前言¶
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 查看源碼。