用途:该技能用于操作一个正在运行的 opencodex(ocx)代理,通过 CLI 覆盖仪表盘的管理面,包括账户池、供应商路由、模型目录、用量与成本归因、请求日志、访问密钥等。它面向“操作代理”,安装见 AGENTS_INSTALL.md,改代码见仓库 AGENTS.md。
主要能力与用法:先运行 ocx capabilities --json 获取声明的动词、路由、标志及是否变更状态的机器可读索引;可用 --mutating-only 或 --route /api/logs 收窄。索引不完整,未声明的路由仍可能有可用命令(如 ocx access key、ocx route policy),可回退到 ocx <group> help。任何管理调用前先做三步:ocx ready --json 确认代理可用,ocx status --json 确认二进制与运行代理版本一致,再执行真实命令并加 --json。
退出码:0 成功;2 用法错误(未发送);4 未找到;5 冲突(通常可重试);1 其它(含传输失败)。退出 0 不代表无错误,需检查结果是否发生变更。失败输出含 message、reason、hint,应基于 reason 分支:oauth_mutation_busy 与 catalog_busy 为 503 且带 Retry-After: 1,可等一秒重试一次;配置锁原因稍后重试;凭据冲突原因说明安装已损坏,应运行 ocx doctor,重试无用。
限制与边界:不得代替用户给仓库点星,ocx inspect star 只读,点星 POST 需真实仪表盘会话;会话门控的 /api/codex-prompt 写入也应留给仪表盘。不要在代理会话中创建访问密钥或启动轮换,相关响应含一次性明文凭据,应由用户在人工终端完成。配置确认不等于批准吊销现有凭据,需单独明确批准。storage trash restore 与 storage policy run 无 --yes 会拒绝;storage cleanup 无 --yes 仅为预览,退出 0 不代表删除,需先报告数量与字节并获批准。远程 hub 中配对不是 hub 设置的前提,管理 API 用 admin token;ocx disconnect 后还需吊销 hub 密钥。凭据仅支持 stdin(--pairing-code-stdin、--admin-token-stdin)。