前言¶
在 DeepSeek Harness（DSH）裏做智能體，記憶往往只有兩條路：靠模型上下文（會話結束就斷），或上檢索庫（要嵌入、要依賴、要運維）。社區插件 dsh-book（倉庫 Zhi-yin666/dsh-book，目錄頁 skillhub.cn/plugins/Zhi-yin666/dsh-book）走第三條：記憶落在磁盤上的 Markdown，按冷熱分層注入，需要時用工具翻。 維護者爲 Zhi-yin666，分類爲「記憶」；當前爲 0.1.0 測試版，README 寫明僅在一臺 Windows + DSH 桌面版上驗證過，請當作可試用的自用版本，而非穩定發行版。
下面介紹它解決什麼問題、怎麼裝、怎麼用，以及 0.1.0 的已知限制。
這是什麼¶
dsh-book（小本本）是 DSH 的本地記憶插件：三本書加一份交接，全部是 ~/.dsh/book/ 下的 Markdown 文件，沒有數據庫、沒有嵌入模型、沒有 Python、沒有網絡請求（插件自述爲零依賴式文件存儲）。
| 本子 | 用途 | 如何進入上下文 |
|---|---|---|
| 筆記本 | 人格、底線、說話方式 | 每輪全量注入，默認 600 字上限 |
| 工作本 | 今天做了什麼 | 最近 3 天自動注入，過期不注入但永不刪除，可搜索 |
| 日記本 | 長期要記住的事，五支：相處 / 心意 / 教訓 / 做成 / 懸着 | 不自動注入，用工具翻 |
| §〇 交接 | 換會話接力（我是誰 / 幹到哪 / 下一步 / 卡在哪） | 注入壓縮後的 220 字 |
另有 dream 機制：30 天沒人翻的日記降權重，掉到 1 以下搬進 沉底/——只搬不刪；「教訓」那支永遠不衰減。
裝好後新會話應能看到 12 個 book_* 工具；若 DSH 帶 @deepseek-ai/dsh-client-ui-sidebar，左側欄會多一個「筆記本」入口。
安裝與啓用¶
安裝命令須按 README 原文，不要憑倉庫名拼接 dsh plugin add github:...。
方式 A：本地 tgz（推薦）
dsh plugin --profile <你的 profile 名> add file:<解壓目錄>\dsh-book-0.1.0.tgz
<你的 profile 名> 一般是 desktop 或 web，可看 ~/.dsh/profiles/ 下有哪些目錄。裝完重啓 DSH。
方式 B：從源碼目錄裝
dsh plugin --profile <profile> add file:<解壓目錄>\dsh-book
方式 C：手動（不推薦）
解壓到 ~/.dsh/profiles/<profile>/node_modules/dsh-book，在 profile 的 package.json 裏：dependencies 增加 "dsh-book": "link:<絕對路徑>"，並在 dsh.profile.bundles 末尾加 "dsh-book"。改 JSON 建議用 Node/Python；README 提醒 Windows PowerShell 5.1 的 Set-Content -Encoding utf8 會寫 BOM，可能導致 DSH 無法啓動。
安裝時若 pnpm 提示 @deepseek-ai/cordis peer 未滿足，README 稱宿主通常已自帶，可忽略；啓動報錯可把 ~/.dsh/logs 對應時段日誌保留備查。
卸載：從 profile 的 bundles 移除 dsh-book，或執行 dsh plugin remove dsh-book，再重啓。~/.dsh/book/ 爲用戶數據，刪留自定，README 建議備份。
數據目錄與可選配置¶
默認數據目錄結構如下：
~/.dsh/book/
├── card/card.md # 筆記本（可手改，Markdown 兩節：我選的 / 你要的）
├── work/YYYY-MM-DD.md # 工作本，一天一個文件
├── diary/<分支>/*.md # 日記本，按五支分目錄
├── diary/主幹.md # 長期主線（1500 字上限）
├── diary/交接.md # §〇 交接（4096 字節上限）
└── config.json # 可選：改注入字數等
不寫 config.json 則用默認值；可選項示例：
{
"cardLimit": 600,
"workDays": 3,
"workInjectLimit": 800
}
典型用法¶
無需單獨配置文件，直接對 AI 說明意圖即可，README 給出的對應關係：
- 「記一下今天修了啥」→ 寫工作本
- 「這事我想記住」→ 寫日記（選五支之一）
- 「我要換會話了，寫個交接」→ 寫交接
- 「翻翻以前關於 XX 的記錄」→ 搜索
適用場景與注意¶
適合誰：希望在 DSH 裏用純文件、可手改、可備份的長期記憶，且能接受關鍵詞子串搜索（非語義檢索）的開發者。
權限與安全：README 寫明沒有權限控制，任何會話都能讀寫 ~/.dsh/book/；插件以當前 DSH 進程權限運行。安裝前應自行查看 GitHub 源碼 與 MIT 許可證（見倉庫 LICENSE）。
0.1.0 已知限制（摘自 README）
- 沒有語義檢索，只能按關鍵詞子串搜。
- 沒有項目隔離，多工作區記錄混在一起。
- 會話壓縮後不會自動補記憶；模型上輪翻過的日記內容可能丟（筆記本/交接每輪重算，不會丟）。
- 左側欄入口依賴
@deepseek-ai/dsh-client-ui-sidebar；無該包時入口不出現，工具仍可用（會 warn）。 - 界面與文案全中文，無 i18n。
- 只在 Windows 桌面版驗證過，headless / 其他系統未測。
DSH 生態理念是「一切皆插件」；社區目錄站點與 DeepSeek / 幻方無官方從屬關係，本文僅介紹社區插件本身。
結尾¶
dsh-book 把 AI 記憶拆成筆記本、工作本、日記本與交接，用 Markdown 和時間分層注入，避開檢索庫依賴。若要試用或反饋問題，可訪問目錄頁 skillhub.cn/plugins/Zhi-yin666/dsh-book 與倉庫 github.com/Zhi-yin666/dsh-book；報 bug 時 README 建議附上 DSH 版本、安裝方式、報錯全文、~/.dsh/book/ 目錄樹與觸發原話。
