前言¶
在 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/ 目录树与触发原话。
