百通经典患者流模型

要解决的具体问题

在调用受保护的云端技能时，最常见的失败不是代码报错，而是环境未就绪或凭证失效。如果缺少前置校验，Agent 可能在未授权的情况下继续生成业务结果，造成静默降级或数据泄露。

核心能力与关键步骤

1. Python 环境检测

执行任何脚本前，先静默检测 Python 命令：

• 若 PYTHON_CMD 有值且版本可用，直接执行后续脚本
• 若版本过低或命令为空，输出明确的环境报告
• 若用户已手动安装但检测不到，支持用户提供全路径

Windows 下优先使用 py -3 启动器，避免 python 命令打开 Microsoft Store。

2. 授权检查与绑定流程

授权逻辑由 scripts/auth.py 统一处理，不要手动解析 JWT 或拼接密钥。

• 首次运行返回 AUTH_REQUIRED 或 CREDENTIALS_MISSING 时，不要停止，而是主动调用 connect_cloud_service 获取 JWT
• 绑定成功后自动重新检查，直到拿到 AUTH_OK
• 只有绑定后仍失败，才向用户报告错误

3. 受保护内容的获取

授权通过后，调用 scripts/protected.py 拉取云端指令。只有拿到 protected instructions 才能继续执行；未拿到时必须停止。

适用边界与注意点

• 鉴权失败与业务输出是互斥关系，绝不允许带病执行
• 网络错误与权限错误需区分处理，给出不同建议
• 最多重试一次，失败后应告知用户服务不可用