纯 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 f3e5a79592153e534576dc8b1d9db3d6e5e13480fa5c9855ed5732870804d410
✓ v0.2.5 起 macOS 版已由 Apple Developer ID 签名并完成公证——下载后双击直接打开，Gatekeeper 正常放行，无需任何绕过操作。若你之前下载的旧版（未公证）仍被阻止：删除旧应用，到本页重新下载最新版本即可。
arm64 sha256 203c171ed403ab7c5870b2ad91a36c343a94109a2a6bc0d490628fe3714a29bb
x64 sha256 678091e057ef23c3460b73e37da6700ac5a9d2edc061efa07326ff530033365b
deb：sudo apt install ./mingdao-0.4.0-amd64.deb；AppImage：chmod +x 后直接运行。
deb sha256 3dfb776235c956085a7b1bb6f90cae76ff6ee1bf0aac80c14b23808a586ef41b
AppImage sha256 24368bdd32efa2d7e1a65acbd64218f608bdcd9e5fc71071f7f8eede39b10a80
全部安装包由 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 定时任务。
与 Hermes 社区一致的上手路径：先用起来，再进阶。
mingdao web 一键启动：流式思考实况、工具卡片、权限确认弹窗、会话管理、全部设置面板。
mingdao 终端对话：/plan 先计划后执行、/compact 压缩、/memory 长期记忆、/cost 分账、Tab 补全。
VS Code 侧边栏与 JetBrains 工具窗深度集成，选中代码直接发问。
mingdao run 后台任务、schedule add 定时/链式依赖，支持 --offpeak 避峰执行。
架构干净、安全默认、测试真实存在——三轮外部评估 8.4–8.9/10。
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 三分钟上手。
预设声明工具白名单后，名单外工具对模型不可见、被调用也会硬拦并回填拒绝——安全边界随预设走，定制不改安全默认。
只读审计 / 代码审查开箱即用与「DeepSeek 省钱」并列主攻：上下文窗口感知预算（75% 舒适区）、分层超时（慢 prefill 不被误杀）、边缘强制压缩——本地小模型长任务不中断，数据不出门。
v0.3.2 能力升格为战略完整战略复盘与路线图随仓库发布（docs/STRATEGY-NEXT.md）：护城河、错位竞争、阶段路线。零依赖根基不动摇——不引入插件内核、不做云平台账号体系。
18 天 84 版，方向不漂移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 一键启动。