Paperclip 2026.916 升級後如何驗收 Agent 憑證權限？

Paperclip 2026.916 升級後，先驗收憑證由誰擁有、哪些成員獲准使用、哪些 Agent 能呼叫，以及撤銷後是否確實失效；本週先在隔離環境完成權限回歸，不要只確認管理介面能開啟。這項建議適用於自託管 Paperclip，實際結果仍須對照你的安裝版本與部署設定。

管理程式碼倉庫連線、模型帳戶，或負責憑證治理的安全負責人，應按下列時間線執行。若你只負責一般 Agent 提示詞與模型選擇，並沒有帳戶授權或部署管理權，本文的權限驗收流程未必由你執行。

最後更新於 2026 年 9 月 29 日；版本資訊核對自 Paperclip v2026.916.0 發布說明，權限流程核對自 Connections 存取模型、共享連線授權範圍及重新授權與中斷連線說明。

先界定 2026.916 這次要驗收的範圍

把 v2026.916.0 當作本次核對的版本識別，不要把後續版本才加入的功能或預設值，回填成這次升級已具備的能力。官方發布說明記錄了與連線憑證及權限邊界相關的變化；至於你的部署中哪個成員、哪個 Agent 實際可用，仍要以目標版本文件及隔離測試為準。

表格左欄描述文件可核對的範圍，並不代表所有連線類型在你的環境中有相同預設值。先確認安裝版本，再閱讀與該版本相符的發布記錄和連線存取模型文件；若文件或畫面不足以判定授權範圍，就把該項列為待測，而不是自行推斷。

升級前：留下可比較的權限基線

升級前先盤點個人帳戶、共享帳戶及目前綁定的 Agent。每個帳戶記錄負責人、授權來源、用途、可使用的成員與任務；每個 Agent 記錄連線名稱或其他不含秘密的識別碼，以及它預期會執行的操作。

不要把密鑰明文複製到試算表、工單、終端機畫面截圖或日誌。用可稽核的帳戶標籤、連線識別碼或秘密管理系統中的參照值，讓維運人員能追查對象，又無法從文件直接取得憑證。這符合秘密管理指南對秘密存放與暴露風險的處理方向。

基線至少要能回答以下問題：

• 憑證的負責人是個人，還是團隊共用帳戶？
• 哪些成員目前獲准使用？授權是直接授予，還是透過共享範圍取得？
• 哪些 Agent 綁定或預期使用這個連線？它們各自需要完成什麼任務？
• 哪些工作正在執行，是否會在升級後繼續使用既有授權狀態？

最後一項容易被忽略：介面上的綁定狀態不等於實際工作已使用同一條授權路徑。升級前記錄一個可重現、無破壞性的測試任務，升級後用相同條件比較結果。這是部署層的驗收方法，不是對 Paperclip 內部快取或執行行為的產品保證。

整理基線時，也可以將不含密鑰的操作紀錄與VPSSpark 說明中心所提供的支援資訊分開保存；不要在一般求助內容中貼上憑證明文或可直接重用的秘密值。

升級後：逐一確認擁有者、成員與 Agent 範圍

升級完成後，先確認帳戶負責人，再查共享對象和 Agent 使用範圍。Paperclip Connections 的帳戶綁定、成員授權與 Agent 設定不是同一個檢查項目；不要因為某個 Agent 已設定模型或執行器，就判定它因此取得了某個帳戶的使用權。

官方共享連線成員與 Agent 範圍說明可作為逐欄核對的依據。你需要確認：

• 帳戶負責人仍是預期的個人或團隊帳戶，沒有因升級或人工操作而改變。
• 共享對象只包含工作所需的成員；不應使用「方便所有 Agent 共用」取代明確授權。
• Agent 能使用的連線符合其任務範圍；若設定與基線不符，先暫停相關任務並查明原因。
• 模型或執行器設定只按其設定目的檢查，不拿來代替連線憑證的存取檢查。

此處套用的是最小權限原則：只授予完成指定工作所需的存取權。最小權限定義可協助你把「方便重用」和「確有工作需要」分開。若 Agent 只需讀取某個資源，就不要只為了讓測試快速通過而擴大到無關帳戶或操作範圍。

在隔離環境用任務結果驗證授權

