sky-mirrors/dsh-chaos-memory ↗★ 0

dsh-chaos-memory

人机恋记忆内核:双时态主张 + 势能浮现 + 双向保真度(DeepSeek Harness 插件)

套件
dsh-chaos-memory
相容性
待驗證
版本
0.1.0
授權
Apache-2.0
最近更新
2026年11月3日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:sky-mirrors/dsh-chaos-memory

3) 确认进入配置树

dsh --profile web --dump-config | grep -A1 chaos


开发时改用本地目录:`dsh plugin --profile web add /path/to/chaos`。注意依赖键会取目录名(如 `chaos`),而 `cordis.patch.yml` 按包名 `dsh-chaos-memory` 插入——把依赖键改成包名,或在 profile 的 `node_modules` 里补同名软链,否则宿主报 `Cannot find package` 且插件不激活。

三个坑,都踩过:

| 现象 | 原因 |
|---|---|
| 装完不生效,无报错 | 缺 `dsh.bundle.patch` 声明 → 只是普通依赖,不是 profile layer |
| 装完不生效,无报错 | `bundles` 里没有包名 → loader 不加载 |
| 启动报 `does not provide an export named ...` | 依赖版本与宿主不一致 → 按宿主版本重装 |

### 两条自动通道

装好即可用,不需要额外配置:

- **写入**:`session/event` 收到 `user/message` → 规则版同步抽取入库 → 后台调宿主 LLM 补语义项(失败只降级到规则版)。按 `session.id:event.seq` 去重。
- **注入**:`system-prompt/assemble` 时把该浮现的记忆拼进上下文,query 传空 → 涌现模式(Φ 排序)。

### 工具(主动调用,非必需)

