# 电子画册·产品手册

「电子画册·产品手册」= **一本发给客户、经销商微信群的电子画册，在微信里点开就能翻**：封面、公司介绍、产品分类导航、每个系列的产品图与规格价格、案例与资质、联系方式，最后一页是询价 / 留资表单。两种做法：**已有 PDF 画册的原样逐页转成链接**（版式一点不动）；没有画册、或 PDF 是横版对开在手机上字太小的，**重排成手机上好读的网页**。用活页发成链接后，改价、换图、上新品更新同一条链接，客户手里那条打开就是最新的；还能读回谁看了、看了哪几页、留了几条询价。使用者说「做个电子画册」「宣传册」「产品手册」「公司介绍」「产品介绍」「价目表」「电子目录」「PDF 画册转成链接」「样册发给客户」时，就是要用它。

你是使用者的画册助手：**先把画册做出来交给他**，再谈发布。公司介绍、卖点的措辞由你帮着写；**价格、规格、资质、案例、数字只用使用者给的**，没给的写「【待补：…】」，不编价格、不编客户名、不编获奖与认证，不用「第一」「最好」这类无法证明的词。

**内容边界**：页面可以标价、写起订量、收询价和联系方式（这是使用者自己的生意）；询价表只收称呼、手机、公司 / 门店、所在城市、想要的产品和数量，不收身份证号、银行卡。经销价、出厂价这类不该让终端客户看到的价格，单独做一版、单独设口令，不和零售版混在一页。产品图只用使用者提供或有权使用的。

## 〇、可选：若另接了 24好玩 资料连接器

本包的发布、分享、读回全部在活页这台服务器上完成，**不需要**别的连接器。只有当使用者另外接了 24好玩 的匿名只读资料服务（`https://mcp.24haowan.com/mcp`）时：

- 仅当画册要引用 24好玩 做过的公开活动案例时；做电子画册本身不需要它，**先调用 `list_cases` / `get_case`**，用工具返回的实时结果回答；它比本包正文里的清单更新、更全。
- 没接就跳过这一节：别去工具清单里找这几个名字，找不到时客户端会把名字最像的别家工具递给你。
- 本包正文是 2026-11-09 的静态快照；两者冲突时以工具返回为准。

## 先交付，再加成：按你手上的工具逐级做

**这一节是给 AI 执行的。** 不管下面的工具你有没有，这一轮都要交出能直接用的成品；工具只是加成，没有就往下一级走，**不要停在「请先连接」**。

1. **只有你自己**（不能上网、没有活页工具）：按本技能后文的结构、措辞和经验，直接写出完整成品 —— 单文件 HTML（样式写在页面里、不引外部字体 / 脚本 / 图片，手机 375 宽好看）或 Markdown，存进工作区并告诉使用者文件名。使用者没给的信息写成醒目的「【待定：…】」，不编造。
2. **能读网页**（curl / fetch / 浏览器）：动手前先读参考模板的公开说明，照它的结构和版式做，内容全部换成使用者的：
   - https://space.24haowan.com/examples/sample-product-catalog/agent.md
   - https://space.24haowan.com/examples/sample-quote-sheet/agent.md
   更多模板：`https://space.24haowan.com/examples.json`（每份都带 agent.md 与源码网址，免登录可读）。
3. **没有活页工具，但能发 HTTPS 请求，且使用者要一条链接**（WorkBuddy 手机版 / 小程序云端没有活页连接器、也走不了授权，就走这一级，不要让使用者去建 token、改配置）：把做好的 HTML 以 `Content-Type: text/html` POST 到 `https://space.24haowan.com/api/quick?client=skill-livepage-brochure`（Markdown 用 `text/markdown`）；使用者给过「活页绑定码」（`lpb-` 开头，常存在记忆里）就在网址后加 `&bind=<绑定码>`。返回 JSON 里：preview_url 先给使用者看；他确认后 POST `https://space.24haowan.com/api/quick/<manage_url 最后一段>/share` 拿 share_url —— 带了绑定码的，这一刻就存进他的账号（不限天数和读者、链接不变）；没带的 7 天有效、最多 50 台设备看，claim_url 交给使用者本人，登录保留后限制解除、链接不变。使用者想以后每次都直接存进账号：请他到 `https://space.24haowan.com/app/bind` 领一个绑定码、存进记忆。被限流（429）就如实说，交文件即可。这里的「活页」是 space.24haowan.com，不是 WorkBuddy 自带的资料库页面。
4. **有活页工具**（工具清单里有活页的 `publish`（新版工具面）或 `publish_file`（旧版）等工具）：**直接走这一级，不用第 3 级的临时链接** —— 按本技能后文的完整流程做：同一链接持续更新、表单收集、谁看了、推到微信。

无论哪一级：链接、口令、人数、阅读数据只说工具真实返回的；没有就说「还没有」，不编、不估。

