dsh-deveco

DeepSeek Harness HarmonyOS 开发套件

_中文

---

为 DeepSeek Harness（DSH） Web UI 打造的 HarmonyOS 全栈开发套件插件：HiLog 检查器、Chrome DevTools 风格 ArkUI Inspector（截图点选 + 组件树 + 盒模型声明值 + 自定义组件名）、ArkTS 语法高亮 .ets 查看器、工具链与设备管理，以及对话内 agent 可直接调用的 harmony_ui_tree 工具。

兼容性：支持 DSH ^0.2.0-rc.1（0.2.x；本插件深度依赖 0.2.0 API——官方右侧边栏 sidebarRightTabs、设置页、agent 工具 ctx.tools，0.1.x 无右侧边栏，不受支持）。engines.dsh 与 peerDependencies 同步声明。发布走 GitHub v* 标签 → Actions 自动构建测试 + GitHub Release + npm（@duke-dsh-plugins 组织，OIDC Trusted Publishing）。

功能

官方右侧边栏 Tab

• HiLog 检查器：实时日志流（基于 devecocli log --follow）+ 级别过滤（chip 多选）+ 包名/关键词过滤 + 「开始/停止」控制
• ArkUI Inspector：Chrome Elements 风格三栏——左侧设备截图（点「Dump UI」自动抓取，Host 内联返回 PNG dataUrl；点击截图直接选中对应节点并显示蓝色高亮框，按 origBounds 真实布局矩形标注——bounds 只是被滚动/遮挡后的可见区域，List 尤其不准；高亮与点击命中共用同一坐标系；点中后 UI 树自动展开并滚动定位到该行并高亮选中）+ 右上 UI 树（可逐节点折叠/展开 + 「折叠全部」、层级引导线（线性缩进不封顶，深层可横向滚动）、自定义组件显示组件名，其内部 __Common__ 占位节点归属到所属组件、tap/scroll/子节点数标记、#accessibilityId 标识、顶部「树源」下拉两选一：DevEco 调试源（反编译复刻 DevEco Studio 同款 ark:<pid>@<pkg> WebSocket 调试链路，唯一带 padding/margin/border 声明值与 viewTag 组件名；需 debug 应用且应用侧调试 socket 空闲——DevEco Studio 的 Inspector 面板开着时会占用唯一连接）/ 无障碍树（uitest，适合已发布应用）、窗口下拉切换窗口）+ 右下节点属性（全部设备原始属性，支持按属性名或值搜索过滤并高亮命中项 + 盒子模型：组件区域 / 内容区域（子节点并集实测） / 四边内缩实测值；padding/margin/border 声明值在 uitest 源下显示「未提供」——已穷尽核对 7 条取数路径确实不输出，不做假数据；DevEco 调试源下显示真实声明值）；底部 Tap/Swipe/Text 操作
• Projects：项目浏览器（v1.0 占位；v1.1 路线）

Agent 工具（对话内可调用）

• harmony_ui_tree：把 DevEco 调试源取树注册为 DSH 的 agent 工具（ctx.tools），对话里的 agent 可直接调用，返回缩进树文本（或 format=json 完整节点）——节点含组件名、bounds、文本与 padding/margin/border 声明值。支持 device / pid / package_name 定位目标、include_attrs 附带全部原始属性、max_nodes 截断保护。前置条件同 DevEco 调试源（debug 应用、DevEco Inspector 面板未占用）。

.ets 文件查看器

• 注册为官方侧边栏 file tab（patterns: ["dsh-resource://file/**"] + canOpen 按扩展名过滤），extension 优先级优先于内置 text editor
• 提供 ArkTS 语法高亮：关键字 + 装饰器（@Entry /@Component /@State 等）+ 注释 + 字符串 + 数字
• 内容经官方 remote.workspaceFiles.read 分页读取；绝对路径文件回退插件自有 readTextFile Remote

设置 → HarmonyOS Suite

页面分两个分区：

工具链

• 「DevEco Studio 路径」输入框 + 「扫描系统默认」+ 自发现结果列表
• 「HarmonyOS Command Line Tools 路径」输入框 + 版本校验（≥ 26.0.0）+ 自发现结果列表
• 「重新扫描」按钮 + 「保存 / 放弃」
• 状态徽章（devecocli / CLT ≥26 / CLT<26 / Studio / 未配置）

设备管理

• 设备列表：实时列出 USB / 网络设备（devecocli device list），网络目标（ip:port）带「网络」徽章，可一键「断开」（hdc tconn <ip>:<port> -remove）
• IP 网络连接：输入设备 IP 和端口（端口必填——hdc 无默认端口，须与设备开启调试后暴露的端口一致）后「连接」，底层执行 hdc tconn <ip>:<port>；连接/断开后列表自动刷新。devecocli 本身没有 IP 连接能力，这里直连 SDK 自带的 hdc（按 DEVECO_SDK_HOME → DEVECO_HOME → 已配置/已发现的 Studio/CLT 安装根 → PATH 顺序解析）。前提：设备已在「设置 → 开发者选项」中开启调试

工具链解析优先级（用户决策）

1. PATH 存在 devecocli → 优先使用，忽略设置路径
2. CLT 路径 ≥ 26.0.0 → 用 CLT（与 Studio 互斥）
3. DevEco Studio 路径 → 兜底
4. 无 → 错误提示去设置

互斥规则：setCltPath 清空 studioPath；setStudioPath 清空 cltPath。

安装

dsh plugin --profile web add @duke-dsh-plugins/dsh-deveco

本地开发版：

git clone https://github.com/MoonlitDropOfBlood/dsh-deveco
cd dsh-deveco
dsh plugin --profile web add .

开发

npm run check    # 全部 JS 语法检查
npm test         # 82 个独立核心单元测试（路径探测 + 配置互斥 + HiLog/ui 解析 + hdc IP 连接/空格路径 spawn/超时判定 + 盒子模型/contentBox/hitTest/PNG 尺寸 + 窗口/原始 dump/DevEco 调试树/裸 WS 握手/agent 工具投影/自定义组件/字体属性/devId 解析）

改插件后必须重启 DSH 生效（Host 加载、typert 注册、client bundle 注入都在启动时发生）。

详细开发规范见 AGENTS.md。

三平台自动发现

平台	Studio 默认路径	CLT 根默认路径
Windows	C:\Program Files\Huawei\DevEco Studio C:\Program Files (x86)\Huawei\DevEco Studio C:\DevEco Studio	C:\Program Files\Huawei\Command Line Tools %LOCALAPPDATA%\Huawei\Command Line Tools
macOS	/Applications/DevEco Studio.app/Contents /Applications/Huawei DevEco Studio.app/Contents ~/Applications/DevEco Studio.app/Contents	/Applications/Command Line Tools.app/Contents ~/Library/Huawei/Command Line Tools
Linux	/opt/deveco-studio /opt/Huawei DevEco Studio ~/deveco-studio	/opt/Huawei/Command Line Tools ~/Huawei/Command Line Tools

持久化

• 配置：<DSH_HOME>/data/dsh-deveco/config.json
• 自发现缓存：<DSH_HOME>/data/dsh-deveco/discovery.json

首次启动（discovery.json 不存在）自动触发三平台自发现，结果缓存到 <DSH_HOME>/data/dsh-deveco/discovery.json。

许可证

MIT