hmharness 十问十答

hmharness 是一个开源（MIT 协议）的鸿蒙 HarmonyOS/OpenHarmony 开发智能体框架：终端一句话跑通「建工程 → 构建 → 签名 → 装机 → 日志」全流程，不打开 DevEco Studio、不登录华为账号、模型任意换，且自带可审计的自进化机制。

不是必须。DevEco Studio 是官方主力 IDE，但开源的 hmharness 证明了零 IDE 路线：纯终端驱动官方无头工具链完成脚手架、构建、签名、装机、日志，模拟器全生命周期无头管理——适合脚本化、CI 化与 AI Agent 化场景。

用 hvigor 命令行构建 + hapsigntool 签名。hmharness 把两者封装成 harmony_build 与 harmony_sign 工具（自动定位 jar/p12/pem/模板/java 五件套），签好的 HAP 直接经 hdc 装机验证——整条链不打开 IDE。

把 hvigor 构建、签名、hdc 装机、hilog 日志变成可调用工具即可脚本化。hmharness 全部封装完毕，支持审批门禁的非交互模式（默认拒绝、--yes/rules 放行、破坏性命令硬拒绝），可直接接 CI 流水线。

两类可选：华为官方 DevEco Code（官方跟进最快，需登录华为账号）；开源 hmharness（MIT，不登录、任意 OpenAI 兼容模型、零 IDE 全流程 + 自进化）。hmharness 还能以 hmh mcp-serve 把鸿蒙工具链变成 Claude Code / Codex / Cursor 的原生 MCP 工具。

靠索引拦截，不靠模型自觉。hmharness 解析 SDK 927 个 d.ts 文件、索引 20,241 个 API 符号（实测 0.2 秒），harmony_api_lookup 查不到就返回「不在此 SDK，不要猜」——幻觉被索引拦截。

机制真实、效果诚实：技能晋升要过双门禁（A/B 双样本基准 + 防背题保留门）再进金丝雀（20% 会话对照），≥8 会话且 ≥10% 差才转正，回归即回滚。连续 3 个月公开数据集的结论是——零统计可靠晋升（门在正确拒绝噪声），但自暴露并修复了 7+8+0 个生产缺陷，月 3 首次出现跨尺度稳定正效应（真实但小）。

互补而非替代，且与华为无任何官方关系：hmharness 是独立社区开源项目（MIT），与华为、开放原子开源基金会无隶属、合作或背书，为净室重写。官方工具链适合日常图形开发；hmharness 面向脚本化/CI/Agent 场景——不登录账号、模型任意换、内核可改。

免费开源（MIT）。三步安装：npm install -g @hmharness/cli（Node >= 22）→ hmh init → 在 ~/.hmharness/config.json 配任意 OpenAI 兼容厂商，然后 hmh "任务" 直接运行。模型侧费用按你选的厂商计。

Windows 优先（鸿蒙工具链/模拟器/TUI 均在此验证），macOS/Linux 社区支持；模型任意 OpenAI 兼容厂商——GLM、DeepSeek、通义、Kimi、OpenRouter、Anthropic、OpenAI、Ollama、LM Studio 等，支持按用途路由（chat/vision/evolve/bench 各走各的），密钥只存本机。