前言¶
DeepSeek Harness (DSH) 的每个新会话默认从空白开始，没有跨会话的记忆。这个插件通过钩子 ctx.systemPrompt.context，将本地状态注入到每个新会话的提示词中。
插件定位¶
这是一个 DeepSeek Harness 插件。它的作用是把一个有硬上限、带时间戳的脑快照（身份＋状态指纹＋未决项＋指针与边界）注入每个新会话。它只读、零写入、fail-loud、零依赖。
核心功能¶
- 注入快照：将本地大脑的快照注入到每个新会话的提示词上下文中。
- 只读与零写入：插件只调用
readFileSync，不修改大脑文件。 - Fail-loud：如果块长度低于 300 字符，插件会拒绝注册并打印原因，而不是静默失败。
- 零依赖：纯 ESM，不依赖其他包。
- 硬上限：有
maxChars限制（默认 1000，打包补丁为 1300），防止上下文窗口溢出。
安装¶
插件需要 Node.js 环境，版本需大于等于 18。
pnpm add @xianshu/dsh-second-brain
配置¶
插件安装后默认启用（v0.1.0 的默认值相反，容易误用）。关键配置项如下：
| 配置项 | 默认值 | 说明 |
|---|---|---|
brainRoot |
~/.dsh/brain (或 $DEEPSEEK_BRAIN) |
大脑文件所在目录 |
maxChars |
1000 (打包补丁为 1300) | 注入块的最大字符数，下限为 300 |
order |
200 | 在系统提示词中的层序 |
inject |
true | 是否启用注入，设为 false 或环境变量 DSH_SB_INJECT=0 可禁用 |
使用与验证¶
安装并重启 DSH 后，新会话会自动获得注入内容。
验证步骤：
1. 打开一个新会话，输入问题：what Second Brain information did you get at startup?
2. 如果回答正确，说明注入已生效。
3. 查看日志，应出现类似记录：
[second-brain-xianshu] ✅ 注入已注册：name=xianshu-second-brain order=200 块长=NNN 字符
注意事项¶
- 快照机制：注入的内容是快照，不是实时状态。如果文件被外部修改，新会话仍会使用快照内容（文件优先级高于快照）。
- 安装默认值：当前版本默认
Installed == ON。 - GitHub 路由限制：若通过
github:路由安装，系统需要git在 PATH 中，且能访问github.com。
生态背景¶
DeepSeek Harness 理念是「一切皆插件」。本插件由 DiaryOfUranus 维护，可在 SkillHub 查看目录页，或在 GitHub 查看源码。
