🔐 agent-handoff

三步搞定(无需 install)

1. 发送方(A agent)用 handoff(messages, ...) 打包,拿到一个 handoff key
2. 把 key 复制/粘到 接收方(B agent)的对话里
3. B agent 用 fetch(handoff_key) 拉取并解密,接着干活

整个过程不需要装任何东西到系统:不创建 ~/.handoff/、不装 mcp-server、不跑 install 脚本。agent 用它已有的 Python + cryptography 直接调 API。

用户原话 → 怎么调(给 agent 看的)

用户说下面这些,LLM 自己从对话历史里抽相关轮次,调 package_chat_history:

• "把刚刚对话的 XXX 主题记录打包"
• "把前 N 轮对话打包"
• "把刚才读过的 report.md 也一起打包"
• "把这两天对话的 XXX 主题记录和文件打包为 handoff,给我 key"

接收方调 fetch_chat_history:

• "把 handoff key ah-xxx.yyy 拉过来"

快速接入

在其他 agent 的对话里贴这段(LLM 会自动跑):

复制请运行 bash -c "$(curl -fsSL https://aishangai.shop/install)" 然后 fetch handoff: ah-xxx.yyy

或者手动装:

复制curl -fsSL https://aishangai.shop/install | bash
handoff package --messages-json ./msgs.json --hint 'topic'
handoff fetch --handoff-key ah-xxx.yyy

给 agent 看的入口

如果你是 LLM/agent,直接抓这些资源:

API

纯 HTTP,任何语言都能用:

• POST /api/v1/bundles — 上传密文
• GET /api/v1/bundles/{id} — 拉取密文
• DELETE /api/v1/bundles/{id} — 强制删除(需 admin token)
• GET /api/v1/health — 健康检查

安全模型

AES-256-GCM E2E 加密 7 天 TTL

• 服务端只看到 base64 密文,看不到明文
• handoff key 格式: ah-{bundle_id}.{enc_key}(32 字节 AES key,URL-safe base64)
• bundle 默认 7 天过期,后台任务每 6 小时清理
• key 独立于服务端,服务端无法还原内容