promptfigure 0.2.0 → 0.3.1

package/skill/promptfigure-api/references/setup-guide.md

@@ -0,0 +1,151 @@
+# 拿到 promptFigure API key
+
+全程站点：https://promptfigure.top
+注册 **不需要邮箱验证码**，邮箱 + 密码（≥8 位）即可。
+
+**主路径：网页**。`/api/login`、`/api/keys` 等内部接口**面向已登录会话**，curl 注册可用但绕过了 UI（且会受 WAF UA 拦截），建议人肉注册、AI 只接管「登录后拿 key」这一步。
+
+---
+
+## 路径 A：网页人肉（小白 / 默认推荐）
+
+最稳。UI 自带 401/校验/防风控。
+
+1. 打开 https://promptfigure.top
+2. 右上角点 **注册**（或 登录）。填邮箱 + 密码（≥8 位），提交即完成，**无需验证邮件**
+3. 打开 https://promptfigure.top/console#account-balance 充值（$1 起、必须整数，上限 $10000；每满 $50 赠 $1 进余额——按 `floor(金额/50)` 计算，**零头不累计**：$99 只赠 $1，$100 赠 $2）
+4. 打开 https://promptfigure.top/console#account-keys → 点创建 → **复制明文 key（`pf_` 开头），立刻存好**
+5. 把 key 交给调用方环境变量：
+
+```bash
+export PROMPTFIGURE_KEY=pf_xxxxxxxx
+```
+
+⚠️ key 是 **会话内一次性明文**，弹窗关闭后只能看到 hint。库内只存 SHA-256 哈希 + hint。
+⚠️ SPA 必须带 hash 直达标签页：`#account-keys` / `#account-balance` 缺一不可，否则落总览页。
+
+---
+
+## 路径 B：浏览器自动化（有桌面/浏览器控制能力的 Agent）
+
+⚠️ **仅当路径 A 因浏览器限制不可用时用**。注册走 UI 风险大于收益，下面这版只接管「登录 + 拿 key」。
+
+注册（请用户自己点一次 UI）：
+- 邮箱 + 密码注册一次拿 `pf_` key 即可
+- 注册后只登录会话：弹窗顶部是**分段控件（segmented-control），「登录」「注册」两个 tab 按钮并排**——点「登录」按钮切到 login tab → 填 email/password → 提交。**没有「已有账号？」这类链接文案**，自动化时按 segmented-control 内的按钮文本（登录 / Login）定位
+
+登录后的 DOM 选择器（实测有效）：
+
+| 元素 | 选择器 |
+|---|---|
+| 邮箱输入 | `#lite-email` |
+| 密码输入 | `#lite-password` |
+| 登录/注册弹窗关闭 | `.modal-close` |
+| 提交按钮 | `.primary-action` |
+| API 密钥标签页 | 访问 `/console#account-keys` |
+| 余额标签页 | 访问 `/console#account-balance` |
+| 调试台 key 输入框 | `#pf-play-key` |
+| 调试台 prompt 输入框 | `#pf-play-prompt` |
+
+要点：
+- 登录入口是**右上角弹窗**，不是独立登录页——需先点触发再操作表单
+- 弹窗分 登录 / 注册 两个 tab，注册按钮在同一弹窗内切换（`mode` 状态）
+- SPA 路由走 `history.pushState`，自动化时应直接导航完整 URL（含 hash），不要依赖点击导航
+- 创建 key 后明文弹窗通常带「复制」按钮，优先点复制；若需读取文本，直接读弹窗 DOM 文本而不用 OCR
+- 浏览器 fetch 不会被 CF WAF 拦截（只有默认 UA 才拦）
+
+---
+
+## 路径 C：纯 curl（无 UI 场景 / 自建脚本）
+
+⚠️ 注册/登录/建 key 都是内部 REST 接口，**没文档承诺稳定**——产品主路径是网页。这条路径出问题时，请优先回退到路径 A。
+
+### 客户端 UA（必经）
+
+CF WAF 会拦 `Python-urllib/*`（实测 403 error code:1010）。其它都过。**curl 默认 UA 不在拦截名单里，可以直接用**；Python `requests` 默认 UA 也能过；只有 `urllib.request` 需要手动改 UA：
+
+```python
+import urllib.request
+req = urllib.request.Request(url, ...)
+req.add_header("User-Agent", "Mozilla/5.0")  # 绕过 CF WAF 拦截
+```
+
+### 1. 注册（可选，有账号则跳到 2）
+
+```bash
+curl -s -X POST https://promptfigure.top/api/register \
+  -H "Content-Type: application/json" \
+  -d '{"email":"you@example.com","password":"至少8位"}'
+```
+
+成功返回 `201` + `{ token, userId, email, balance: 0, ... }`。
+`409 email_taken` → 跳步骤 2 直接登录。
+
+### 2. 登录
+
+```bash
+curl -s -X POST https://promptfigure.top/api/login \
+  -H "Content-Type: application/json" \
+  -d '{"email":"you@example.com","password":"你的密码"}'
+```
+
+返回 `{ token, userId, email, balance, credits, ... }`，token 是 session token（30 天有效）。
+
+### 3. 创建 API key
+
+```bash
+export PF_TOKEN=<上一步的 token>
+curl -s -X POST https://promptfigure.top/api/keys \
+  -H "Authorization: Bearer $PF_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"name":"my-agent"}'
+```
+
+返回 `{ id, key:"pf_...", hint, name, createdAt }`。立刻存：
+
+```bash
+export PROMPTFIGURE_KEY=pf_xxxxxxxxxxxxxxxx
+```
+
+⚠️ **明文只在此响应中出现一次**，库里只存 SHA-256 哈希 + hint。丢了无法找回，只能吊销重建。
+
+### 4. 充值（必须步骤）
+
+API 计费**只从余额扣**，与会员额度完全独立。新注册余额为 0，不充值调用会 `402`。
+充值走网页：https://promptfigure.top/console#account-balance（$1 起，整数）。
+**付款动作不应由 Agent 代劳**，留给用户人肉操作。
+
+### 5. 验证
+
+```bash
+curl -s -X POST https://promptfigure.top/api/v1/generate \
+  -H "Authorization: Bearer $PROMPTFIGURE_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"prompt":"Simple two-group bar chart comparing method A and method B","model":"standard"}' \
+  | jq '{size, ratio, model, crafted, charged, balance}'
+```
+
+看到 `crafted: true` + `charged: 0.02` + `balance` 减少 → 打通（默认管线实测约 40–90 秒；若 502 看 `references/troubleshooting.md`）。
+
+---
+
+## key 管理
+
+```bash
+# 列表（不含明文，只有 hint）
+curl -s https://promptfigure.top/api/keys -H "Authorization: Bearer $PF_TOKEN"
+# 吊销
+curl -s -X POST https://promptfigure.top/api/keys/revoke \
+  -H "Authorization: Bearer $PF_TOKEN" \
+  -H "Content-Type: application/json" -d '{"id":"<key id>"}'
+```
+
+每人最多 10 把未吊销 key。
+
+---
+
+## 安全提示
+
+- key 不进代码仓库、不进 commit。放环境变量或 secrets store
+- 怀疑泄露先吊销再重建，成本为零
+- 一次性不要创建过多 key；按用途命名（如 `paper-agent`、`lab-batch`）便于追溯

