前言¶
在 DeepSeek Harness（DSH）里做本机 agent，跨会话时上下文会被清空：项目约定、个人偏好、踩过的坑往往要重复说明。只靠单轮 prompt 或手写 AGENTS.md，很难把「经历」和「规矩」分开管理，也不容易在对话开场自动带上相关事实。下面介绍社区插件 neural-mind（维护者 JIUYUE-SEP），它是面向 DSH 的「心智」类插件，分类为记忆；当前包版本 0.6.7，许可证 MIT，依赖 Node ^22.19 或 ≥24。
这是什么¶
neural-mind 给 DSH 提供三块能力：长期记忆池（自动记住、召回、可显式管理）、可自改的 SOUL 人格设定、以及 L1 用户画像。写入走「热缓冲 + 后台提炼」双速通道；读取在每轮开场注入相关记忆，并支持工具随时拉取。设计上强调：后台耗时、失败不阻断聊天、单轮内联注入预算不超过约 300ms；记忆带来源与时间，代码相关条目注入时标明「以当前代码为准」。
插件原名 dsh-plugin-memory，0.6.6 起改名为 neural-mind；0.6.7 起将注入 / 提炼 / 召回计数与注入质量元数据落到独立观测域（只记录，不改变记忆行为）。旧数据目录在首次启动时会从 ~/.dsh/storages/memory/ 迁移到 ~/.dsh/storages/neural_mind/。
核心功能¶
记忆写入与读取¶
回合结束后，原文先进入 L0 热缓冲（秒级可检索）；攒批后由后台 LLM 提炼为事实 / 经验 / 话题摘要（L2），并建立与既有记忆的印证、矛盾关系。每轮开场（step 1）检索相关记忆并注入，措辞区分用户、助手确认与代码线索；工具 memory_recall 可随时检索，支持时间窗、按 session 回放、按 id 展开。
显式记忆可说「记住：……」或让 agent 调用 memory_remember；新条目先进暂存区，确认后转正。自动带入的长期记忆行带 [m_…] 编号，便于纠错或 memory_forget 归档。
SOUL 与 L1 画像¶
SOUL 存放在 ~/.dsh/SOUL.md（可通过配置项 soulFile 调整），描述 agent 的性格、信条、口吻，跨会话一致；自改经 soul_update 须带 reason，受日预算与检查约束，记忆页支持预览、历史与回滚。与 DSH 原生的 AGENTS.md（规矩）、preset persona（角色）、记忆层（事实）分工不同：优先级上安全与用户当场要求高于 SOUL。
L1 用户画像 唯一入口是配置文件路径 profileFile（支持 ~/…），记忆页「画像」编辑同一份；只放关于你和项目的陈述性事实，操作规程仍应写在 AGENTS.md。
检索与生命周期¶
未配置 embedding 时使用纯 BM25；配置 OpenAI 兼容的 POST {baseUrl}/embeddings 后开启语义检索（跨语言场景文档建议配置）。默认开启 relevanceGate：过低相关性的候选不注入对话（只卡注入，不影响 memory_recall）。
记忆不物理删除：印证强化、质疑衰减，连续 14 天净负分可归档；归档可恢复。存储、LLM、embedding、会话查询按能力探测，缺席时自动降级。
记忆工具（摘要）¶
| 工具 | 作用 |
|---|---|
memory_recall |
检索记忆，limit 1–20（默认 10） |
memory_remember |
显式记忆，可带 userQuote 证明来源 |
memory_forget |
归档 / 屏蔽 |
soul_update |
SOUL 整篇替换，须 reason |
主侧栏「记忆」控制台含总览、记忆列表、召回调试、配置、画像、SOUL、审计等页签；健康检查可确认存储、提炼、自动召回是否正常。
安装与启用¶
DSH Desktop（0.2.x）：在应用内侧边栏「插件」页添加本包（本地路径或 github: 地址），重载后生效。不要用 dsh plugin --profile desktop … 装桌面 profile——CLI 会直接拒绝，桌面 profile 由 Electron 应用独占。
自建 profile（web / headless 等）可用命令行：
dsh plugin --profile <profile> add /path/to/neural-mind # 或 github: 地址
# 重启 dsh 生效
dsh plugin add 会读取包内 cordis.patch.yml 与 package.json 的 dsh.bundle.patch，把插件登记进对应 profile。卸载：命令行 profile 使用 dsh plugin --profile <profile> remove neural-mind；桌面端在同一「插件」页移除。
启用后，主侧栏「自动化任务」下方应出现「记忆」；打开总览，健康检查里存储 / 提炼 / 自动召回应为正常。
典型用法¶
- 安装并重载后，打开「记忆」→ 总览，确认健康检查无红色项。
- 正常聊几轮，在「记忆」页签查看热缓冲与提炼产物。
- 显式约定，例如：
> 记住：这个仓库提交信息用中文
> 你还记得我们约定过什么吗？
- 需要调参时打开「配置」页签；常用项包括
autoRecall、extractEnabled、injectMaxChars、semanticSearch（向量端点）、disabledWorkspaces/privateWorkspaces、soulEnabled等。向量检索可选：例如本机 Ollama 拉取bge-m3后，在配置页填写baseUrl=http://127.0.0.1:11434/v1、modelId=bge-m3等（详见仓库 README）。
配置写入 profile 层的 cordis.patch.yml；标了 .volatile() 的字段改后热重建，其余改后需整插件重挂载。
适用场景与注意¶
适合：本机单人使用 DSH Desktop；希望 agent 跨会话记住项目约定与偏好；愿意可选配置本地 embedding 的用户。
不适合：多人共享机器且需强隔离、需要定时提醒、希望记忆库化或云同步、或使用未认证宿主版本——详见仓库「已知限制」。
安全与权限：记忆与 SOUL 以明文落在用户目录（如 ~/.dsh/storages/neural_mind/、~/.dsh/SOUL.md，权限 0600），威胁模型是本机单人使用。插件在当前 dsh 进程权限下运行；安装前请自行查阅源码与 MIT 许可证。社区目录 SkillHub 插件页 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系。
结尾¶
neural-mind 把「可印证的长期事实」「人格 SOUL」「用户画像」从单次对话里拆出来，并在 DSH 插件体系里用控制台和工具显式管理。若要安装或核对设计细节，可参考：
- 目录页：https://www.skillhub.cn/plugins/JIUYUE-SEP/neural-mind
- 源码与文档：https://github.com/JIUYUE-SEP/neural-mind
