非交互认证与恢复

凭据输入

pluginctl auth login --token-stdin --config ./private/auth.json --endpoint https://market.example/v1/graphql --json < ./private/token.txt

凭据文件由用户或 secret manager 提供，Unix 设置 0600，并使用 0700 私有目录。 不要在参数、源码、聊天、evidence 中包含有效 token 或 grant URL。 配置绑定明确 endpoint；不同服务地址不自动沿用凭据。

稳定操作

publish 需要 journal。一次用户意图只生成一次 command ID，重试保持原输入和 ID。 status 合并 receipt 查询与插件状态；review 无 approve/reject 时列队列，需要明确决定才提交。 日志、缓存、通知或 Agent 自报不是完成证明。

取消与恢复

CLI 操作有期限并处理取消；离开或超时后保留 journal 查询结果。PAT 到期或撤销时使用 同一账号的新 PAT；账号/endpoint/input 变化会被 journal 绑定拒绝。 新 CLI 不接受旧格式发布 journal；已完成的旧记录保留为历史，不复用到新版本。

API 调用

GraphQL endpoint 为 /v1/graphql，无管理 MCP endpoint。 认证、operations 和 恢复 描述同一服务端能力。接口 schema 来自构建输入，避免根据 UI 猜测 wire 字段。