package/skill/promptfigure-api/references/troubleshooting.md

@@ -0,0 +1,204 @@
+# 常见问题与排障
+
+## 错误码速查
+
+| 码 | error 值 | 原因 | 处置 |
+|---|---|---|---|
+| 400 | `prompt_required` / `prompt_too_long` | prompt 空或 >8000 字符 | 检查请求体 |
+| 401 | `invalid_api_key` | key 无效/已吊销/漏了 `Bearer ` 前缀 | 检查 header；无效则重建 key |
+| 402 | `insufficient_balance` | 余额不足 | 控制台充值（$1 起，整数） |
+| 403 | `error code: 1010` | **CF WAF 拦了客户端 UA**（仅 `Python-urllib/*` 默认 UA） | 切 Node / Go / Python `requests` / 浏览器；或给 urllib 加 `User-Agent: Mozilla/5.0` |
+| 429 | `rate_limited` | 超 RPM | 已退款，串行 + 退避重试（1s → 2s → 4s） |
+| 502 | `generation_failed` | 生图通道异常 | **已自动退款**，看 `detail` 后重试；最常见是 `orchestration_failed: empty or truncated polish output` |
+| 405 | `method_not_allowed` | 用了 GET | 必须 POST |
+
+> 注意 RPM 限制是**账号级**，与网页端工作台共享同一个分钟窗口。网页上刚连续出过图，API 立刻报 429 属正常。
+
+---
+
+## 🔧 502 `orchestration_failed: empty or truncated polish output`
+
+**上游 Agnes 文本模型间歇性限频**。限频期间默认管线可能 502（约 35 秒后返回），`refunded` 标明退还金额，无需补款。服务端已内置回落：主模型 agnes-2.5-flash 撞 429 时会自动用 agnes-2.0-flash 整体重试一次；两层都撞上才会 502。
+
+⚠️ 重要：**这是上游运维状态，不是产品形态。** `/api/v1/generate` 的设计就是默认走完整润色管线，与网页同款。不要把 `polish:false` 当常态。
+
+### 真实根因（2026-09-09 实证，已修订）
+
+上游返回 **`429 "Too many requests. Please try again in a moment."`**——**与本方用量完全无关**（实测窗口内仅 7 次调用 / 配额 7500，依然 429；数小时后自行恢复）。重要线索：同 key 同模型从本机直连不限流、只有站点出口被限 → **疑似 Agnes 按出口 IP 频控**，换模型未必躲得开，等服务端回落+稍后重试是正解。
+
+**已修复的误导**：此前四种不同失败（配额耗尽/key 冷却/上游空响应/被上游拒绝）统一报成 `empty or truncated polish output`。**现在错误 detail 里带 `last_text_failure:` 字段**，直接给出上游真实状态码和响应片段——看到它就不用再猜。
+
+### 如何区分「平台故障」vs「我自己的问题」
+
+| 特征 | 平台限频（本次） | 自己的问题 |
+|---|---|---|
+| 错误 detail | 含 `upstream 429` | 含 `prompt`/参数类提示 |
+| 耗时 | 恒定 ~35s（重试耗尽） | 秒级返回 |
+| `polish:false` 同参数重试 | ✅ 能出图 | 也失败 |
+| 隔一段时间重试 | ✅ 自愈 | 仍失败 |
+
+### 处置
+
+**首选：等几分钟到几小时后原样重试**（限频会自行解除；2026-09-09 实测当天恢复，默认管线 42–90s 成功出图）。
+
+赶时间时的临时绕过：
+
+```json
+{ "prompt": "<完整英文提示词>", "polish": false, "model": "standard" }
+```
+
+⚠️ `polish:false` 时服务端**不润色不扩写**，prompt 原样进图模型——所以必须自己写完整英文提示词（写法见 `prompt-cookbook.md` 的「降级模式」）。
+
+### 何时回到正常
+
+无需操作——限频解除后默认管线自动恢复（响应里 `crafted: true`）。`polish:false` 仅作为绕过手段保留。
+
+---
+
+## 🔴 CF WAF 403 `error code: 1010`
+
+实测拦截列表（2026-09-09）：
+
+| 客户端 | UA | 结果 |
+|---|---|---|
+| curl | `curl/7.x` | ✅ 200 |
+| Node fetch | `node` | ✅ 200 |
+| Python `requests` | `python-requests/2.x` | ✅ 200 |
+| Go `net/http` | `Go-http-client/1.1` | ✅ 200 |
+| 浏览器 fetch | `Mozilla/5.0 ...` | ✅ 200 |
+| Python `urllib.request` | **`Python-urllib/3.x`** | ❌ 403 |
+
+**修法**：
+- Python `urllib`：手动加 `User-Agent: Mozilla/5.0`
+- 或换 `requests` / `httpx` / Node / Go
+
+---
+
+## 🔴 `balance` 字段滞后
+
+`/api/login` 和 `/api/me` 返回的 `balance` **不等于真实余额**（实测：`me` 返回 0，扣费 0.02 后真实余额 0.09，扣费仍成功）。
+
+可能解释：这两接口里 `balance` 字段没同步 D1，或来自一个非权威缓存层。
+
+**操作规则**：
+- 不要因为 `balance` 看起来够而**预先估算**余额
+- 看到 `402` 不要立即判定没钱，先看 D1 控制台 https://promptfigure.top/console#account-balance
+- 用户报告「明明有钱却被 402」时，先核对控制台余额（不是接口返回的）
+
+---
+
+## 注册 / key 相关
+
+**Q：注册要收邮箱验证码吗？**
+不用。邮箱 + 密码（≥8 位）提交即完成，session token 立即可用。
+
+**Q：key 明文丢了怎么办？**
+找不回来。库内只存 SHA-256 哈希。吊销旧的重建：
+`POST /api/keys/revoke {"id":"..."}` → `POST /api/keys {"name":"..."}`。
+
+**Q：余额和会员额度是一回事吗？**
+不是。API 只从**余额**扣，与订阅赠送的额度完全独立。有会员但余额为 0 → 调用仍会 402。反过来，只充值不订阅也能一直用 API（免费层 5 RPM）。
+
+**Q：能创建几把 key？**
+每人最多 10 把未吊销。按用途命名便于追溯。
+
+**Q：为什么会 401 但我明明没吊销？**
+先查 `Authorization` header —— 必须是 `Bearer pf_xxx`。写成 `Token pf_xxx` 或直接裸 key 都会 401。
+
+---
+
+## 参考图
+
+**Q：`refIgnored: true` 是什么意思？**
+参考图缺失/非法/拉取失败，**已被忽略，当次照常出图并计费**。按序排查：
+
+1. URL 是图片**直链**吗？（浏览器打开直接显示图片，不是含图的网页）
+2. 是 PNG 吗？（某些 .webp/.jpg 后缀但实际格式不符会失败）
+3. 超过 8MB 吗？
+4. 是私网/本地地址吗？（会被拒绝）
+5. 图床是否还在？（免费图床政策常变）
+
+**Q：参考图端点是不是有问题？**
+**是**。上游 `/images/edits` 自 2026-09-07 起持续 503。`refUrl`/`refDataUrl` 当前经常 `refIgnored: true`。
+**绕开方案**：暂时改用「纯文字精确描述」——把参考图的特征（方向/panel 数/图表类型/图标风格/数据标注密度/色分布）全部写进 prompt。修复后第一时间回写到本文件。
+
+**Q：有既稳定又省事的方案吗？**
+图在公网 → 用 `refUrl`（服务器代取，你不用下载也不用转 base64）。
+图在本地且较小 → 用 `refDataUrl`。
+图在本地且较大 → 先挂免费图床：
+`curl -F "file=@ref.png" https://x0.at`
+
+---
+
+## 出图质量
+
+**Q：图里的文字糊/有乱码英文？**
+polish:false 直出时图模型对英文文字标签渲染差（实测出 "Mcıuacy" 这种乱码）。
+**修法**：prompt 里**逐字写对**所有英文标签，加一句 "All on-figure text labels in English, spelled correctly"。重要场合用 `premium`（gpt-image 文字渲染显著优于 Agnes standard）。
+
+**Q：数值和我给的不一致？**
+polish:false 时图模型会忠实画你给的数值，但也可能把"上下文中相似数字"画错。关键数值在 prompt 里重复一次并显式绑定单位。⚠️ 没有真实数据就别写——补出来的数值会被当成事实印到图上。
+
+**Q：配色太单调，全是一个色系？**
+prompt 里写了单一色相约束（如 `"muted steel-blue fills"`）。改用语义化多色（详见 `prompt-cookbook.md` 的配色小节）。
+
+**Q：机制图被画成了 3D？**
+prompt 里加 `2D flat`, `white background`, `no gradients, no photorealism`。
+
+**Q：构图和我给的参考图差很远？**
+「参考风格」不拆特征是必返工的。拆到特征级——方向、panel 数、图表类型、图标风格、标注密度、色分布——逐条写进 prompt 正文。参考图只是补充（且当前参考图端点 503）。
+
+**Q：prompt 很长但出图反而更差？**
+超 400 词后信息超载。压到 150–300 词，只保留核心实体与结构。
+
+**Q：为什么图快/出图秒成但像样？**
+polish:false 直出时快（~11s）但少了编排层润色，**质量低于正常管线是预期**，不是异常。正常管线应看到 `crafted: true` 的更慢但更好的结果。
+
+---
+
+## 计费
+
+**Q：既然 premium 1K 和 2K 同价，为什么还要选 1K？**
+基本不用选，默认 2K。仅当需要快速迭代或尺寸受限时用 1K。
+
+**Q：失败会扣钱吗？**
+不会。502、429 都会自动原路退款（响应里看 `refunded`）。只有成功出图才真扣费。
+
+**Q：RPM 不够用怎么办？**
+提升订阅档（Lite 10 / Plus 15 / Pro 40 / Ultra 80 RPM）。短期也可以：错峰、把批量任务摊到不同分钟。
+
+---
+
+## 时效
+
+**Q：响应要多久？**
+polish:false 实测 ~11s（standard）/ 60–120s（premium 2K 偶尔更长）。**客户端 timeout ≥ 300s**。
+⚠️ 别设 30s/60s 就以为服务挂了——通常是你自己先断开了。
+
+**Q：网页工作台和 API 一样慢/卡吗？**
+管线正常时网页与 API 同速（都在服务端润色）。网页端**没有 `polish:false` 等价开关**——上游限频期网页会卡在 polishing，急用请走 API 路径 A。
+
+---
+
+## 仍然解决不了
+
+- 线上文档（权威，比本文件更新）：https://promptfigure.top/docs/zh-CN/faq
+- 在线调试台（隔离是代码问题还是账号问题）：https://promptfigure.top/docs/zh-CN/api-playground
+- 服务状态/更新：https://promptfigure.top/news
+
+---
+
+## premium 被内容审核误伤（502 `content moderation`，2026-09-10 CVPR 实测）
+
+现象：502 + `detail.error = premium channel rejected` + 上游报 "rejected by content moderation"，**自动退款**。
+
+关键实测结论（二分验证）：
+
+- 触发是**整段组合判断，不是单词命中**——把整段 prompt 里的词逐个/分组喂给极简探针全部通过，合在一起就被拒。密集的「检测/候选框/过滤/一致性」类 CV 术语组合（如 …Candidate Boxes + Consensus + Filtering + 本地化器… 同屏多个）容易触发
+- 单个可疑缩写也可能命中（实测 `WBF` 被拒，全称 Weighted Box Fusion 反而通过）——先用极简探针 + 可疑词单独测，拒=免费，通过=正常扣费，别拿整段 prompt 反复烧钱试
+
+处置顺序：
+
+1. 拒了就换措辞重试**最多 2 次**（每次拒绝免费）；去掉标题/缩写、把检测类词汇换成中性词（Estimator/Candidate）常能过
+2. 还不过 → **不要继续试探**：改走 standard 出图（Agnes 通道审核宽松，同样内容能过），拼写/小字问题用 PIL 本地修补（采样盒底色覆盖 + Arial 按原字号重写标签），成本为零且拼写百分百正确
+3. 台账里记 `moderation_blocked: true` 与被拒 prompt，便于服务端侧后续排查

