READMESource: main@96eed527
dsh-bot — DSH 里的常驻 AI 队友
一句需求交给 Bot 长期值守;每次动作先演习、可批准、可整单回滚。
一个运行在 DeepSeek Harness 里的插件。
它是干什么的
用一句自然语言,把重复性的守护工作交给一个有记忆、有预算、可回滚的 AI 队友。
你只需要说:
「每过 4 小时报告一次我的服务运行状态」 「每天早上 9 点汇总一下 Git 提交」 「持续盯着这个目录,有新文件就整理归档」
Bot 会接手这件事:按时自动执行、记住每次的结果、把报告发给你——而你对它有三重控制权(见下)。
三分钟上手
- 安装插件(见下文「安装」),重启 DeepSeek Harness
- 在聊天框说需求:包含「每过 N 小时 / 每天 / 持续盯着」这类节奏词,Bot 面板会出现「新接手」角标
- 确认接手:Bot 会先复述它理解的目标与节奏,你确认后它先跑一次演习(dry-run,无真实副作用)
- 放行真实执行:演习没问题,说「真实执行吧」——之后到点自动运行
- 看结果:
- 运行完成后收到系统通知(可在设置里改为「仅异常时打扰」+ 免打扰时段)
- 打开 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 路由数量有注册断言(删了/漏了会红)。
诚实限制清单
- 演习本身计费:dry-run 拦截的是工具执行,模型调用是真实的
- 桌面休眠:DSH Desktop 关闭/休眠时调度器停转,错过的轮次只补最后一次(面板有心跳指示)
- 单实例假设:两个 DSH 实例共用同一
~/.dsh/bot会互踩 - 通知依赖 GUI 进程:系统通知由 Web GUI 页面轮询驱动,浏览器页面完全关闭时不会响(宿主未向插件暴露原生通知 API)
- 未知成本模型:价格表没覆盖的模型显示「无价目」而不是 ¥0——它可能真的花钱
- 工具能力边界:Bot 工具来自插件注册 + 宿主暴露两层;宿主环境差异看
~/.dsh/bot/.plugin-loaded.json诊断
文档
License
MIT
No comments yet. Be the first to write one.