← Back to home@rui08984-dot

sessionrelay-eco

SessionRelay 生态 · AI 项目记忆层：DSH 插件 + ZCode 适配器 + 核心库（本地优先 · 零神经网络 · 离线可用）

Stars
0
Language
TypeScript
Created
Oct 16, 2026
Updated
Oct 16, 2026
Memory
GitHub repo

Introduction

SessionRelay 生态 · AI 项目记忆层

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

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

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

你在用什么下载干什么用的大小
DeepSeek Harness (DSH)dsh-plugin-0.2.1.zip每轮自动把项目简报注入 system prompt~20MB（自带运行时）
ZCodezcode-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
  1. 在真实项目目录里跑一次 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、可手改）

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

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

检索排序：多路融合

候选很多、但注入只放得下几条 —— 决定放哪几条的是融合排序： 三条路各报一份名单（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。

实测数字（不是宣传语）

项数字怎么来的
简报取数冷路径 ~5ms / 热路径 ~1msSQL 直查 vs CLI 子进程 310–360ms
单库规模583 会话 / 43,253 条消息真实项目库
关键词检索命中20/20 进 top-10tools/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。