@dsh-external/dsh-engram-relay

Readme

# 风识 FengShi · DSH 统一大脑

> 跨会话记忆图谱（agent 自组织）＋ 灵枢知识校准器（白箱验证）＋ 浅思维自动注入 ＋ 自动补卡/补簇 ＋ 跨端联动（知+忆）。
> 让 DSH 的 agent 拥有「记得住、懂得多、不硬答、当场学、学得快」的外置大脑。
> 百查询出招正确率 ~90%；闲聊/新域零污染（诚实边界）；使用者自己补卡/补簇当场生效。

## 是什么

风识是一个 DSH 插件，把记忆与知识融合为**一张自组织语义图**：

```
统一自适应语义图（agent 建边 · 强化遗忘 · 软簇）
 ├─ 存储层：节点=记忆/概念（蒸馏+agent 织网），跨会话分层 global/project/session
 ├─ 召回层：哈希+纯算法语义匹配（SemanticScorer 三通道，零模型）
 ├─ 浅思维：图上算子（条件/验证/边界）→ 每轮自动注入 3 行
 └─ 深挖层：14 个工具（recall/store/open/link/verify/respond…）渐进披露

灵枢（常驻校准器）：
  · D_norm 验证闸门——记忆敢想，灵枢把关敢不敢说对
  · 诚实边界——不知道就说不知道（不裁决，防过度自信）
  · 自动补卡——agent 求助且无答案（双不会）→ 当场生成知识卡 → 下次即有
```

## 设计原则

- **零 embedding**：语义匹配为纯算法（词汇 n-gram / 共现桥 / 图传播），可解释、可审计；ONNX bge 仅作对比验证（显式配置启用）
- **算法是参谋，agent 是主人**：建边由 agent 决策，算法只给候选建议
- **浅注入，深挖掘**：每轮自动注入 3 行线索，细节由 agent 用工具渐进披露
- **人类式学习**：不会 → 求助 → 查不到 → 当场补卡（当日上限 5 张，防噪声）；弱命中高频 → 自动补词网（俗语→规范词桥接）
- **诚实边界**：证据不足不裁决，图谱外明说，绝不硬答

## 功能清单

| 能力 | 说明 |
|---|---|
| 记忆注入 | 每轮 API 调度自动注入相关记忆入口（记忆+浅思维三行） |
| 浅思维 | 条件（邻域 kind 分布）/ 验证（灵枢校准）/ 边界（教训邻域+边界词） |
| 自动补卡 | agent 求助无答案 → LLM 生成知识卡（空返回时启发式保底）→ 灵枢写入 |
| 自动补簇 | 弱命中查询 ≥3 次 → 从查询提取俗语词自动建簇（零 LLM，相关性质量门）→ 词网自组织 |
| 占位卡治理 | 无答案补卡的占位卡标 pending——不参与出招/验证（防污染），等 LLM 生成真卡 |
| 蒸馏保底 | 回合后 LLM 蒸馏；空返回时启发式直接沉淀（记忆不断流） |
| 自动成族 | 语义图软簇（层次聚类，分辨率可调）——无硬分类 |
| 跨域桥 | agent 跨域对话触发桥边——「融会贯通」的结构化形态 |
| 工具面 | 14 个工具：recall/store/propose/confirm/reject/open/search/link/update/remove/promote/status/verify/respond |

## 装配（与本地一致）

### 1. 克隆与构建

```bash
git clone https://github.com/yjh051108/dsh-engram-relay.git fengshi
cd fengshi
npm install --legacy-peer-deps   # 依赖精确锁定（package-lock.json 已入库）
npm run build            # 构建 lib/（tsc host + tsdown client）
```

### 2. 装配到 DSH

```bash
# 方式 A：热装（免重启，开发用）
# 用 DSH 注入器 dev_inject_plugin 指向本仓库目录

# 方式 B：正常装配（重启生效，生产用）
dsh plugin --profile web add .
```

### 3. 启动灵枢云（校准器服务，127.0.0.1:18766）

```bash
python lingshu/start_lingshu.py    # 自愈 watchdog：崩溃 1s 自动重启
```

### 4. 配置（cordis.patch.yml 或 schema 默认值）

```yaml
config:
  lingshuVerifyUrl: 'http://127.0.0.1:18766'   # 灵枢校准器（默认开启）
  embedModel: ''                                # 空 = 纯算法语义匹配（默认）
  distillEveryTurns: 2                          # 回合蒸馏频率
  injectBudgetTokens: 200                       # 注入预算（token）
```

## 验证（装配后 30 秒确认）

```bash
npm run verify    # 运行自检：服务健康 + 卡库 + 记忆库 + 浅思维冒烟
```

新会话里问：
- 「铁门放外面久了为什么生锈」→ 记忆/知识命中
- 「量子纠缠能不能超光速通信」→ 浅思维验证行（?图谱外 或 ✓锚定）
- 任意灵枢无卡的问题连续求助 → 自动补卡（~15s 生效）

## 与本地一致的说明

发布包包含：插件完整源码 + 灵枢运行集（`lingshu/`）+ 卡库种子 + 装配脚本（git clone 后需 `npm run build` 产出 lib/）。
本地与大家装配的差异仅剩：DSH 版本与 node_modules 解析（README 与 INSTALL 已覆盖）。

## 架构文档

- `docs/unified-brain.md`：统一大脑架构（图网络+浅算子+校准器）
- `docs/unified-routing.md`：零 embedding 统一路由设计（含文献：WordNet 扩展 / PRF 共现 / SPLADE）
- `docs/INSTALL-new-machine.md`：换机装配指南

## 许可证

BSD-3-Clause（工程代码）。协议概念（智能论/信息差）权利归协议方。