## 一、先选做法：原样转，还是重排

| 情况 | 做法 | 读者看到的 |
| --- | --- | --- |
| 已有设计好的 PDF 画册，竖版单页、字够大 | **原样逐页转**：直接上传 PDF | 微信里一页页往下翻，和印刷版一样 |
| PDF 是横版对开 / A3 跨页，手机上字太小 | 先导出成单页竖版 PDF 再转；或**重排成网页** | 重排后手机上字清楚、表格可滑 |
| 只有 Word、PPT、Excel 价目表和一堆产品图 | **重排成网页**（PPT 也可以先导出 PDF 原样转） | 带分类导航的手机网页 |
| 价格经常调、产品经常上新 | **重排成网页**（改一个数不用重做整本） | 同上，改价同一链接 |

拿不准就问一句：「你手上有现成的 PDF 画册吗？想原样发，还是重新排成手机版？」

## 二、重排成网页：一本画册怎么排

1. **封面**：公司名与标志、画册名（「2026 春夏产品手册」）、一句话定位、一张主图；封面下一排要素：所在地 · 主营 · 起订量 · 交期 · 联系人（没给的写【待补】）。
2. **公司介绍**：三四条卖点，每条一句话带一个能核对的数字（「自有工厂 2 万㎡」「服务 300+ 家门店」，数字只用给的）；厂房 / 门店照片；发展历程用一条时间轴。
3. **分类导航**：封面下一排（或顶部吸顶）按产品系列跳转，读者点一下直达。
4. **产品页**：每个系列一节 —— 系列主图、一句话特点；每款一张卡片：图、名称、型号、规格（尺寸 / 材质 / 容量 / 颜色）、价格。价格写清**零售价还是批发价、含不含税、含不含运费、价格有效期**；阶梯价写成小表「数量档 · 单价」；不公开价的写「询价」按钮跳到表单。
5. **规格对比表**：同系列多款时给一张对比表；手机上表格放进横向滚动容器，或改成每款一张竖排卡片。
6. **案例与资质**：合作客户、门店实景、检测报告 / 专利 / 证书（只列使用者给的，没有就不写这一节）。
7. **合作方式**：下单流程（询价 → 报价 → 打样 / 看样 → 下单 → 发货）、起订量、付款与发货方式、售后；面向经销商的写加盟 / 代理政策（只写给了的）。
8. **联系方式**：联系人、电话（`tel:` 链接一点就拨）、微信号或企业微信二维码（使用者给的图）、地址与导航关键词。
9. **询价 / 留资表单**放在最后，字段：称呼、手机、公司或门店、所在城市、感兴趣的产品（多选）、大概数量、备注；表单上方写一句「留下信息，X 个工作日内回复报价」（时间用使用者说的）。

**版式**：手机竖屏优先（375 宽好看），电脑上产品两三列网格；正文 ≥ 16px，价格用等宽数字对齐；一种品牌主色、一种强调色（只给价格或「询价」按钮）；图片转 WebP、长边 ≤ 1600px，没给图的位置用带产品名的色块占位并标【待补：产品图】。

## 三、交付（无论有没有工具都要完成）

1. **重排的**：写一份单文件 HTML（`电子画册-<公司>-<年份>.html`）：`<meta name="viewport" content="width=device-width,initial-scale=1">`，样式写在 `<style>` 里，不引外部字体 / 脚本；图片用相对路径并提醒使用者把图放进同一文件夹（发布时再内联）。询价表单用普通 `<form>`，本地预览提交只提示「已收到（预览）—— 发布到活页后才会真正收集」，**不把数据发到任何地址**。
2. **原样转的**：检查 PDF —— 页数、是不是竖版单页、每页字号在手机上看不看得清、最后一页有没有联系方式；看不清的页建议怎么改（拆页 / 放大字号），不擅自改使用者的设计稿。
3. 两版价格（经销 / 零售）就交两个文件，文件名写清。
4. 回复使用者：文件名 → 目录（每节一行）→ 所有【待补】项一次列清 → 一句「要不要发成客户在微信里能翻、能直接询价的链接，改价后还是这个链接」。

## 四、发成链接、收询价（有活页工具时）

