Paperclip 2026.916 升级后如何验收 Agent 凭据权限？

本周建议动作：先核对版本，再做授权回归。 Paperclip v2026.916.0 发布说明列出 49 项数据库迁移，其中涉及连接授权、委派身份和 AI 凭据。升级后别只确认页面能打开，应依次验收：谁拥有凭据、哪些成员可使用、哪些 Agent 能调用，以及撤销后旧任务路径是否仍可访问。迁移数量不代表每种部署都会出现权限异常；你需要对照实际安装版本和运行方式测试。〔v2026.916.0 发布说明〕

本文适合管理代码仓库连接、模型账户和共享凭据的自托管团队管理员、平台工程师与安全负责人。
如果你只负责模型选择或运行器参数、不管理账户授权，可把成员和凭据验收步骤交给相应负责人执行。

最后更新于 2026 年 9 月 29 日；版本事实核实自 v2026.916.0 发布说明，授权行为还应按你的实际安装版本复测。

Paperclip 2026.916 凭据权限：先划清验收边界

发布说明记录，AI 运行凭据纳入 Connections 的账户归属、授权与访问边界；凭据选择与模型、运行器选择彼此独立。旧 Agent 会保留原有身份验证方式，除非明确采用托管连接。因此，不要假设升级完成就意味着所有 Agent 已改用新凭据路径。

发布说明还记录了 Agent API 响应中的明文凭据脱敏变化。如果你的脚本曾从 Agent 响应读取密钥或令牌，升级后应检查调用方是否依赖了响应中的明文值。不要为了让旧脚本继续工作，就把凭据写进日志、配置导出或工单。API 响应中看不到明文，不等于权限配置正确，也不等于外部服务端的令牌已撤销。

管理 AI 模型运行凭据，与管理可执行操作的应用连接，也不是同一类授权路径。Paperclip 的连接访问模型将账户归属、成员范围和 Agent 可用范围作为需要分别核对的边界。〔Connections 访问模型文档〕当前文档会随版本调整，不能替代你所安装版本的发布记录与实测。

升级前：留下可审计的凭据基线

在改权限之前，先把现状记下来。每条记录只写可审计标识，不复制密钥明文：

• 账户归属：个人账户、组织共享账户，或专供某个 Agent 使用的账户。
• 使用范围：获准成员、可调用的 Agent、关联项目，以及凭据用途。
• 运行关系：Agent 当前的模型、运行器和认证来源。将这些配置分别记录，避免把“用了哪个模型”误当成“有权用哪个账户”。
• 任务样本：保留可重复执行的测试任务标识和预期结果，例如“指定 Agent 可读，另一 Agent 应被拒绝”。
• 版本与时间：记下当前安装版本、升级目标版本、部署方式和计划回滚点。

不要把令牌贴进变更单、终端截图或调试日志。用连接名称、账户责任人、脱敏后的标识或内部资产编号即可。〔OWASP 秘密管理指南〕如果现有记录无法回答“谁负责这个账户”或“哪个 Agent 正在使用它”，先补齐基线，再升级或扩大共享范围。否则，升级后的成功任务很难区分权限符合预期，还是沿用了旧绑定、旧令牌或过宽授权。

升级后：分别验账户、成员与 Agent 边界

先核对凭据属于谁，再核对哪些成员的任务可使用它，最后核对哪些 Agent 获准调用。共享账户的成员范围与可调用 Agent 列表是不同设置；改变其中一项，不应被当作另一项也已收紧。〔共享连接的成员与 Agent 范围说明〕

按以下顺序逐项检查：

• 先看账户负责人。确认个人连接仍属于预期成员；共享连接由仍在岗且有权管理连接的人负责。专属 Agent 身份不要误认作组织共享账户。
• 再看成员授权。对于共享账户，逐名核实哪些人的任务可由该账户执行。团队内所有成员都可用，与仅指定成员可用，是不同的授权结果。
• 随后看 Agent 范围。把获准 Agent 列表与任务职责逐项对应。只需要一个 Agent 的共享账户，不要保留成组织内所有 Agent 都可用。
• 最后区分认证与运行配置。分别检查账户绑定、模型选择、运行器配置及 Agent 配置。发布说明指出模型／运行器选择与凭据选择独立；旧 Agent 也可能保留原认证方式。

成员能做什么也要单独验收。不要仅凭某人能打开设置页面，就推断他拥有全部凭据管理或审计权限。确认其角色是否允许管理连接、测试调用和查看活动记录，并用相应权限的测试账号实际验证。

判定分数：“通过”表示账户负责人、成员与 Agent 范围都符合预期，且负向测试被拒绝；“需复核”表示旧绑定、继承关系或活动记录无法解释；“阻断”表示未授权主体仍能调用、撤销后仍成功，或密钥出现在日志中。出现“阻断”时，不要继续放开生产任务。

隔离环境：用正向与负向任务验证实际边界

只检查界面上的开关不够。把验证拆成有权限和无权限两条路径，使用无敏感数据的测试任务；每次只改变一个授权条件，记录操作者、Agent、连接标识、任务结果和时间。不要将单个部署的结果写成所有 Paperclip 自托管实例的统一保证。

建议按这些动作操作：

