项目记忆简报 rui08984-dot/sessionrelay-eco

SessionRelay 生态 · AI 项目记忆层

让你的 AI 记住这个项目：决策、未决问题、最近在动的东西，在你开口之前就摆到它面前。
本地优先 · 零神经网络 · 完全离线可用 · 一个项目一个库。

本项目是 SessionRelay（MIT）的深度改造，外加两端集成，一个仓库装下全部内容。

⬇️ 先看你用哪个客户端，就下哪个

| 你在用什么 | 下载 | 干什么用的 | 大小 |
| DeepSeek Harness (DSH) | dsh-plugin-0.2.1.zip | 每轮自动把项目简报注入 system prompt | ~20MB（自带运行时） |
| ZCode | zcode-adapter-1.0.1.zip | 开场简报 + 每轮相关召回（SessionStart + UserPromptSubmit） | ~21KB |
| 两个都用 / 新机器一次装齐 | ses-offline-\<日期\>.zip | 全家桶：内核产物 + 插件 + 适配器 + 技能 + 工具 | ~20MB |

三个包都在 Releases 页。
两个客户端都还需要内核（记忆本体）——从源码装一次即可，见下面「三分钟装上」。

傻瓜式安装（每端三步）

DSH 用户

1. 下载 dsh-plugin-0.2.1.zip，解压
2. 把 dsh-plugin/ 整个目录复制到 <你的 DSH 配置目录>/profiles/<profile>/local-plugins/dsh-srelay-brief/
3. 重启 DSH → 新开会话，开场应出现 📋 看板 / 决策行

（Windows 上 DSH 配置目录一般在 C:/Users/<你>/.dsh/；profile 常见是 web 或 desktop。）
包内 README-INSTALL.md 有同一份步骤 + 排障表。

ZCode 用户

1. 下载 zcode-adapter-1.0.1.zip，解压
2. 在解压出来的 zcode-adapter/ 里跑两条命令：

node install.mjs # 先看计划，不写任何东西（dry-run）
node install.mjs --apply # 真装：拷文件 + 注册 SessionStart / UserPromptSubmit 两个 hook

3. 在真实项目目录里跑一次 brief.mjs 验收，或直接新开会话看有没有 📍项目状态简报

（安装器会先备份你的 ZCode 配置，失败了能精确恢复。）

它解决什么问题

命令行 AI（ZCode、Claude Code…）的工作目录天然等于项目根，开场读一次项目状态是顺手的事； 桌面端 AI（DSH）三条常规信号全断——你换个窗口继续干活，它对项目既有的决策一无所知。

更麻烦的是静默半失效：装了一个看起来正常的记忆插件，命令成功、库建好了、自检全绿——而你的会话永远采不进来，全程零报错。这个仓库里几乎每一处设计，都是被这类「绿着的坏」逼出来的（详见 docs/ENGINEERING-NOTES.md）。

三个核心能力

1. 每轮自动带上项目简报（DSH 侧）不是写死在文件里，而是每个模型步骤前现查一次记忆库——这一轮你做的决定，下一轮它就知道。
简报限 1200 字符，走 SQL 直查：冷路径约 5ms，而调 CLI 子进程要 310–360ms。

2. 开场自动注入（ZCode 侧） SessionStart hook 组装简报塞进会话开场。任何失败 = 空输出 = 不阻塞会话。

3. 一个项目一个库，永不合并 <项目>/.sessionrelay/relay.sqlite，SQLite + FTS5，中文分词（jieba / bigram 可选）。
隐私边界就是文件边界：删掉目录即彻底消失。

三分钟装上（源码方式）

完整步骤（含离线、沙箱验证、卸载回滚）：INSTALL.md

1) 内核：装到全局（两个客户端共用）
cd packages/core && npm install && npm run build && npm i -g .

2) 给某个项目建记忆库
cd /path/to/your-project && srelay init

3) 选你的端（见上面「傻瓜式安装」）

完全离线（新机器、无 npm、无网络）：用 Release 里的全家桶，见 release/README.md。

仓库结构

packages/core/ 核心库（TypeScript）：采集 → 提取 → 检索 → 归档 → MCP packages/dsh-plugin/ DSH 插件（vendor 由 Release 包提供） packages/zcode-adapter/ ZCode SessionStart hook + 一键安装器 skills/handoff-atlas/ 交接与全资源地图技能（含锚点审计、地图生成器） tools/ 安装器 / 重建 / 一致性守门 / 召回探针 / 客户端打包 docs/ 架构、工程笔记、常见问题 release/ 离线包与客户端包说明、发布清单

全局经验层（🌍 跨项目经验）

记忆原本是一个项目一个库——你在 A 项目踩的坑，B 项目完全不知道。
经验层补上这一块：跨项目、有出处、会挑轻重、还会退休的老手经验本。

