Skip to content

Releases: Mars535821089-ops/Relay-Card

v0.6.0 — Initial open-source release

Choose a tag to compare

@Mars535821089-ops Mars535821089-ops released this 21 Jun 08:29

🎉 Initial Open-Source Release

Relay Card 是一个跨 AI 工具的「上下文接力」机制:当你的 AI 编程助手(Claude Code、Cursor、Aider 等)的对话上下文即将耗尽或被压缩时,自动从对话历史、git 状态、未保存修改中提取出当前任务、已完成、待办、关键决策、踩过的坑,生成一张可读的接力卡;新 session 开头只要读这张卡,就能无缝衔接上下文。

✨ 核心特性

  • 🏃 自动触发 — 监听 AI 工具的 compact 事件,无需手动介入
  • 🎯 智能抽取 — 中英文 n-gram + 关键词匹配,自动识别目标/进度/决策
  • 🔒 敏感信息脱敏 — 内置 9 类规则(API key / 邮箱 / JWT / AWS / 私钥),写卡前自动擦除
  • 📦 三级归档 — 活跃区 / 月归档 / 压缩区,磁盘不爆
  • 🛡️ 钉住保护.pin 文件防止重要卡被自动归档
  • 🔌 工具无关 — Core 与 AI 工具解耦,Claude Code 是首个 adapter
  • 🌏 多语言友好 — 关键词提取同时支持中文 n-gram 和英文 word boundary

📦 5 分钟上手

# 一键安装
curl -fsSL https://raw.githubusercontent.com/Mars535821089-ops/relay-card/main/scripts/install.sh | bash

# 验证
bash ~/.relay-card/hooks/relay-card-write.sh --auto

🏗️ 架构

三层架构:AI Adapter (Claude Code 首个) / 工具无关 Core / Storage。

新 AI 工具只需 50 行 adapter,把工具事件转成标准 JSON 喂给 Core。详见 docs/adapters.md

🧪 测试

  • 5 个 bats 单元测试
  • 1 个端到端集成测试
  • GitHub Actions CI: shellcheck + shfmt + macOS/Ubuntu matrix

🌟 它是怎么演化出来的

v0.1 → v0.6,8 天从空模板迭代到完整机制。完整故事见 README。

🤝 贡献

欢迎 PR!参见 CONTRIBUTING.md。其他 AI 工具 (Cursor / Aider / Cline) 的 adapter 尤其欢迎。