前言¶
DeepSeek Harness (DSH) 的核心架构支持通过插件扩展功能。针对 HarmonyOS 开发场景，dsh-deveco 插件将开发者常用的 HiLog 日志监控、Chrome DevTools 风格的 ArkUI Inspector、ArkTS 语法高亮查看器以及设备管理工具集成到了 DSH 的 Web UI 右侧边栏中，旨在减少工具切换成本，提供一站式的开发辅助体验。
功能¶
HiLog 检查器¶
提供实时的日志流查看能力。支持对日志级别（Error/Warn/Info 等）、包名以及自定义关键词进行过滤。用户可以通过界面上的控制按钮实时开始或停止日志流。
ArkUI Inspector¶
采用 Chrome DevTools 的经典三栏布局设计：
* 设备截图与交互：点击「Dump UI」抓取当前界面快照，点击截图可直接选中对应的 UI 节点，并在组件树中自动展开并定位该节点。
* UI 组件树：展示组件层级结构，支持自定义组件名的显示、折叠/展开操作。支持通过 DevEco 调试源或无障碍树源（uitest）进行切换。
* 节点属性与盒模型：右侧面板展示节点的原始属性，并支持按属性名或值搜索过滤。底部提供 Tap、Swipe、Text 等模拟操作。
ArkTS 语法高亮查看器¶
支持在 DSH 的侧边栏中直接查看 .ets 文件。提供关键字、装饰器、注释、字符串和数字的语法高亮。内容通过官方 remote.workspaceFiles.read 接口分页读取。
Agent 工具与配置¶
- Agent 工具：注册了
harmony_ui_tree工具，对话内的 Agent 可直接调用，返回缩进树结构或 JSON 格式的 UI 树，包含组件名、边界和声明值。 - 工具链配置：在设置页中可配置 DevEco Studio 路径和 HarmonyOS Command Line Tools (CLT) 路径。插件支持跨平台（Windows/macOS/Linux）自动发现默认安装路径，并校验 CLT 版本是否大于等于 26.0.0。DevEco Studio 路径与 CLT 路径互斥。
设备管理¶
提供设备列表管理功能，支持列出 USB 连接和网络连接的设备。用户可以手动输入设备 IP 和端口进行网络连接，或一键断开连接。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add @duke-dsh-plugins/dsh-deveco
安装完成后，需重启 DSH 进程以使插件生效。
典型用法¶
- 配置路径：首次使用前，进入 DSH 设置页的 HarmonyOS Suite 区域，扫描并保存 DevEco Studio 或 CLT 的路径。
- 查看日志：在右侧边栏启动 HiLog 检查器，过滤特定包名或关键词查看实时日志。
- Agent 调用：在对话中让 Agent 调用
harmony_ui_tree工具，获取当前设备的 UI 结构用于自动化测试或分析。 - 网络调试：在设备管理区域输入设备的 IP 和调试端口进行连接。
注意事项与限制¶
- DSH 版本要求：仅支持 DSH
^0.2.0-rc.1及以上版本。0.1.x 版本由于缺乏右侧边栏 API，不受支持。 - CLT 版本校验：配置的 CLT 版本必须大于等于 26.0.0。
- 调试源限制：使用 DevEco 调试源时，应用必须处于调试模式，且应用侧的调试 Socket 必须空闲（即 DevEco Studio 的 Inspector 面板未占用连接）。
- 路径互斥：DevEco Studio 路径与 CLT 路径不能同时配置，设置一方会自动清空另一方。
- 许可证：本项目基于 MIT 许可证开源。
生态与资源¶
- GitHub 仓库：https://github.com/MoonlitDropOfBlood/dsh-deveco
- 维护者：MoonlitDropOfBlood
