认知记忆架构ljlj7149-cloud/dsh-cognitio

dsh-cognitio

纠错驱动的认知架构插件 —— 让 DeepSeek Harness 的 AI 记住你的规矩、教训与知识，并在该守规矩的时刻自动提醒；所有自动沉淀，你批准才生效。

LICENSE
DSH
status

目录

- 这是什么
- 它有什么
- 怎么用（安装与配置）
- 设置页 / cognitio 系统
- 架构
- 开发
- 测试
- 发布
- 数据与隐私
- FAQ
- 许可证

这是什么

cognitio（认知·张力网络）是一个 DeepSeek Harness 插件，把“AI 的记忆与自律”从凭自觉变成机制：

- 记忆是分层的（事实/规矩/模式/案例/命题），改过的内容永远能查旧版（版本链）
- 提醒是机械触发的（每回合/动作前/出错/回合末自动检索），不依赖模型记住你定的规矩
- 进化是纠错驱动的（出错 → 自动归档 → 每日提炼 → 你批准 → 成为新规矩）
- 你永远是仲裁者：一切自动产物只进草稿，批准才转正（审批面板可见可一键批）

一句话：它是“会自我进化的规矩与记忆系统”，不是一个聊天机器人。

它有什么

| 能力 | 说明 |
|---|---|
| 🧠 记忆井 | SQLite 分层记忆：fact（事实）/ rule（规矩）/ pattern（模式）/ case（案例）/ proposition（命题）；版本链 + 墓碑软删 |
| 🪞 关系与效力 | 条目间关系（依赖/支持/矛盾/证据）；规则效力成绩单（管用几次/失效几次），失效自动进入“死规矩/推翻候选”池 |
| 🔔 哨兵触发 | 回合开始 / 工具调用时点 / 出错 / 回合末 四类机械触发 + 闲聊零打扰；触发词双向匹配 + 证据加权 + 遗忘衰减 |
| 🐛 纠错管道 | 出错自动归档草稿（过滤环境性错误）；回合末归档哨兵；每日无人值守维护（体检/巩固/阅读/蒸馏） |
| 🧭 文献知识 | 文献井（只读全文检索）+ 专业问题强制查库义务 |
| 🖥️ 设置页面板 | DSH 设置 →「cognitio 系统」：记忆/命题/规则/决策/审计 五区一览 + 审批 + 审计翻译成人话 |
| 🔒 审计与观测 | 每一次注入/批准/改动全留痕；六维指标（覆盖/精确/时效/预算/抗噪/可审计）自监控 |

怎么用（安装与配置）

安装

方式 A：从 GitHub 直接安装（推荐，生态惯例）
dsh plugin --profile web add github:ljlj7149-cloud/dsh-cognitio

方式 B：npm 包（发布后）
dsh plugin --profile web add dsh-cognitio-core

方式 C：本地目录（自托管/开发）
dsh plugin --profile web add file:/path/to/dsh-cognitio

安装后 重启 DSH（插件清单在启动时装载一次）。重启后：设置 →「cognitio 系统」。

配置（可选）

| 环境变量 | 作用 | 默认 |
|---|---|---|
| MEMORY_DIR | 记忆数据目录 | ~/.dsh/cognitio |
| VAULT_DIR | 文献库目录 | ~/.dsh/cognitio/vault |
| VAULT_INDEX_DB | 文献索引文件 | /vault-index.sqlite |

首次启动自动初始化数据目录；不配置也能用（默认路径）。

三分钟体验

1. 装好并重启后，打开 设置 →「cognitio 系统」
2. 「记忆库」页：看到分层记忆 + 状态（已生效/待审批）+ 筛选胶囊（全部/事实/规矩/模式/案例/命题）
3. 「规则」页：生效中的规矩（50 条+）与待你批的规矩分区显示；点条目展开定义/触发词/失效条件
4. 在任意会话重复说一句话——哨兵按需注入相关规矩（人工验证触发链路）

