dsh-book（小本本）· 0.1.0 测试版
给 DeepSeek Harness（DSH）用的本地记忆插件。三本书 + 一份交接，全部是磁盘上的 Markdown 文件，
没有数据库、没有嵌入模型、没有 Python、没有网络请求。
⚠️ 这是自用插件的 0.1.0 测试版，只在一台 Windows + DSH 桌面版上验证过。
请当作「可以装、可以看、可以骂」的版本，不要当作稳定软件。
它解决什么
AI 的记忆通常只有两种做法：模型自己记（会话一关就没了），或者塞进一个检索库（要检索、要模型、要依赖）。
dsh-book 走第三条路：把记忆做成文件，按时间冷热分层，需要时再翻。
| 本子 | 干什么 | 怎么进入上下文 |
|---|
| 笔记本 | 人格、底线、说话方式 | 每轮全量注入，默认 600 字上限 |
| 工作本 | 今天做了什么 | 最近 3 天自动注入，过期不注入但永不删除，可搜索 |
| 日记本 | 真正记住的事，五支：相处 / 心意 / 教训 / 做成 / 悬着 | 不自动注入，用工具翻 |
| §〇 交接 | 换会话接着干的接力棒（我是谁 / 干到哪 / 下一步 / 卡在哪） | 注入压缩后的 220 字 |
外加 dream：30 天没人翻的日记降一级权重，掉到 1 以下搬进 沉底/——只搬不删，「教训」那支永远不衰减。
安装
方式 A：装本地 tgz（推荐）
dsh plugin --profile <你的 profile 名> add file:<解压目录>\dsh-book-0.1.0.tgz
<你的 profile 名> 一般是 desktop 或 web，看 ~/.dsh/profiles/ 下有什么。
装完重启 DSH。新会话里应该能看到 12 个 book_* 工具，左侧栏多一个「笔记本」入口。
方式 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，不要用 PowerShell 的 Set-Content -Encoding utf8
（Windows PowerShell 5.1 会写 BOM，DSH 读到 BOM 会起不来）。
装完怎么用
不用特意配置，直接跟 AI 说：
- 「记一下今天修了啥」→ 写工作本
- 「这事我想记住」→ 写日记（选五支之一）
- 「我要换会话了，写个交接」→ 写交接
- 「翻翻以前关于 XX 的记录」→ 搜索
默认数据目录：
~/.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
}
0.1.0 的已知限制（请先读）
- 没有语义检索，只能按关键词子串搜。记得意思、不记得原词的时候搜不到。
- 没有项目隔离：多个工作区的记录混在一起。
- 会话压缩后不会自动补记忆：模型上轮翻过的日记内容可能丢（笔记本/交接每轮重算，不会丢）。
- 左侧栏入口依赖
@deepseek-ai/dsh-client-ui-sidebar：如果你的 DSH 版本没有这个包，
页面入口不会出现，但插件本体和工具仍然能用（会打一条 warn 日志）。
- 界面与文案全中文，没有 i18n。
- 只在 Windows 桌面版验证过，headless / 其他系统未测。
- 没有权限控制：任何会话都能读写
~/.dsh/book/。
安装时如果 pnpm 提示 @deepseek-ai/cordis peer 未满足，通常是宿主已自带，可忽略；
如果启动报错，请把 ~/.dsh/logs 里对应时段的日志贴回来。
想要什么反馈
报 bug 的时候，这几样最有帮助：
- 你的 DSH 版本（关于页 /
dsh --version）
- 安装方式（A/B/C 哪个）
- 报错全文，不要截半句
~/.dsh/book/ 的目录树（tree 或 Get-ChildItem -Recurse 输出）- 触发问题的那句话（原话）
想提需求也行，但先说清楚是「记不住」还是「记乱了」——这两种要动的地方完全不同。
卸载
从 profile 的 bundles 里移除 dsh-book（或 dsh plugin remove dsh-book），重启 DSH。
~/.dsh/book/ 是你自己的数据，删不删自己决定——建议留着备份。
文件清单
dsh-book/
├── package.json
├── cordis.patch.yml # bundle patch
├── client.js # 左侧栏「笔记本」面板
├── lib/
│ ├── index.js # 插件入口：12 个工具 + 3 段注入 + 编辑页
│ ├── store.mjs # 三本书的读写、dream
│ └── hostdeps.mjs # 宿主包解析兜底
├── tests/
│ ├── check-tools.mjs # 工具 schema 体检（只读工具实跑）
│ └── smoke*.mjs # 三本书的冒烟测试，不依赖 DSH
├── LICENSE
├── .gitignore
└── README.md
MIT License.
