# 非交互认证与恢复

## 凭据输入

```sh
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。
[认证](../api/authentication.md)、[operations](../api/reference.md) 和 [恢复](../api/errors.md)
描述同一服务端能力。接口 schema 来自构建输入，避免根据 UI 猜测 wire 字段。