设置页 / cognitio 系统

DSH 设置 →「cognitio 系统」：

- 记忆库：全量记忆 + 类型筛选 + 前缀搜索 + 行内展开详情 + 待审批条目就地批准/毙掉
- 命题与范畴：我们总结的“毛病类型”看板（案例计数/状态/成熟度），供你仲裁重点
- 规则：🔵 生效中的规矩 / 🟡 待你批的规矩（分组），反例覆盖标记（✓/⚠）
- 待裁决：等待你拍板的决策队列（选项下拉 → 按所选方案执行）
- 审计流：谁在何时对哪条记忆做了什么（人话翻译：写入/批准/毙掉/补记）；近 7 天疑似未走审批即转正的可疑项，可补记

架构

哲学内核：张力网络（命题可推翻 + 反例 + 外部锚点）· 纠错驱动进化 · 用户仲裁
┌─────────────────────────────────────────────┐
│ ⑦ 治理层   审批面板 + 决策队列 + 审计链（你仲裁）│
│ ⑥ 知识层   文献井（只读 FTS）+ 强制查库义务     │
│ ⑤ 观测层   注入审计 + 六维指标 + 死规矩/推翻候选 │
│ ④ 沉淀层   出错归档 / 回合归档 / 每日维护       │
│ ③ 触发层   哨兵：回合/动作/出错/回合末 四面注入  │
│ ② 检索层   FTS5 + 触发词双向 + 证据加权 + 衰减   │
│ ① 数据层   SQLite：版本链/关系表/效力成绩单     │
└─────────────────────────────────────────────┘
↕ 事件钩子（pre-step/turn-stopping/error/pre-execute）
↕ 宿主：DeepSeek Harness（bundle 插件形态，plugin_check 体检通过）

开发

依赖
pnpm install

构建（生成 lib/，prepare/prepack 钩子自动执行）
pnpm build

目录
src/      源码（哨兵/记忆井/文献井/面板 API/聚合入口）
client/   设置页前端（手写产物，无构建链）
scripts/  构建/装订/井行生成/迁移/隐私防线
skills/   随包技能（cognitio/session-init/handoff/memory-consolidation）
docs/     MIGRATION 移植手册

测试

全链路协议测试（node:test，覆盖记忆井/哨兵/事件插件/文献井）
node --test memory-server.test.mjs sentinel-plugin.test.mjs p2-plugins.test.mjs vault-server.test.mjs

发布

发布前自检（两道闸）：

sh scripts/pre-commit-guard.sh   # 隐私防线：记忆数据/凭据/临时产物禁止入库
plugin_check                     # 官方插件体检（bundle 形态 20 项）

数据与隐私

本仓库不含任何记忆数据。 你的记忆、项目内容与凭据永远留在你的机器：

- 数据目录（~/.dsh/cognitio 或 MEMORY_DIR）不在仓库内
- npm 包 files 白名单只含机制代码
- scripts/pre-commit-guard.sh 在提交时拦截数据/凭据/临时产物
- 记忆写入经 no-secrets 扫描（检测器自身豁免逻辑见脚本注释）

FAQ

Q：装了会改变我的 AI 行为吗？
A：只增不减——多一套"该守规矩时的提醒"；所有提醒内容来自你自己的记忆库，可随时在设置页查看/删除。

Q：和普通记忆插件（如 dsh-memoir）区别？
A：它们多是"会话归纳→存文件"；cognitio 是完整闭环：触发-沉淀-治理-审计-进化，且所有自动产物必须你批准，并有六维自监控。

Q：换模型/换预设会失效吗？
A：不会。提醒是机械注入（不依赖模型自觉），挂在宿主总装层（与预设解耦）——这是本项目核心设计目标之一。

Q：能贡献吗？
A：欢迎 PR/Issue（机制增强、测试、文档）。注意别提交含个人记忆数据的 dump。

许可证

MIT © cognitio contributors