🎉 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 尤其欢迎。