前言¶
在 DSH 裏跑智能體時，上下文窗口裝不下長期協作偏好、任務標準和近期狀態；換會話或換模型後，往往又要從頭對齊。常見做法是手寫筆記或外掛知識庫，但和 Harness 的注入、配額、審計往往脫節。dsh-neocortex（README 中稱 Zhinao / Neocortex）把記憶落在本地 Markdown 上，用分層寫入規則、本地召回賬本和 Web 面板把「記什麼、何時注入、爲何注入」拆開處理。下面按定位、能力、安裝與用法說明。
這是什麼¶
dsh-neocortex 是維護者 kelunisi 發佈的 DSH 記憶類插件：以 Markdown 爲權威數據源，提供本地召回賬本（recall ledger）、生命週期引擎、週迴顧和 Web 面板。社區目錄頁在 skillhub.cn/plugins/kelunisi/dsh-neocortex，源碼與說明在 GitHub: kelunisi/dsh-neocortex。許可爲 MIT；package.json 中當前版本爲 0.4.2。
核心功能¶
三層記憶（L1 / L2 / L3）¶
- L1：長期模型類內容（背景、協作偏好、任務標準等），需用戶確認後纔會進入長期層。
- L2：知識層，自動寫入，且要求帶來源。
- L3：近期狀態，在每日配額下直接寫入。
本地賬本與召回說明¶
插件維護面向崩潰恢復的本地賬本，記錄每一次 recall 與 write。Web 面板可說明某條記憶爲何被注入上下文。
生命週期與週迴顧¶
場景與條目可休眠、喚醒、復活，並在有界規則下晉升。可恢復的週迴顧會把 L1 候選與休眠條目排隊，供用戶處理。
Web 面板¶
面板提供狀態查看、召回說明、僅針對 L1 的確認、回顧操作、L2 只讀審計、撤銷，以及六個有界的設置滑塊。
首次初始化與接管¶
首次運行可通過嚮導選擇目錄：
- New brain：空目錄；嚮導拷貝無個人信息的空白模板；若存在衝突文件則中止，不覆蓋已有文件。
- Use existing：指向已有 Zhinao 目錄；僅校驗，不修改已有文件。
- Upgrade skeleton：指向不完整的 Zhinao 目錄；只補缺失骨架文件，已存在文件跳過。
環境與依賴¶
- DeepSeek Harness（DSH）版本要求：
>= 0.2.1-rc.5（見 README 與package.json的engines.dsh）。 - README 寫明已在 Windows 上驗證。
安裝與啓用¶
在終端執行（README 原文）：
dsh plugin --profile web add dsh-neocortex
也可在 DSH 圖形界面的插件市場中安裝 dsh-neocortex。該插件面向 web profile（package.json 中 dsh.client.platform 爲 web）。
首次使用：打開 Settings → Plugins → Zhinao / Neocortex，運行設置嚮導並按上文三種模式選擇目錄。
典型用法¶
智能體工具¶
代理側提供三個工具（名稱以 README 爲準）：
| 工具 | 作用 |
|---|---|
neocortex_remember |
向 L1/L2/L3 寫入一條原子事實；返回配額或隊列反饋 |
neocortex_recall |
召回一般與休眠的個人歷史；外部知識類問題會路由到網頁搜索 |
neocortex_panel |
面板狀態、回顧預覽、撤銷、回顧執行/重試、有界設置更新；L1 確認與週迴顧的接受/拒絕僅由用戶操作 |
自然語言轉向¶
除工具外，可用口語約束當次行爲，例如：
skip the brain this time：本次不讀不寫記憶don't remember this：不保存remember this：保存
卸載與數據保留¶
移除插件不會刪除大腦數據：Markdown 文件、本地賬本與設置仍留在磁盤上。
適用場景與注意¶
適合誰：需要在 DSH 中長期保留協作偏好與任務標準（L1）、帶來源的知識片段（L2）、以及受配額約束的近期狀態（L3），並希望通過面板審計召回與回顧條目的開發者。
運行與信任邊界：插件隨當前 DSH 進程權限運行，可讀寫你指定的 Zhinao 目錄及本地賬本。安裝前建議閱讀 倉庫源碼 與 MIT 許可證，自行確認數據目錄與備份策略。社區目錄 skillhub.cn 爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係。
平臺：README 僅聲明 Windows 驗證；其他系統需自行驗證。
結尾¶
dsh-neocortex 把第二大腦落成可審計的 Markdown 分層結構，並用賬本與 Web 面板解釋注入原因、承接 L1 確認與週迴顧。若要在 Harness 裏試用，可從目錄頁 kelunisi/dsh-neocortex 進入，安裝命令與完整說明以 GitHub README 爲準。