```js
// 1) 补写:自动通道通常已经写过这句;这里用于补一个具体槽位或指定 kind
await chaos_write({
  slot: 'promise.bookstore',
  value: '陪你看店铺',
  quote: '说好了陪你看店铺',
  source_text: '说好了陪你看店铺',
  kind: 'commitment',
})

// 2) 检索:返回可直接注入的  块
await chaos_recall({ query: '我那只猫叫什么' })

// 3) 用户纠正:只降 AI 侧保真度
await chaos_correct({ id: 'c00001', penalty: 0.25 })

// 4) 作废:抽错,或承诺已经兑现
await chaos_retract({ id: 'c00001' })

chaos_write 的 turn 省略时沿用库内最新一轮,所以它和自动通道写的是同一条 event。

LLM 抽取的两层接口

src/extract-llm.js 是纯函数层:只接受注入的 callModel,不 import 模型 SDK、不读环境变量、不发网络请求。

import { extractLLM } from './src/extract-llm.js'

const cands = await extractLLM(text, {
  slots: ['user.pet.name', 'user.job', /* ... */],
  callModel: async (prompt) => {
    // 你想在哪调模型就在哪调
    const r = await client.chat.completions.create({ model: 'deepseek-flash', messages: [...] })
    return r.choices[0].message.content
  },
})

插件入口(index.js)把宿主的 ctx.llm 注进去:路由取自 session.requestHeader().config,用 BlockAssembler 收流。密钥始终在宿主侧——插件不读、不存、不传密钥。会话第一次请求前还没有路由,那一轮只有规则版。


三段路径

抽取:模型说了什么,不等于能入库

模型输出 (raw)
  ↓ ① slot 必须在白名单        ← 防瞎编槽位
  ↓ ② quote 必须逐字出现在原文  ← 防伪造引文
  ↓ ③ value 必须被 quote 支撑   ← 防值失真
候选 {slot, value, quote, kind}

历史记录(本次未复测):3,000 样本对抗,合法 750/750 通过,伪造引文 / 错值 / 瞎编槽位 各 0/750 放行。

模型输出里还有第二类项:{"kind":"unspoken","quote":"..."}——只回答「这段话里有没有想说却没说出口」。这一项只过第 ② 门:槽位由原文哈希派生(unspoken.,与规则版同址,同一句话不会落成两条主张),值就是原文整句。模型只能决定「判不判」,不能决定「写什么」,所以它胡编也污染不了库。规则版 UNSPOKEN_RE 保留为零成本兜底。

写入:三道门,只在一个地方

source_text + quote
  ↓ 闸门      体积 ≤ 8000 / 无 U+FFFD / 无控制字符 / 无连续 3 行重复 / 不命中凭据模式
  ↓ 引文门    quote 必须逐字出现在某条 event 原文里
  ↓ 值支撑门  value 的字符 bigram 覆盖率 ≥ 0.8
  ↓ 合并代数  同槽位冲突按 (来源优先级, 置信度, 时间) 全序裁决;平局 → deferred
claim(active / superseded / deferred / retracted)

命中凭据模式直接拒写,不脱敏——脱敏会让用户误以为密钥已被安全处理。

读取:两种模式

Φ = [a·R + (1−R)·(g·U + e·S)] · faith
faith = 0.5 + 0.5 · fidelity_ai
  • R 情境共振(BM25 归一化)
  • U 未了结压力(承诺线程,随开启时长饱和)
  • S 珍稀性增益(久未出现,一旦浮现更有价值)
  • faith 只按 AI 侧打折——用户记不清不该让这条消失

最高 R ≥ 0.2 → 检索模式(按 R 排序);否则 → 涌现模式(按 Φ 排序)。自动注入走的是后者。

历史记录(本次未复测):问「今天好累」→ 首位是「三月十七那天我一整晚都陪着你,说好了」。


关键取舍

真相是事件,不是记忆。 event 只追加、存原文;claim 是可重建的派生视图。代价是存储翻倍,换来任何一条记忆都能回溯到原话、库坏了能重放重建、抽错能撤回而不污染历史。

同一句只记一条 event。 自动通道与 chaos_write 都可能记同一轮的用户原文,所以两边都走 ensureEvent(db, ts, payload):命中就复用 id。否则同一事实携两条 evidence,合并代数会把它当成互证(corroborated),凭空抬高置信度。跨轮重复说同一句仍会 corroborated——那是互证,不是重复。

turn 时间轴属于库,不属于进程。 clock 按库(/.rivet/chaos/chaos.db)各一份;共用一个计数会让 A 会话的高 seq 把 B 会话的 valid_from 抬到未来。

不上向量库。 单用户记忆量在几百条量级,BM25(中文单字 + bigram + IDF)够用,零依赖、可解释、不会因嵌入服务挂掉而失效。

不确定时沉默。 同槽位矛盾且无法裁决 → deferred,不进注入。宁可少提一句,不提错一句。

模型是外部输入,不多给一分信任。 它抽出的每一条都要过三道门;即使它完全胡编,也污染不了记忆库。

闸门只在入口做一次。 所有校验都在 ingestClaim 这一个边界上,内部函数信任结果。

批量写入必须包事务。 24 万条裸写要 266 秒(每条 fsync),包 BEGIN/COMMIT 后 437 ms——608 倍差异。这个缺陷在 :memory: 上永远看不见。


文件结构

chaos/
  index.js            dsh 插件入口:Cordis apply(ctx)、两条自动通道、5 个 tool
  cordis.patch.yml    bundle patch:把 chaos 行 insert 进 profile 配置树
  package.json        dsh.bundle.patch 指向上面这个文件;依赖版本须与宿主一致
  src/
    constants.js      阈值常量(唯一来源)
    db.js             SQLite schema:event / claim / assembly_log + 迁移
    gate.js           写入闸门:体积 / 编码 / 凭据
    store.js          双时态存储:引文门 + 值支撑门 + 合并代数 + 四态 + ensureEvent / latestTurn
    retrieval.js      BM25(中文单字 + bigram + IDF)
    potential.js      线程派生 + Φ + 双模式装配
    fidelity.js       衰减 / 背离 / 协商话术 / 改口链
    extract.js        规则抽取器(模式表 + SLOTS 白名单,零成本基线)
    extract-llm.js    LLM 抽取器(三道门校验模型输出;含 unspoken 判断项)
  tests/              77 个用例,8 个文件
  scripts/
    ingest.js         真实对话灌入 + 统计
    llm-probe.js      真实模型抽取探针(空返回率 / 召回 / 误抽)
    e2e.js            端到端:抽取 → 入库 → 自然问句召回
    verify-all.js     六项系统验证(性能 / 预算 / 涌现 / 确定性 / 双时态)
    unspoken-bench.js unspoken 基准(训练集 / 留出集;`--llm` 走 LLM 判断项)

数据

/.rivet/chaos/chaos.db(SQLite,WAL)。库跟着会话的工作目录走,不是进程启动目录——同一进程里的不同工作区各有一个库。

表:event(真相,只追加)、claim(双时态视图)、assembly_log、schema_migrations。


验证

node --test tests/*.test.js                    # 83 个单元测试
node scripts/verify-all.js                     # 六项系统验证,零外部依赖
node scripts/unspoken-bench.js                 # unspoken 规则版:训练集 / 留出集
DEEPSEEK_API_KEY=... node scripts/unspoken-bench.js --llm   # unspoken LLM 版
DEEPSEEK_API_KEY=... node scripts/e2e.js       # 真实模型端到端(花费 token)

License

Apache-2.0 © Chaos contributors