DeepSeek Harness (DSH) 的核心设计理念是插件化。在实际使用中，让 AI 记住特定的规则、历史教训或知识库内容往往是一个痛点，因为常规的会话记忆容易丢失或失效。dsh-cognitio 插件旨在解决这个问题，它提供了一个基于 SQLite 的分层记忆系统，让 AI 能够记住你的规矩，并在关键时刻自动提醒，且所有自动沉淀的内容都需要经过你的批准。
定位与核心机制¶
cognitio（认知·张力网络）是一个 DeepSeek Harness 插件，它将“AI 的记忆与自律”从凭自觉转变为机制。其核心逻辑包括：
- 记忆分层：将记忆分为事实、规矩、模式、案例和命题，支持版本链查询旧版。
- 机械提醒：在回合开始、工具调用、出错或回合结束时自动检索并注入相关规矩，不依赖模型自身的记忆。
- 纠错进化：通过纠错管道自动归档错误和回合内容，每日维护后提炼为新规矩。
- 用户仲裁：所有自动生成的产物只进入草稿箱，必须由用户批准才能生效。
核心能力¶
该插件提供以下功能模块：
- 记忆井：基于 SQLite 的分层存储，包含版本链和软删除机制。
- 关系与效力：记录条目间的关系（依赖/矛盾等），并根据生效次数统计规则效力。
- 哨兵触发：支持在四种时间点触发提醒（回合开始/动作前/出错/回合末），触发词双向匹配。
- 纠错管道：自动过滤环境性错误并归档，实现无人值守的维护。
- 文献知识：提供只读全文检索的文献库，并强制要求在处理专业问题时查阅。
- 设置页面板：在 DSH 设置中集成“cognitio 系统”面板，提供记忆、规则、审批等视图。
- 审计与观测：记录所有注入、批准和改动的操作，支持六维指标监控。
安装与启用¶
安装该插件需要使用 DSH 的命令行工具。
- 执行安装命令：
dsh plugin --profile web add github:ljlj7149-cloud/dsh-cognitio
- 安装完成后，重启 DSH。插件会在启动时加载清单。
配置与使用¶
安装重启后，进入 DSH 的设置界面，找到「cognitio 系统」进行配置。
环境变量配置（可选）¶
你可以通过环境变量指定数据目录和文献库路径：
MEMORY_DIR：指定记忆数据目录，默认为~/.dsh/cognitio。VAULT_DIR：指定文献库目录，默认为~/.dsh/cognitio/vault。VAULT_INDEX_DB：指定文献索引文件，默认为<vault>/vault-index.sqlite。
典型用法¶
- 打开设置中的「cognitio 系统」，在「记忆库」页查看分层记忆和待审批条目。
- 在「规则」页查看生效中的规矩和待你批的规矩。
- 在任意 DSH 会话中重复说一句话。
- 哨兵会按需检索并注入相关规矩。
数据与隐私¶
本插件遵循数据隐私原则，所有数据均保留在本地。
- 本地存储：数据目录（如
~/.dsh/cognitio）不包含在仓库中，仅保留机制代码。 - 增量更新：系统仅增不减，不会因为更换模型或预设而失效。
- 审批机制：所有自动沉淀的产物仅进草稿，必须批准才转正。
- 许可证：采用 MIT 许可证。
结语¶
dsh-cognitio 适合希望对 AI 行为进行严格约束、建立长期知识库或需要审计 AI 决策过程的用户。它通过机制而非依赖模型自觉来维持规则，是一个适合深度使用的记忆与治理插件。
仓库地址：https://github.com/ljlj7149-cloud/dsh-cognitio
