前言¶
DeepSeek Harness 的插件生态允许在侧边栏扩展开发工具。鸿蒙模拟器插件是 dsh-better-sidebar 的一个标签页扩展，它将鸿蒙模拟器的启动、设备管理以及应用构建部署流程集成到 DSH 的侧边栏面板中。对于需要在 Harness 环境中直接调试 HarmonyOS 应用的开发者，该插件提供了一个统一的操作入口。
插件定位¶
这是一个基于 dsh-better-sidebar 的标签页插件，由用户 momo20012002 维护，采用 MIT 许可证。它主要解决的是在 DSH 环境下，如何方便地启动鸿蒙模拟器，并将选定的工程构建并部署到目标设备的问题。
核心功能¶
插件提供了以下功能：
- 模拟器管理：启动或停止模拟器，查看可用实例与在线设备。
- 项目识别：通过文件浏览或扫描，识别 HarmonyOS 应用工程。
- 构建部署：将选定的工程构建、安装并启动到目标设备，支持自动识别多入口模块。
- 实时反馈：构建、安装、启动过程的实时输出。
- 就绪检测：模拟器冷启动后自动检测设备是否上线。
- 模型工具：向 AI 提供六个专用工具，用于模拟器控制、部署、日志、代码检查和文档检索。
安装与前置条件¶
安装前请确认以下环境已就绪：
- DSH 环境：
dsh web正常运行。 - Node.js：版本 >= 22。
- 包管理器：pnpm 版本 >= 10。
- 开发环境：已安装 DevEco Studio（Windows/macOS）或 Linux Command Line Tools >= 26.0.0。
- CLI 工具：已安装
@deveco/deveco-cli（devecocli），如未安装可在面板点击「一键安装」。
安装命令如下：
dsh plugin --profile web add dsh-hmos-emulator
安装完成后，重启 dsh web 并刷新浏览器页面即可生效。
使用流程¶
- 打开侧边栏的
+菜单，选择「鸿蒙模拟器」。 - 点击「扫描可用」，列出模拟器与在线设备，点击「启动」启动模拟器。
- 在「应用项目」中浏览或扫描，选择一个鸿蒙工程。
- 点击「构建并部署」，等待完成。
模型工具¶
插件向 AI 提供以下六个工具，可在对话中直接调用：
emu：模拟器实例的查看、启动与停止。emu_ui：屏幕结构读取、交互与截图。hmos_deploy：构建 → 安装 → 启动流程。hmos_lint：代码检查。hmos_log：设备日志查看。hmos_docs：官方鸿蒙文档检索。
截图逻辑：界面状态默认读取节点结构，仅在结构不清时使用截图。异常发生时，截图会自动留存到工作区的 screenshots/ 目录。
平台支持与注意事项¶
- Windows / macOS：依赖 DevEco Studio 提供的模拟器功能。
- Linux：DevEco Studio 不可用，需使用 Command Line Tools >= 26.0.0。Linux 上必须配置桌面环境（即
DISPLAY或WAYLAND_DISPLAY环境变量已设置），否则无法启动模拟器。 - 权限与安全：插件以当前 DSH 进程的权限运行，安装前请检查源码与许可证（MIT）。
结语¶
该插件将鸿蒙开发的核心流程封装进 DSH 侧边栏，配合 AI 模型工具，能够显著提升在 Harness 中开发 HarmonyOS 应用的效率。
