万象城级招商手册制作 Agent
> 版本 1.1.0 已修复（评测反馈闭环）：① 去除 Google Fonts 外网依赖，改用系统字体栈，国内离线导出 PDF 无障碍；② 模板内嵌图片占位兜底，双击即开不裂图；③ 新增目录导航、具体触发例句、常见错误排查表、FAQ；④ 附自包含示例 examples/示例-青岛百丽广场.html。
目录
- 一句话定位
- 何时使用 / 如何触发（含触发例句）
- 资产文件清单
- 快速开始（3 步出手册）
- 四阶段流水线
- 常见错误与排查
- FAQ
- 禁止事项（红线）
- 质量检查清单
一、一句话定位
把一份定位报告（或项目资料）自动变成一本能直接发出去的购物中心招商手册——万象城级视觉、图文结合、用户零代码自行改字换图、一键导出 PDF。
二、何时使用 / 如何触发
满足以下任一情况即触发本 Skill：
- 用户上传 .pptx 定位 / 策划 / 运营报告，并说"做成招商手册 / 宣传册"
- 用户说："帮我出一本购物中心招商资料 / 品牌手册 / 投资手册"
- 用户说："参考万象城 / 华润 / 标杆购物中心风格，做一本招商册"
- 用户说："给我一个能反复用的招商手册生成 agent / skill"
直接可用的触发例句（复制即可作为用户场景）：
> "用招商手册制作 Agent，根据这份《XX 项目整盘定位报告》生成招商手册"
> "帮我把这个购物中心的资料做成万象城级别的招商宣传册，要能直接发品牌方"
> "生成一份招商手册，图文结合，我自己能在浏览器里改字换图"
不要在本 Skill 里做：纯 AI 概念图堆砌却不填真实数据、衬线书法大标题风、米黄底高定风（那是被否方向）。
三、资产文件清单（本 Skill 自带，缺一不可）
| 文件 | 用途 | 是否需改 |
|---|---|---|
SKILL.md |
本文件（流程与规范） | 否 |
assets/template.html |
万象城级手册模板（含浏览器编辑器 JS、打印适配、图片占位兜底，双击即开不裂图） | 是（复制后替换内容） |
references/design-system.md |
万象城级设计系统蒸馏（配色 token / 字体层级 / 版式组件 / 图文铁律 / 质检清单） | 否（排版严格照此） |
inputs/brief-template.md |
无 PPTX 时的信息收集表 | 否 |
examples/示例-青岛百丽广场.html |
已填真实数据的完整样例（离线打开即见效果，图区为占位待替换） | 否（参考用） |
务必先读：references/design-system.md（排版时严格照此执行）。
排版基底：复制 assets/template.html 作为工作副本，再替换内容与图片。
四、快速开始（3 步出手册）
- 复制模板：把
assets/template.html复制为你的工作文件（如XX项目招商手册.html）。 - 填内容：浏览器打开 → 点右下角「✎ 编辑」直接改字；点任意图片选本地照替换（无需联网、无需代码）。
- 导出：点「📄 导出PDF」或 Ctrl+P 存 PDF；「⬇ 下载」得独立 HTML 可转发。
> 想全自动：把定位报告 PPTX 交给本 Agent，它会按第五阶段流水线替你填好再交付。
五、四阶段流水线（自动模式）
Stage 0：收集输入
判断输入类型，二选一：
- A. 有定位报告 PPTX（推荐）：用 python-pptx 全量提取文本 + 图片（见下方"提取脚本要点"）。
- B. 只有口头 / 简要 brief：按 inputs/brief-template.md 向用户收集项目名、定位、指标、业态、品牌、政策、交通、联系方式。
无论哪种，最终都要拿到结构化数据（YAML/JSON）：
project: 项目名称 / 英文标 / 一句话定位
location: 区位亮点 / 交通 / 客流 / 辐射
metrics: 建面 / 分层建面 / 车位数
positioning: 定位语 / SWOT / 差异化
format: 业态规划 / 楼层租金梯度
brands: 品牌矩阵(名/业态/级别/是否真签约)
policy: 招商政策表(级别/免租/补贴/权益)
finance: 财务亮点
contact: 电话/联系人/邮箱/地址
Stage 1：文案生成（按 13 模块）
对照模板的 <!-- SECTION --> 注释，逐模块产出文案。语气：克制、数据驱动、卖"价值"不卖"商铺"。
- 数字用「」括号 + 金棕关键词（见 design-system 3.4）
- 章节头配英文宣言句（design-system 3.2）
- 品牌用"名 · 业态 · 级别"，真实签约标"已签约"，意向标"意向洽谈中"
- 财务预测加"目标 / 预期"字眼，避免承诺感
Stage 2：配图（图文结合，强制）
优先级：① 客户自己的实景照 / 渲染图 / 区位图 ＞ ② 从定位报告 PPTX 提取的真实图 ＞ ③ ImageGen 生成概念图。
- 从 PPTX 提取的图：筛选 ≥150KB、尺寸较大的渲染图 / 实景照（见提取脚本）。
- 缺图用 ImageGen：调性统一为"象牙+金棕+暖光、商业摄影感、杂志级"，prompt 末尾固定加
editorial commercial real estate photography, luxury, ultra detailed，尺寸 1536×1024（封面/空间）或 1024×1536（竖向）。
- 所有 AI 生成图必须在手册中标注"效果图 / 概念示意"，正式对外前替换。
- 放图规则：封面右方形 1:1、空间体验整屏断点、其余左右分栏图占 58%。绝不用纯文字页堆砌。
- 模板已内置 onerror 占位兜底：即使暂时没放图，打开也显示"替换为…"提示而非裂图。
Stage 3：排版（注入 template.html）
- 复制
assets/template.html为工作副本。 - 把 Stage 1 文案替换进对应
<!-- SECTION -->区块（保留data-edit属性，便于用户后续自改）。 - 把 Stage 2 图片放到
images/并改src；缺图时模板自动占位（已内置，不报错）。 - 应用 design-system 的 CSS token（模板已内置，一般无需改；仅当客户有定制色时微调
--gold等）。 - 自检（见 design-system 6 质量清单），特别确认：底色纯白、无衬线主导、留白充足、每页有图/数据。
Stage 4：交付（可发布）
present_files打开 HTML 预览。- 告知用户零代码自改方式：右下角工具条 → ✎编辑改字 / 🖼换图 / 💾保存 / 📄导出PDF / ⬇下载 / ↺重置。
- 提醒：正式对外前必须把占位联系方式换成真的、品牌状态标注清楚、AI 图换实景。
六、常见错误与排查
| 现象 | 原因 | 解决 |
|---|---|---|
| 打开模板图区显示"替换为…"灰块 | 尚未放真实图（正常占位，非错误） | 点图片选本地照，或放图到 images/ 改 src |
| 字体显示偏细 / 不是预期 | 系统无 Noto Sans SC | 已本地化用系统字体栈，国内正常；要更高级字体自加 @font-face |
| Ctrl+P 导出 PDF 有破页 | 模块跨页断裂 | 给该模块加 CSS break-inside:avoid |
| 导出 PDF 带工具条 | 打印样式未隐藏 | 模板已内置 @media print{工具条 display:none}，确认未误删 |
| 改完刷新内容丢失 | 未点「💾保存」 | 点保存写入 localStorage；或用「⬇下载」得独立文件 |
上传文件非 .pptx |
提取脚本失败 | 转 pptx，或改用 inputs/brief-template.md 手动收集 |
| 大报告（300+页）卡顿 | 内存占用 | 先提文本再分批提图（见脚本要点） |
| 提示"文件缺失" | 只拿了 SKILL.md 单文件 | 必须连同 assets/ references/ inputs/ examples/ 整个目录一起使用 |
七、FAQ
Q1 一定要联网吗？ 不需要。模板已去除 Google Fonts，用系统字体；图片本地化。纯离线可用，国内导出 PDF 字体正常。
Q2 我不会写代码能改吗？ 能。浏览器打开点「✎编辑」直接改字，点图换图，无需任何代码。
Q3 图片区显示灰块正常吗？ 正常，那是占位提示。换上项目实景照即变真实手册。
Q4 能换风格吗？ 默认万象城级（纯白/无衬线/左右分栏）。要其它风格改 CSS token，但本 Skill 专注购物中心宣传风。
Q5 品牌墙图片裂了？ 模板品牌墙图 onerror 自动隐藏并显示文字，不影响整体排版；放真实品牌图即可。
Q6 数据要真实吗？ 你负责真实性；Agent 只做美化呈现，可加"客流×客单价≈营收"等合理性校验提示。
Q7 怎么才算"可直接发布"？ 填真实数据 + 换真实图 + 联系方式真实 + 标注 AI 示意，四步齐了即可对外。
八、禁止事项（红线）
- 不输出衬线书法大标题 / 米黄底 / 满版渐变遮罩风（被否方向）。
- 不编造品牌"已签约"状态（意向必须标注）。
- 不把 AI 概念图当真实项目照对外（必须标注示意）。
- 不验证客户数据真伪（用户负责；但可加"数据合理性校验"提示）。
九、质量检查清单（交付前逐条过）
- [ ] 底色纯白 #FFFFFF（非米黄）
- [ ] 全册无衬线字体主导
- [ ] 留白 ≥35%，无拥挤感
- [ ] 每页有图或数据可视化
- [ ] 数据用「」括号 / 金关键词，非数字卡网格
- [ ] 品牌用照片拼贴，非边框卡片
- [ ] 章节头有英文宣言句
- [ ] 占位 / 示意已标注，真实数据已填
- [ ] Ctrl+P 导出 PDF 无破页、无工具条残留
- [ ] 联系电话 / CTA 为真实信息（非 # 占位）
字体本地化说明（国内适配）
本 Skill 所有 HTML 不依赖 fonts.googleapis.com，统一使用
"PingFang SC","Microsoft YaHei","Hiragino Sans GB","Source Han Sans SC","Noto Sans SC",sans-serif
系统字体栈。国内机器离线打开 / 导出 PDF 字体正常，无"需联网国外网站"的麻烦。
提取脚本要点（Stage 0·A）
用 python-pptx 跑：读 prs.slides，shape.text_frame.text + has_table 取文字，
MSO_SHAPE_TYPE.PICTURE 的 sh.image.blob 落盘到 images/。注意：
- 364 页大报告先提取文本（写文件），再分批渲染图片，避免内存爆。
- 图片质量筛选：用 Pillow 读 size 与文件大小，取 Top 40 大图人工挑 5–8 张。
- 中文乱码 / 图片型页面（如 REGULAR 源野）跳过文本，直接取图。
生图额度提示
ImageGen 约 5–10 额度/张。优先用客户 / PPTX 真实图，仅在确实缺图时调用生图，并事先向用户报备张数与预估额度。
