更新配图与截图处理规则

SKILL.md

@@ -40,7 +40,7 @@ description: 生成或优化符合 maomomo / 猫MOMO 风格的中文出海金融
 - 金融活动配图如出现信用卡、支付卡、卡组织、支付网络或机构 Logo，必须按官方材料或用户素材核对并记录来源；用户没有提供 Logo / 卡面素材但画面需要品牌或支付标识时，应主动尽力从官方活动页、品牌资源页、条款 PDF、App / 官网截图等来源查找准确标识，保存到 `sources/` 并记录来源。不得把银联 / UnionPay 画成 Mastercard、Visa 等其他卡组织。已核对正确的 Mastercard / Visa / UnionPay / 银行 / 支付宝等标识可以辅助出现，但不能抢占或替代 `MAOMOMO` 主标识位置。
 - 先只生成一张代表性风格确认图，优先封面图，保存为正式命名，例如 `origin_image/hsbc-mastercard-alipay-campaign-01-cover.png`。用户批准样张前不得批量生成剩余图片。
 - 样张批准后，后续每张图片必须继承同一个生图后端、同一套视觉系统和同一种质量配置；不得为了加快速度擅自改成 `low`。
-- 每张最终图片必须来自确认后的图片生成后端：当前 agent 的内置图片生成工具，或用户确认后的 `scripts/maomomo_image_gen.py` API/CLI fallback。不得用 Playwright、HTML/CSS、SVG、Pillow、canvas、本地拼贴或手工文字覆盖冒充最终生成图。
+- 每张最终图片必须来自确认后的图片生成后端：当前 agent 的内置图片生成工具，或用户确认后的 `scripts/maomomo_image_gen.py` API/CLI fallback。不得用 Playwright、HTML/CSS、SVG、Pillow、canvas、本地拼贴或手工文字覆盖冒充最终生成图。例外：用户提供真实银行 / 券商 / 钱包截图且需要上传图片 API 做编辑时，必须先向用户确认实际 API 地址 / baseURL、接口归属和是否允许外发；该 API 可能是用户自有兼容服务，不能默认按公共第三方处理。若未确认、确认不允许或安全策略不允许上传，则先用图片后端生成不含真实截图的空白模板，再在本地把原截图完整嵌入模板；本地步骤只能做排版嵌入、圆角、阴影和尺寸适配，不得改动截图内金额、日期、姓名、账号、交易描述等关键内容，并必须在状态文件和最终回复说明这是“图片后端模板 + 本地嵌入真实截图”的混合流程。
 - 生成图片按“一张图一个 job / 一次请求 / 一次 QA”推进；通过 QA 后才用状态脚本记录 result 并同步到 `assets/`，不能只生成到 `origin_image/` 后声称完成。运行环境支持子 agent 时，样张通过后可以一图一个子 agent 并发处理；每个 dispatch、结果和 blocker 都必须写入状态文件，不能只靠聊天说明。
 - 完整交付模式下，不能只在聊天里输出正文；必须生成 Markdown 文件、`assets/` 目录和 ZIP 包，除非用户明确说只要文字、只要大纲、不要图片、不要打包或先不生成文件。
 - 配图文件必须是独立 PNG；不要用一张大拼图代替多张图，不要只给提示词冒充图片文件。

references/delivery-rules.md

@@ -126,6 +126,16 @@ article_package.zip
 4. 如果用户要求文件或打包，必须重新生成 ZIP。
 5. 最终回复给出最新 Markdown 和 ZIP 链接，避免继续给旧文件。
 
+## 远程图片路径替换
+
+当用户提供 WordPress / CDN 上传后的 `<img ... src="...">` 片段或远程图片 URL，并要求替换文章图片路径时：
+
+1. 只替换 Markdown 中的图片 URL，不改正文、alt text、图片顺序和本地 assets 文件。
+2. 优先按文件名或 title 中的序号 / 语义匹配，例如 `01-cover` 对封面图，`04-rebate-card` 对到账截图卡片；不要按用户粘贴顺序机械替换，除非用户明确说按粘贴顺序。
+3. 替换后用 `rg` 或等效检查确认没有残留本地 `assets/` / `origin_image/` 引用。
+4. 若文章已全部改为远程图，Markdown 本地图片路径检查可以跳过本地资产存在性要求，但仍要检查远程 URL 已写入正确位置。
+5. 如果需要重新打包，ZIP 至少包含最新 `article.md`；是否继续附本地 `assets/` 取决于用户要“发布稿”还是“完整归档包”，最终回复要说明包内内容。
+
 ## 最终交付前检查清单
 
 交付前必须逐项确认：

