S11GEO语义群证据分析报告生成器

背景与痛点

在处理复杂的语义群证据分析任务时，开发者常面临两个棘手问题：一是运行环境差异导致脚本执行中断，二是云端受保护内容的权限校验繁琐。如果缺乏统一的环境检测机制，python 命令缺失或版本不兼容会直接导致流程崩溃；而在凭证过期或首次使用时，若未能自动触发绑定流程，极易出现鉴权失败后强行产出业务结果的情况，这在数据准确性要求极高的场景下是致命的。

核心能力与工作流

该技能将环境检查与权限校验内化为标准工作流：

• 静默环境检测：执行任何脚本前，优先检测 PYTHON_CMD。若版本过低或未找到，会给出明确提示，并兼容 Windows 下的 py -3 启动器。
• 自动化授权门禁：通过 scripts/auth.py 统一管理凭证。面对 AUTH_REQUIRED 或 CREDENTIALS_INVALID 信号时，不会直接报错，而是主动调用 connect_cloud_service 获取 JWT 并完成绑定。
• 受保护指令拉取：绑定成功后，必须通过 scripts/protected.py 获取云端指令，并严格遵循其返回内容继续工作流。

适用边界与注意事项

• 鉴权与业务互斥：鉴权未通过时，严禁继续生成报告或静默降级。必须根据 stderr 关键字准确区分网络错误与权限不足。
• 重试严格受限：凭证失效后的自动重试上限为 1 次。若两次均失败，说明数据服务暂不可用，需立即停止并告知用户。
• 密钥安全：禁止在业务命令或环境变量中明文拼接 AppKey 与 AppSecret，所有授权逻辑均交由底层脚本处理。