API 认证

GraphQL PAT

HTTPS POST /v1/graphql，Content-Type 为 application/json，Authorization 为 Bearer PAT。 请求体为 query、variables 和可选 operationName；有效 token 不能写入 URL 或日志。 公开目录和下载使用 S3/CDN binding，不发送 token、cookie 或管理 header。

当前权限

能力	范围与当前角色
私有读取 / tokens / receipts	plugins:read，并检查资源或回执权限
创建 / metadata / listing / ownership / lifecycle	plugins:write，并检查 ownership；特殊流程由契约控制
upload / submit_release	releases:write，并检查 ownership
review_change	reviews:write，管理员
set_visibility	plugins:write，管理员
用户角色 / suspend / policy	admin:write，管理员
publication_status	plugins:read，当前owner/admin；跨actor仅管理员
recover_publication	admin:write，当前管理员；原publication、CAS与幂等

scope 不扩权；转让、撤销、到期、suspend 都在提交和重放处重新检查。 不允许移除最后一个活动管理员；账号删除不重新开放首次管理员 bootstrap。

服务内部边界

BFF service key 不代表用户权限；worker lease/fence 只负责被领取工作。 不要将内部服务凭据提供给浏览器、插件或 Agent。