DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

rui08984-dot /

rui08984-dot/sessionrelay-eco

Topic repository only

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

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@357576d4

SessionRelay 生态 · AI 项目记忆层

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

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


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

你在用什么 下载 干什么用的 大小 要 trust 吗
DeepSeek Harness (DSH) dsh-plugin-0.2.3.zip 每轮自动把项目简报注入 system prompt + 图形面板 ~21MB(自带运行时) 否
ZCode zcode-adapter-1.0.2.zip 开场简报 + 每轮相关召回(SessionStart + UserPromptSubmit) ~32KB 否
Codex codex-adapter-1.0.0.zip 开场简报 + 13 个 MCP 工具 + 交接技能 ~35KB 是
DSH 想要图形面板 dsh-panel-0.1.0.zip 记忆台:图谱(可拖拽)/ 看板 / 经验 / 28 个旋钮 ~0.3MB 否
全都用 / 新机器一次装齐 ses-offline-<日期>.zip 全家桶:内核产物 + 插件 + 适配器 + 技能 + 工具 ~20MB —

这些包都在 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
  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、可手改)

注入预算(各端不同,都不挤占简报)

端 时机 预算
ZCode SessionStart 开场 按重要度给最重要的几条(开场还没有本轮可言)
ZCode UserPromptSubmit 每轮 按相关性筛(经验 ≤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 / 热路径 ~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。

—/ 5

No ratings yet

Manifest verification required

Commit 357576d4f599

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout