一个把官方 DevEco CLI 封装成 Agent 工具 + 对话面板的 DSH 插件：工程脚手架、构建、运行、设备与模拟器控制、UI 自动化（布局 / 点击 / 输入 / 滑动 / 截图）、hilog 日志、代码规范检查与本地 HarmonyOS 文档检索。

插件包装官方 devecocli 二进制，不重复实现工具链。只需安装一次 DevEco Studio（≥ 6.0.0）或 Command Line Tools（≥ 26.0.0），ohpm、hvigor、hdc、emulator、hilog 全由 CLI 接管。

安装

需要 DSH（DeepSeek Harness）、Node.js ≥ 22，以及官方 DevEco CLI：

npm install -g @deveco/deveco-cli   # 一次性安装工具链

然后把插件装进你的 profile：

dsh plugin --profile desktop add dsh-plugin-deveco-cli   # 换成你的活动 profile
# 桌面版：打开 DSH Terminal → dsh plugin add dsh-plugin-deveco-cli

重启 / 刷新 Harness 后，对话视图会出现 DevEco 标签页，以下工具对 Agent 生效。

可选插件配置

在插件行配置里（如 cordis.yml）：

- id: dsh-plugin-deveco-cli
  name: dsh-plugin-deveco-cli
  config:
    binary: C:/path/to/devecocli   # 不在 PATH 时用绝对路径
    cwd: D:/work/MyHarmonyApp      # 默认工程目录
    timeoutMs: 60000               # 默认命令超时
    disabledTools: [deveco_cli]    # 隐藏指定工具

工具一览

工具	用途
deveco_status	工具链体检：二进制、版本、Studio/CLT 检测、设备数
deveco_cli	通用通道：执行任意子命令（auth、skills、check compat…）
deveco_create	创建新的 HarmonyOS 应用工程
deveco_build	构建工程 → .hap / .hsp / .har / .app（product / 模块 / 模式）
deveco_run	构建、安装并在设备/模拟器上启动
deveco_device_list / deveco_device_view	已连接设备（名称、序列号、类型、OS）
deveco_emulator_list / start / stop	模拟器实例管理
deveco_ui_layout	导出设备 UI 节点树（simplified/full，按 id/窗口/深度）
deveco_ui_screenshot	设备截图保存到文件
deveco_ui_click / deveco_ui_text / deveco_ui_swipe	UI 交互
deveco_log	hilog / 崩溃日志（级别、包名、关键字、行数过滤）
deveco_docs_search / deveco_docs_read	本地 HarmonyOS 文档检索与阅读
deveco_check_lint	Code Linter 规范检查（可选自动修复）
deveco_signature_generate	自动生成调试签名材料（需先 devecocli auth login）

Agent 用法示例：

• 以 release 模式构建这个工程并跑到我的模拟器上
• 创建名为 MyApp、API 级别 18 的 HarmonyOS 工程
• 查看这个应用最近 50 条错误日志
• 看看手机上的 UI，点 id 为 submit 的按钮，输入 Hello
• 在本地文档里搜 @State 并总结最佳实践

面板

对话视图的 DevEco 标签页展示工具链状态、已连接设备、模拟器实例（可刷新），以及本地文档检索框。

工作原理

• Host 端（src/index.ts）注册 defineTool，用校验过的参数调起 devecocli（支持处带 --format json），带超时与中止联动。
• RPC（src/runtime.ts + src/typert.ts）通过 Typert 把 remote.deveco 暴露给浏览器面板。
• Client 端（src/client/）把面板挂到 conversation.view 插槽。

开发

npm install
npm run build        # tsc 编译 host + esbuild 打包 client
npm run typecheck
npm run smoke        # 用桩 devecocli 做离线冒烟测试

隐私与许可

命令由官方 DevEco CLI 在你本机执行，插件本身不向外发送任何数据；DevEco 遥测见 CLI 的 PRIVACY.md。MIT 许可——本插件是独立的社区封装，与华为 / OpenHarmony SIG 无隶属关系。