cms-auth-skills
版本: v2.3.4
定位
- - 本 Skill 只负责鉴权值解析，输出
appKey 或 INLINECODE1 - 术语统一： INLINECODE2
- 任何业务接口需要鉴权 Header，都必须先触发本 Skill
AI 执行总规则
- 1. 先判断目标接口需要
appKey 还是 INLINECODE4 - 再按固定优先级解析，不要跳步骤
- 解析失败时，只向用户索要 INLINECODE5
- INLINECODE6 解析与
access-token 解析是两个独立步骤：只需要 appKey 时，不要主动换 INLINECODE9 - 统一通过
scripts/auth/login.py 执行，不需要读取或分析 scripts/auth/*.py 源码
支持能力（5 条）
- 1. 支持从上下文/显式参数直接获取
appKey、 INLINECODE13 - 支持从环境变量获取（并做判空）：
XG_BIZ_API_KEY、 INLINECODE15 - 支持通过
appKey 获取 INLINECODE17 - 支持通过
sender_id + account_id 获取 INLINECODE19 - 支持在自动解析失败时向用户索要 INLINECODE20
解析优先级（必须按顺序）
目标是 appKey
- 1. 上下文/显式 INLINECODE22
- 环境变量 INLINECODE23
- INLINECODE24
- 向用户索要 INLINECODE25
目标是 access-token
- 1. 上下文/显式 INLINECODE27
- 上下文/显式
appKey -> 换 INLINECODE29 - 环境变量 INLINECODE30
- 环境变量
XG_BIZ_API_KEY -> 换 INLINECODE32 - INLINECODE33 ->
appKey -> INLINECODE35 - 向用户索要 INLINECODE36
上下文字段兼容
- -
appKey：appKey / app_key / INLINECODE40 - INLINECODE41 ：
access-token / access_token / INLINECODE44 - INLINECODE45 ：
sender_id / senderId / send_id / INLINECODE49 - INLINECODE50 ：
account_id / INLINECODE52
CLI
推荐参数：
- - INLINECODE53
- INLINECODE54
- INLINECODE55
- INLINECODE56
- INLINECODE57
- INLINECODE58
- INLINECODE59
兼容旧调用：
常用示例
CODEBLOCK0
cms-auth-skills
版本: v2.3.4
定位
- - 本 Skill 只负责鉴权值解析，输出 appKey 或 access-token
- 术语统一：appKey = 工作协同 key = cowork key
- 任何业务接口需要鉴权 Header，都必须先触发本 Skill
AI 执行总规则
- 1. 先判断目标接口需要 appKey 还是 access-token
- 再按固定优先级解析，不要跳步骤
- 解析失败时，只向用户索要 appKey
- appKey 解析与 access-token 解析是两个独立步骤：只需要 appKey 时，不要主动换 access-token
- 统一通过 scripts/auth/login.py 执行，不需要读取或分析 scripts/auth/*.py 源码
支持能力（5 条）
- 1. 支持从上下文/显式参数直接获取 appKey、access-token
- 支持从环境变量获取（并做判空）：XGBIZAPIKEY、XGUSERTOKEN
- 支持通过 appKey 获取 access-token
- 支持通过 senderid + account_id 获取 appKey
- 支持在自动解析失败时向用户索要 appKey
解析优先级（必须按顺序）
目标是 appKey
- 1. 上下文/显式 appKey
- 环境变量 XGBIZAPIKEY
- senderid + account_id
- 向用户索要 appKey
目标是 access-token
- 1. 上下文/显式 access-token
- 上下文/显式 appKey -> 换 access-token
- 环境变量 XGUSERTOKEN
- 环境变量 XGBIZAPIKEY -> 换 access-token
- senderid + account_id -> appKey -> access-token
- 向用户索要 appKey
上下文字段兼容
- - appKey：appKey / appkey / appkey
- access-token：access-token / accesstoken / token
- senderid：senderid / senderId / sendid / sendId
- accountid：account_id / accountId
CLI
推荐参数：
- - --app-key
- --access-token
- --sender-id
- --account-id
- --resolve-app-key
- --ensure
- --update
兼容旧调用：
常用示例
bash
直接返回 token
python3 login.py --ensure --access-token your-token
用 appKey 换 token
python3 login.py --ensure --app-key your-app-key
只解析 appKey
python3 login.py --resolve-app-key --sender-id user-001 --account-id xgjk_prod
兼容旧调用
python3 login.py --ensure --context-json {appKey:your-app-key}
