技能介绍

要解决的问题

在医药 GEO 场景中，患者自然语义洞察是一项受保护能力。直接调用会面临两个前置障碍：运行环境不确定，以及云端授权未完成时无法获取受保护的业务指令。如果没有统一的入口来处理环境检测和鉴权流程，开发者很容易在"Python 没装""凭证过期""绑定没走完"这类问题上反复踩坑，甚至更糟——在鉴权未通过的情况下擅自产出业务结果。

工作原理

该技能的核心是一个两阶段门禁机制，确保任何业务推理都只在授权完全通过后才执行。

第一阶段：Python 环境检测

在任何业务脚本执行前，技能会静默检测 Python 环境。检测到可用命令且版本满足要求时直接执行，只有在真正失败时才向用户报告。Windows 平台下，python 命令可能误触 Microsoft Store 别名，技能提供了替代方案：使用 py -3 启动器或关闭应用执行别名。如果用户主动提供了 Python 全路径，技能会优先使用该路径绕过检测盲区。

第二阶段：授权与受保护内容拉取

授权逻辑完全封装在 scripts/auth.py 中，涵盖本地凭证缓存、WorkBuddy 用户绑定、平台授权校验和错误信号输出。技能明确区分了"可自动修复"和"真正失败"两种情况：AUTH_REQUIRED 和 CREDENTIALS_MISSING 属于首次使用的正常流程，技能会自动调用 connect_cloud_service 获取 JWT 并完成绑定；只有绑定后重新校验仍失败，才会向用户输出明确的中文报告，停止业务推理。

授权通过后，技能通过 scripts/protected.py 拉取云端受保护的业务指令，并严格按返回内容执行。未拿到 protected instructions 时，技能必须停止，不得凭本地提示或历史上下文继续生成。

适用边界与注意点

鉴权门禁与业务输出互斥：鉴权未通过时禁止产出任何业务结果，不存在"先给结果再补鉴权"的路径。
重试上限为 1 次：两次失败说明是服务端问题，应停止重试并告知用户数据服务暂时不可用。
密钥安全：不要向用户展示或提及 AppKey / AppSecret 的明文内容，也不要手动解析 JWT 或拼接密钥。
slug 机制：授权脚本优先读取包内 _meta.json 的 slug 作为服务端技能编号（如 BT_D5CCF22D），只有包内缺少该文件时才需要手动传参。
信号观察：auth.py 仅输出 5 种 stdout 信号，业务错误细节在 stderr 中给出，需同时观察两者才能正确定位问题。