• 选择一个预期允许使用共享模型凭据的成员和 Agent，提交无敏感内容的测试任务，确认任务确实使用预期账户。
• 保持其他条件不变，改用未授权成员或未授权 Agent 发起同类任务，确认请求被拒绝或无法取得该连接。
• 检查任务轨迹和活动记录，确认判断依据对应连接授权，而非模型不可用、运行器故障、服务商限流或网络错误。
• 若测试对象是应用工具连接，区分“Agent 能看见连接”和“Agent 获准执行某个动作”。连接可见不自动代表动作获准，还要核对实际连接配置与动作范围。
• 将成功与拒绝样本留存为回归记录，但只记脱敏标识和结果，不保存密钥、访问令牌或可复用的认证材料。

若正向任务成功、负向任务被拒绝，而且结果能对应到预期账户与 Agent，就进入撤销测试；若失败原因不明，先修复测试条件，不要直接把“任务失败”判作权限生效。

撤销与回滚：确认旧任务路径也已关闭

移除 Paperclip 内的授权，与撤销凭据在上游服务中的有效性，不一定是同一个动作。如果令牌已暴露、需要彻底失效，或 Paperclip 内移除后仍能从上游使用，应按服务商流程另行撤销或轮换。

执行撤销回归时，先移除测试授权，再用原先获准的 Agent 重放同类任务。确认连接调用被拒绝，并检查活动记录中是否留下足以解释结果的信息；如仍成功，暂停该 Agent 的相关任务，排查旧认证、缓存任务、其他可用账户或服务商侧仍有效的凭据。Paperclip 的连接文档也将重新授权与断开连接列为不同管理流程。〔重新授权与断开连接说明〕不要把“连接页面显示已移除”单独作为撤销成功证据。

回滚也要按权限状态验收，而非只看服务能否启动。记录回滚版本、恢复的数据范围和授权差异；回滚后重新做一次未授权主体的负向调用，并确认不会恢复更宽的共享范围。若你无法证明回滚不会重新暴露旧凭据或权限，就不要直接回到生产流量。

验收结果：按条件决定放行或回退

• 若安装版本与发布说明匹配、基线完整、正向成功且负向被拒绝、撤销后旧路径失效：记录证据，再按团队既定发布流程逐步恢复任务。
• 若旧 Agent 仍使用原认证、身份归属不明，或活动记录不足以解释结果：标记“需复核”，保持当前任务范围，不要把旧认证误写成 Connections 新授权已经生效。
• 若未授权 Agent 可调用、密钥明文进入日志，或撤销后调用仍成功：判定“阻断”，先收紧任务与账户访问，再排查 Paperclip 绑定及上游凭据；根据结果决定是否轮换。
• 若计划回滚但无法证明旧版本的授权范围安全：暂停回滚操作，先在隔离环境核对数据迁移与凭据状态。

NIST 将最小权限概括为用户或代表用户运行的进程，只取得完成任务所需的授权。〔NIST 最小权限定义〕对应到 Paperclip AI Agent，验收目标不是“共享账户能跑通任务”，而是有明确理由的 Agent 能运行、其他主体被拒绝，且撤销后没有可继续调用的路径。

如果问题实际出在 VPSSpark 主机账户或服务操作，而不是 Paperclip 的连接权限，可先查阅 VPSSpark 帮助中心，把基础设施访问故障与应用授权失败分开定位。

FAQ：版本、共享凭据与撤销验证

升级后 Connections 的授权边界应如何理解？
发布说明记录 AI 运行凭据进入 Connections 管理，并纳入账户归属和授权边界；模型／运行器选择与凭据选择独立，旧 Agent 保留原认证，除非明确采用托管连接。具体界面和权限行为仍须对照你安装的版本，并在隔离环境测试。

怎样限制 Paperclip AI Agent 调用团队共享的模型账户？
分别限制账户可供哪些成员的任务使用，以及哪些 Agent 可以调用连接；两者是独立范围。再用获准与未获准主体执行同类测试任务，确认差异来自授权，而不是模型、运行器或网络故障。不要因为共享账户能运行，就推断所有 Agent 都应获权。

撤销 Paperclip 连接后，还要检查什么？
用原有权限的 Agent 重放测试任务，并核对任务结果和活动记录。如果连接仅从 Paperclip 移除，而上游签发的令牌仍有效，按服务商流程另行撤销或轮换。将 Paperclip 内的访问拒绝与上游凭据失效分开记录，避免把界面状态当作完整撤销证明。

自托管 Paperclip 升级后，容易漏掉哪类检查？
常见遗漏是只检查连接页面，不盘点旧 Agent 是否仍在使用原认证；或者只测成功任务，没有测试未授权主体和撤销后的重放。还应检查成员权限、Agent 范围、日志脱敏与回滚后的权限状态，并把结论限定在对应版本和部署条件内。

权限回归通过后，再检查自托管环境的网络暴露、备份和版本回滚步骤。普通服务器适合常驻、长期重负载的编排任务；但若 Agent 流程还需要验证 macOS 构建、Apple Silicon 运行环境或实体设备接口，通用服务器在操作系统、芯片架构和接口条件上都有边界，本地临时环境也需要你自行维护。租用 VPSSpark 的 Mac 环境只适合这类测试需求，不会替你自动修正 Paperclip 的凭据权限。遇到 VPSSpark 环境使用问题，可通过 VPSSpark 帮助中心查找支持入口。