技能介绍

解决什么问题

区域品牌计划（RBP）是面向 RPM 场景的受保护技能：真正的业务指令不随包分发，而是存放在云端，只有通过平台鉴权后才返回。这带来两个工程问题：一是调用前必须先确认本地 Python 环境可用；二是凭证可能缺失、过期或失效，Agent 需要在不打断用户的前提下完成绑定与续期，同时在真正失败时给出准确反馈，而不是静默降级、反复重试或硬凑结果。

技能如何工作

环境检测优先：执行任何脚本前先静默检测 PYTHON_CMD。检测到可用命令就直接执行，不打扰用户；只有版本过低或找不到时才报告。用户明确提供了全路径时，直接采用该路径执行。
授权门禁：每次使用前必须通过 scripts/auth.py 完成授权检查。凭证缓存在本地，由 auth.py 统一处理 WorkBuddy 用户绑定与平台校验，不要手动解析 JWT、拼接 AppKey/AppSecret 或自行调用绑定接口。
信号分级：AUTH_REQUIRED 和 CREDENTIALS_MISSING 属于首次使用的可自动修复信号，Agent 必须自动继续执行 connect_cloud_service 绑定流程，而不是停下向用户报告；AUTH_INVALID / CREDENTIALS_INVALID 则尝试用新凭证覆盖旧缓存。绑定后重新 --ensure 仍失败才算真正失败。
业务解锁：只有 scripts/protected.py 成功返回 protected instructions 后，才按返回内容继续执行；拿不到就必须停止，不得凭本地提示或历史上下文继续生成。

适用边界与注意点

鉴权门禁与业务输出是互斥关系：鉴权未通过时严禁继续产出业务结果，报告需同时转述 stdout 信号与 stderr 关键行，不能只给模糊提示。
网络错误（network error、非 JSON 响应）与鉴权失败（HTTP 401、authorization failed）要区分处理：前者建议检查服务可达性，后者按凭证问题走重绑流程。
鉴权类错误最多重试一次，连续两次失败应告知用户数据服务暂不可用并停止重试。
Windows 上 python 命令可能打开 Microsoft Store，推荐使用 py -3 启动器。
AppKey / AppSecret 不得在命令、环境变量或回复中明文出现，错误信息里的密钥字段必须打码。