为什么需要
多 Agent 系统里，子 Agent 之间需要传递文件、代码、文档。最直接的做法是粘贴全文——但一个文件动不动几千 token，重复传递上下文让成本飙升。Waggle 的思路是：传一个 30 字节的令牌，而不是整个文件。接收方按需拉取自己需要的部分，不再重复传递完整内容。对运行 Claude Code 编排脚本的独立开发者来说，这能直接省掉一大笔 token 费用。
怎么用
安装：
bash
cargo install waggle
生成令牌（发送方）：
bash
waggle create /path/to/large-file.md
# 输出：~30字节的令牌，如 waggle://abc123...
接收方拉取：
bash
waggle resolve waggle://abc123...
也可以只读取部分内容（按行数或 token 预算）：
bash
waggle read waggle://abc123... --lines 50
waggle search waggle://abc123... --pattern "function"
使用案例
你用 Claude Code 编排一个脚手架生成任务：主 Agent 分析需求后，把项目模板文件传给 3 个子 Agent 各自生成不同模块。用 Waggle 而不是粘贴全文，token 消耗从约 18,000 降到约 2,500。
另一个场景：代码审查流程中，主 Agent 把变更文件用 Waggle 传给审查 Agent，审查 Agent 只拉取自己需要看的 diff 部分，而不是整个上下文。
注意事项
- 需要所有 Agent 都安装 Waggle 才能解析令牌
- 令牌本身不包含文件内容，仅为引用地址
- 本地文件系统共享时，令牌可解析为本地路径；跨机器需额外配置
- 项目较新（2026年7月），社区和文档尚在完善中