hmharness

自 进 化 · 零 依 赖

为鸿蒙 (HarmonyOS/OpenHarmony) 开发全流程而生的自进化智能体框架 —— 零依赖内核 + 自进化一等公民 + MCP 生态借力。一句话创建工程、构建、装机、跑模拟器;每一步进化都有基准门禁与回滚。

$ hmh tui ⚙ hmharness · your-model · my-app · ○ idle 网页端已就绪 → http://127.0.0.1:7788创建鸿蒙工程 my-app:登录页+首页,构建装进模拟器跑起来 harmony_project_create → pages+modules · OK harmony_build → hvigorw · BUILD SUCCESSFUL harmony_emulator_start → running harmony_install → harmony_launch → ✓ ability started

先看证明,再一命令安装

两条竖屏演示:36 秒产品概览;40.6 秒从 GitHub 仓库进入 npm 安装。

产品概览 · 36 秒
功能篇 01 · 一命令安装

不继承任何上游,全部自持

七包单仓:零依赖内核 + 自进化 + 鸿蒙原生域 + 运维看家 + 执行层 + 双前端。while 循环内核、上下文压缩、审批门禁、会话审计全部自研,MCP 生态即插即用。

🏗️

参数化工程脚手架

harmony_project_create 一次调用生成多页面 + feature HAP + har 库的任意结构;hvigor 真实构建验证。

🖥️

模拟器全生命周期(零 IDE)

harmony_emulator_* 直接驱动官方无头 CLI:发现/目录/创建/启动/停止/删除,全系机型与变体即刻部署,无需打开 DevEco Studio。

📲

构建 · 装机 · 运行

hvigor 构建、hdc 安装/启动/日志/卸载、仓颉 cjpm 构建、官方 codelinter 门禁 —— 设备写操作全部走审批。

🧠

自进化双门禁

洞察挖掘 → 技能提案 → 训练门 A/B 基准(双样本,运气过不了门)→ 晋升进金丝雀(20% 会话采样)→ impact 判定(≥8 会话且 ≥10% 差才转正,有害即退役)→ 回归即回滚;判定记录原样发布在证据页

🔌

MCP 双向生态

客户端:手写零依赖(stdio + Streamable HTTP),5800+ 社区服务器即插即用;服务器:hmh mcp-serve 把鸿蒙工具链以原生工具供给 Claude Code / Codex / 任意 MCP 宿主,按工具名粒度豁免审批。

🛰️

运维看家(生态雷达)

8 源开源鸿蒙雷达每日 diff 脚手架与门禁假设,模型写简报、模板降级;issue 流 AI 只起草、人批准才发布,draft PR + 身份署名。

🎛️

双前端

全屏 TUI(斜杠面板 ↑↓ 选择、滚轮翻页、/resume 会话恢复选择器、右对齐输入气泡、内置更新提醒)+ Web(浏览器审批、会话回放、工作区切换);hmh tui 一条命令自动带起网页端。

🛡️

安全内建

deny-first 审批门禁做进循环内核;破坏性命令模式硬拒绝;进化提案过防投毒筛选;会话全量追加式审计;hmh state backup 进化状态一键快照与恢复。

🌍

国际化 & 多厂商

zh / en 双语界面与系统提示(--locale=en);任意 OpenAI 兼容厂商按用途路由(chat / vision / evolve / bench)。

📐

模型感知上下文工程

上下文窗口登记表,压缩预算随模型窗口自适应(128K=旧默认,未知模型零变化);超长会话滚动摘要(被逐内容先蒸馏再丢弃);工作区记忆隔离;可选 embedding 混合检索。

7单仓七包
0运行时依赖(内核)
115单元测试(CI 全绿)
2门禁(训练+保留)

四步上手

Node ≥ 22 + 鸿蒙工具链(hvigorw / hdc / DevEco 或命令行等价物)。任意 OpenAI 兼容厂商均可。

1
npm 安装(已发布,零构建)
npm install -g @hmharness/cli   # Node >= 22
2
初始化并配置厂商(任意 OpenAI 兼容端点;支持多厂商按用途路由)
hmh init
notepad %USERPROFILE%\.hmharness\config.json
  { "provider": { "baseUrl": "…", "apiKey": "…", "model": "…" } }
3
一条命令起飞:全屏 TUI,网页端自动就绪
hmh tui          # 全屏 TUI + 自动后台启动网页端
hmh web start    # 或单独后台启动网页(零窗口,stop/status)
4
让它自己变强
hmh evolve --every=30   # 常驻自进化(双门禁,回归即回滚)

严格提升,否则回退

借鉴 Darwin Gödel Machine 与 GDPevo 的机制教训:每轮优化有度量、有快照、防背题、可回滚;进化循环无法触碰配置与安全设置。

洞察 insights
提案 drafts
训练门 bench A/B ×2
晋升 snapshot
保留门 holdout

上一次会话踩过的坑,下一次开局就知道(检索式长期记忆自动注入,蒸馏层只增不删);每一轮进化都落在 evolution/log.jsonl,全程可审计。

模型无关 · 按用途路由

任意 OpenAI 兼容厂商:GLM / DeepSeek / 通义 / Kimi / OpenRouter / Anthropic / OpenAI / Ollama / LM Studio……chat、vision、evolve、bench 各走各的,密钥只存在本机 HMH_HOME。

{
  "providers": { "a": { "baseUrl": "…", "model": "strong" },
                 "v": { "baseUrl": "…", "model": "vision" } },
  "routing": { "chat": "a", "vision": "v", "evolve": "a", "bench": "a" }
}