非营利活动网站搭建

非营利组织做活动时，常卡在一个现实问题上：宣传页、报名表单、现场签到和反馈问卷分散在不同工具里，负责同事又不一定懂前端和部署。这个技能把活动网站拆成五类页面，并统一到可双击打开的 .html 单文件输出，目标是让不懂技术的人也能把一套活动站点跑起来。

核心能力

• 五类站点识别：按“宣传 / 报名 / 签到 / 留言墙 / 问卷”分流；用户说“整套都要”时，按顺序逐页生成。
• 文档优先：先问是否有提案、新闻稿、讲者名单、日程表；上传后自动解析并回读关键信息，减少手填字段。
• 能自动化就自动化：报名和问卷优先通过 scripts/generate_google_form.py 直出 Google 表单，数据天然进入 Google Sheets；静态页面可走 EdgeOne Pages、GitHub Pages 或 npx vercel --prod --yes 部署。
• 签到后端：assets/checkin.html 支持姓名搜索和现场补录两种模式；后端 assets/checkin-apps-script.js 使用 doGet 返回名单、doPost 处理签到或补录，数据写入 Attendees 与 Checkins 两个 sheet。
• 跨域处理：file:// 读取 Google Sheets 用 JSONP；写回 Apps Script 用 navigator.sendBeacon()，失败再用 fetch 兜底，同时写 localStorage 做离线备份。
• 交互降级：优先给单选 ▸、多选 ☐/☑ 的预设选项；WorkBuddy 支持原生 checkbox 时直接渲染勾选框，否则退化为编号列表。

关键流程

1. 判断页面类型并确认是否已有活动文档。
2. 收集活动名、日期、地点等无法穷举的信息，其余尽量给选项让用户点选。
3. 替换模板占位符：{{PLACEHOLDER_NAME}} 必须精确匹配，生成后校验不能残留 {{ }}；空数组片段直接不渲染。
4. 报名/问卷默认走 Google Forms API；只有用户明确偏好独立网页、没有 Google 账号或 API 不可恢复时，才落到 assets/registration.html 和 assets/survey.html。
5. 涉及 Google Sheets 后端的部署，必须先 present_files references/apps-script-deploy-tutorial.html，再输出 11 步文字速览，并请用户确认后逐步带做。

边界与注意点

• 单文件网页不做 CDN 依赖，也不引入 npm 包；颜色集中在 :root CSS 变量里，方便换主题。
• 绝不猜用户数据：接入 Google Sheets 前必须让用户截图 sheet tab 和列头，并确认哪一列映射到姓名、机构、邮箱或签到码；不要硬编码 Attendees 这类名称。
• 部署话术要面向非技术用户，不说 MCP、API、SCF、COS；只说明“需要授权一次”还是“我来帮你放到网上”。
• 留言墙如果要实时同步，需要 assets/scf-backend/main.py 部署到腾讯云函数，并创建 COS bucket；注册腾讯云账号因实名要求仍需人工完成。