dsh-cognitio-core

Readme

# dsh-cognitio

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

![LICENSE](https://img.shields.io/badge/license-MIT-blue)
![DSH](https://img.shields.io/badge/DeepSeek%20Harness-bundle-blueviolet)
![status](https://img.shields.io/badge/status-active-brightgreen)

---

## 目录

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

---

## 这是什么

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

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

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

## 它有什么

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

## 怎么用（安装与配置）

### 安装

```sh
# 方式 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>/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 体检通过）
```

## 开发

```sh
# 依赖
pnpm install

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

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

## 测试

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

## 发布

发布前自检（两道闸）：

```sh
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