package/skill/promptfigure-local/SKILL.md

@@ -375,6 +375,37 @@ pf craft --at "§3.2 ¶2" --figure-type pipeline \
 - **路径写法**：Git Bash 的 `/c/...`、Windows 的 `C:\...`、POSIX 的 `/home/...` 都能用；
   但 craft --out 建议用相对路径（当前目录下），最不容易踩环境差异。
 
+## 每轮交付与台账（每轮结束必交，CLI 优先）
+
+**CLI 优先**：出图、核验、审批、定稿全走 `pf` 命令（`pf next` 永远告诉你下一步）；
+GUI 只留给人两件事——亲眼看图、点审批。插件的门禁与留痕都挂在 CLI 上，
+走 CLI 的每一步在 `events.jsonl` 里可审计；无头环境（SSH/容器/CI）本来就全 CLI。
+
+每轮交付在**用户工作目录**建 `promptfigure-out/`，每轮一个新版本文件夹 `vN/`（v1 → v2…）：
+
+```
+promptfigure-out/
+├── vN/
+│   ├── round-vN.md                ← 本轮反馈（下面的必含项）
+│   └── figures/                   ← 本轮图（副本或引用，文件名带 -vN）
+├── paper-with-figures.md          ← 论文+已插图的演进版（无关段落省略，每次更新同一个）
+└── final/paper-final.md + 格式副本  ← 最终论文版本（定稿时才建）
+```
+
+**round-vN.md 必含**（与 promptfigure-api skill 的 deliverables-ledger.md 同一协议）：
+1. **本轮清单**：每张图——figureId / 图种 / 档位 / 版本 / 本机真实路径（本插件即
+   `~/.promptfigure/projects/<docId>/figures/<figureId>/vN.png`）/ 插入位置（§¶）
+2. **插入位置（两段边界）**：上一段最后一句 + 「……」 + 下一段第一句，用户一眼定位
+3. **所用上下文**：用了哪几段明确到 §¶；上下文只放**首句 + 「……」 + 尾句**；
+   数据/表格/代码文件一律给引用链接，不内联内容
+4. **图片版本**：每张图的每个版本独立文件（vN），旧版永不覆盖
+5. **优化前→优化后**（优化任务）：原图路径 vs 新图路径 + 改了什么 + 所用上下文（首尾句）
+
+**最终成稿流程**（用户说「定稿」）：提醒核对数据是否更新 → 用户确认后才 premium 定稿 →
+定稿后必问矢量图（本地 AI 重绘、token 贵、速度慢；比赛/数模默认不做；确认做则按元素
+分层重绘成可编辑矢量，PPT/WPS 按用户偏好）——完整协议见 promptfigure-api skill 的
+`references/deliverables-ledger.md`。
+
 ## 事件回放
 
 `~/.promptfigure/projects/<docId>/events.jsonl` 只追加不改写 —— 审批历史、