references/image-generation.md

@@ -170,6 +170,8 @@ uv run python scripts/maomomo_image_gen.py styles
 
 - API key 缺失：提示用户配置环境变量或检查 Codex 配置，不要编造图片文件。
 - 接口失败：保留已生成图片，说明失败项，必要时用 `--dry-run` 交付 prompt 清单作为临时排查材料。
+- 如果脚本实际请求到了默认 `https://api.openai.com/v1`，但项目配置应使用兼容接口，先检查 `MAOMOMO_IMAGE_BASE_URL` / `OPENAI_BASE_URL` 和 `~/.codex/config.toml` 解析结果；Python 3.10 及以下必须走脚本内置 TOML fallback。不要把兼容接口的 key 误发到默认 OpenAI API 后反复重试。
+- 真实银行 / 券商 / 钱包截图等敏感素材需要上传图片 API 做 edit 前，先向用户确认实际 API 地址 / baseURL、接口归属、是否为用户自有兼容服务以及是否允许外发。确认且安全策略允许后才上传；未确认、确认不允许或安全策略不允许时，先生成“不含真实截图”的空白模板，再本地嵌入真实截图；状态记录 `backend_used` 写成类似 `GPT Image2 template + local screenshot embedding`，并在 QA note 说明截图未外发。
 - 图片文字乱码或金额错误：重新生成该单张图片；不要手工覆盖文字伪装成模型输出。
 - 图片不符合风格：先更新 manifest 的 `style` / `core_text` / `extra`，再重跑对应项。
 - 图片生成超时：可以对同一张图重试较长超时；不要为了快擅自降低 `quality`。

references/visual-assets.md

@@ -14,6 +14,9 @@
 - 最终原始图保存到 `origin_image/`，通过 QA 后同步到 Markdown 引用的 `assets/`。
 - 生成图必须是“示意图 / 信息图 / 教程视觉”，不得伪造真实 App 截图、账单或官方页面。
 - 用户提供真实截图时，优先用真实截图，并隐去姓名、账号、余额、地址、手机号、二维码、交易号等个人信息。
+- 真实银行 / 券商 / 钱包截图、账单、交易记录、客服记录等默认视为敏感素材；需要上传图片 API 做编辑或重绘前，必须先向用户确认实际 API 地址 / baseURL、接口归属、是否为用户自有兼容服务以及是否允许外发。不要默认把配置里的图片 API 视为公共第三方，也不要在未确认具体接收方时上传真实截图。若用户未确认、确认不允许或安全策略 / 上下文不允许外发，即使用户要求“用 GPT Image2 美化截图”，也改用“GPT Image2 生成空白展示模板 + 本地嵌入真实截图”的流程。
+- 空白模板流程：图片后端只生成不含真实截图、账单文字、交易数字和伪造 App UI 的展示框 / 卡片背景；随后用本地工具把真实截图完整嵌入预留区域。本地嵌入可以做裁切适配、圆角、阴影、边框和背景排版，但不得修改截图内部文字、金额、日期、账户、交易描述或任何证据内容。
+- 使用空白模板流程时，`prompt` / manifest / `deck_spec.json` / 状态文件必须记录模板生成后端、真实截图本地嵌入方式、原截图路径和 QA 结论；最终回复说明真实截图未上传到图片接口。
 - 每张图必须包含清晰可见的 `MAOMOMO` 标识。
 - 每张图的可见文字必须受控：只允许出现该图指定的业务文案、`MAOMOMO` 和已核对允许出现的品牌 / 支付标识，不得添加副标题、风格标签、prompt 描述、说明文字、额外 slogan 或无关文字。
 - 不要用 Playwright、HTML/CSS、SVG、Pillow、canvas、本地拼贴或手工覆盖文字替代图片生成后端。