虾稿设计

使用 visual-rag MCP 工具生成设计图片。

MCP 服务地址：https://syncopated-retractively-anitra.ngrok-free.dev/mcp

若工具不可用或域名失效，告知用户联系小邹获取新地址。

标准流程

所有模型都应优先使用语义搜索路径。 关键词搜索仅在语义搜索无结果时作为兜底。

Step 1：ensure_services

确认服务在线，必须第一步调用。

Step 2：search_templates（语义搜索，首选）

search_templates(query, usage_type="cover", n=8, include_thumbnails=True)

用固定的 Query 模板构造查询，匹配效果最佳：

格式:[cover/content/poster] 语义:[为{目标受众}做{格式}，传达{核心主张}，整体{情绪/风格}]

示例：

> ❌ 弱："减脂封面"

> ✅ 强："格式:cover 语义:为减脂打卡博主做封面，传达夏日减脂计划，整体清新轻松、带清单结构"

usage_type 参数与 query 中的"格式"保持一致，作为硬过滤（只搜对应类型的模板）。n 建议设为 8。

有视觉能力的模型：看缩略图合图，根据视觉风格直接选。

纯文本模型：传 include_thumbnails=False，根据 brief / visual_tags / layout_structure 等字段判断匹配度选模板 ID。

无结果时：改用 list_templates(keyword, include_thumbnails=True/False) 关键词兜底。关键词须命中模板描述中实际存在的词（如"插画""手绘""喜庆"），不能用语义词（"减脂"无效）。

Step 3：get_template_spec(template_id)

获取选定模板的槽位详情（uuid、role、max_chars、max_per_line、line_break、hint、current）。

⚠ template_id 是纯整数，不带 t 前缀。正确：template_id=689，错误：template_id="t689"

Step 4：填写槽位内容

有视觉能力的模型：可根据需求适度发挥，但不得超出 max_chars / max_per_line 限制。

无视觉能力的模型：严格遵守以下规则，这是唯一的质量保障手段：

• list_line_count: N → 必须填满 恰好 N 条，不能多也不能少，少填会出现大片空白
• max_per_line → 每行字数绝对不超过此值，参考 current 示例的字数节奏
• max_chars → 总字数不超过上限
• line_break: true → 手动加 \n 换行，不靠自动折行
• must_edit: true 的槽位必须填写，其余保留原值不做修改
• 不擅自改变内容结构，模板设计什么格式就填什么格式

槽位来源字段（⚠ 必须遵守）：每个槽位的 来源 字段定义了内容来源类型：

填写指引 字段提供了具体的填写说明，填写前必须阅读。

若用户未提供真实信息（账号名、品牌名、期号等），先追问再填写，或保留原值，绝不编造。

Step 5：generate_poster(template_id, slots, adjustments?)

渲染并返回两张图：render（成品）+ inspect（UUID 标注图）。

⚠ slots 是字典，格式为 {"uuid": "填入文字"}。

正确：slots={"4b4c414680a0": "减脂打卡"}

错误：slots=[{"uuid": "4b4c414680a0", "value": "减脂打卡"}]

⚠ 渲染完成后返回的下载链接路径是 /files/文件名，不要自行拼接路径。

Step 6：验收（渲染完成后必须检查）

generate_poster 返回结果包含：

• render 图（成品）
• inspect 图（色码标注：🔴已确认问题 🟡疑似 🟢正常 ⬜装饰/非必填）
• 📊 质检报告（文字，随文本一起返回）
• 🔴 高危裁图（有确认问题时自动附加）

验收流程：

1. 先读质检报告：
• 🔴 确认问题 → 必须处理（文字溢出/元素缺失），通常需缩短文字后重渲
• 🟡 疑似问题 → 调用 get_slot_crops 放大查看后决定是否处理
• ✅ 全部正常 → 继续视觉检查

1. 看 render 图（有视觉能力时）：
• 装饰贴纸是否遮挡文字
• 列表是否有大片空白（槽位未填满）
• 整体视觉效果是否达标

1. 处理 🟡 疑似问题（按需）：

```

get_slot_crops(render_path="/path/t708_xxx_render.png", uuids=["uuid1", "uuid2"])

```

1. 定位布局问题：看 inspect 图，左上角 UUID 前8位对应 adjustments 中的 id

⚠ 批量生成时，每张图必须独立验收，不能因为第1张通过就认为其余都正确。

调整元素位置（inspect 图定位后）：

adjustments=[{"id": "uuid前8位", "style": {"transform": "translateX(80px)"}}]

支持：transform / display: none / opacity / fontSize / top / left

无视觉能力的模型：依赖质检报告文字，严格处理 🔴 问题；从源头（Step 4 字数控制）规避 🟡。

原则

• 内容优先：内容多换高密度模板，不删减用户内容
• 给成品：有视觉能力的模型自行调整到满意后再展示；无视觉模型严格填槽后直接交付
• 渲染完成后展示 render 图，并提供响应中返回的下载链接（不自行构造文件名）