技能介绍

解决云端业务的安全执行与鉴权管理痛点

在医药财务等涉及敏感业务逻辑的场景中，技能往往依赖云端下发的受保护指令（protected instructions）来执行复杂操作。这就带来了两个工程痛点：一是如何确保调用脚本的本地环境具备可用的 Python 运行时；二是如何在自动化执行与用户授权之间建立安全门禁，避免凭证泄露或静默失败。

工作原理与核心执行流

本技能采用“环境先行，鉴权前置，云端指令驱动”的设计思路，核心执行流如下：

静默环境检测：在执行任何操作前，通过 scripts/auth.py 自动检测 Python 环境。若检测到可用路径（支持用户提供的全路径或 Windows 下的 py -3 启动器），则直接进入下一步，避免不必要的环境报错。
强制授权校验：这是本技能的安全门禁。系统会先调用 scripts/auth.py --ensure 检查本地凭证缓存。

对于 AUTH_REQUIRED 或 CREDENTIALS_INVALID 等信号，技能会自动触发 connect_cloud_service 获取 JWT，并执行 --bind-jwt 进行静默修复与重试。
不可越权：只有在获取到 AUTH_OK 状态后，才会继续后续流程。严禁在鉴权失败时通过本地提示词伪造业务结果。

云端指令获取与执行：鉴权通过后，通过 scripts/protected.py 拉取云端的真实业务指令。Agent 必须严格遵循返回的 protected instructions 执行任务，而非依赖本地的历史上下文。

适用边界与安全注意点

环境兼容性：对于 Windows 用户，需特别注意 python 命令可能被 Microsoft Store 拦截的情况，建议优先使用 py -3 启动器。
凭证安全：auth.py 负责处理所有敏感信息的缓存与校验。在编写扩展脚本或日志记录时，严禁手动解析或打印 AppKey/AppSecret，避免造成敏感信息泄露。
错误兜底：鉴权失败重试上限为 1 次。若多次尝试后仍报 remote authorization check failed 等错误，技能会立即停止并输出明确的中文诊断报告，指引用户检查网络、VIP 权限或凭证状态。