dsh-hdc-bridge

DSH 原生鸿蒙开发助手：hdc 设备闭环（看设备 → 截图 → 看图 → 改码 → 装包 → 再看）＋ 官方优先、按 API 版本分类的知识层 ＋ 可选官方 DevEco CLI 构建/签名通道。 A DSH-native HarmonyOS dev assistant: the hdc device loop (inspect → screenshot → view → fix → install → verify), an official-first version-classified knowledge layer, and an optional official DevEco CLI build/sign backend.

定位

hdc_mcp 等 MCP 服务器已覆盖 hdc 能力层。本插件不重写 hdc 协议，直接复用本机 hdc 二进制（3.x），价值在 DSH 原生层：

• 会话内工具卡片与 read_image 原生闭环
• 按调用会话解析沙箱策略（与 pwsh 工具同款路线），截图写入 /.dsh-hdc/screenshots/
• 结构化的失败上报（hdc 传输层退出码不可靠，插件用输出标记 + 落盘校验兜底）

工具

工具	说明
hdc_list_targets	列出已连接设备/模拟器（空列表 + 连接指引）
hdc_connect	hdc tconn（严格 host:port 校验）
hdc_shell	设备 shell（param get / ps / uitest dumpLayout…）
hdc_screenshot	截图 → 拉取 JPEG → 落盘校验（API 10+ 的 snapshot_display 仅支持 .jpeg）
hdc_install	安装 .hap（默认 -r；输出标记级失败检测）
hdc_hilog	hilog 尾部 N 行（可选域名 -T 过滤，如 PARAM）
hdc_ui_dump	文本化 UI 快照：uitest 布局树 → 可见文本节点（纯文本模型的「文字截图」）
hdc_ui_find	按文本/hint 找控件：返回 bounds 与中心坐标，配合 tap 免手算坐标
hdc_ui	UI 操作：tap / doubleTap / longPress / swipe / input / key（Back/Home/Power/keyID），配合 dump 形成「观察 → 操作 → 验证」闭环
hdc_app	应用管理：query / start / stop / clear-data / uninstall（破坏性动作已标注）
hdc_crash	崩溃抓取：faultlogger 目录里最近的 jscrash / cppcrash / appfreeze，可按包名过滤，并解析结构化摘要（错误名/信息/错误码/源码帧/已知错误码提示）
hdc_diag	诊断：shell 口味 / hdc 路径 / 策略解析 / 探测日志
错误码提示	install / app 失败时按错误码附中文修复建议（如 9568332 → 登记设备 UDID）
hms_setup	环境体检：hdc / DevEco Studio / SDK(API 版本) / devecocli / 设备五项 + 目标 API 版本三源解析（项目→设备→SDK）与不一致告警
hms_build	官方构建/签名/运行通道：status / build / run / sign / clean；devecocli 缺失时自动回退本机 hvigorw + hdc_install + hdc_app 闭环