modiqo/waggle

解決的問題

Waggle 解決了多代理交接中的低效率與責任缺失問題。目前，協調器通常會將完整的上下文區塊轉送給子代理，導致高昂的 token 成本、上下文視窗飽和，以及缺乏關於子代理是否實際讀取所需資訊的遙測資料。Waggle 以輕量級、具歸屬資訊的引用系統，取代傳遞原始檔案路徑（缺乏版本控制與歸屬）或完整文字（成本高昂）的做法。

工作原理

Waggle 使用約 30 字節的 token 作為對一個工件的引用。協調器不傳送工件本身，而是傳送 token。當子代理解析該 token 時，會收到一個「投影」——即根據其特定模型或需求定制的資料版本（例如摘要或特定片段），在位元組預算內提供。

關鍵技術組件包括：

• MCP 伺服器：作為 Model Context Protocol (MCP) 伺服器整合，可無需自訂 SDK 直接加入 Claude Code、Cursor 和 Codex 等工具。
• 歸屬清單：追蹤 token 的發行者、委任的傳承關係，以及針對不同消費者的變體。
• 事件日誌：一個僅追加的日誌記錄每次讀取和解析操作，提供可驗證的審計軌跡（收據），證明哪些內容被存取過。
• 鏡頭（Lenses）：針對不同檔案類型的專用引擎；例如，原始碼在產生時透過 tree-sitter 處理，使代理在檢索時無需解析整個檔案即可讀取特定符號。
• 邊緣部署：token 可在多台機器間聯邦部署，或推送到 Cloudflare 的邊緣，使遠端代理可在原始主機的原始檔案始終不外洩的前提下，搜尋或解析內容。

適用對象

專為開發多代理協調器與工具鏈（如使用 Claude Code 或 Codex）的開發者設計，適用於需要降低 token 開銷、確保子代理確實消費了正確資料，並在不同 AI 供應商與環境中維持一致引用層的場景。

主要亮點

• 基於 token 的交接：用 30 字節的引用取代龐大的上下文轉儲。
• 可驗證的消費：提供「收據」與覆蓋率報告，證明代理讀取了工件的哪些部分。
• 上下文感知的投影：根據消費者的上下文與預算，僅提供必要的資料片段。
• MCP 集成：與任何 MCP 相容的 AI 工具鏈開箱即用，無需額外 SDK。
• 符號級存取：透過 tree-sitter 摘要，使代理可直接定位特定程式碼符號。
• 分散式可達性：支援本地、聯邦與邊緣方式解析 token。