前言¶

用 DeepSeek Harness（DSH）做本机 agent 时，会话一关，项目约定、个人偏好和踩过的坑往往就没了；若在每轮里硬塞整段历史，又会拖慢对话、占满上下文。社区插件 DSH-Neural-Mind（npm 包名 neural-mind，仓库 JIUYUE-SEP/DSH-Neural-Mind）在 DSH 上叠加一层「心智」能力：后台写入与召回的长期记忆池，可选的 SOUL 人格自设，以及基于文件的 L1 用户画像。下面按定位、能力、安装、用法与边界说明如何在桌面或自建 profile 里启用它。

这是什么¶

DSH-Neural-Mind 由维护者 JIUYUE-SEP 发布，在 SkillHub 插件目录 中归类为「记忆」。README 将其定义为：给 DSH 的心智插件——自动记住、自动想起、可显式管理的长期记忆池，外加可自改的 SOUL 人格设定与 L1 用户画像。package.json 当前版本为 0.6.7，许可证 MIT，要求 Node ^22.19 || >=24。

设计原则在文档里写得很直白：耗时操作放后台，失败不阻断聊天，每轮内联注入预算不超过约 300ms；记忆带来源与工作区 / 会话 / 时间信息；存储、LLM、embedding、会话查询按能力探测，缺席则自动降级。

核心功能¶

长期记忆：双速写入与推拉读取¶

写入（双速）：回合结束后原文先进 L0 热缓冲（秒级可检索）；攒批后由后台 LLM 提炼成事实、经验、话题摘要（L2），并与既有记忆建立印证、矛盾关系。

读取（推拉结合）：每轮开场（step 1）检索相关记忆并注入，带来源措辞；工具 memory_recall 可随时拉取；L1 用户画像与 SOUL 作为固定段注入。

注入前闸门：默认开启 relevanceGate，控制自动注入质量；只卡注入，不影响 memory_recall。未配置向量检索时走纯 BM25，跨语言召回会降级。

生命周期：印证强化、质疑衰减；连续 14 天净负分自动归档；归档不物理删除、可恢复。来源按会话原文角色判定，模型自报不算数（0.6.6 R13b）。

SOUL 与 L1：与规矩、角色分层¶

SOUL 真相源为可配置的 md 文件（默认 ~/.dsh/SOUL.md）。L1 用户画像唯一入口是配置项 profileFile 指向的文件；记忆页「画像」编辑同一份，手改后下一轮生效。规矩应写 AGENTS.md，避免与画像重复造成双重注入。

记忆工具¶

自动注入的长期记忆行带 [m_…] 编号，便于模型引用后纠错或 forget。记忆页支持搜索、暂存确认、敏感标记与来源轮次展开等管理操作。

控制台与配置¶

重载后主侧栏出现 「记忆」（在「自动化任务」下面），含总览、记忆、召回、配置、画像、SOUL、审计等页签。总览健康检查可确认存储、提炼、自动召回是否正常。

常用配置项（记忆页可改部分）包括：disabledWorkspaces 停用某工作区记忆、autoRecall 自动召回总开关、privateWorkspaces 只进不出隐私目录、semanticSearch 向量检索、extractEnabled 提炼开关、injectMaxChars 单轮注入字符上限、profileFile 画像路径、soulEnabled / soulSelfEditEnabled 等。全量默认值见仓库 docs/design/10-config-ledger.md。

可选接入 OpenAI 兼容 的 POST {baseUrl}/embeddings（文档推荐本机 Ollama 拉取 bge-m3 等）；不配 embedding 仍可用关键词检索。

安装与启用¶

DSH Desktop（0.2.x）¶

在应用内 侧边栏「插件」页 添加本包（本地路径或 github: 地址），重载后生效。文档明确：不要用命令行装桌面 profile——dsh plugin --profile desktop … 会被 CLI 拒绝。

自建 profile（web / headless 等）¶

dsh plugin --profile <profile> add /path/to/neural-mind   # 或 github: 地址
# 重启 dsh 生效

dsh plugin add 会读 package.json 的 dsh.bundle.patch（cordis.patch.yml）把插件登记进该 profile。卸载：命令行 profile 使用 dsh plugin --profile <profile> remove neural-mind；桌面端在同一「插件」页移除。

启用验证：主侧栏打开「记忆」→ 总览，健康检查里存储 / 提炼 / 自动召回应为正常。

典型用法¶

README 给出的五分钟上手路径可照做：

1. 安装并重载后，在「记忆」→ 总览确认健康检查无红色项。
2. 正常聊几轮，在「记忆」页签查看热缓冲与提炼产物。
3. 显式记忆：对话中说「记住：这个仓库提交信息用中文」，或让 agent 调用 memory_remember；新条目先进暂存区，确认后转正。
4. 下一轮问「我们之前约定过什么？」——开场会检索并注入相关记忆。
5. 调参：「配置」页签改常用项；跨语言或语义召回建议配置本地 embedding。

示例话术：

> 记住：这个项目提交信息用中文，结论先行。
> 你还记得我们约定过什么吗？

适用场景与注意¶

适合：本机单人使用 DSH Desktop；希望 agent 跨会话记住项目约定与个人偏好；愿意花约十分钟配置本地 embedding（可选）的用户。

不适合：多人共享机器且需强隔离、需要定点提醒、希望记忆库化或云同步、或使用未认证宿主版本——详见仓库「已知限制」。

隐私与权限：记忆落盘于 ~/.dsh/storages/neural_mind/（0.6.6 前为 memory/，首次启动可读迁移），目录与文件权限 0600；威胁模型为本机单人使用。插件以当前 dsh 进程权限 运行，本机其他进程仍可读写这些路径；安装前应自行查看源码与 MIT 许可证，并按组织安全策略评估 SOUL 自改、手改文件与 agent 工具链的边界。文档说明治理主要防手滑与注入特征，强制边界仍依赖 DSH 沙箱与审批策略。

观测：0.6.7 起将注入 / 提炼 / 召回计数与注入质量元数据落到独立观测域，只记录、不改变记忆行为。

结尾¶

DSH-Neural-Mind 把「记、想、管」收到一条后台流水线里，并把人格与画像从一次性 prompt 里拆成可版本化的层；与 DSH「一切皆插件」的思路一致，记忆能力以独立包挂载，而不是改宿主核心。

• 目录页：SkillHub — DSH-Neural-Mind
• 源码与完整文档：GitHub — JIUYUE-SEP/DSH-Neural-Mind