纯 Node.js（≥18.17）零运行时依赖，装完即用。好用＝任务续跑、项目记忆、长会话不丢上下文；省钱＝缓存命中计价（1/30）、Batch 半价、避峰调度、自动路由 pro⇄flash；省心＝一键诊断、三平台 CI 全绿、零构建开箱即用。省钱是刻进内核的系统设计，不是营销话术。
MingDao 品牌主站 · 道法AI —— 传统文化数字化展示平台 ↗
# 一行安装（自动装 Node）
curl -fsSL https://gitee.com/MingDaoTCM/MingDao-harness/raw/main/install.sh | bash -s -- gitee
装完 mingdao init 配置 DeepSeek Key，输入 mingdao 开始对话；npm 用户升级 npm update -g mingdao-harness；Windows 用户解压后双击 install.bat。
内置 WebUI 的 Electron 桌面应用：托盘常驻、窗口记忆、权限收紧、自动更新。安装即用，mingdao init 首次配置后即可对话。四平台安装包全部官网直连下载（国内极速，不走 GitHub）。✓ v0.1.67+ 桌面版启动后自动提示更新（官网 feed 已刷新）；更早版本请手动下载一次。
安装后从开始菜单启动；首次运行若出现 SmartScreen 提示，点「更多信息 → 仍要运行」（未签名构建）。
sha256 64ef23a59dd4886b929f87c599dd67cb4f181785c231f8f36d85934c90bc3780
✓ v0.2.5 起 macOS 版已由 Apple Developer ID 签名并完成公证——下载后双击直接打开，Gatekeeper 正常放行，无需任何绕过操作。若你之前下载的旧版（未公证）仍被阻止：删除旧应用，到本页重新下载最新版本即可。
arm64 sha256 f1ab8087be20f77b9a2baabd570533fb83a8c4c843ff5734c4959af18a4db5f7
x64 sha256 dd58b2403350e83e4e53fbf02d8c28ac1a784850fffc2513f56bc286668e369f
deb：sudo apt install ./mingdao-0.4.3-amd64.deb；AppImage：chmod +x 后直接运行。
deb sha256 ace18f702c372a939b03341c5a44b673e4bec2f250fd41fd2a9a93d7258a7161
AppImage sha256 80a29ef826ee8fd28e9c096ee24878409b040663bfc40ecc2aa4176abf54ad75
全部安装包由 CI 打 tag 时自动构建，官网同域直出、国内直连极速；桌面版自动更新走官网 feed（/updates/latest*.yml）。
📈 累计下载 — 份 · 今日 — 份
（历史版本累计 · 每 5 分钟更新）
三步完成安装；Windows 解压后双击 install.bat（自动经 winget 装 Node）。
上方四选一：Gitee/GitCode/GitHub 一行安装（自动装 Node，无管理员权限自动装到 ~/.local/bin，仓库常驻、mingdao update 一键自更新）；npm 全局（已有 Node ≥18.17 时最快，npm i -g mingdao-harness，升级 npm update -g）。
mingdao init 交互式配置 DeepSeek（API Key 独立存 600 权限凭证库，绝不进 config.json/仓库）；模型列表以官方 /models 线上名单为准，新模型发布自动出现。
mingdao 进 TUI 对话；mingdao web 一键 WebUI（PWA 可装桌面，多任务并行）；VS Code / JetBrains 插件开箱即用；mingdao schedule add 定时任务。
先用起来，再进阶。
mingdao web 一键启动：流式思考实况、工具卡片、权限确认弹窗、会话管理、全部设置面板。
mingdao 终端对话：/plan 先计划后执行、/compact 压缩、/memory 长期记忆、/cost 分账、Tab 补全。
VS Code 侧边栏与 JetBrains 工具窗深度集成，选中代码直接发问。
mingdao run 后台任务、schedule add 定时/链式依赖，支持 --offpeak 避峰执行。
架构干净、安全默认、测试真实存在——三平台 CI 全绿，1050+ 断言随版本回归。
SSE 解析、BPE tokenizer、MCP 客户端、HTTP 服务器、云同步全部只用 node: 内置模块，装完即用。
缓存命中计价 + 仪表盘、峰谷计价（周末全天低价）、Batch 半价、避峰调度、费用护栏。
14 内置常驻 + 22 可安装技能库；线上 registry 逐文件 sha256 防篡改，渐进披露只注入名称。
MCP 客户端（9 个生态预设一键接入）、Hooks 钩子、自定义 Provider 模块、自建企业内 registry。
跨设备会话同步、分享码协作、冲突三选一绝不丢数据；服务端零依赖单文件即可自建。
权限三档 + 工具级规则、bash 沙箱、WebUI 令牌 + Host 白名单、审计日志、凭证 600 隔离。
超预算自动压缩（80% 触发、压到 60%），早期段落压成摘要注入，前缀字节稳定保缓存命中。
增量索引全文检索（中文 bigram 分词）；WebUI 会话级工作空间，多任务并行互不串目录。
这一版是 MingDao Harness 自 0.1.0 以来最大的一次定位升级：垂直产品 × 开放内核——保持 DeepSeek 省钱 Coding Agent 的垂直深度，同时把内核正式开放给开发者：不改一行源码，定制你自己的智能体。
一个声明式 JSON = 系统提示 + 工具白名单 + 权限 + 模型 + 参数。项目级 .mingdao/presets/、用户级 ~/.mingdao/presets/、内置三层遮蔽；字段严格校验，拼错直接报错。
registerTool({name, schema, run}) 程序化注册，或 config.tools 声明式 shell 命令包装（参数经环境变量传递，杜绝注入）。自定义工具与内置工具同链路：权限门控、审计、省钱 schema 瘦身、预设白名单全部生效。
import { createAgent, createProvider, registerTool } from 'mingdao-harness'——把 MingDao 嵌进你自己的程序。24 个 @stable 导出有契约测试锁定，minor 版本内向后兼容；docs/DEVELOPER.md 三分钟上手。
预设声明工具白名单后，名单外工具对模型不可见、被调用也会硬拦并回填拒绝——安全边界随预设走，定制不改安全默认。
只读审计 / 代码审查开箱即用上下文窗口感知预算（75% 舒适区）、分层超时（慢 prefill 不被误杀）、边缘强制压缩——本地小模型长任务不中断，数据不出门。
本地部署零门槛MIT 开源，GitHub / Gitee / GitCode 三平台镜像内容一致；CHANGELOG 全程公开，省钱基准可复现（docs/SAVINGS-BENCHMARK.md）。
开源透明，无黑箱v0.4.3 依据完整技术审计报告偿还 P1×3 + P2×6 正确性债，并给 macOS 本地模型长任务的 network error 补上诊断闭环。
SSE 流异常补全量诊断日志（错误形态 + 回合状态）；服务端断连日志区分「正常收尾 vs 客户端中途断开」；中断提示改为「检查点已保存，发『继续』续跑」。
下次复现即可一锤定音WebUI 自启 100% 失效（spawn 目标修正）；云同步会话落盘锁内原子写（并发不串扰）；技能安装改异步（不再冻结事件循环 120 秒）。
重构遗留与并发边界技能 URL 安装 SSRF 防护、费用 TTL 口径、统计轮转加锁、autoTitle 误报、--format json 输出纯净、孤儿 tool_calls 清理。
正确性与安全一致家目录脱敏边界、预设 name 字段遮蔽、IPv6 本地判定、hook 环境变量过滤、sandbox 空串归一化；项目简称 MDH 自本版起统一使用。
P3 配额清理零依赖开源框架，持续小步迭代。以下是近期版本的「新增 / 变化」速览，完整日志见仓库 CHANGELOG.md。
| 版本 | 新增 / 变化 |
|---|---|
| v0.4.3 09-06 · 正确性收尾 |
network error 诊断闭环（渲染层全量异常日志 + 服务端断连日志 + 可恢复提示）。审计修复：WebUI 自启失效、云同步锁内原子写、技能安装异步化、SSRF 防护、费用 TTL、统计轮转加锁、autoTitle 误报、--format json 纯净、孤儿 tool_calls 清理 + 低成本 P3×5。项目简称 MDH 统一使用。 |
| v0.4.2 09-06 · 体验/本地模型 |
预设下拉体验：桌面版打包补内置预设目录（下拉恒空根因）、tooltip 秒现、选中即弹「这是什么 + 覆盖字段」、「无预设」显式退出、内置预设 permission auto→readonly。本地模型 507 缓解：只读子代理串行化、压缩触发提前 60%、507 错误附可操作提示。 |
| v0.4.1 09-06 · 安全版本 |
安全债清零：路径穿越防护、SSRF 302 复检、权限前缀白名单化、预设提权拦截、MCP 只读仅信任 trusted（P0×5）+ P1/P2 共 12 项正确性与质量修复。macOS 本地模型双根因：子代理无反馈（routing 池外跟随当前模型）+ 输出截断 text=0（兜底总结轻量化）。诊断新增「当前模型能力」报告；桌面版自定义模型「修改」可直接改上下文窗口/最大输出。 |
| v0.4.0 09-05 · 开放内核 |
Agent Preset（声明式智能体预设，三级遮蔽 + 白名单硬拦截）· 第三方工具（registerTool + config.tools）· 公共 API 冻结（24 个 @stable 导出契约锁定，见 API 文档）· 定位升级「垂直产品 × 开放内核」。 |
| v0.3.2 09-05 · 本地模型 |
本地模型自适应：上下文窗口感知预算（75% 舒适区）、分层超时（慢 prefill 不误杀）、边缘检测强制压缩、工具结果按窗口/16 截断——资源受限的本地部署长任务不再中断。 |
| v0.3.1 09-04 · 省钱仪表盘 |
真·省钱仪表盘（命中率环状图 + 14 天趋势 + 模型/工具 Top5）· 语义检索（项目记忆按任务取相关条目）· 只读调研工具（git/fetch）· 自动续跑（跑满步数注入进度摘要续下一轮）。 |
| v0.3.0 及更早 08-28 起 |
记忆与长跑（项目级记忆 .mingdao/memory.md + 任务续跑检查点 + mingdao diagnose）· 省钱体系成型（缓存命中计价、Batch 半价、避峰调度、自动路由、精确 tokenizer、费用护栏）· 结构治理（路由拆分、SPA 外置、类型安全归零）。 |
💰 省钱效果可复现、可回归：基准见仓库 docs/SAVINGS-BENCHMARK.md。
DeepSeek-V4 的缓存计价（命中 1/30 价）决定了 Harness 的核心竞争力 = 让每个请求的前缀字节稳定。MingDao Harness 围绕这一点做了系统设计。
hit/miss 拆分计费 + 命中率仪表盘，口径不一致时余量按未命中计（不漏计）。
0.15 元 vs 4.5 元 /Mmingdao batch 问题.txt 单轮批量任务走批处理通道，结果落盘并计入分账。
--offpeak 高峰（工作日 9:00–14:00）自动顺延 14:00 后；周末全天闲时（官方确认）。
pro 规划 / flash 执行，分类缓存 + 会话粘滞；系统提示跨模型字节恒定，路由翻转不破缓存前缀。
日常省 67%官方词表 BPE：GPT-2 字节映射 + Split 预分词 + 堆合并，与 HF tokenizers 逐值一致。
±2 倍误差 → 0costGuard 每日上限：warn 提醒 / block 暂停，按真实口径（含缓存折扣与半价）累计。
从任务到结果，全链路可观测、可追溯。
启发式零成本 + 分类器兜底（LRU 缓存/会话粘滞），生成类任务自动切大输出模型防截断。
流式思考实况、工具卡片逐个闪烁、只读工具与只读子代理并行执行；权限引擎 + 沙箱 + 敏感环境变量过滤。
每次调用落审计日志（sk- 脱敏）；缓存命中率、费用、节省额实时入账，/cost 按模型分账。
交付物卡片（路径 + 使用说明）、自动生成会话标题、结束静默同步云端。
每个工作空间自动沉淀「决定/事实/教训」到 .mingdao/memory.md，换会话不重来、换项目不串。
跑到步数上限自动落检查点，--continue / WebUI 从断点续跑，已完成文件不重做。
mingdao diagnose 生成脱敏诊断包（日志/审计/配置/工作空间），贴给反馈即查。
本地零依赖直跑；服务器上 WebUI + 云同步服务端一条龙。
一次性/周期/链式依赖，单守护进程调度器，重启自愈。
SKILL.md 格式，三级来源（用户/项目/内置），线上 registry 一键安装。
DeepSeek-V4-Flash-Vision-Exp 内置，WebUI 上传图片/文本附件。
分享码协作、跨设备冲突图形化三选一、注册开关/邀请码。
三平台镜像内容一致，你在哪个平台浏览就用哪个（Gitee / GitCode 国内速度快）。
使用文档见仓库 README.md 与 docs/；WebUI 由 mingdao web 一键启动。