Skip to content

会话接力 SessionRelay v0.2.2

Choose a tag to compare

@EwanJasper EwanJasper released this 31 Aug 00:37
· 39 commits to main since this release

属于项目、不属于任何厂商的本地记忆层

你和 AI 聊了 3 天的方案,不应该随关窗消失。会话接力把你与 AI 编程工具(Claude Code / ZCode / Codex / Qoder / Trae)的对话统一采集进项目级本地数据库,提供中文全文检索、15 个 MCP 工具和开放的 HOP 交接包格式——记忆始终完整收录,检索边界由你划定。

核心能力

  • 被动捕获(零打扰):五源适配 + 守护进程每 30 秒自动同步(对抗 ZCode 上下文压缩时物理删除消息)+ 历史回填
  • 中文检索:jieba + FTS5,会话级 AND 覆盖 + OR 兜底 + 短语精确匹配,结果强制携带出处块
  • MCP Server(15 工具):8 读 + 7 写域,接入后 AI 在这个项目里不再是失忆的;上下文安全护栏默认 20 条 × 1000 字,防上下文爆炸
  • 两阶段判定:active → pending_end → confirmed,resume 自动回滚;原始会话文件是唯一事实源,可随时 rebuild
  • HOP 交接协议 hop/1.0(开放格式):sha256 完整性 + 默认密钥脱敏 + 隔离导入(反 prompt 注入)
  • 隐私四层防线:三档捕获模式 + .sessionrelayignore 硬边界 + 归档释放 99.4% 空间 + 导出脱敏;零云依赖、零网络外呼

安装

npm install -g @ewanjasper/sessionrelay
cd 你的项目 && srelay init

要求 Node ≥ 22。详细指南见 用户手册

本版本变更

文档与发布形态整理(功能与 0.2.1 一致):

  • README 新增 4 张架构/流程图(架构总览、记忆生命周期状态机、HOP 交接时序、守护进程对比 timeline)
  • README 修正过时信息(五源适配、125 测试、路线图清理)
  • 设计决策文档入口移至 CONTRIBUTING;过程性内部资料移出公开仓库
  • npm 包精简:39 文件 / 79KB

质量

  • 125 个测试(单元 / 集成 / MCP stdio 真握手契约 / 端到端)全绿
  • CI 三平台 × Node 22/24 常绿