dsh-hmos-sidebar

dsh-hmos-sidebar

面向 DeepSeek Harness 的原生 HarmonyOS 开发套件，包含：

• HarmonyOS 工作台插件：在 DSH Web 中提供悬浮面板、构建、部署、设备、日志、截图和工程探测功能。
• 41 个 dcli__* 工具：供 Agent 执行构建、LSP 检查、设备控制、UI 自动化、文档查询和签名配置等任务。
• 原生鸿蒙开发预设：提供 HarmonyOS 专家 Persona、交付标准（诊断清零 → 构建 → 真机截图）和 14 份配套 Skills。

仅支持 Windows。需要已安装 DeepSeek Harness；HarmonyOS 构建和设备能力还需要 DevEco Studio、HarmonyOS SDK，以及按需安装的 deveco-cli。

仓库结构

packages/dsh-hmos-sidebar/            npm 包：DSH 插件、41 个 dcli__* 工具和预设安装器
  presets/native-harmonyos/           “原生鸿蒙开发”预设及 Skills

安装

方式一：从 npm 安装（推荐）

当前公开版本：dsh-hmos-sidebar@0.3.13

将插件安装到需要使用的 DSH Profile。以下示例使用 web：

dsh plugin --profile web add dsh-hmos-sidebar

安装后重启该 Profile 对应的 DSH Web 进程，再打开或刷新 DSH Web 页面。

方式二：从 GitHub 源码安装

git clone https://github.com/YrracOwl/dsh-hmos-sidebar.git
cd dsh-hmos-sidebar
dsh plugin --profile web add .\packages\dsh-hmos-sidebar

源码安装适合开发、调试或需要修改插件代码的场景。修改后需要重新执行安装命令，并重启对应 DSH Web Profile。

插件会同时挂载：

• Host 端 /hmos/api/* 动作级 RPC
• DSH Web 的 HarmonyOS 悬浮工作台

dcli__* 模型工具不会全局注册，只有安装下方预设并选择相应预设的 Agent 才会看到这些工具。

3. 安装预设

npm 包同时携带两个预设（详见 npm 包内容）。安装插件后，显式运行预设安装器：

npx --yes dsh-hmos-sidebar install-presets

如果使用本地 checkout，先进入包目录再运行：

cd packages\dsh-hmos-sidebar
node .\bin\dsh-hmos-sidebar.mjs install-presets

默认安装：

• native-harmonyos（原生鸿蒙开发）

只安装指定预设：

npx --yes dsh-hmos-sidebar install-presets --preset native-harmonyos

先预览目标路径、不写文件：

npx --yes dsh-hmos-sidebar install-presets --dry-run

安装器写入 ${DSH_HOME:-$HOME/.dsh}/.agent-presets/。目标预设已存在时默认拒绝覆盖；确认替换时可使用 --force，原目录会先保存为带时间戳的备份：

npx --yes dsh-hmos-sidebar install-presets --force

安装后重启 DSH Profile，并在新建会话时选择对应预设。预设中的 tool-hmos-tools 引用 dsh-hmos-sidebar/tools，因此必须先完成插件安装。

环境配置

插件会在每次调用时动态探测本机环境，不需要把个人绝对路径写入仓库。需要覆盖自动探测结果时，可在启动 DSH 的本机环境中设置：

插件也可以从 DevEco Studio 和常见 Windows 安装位置自动发现相关工具。

主要能力

DSH Web 工作台

• HarmonyOS 工程与环境探测
• Debug/Release 构建与清理
• HAP 产物查看、安装和启动
• 真机与模拟器列表
• 设备日志、崩溃日志和截图
• 41 个 dcli__* 工具参数速查
• 非鸿蒙工作区自动隐藏悬浮球等安静模式设置

Agent 工具链

• ArkTS/C/C++ LSP 静态检查
• hvigor 工程同步和构建
• HAP 安装、Ability 启动和设备日志
• UI 布局读取、点击、滑动、文本输入和截图验证
• HarmonyOS SDK API 与本地文档查询
• 双签名配置预览与安全写入
• HarmonyOS 工程 AGENTS.md 生成和更新

更新与卸载

更新本地 checkout 后，重新安装插件并重启对应 DSH Profile：

git pull
dsh plugin --profile web add .\packages\dsh-hmos-sidebar

卸载插件：

dsh plugin --profile web remove dsh-hmos-sidebar

预设可通过删除对应的用户预设目录卸载；请先确认其中没有需要保留的本地修改。

开发验证

cd packages\dsh-hmos-sidebar
npm install
npm test
node --check lib/index.js
node --check lib/client.js
node --check lib/dcli-tools.mjs
node --check lib/environment.js
node --check lib/dual-signing.js
npm pack --dry-run

License

插件代码使用 MIT License。第三方来源与改编说明见各预设目录中的 NOTICE。