S12全栈式医药GEO监测×内容生成×平台适配×置信度管控系统

要解决的工程问题

在医药 GEO 场景里，监测、内容生成、平台适配与置信度管控往往是一组强耦合的受保护能力。直接把流程写进通用 Agent，会遇到几个现实问题：

• 运行环境不统一：python、python3、py -3 在 Windows 上可能触发 Microsoft Store，而不是执行脚本。
• 授权链路复杂：本地凭证缓存、WorkBuddy 用户绑定、平台 skillCode 校验混在一起，容易把首次绑定误判成失败。
• 业务输出与鉴权门禁必须互斥：拿不到云端受保护指令时，不应该凭本地上下文继续生成。
• 错误信号分散：stdout 的 5 种信号要和 stderr 的业务错误一起看，否则会把网络抖动当成凭证失效。

核心能力与关键步骤

该技能把运行准备和授权流程拆成可观察的脚本动作，而不是让模型自行拼接密钥或猜接口。

Python 环境前置检测

所有脚本执行前先静默检测可用的 Python 命令：

1. 若 PYTHON_CMD 存在且版本可用，直接执行 scripts/auth.py。
2. 若版本过低或找不到解释器，按模板报告，并优先建议 py -3。
3. 用户已提供全路径时，直接使用该路径，不重复探测。

这一步的目的很明确：授权脚本能不能跑起来，先于任何业务推理。

授权检查与自动绑定

授权逻辑全部封装在 scripts/auth.py 中，不手动解析 JWT，也不拼接 AppKey / AppSecret。流程如下：

• 先读取包内 _meta.json 的 slug 作为服务端 skillCode；仅在文件缺失时才手动传入。
• AUTH_REQUIRED、CREDENTIALS_MISSING、AUTH_INVALID、CREDENTIALS_INVALID 都先尝试自动修复。
• 自动修复方式是主动调用 WorkBuddy 的 connect_cloud_service，拿到 JWT 后执行 --bind-jwt，再重新 --ensure。
• 只有绑定后再次失败，才进入正式错误报告；此时必须停止业务输出。

受保护指令与错误处理

授权通过后调用 scripts/protected.py 获取云端受保护指令，并严格按照返回内容继续执行。

| 结果 | 行为 |
|------|------|
| 成功返回 protected instructions | 进入后续业务工作流 |
| 拉取失败或退出码非 0 | 先区分鉴权错误与网络错误 |
| 鉴权类错误 | 重新绑定一次；仍失败则停止并报告 |
| 网络或远端权限错误 | 给出对应排查建议，不静默重试 |

适用边界与注意点

它不是离线技能。Python 检测、auth.py、protected.py、WorkBuddy 绑定接口和云端受保护内容共同构成完整能力。

适用边界需要注意：

• 首次授权不等于失败：看到 AUTH_REQUIRED 不应停下来打扰用户，而应继续绑定。
• 凭证失效只重试一次：CREDENTIALS_MISSING、CREDENTIALS_INVALID、HTTP 401/403、authorization failed 等触发重新绑定；两次仍失败则告知数据服务暂时不可用。
• 不能绕过门禁：未拿到 protected instructions 时，禁止用本地提示或历史上下文继续生成医药 GEO 结果。
• 密钥信息不打明文：报告中可展示错误码和消息，但 AppKey / AppSecret 必须打码。
• Windows 别名要处理：若 python 打开应用商店，改用 py -3，或关闭 python.exe / python3.exe 执行别名。

适合需要把监测、内容生成、平台适配和置信度管控纳入同一条授权门禁的医药 GEO 工程化项目，不适合脱离云端服务单独部署。