DSH 的错误账本与长期记忆:把每次踩的坑记成可检索的 guard,重试前先查;工具失败自动提醒;检测思考复读;内置 bash 工具与人格/心事本。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:Baimacao/dsh-pipem
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
给 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
链接
同类插件
vectorize-io/hindsight#coding-agents★ 61388
Hindsight:会学习的 Agent 长期记忆系统,自动召回/保存、知识页、深度反思与按仓库隔离的记忆银行。
volcengine/OpenViking#examples/dsh-memory-plugin★ 42311
面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件:pre-step 自动召回与画像注入、会话捕获、`viking://` URI 防护,以及对接 OpenViking 服务端的 recall/write 记忆工具。
MemTensor/MemOS#memos-local-plugin★ 12417
DeepSeek Harness 本地记忆插件:分层 L1/L2/L3 记忆,自动沉淀与手动 memos_* 检索工具并存,内置记忆浏览器。
agentscope-ai/ReMe#dsh★ 3812
将 DeepSeek Harness 接入 ReMe 本地优先、自进化的个人知识库:自动把已完成的主 Agent 对话沉淀为用户掌控的 Markdown 记忆,通过 reme_search 结合 BM25、可选向量检索和 wikilink 展开搜索对话与资料,并按日整理长期记忆。
zilliztech/memsearch#MemSearch★ 2889
供 DSH 与其他编程 Agent 共享的 Markdown 记忆,支持自动捕获、步骤前上下文注入、搜索召回,以及通过审阅面板实现 memory-to-skill 自进化。
vshulcz/deja-vu#extensions/dsh★ 1578
跨会话长期记忆与上下文恢复:读取本机上其他四十五个(45+)编程智能体已经写下的会话文件,支持安装前历史找回与中断恢复(Claude Code、Codex、Cursor、Windsurf、Trae、Antigravity、VS Code Copilot Chat、opencode、OpenClaw、Hermes、Kimi、Qoder、Cline、Zed、Magpie 等):提供 deja_recall、deja_session、deja_blame、deja_fix、deja_how、deja_remember 六个工具与 /deja 命令,并可选地把召回结果加入运行时上下文。共享本地 BM25 CLI/MCP 索引,不用大模型,不用向量嵌入,不联网(dsh plugin --profile web add dsh-deja)。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。