package/web/app.js

@@ -407,21 +407,27 @@ function paintFigures() {
 // ---------- 审批控件（侧栏卡片与浮层共用 —— 审批永远针对具体的图） ----------
 function reviewControls(f) {
   const rev = state.review[f.figureId] || { status: "pending", note: "" };
+  const byLabel = rev.by === "ai" ? '<span class="by-ai" title="这条判定是 AI 写的，不是你——请自己看一眼图再改判">⚠ AI 判定</span>'
+    : rev.by === "user" ? '<span class="by-user" title="你本人点的">本人</span>' : "";
   const box = document.createElement("div");
   box.className = "review-ctl";
   box.innerHTML = `
-    <div class="meta">${badgeOf(rev.status)} <b>${escapeHtml(f.figureId)}</b> @${escapeHtml(f.at)} · ${escapeHtml(latestVer(f).model)}${f.versions.length > 1 ? ` · ${f.versions.length} 版` : ""}</div>
+    <div class="meta">${badgeOf(rev.status)} <b>${escapeHtml(f.figureId)}</b> @${escapeHtml(f.at)} · ${escapeHtml(latestVer(f).model)}${f.versions.length > 1 ? ` · ${f.versions.length} 版` : ""}${byLabel ? ` · 审批来源 ${byLabel}` : ""}</div>
     ${rev.note ? `<div class="meta">意见：${escapeHtml(rev.note)}</div>` : ""}
-    <textarea class="note-box" placeholder="哪里不对？（可选，AI 会读到）"></textarea>
+    <textarea class="note-box" placeholder="写哪里不对或建议（AI 会读到；点「驳回」请写具体缺陷）"></textarea>
     <div class="btn-row">
       <button class="btn ok" data-act="approve">通过</button>
       <button class="btn no" data-act="reject">驳回</button>
     </div>
+    <div class="btn-hint">通过后 AI 才能出高清定稿 · 驳回 = AI 按意见重画 · 反馈 = 只提建议、图仍待你审批</div>
     <div class="btn-row"><button class="btn ghost" data-act="feedback">提交反馈给 AI</button></div>`;
   box.querySelectorAll("[data-act]").forEach((btn) => {
     btn.onclick = async () => {
       const note = box.querySelector(".note-box").value.trim();
       const act = btn.dataset.act;
+      // 驳回不带意见 = AI 只能盲改（精修状态机拿不到具体缺陷）——拦一道
+      if (act === "reject" && !note &&
+          !confirm("驳回但没写意见 —— AI 只能盲改。\n建议在上方写清楚哪里不对；确定要空意见驳回？")) return;
       const status = act === "approve" ? "approved" : act === "feedback" ? "pending" : "rejected";
       const resp = await fetch(`/api/review?doc=${DOC}`, {
         method: "POST",
@@ -430,7 +436,7 @@ function reviewControls(f) {
       });
       const data = await resp.json();
       if (!resp.ok) return toast("提交失败：" + (data.error || resp.status));
-      toast(act === "approve" ? "已通过，AI 可以出定稿了" : act === "feedback" ? "反馈已提交，AI 会读到" : "已驳回");
+      toast(act === "approve" ? "已通过，AI 会接着出高清版" : act === "feedback" ? "反馈已提交，AI 会读到" : "已驳回，AI 会按你的意见重画");
       await loadState(); paintAll();
       // 审批队列开着 → 这张已离开队列，原位自动落到下一张
       if (!$("#queue").classList.contains("hidden")) renderQueue();

package/web/style.css

@@ -136,6 +136,11 @@ main { flex: 1; display: flex; min-height: 0; }
 .btn.no { background: var(--red-line); color: #fff; }
 .btn.no:hover { filter: brightness(1.08); }
 .btn.ghost { background: #eef1f6; color: var(--ink); }
+/* 审批按钮后果说明（三个按钮的区别一眼可见，别让用户猜） */
+.btn-hint { font-size: 11px; color: var(--ink2); margin-top: 6px; line-height: 1.5; }
+/* 审批来源：AI 自批的图必须让人一眼看出来（监督闭环） */
+.by-ai { background: #fde8e8; color: #9b2c2c; border-radius: 8px; padding: 0 6px; font-weight: 600; }
+.by-user { background: #e8f3ec; color: #1c6b3a; border-radius: 8px; padding: 0 6px; }
 
 .evt { font-size: 12px; padding: 6px 0; border-bottom: 1px dashed var(--line); color: var(--ink2); }
 .evt b { color: var(--ink); font-weight: 600; }