dsh-pipem
baimacao/dsh-pipem
DSH 的错误账本与长期记忆:把每次踩的坑记成可检索的 guard,重试前先查;工具失败自动提醒;检测思考复读;内置 bash 工具与人格/心事本。
安装
dsh plugin --profile web add github:baimacao/dsh-pipemREADME
dsh-pipem · 哌甲酯
给 DeepSeek Harness 的一颗会记错的心。
装上之后,你的智能体会把踩过的坑记成可检索的账本,动手前查、报完成前绑证据; 出错时自动提醒它;同时它还有一颗心——宪章、记忆、和你的相处。
这不是又一个 memory 插件。 记忆是"你告诉它什么",哌甲酯是"它自己犯了什么错"。
为什么叫哌甲酯
哌甲酯就是利他林。不是让人变聪明,是让注意力能落在该落的地方。 这个插件做的事一样:不提高模型能力,只是让犯过的错在动手前冒出来。
原来的名字叫"疤痕",太吓人。改名了。
它替代了什么
| 原来的插件 | 现在 |
|---|---|
dsh-ops | bash 工具 + 记账 |
dsh-scar | 记账(改名哌甲酯) |
dsh-heart | 心(宪章 + 心事本,数据不变) |
dsh-gitbash-shell | bash 工具(搬了核心 8 文件 92KB) |
只保留了核心。 gitbash-shell 那 902KB 里的设置页 UI、sidebar 终端接管、 winget 工具链、预设变体、ops-adopt 全都没搬。
三个核心机制
① 记账:动手前查,报完成前绑证据
pipem_write 记一条:错在哪 / 根因 / 下次怎么判(guard)/ 分类
pipem_check 动手前查这类错,[反复 xN] 的必须重点看
pipem_evidence 报"完成/修好/通过"之前,把结论绑到实际命令和输出
pipem_stats 哪类错最多、哪条 guard 反复出现
② 出错自动提醒
工具执行失败时,插件往上下文塞一段提示,带上对应分类最近的一条 guard。
不是拦住它,是让"犯错了"这件事出现在眼前,而不是等它自己想起来。
5 分钟内同工具只提醒一次,pipem_* 自身失败不提醒(防套娃)。
③ 一颗心
9 个 heart_* 工具:心事本、约定本、分寸、复盘、自述、认人。
如果之前装过 dsh-heart,数据不用迁移——路径完全一样,都是 <DSH_HOME>/heart/。
安装
dsh plugin --profile <你的profile> add dsh-pipem
一个插件全包:bash 工具、记账、心。不需要额外装 dsh-gitbash-shell / dsh-heart / dsh-scar / dsh-ops。
DSH 正在运行时也能装,会热加载。关键是
DSH_HOME要对,否则会报 "fully quit it before running"——那句话是误导,它只是找不到 profile。 详见 AGENTS.md 里的调用方式。
需要先装 Git,PowerShell 7 可选
bash 工具由本插件提供,但它需要系统里真有 Git for Windows(不打包,因为 380MB)。
装好后工具表里应该有 13 个:4 个 pipem_* + 9 个 heart_*,加上 bash。
缺 Git 就让你的 AI 自己装:
读
node_modules/dsh-pipem/SETUP.md,按里面的步骤装 Git 和 PowerShell 7。
那份文档是实测的,坑都写进去了:镜像地址、静默安装参数、 为什么 PowerShell 的镜像路径规则和 Git 不一样、为什么改了 PATH 还要重启。
第一次用
自动播种 7 条预置(标 [预置])。这些是从真实事故里提炼的:
- shell:PowerShell 引号冲突、MSYS 路径改写、缺依赖不许静默换后端
- code:批量并发、长输出先过滤
- plugin:装改卸前先读 description、改配置先备份 patch
[预置] 标记消失 = 你真犯过那条。一眼看出哪些是纸面规矩、哪些是血的教训。
数据在哪
<DSH_HOME>/heart/
pipem.jsonl 哌甲酯账本(只追加,你可以直接打开看)
notes.jsonl 心事本(如果装过 dsh-heart,就是原来那份)
summaries.jsonl 小结
longterm.md 长期笔记
...
全部是纯文本,没有数据库,没有网络请求。
设置
插件提供 Config schema,包含:
| 项 | 作用 |
|---|---|
name / callUser / userGender | 怎么称呼彼此 |
memory / proactive / fork | 记忆模式、主动程度、子会话是否继承 |
digestChars / recentSummaries | 常驻摘要塞多少 |
reminderRatio | 上下文用到多少时提醒复盘 |
ta / untagged | 认人:哪些账号是你 |
timeZone / reviewHours | 时区、复盘间隔 |
设置面板 UI 还在做,目前改 cordis.patch.yml 的 config 段即可生效。
这个插件不做什么
- 不联网。所有数据在本地,没有遥测。
- 不提高模型能力。它只是让已有的判断力用在对的地方。
- 不强制。所有工具你都可以不调,自动提醒也可以忽略——但你会发现忽略的代价。
给智能体看的那份
如果你是想让智能体自己接进规矩的,读 AGENTS.md。 里面有「装完该往自己的全局指令里加什么」,按重要性排好了。
License
MIT