前言¶
在 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
