1na-ko/dsh-hdc-bridge
71最近提交 2026年8月14日
dsh-hdc-bridge DSH 插件
dsh-hdc-bridge 在 DSH 中实现了完整的 hdc 设备调试闭环：列出设备、连接、Shell、截图、安装、UI 转储与操作、崩溃抓取等。还包含离线官方知识层（Tier-1 随包内置 23 个高频 API 模块），以及可选的 DevEco CLI 构建、签名、lint 集成。
如何安装 dsh-hdc-bridge DSH 插件
dsh plugin --profile <name> add dsh-hdc-bridge来源命令需要人工核对。复制不会执行命令。
dsh-hdc-bridge DSH 插件数据来源
dsh-hdc-bridge DSH 插件快照日期：2026年8月16日
discovered
dsh-hdc-bridge DSH 插件能做什么
- 设备管理：列出、连接、Shell、截图、安装、卸载、应用生命周期控制
- UI 自动化：转储布局树、按文本查找控件、点击、滑动、输入、按键
- 崩溃抓取：获取最近的 jscrash/cppcrash/appfreeze 日志及结构化摘要
- 离线官方知识：23 个高频 API 模块随包内置，无需网络
- SDK 精确 API 知识：读取本地 .d.ts 文件，支持 @since/@deprecated 版本信息
- 官方 DevEco CLI 构建、签名、运行、lint、兼容性检查（可选后端）
dsh-hdc-bridge DSH 插件适合哪些场景
- 在 DSH 会话中通过自然语言调试鸿蒙设备或模拟器
- 自动化 UI 测试：观察→操作→验证闭环，配合截图和文本转储
- 快速查看设备信息、日志和崩溃报告，无需离开聊天界面
- 使用官方 DevEco CLI 构建和签名 HAP 包，并自动降级到本地 hvigorw
- 离线搜索官方文档，了解 API 用法和版本变化
dsh-hdc-bridge DSH 插件适合谁
- 使用 DSH 作为开发环境的鸿蒙应用开发者
- 在鸿蒙设备上进行自动化 UI 测试的 QA 工程师
dsh-hdc-bridge DSH 插件的限制
- 截图仅支持 JPEG 格式（API 10+ snapshot_display 限制）
- 真机安装需要签名 profile 绑定设备 UDID，否则报 9568332 错误
- hdc 客户端在远程失败时可能仍返回退出码 0，插件通过输出标记和校验兜底
- 混合字符类型的 UI 输入在模式切换后会丢失第一个字符，需分段输入
- DevEco CLI 功能需要 DevEco Studio ≥ 6.1.0（macOS/Windows，Node ≥ 18）并一次 `devecocli auth login` 登录
dsh-hdc-bridge DSH 插件的仓库 README 摘录
以下文字摘自 dsh-hdc-bridge DSH 插件的上游仓库 1na-ko/dsh-hdc-bridge 的 README，版权归原作者，仅作引用。
> DSH 原生鸿蒙开发助手：`hdc` 设备闭环调试（看设备 → 截图 → 看图 → 改码 → 装包 → 验证）＋ 官方优先版本化知识层（离线 Tier-1 随包 + SDK 机读 + 官方文档检索）＋ 可选官方 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 (offline Tier-1 bundled + SDK-accurate reads + official docs search), and an optional official DevEco CLI build/sign backend. ## 定位 [hdc_mcp](https://github.com/yushun667/hdc_mcp) 等 MCP 服务器已覆盖 hdc 能力层。本插件不重写 hdc 协议，直接复用本机 hdc 二进制（3.x），价值在 DSH 原生层： - 会话内工具卡片与 `read_image` 原生闭环 - 按调用会话解析沙箱策略（与 `pwsh` 工具同款路线），截图写入 `<workspace>/.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_
阅读完整 README仓库许可: MIT
dsh-hdc-bridge DSH 插件常见问题
如何安装 dsh-hdc-bridge？
在终端中运行 `dsh plugin --profile <name> add dsh-hdc-bridge`。如果你想直接从 GitHub 安装，可以使用 `dsh plugin --profile <name> add github:1na-ko/dsh-hdc-bridge`。安装后，用 `dsh --profile <name> --dump-config` 确认插件层出现，然后启动 DSH。
这个插件对环境有什么要求？
需要一台开启了开发者模式和 USB 调试的鸿蒙设备或模拟器。插件会自动从 DevEco Studio SDK 路径或 PATH 中检测 hdc 二进制。截图查看需要图像输入模型；纯文本模型可以使用 `hdc_ui_dump` 替代。可选的 DevEco CLI 功能需要 DevEco Studio ≥ 6.1.0（macOS/Windows，Node ≥ 18）并执行一次 `devecocli auth login` 登录。
截图保存在哪里？
截图默认保存在 `<工作区>/.dsh-hdc/screenshots/` 目录下。插件会自动创建该目录。建议将 `.dsh-hdc/` 添加到项目的 `.gitignore` 文件中，避免提交截图文件。
安装应用时遇到 9568332 错误怎么办？
错误 9568332 表示签名 profile 没有绑定设备 UDID。需要在 AppGallery Connect 项目中注册设备 UDID，然后重新签名 HAP，使用包含该 UDID 的 profile。这是鸿蒙标准的签名要求，不是插件问题。
离线情况下可以使用知识层吗？
可以。`hms_knowledge` 工具提供了离线访问的官方知识层，包含 23 个高频 API 模块的节选（基于 OpenHarmony 官方文档，CC-BY-4.0 许可）。这些内容随插件打包（约 1.2MB），无需网络、SDK 或 CLI。使用 `hms_knowledge catalog` 浏览主题，然后 `hms_knowledge read <章节>` 查看内容。