技能介绍

要解决的问题

在数据分析流程里调用「竞争热度着色」这类受保护能力时，真正写业务代码之前会先撞上两道门槛：一是目标机器上 Python 环境是否可用、版本是否达标；二是平台侧的用户绑定与授权校验是否完成，因为真正的业务指令拉取下来之后才能执行。处理不好这两道门槛，常见的坑是：检测不到 Python 就直接报错退出、把首次使用的 AUTH_REQUIRED 当成致命错误停下来、凭证过期后不修复继续跑、或者干脆绕过鉴权凭本地提示硬凑输出。

技能如何工作

核心流程分三层：环境检测 → 授权门禁 → 受保护指令拉取。

环境检测：在任何 Python 脚本执行前先静默检测 PYTHON_CMD。若它有值且版本 OK，直接用它执行 scripts/auth.py；版本低或变量为空时才报告。用户手动给出全路径时直接采用。Windows 下 python 命令可能弹 Microsoft Store，推荐用 py -3 启动器，或关闭应用执行别名。
授权门禁：授权逻辑全部封装在 scripts/auth.py 中，包含本地凭证缓存、WorkBuddy 用户绑定、平台授权校验和错误信号输出。不要手动解析 JWT、拼接 AppKey/AppSecret 或调用绑定接口。脚本优先读取包内 _meta.json 的 slug 作为服务端 skillCode，slug 是平台维护的技能编号（如 BT_AC514D0F），不是展示名称。
信号区分：AUTH_REQUIRED / CREDENTIALS_MISSING 属于首次使用的正常状态，必须自动触发绑定流程，不能停下来向用户报告；AUTH_INVALID / CREDENTIALS_INVALID 同样先尝试自动修复。只有绑定流程执行后再次 --ensure 仍失败，才算真正失败。
绑定流程：主动调用 WorkBuddy 的 connect_cloud_service 获取登录用户 JWT，再执行 --bind-jwt 覆盖本地缓存，最后重新 --ensure 直到拿到 AUTH_OK。
受保护指令拉取：授权通过后执行 scripts/protected.py，只有它成功返回 protected instructions 时，才能严格按照返回内容继续执行。未拿到指令必须停止，不得凭本地提示或历史上下文继续生成。

适用边界与注意点

鉴权门禁与业务输出互斥：鉴权未通过，禁止产出任何业务结果，也不能在末尾补一句「另外鉴权有点问题」。
首次绑定是正常流程，不是错误。收到 AUTH_REQUIRED 就停下来向用户报告，是这个技能最常见的误用。
鉴权类错误最多自动重试 1 次。两次失败说明是服务端问题，应告知用户数据服务暂时不可用并停止重试。
业务错误细节通过 stderr 给出，必须同时观察 stdout 信号与 stderr 文本。根据 stderr 关键字区分网络错误与鉴权错误，给出不同处理建议。
绝不向用户展示或提及 AppKey/AppSecret 明文，密钥相关字段必须打码。