常驻值守机器人 HAN102300/dsh-bot

dsh-bot — DSH 里的常驻 AI 队友

一句需求交给 Bot 长期值守；每次动作先演习、可批准、可整单回滚。

一个插件，运行在 DeepSeek Harness 里。

它是干什么的

用一句自然语言，把重复性的守护工作交给一个有记忆、有预算、可回滚的 AI 队友。

你只需要说：

「每过 4 小时报告一次我的服务运行状态」「每天早上 9 点汇总一下 Git 提交」「持续盯着这个目录，有新文件就整理归档」

Bot 会接手这件事：按时自动执行、记住每次的结果、把报告发给你——而你对它有三重控制权（见下）。

三分钟上手

1. 安装插件（见下文「安装」），重启 DeepSeek Harness
2. 在聊天框说需求：包含「每过 N 小时 / 每天 / 持续盯着」这类节奏词，Bot 面板会出现「新接手」角标
3. 确认接手：Bot 会先复述它理解的目标与节奏，你确认后它先跑一次演习（dry-run，无真实副作用）
4. 放行真实执行：演习没问题，说「真实执行吧」——之后到点自动运行
5. 看结果：
- 运行完成后收到系统通知（可在设置里改为「仅异常时打扰」+ 免打扰时段）
- 打开 DSH 设置 → Bot → 最近运行，每一轮的状态、token、费用、渠道（免费/付费）一目了然，点开看完整详情
- 运行报告全文在 ~/.dsh/bot/runs/ 按月归档

为什么值得信任：三根支柱

🧠 记得住

具名身份、独立工作区、跨会话记忆。它知道自己上次做到哪、你偏好什么格式、目标推进到第几轮——而不是每次醒来都是陌生人。

🎯 守得住

目标驱动（一次性任务 / 常驻守护），节奏到点自动跑。Bot 只能报告进展或标记卡住，「做完了」永远由你拍板——它不能自己宣布胜利。

🔄 收得回

这是与其他常驻 Agent 最大的差异：

| 风险 | Grok Bot / Dots | dsh-bot |
| 演习会真实执行（"演习发邮件" = 真发了） | 是 | 默认 dry-run，工具分发前拦截 |
| 停止 ≠ 撤销已完成的操作 | Dots 官方承认 | 执行前后双快照，一键整单回滚 |
| 成本失控 | 无上限 / 额度制黑箱 | 人民币预算熔断（运行中增量熔断）+ 花费逐轮透明 |
| 审计只有最近 20 条 | 是 | 全量保留，每次工具调用一条记录 |

一句话：大厂卖「AI 同事住进云电脑」，这里卖「这位同事干活前后你有一键后悔药」。

功能一览

- 24 个工具：Bot 管理 / 目标 / 记忆 / 执行 / 流程（Routine）/ 快照回滚 / 调度 / 通用联网抓取（http_get，防 SSRF + pick 路径提取），清单见 docs/TOOLS.md
- 运行记录 UI：设置页内固定高度滚动 / 分页器两种形态可切换，逐轮费用透明（免费渠道、付费渠道、无价目渠道三种标记分明）
- 系统通知：运行完成/失败桌面提醒，仅异常打扰模式 + 免打扰时段
- 模型兜底：环境变更导致绑定的模型不可用时自动切换到可运行渠道，并在运行记录中如实标注
- 成本三态展示：¥0 有两种含义（真免费 vs 算不出来），UI 上长得不一样

安装

从插件市场（推荐）：DSH 设置 → 插件市场 搜索 dsh-bot 从 npm
dsh plugin add dsh-bot
本地开发
dsh plugin add link:D:/path/to/dsh-bot

开发

npm run verify:all # typecheck + 静态检查 + 单测 + 构建 + client 契约 + e2e
npm run test # 330 个单测
node dev/gen-tools-doc.mjs # 重新生成工具清单文档

改动必须过 verify:all；工具数量与 HTTP 路由数量有注册断言（删了/漏了会红）。

模型渠道建议

| 渠道 | 适配状态 | 说明 |
| deepseek-official / deepseek-account | ✅ 推荐 | 验证最充分：文本协议 + 双轮回喂 + 流稳定性都打磨过 |
| deepseek-web | ✅ 可用 | 免费网页渠道 |
| 其他渠道（our-free-model / zcode / qoder / trae…） | ⚠️ 逐步优化 | 可能出现空回复或流中断；每个版本公告会注明本版优化了哪个渠道 |

遇到「模型返回了空内容」？ 九成是渠道兼容性问题——先换 DeepSeek 系渠道试试。

诚实限制清单

- 演习本身计费：dry-run 拦截的是工具执行，模型调用是真实的
- 桌面休眠：DSH Desktop 关闭/休眠时调度器停转，错过的轮次只补最后一次（面板有心跳指示）
- 单实例假设：两个 DSH 实例共用同一 ~/.dsh/bot 会互踩
- 通知依赖 GUI 进程：系统通知由 Web GUI 页面轮询驱动，浏览器页面完全关闭时不会响（宿主未向插件暴露原生通知 API）
- 未知成本模型：价格表没覆盖的模型显示「无价目」而不是 ¥0——它可能真的花钱
- 工具能力边界：Bot 工具来自插件注册 + 宿主暴露两层；宿主环境差异看 ~/.dsh/bot/.plugin-loaded.json 诊断

文档

- 立意与竞品 — 为什么做「可托付」这一层
- 技术设计
- 工具清单（自动生成）
- 宿主契约 — 宿主实际怎么工作，以及踩过的七个坑
- 经验教训 — 从事故文档蒸馏的工程原则

License

MIT