YBO 产品规格包
v1.1 — 2026-09-14。每个产品一个包，包内是该产品的规格、设计附录、供应商指南、产品说明与评估（槽位固定，见下文产品包）。层级、价格、里程碑与待决事项的治理摘要是 product-plan.md；本包内容不得与之矛盾。若某文件固定了计划中尚未决定的数值，该数值为目标值 (t)，并引用计划中的待决项而不是关闭它。
阅读顺序
章节标题：“阅读顺序”供应商交付入口：Air 指南、Air Hub 指南、Key 指南，公共条款在 Switch 公共条款；每个产品的规格加指南即其 RFQ 包，按代工范围分开交付。
- 先读产品规划书，确认产品边界、优先级和待决事项。
- 从下表进入产品目录，先读目标规格（Level 1），再读设计附录（Level 2）。产品状态与文档清单在对应目录页查看。
- 涉及通信、配置或系统集成时，结合跨产品基础中的 YBO-CAN 协议与配置模式；研究依据从研究索引进入。
产品矩阵
章节标题：“产品矩阵”下图是各产品线的连接关系总览：控制面经 Air Hub 或直接上 YBO CAN 到 Core，Core 把逐路遥测交给 Mate；交流侧由 Core 系列的 DO 控制成员自主决策并驱动线圈，Mate 经 RS-485（或 CAN）与它通信；Mate 再经 NMEA 2000 与船内 LAN 把数据送到船上的 MFD。Studio 配置的是 Core 的通道与规则。节点上的编号对应下方产品目录。点击图可全屏放大。
读图要点：
- 控制环路不经 Mate 与云。 Air → Air Hub → Core，Key → Core；只有 Core 的真实回读能表示成功，约 5 秒无回读则界面回退并提示重试。
- 交流侧由 Core DO 决策。 Mate 只与 Core DO 通信，不逐条驱动交流回路；Core DO 以直流线圈驱动与干接点跨接线端子，交流配电箱的载流部分、互锁与保护仍属其制造商与成套商。
- 失效安全在模块本地。 逐通道默认态与报警规则在 Core 与 Sense 上执行，Mate 或云离线不影响；每模块保留物理手动旁路。
- Studio 配置 Core。 回路清单、通道分配、脱扣曲线与调光预设都落在 Core 上，带版本、云备份与一键回滚。
- 对外互通走 Mate。 Mate 经认证 PGN 把状态送上 NMEA 2000，供 Garmin、Simrad、Raymarine 等 MFD 显示；船内 LAN 同时承载摄像头与 MFD 的以太网接入。
- 未画进图的产品：P12 Tag（接收端待定：原 Air Hub LR 已于 2026-09-29 撤销，见 Air Hub 规格
AIR-O-12）、P10 View 接 NMEA 2000 或船内 LAN，两者均非当前基线。
船外形态（P09 Control）
章节标题：“船外形态（P09 Control）”Air 卖到船以外时，Air Hub 自己就是控制器与授权点，不需要 Core 或 Mate。
读图要点：策略点对每条回路标记 local / remote / bridged 并执行本地锁；集成层的 Matter 桥把每个 Air 按键暴露为 Generic Switch 端点、把 Air Hub 管理的回路暴露为开关与调光端点，生态侧同时接入 Apple Home、Google Home、Alexa、SmartThings、HAOS 与米家；每类执行器必须有确认回读；所有远程路径（自有云、生态云、云对云）都要穿过策略点，同受本地锁约束并审计来源，安全相关回路永不桥接。
产品目录
章节标题：“产品目录”| ID | 目录入口 | 范围 |
|---|---|---|
| P01 | YBO Core | 分布式通用配电输出模块 Core 27 / Core 43（2026-09-14 取代 Core S / M / HD），以及交流侧 DO 控制成员 Core DO（2026-09-13） |
| P02 | YBO Sense | 数字与模拟输入模块 |
| P03 | YBO Mate | 船舶主控，软硬件一体：i.MX93 硬件与其上的运行时、云与 App（2026-09-12 合并，2026-09-13 定为单一产品） |
| P04 | YBO AC | 交流集成与自动化接口、调试包、参考配电板；交流侧 DO 控制由 P01 Core DO 承担，YBO 仍无任何承载交流的硬件 |
| P05 | YBO Switch | 墙面控制面板产品线：无线 Air、有线 Key（首期为 Key Box 36 外接按键控制盒，Key 4 / Key 8 面板延后），及两者共用的中枢 Air Hub（2026-09-12 由 P05 Air Switch / Air Hub 与 P06 Key 合并） |
| P07 | YBO Studio | 配置工具与应用架构 |
| P09 | YBO Control | 船外 Air 的控制应用与协议集成平台：Air Hub 控制外部断路器/继电器，Air 作为无线开关接入 Matter/HomeKit/HAOS，可选自有云与第三方互通（概念阶段规格 + 协议评估 + 生态接入说明） |
| P10 | YBO View | 舵台显示器与概念设计简报 |
| P11 | YBO Eye | 摄像头与 AI 监控集成，含 PoE 交换机附件 |
| P12 | YBO Tag | 船员手环（落水告警）与资产标签 |
| X01 / X02 | 跨产品基础 | YBO-CAN 应用层协议与 Studio 配置模式 |
生命周期取值：concept → spec-draft → EVT → DVT → PVT → released。只有当验证计划有带日期的台架记录时，文件才可进入 EVT。
产品包
章节标题：“产品包”每个产品 ID 一个目录，就是一个产品包；包内的文件槽位固定（文档规范 §4）：
| 槽位 | 文件 | 类型 | 面向 | 何时必须 |
|---|---|---|---|---|
| 入口 | index.md |
目录 | 所有人 | 始终 |
| 规格（Level 1） | P<nn>-<product>.md |
规格 | 内部工程、治理 | 始终；唯一的需求来源 |
| 设计（Level 2） | P<nn>-<product>-design.md，拆分时 -design-<aspect>.md |
设计 | 内部工程、设计公司 | spec-draft 起；不得改动任何 Level-1 数值 |
| 供应商指南 | P<nn>-<product>-guide.md |
指南 | 供应商、代工厂 | 外包产品 EVT 前 |
| 产品说明 | P<nn>-<product>-brief.md |
说明 | 客户、安装商、经销、销售 | 始终（concept 阶段可为草案桩） |
| 评估 | evaluations/<slug>.md |
评估 | 内部工程 | 可选；永不作为需求来源 |
多产品线（P05 Switch）在线目录下放线级入口、规格、说明与供应商公共条款指南，每个产品再各一个子包（决策）。跨产品基础（X01、X02）在 shared/。
- 目标值与事实。 每个数值只能是以下三种之一：引自 product-plan.md；标为 (t) 的目标值；或附有官方来源 URL（写在同一行或同一句）的数据手册数据。未核实的项目须注明。商业与采购主张的证据状态见 assumptions.md。
- 芯片。 具名器件均为候选（主选 + 备选），在文件中指明的门槛（通常是 product-plan.md §4/§6 的 M3 出口门槛）冻结。无线器件另需遵循 product-plan.md §1/§3 的供应商中立配置原则。
- 平台规则（12/24 V 与 8–32 V；ISO 16750 / ISO 7637 抗扰；双总线——NMEA 2000 与内部 YBO CAN；失效安全准则；控制面回读准则；休眠 ≤5 mA；三防涂覆；-25…+70 °C；MCU 家族 S32K148 / S32K314，小节点 S32K116/118）以 product-plan.md §1 为基础；Air/Key 的电池、温度、单 CAN 与推荐 MCU 差异在 P5 与 Air/Key 指南明确，不将其他节点参数机械套用。
- 合规路径由 compliance-matrix.md 管理；每个文件只指向其对应行并列出产品特有证据。
- 研究证据以相对路径引用 研究目录 下的报告。
文件模板
章节标题：“文件模板”硬件规格使用 16 个编号章节：1 定位与层级 · 2 型号与 SKU · 3 系统位置 · 4 功能需求（FR-nn） · 5 电气规格 · 6 接口与连接器 · 7 推荐芯片（候选） · 8 机械与环境 · 9 固件、配置与 OTA · 10 失效安全与控制面行为 · 11 合规路径 · 12 成本目标 · 13 参照基准 · 14 验证计划 · 15 待决事项与依赖 · 16 变更记录。软件与概念产品使用 11 个：1 定位与层级 · 2 范围与边界 · 3 系统位置 · 4 功能需求 · 5 数据、配置与接口 · 6 安全、隐私与合规 · 7 成本/商业挂钩 · 8 参照基准 · 9 验证计划 · 10 待决事项与依赖 · 11 变更记录。Switch 产品线的三个产品用统一的 9 章规格：1 定位与边界 · 2 型号与目标规格 · 3 功能与状态行为（ID 表） · 4 系统位置与失效安全 · 5 接口 · 6 安全 · 7 合规路径 · 8 待决事项 · 9 变更记录，需求用“必须/目标/推荐/待冻结”标记；设计附录与指南的章节见 P05-switch.md §2。
每个文件以 frontmatter（title / kind / status / updated / version / product / level / lifecycle）开头，由站点在标题上方渲染；标题后只保留关系行（产品入口、治理摘要、Level-1 规格、设计附录、总交付要求、引用的基础文件、依据、适用产品、取代说明）。整套骨架在 docs/templates/product-package/。
如何新增或修改产品
章节标题：“如何新增或修改产品”- 先通过 PMA 流程（任务、计划）在 product-plan.md 中新增或更新该产品的章节（层级、价格、里程碑、待决事项）。
- 新增产品：复制
docs/templates/product-package/骨架到本目录下的新产品目录，替换P<nn>-<product>占位符，并在上表添加目录链接。已有产品的新文档只能落在包的某个槽位；放不进槽位的是评估、研究报告（research/）或决策（docs/decisions/）。 - 每个芯片数据在厂商数据手册核实并引用；其余一律标 (t) 或“未核实”。
- 运行质量门
bun run docs:lint && bun run docs:build && git diff --check；lint 检查 frontmatter、槽位与目录索引一致性。 - 只在对应产品目录的
index.md文档表中登记明细；在受控文件末尾追加变更记录行，并在变更日志记录变更。