鸿蒙开发套件 MoonlitDropOfBlood/dsh-deveco

<rect x="5" y="2" width="14" height="20" rx="2" ry="2"/><line x1="12" y1="18" x2="12.01" y2="18"/>

DeepSeek Harness HarmonyOS 开发套件

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

兼容性：支持 DSH ^0.2.0-rc.1（0.2.x；本插件深度依赖 0.2.0 API——官方右侧边栏 sidebarRightTabs、设置页、智能体工具 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 多选）+ 包名/关键词实时过滤——流跑着随时改随时生效、清空即回溯（不丢已缓冲的行）；包名自动解析为进程 pid 集合过滤（主进程 + :render 等后缀进程全收）+ Ctrl+F 日志内查找（Tab 内接管快捷键：全部命中高亮 + 计数 + Enter 逐个跳转 + Esc 关闭）+ 「开始/停止」控制
- 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 路线）

智能体工具（对话内可调用）

- harmony_ui_tree：把 DevEco 调试源取树注册为 DSH 的智能体工具（ctx.tools），对话里的智能体可直接调用，返回缩进树文本（或 format=json 完整节点）——节点含组件名、bounds、文本与 padding/margin/border 声明值；JSON 中每个节点带裁剪前原始直接子节点数 childCount（裁剪为叶子也不归零）。Swiper 在 displayCount 未配置或 ≤1 时只完整展开 currentIndex 页，其他页保留一层（TabContent 两层），displayCount>1 时不裁剪。支持 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 # 93 个独立核心单元测试（路径探测 + 配置互斥 + 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 StudioC:\Program Files (x86)\Huawei\DevEco StudioC:\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