權限畫面只能說明設定狀態，不能單獨證明執行路徑符合預期。準備不會寫入正式資料的測試任務，分別以獲准與未獲准的成員、Agent 發起呼叫；保存結果、時間、連線識別碼及使用的安裝版本。失敗測試也要保留，因為拒絕結果正是驗收證據之一。

測試成功只代表指定安裝版本、連線類型、帳戶和任務組合的觀察結果。不要把單一測試推廣成所有 Paperclip AI Agent、所有連線或其他自託管部署都會有相同結果。若任務成功但使用了非預期帳戶，也不能算通過；記錄實際使用的連線識別碼，再追查為何授權路徑與預期不同。

撤銷後回歸：確認拒絕、活動紀錄與回滾

依照目標版本的重新授權與中斷連線說明，在測試帳戶上執行撤銷或中斷操作。操作完成後，使用相同的成員、Agent 和測試任務重試，確認呼叫結果已改變，再查看活動紀錄是否能支持這個判斷。若只看到連線顯示已中斷，卻沒有以任務驗證拒絕結果，驗收仍不完整。

回滾也要當作權限測試的一部分。升級前保留可還原的部署方案，但不要把含有密鑰明文的設定檔當作回滾材料。若回滾會重新套用舊的共享範圍，先在隔離環境確認它不會恢復已撤銷的授權；無法確認時，停止回滾流程並先修正帳戶範圍。

依條件決定是否放行

• 若擁有者、成員範圍、Agent 呼叫結果都與基線相符，而且撤銷後測試確實遭拒，才放行這個已測組合；保留版本、連線識別碼與結果紀錄。
• 若獲准呼叫也遭拒，先回查該帳戶的授權或重新授權狀態；不要為了讓任務成功而直接擴大共享範圍。
• 若未獲准成員或 Agent 仍能呼叫，立即暫停受影響任務，檢查共享成員、Agent 綁定及其他可能的授權路徑。
• 若回滾可能恢復較寬的授權，先不要回滾到正式環境；改在隔離環境確認權限差異，再選擇可保留撤銷結果的處理方式。

常見問題

Paperclip 2026.916 的 Connections 權限要怎麼確認？

先核對實際安裝版本，再對照該版本發布說明與 Connections 存取模型文件。逐一確認憑證擁有者、共享成員及 Agent 可用範圍；文件沒有明確保證的行為，應在隔離環境測試，不要推定所有部署都相同。

怎樣避免 Agent 使用不該用的共享模型憑證？

把帳戶負責人、獲准使用的成員和允許呼叫的 Agent 分開記錄。用未獲授權的成員或 Agent 執行受控任務，確認請求遭拒；不要把模型或執行器設定當作帳戶授權，也不要在紀錄中留存密鑰明文。

撤銷 Paperclip 憑證後，怎麼確認 Agent 已不能呼叫？

撤銷後以相同 Agent 和測試任務再次呼叫，觀察拒絕結果並核對活動紀錄。若任務仍成功，先停止使用該憑證，再檢查授權範圍、執行中的工作與部署狀態；不能只依據畫面顯示已斷開就判定撤銷生效。

Paperclip 自託管升級後，憑證權限要檢查哪些項目？

先留存升級前的帳戶與 Agent 綁定，再核對擁有者、共享成員、Agent 使用範圍及實際任務結果。接著測試授權、拒絕和撤銷，檢查活動紀錄，並確認回滾不會恢復過寬權限或暴露密鑰。

如果目前是把 Paperclip 長期放在既有伺服器上，你的主要風險在於憑證範圍、部署設定與撤銷驗證；單純換成 Mac 並不會自動修好權限。若你需要臨時的 Mac 開發或相容性測試環境，VPSSpark 租用 Mac 可作為另一種測試選擇，但 Paperclip 能否在該環境按你的部署方式執行，仍要先核對需求。完成這次權限回歸後，優先補齊自託管環境的網路暴露、備份與版本回滾檢查；若你要以流動網路檢查管理介面的連線可用性，可將測試裝置的連線方式與伺服器權限驗收分開規劃，例如參考香港 eSIM 方案。若網路暴露、備份或回滾步驟尚未驗證，就先不要把測試通過等同整體部署安全。