前言¶
DeepSeek Harness(dsh)的核心理念是「一切皆插件」:模型、工具、技能、会话都可以换成社区包。智能体很擅长一次性给出完整计划,但对执行功能吃力的人来说,计划本身经常变成负担——清单越长,启动越难。
dsh-adhd-copilot 就是冲着这件事做的。它不要求你先自律、再完成全部,而是扫描「拖着 / 过载 / 自责」这类状态,路由到对应模块,每次只给 1 到 3 个能带走的最小动作。本文按社区目录页、GitHub 仓库 README、SKILL.md 和源码交叉核对后整理:它是什么、装怎么装、实际怎么用。
社区插件目录 https://deepseek-harness-plugin.com/ 是独立站点,和 DeepSeek / 幻方没有官方从属关系,不要把它当成官方应用商店。
这是什么¶
dsh-adhd-copilot 是一款面向 DeepSeek Harness 的技能插件,由 zimai233 维护,仓库在 GitHub:zimai233/dsh-adhd-copilot。许可证为 MIT,package.json 版本号为 0.1.0,主要语言是 JavaScript。截至 2026-08-18,目录页和 GitHub 都显示 3 星。
目录页上的定位是:面向 ADHD 的行为教练技能,用温和、可执行的结构帮你推进任务。仓库 README 写得更具体:把用户从「想做但动不了」带到「带走一个最小行动」。
它解决的不是「帮你写一份周报大纲」,而是这类卡住的时刻:
- 想开始但动不了(启动困难)
- 事情太多,不知道先做哪个(过载)
- 容易分心、坐不住
- 低估任务耗时
- 没劲、无聊、没动力
- 因没完成而自责
- 不知道这个任务该怎么下手
运行时它只向智能体注册一个工具:adhd_breakdown。源码注释写明:参考 agent 里没有确认可用的 skills 服务,因此插件只注册工具,更稳妥;完整教练方法论仍以 skills/adhd-copilot/SKILL.md 和 11 份 references/*.md 原样打进 npm 包的 files 字段,作为可独立阅读的交付物。
核心功能¶
三条原则¶
SKILL.md 和 README 共用三条驱动理念:
- 永远只推动下一步,不要求完成全部。
- 可带走行动:每条回复给出用户能独立执行的最小动作,不需要回到聊天框;反馈循环全部可选。
- 质量地板:内容质量高于格式;规则和好答案冲突时,规则让路。
references/core-workflow.md 还列出五条认知事实,用来解释为什么步骤必须短、估时必须落到分钟:工作记忆很小、知道不等于做到、启动最难、时间感失真、可见进度才有意义。
一个工具,八个模块¶
智能体调用 adhd_breakdown 时,会扫描 task 和 context 里的状态信号,按优先级 情绪 > 结构 > 启动 路由到模块。源码里的顺序是:自责(F)和没劲(E)先处理,再清理过载(B),最后才启动(A)。
| 状态 | 典型信号 | 模块 | 一句话规则 |
|---|---|---|---|
| A 启动困难 | 做不了 / 拖着 | M1 任务破碎机 | 一次 1-3 步,每步小于 60 秒 |
| B 事情太多 | 好多事情 / 脑子乱 | M2 外部大脑 | 现在区只留 1 件事 + 唯一 Next Action |
| C 容易分心 | 坐不住 / 看手机 | M4 起跑与回归仪式 | 给自足启动指令,检查点可选 |
| D 时间误估 | 怎么花这么久 | M6 时间审计员 | 预计 vs 现实:准备 / 执行 / 中断缓冲 |
| E 没动力 | 太无聊 / 不想做 | M3 多巴胺建筑师 | 先问电量,再配开胃菜 / 主菜 / 配菜 |
| F 自责 | 又失败了 | M7 失败重启 | 停止评价 → 缩小目标 → 一个 30 秒动作 |
| G 不知道怎么做 | 该怎么做 / 怎么选 | M8 选路器 | 2-3 个框架 → 标陷阱 → 收敛到 1 个行动 |
M5「兴趣游戏化」不走默认路由,只有用户明确要求(opt-in)时才会包装成 RPG / 认真 / 极简叙事。
工具返回的结构化字段在 README 里写得很清楚:module / moduleName、nextAction(30 秒内能做)、whyNow、timeboxEstimate(具体分钟,不用「一会儿」)、energyRequired、steps(1-3 步)。可选参数包括:battery(M3 电量:10 / 30 / 60 / 90)、narrative(M5)、estimatedMinutes(M6)、parked / dropped(M2 的稍后 / 废弃清单)。
Pre-flight 门和输出纪律¶
不是每句话都会套教练流程:
- 无任务信号(闲聊)→ 静默,零干扰
- 请求很小(一句话提问)→ 直接回答,不套流程
- 信号模糊 → 给出 A-G 自助菜单,让用户自己选,减少误判
- 信号明确 → 直接进对应模块
输出纪律写在 references/output-discipline.md:首行就是下一步行动;编号步骤一次不超过 3 步;结尾再给一个 30 秒内能做的动作;表扬必须绑到具体胜利,禁止「加油你能行」;AI 无法在执行期间主动出现,因此绝不假装有计时器。
实现上是纯 ESM,零构建、零运行时依赖。package.json 通过 "dsh": { "bundle": { "patch": "./cordis.patch.yml" } } 声明 Cordis 层,补丁文件把插件以 id: adhd-copilot 插入当前 profile。
安装与启用¶
社区目录页给出的安装命令如下,在已经装好 dsh CLI 的终端里运行即可:
dsh plugin add github:zimai233/dsh-adhd-copilot
官方 CLI 习惯带上 profile。仓库 README 的写法是:
dsh plugin --profile myprofile add github:zimai233/dsh-adhd-copilot
需要可复现安装时,把 commit 哈希钉死。目录页的格式是 github:zimai233/dsh-adhd-copilot#commit。截至 2026-08-18,仓库 master 最新提交为 6527cb64b11b7265ba576e195bd008a5aa066be5:
dsh plugin add github:zimai233/dsh-adhd-copilot#6527cb64b11b7265ba576e195bd008a5aa066be5
README 还写了 dsh plugin --profile myprofile add dsh-adhd-copilot(按 npm 包名安装)。核对 npm 注册表时,dsh-adhd-copilot 返回 404,当前应以 GitHub 源为准,不要默认走 npm。
目录页和 dsh 文档都提醒:插件以当前 dsh 进程的权限运行,安装时可能执行代码。安装前请检查源代码仓库和许可证。
典型用法¶
装好后,用自然语言对 agent 说话即可,不必手写工具调用。README 给了三句触发语:
「我拖着不写周报,两周了,帮我开始。」
「好多事情堆着,脑子乱成一团,不知道先做哪个。」
「我又没做完,我怎么这么差。」
第一句会命中 M1。README 里的结构化拆解示例是:
{
"module": "M1",
"moduleName": "任务破碎机 (Task Breaker)",
"nextAction": "打开与「周报」相关的文件或页面(30 秒内)",
"whyNow": "启动最难:第一个动作必须明显、微小、现在就能做。一次只给 1-3 步,每步 <60 秒,跑完再要。",
"timeboxEstimate": "第一步 <60 秒;本轮 2 步,跑完再要下一步",
"energyRequired": "低(仅需打开文件)",
"steps": ["打开与「周报」相关的文件或页面(30 秒内)", "写下这一行标题:「周报」"]
}
渲染成教练回复后,大致是:
周报,先别想完成。只做第一步:
1. 打开与「周报」相关的文件或页面(30 秒内)
2. 写下这一行标题:「周报」每步 <60 秒。做完回复「完成」(可选,不阻塞)。你开始了,这一步就成了。
第三句会命中 M7(失败重启)。SKILL.md 里的对应回复是:先停评价,再给一个 30 秒动作——打开相关文件即可,不要求把任务做完。
仓库自带 npm test(node --test),覆盖状态扫描、Pre-flight 静默、模糊菜单、以及技能文件是否齐全。需要核对拆解逻辑时,可以直接跑测试,不必先接上真实对话。
适用场景与注意事项¶
适合已经在用 DeepSeek Harness、执行时经常卡在「启动 / 过载 / 自责」的人。它不是待办应用,也不会替你盯着番茄钟。仓库「Honest by design」一节写得很直白:
- 没有计时器:AI 无法在执行期间出现,中途检查点全部可选。
- 不承诺跨会话记忆:只有平台本身提供长期记忆时才会持久化。
- 零打扰:没有任务信号时完全静默。
- 安全边界:这是执行辅助,不是医疗诊断或治疗工具。用户表现出情绪危机或自伤信号时,应温和建议寻求专业帮助,而不是继续推任务。
SKILL.md 还列出几条反模式,安装后如果智能体仍在一次甩出完整清单、给二十个选项让你自己挑、或说「你应该自律」,就说明没有按这套纪律在走。
插件以当前 dsh 进程权限运行。安装前请打开 https://github.com/zimai233/dsh-adhd-copilot 查看源码和 MIT 许可证;需要可复现环境时固定 commit,不要只装浮动的默认分支。
结尾¶
dsh-adhd-copilot 把一套 ADHD 教练流程收成 DeepSeek Harness 里的一个工具:先辨认状态,再只推下一步。完整方法论在 skills/adhd-copilot/ 里,可以当文档读,也可以随插件一起加载。
目录页:https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-adhd-copilot/
GitHub:https://github.com/zimai233/dsh-adhd-copilot