Project Christmas Magic Tent｜圣诞互动帐篷
规划中、明确暂不采购。 目标预算 ≤¥500，首要任务为参数化结构与电子电路验证。此处尺寸、材料、电路均是设计候选值，非实际成品。
希望实现的四层体验
- 帐篷结构：偏向小屋 / 城堡式，可拆搭、可存放的软布空间。
- 灯光：星星灯 / 树灯，可替换主题装饰。
- 传感器：使用 HC-SR501 PIR 检测有人经过或进入（不用于儿童安全监控）。
- 声音：Arduino + DFPlayer Mini 播放问候声或圣诞音效；先在桌面用低压电路测试。
已记录但尚未冻结的候选尺寸
| 部位 | 方案尺寸 | 处理方式 |
|---|---|---|
| 小屋总体 | 约 160 × 110 × 135cm（长 × 宽 × 高，方案） | 需要先建模，不能直接按这个裁布 |
| 墙体 | 高约 80cm | 根据顶棚坡度和儿童站立空间调整 |
| 正面窗 | 约 40 × 45cm | 需核对开窗位置与边缘加固 |
| 侧窗 | 约 30 × 40cm | 需考虑通风和防夹手 |
| 主体布料 | 曾估算 6.5–9.5m | 仅为历史粗估，需以裁片排料重算 |
| 可用空间 | 曾报告宽和进深各 1000cm | 作为输入记录，实际安装净空仍需复测 |
主要资源：Bambu P1S、2D 打印机、Arduino（型号未知）。可复用万圣节项目中的布艺、魔术贴和 3D 打印经验。
先模拟，不购物：第一阶段任务
- 用 Blender/FreeCAD 建立参数变量
length=1600mm、width=1100mm、ridge_height=1350mm、wall_height=800mm；窗户作为可切换的参考体。 - 对比门口方向、屋脊净空、儿童进入路径、通风位置、室内取放空间及骨架收纳长度。
- 从三维模型导出裁片面积和骨架长度估算；打印 1:5 连接件/小样，先观察形变，不用估计材料强度代替实测。
- 先在桌面使用低压供电连接 LED、HC-SR501 和 DFPlayer Mini；确认电源电压、引脚及实际 Arduino 型号，不得直接接家用市电或让电线暴露在儿童可触区域。
- 形成可采购 BOM：确定单根杆、布料长度、供电方式、线材、接头及运费；合计控制在 ¥500 内后才允许下单。
项目关卡
- Blender 参数化尺寸模型与可重复修改的源文件保存。（G0 数字模拟完成，2026-11-06，见 G0 评审；非实物验证）
- 帐篷入口、窗户、骨架、布料裁片有完成检查截图。（G0 几何检查截图与 A/B 对比已完成；裁片为估算，未实测）
- 1:5 骨架、连接件与缝制样片已实测。
- Arduino 型号、低压电源与接线图实际确认。
- PIR 与 DFPlayer 单独通电测试通过。
- 安全检查、预算、运费和儿童可达区域问题关闭后，再下单。
本项目与 HachimoDock 不同：HachimoDock 优先照官方成熟设计复刻，帐篷先做参数化设计与电路原型。
当前进展（2026-11-06）：G0 数字模拟完成
Blender 参数化模型已建成，A（110×160）/ B（160×110）两候选完成几何对比，仍是数字模拟证据，未采购、未制作实体：
- 门洞×屋顶冲突验证：门高 90cm > 檐高 80cm，门洞上角切入山墙；A 净空 10.0cm、B 20.9cm，均通过但 A 余量偏紧。
- 站立净空限制：两方案仅屋脊下 30cm / 43.6cm 窄条可直立（110cm 儿童），帐内活动以跪坐为主。
- 小可用区域压力测试：3.0×3.5m 放得下帐篷，但房间门扇范围与门口通道重叠——真实房间复核时“门扇动线”是第一失效点。
- 电子外置决策：控制盒/电源/扬声器帐外，帐内只留低压发光件；隐藏电子层后基础小屋完整。
详见 G0 数字模拟评审；模型与数据在 source-data/christmas-magic-tent/g0/，渲染图在 public/media/christmas-magic-tent/g0/。下一步：按 G0 清单向 2–3 款真实商品索要尺寸，回填参数重跑后再决定购买。
G1 第一轮商品搜寻结果（2026-11-06，公开信息检索，0 PASS，已复核）
按搜寻需求书完成淘宝/京东/宜家/拼多多公开信息检索，合格候选 0：商品页普遍只给外廓 W/D/H，不发布檐口高与门净宽×高（明细见 source-data/christmas-magic-tent/candidates.md）。人工复核后修正两条记录：
- HelloKitty 游戏屋（160×100×130 加长版）：早前记录的"16mm 金属支架"实际对应 130×100×130 中号款，加长版杆径恢复为待核实，必须按具体商家 SKU 重新核实。
- 宜家 HÖVLIG（¥199，120×120×164）降级为"仅尺寸/结构参考，非采购目标"：官方页面明确警告不要在帐篷内外悬挂灯串、装饰品，以免孩子被绊住——与本项目"星星灯+装饰+帐篷"的核心方案直接冲突。不再建议线下专程测量。
策略（G1 拆分为两子阶段，详见 sourcing-brief.md v2）：
- G1a 商品身份锁定：为 HelloKitty 加长版与何佳功曲奇熊（135×105×135）找到独立商品页、商家、SKU、到手价、按 SKU 核实杆径；
- G1b 缺失尺寸补齐：详情图/说明书/评价图优先，必要时允许向卖家仅索取尺寸照片（仍禁止下单付款）；拿不到的字段走 G1b 参数不确定性模拟兜底（已完成：假设网格上"确定通过 / 存在条件 / 无法判断"三类判定与失效边界，见
source-data/christmas-magic-tent/g1b/）。 - 预算约束修正：帐篷优先 ≤¥200（总预算 ¥500 中原预留额）；超 ¥200 的候选须重算完整 BOM ≤¥500 才能进入采购评审。
- 明确不走"买一实测"路线：7 天无理由要求商品完好、超查验范围可能影响退货，且"缺几个尺寸"不足以 justify 购买一整套帐篷。
G2-V1 电子数字模拟完成（2026-11-07，零采购）
控制器逻辑 controller.h 原样复用（md5 校验一致）通过主机逻辑测试 8 类行为 / 11 场景全 PASS（上电关闭、短按循环、长按关闭、去抖 29/30ms 边界、上电按住抑制、10 分钟超时 599999/600000 边界、快速连续按压、millis 回绕），原版 7 场景回归亦 PASS。Wokwi 项目（UNO R3 + 按钮 D2 + 4×WS2812 D6）编译通过、仿真运行、串口输出正确；按钮交互截图待人工 5 分钟执行（自动化未穿透 canvas），真实硬件验证阻塞于 Arduino 型号确认。详见 G2-V1 评审。
G2-V2 与 G1a 预算收敛（2026-11-07，零采购）
- G2-V2 纯数字模拟完成：新增
greeter.h（PIR 触发/冷却 15s/防重复/事件 Welcome↔Story 交替/按钮优先/上电预热抑制），G2-V1 controller.h 零改动；主机测试 6 场景全 PASS（连续触发、播放中再触发、手动按钮优先级、上电默认全覆盖），G2-V1 回归 11 场景 PASS。声音=串口事件模拟（PLAY_WELCOME/PLAY_STORY），未宣称 DFPlayer 验证。详见 G2-V2 报告。 - G1a 预算收敛：
主候选曾锁定 HelloKitty 160×100×1302026-11-09 采购决策更新：最终帐篷改为天猫哎哟宝贝 165cm 实木款 ¥210（CONDITIONAL BUY），HelloKitty 内容保留为历史比价（详见 G1a 预算页 与 g1a-final-report.md）。一次性合并采购清单（帐篷+装饰+电子四层，READY_BUY/BOARD_DEPENDENT/SIZE_DEPENDENT 分级）见 采购合并清单。
帐篷采购放行（2026-11-07，用户拍板）
确定购买：HelloKitty 单帐篷款 160×100×130cm ¥299.52（京东 10234458195367，下单由用户执行）。风险兜底：7 天无理由+免费上门退换；门净尺寸/檐口高/杆径/"160×150"疑点全部转为到货实测项（9 项清单见 G1a 预算页），实测数据回填 Blender 复核，PASS 关闭帐篷项、FAIL 免费退换启用对照款。预算口径：帐篷 299.52 + 固定 260 = 559.52（V1 规划 550–650 内）；剩余电子+装饰 ≈350，电子件待 Arduino 型号确认后分批采购。