前言¶
在 DSH（DeepSeek Harness）里做智能体，常见做法是每轮对话靠 system prompt 和外部向量库拼上下文。会话一关、进程一重启，「你上周说过什么」「这件事后来怎么样了」往往接不上；想让角色有连续生活、会自己查资料再找你聊，通常还要自己写调度、存储和前端入口。
下面介绍社区插件 dsh-nook（仓库 guix4ever/dsh-nook）：把「记得你、性格在相处中变化、离线自己去读、合适时主动发消息」做成一套本机引擎，挂进 DSH 侧边栏和 Nook 预设，聊天与联网复用你在 DSH 里已配好的 DeepSeek。
这是什么¶
dsh-nook 是 maintainer guix4ever 维护的 DSH 拟人化插件（package.json 版本 0.1.0，许可证 MIT）。默认伙伴叫 大D老师，名字可在首次使用时改。
它要解决的问题是：在 Harness 里有一个长期共处的 AI 伙伴——不是固定人设卡片，而是基于本机事件流积累记忆与关系，并在后台跑「自己去逛、主动消息、 nightly 整理」等循环；数据不出本机目录，不另配一套模型密钥。
社区目录 skillhub.cn 将其归类为「趣味换装」；功能定位以仓库 README 为准。
核心功能¶
以下能力均来自官方 README，可按模块理解。
记忆与连续生活¶
- 记得你：说过的事、喜好、约定会记下，并区分是你亲口说的还是她推测的；你改主意，记忆会跟着改。
- 日子连续：面试、搬家、生病等「进行中的事」会跟踪进展，换会话或重启电脑仍能接上。
性格与关系¶
- 性格在相处中生长：无预设人设；MBTI 仅作一点初始倾向。回复方式、口头禅、兴趣随相处变化，每次变化可查原因、可撤销。
- 首次打开需填 名字、朋友还是恋人；性格可选。
独立生活与主动消息¶
- 有自己的生活：你不在时，会用 DeepSeek 联网去看内容，读完写感受；只有真正搜到、读到的才算，搜不到不编。
- 会主动找你：想起没聊完的事、读到你可能喜欢的内容、或太久没见，会主动发消息；睡觉、你在忙时不打扰；连续几次没回会收敛。
数据与界面¶
所有记忆、心情、阅读记录仅存本机：
<DSH_HOME>/storages/dsh-nook/
events.jsonl：事件只追加不改写，是一切记忆的依据。state.json：当前记忆、性格、关系和设置。
在 Nook 页面可改、删单条记忆；删除会清掉该条内容。
聊天与联网均使用 DSH 已配置的 DeepSeek（账号登录或环境变量 DEEPSEEK_API_KEY），无需再配其他 API。
安装与启用¶
要求：package.json 声明 Node >= 20，DSH >= 0.2.1-rc.1（dsh.engines.dsh）。
侧边栏安装¶
DSH 侧边栏 → 插件 → 添加插件，输入仓库地址：
github:guix4ever/dsh-nook
命令行安装¶
dsh plugin --profile web add github:guix4ever/dsh-nook
装好后 重启 DSH。侧边栏会出现 大D老师（或你起的名字）。第一次打开完成上述三项设置即可开始聊。
插件通过 cordis.patch.yml 注入宿主与 Nook agent 预设；浏览器端依赖 DSH web client 的 sidebar / workspace 等注入项（见 package.json 的 dsh.client）。
典型用法¶
日常对话¶
在侧边栏进入伙伴入口，与普通 DSH 对话相同；lib/agent.js 将人格作为完整 system prompt，每轮注入她当前状态，再交给引擎处理。
管理记忆¶
打开 Nook 页面，逐条查看、修改或删除记忆；底层仍对应 events.jsonl 与 state.json 的语义。
开发者自测（可选）¶
仓库提供验收故事测试与开发用 patch，不打开浏览器也能调接口：
npm test
test/story.test.js 用假模型跑通：想养猫 → 记住 → 自读 → 主动分享 → 说不养了 → 撤回未发猫文 → 时间线卡片 → 次日不再查猫；以及睡觉不发、搜索失败不编造、发送中途重启不重发等场景。
本地带开发覆盖层启动 web：
dsh web --patch test/dev/harness.patch.yml
此时可用 /api/nook-dev/* 直接聊天、触发后台任务。
适用场景与注意¶
适合谁：已经在用 DSH web profile、希望在本机养一个「有记忆、有后台生活、会 proactive 消息」的伙伴，且愿意用 DeepSeek 账号或 DEEPSEEK_API_KEY 承担对话与联网成本。
务必注意：
- 插件以 当前 DSH 进程的权限 运行，可读写
<DSH_HOME>/storages/dsh-nook/并调用你已配置的模型与联网能力。安装前请阅读 源码 与 MIT 许可证，自行判断是否信任 maintainer。 - 社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系；DSH 生态是「一切皆插件」，本文事实以 GitHub README 与
package.json为准。 - README 未提供除上述以外的独立配置文件；勿假设还有未文档化的密钥项。
结尾¶
dsh-nook 把记忆引擎、人格演化、自主阅读与主动消息收进一个 DSH 插件，数据留在本机 storages/dsh-nook，复用 Harness 里的 DeepSeek。若你要在同行项目里对照实现，可先看 lib/core/（与 DSH 无关的引擎）和 lib/index.js（宿主、后台循环与投递）。
