虾稿设计#

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

MCP 服务地址： https://syncopated-retractively-anitra.ngrok-free.dev/mcp 若工具不可用或域名失效，告知用户联系 小邹 获取新地址。

---

标准流程#

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

Step 1：ensure_services#

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

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

text

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

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

text

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

参数说明示例格式用途分类cover=小红书封面，content=正文配图，poster=手机海报目标受众谁会看这张图内容创作者、职场新人、减脂博主…核心主张图片想传达什么"AI工具让创作提速10倍"、"3步搞定职场沟通"情绪/风格整体调性冲击力强/清新轻松/喜庆热烈/克制专业…

示例：

❌ 弱： "减脂封面" ✅ 强： "格式: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 放大查看后决定是否处理
   • ✅ 全部正常 → 继续视觉检查

2. 看 render 图（有视觉能力时）：

   • 装饰贴纸是否遮挡文字
   • 列表是否有大片空白（槽位未填满）
   • 整体视觉效果是否达标

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

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

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

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

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

text

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

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

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

---

原则#

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