30 lines
2.5 KiB
Markdown
30 lines
2.5 KiB
Markdown
# 网页调用 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，重启或重置后下载登记失效，请及时下载。工具审批与来源留档不能替代人工核对模型分析。
|