返回首頁

GitHub Repo

Paperclip 更新預設代理執行器,支援原生會話恢復並加入遷移檢查

Paperclip 於 11 月 6 日發布 v2026.1106.0,讓支援平台上的新建代理預設使用 Paperclip Runner,並加入 GitHub Copilot 原生整合。既有代理保留原設定,遷移前須檢查執行環境、權限與自訂參數的相容性。

The Next Web from Amsterdam, Netherlands · CC BY-SA 2.0 · Image source
zh-Hant

開源代理管理工具 Paperclip 於 11 月 6 日發布 v2026.1106.0,將原生 Paperclip Runner 設為部分新建代理的預設執行路徑,涵蓋 Claude、Codex、OpenCode 與 Pi。既有代理不會隨升級自動切換;符合條件的 Claude、Codex 代理可透過「Upgrade runner」轉換,並查看無法沿用的設定。版本公告

技術重點是把執行生命週期、內建任務工具與原生會話識別整合到 Runner,再分別選擇模型供應商與執行環境。恢復會話時,系統重新檢查供應商、憑證、環境與任務權限;不過,各供應商支援的恢復能力不同,保存會話並不保證所有中斷操作都能接續。對維運團隊而言,這讓會話恢復的檢查條件更明確,也使供應商差異成為部署時必須驗證的項目。Runner 文件

預設切換有明確的平台門檻:支援 Intel 與 Apple Silicon Mac,以及 GNU libc 2.39 以上的 Linux x64/ARM64;OpenCode、Pi 在 Linux ARM64 仍使用舊執行器。Windows、Alpine 等 musl 系統及較舊 libc 環境也保留原路徑。判定依據是代理實際執行的主機,因此容器映像與遠端主機都需要單獨確認。平台條件

遷移也可能碰到設定不相容。部分舊介面的自訂命令、額外參數、檔案或網路範圍與回合限制,在 Runner 沒有對應項目;系統會拒絕儲存並列出衝突欄位。工程團隊應先測試環境與權限,再確認中斷恢復、用量統計及既有腳本的行為,不能僅以安裝成功判定可正式使用。遷移限制

此次版本另加入 GitHub Copilot 原生執行支援,並調整維運介面:執行歷史 API 預設回傳 200 筆、上限 1,000 筆,依賴無界陣列的客戶端須修改查詢;代理執行失敗也不再預設送往 Sentry。這些變更會影響升級後的歷史資料擷取與告警完整性,應納入部署驗收。破壞性變更

來源

  1. Paperclip v2026.1106.0 發布公告
  2. Paperclip Runner Setup and Providers