2.5 KiB
网页调用 Drama Minis
使用
打开本机 http://127.0.0.1:5173/，在 Skills 中找到 drama-minis-diagnosis，点击「使用此 Skill」。页面返回 Chat 并填入任务草稿，点击发送即可读取原始 Skill。
模型会确认分析日期、对比日期和账户范围。确认后，每次真实指标查询会弹出审批，检查日期与账户参数后点击「批准本次查询」。数据会由当前配置的模型处理。报告生成有独立审批，成功后工具卡提供 JSON、HTML 和 PDF 下载；PDF 失败不会显示虚假的 PDF 链接。
ads-analysis 和「填入演示任务」仍使用模拟数据，不是这条真实业务链路。
服务配置
SWADS_MCP_TOKEN：后端环境中的凭证，不写前端、源码或 Git。DRAMA_MINIS_SKILL_DIR：默认用户目录.codex/skills/drama-minis-diagnosis。PYTHON_EXECUTABLE：默认 python3。CHROME_EXECUTABLE：macOS 默认 Google Chrome；用于本地 A4 PDF。- 模型配置沿用网页 Settings 或服务器环境。
本机另有 scripts/start-private-server.mjs，在构建后通过关闭回显的交互终端读取一行包含 swadsToken 与 llmKey 的 JSON，启动指定的 Qwen 网关后端。不要把凭证放在命令行参数或文件中；退出后恢复终端回显。凭证只在进程内，服务退出后需重新注入，脚本不是持久化密钥管理器。
验证与限制
2026-09-09 已通过真实网页验证：Qwen 成功读取 SKILL.md、metrics.md、reporting-playbook.md，成功调用 swads_whoami 与 metrics_catalog，随后询问周期和账户范围。未调用 metrics_semantic_query，未制作真实经营报告。
验证结果：137 条自动化测试通过（包含新增窄屏 Skill→Chat 切换测试）；typecheck、lint、build 通过。原始 Python 渲染器的合成测试生成了 1 页中文 A4 PDF（594.96 × 841.92 pt），完成图像检查；不是经营数据证据。构建仍有约 599 kB 主包的非阻塞体积提示。
默认测试覆盖 MCP 白名单、脱敏与错误、资源快照、审批、报告来源 ID、下载边界和前端下载卡。node scripts/verify-minis-render.mjs 是可选的离线渲染验证，使用人工合成数据调用原始 Skill Python 渲染器与本地 Chrome，不查询经营数据，不是经营报告。
当前原始渲染器仅支持 USD 图表；非 USD 报告明确拒绝。报告与查询记录属于内存 Session，重启或重置后下载登记失效，请及时下载。工具审批与来源留档不能替代人工核对模型分析。