纯 Node.js（≥18.17）打造，无任何 npm 运行时依赖。缓存命中计价（命中价仅为未命中的 1/30）、Batch 半价批处理、避峰调度、自动路由 pro⇄flash——「省钱」是刻进内核的系统设计，不是营销话术。
# 一行安装（自动装 Node）
curl -fsSL https://gitee.com/MingDaoTCM/MingDao-harness/raw/main/install.sh | bash -s -- gitee
装完 mingdao init 配置 DeepSeek Key，输入 mingdao 开始对话；Windows 用户解压后双击 install.bat。
内置 WebUI 的 Electron 桌面应用：托盘常驻、窗口记忆、权限收紧、自动更新。安装即用，mingdao init 首次配置后即可对话。四平台安装包全部官网直连下载（国内极速，不走 GitHub）。⚠ ≤0.1.66 桌面版自动更新存在加载缺陷：请手动下载安装一次 v0.1.67（此后自动更新恢复正常）。
安装后从开始菜单启动；首次运行若出现 SmartScreen 提示，点「更多信息 → 仍要运行」（未签名构建）。
未公证：首次打开请在「系统设置 → 隐私与安全性」点「仍要打开」。
deb：sudo apt install ./mingdao-0.1.67-amd64.deb；AppImage：chmod +x 后直接运行。
🔒 校验（sha256sum 文件名 比对）：exe b8861a23103d1575… · dmg-arm64 026ada17d0178da6… · dmg-x64 38cb7a8b48e95743… · deb aed33f169ffcea4d… · AppImage a016fde104293683…； 全部安装包由 CI 打 tag 时自动构建，官网同域直出、国内直连极速；桌面版自动更新走官网 feed（/updates/latest*.yml）。
全部安装包由 CI 打 tag 时自动构建，官网同域直出、国内直连极速；桌面版自动更新走官网 feed（/updates/latest*.yml）。
📈 累计下载 — 份 · 今日 — 份（历史版本累计 · 每 5 分钟更新）。
三步完成安装；Windows 解压后双击 install.bat（自动经 winget 装 Node）。
上方三平台任选一行（Gitee/GitCode 国内速度快，三平台内容一致）；无管理员权限自动装到 ~/.local/bin，仓库常驻、mingdao update 一键自更新（升级后冒烟失败自动回滚）。
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 会话级工作空间，多任务并行互不串目录。
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 按模型分账。
交付物卡片（路径 + 使用说明）、自动生成会话标题、结束静默同步云端。
用户记忆（AGENTS.md）+ 会话日志；新会话默认全新开始，「带上文」显式开启。
本地零依赖直跑；服务器上 WebUI + 云同步服务端一条龙。
一次性/周期/链式依赖，单守护进程调度器，重启自愈。
SKILL.md 格式，三级来源（用户/项目/内置），线上 registry 一键安装。
DeepSeek-V4-Flash-Vision-Exp 内置，WebUI 上传图片/文本附件。
分享码协作、跨设备冲突图形化三选一、注册开关/邀请码。
三平台镜像内容一致，你在哪个平台浏览就用哪个（Gitee / GitCode 国内速度快）。
使用文档见仓库 README.md 与 docs/；WebUI 由 mingdao web 一键启动。