前言¶
在 DeepSeek Harness（DSH）里做 HarmonyOS 应用，往往要同时处理 ArkTS 改码、hvigor 构建、ohpm 依赖、hdc 装包和 hilog 排错。若只靠通用编码 agent，常见问题是：编译报错时盲改、真机验证要人工串好几步命令、日志只能在终端里翻。社区插件 mobius-2046/dsh-harmonyos-agent（包名 @local/dsh-harmony，目录页 SkillHub）把 DSH 预设、领域技能和单一 harmony 工具收成一套工作流，并带 Web 侧 hilog 面板。下面介绍它是什么、能做什么，以及安装与典型用法。
这是什么¶
dsh-harmony 是 DSH 的 HarmonyOS 应用开发 agent 插件，维护者为 mobius-2046，分类为工作流。当前资料中的版本为 0.6.5，许可证 MIT。
一句话定位：复用宿主自带的 planMode 与 goals 服务，在同一套会话里切换 plan / goal / build 三种状态；补上鸿蒙专家人格、ArkTS / hvigor / ohpm / hdc 相关技能，以及一个合并后的 harmony 工具（build / run / devices / deploy / logs），并在 Web GUI 侧边栏提供仿 DevEco HiLog 的 hilog 面板。
插件在 DSH 进程权限下运行；安装前建议阅读仓库源码与 LICENSE。SkillHub 为社区目录站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
三模式：同一会话，三种状态¶
三个模式不是三个独立 agent，而是同一对话的三种状态，切换不丢历史。
| 模式 | 进入方式 | 行为 |
|---|---|---|
| plan | /plan（宿主内置） |
只读调研，产出方案，经 exit_plan_mode 提交审批 |
| goal | /goal <目标>（宿主内置） |
持久目标 + 自动续跑轮次，输入区上方 GoalBar 显示进度 |
| build | 关闭 plan 后的默认状态 | 直接改文件并构建验证；中途可用 /build 跳过剩余 plan |
补充命令：/mode 查看当前 plan / goal 状态；/build 在 plan 停在半路时直接开工。
预设、技能与工具¶
| 部件 | 内容 |
|---|---|
预设 harmony |
与 standard 同源的编码工具面（26 个组件），人格换为鸿蒙专家；经 agentPresets.register() 运行时注册，不占用官方预设位 |
| 技能 | harmony-project、harmony-arkts、harmony-build-deploy、harmony-ohpm |
| 工具 | 单个 harmony，通过 action 选择：build / run / devices / deploy / logs |
设计上把原先多个 DevEco CLI 相关工具合并为一个，是为了控制每轮下发的工具 schema 体积（README 提到多工具并存时工具表曾撑到约 87 个）。
run 的一次闭环：构建 → 安装 entry →（HSP 工程）补装依赖 → 拉起 Ability → 抓取约 6 秒日志，返回五段结论；README 称若交给模型自行串联，平均会多 3–4 轮。
各 action 职责（摘自 README）：
| action | 做的事 |
|---|---|
build |
hvigorw assembleHap（hsp: true 时再跑 assembleHsp），返回产物、是否已签名、结构化错误 |
run |
build → 装包 →（HSP）补依赖 → aa start → 抓日志 |
devices |
列出 hdc 设备 |
deploy |
安装指定 .hap，可选拉起 |
logs |
限时抓取 hdc shell hilog |
编译报错时，agent 会先读第一条错误再改，而不是盲改——这是 README 中描述的行为约定。
hilog 日志面板¶
侧边栏 hilog 图标进入全屏日志页：选设备、按进程 / 级别 / 关键字过滤，实时跟随，可暂停、保存。浏览器侧只负责界面；采集在 Host 侧，经宿主 ctx.connection.fetch 上的 /api/harmony/logs* 路由（带浏览器令牌）以 NDJSON 流推送。首次进入会先灌入最近 120 行，再实时追加。
安装与启用¶
前置条件¶
- DSH 版本：
>=0.2.1-rc.5 <0.3.0-0（见package.json的engines.dsh） - Windows + PowerShell（仅支持 Windows：
tool-pwsh启用、tool-bash关闭） - DevEco Studio 6.x（提供
hvigorw/hdc） - 真机调试：设备已连上
hdc；工程目录须可写（hvigor 要写<project>/.hvigor和build/） - 未配置签名时只会产出 unsigned，真机无法安装
安装步骤¶
在 SkillHub 插件页点「安装」并选择本目录，或在 plugin_manager 中执行：
install_bundle target: <本目录的绝对路径>
PowerShell CLI 方式：
dsh plugin --profile desktop add file:<本目录>
装完后新建会话，在预设选择器里选 HarmonyOS。
第一次安装，或升级到包含新 client.js、新 Host 路由的版本后，需要重启一次 Harness，浏览器半边与 hilog 面板才会正确加载。
典型用法¶
1. 先规划，再动手¶
在会话里输入例如：
/plan 给这个工程加一个设置页，带深色模式开关
agent 只读探索并给出方案与验证命令；你批准后（或输入 /build）进入 build 状态动手改码、跑构建。
2. 给可验收的跨轮目标¶
/goal 让设置页在真机上能打开并截图；完成判据：真机截图里能看到开关；验证方式：harmony run 后 hilog 无 FATAL
GoalBar 显示状态；目标达成或明确失败时停止续跑。
3. 构建与真机验证¶
通过 harmony 工具的各 action 完成构建、安装、拉起与日志抓取；run 适合一次性走完「装包 + 拉起 + 短日志」验收。
4. 在 Web 里看真机日志¶
点侧边栏 hilog：选设备后查看实时日志，在浏览器内做级别（默认关闭 Debug）、进程、关键字过滤，无需重连。
README 另注：run 返回「日志为空」是正常结果，不等于没有崩溃。
适用场景与注意¶
适合谁：在 Windows 上用 DSH 开发 HarmonyOS 应用、希望 plan 审批、goal 盯进度、构建与 hdc 操作尽量少占对话轮次的开发者。
边界与风险（均来自 README）：
- 仅 Windows；依赖本机 DevEco 工具链与 hdc 环境。
- 插件与 DSH 同权限执行 shell 与文件操作；安装前应自查源码与 MIT 许可证。
- 签名未配置时无法真机安装 unsigned 包。
- 预设采用运行时注册，是为避免 profile
node_modules缺少大量@deepseek-ai/*依赖导致 Loader 解析失败；维护细节见仓库 docs/design-notes.md。
社区目录当前星标为 0（以目录页信息为准），不代表功能完整度；版本演进见仓库 CHANGELOG.md 与 Releases。
结尾¶
dsh-harmonyos-agent 把鸿蒙开发的「想清楚 → 盯目标 → 构建真机验证 → 看 hilog」收进 DSH 的 plan / goal / build 工作流，并用一个 harmony 工具和 Web hilog 面板减少手工串命令。
