Dikciz Launcher

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install dikciz-launcher
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 dikciz-launcher。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Dikciz Launcher 是一款 Android 主屏幕应用，支持可配置页面、应用快捷方式、提供方小部件、主题、HTML 小部件和 Lua 自动化。此 Openclaw Skills 集成可帮助安装或连接启动器，并通过其原生界面、WebSocket 控制和 MCP 工具使用受支持的功能。
此技能强调在进行更改前，先发现当前运行版本实际支持的命令和架构，然后在选定设备上验证结果。它会保留现有启动器数据，并要求对破坏性或特权操作进行明确批准。

应用场景

在用户选定且已连接的 Android 设备上安装提供的 Dikciz Launcher APK。
操作前检查运行中的启动器控制状态、自动化状态和可用的 MCP 工具。
使用文档说明的架构读取或更新主屏幕配置、页面、快捷方式、主题和小部件。
使用 HTML 桥接调用或 Lua 自动化脚本执行受支持的启动器工作流。
通过 WebSocket 或 MCP 控制执行语义化 UI 操作或设备命令。
使用新的快照、脚本状态或日志验证请求的更改。

工作原理

与用户确认 APK 和目标 Android 设备；若任一项缺失或不明确，请求澄清。
按照设置参考安装或连接启动器、配置 Android 访问权限，并将所需端口转发到主机回环地址。
对于现有安装，查询 controlStatus、automationStatus 和 tools/list，以发现当前运行版本可用的控制功能和限制。
选择操作前，查阅相关的用户、配置、脚本或自动化控制指南。
从 snapshot、homeGet 或 configGet 等读取操作开始，并使用返回的语义 ID 以及页面或小部件地址进行更改。
操作后读取新的快照，或检查脚本状态和日志，以确认请求的结果；如实报告失败或访问被拒绝的情况。

配置指南

使用用户选定的 APK 和设备。不要仅为了安装 APK 而构建 APK 或启动模拟器。阅读 references/setup.md，了解安装流程、Android 访问要求、端口转发和连接检查。使用适用于用户设置的实际客户端路径、主机和转发端口。
对于已连接的启动器，使用仓库客户端检查其实时接口：
python3 scripts/dikciz-control.py websocket controlStatus --port 19101 --pretty
python3 scripts/dikciz-control.py websocket automationStatus --port 19101 --pretty
python3 scripts/dikciz-control.py mcp-tools --port 19102 --pretty
已配置的 MCP 客户端可以直接连接转发的 /mcp 端点。将 bearer 密码保存在用户的机密环境中，不要放入命令参数或公开文件。只将选定设备的端口转发到主机回环地址。

数据架构

Dikciz 将已保存的配置、页面和小部件文件存放在 /sdcard/Dikciz/ 下。编辑这些文件前请阅读配置指南，并保留用户现有的主屏幕和数据。
数据或接口 用途
主屏幕配置和页面 定义启动器布局和页面内容。
HTML 小部件文件 提供小部件内容，并可使用文档说明的 HTML 桥接功能。
Lua 脚本和自动化策略 定义自动化行为；Lua 脚本以自动化形式运行，而非作为小部件类型运行。
WebSocket 控制和 MCP 工具 提供运行时操作；应从当前运行版本发现名称、字段和限制，而不要假设架构固定不变。
语义 ID 和页面/小部件地址 标识操作的 UI 目标；应使用实时读取返回的值。
除了启动器文档说明的文件和运行时接口外，此技能未指定单独的元数据分类体系或生成文件格式。

高级特性

发送命令前发现实时 WebSocket 控制、自动化状态和 MCP 工具。
配置了 MCP 客户端时，连接转发的 MCP
/mcp
端点。
使用自动化控制指南中说明的语义化 UI 操作、屏幕截图和设备命令。
使用 Lua 脚本、事件和自动化策略自动执行受支持的工作流；通过状态和日志验证执行情况。
使用 HTML 桥接执行受支持的小部件交互和脚本操作。
遵守 Android 权限边界：辅助功能操作需要所有者启用 Dikciz 的 Accessibility 服务，而普通启动器控制不需要。
默认将 shell 访问视为特权操作；有意在应用沙盒中执行时设置
root: false
，遭到拒绝后绝不可改用 root。
重置主屏幕、卸载应用、替换配置、启用设备管理或运行特权 shell 命令前，必须取得明确批准。

name: "dikciz-launcher" description: "Install a Dikciz Launcher APK with ADB and use its home screen, configuration, HTML widgets, Lua automation, WebSocket controls, and MCP tools on the user's selected Android device."

Dikciz Launcher

Use this skill to install and operate Dikciz, not to develop its Android source or manage Android Lab.

Install or connect

Read references/setup.md for APK installation, Android access, port forwarding, and connection checks. Take the APK and target device from the user. If either is missing or ambiguous, ask. Do not build an APK or start an emulator just to install one.

For an already connected launcher, discover its live contract before sending commands:

python3 scripts/dikciz-control.py websocket controlStatus --port 19101 --pretty
python3 scripts/dikciz-control.py websocket automationStatus --port 19101 --pretty
python3 scripts/dikciz-control.py mcp-tools --port 19102 --pretty

These examples use the repository's client and the forwarding ports in the setup reference. Use the actual client path, host and forwarded ports for the user's installation. A configured MCP client can connect directly to the forwarded /mcp endpoint instead.

Use the launcher

Read references/capabilities.md to choose among the supported features. It catalogs the launcher, configuration, event sources, actions, HTML bridge and remote controls, with links to their exact schemas.

For Home selection, pages, app shortcuts, provider widgets, themes, and the native settings UI, read the user guide.
For saved configuration, pages and widget files beneath /sdcard/Dikciz/, read the configuration guide before editing them.
For HTML bridge calls, Lua scripts, events, and automation policies, read the scripting tutorial.
For WebSocket envelopes, MCP tools, semantic UI actions, screenshots, and device commands, read the automation-control guide. Discover the running build's names, fields and limits through controlStatus and tools/list rather than inventing them.

Start with snapshot, homeGet, configGet, or the matching discovered MCP read tool. Use returned semantic IDs and page/widget addresses for actions. Read a fresh snapshot after an action to verify the change. Android accessibility actions require the phone owner to enable Dikciz's Accessibility service; ordinary launcher controls do not require it.

The bundled home has pages, HTML widgets, native shortcuts, provider widgets, and a script dashboard. Lua runs as automation scripts, not as a widget type. Android permissions, special access and root remain device-controlled.

Boundaries and completion

An installation or connection request does not authorize resetting the home, uninstalling apps, replacing all configuration, enabling device administration, or running privileged shell commands. Explain the effect and obtain explicit approval for those operations. shell requests root by default; set root: false when app-sandbox execution is intended. Do not fall back to root after a denied action.

Preserve /sdcard/Dikciz/ and the user's existing home. Keep bearer passwords in the user's secret environment, never in command arguments or public files. Forward only the selected device's ports to host loopback.

Finish after the requested installation or action is verified on that device. A queued automation event is not proof its actions succeeded; check script status and logs. Report access denials and connection failures instead of claiming completion.

SAVER Verifier

Jev Pipeline