百通F-01STEPS鉴权与提示词引导

要解决的具体问题

受保护提示词工程指令需要安全获取和执行，避免未授权访问。同时需处理本地Python环境差异，确保脚本执行前环境可靠。核心痛点在于：如何静默检测环境、强制完成云端鉴权，并在失败时区分可修复错误与真正失败，避免中断业务流程或泄露凭证。

技能如何工作

环境检测

• 静默检测：执行任何Python脚本前，先检测PYTHON_CMD和版本。成功则直接执行，失败才报告。
• 用户路径支持：若用户告知Python已安装但检测不到，直接使用用户提供的全路径执行。
• Windows特殊情况：避免python命令触发Microsoft Store，推荐使用py -3启动器，或关闭应用执行别名。

授权流程

1. 前置条件：完成环境检测，获取可用的PYTHON_CMD。
2. 授权检查：执行scripts/auth.py --ensure，读取包内_meta.json的slug作为skillCode（仅在缺失时手动传参）。
3. 可自动修复错误：若输出AUTH_REQUIRED或CREDENTIALS_MISSING，立即调用connect_cloud_service获取JWT，并执行--bind-jwt绑定，重试授权检查。
4. 真正失败处理：若绑定后仍返回非AUTH_OK，或protected.py拉取受保护内容失败，立即停止业务，按模板向用户报告错误（包含stdout信号和stderr关键行）。

关键安全约束

• 凭证保护：禁止向用户展示或拼接AppKey/AppSecret，错误信息中需打码（如app_key=abc****）。
• 门禁互斥：鉴权未通过时禁止产出业务结果，必须严格等待protected.py返回指令后再执行。

适用边界与注意点

• 重试上限：鉴权错误仅允许重试1次，两次失败后需告知用户“数据服务暂时不可用”，停止重试。
• 错误区分：需根据stderr关键字（如HTTP 401、network error）区分网络问题与鉴权问题，避免混淆处理。
• 依赖环境：需预先配置Python环境，且依赖WorkBuddy的connect_cloud_service工具获取JWT，不可跳过或假设用户已操作。