account-rotation

账户轮换——凭据适配器

根据宿主和 Agent 系列选择凭据工具，仅执行明确要求的账户切换，并报告通过相应运行时观察到的身份。

通过目标运行时验证身份之所以有效，是因为只有运行时的判断才有意义：凭据文件可以被完美替换，但已运行的进程仍可能以旧账户进行身份验证。

命名故障模式——进程身份过期：在所有运行中的会话仍将先前账户的令牌保存在内存中时，就宣称轮换已完成。

反模式：通过比较凭据文件字节来确认切换。 纠正方式：询问相应运行时当前的身份，并报告是否需要新进程才能使该身份生效。

边界

• 仅执行调用方明确授权的账户切换；轮换会修改宿主凭据状态，不能仅凭仓库访问权限推定已获授权。
• 凭据工具由调用方或操作员根据宿主和 Agent 系列选择；下列名称是此操作员使用的路径，并非通用建议。在使用 Claude 凭据的 macOS 上，路径为 claude-acct（由 Keychain 提供支持）；基于文件的 Codex、Gemini、Linux 或 WSL 凭据使用 caam。绝不能将 caam 用于 macOS 上的 Claude 账户操作。
• 通过目标运行时验证账户身份；令牌字节不等于账户身份。
• 如果所选凭据工具或运行时身份探测都不可用，应如实报告此情况并停止。绝不能退而通过比较凭据文件字节来宣称切换已完成。
• 现有进程会保留已加载到内存中的凭据。轮换仅影响新进程。
• 此技能不会重启工作、恢复任务、选择窗格、迁移仓库状态，也不会决定切换后要做什么。

返回宿主、Agent 系列、所选工具、请求的账户或配置文件、切换前后观察到的身份、是否仍有运行中的运行时持有先前账户（即部分轮换）、命令退出代码，以及新身份生效是否需要新进程。