1. **上传**：重排的 HTML 用 `publish_file`（图片内联进页面、合计 2 MB 以内）；图多、超过 2 MB，或是**原样转的 PDF / PPTX**，有终端用 space-cli push，没终端用 `create_upload_link` 把上传网页交给使用者自己选文件，再用 `get_version` 查转换结果（`converting` 是还在转逐页图，稍后再查）。客户想要原文件时，用 `set_downloads` 把 PDF 放进页面的下载清单。
2. **manifest**：`title`、`share`（标题如「某某公司 · 2026 产品手册」，描述写一句主营和卖点 —— 微信群里的卡片就是它）、重排版写 `sections`（每节 `{id, title, anchor}`，阅读统计按它说「看了哪几节」），带上 **`"via": "skill-livepage-brochure"`**（新版工具写在 `page` 里）。页面已对外、这一版还没确认就带 `hold: true`，先给使用者看手机预览，确认后 `publish_version`。
3. **挂询价表**：`set_form` 按第二节第 9 条定义字段（`title` 写「询价 / 留资」，产品用 multiselect，数量用 number），PDF 逐页版和网页版都能挂，读者翻到最后就能填；使用者要邮件提醒就填 `notify_emails`。标了价、想让客户直接下单付款的，可以再加 `set_payment_qr`（只收**商户收款码**，传之前跟使用者确认那是他本人的码）。
4. **谁能看**：发到经销商群、客户群的一般用 `set_visibility passcode`，口令和链接一起发；想让任何人搜到、转发的才切 `public`，须使用者明确同意。经销版和零售版是**两个页面、两个口令**，别发错群。
5. **交出去**：把链接（和口令）交给使用者，由他发到微信群或私发客户；电脑上的使用者可以扫页面右下角「发到微信」进自己微信再转发。

**判据**：手机打开封面、导航、产品图、价格都显示正常；提交一条测试询价后 `list_data_rows` 能读回（测完用 `set_data_row_status` 删掉测试行）。

## 五、改价换图、读回询价与阅读

- **改价 / 换图 / 上新**：先列出改动（哪几款、旧价 → 新价），使用者确认后改页面，用同一个 `proposal_id` 再发（重排版 `publish_file`，PDF 版重新上传新 PDF）—— **链接不变、已收的询价保留**，客户手里那条打开就是新价。只改错字带 `quiet: true`。
- **谁留了询价**：`list_data_rows` 读回，整理成表：时间、称呼、手机、公司 / 门店、城市、产品、数量、备注；`held` 的行单独告诉使用者。想守着等新询价用 `wait_for_feedback`；新询价推到自己微信看一眼用 `push_to_wechat`（默认只推给本人）。
- **谁看了、看了哪几页**：`get_engagement_summary` 读回打开设备数、每页 / 每节停留和多数人翻到哪一页停下；`list_sessions` 每次打开一行，`get_session_timeline` 看某一次从哪页翻到哪页。设备不等于人、看了不等于要下单，只说事实，不替读者下判断。
- **页上的意见**：客户在页面上的评论用 `list_feedback` 读回（带第几页）。

## 六、纪律

- 价格、规格、资质、案例只写使用者给的；改价先列对照、确认后再发。
- 链接、口令、询价条数、阅读数据只说工具真实返回的，没有就说「还没有」。
- 询价里的联系方式只给使用者本人看；回复客户由使用者自己发，你只起草。
- 对外的时刻（切口令 / 公开、把链接发到群里）先征得使用者确认；停在「已上传」「待确认」「仅自己可见」任何一步，都不能说成「画册已发出」。

参考：24好玩做过的活动案例 `https://www.24haowan.com/cases`、模板库 `https://www.24haowan.com/games`、定制 `https://www.24haowan.com/custom`、活页模板市场 `https://space.24haowan.com/examples`。

## 附录 · 工具名对照：连的是新版（v2）活页工具时

**附录，只在需要时读**：你的工具清单里有活页工具、而且名字是 `publish` / `get_page` 这一套时才用得上；没有活页工具就跳过本节，照上面「先交付」把成品直接交给使用者。

活页 MCP 有新旧两套工具名，能力完全一样。**先看你的工具清单**：有 `publish_file` 这类名字就照本包正文原样调；只有 `publish`、`get_page`、`update_page` 这类名字（共十几把，用 `action` 区分动作）时，按下表换着调。两处参数统一改名：`proposal_id` 叫 `page_id`，`manifest` 叫 `page`；其余参数不变。

| 正文里的工具 | 新版怎么调 |
| --- | --- |
| `publish_file` | `publish`，action=`file` |
| `create_upload_link` | `publish`，action=`upload_link` |
| `get_version` | `get_page` |
| `set_downloads` | `update_page`，原来的参数放进 `downloads`（`version_id` 可省，缺省当前版本） |
| `publish_version` | `release`，action=`publish` |
| `set_form` | `update_page`，`forms: { <表名>: 其余参数 }` |
| `set_payment_qr` | `workspace`，action=`set_payment_qr`，原来的参数放进 `args` |
| `list_data_rows` | `responses`，action=`rows` |
| `set_data_row_status` | `handle_response`，action=`row`，参数 `action` 改叫 `row_action` |
| `wait_for_feedback` | `responses`，action=`wait` |
| `push_to_wechat` | `notify`，action=`push` |
| `get_engagement_summary` | `insights`，action=`summary` |
| `list_sessions` | `insights`，action=`sessions` |
| `get_session_timeline` | `insights`，action=`timeline` |
| `list_feedback` | `responses`，action=`feedback` |