sessionrelay-eco

SessionRelay 生态 · AI 项目记忆层

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

本项目是 SessionRelay（MIT）的独立演进版——已不跟随上游，外加三端集成（DSH / ZCode / Codex）， 一个仓库装下全部内容。

---

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

这些包都在 Releases 页。 所有客户端都还需要内核（记忆本体）——从源码装一次即可，见下面「三分钟装上」。 想直接读源码的话，monorepo 里对应 packages/dsh-plugin / packages/dsh-panel / packages/zcode-adapter / packages/codex-adapter。

面板用户先看这条：dsh-panel 是独立的第二件东西，装 DSH 插件不会自动带上它。 它需要 DSH 插件已经装好（面板从插件的 vendor/dist/srelay.js 取数），然后单独装面板、再重启 DSH。 不装它的症状是「DSH 里没有『记忆台』图标」—— 插件本身完全正常。

Codex 用户先看这条：装完还必须在 Codex 里输入 /hooks 手动 trust 一次，钩子才会运行。 不 trust 的症状是「装好了但什么都没注入」—— 不是坏了，是还没批准。 这是 Codex 的安全设计，脚本无法代劳（详见包内 README-INSTALL.md）。

傻瓜式安装（每端三步）

DSH 用户

1. 下载 dsh-plugin-0.2.2.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.2.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 项目完全不知道。 经验层补上这一块：跨项目、有出处、会挑轻重、还会退休的老手经验本。

它收什么

四道闸（越往上越权威）

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

作用域

用法

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、可手改）

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

检索排序：多路融合

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

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

实测数字（不是宣传语）

与上游的关系

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

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

许可

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