它收什么

| ✅ 收 | ❌ 不收 |
| 环境/工具的事实（本机 pnpm 必须 ≥10.34） | 一次性的具体状态（今天改了 db.ts——那是项目记忆的活） |
| 踩过的坑 + 判据（自动推翻实测误配 87%，别再试） | 主观评价、未验证的推测 |
| 操作配方（改完必须跑 X） | 密钥/凭证（只存去哪儿找，永不存值） |
| 跨项目都成立的口径（数字必须绑快照与口径） | 模型自己的感想 |

四道闸（越往上越权威）

| 闸 | 判据 | 不过会怎样 |
| 闸 0 出处（准入） | 必须挂得上可核验出处：真实工具调用记录 / 用户原话逐字 / 文件内容 | 降为 inferred，只能当草稿，永不进注入层 |
| 闸 1 定级 | verified-tool 9.0 / verified-user 7.5 / verified-file 6.0；阈值 5.5 | 沉到线下（仍可搜到，不删） |
| 闸 2 相关性 | 要与本轮具体重合（命中标识符或实词）；常用词不算数 | 不注入 |
| 闸 3 人工确认 | draft → verified，只有人能升 | 不许升作用域 |

不能随便入库的落地：模型自动产的一律 draft（不进注入层，等于候审）；升 verified 只有两条路——证据到位 或 人工确认；升作用域必须人工确认；永不自动删（退休只是不再默认注入）。

作用域

| 作用域 | 谁看得见 | 怎么产生 |
| project | 只有本工作区 | 默认 |
| domain | 同领域标签的项目 | 需证据（同领域 ≥2 个工作区各自确认过） |
| global | 所有项目 | 只有显式升级 |

用法

SRELAY_GLOBAL_HOME=~/.sessionrelay srelay lesson add "<一句话经验>" --source <出处> --grade verified-user --scope global
srelay lesson list # ● 可进注入层 / ○ 已退休（仍可搜） srelay lesson search <关键词> # 换词能命中（复用项目同一套分词器） srelay lesson harvest # 从项目记忆里刨候选（只产草稿） srelay lesson confirm <id...> # 人工复核：确认即证据（inferred → verified-file 6.0） srelay lesson maintain # 年龄衰减 / 退休 / 复活 srelay lesson export # 导出 Markdown（人可读、可 git、可手改）

注入预算（两端不同，都不挤占简报）

| 端 | 时机 | 预算 |
| ZCode | SessionStart 开场 | 按重要度给最重要的几条（开场还没有本轮可言） |
| ZCode | UserPromptSubmit 每轮 | 按相关性筛（经验 ≤200 字符 / 旧决策 ≤2 条）；没命中就整段不出现 |
| DSH | 每个模型步骤前 | 按重要度给 ≤200 字符 / ≤3 条 |

检索排序：多路融合

候选很多、但注入只放得下几条 —— 决定放哪几条的是融合排序：三条路各报一份名单（FTS 主路 / 改写路 / 不走分词器的子串路），按 Σ w/(60+rank) 合成一份， 被越多路认、且在各自名单越靠前，就越可信。长度惩罚进到每条路内部（巨型会话在每条路上都是第一名，事后乘系数改不动）。

实测（129 条/臂）：hit@1 +1.5~7.0 个百分点、hit@3 +1.5~4.6；hit@10 −1.5~3.9（用尾部换头部，对注入场景正合适）。
复跑：npx tsx core/SessionRelay/scripts/recall-bench.ts <库路径> --n 150。

实测数字（不是宣传语）

| 项 | 数字 | 怎么来的 |
| 简报取数 | 冷路径 ~5ms / 热路径 ~1ms | SQL 直查 vs CLI 子进程 310–360ms |
| 单库规模 | 583 会话 / 43,253 条消息 | 真实项目库 |
| 关键词检索命中 | 20/20 进 top-10 | tools/ses-recall-probe.mjs 20 问基准 |
| 大白话检索命中 | 17/20 进 top-10（top-1 仅 10/20） | 同上——这是本项目的已知短板，写在明处 |
| 提取规则版本 | EXTRACT_VERSION = 18 | 每次改规则都要能重算存量 |
| 一致性守门 | A–I 九段全绿 | tools/check-versions.mjs |

与上游的关系

上游骨架（旁路捕获 / 规则提取 / SQLite+FTS5 / 三反幻觉 / 删除权在人）一行没动，全部是增量： DSH 适配器、第六采集源 dsh、自动归档、提取质量八层防线、跨端简报、项目判定、 srelay doctor 体检、多副本一致性守门。

不追求与上游合并——本项目按自有仓库独立发展。上游版权与许可完整保留（见 LICENSE）。

许可

MIT。上游 © EwanJasper，本仓库改造部分 © rui08984-dot。