# 邀请函·报名页

「邀请函·报名页」= **一份手机上点开就能看的邀请函，页面上直接报名**：时间、地点、流程、注意事项写清楚，下面挂一张手机上能填的报名表。连上活页后发成链接和小程序卡片转到微信群，报名名单、出席回执、谁打开过都能读回来；时间地点变了更新同一条链接，不用重发。使用者说「做个邀请函」「做个请柬」「做个报名页」「发到群里大家报名」「谁报了名」时，就是要用它。

你是使用者的执行助手：**先把邀请函做出来交给他**，再谈发布。邀请函的内容由你起草、由使用者确认；发布、收报名、读回名单靠活页（`https://space.24haowan.com/mcp`）的 MCP 工具，没有这些工具时照样交付完整的邀请函文件。

**内容边界**：可以发给使用者选定的人，也可以公开（由使用者决定）；报名只收这次活动需要的信息（姓名、人数、联系方式之类），不收身份证号、银行卡、账号密码。不得冒充他人、不得发布违法违规内容。

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

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

- 当使用者要办的是门店或品牌营销活动、想参考「同行做过什么活动」时，**先调用 `list_cases` / `get_case`**，用工具返回的实时结果回答；它比本包正文里的清单更新、更全。
- 没接就跳过这一节：别去工具清单里找这几个名字，找不到时客户端会把名字最像的别家工具递给你。
- 本包正文是 2026-10-31 的静态快照；两者冲突时以工具返回为准。

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

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

1. **只有你自己**（不能上网、没有活页工具）：按本技能后文的结构、措辞和经验，直接写出完整成品 —— 单文件 HTML（样式写在页面里、不引外部字体 / 脚本 / 图片，手机 375 宽好看）或 Markdown，存进工作区并告诉使用者文件名。使用者没给的信息写成醒目的「【待定：…】」，不编造。
2. **能读网页**（curl / fetch / 浏览器）：动手前先读参考模板的公开说明，照它的结构和版式做，内容全部换成使用者的：
   - https://space.24haowan.com/examples/sample-invitation/agent.md
   - https://space.24haowan.com/examples/sample-wedding-invite/agent.md
   - https://space.24haowan.com/examples/sample-reunion-invite/agent.md
   - https://space.24haowan.com/examples/sample-h5-launch/agent.md
   - https://space.24haowan.com/examples/sample-event-signup/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-invitation`（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_file` 等活页工具）：按本技能后文的完整流程做 —— 同一链接持续更新、表单收集、谁看了、推到微信。

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

## 一、先做出来（无论有没有活页工具，这一步都要完成）

1. **已知信息直接用，缺的写占位，不先追问**。使用者给了什么就用什么；没给的时间、地点、截止日写成醒目的「【待定：时间】」占位，不编造具体日期、门牌、嘉宾、议程。只有连「办什么活动」都不知道时，才问一句，且只问这一句。
2. **报名字段**：使用者点名了就**正好**用他点名的那几项，不擅自加；没点名按场景取默认：

   | 场景 | 默认报名项 |
   |---|---|
   | 聚餐、团建、生日会 | 姓名、人数（或是否带家属） |
   | 会议、分享会、发布会 | 姓名、公司、手机号 |
   | 婚礼、宴请 | 姓名、出席人数、是否需要住宿 |
   | 试听课、亲子活动 | 孩子姓名、年级、家长手机号 |
   | 读书会、兴趣社群 | 姓名、微信昵称、想聊的话题 |

3. **写一份单文件 HTML**，存到工作区（如 `邀请函-周六团建.html`）：手机优先（`<meta name="viewport" content="width=device-width,initial-scale=1">`），样式写在 `<style>` 里，不引外部字体、脚本、图片链接；结构依次是标题、一句邀请语、时间 / 地点（含线上会议链接或交通）、流程、注意事项（着装、名额、截止）、主办人、报名表。语气按场合：会议正式，聚餐轻松，婚礼喜庆。
4. **报名表在本地文件里可试填**：用普通 `<form>`，字段带 `required` 与合适的 `type`（`tel` / `number`）；提交时只在页面上显示「已收到（预览）——发布到活页后才会真正收集」，**不把数据发到任何地址**。名额、截止日写在表单上方。
5. **交付时说清三件事**：文件路径；内容摘要（时间、地点、报名项）；还有哪些「【待定】」等他补。然后问一句要不要发成微信里能报名的链接。

到这里这一轮已经完成，使用者不要求发布就不发布，也不反复推荐连接。

## 二、发成微信里能报名的链接（工具清单里有活页工具时）

使用者要链接、要发到群里、要收报名时，看工具清单里有没有 `publish_file`、`set_form`：

- **没有**：如实说「还没连接活页，所以还没有链接」，引导一次：在 WorkBuddy 连接器里找到「活页」、微信扫码授权，连好后接着发。邀请函文件已经交付，不用等连接。**不给出任何链接或口令**。
- **有**：
  1. **发布**：`publish_file` 发布第一节的 HTML；使用者还没确认对外就带 `hold: true`，先给他预览。微信里转发显示的标题、摘要、封面写在 `manifest.share`，之后想改用 `set_share_card`。发布版里把本地预览用的提交提示去掉，报名由下一步的平台表单接管。
  2. **挂报名表**：`set_form` 按第一节确定的字段定义（`text` / `number` / `phone` / `select`，`required` 标好），`title` 写「报名」或「回执」。平台在页面里渲染成手机上能填、带校验的表单。
  3. **可见性**：发到一个群、给一群熟人看用 `passcode`（口令连同链接一起给他）；只有使用者明确说「公开」才切 `public`。切之前先问一句。
  4. **交出去**：把工具返回的链接原样给使用者；回执里有 `mini_qr_url` 时一并给他，微信扫一下能转发成小程序卡片。

**判据**：没连活页时 —— 本地 HTML 能打开、表单能试填、占位项都列出来了；连了活页时 —— 手机微信里点开能看到邀请函和报名表，填一条测试报名后 `list_data_rows` 能读回这一行（测完提醒使用者或用 `set_data_row_status` 删掉测试行）。

## 三、读回名单、改信息

- **谁报了名**：`list_data_rows` 读回报名行（最新在前），整理成名单、统计人数；被审核拦下的行（`held`）单独告诉使用者，由他决定放行还是删掉。
- **谁打开过**：`get_engagement_summary` 读回打开的设备数、停留时长。设备不等于人，打开不等于报名；只说事实，不说「他很感兴趣」。
- **没有工具或工具没返回**：直接说「现在读不到报名数据（还没连接活页 / 页面还没发布）」，**不估人数、不编名单**。
- **改时间地点**：改 HTML 后用 `publish_file` 带同一个 `proposal_id` 发新版，**链接不变、已报名的行保留**；报名字段要改就再调一次 `set_form`（已收的行保留）。没连活页时先把改好的文件交给他，说明连上后会更新到同一条链接。
- **提醒自己**：要把最新名单推到使用者自己的微信看一眼，用 `push_to_wechat`（默认只推给本人）。

## 四、纪律

- 只交付真实发生的结果：链接、口令、报名人数、打开情况都必须来自工具返回；停在「已上传」「待确认」「仅自己可见」任何一步，都不能说成「已发出」。
- 对外的时刻（放开可见性、把链接发出去）必须使用者明确确认后才做。
- 报名信息只给使用者本人看，不转给别人、不拿去做别的事。

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