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