@seeed-studio/solution-cli 0.2.0 → 0.3.0

package/catalog/knowledge-core.json

@@ -43,7 +43,34 @@
         "smart_warehouse",
         "retail_voice"
       ],
-      "summary": "用 AI 麦克风采集清晰的声音，在本地盒子上转写、合成语音或运行大模型，开源可部署方案开箱即用。"
+      "summary": "用 AI 麦克风采集清晰的声音，在本地盒子上转写、合成语音或运行大模型，开源可部署方案开箱即用。",
+      "landing_url": "https://www.seeedstudio.com/solutions/acoustic-audio-ai",
+      "repo_url": "",
+      "diagnostic_playbook": {
+        "domain": "声学与音频 AI / 设备故障听诊",
+        "core_dimensions": [
+          "被测机械类型与异响特征",
+          "声学麦克风 vs 振动声发射传感器",
+          "车间环境背景噪音"
+        ],
+        "questions": [
+          {
+            "dimension": "machine_defect",
+            "question": "被监测的机械设备是什么（例如电机、轴承、齿轮箱、还是水泵压缩机）？想捕获的异常特征是什么（异响磨损、撞击声还是高压气体泄漏）？",
+            "rationale": "决定选择声学麦克风阵列还是接触式高频振动/声发射探头。"
+          },
+          {
+            "dimension": "ambient_noise",
+            "question": "设备周边是否有其他强烈机械运转的背景杂音？",
+            "rationale": "强背景杂音需利用端侧硬件 DSP 滤波器及降噪算法将工作主频滤除，突出异常脉冲。"
+          },
+          {
+            "dimension": "alarm_latency",
+            "question": "检测到异响异常后，希望在多长时间内告警，并通过何种方式通知维护人员？",
+            "rationale": "确定边缘推理实时性要求以及告警输出联动链路（声光/短信/PLC 停机信号）。"
+          }
+        ]
+      }
     },
     {
       "id": "building-energy-retrofit",
@@ -79,7 +106,34 @@
         "smart_space_assistant",
         "multi_protocol_gateway"
       ],
-      "summary": "LoRaWAN 传感器贴墙安装，一台网关接入 Modbus、BACnet 等既有设备，数据进入开源面板或你自己的平台。"
+      "summary": "LoRaWAN 传感器贴墙安装，一台网关接入 Modbus、BACnet 等既有设备，数据进入开源面板或你自己的平台。",
+      "landing_url": "https://www.seeedstudio.com/solutions/building-energy-retrofit",
+      "repo_url": "",
+      "diagnostic_playbook": {
+        "domain": "旧建筑节能改造 / 暖通与智能抄表",
+        "core_dimensions": [
+          "存量表计通信接口",
+          "配电间集中 vs 跨楼层分布",
+          "纯能耗采集 vs 闭环控制"
+        ],
+        "questions": [
+          {
+            "dimension": "meter_interface",
+            "question": "现场的电表、水表或空调机组目前是什么型号？是否自带 RS485（Modbus RTU / DL/T 645）通信接口，还是老旧机械表？",
+            "rationale": "带 485 接口可直接低成本手拉手总线抄表；无通信接口的老旧机械表需更换智能表或加装开口式开口互感器 CT。"
+          },
+          {
+            "dimension": "cable_distribution",
+            "question": "表计是集中在配电室/机房，还是分散在各楼层的强电井中？各楼层之间是否有现成弱电网线贯通？",
+            "rationale": "集中点位直接用有线网关接总线；跨楼层分散无布线推荐 SenseCAP LoRaWAN 采集器无线回传，大幅削减施工穿墙打洞成本。"
+          },
+          {
+            "dimension": "control_requirement",
+            "question": "需求是仅做“能耗监测与数据统计”，还是需要做“闭环节能控制”（如根据峰谷电价或人员在场调节空调回路）？",
+            "rationale": "决定是否需要配置带工业继电器与模拟量输出的控制型网关。"
+          }
+        ]
+      }
     },
     {
       "id": "conversational-voice-ai",
@@ -119,7 +173,34 @@
         "conversational_voice_ai",
         "reachy_claw_voice_robot"
       ],
-      "summary": "给设备加一个可随时打断的语音入口；识别和理解在本地主机上完成，首次装好后可断网运行。"
+      "summary": "给设备加一个可随时打断的语音入口；识别和理解在本地主机上完成，首次装好后可断网运行。",
+      "landing_url": "https://www.seeedstudio.com/solutions/conversational-voice-ai",
+      "repo_url": "",
+      "diagnostic_playbook": {
+        "domain": "现场语音控制 / 离线语音助手",
+        "core_dimensions": [
+          "声学噪声与麦克风拾音距离",
+          "100% 离线隐私 vs 云端大模型",
+          "受控设备联动协议"
+        ],
+        "questions": [
+          {
+            "dimension": "acoustic_environment",
+            "question": "现场使用环境的噪音如何？通常是在安静的室内/会议室，还是存在环境背景噪音（如风扇、空调、人群嘈杂）？拾音距离多远？",
+            "rationale": "决定麦克风阵列选型：近场安静可用双麦；远场（3~5米）与嘈杂环境必须使用带硬件 DSP、回声消除 AEC 与波束成形的 ReSpeaker XVF3800 多麦阵列。"
+          },
+          {
+            "dimension": "privacy_connectivity",
+            "question": "系统对网络和隐私有什么硬性要求？是必须 100% 纯本地离线断网运行，还是可以联网访问云端大模型？",
+            "rationale": "纯离线需配置 Orin NX 等中高算力主机在端侧跑端到端小模型（Whisper + LLM + TTS）；联网混合模式可用轻量主机做前端拾音上云。"
+          },
+          {
+            "dimension": "target_control",
+            "question": "语音识别或大模型理解后，主要用来控制什么设备或执行什么业务？",
+            "rationale": "明确南向控制接口：是对接 Home Assistant 智能家居、发送 MQTT 报文、还是通过串口/Modbus 控制工业继电器。"
+          }
+        ]
+      }
     },
     {
       "id": "elderly-care-monitoring",
@@ -150,7 +231,34 @@
       "reference_designs": [
         "fall_detection"
       ],
-      "summary": "摄像头在房间里端侧判定跌倒并秒级推送告警；支持接入麦克风阵列实现异常声音与呼救检测。"
+      "summary": "摄像头在房间里端侧判定跌倒并秒级推送告警；支持接入麦克风阵列实现异常声音与呼救检测。",
+      "landing_url": "https://www.seeedstudio.com/solutions/elderly-care-monitoring",
+      "repo_url": "",
+      "diagnostic_playbook": {
+        "domain": "智慧养老 / 室内监护",
+        "core_dimensions": [
+          "集中 vs 分散空间分布",
+          "存量摄像头利旧",
+          "隐私保护与传感器形态"
+        ],
+        "questions": [
+          {
+            "dimension": "topology",
+            "question": "老人房间和公共区域是在同一层/同一楼栋比较集中，还是分散在多栋楼或较远区域？",
+            "rationale": "集中分布可用 1 台 reComputer 主机拉多路 RTSP 流摊薄成本；分散点位推荐每间房独立 reCamera 一体机免拉长线。"
+          },
+          {
+            "dimension": "asset_reuse",
+            "question": "现场是否已经安装了支持 RTSP/ONVIF 协议的监控摄像头（如海康、大华等）？",
+            "rationale": "已有摄像头可直接复用利旧，只需采购边缘算力盒，省去镜头重购成本；无摄像头则推荐成套硬件。"
+          },
+          {
+            "dimension": "privacy_boundary",
+            "question": "卫生间、卧室等高隐私区域是否对纯光学摄像头有顾虑，是否需要无视觉隐私的毫米波雷达方案？",
+            "rationale": "私密区域用 60GHz 毫米波雷达替代光学镜头，既可精确检测跌倒卧床，又彻底消除侵犯隐私争议。"
+          }
+        ]
+      }
     },
     {
       "id": "environment-monitoring",
@@ -194,7 +302,34 @@
         "smart_hvac_control",
         "agri_env_monitor"
       ],
-      "summary": "现场设备免布线长效续航，既有工业探头加采集器即可利旧接入。"
+      "summary": "现场设备免布线长效续航，既有工业探头加采集器即可利旧接入。",
+      "landing_url": "https://www.seeedstudio.com/solutions/environment-monitoring",
+      "repo_url": "",
+      "diagnostic_playbook": {
+        "domain": "智慧农业 / 环境监测与微气象",
+        "core_dimensions": [
+          "集中大棚 vs 广域农田",
+          "市电 vs 太阳能/电池供电",
+          "监测指标与探头深度"
+        ],
+        "questions": [
+          {
+            "dimension": "topology",
+            "question": "监测区域是集中式连栋温室大棚（百米级），还是大面积户外大田/果园（数公里级）？",
+            "rationale": "大棚内百米级可采用 RS485 有线总线集中组网；广域大田推荐 LoRaWAN 远距离低功耗无线传输，配合 SenseCAP M2 网关。"
+          },
+          {
+            "dimension": "power",
+            "question": "现场测点是否有 220V 市电供电，还是需要野外太阳能板/锂电池长续航供电？",
+            "rationale": "市电可支持持续高频数据上报；无市电需要选用带内置超大锂电池、支持休眠唤醒的低功耗无线传感器（如 S2100/S210x）。"
+          },
+          {
+            "dimension": "sensing_depth",
+            "question": "需要监测哪些核心环境指标？仅是空气温湿度/光照/CO2，还是包括土壤剖面墒情（深层水分/EC/pH）或气象风速风向？",
+            "rationale": "决定是配置一体化多合一微气象站（如 S700/S2120），还是选配工业级土壤三参数/水肥专用探针与变送器。"
+          }
+        ]
+      }
     },
     {
       "id": "home-building-automation",
@@ -228,7 +363,10 @@
         "smart_space_assistant",
         "multi_protocol_gateway"
       ],
-      "summary": "传感器与电表数据汇入边缘网关，同一套点位模型接入 OPC UA、Modbus、BACnet 设备，应用可本地运行或接入你的平台。"
+      "summary": "传感器与电表数据汇入边缘网关，同一套点位模型接入 OPC UA、Modbus、BACnet 设备，应用可本地运行或接入你的平台。",
+      "landing_url": "https://www.seeedstudio.com/solutions/home-building-automation",
+      "repo_url": "",
+      "diagnostic_playbook": null
     },
     {
       "id": "in-person-conversation-intelligence",
@@ -257,7 +395,10 @@
         "retail_voice",
         "smart-badge-voice-transcription"
       ],
-      "summary": "转写可放在云端，也可放在企业自有主机上；固定柜台、窗口的拾音见「门店与柜台服务质检」。"
+      "summary": "转写可放在云端，也可放在企业自有主机上；固定柜台、窗口的拾音见「门店与柜台服务质检」。",
+      "landing_url": "https://www.seeedstudio.com/solutions/in-person-conversation-intelligence",
+      "repo_url": "",
+      "diagnostic_playbook": null
     },
     {
       "id": "indoor-outdoor-positioning",
@@ -284,7 +425,34 @@
       "reference_designs": [
         "indoor_positioning_ble_lorawan"
       ],
-      "summary": "室内BLE信标与室外GNSS无缝融合定位，但地下金属密闭空间需加密布设基站以防信号屏蔽。"
+      "summary": "室内BLE信标与室外GNSS无缝融合定位，但地下金属密闭空间需加密布设基站以防信号屏蔽。",
+      "landing_url": "https://www.seeedstudio.com/solutions/indoor-outdoor-positioning",
+      "repo_url": "",
+      "diagnostic_playbook": {
+        "domain": "室内外定位 / 资产与人员追踪",
+        "core_dimensions": [
+          "纯室内 vs 室内外混合",
+          "定位精度期望（米级 vs 区域级）",
+          "佩戴形式与免维护续航"
+        ],
+        "questions": [
+          {
+            "dimension": "spatial_scope",
+            "question": "定位场景是纯室内（厂房/展厅/仓库），还是室内外混合（比如仓库到室外堆场，甚至货物长途运输）？",
+            "rationale": "纯室内基于 BLE 信标定位；室内外混合推荐 SenseCAP T1000 追踪器，室内切蓝牙/Wi-Fi 定位，室外切 GPS/北斗。"
+          },
+          {
+            "dimension": "accuracy_budget",
+            "question": "对定位精度的期望是怎样的？是需要精确到米级的具体坐标，还是只要知道人在哪间房/资产在哪个货架区域即可？",
+            "rationale": "米级需部署高密度蓝牙基站；区域级可大幅减少基站数量，极大节约硬件成本与施工布线。"
+          },
+          {
+            "dimension": "form_battery",
+            "question": "被追踪对象的形态是什么（人员佩戴胸卡工牌，还是贴在货物托盘/设备上）？期望续航时间是多久？",
+            "rationale": "决定选用超薄卡片型轻量 Tracker 还是超长续航工业 Tracker。"
+          }
+        ]
+      }
     },
     {
       "id": "industrial-control-automation",
@@ -316,7 +484,34 @@
         "multi_protocol_gateway",
         "smart_hvac_control"
       ],
-      "summary": "采集、联动和看板在本地网关上运行；触屏终端可装在设备旁直接操作。"
+      "summary": "采集、联动和看板在本地网关上运行；触屏终端可装在设备旁直接操作。",
+      "landing_url": "https://www.seeedstudio.com/solutions/industrial-control-automation",
+      "repo_url": "",
+      "diagnostic_playbook": {
+        "domain": "现场控制与自动化 / PLC 边缘互联",
+        "core_dimensions": [
+          "工控总线协议种类",
+          "导轨安装与供电环境",
+          "边缘计算与控制响应周期"
+        ],
+        "questions": [
+          {
+            "dimension": "bus_protocol",
+            "question": "现场下位机设备主要采用什么总线和通信协议（如 Modbus TCP/RTU、CANopen、PROFINET、EtherNet/IP）？",
+            "rationale": "决定边缘网关的物理接口（隔离 RS485、双网口、CAN 接口）以及协议转换中间件配置。"
+          },
+          {
+            "dimension": "cabinet_power",
+            "question": "设备是安装在标准工业电控柜导轨上吗？现场供电是直流 24V DC 还是交流 220V？",
+            "rationale": "确认机型是否支持 DIN 导轨卡扣安装，以及宽压 DC 9~36V 输入。"
+          },
+          {
+            "dimension": "control_cycle",
+            "question": "业务需要做实时控制闭环（毫秒级控制周期），还是做上层数据采集与边缘分析诊断（秒级/分级）？",
+            "rationale": "实时控制需要带实时补丁（PREEMPT_RT）的边缘控制器；数据采集与分析常规工业边缘电脑即可满足。"
+          }
+        ]
+      }
     },
     {
       "id": "industrial-visual-inspection",
@@ -345,7 +540,34 @@
         "edge_inspection_surface",
         "edge_inspection_assembly"
       ],
-      "summary": "工位边缘工控机就地完成实时质检判定且原图不出厂，但高检出率依赖产线真实缺陷样本重训与现场标定。"
+      "summary": "工位边缘工控机就地完成实时质检判定且原图不出厂，但高检出率依赖产线真实缺陷样本重训与现场标定。",
+      "landing_url": "https://www.seeedstudio.com/solutions/industrial-visual-inspection",
+      "repo_url": "",
+      "diagnostic_playbook": {
+        "domain": "工业视觉质检 / 表面缺陷与装配复检",
+        "core_dimensions": [
+          "产线生产节拍与相机快门",
+          "工件材质反光与照明",
+          "剔除执行与 PLC 信号闭环"
+        ],
+        "questions": [
+          {
+            "dimension": "line_speed",
+            "question": "现场流水线的生产节拍是怎样的（每分钟过检多少件产品，工件是静止拍照还是运动中飞拍）？",
+            "rationale": "决定相机曝光类型（运动飞拍必须全局快门 Global Shutter），以及端侧推理帧率与 Jetson 算力等级（Orin Nano vs Orin NX）。"
+          },
+          {
+            "dimension": "materials_lighting",
+            "question": "被测工件表面是什么材质（反光金属、高光塑料还是普通漫反射包装）？缺陷尺寸大概在什么毫米级别？",
+            "rationale": "反光表面需定制特殊工业光源（如偏光环形光、同轴光）消除眩光；缺陷精度决定工业相机分辨率与镜头焦距。"
+          },
+          {
+            "dimension": "plc_integration",
+            "question": "检测出不良品后，边缘设备是否需要直接向现场 PLC 或气缸发送剔除信号？",
+            "rationale": "决定是否需要选择带工业隔离数字量 I/O 的工控机型（如 reComputer Industrial 系列），并配置现场总线。"
+          }
+        ]
+      }
     },
     {
       "id": "intelligent-video-analytics",
@@ -389,7 +611,34 @@
         "edge_retail_recognition",
         "edge_waste_sorting"
       ],
-      "summary": "视频在 AI 摄像头或边缘盒子上本地分析，已有的网络摄像头也能接入。"
+      "summary": "视频在 AI 摄像头或边缘盒子上本地分析，已有的网络摄像头也能接入。",
+      "landing_url": "https://www.seeedstudio.com/solutions/intelligent-video-analytics",
+      "repo_url": "",
+      "diagnostic_playbook": {
+        "domain": "视觉与视频智能 / 通用边缘分析",
+        "core_dimensions": [
+          "分析目标与算法类型",
+          "多路 RTSP 汇聚 vs 独立一体机",
+          "夜间与恶劣环境"
+        ],
+        "questions": [
+          {
+            "dimension": "analytics_target",
+            "question": "主要需要检测什么目标与事件（如人员入侵、未戴安全帽反光衣、车辆违停、还是越界徘徊）？",
+            "rationale": "确定所需模型组合（检测 + 跟踪 + 属性识别）以及对 Jetson 算力大小的要求。"
+          },
+          {
+            "dimension": "stream_architecture",
+            "question": "现场是汇聚已有的多路网络监控摄像头（RTSP 流），还是需要在特定点位新装一体化 AI 相机？",
+            "rationale": "多路集中拉流推荐 reComputer J4012 (Orin NX)，支持 8~16 路视频流实时分析；单点分散推荐一体化智能相机。"
+          },
+          {
+            "dimension": "environment_lighting",
+            "question": "监控场景是否位于室外？夜间是否有照明，还是需要红外夜视/补光灯？",
+            "rationale": "室外点位需确认机壳防护等级（IP66 防水防尘）与低照度夜视传感器支持。"
+          }
+        ]
+      }
     },
     {
       "id": "off-grid-mesh-communication",
@@ -416,7 +665,34 @@
         "sensecap_t1000_tracker"
       ],
       "reference_designs": [],
-      "summary": "LoRa Mesh 节点之间远距离中继消息，定位工牌发送位置与 SOS，手机 APP 查看；需要接云平台时可另配 LoRaWAN 网关。"
+      "summary": "LoRa Mesh 节点之间远距离中继消息，定位工牌发送位置与 SOS，手机 APP 查看；需要接云平台时可另配 LoRaWAN 网关。",
+      "landing_url": "https://www.seeedstudio.com/solutions/off-grid-mesh-communication",
+      "repo_url": "",
+      "diagnostic_playbook": {
+        "domain": "离网与自组网通信 / 应急 Mesh",
+        "core_dimensions": [
+          "地形遮挡与视距",
+          "便携手持 vs 高点中继基站",
+          "地区无线电免许可频段"
+        ],
+        "questions": [
+          {
+            "dimension": "terrain_los",
+            "question": "应急通信的使用环境是在城市建筑物密集区域，还是在无手机信号的野外山区、森林或野营开阔地？",
+            "rationale": "开阔地视距传输可达十几公里；建筑物阻隔多需要规划高点固定中继节点。"
+          },
+          {
+            "dimension": "node_roles",
+            "question": "组网节点主要是人员移动随身携带（如佩戴小巧终端配合手机发文字/位置），还是需要搭建固定的高位信号中继站？",
+            "rationale": "固定高位站需配置大功率玻璃钢天线与太阳能充电套件；随身节点强调便携长续航。"
+          },
+          {
+            "dimension": "rf_frequency",
+            "question": "项目部署在哪个国家或地区？",
+            "rationale": "确认合法的 LoRa 免许可频段，如中国 CN470、欧洲 EU868 或北美 US915，确保无线电合规。"
+          }
+        ]
+      }
     },
     {
       "id": "parking-traffic-vision",
@@ -448,7 +724,34 @@
         "edge-anpr-plate-recognition",
         "parking-space-occupancy-detection"
       ],
-      "summary": "车位检测在端侧相机本地闭环免中心服务器，多路出入口通过边缘主机利旧既有监控且视频不出场。"
+      "summary": "车位检测在端侧相机本地闭环免中心服务器，多路出入口通过边缘主机利旧既有监控且视频不出场。",
+      "landing_url": "https://www.seeedstudio.com/solutions/parking-traffic-vision",
+      "repo_url": "",
+      "diagnostic_playbook": {
+        "domain": "智慧交通 / 园区道闸与车牌识别",
+        "core_dimensions": [
+          "道闸卡口 vs 主干道抓拍",
+          "夜间补光与逆光条件",
+          "继电器开闸联动链路"
+        ],
+        "questions": [
+          {
+            "dimension": "traffic_speed",
+            "question": "抓拍点位是出入口道闸（低速停车抓拍，1~2 车道），还是园区/厂区主干道（车辆行驶中抓拍）？",
+            "rationale": "道闸场景普通高帧率相机即可胜任；行驶干道需全局快门与快速连续跟踪推理算法支持。"
+          },
+          {
+            "dimension": "lighting_condition",
+            "question": "夜间或逆光环境如何？安装点是否有充足照明，还是需要相机自带或外接强光抑制爆闪补光灯？",
+            "rationale": "车牌反光与大灯直射在出入口很常见，强光抑制与补光同步触发至关重要。"
+          },
+          {
+            "dimension": "gate_control",
+            "question": "车牌识别成功后，是需要边缘主机直接通过板载继电器/IO 接口控制道闸开杆，还是仅需通过网络上报给您现有的停车计费系统？",
+            "rationale": "决定是否需要硬件级隔离继电器控制配件，以及是否需要本地脱机白名单离线放行能力。"
+          }
+        ]
+      }
     },
     {
       "id": "smart-restaurant",
@@ -476,7 +779,10 @@
         "xiao_esp32s3"
       ],
       "reference_designs": [],
-      "summary": "餐桌侧的交互在桌面上完成：麦克风阵列听顾客点单，订单直接到后厨；电子纸桌牌显示座位、账单和二维码菜单，断电不丢画面；手势和投影让顾客完全不碰屏幕。算力放在店里，数据不出店。"
+      "summary": "餐桌侧的交互在桌面上完成：麦克风阵列听顾客点单，订单直接到后厨；电子纸桌牌显示座位、账单和二维码菜单，断电不丢画面；手势和投影让顾客完全不碰屏幕。算力放在店里，数据不出店。",
+      "landing_url": "https://www.seeedstudio.com/solutions/smart-restaurant",
+      "repo_url": "",
+      "diagnostic_playbook": null
     },
     {
       "id": "smart-retail-store",
@@ -505,7 +811,34 @@
         "recomputer_r11"
       ],
       "reference_designs": [],
-      "summary": "专为商超与便利店设计的端侧 AI 视觉硬件：就地完成客流热力与货架盘点且视频不出店，断网仍可刷脸门禁。"
+      "summary": "专为商超与便利店设计的端侧 AI 视觉硬件：就地完成客流热力与货架盘点且视频不出店，断网仍可刷脸门禁。",
+      "landing_url": "https://www.seeedstudio.com/solutions/smart-retail-store",
+      "repo_url": "",
+      "diagnostic_playbook": {
+        "domain": "智慧零售门店 / 客流统计与货架动线",
+        "core_dimensions": [
+          "进出店客流计数 vs 店内热力动线",
+          "门头吊顶施工布线",
+          "多门店数据汇聚方式"
+        ],
+        "questions": [
+          {
+            "dimension": "analytics_scope",
+            "question": "统计的主要诉求是“出入口进店人数/客流双向计数”，还是“店内各货架区域的顾客停留时长与热力分布”？",
+            "rationale": "出入口仅需门头单台垂直俯视 AI 相机；货架热力需广角全景相机或多机拼接。"
+          },
+          {
+            "dimension": "ceiling_cabling",
+            "question": "现场安装点位（通常在门头吊顶或天花板）是否预留了网线和供电？",
+            "rationale": "支持 PoE 供电只需一根网线即可完成供电与通信，最利于商铺免破坏装修快速施工。"
+          },
+          {
+            "dimension": "data_aggregation",
+            "question": "连锁门店的数据汇总方式是怎样的？是单店本地显示，还是需要将多店客流数据自动上传到您的总部云端或 ERP 系统？",
+            "rationale": "确认网络上报协议（MQTT/HTTP REST）及离线断网本地缓存需求。"
+          }
+        ]
+      }
     },
     {
       "id": "smart-warehouse-management",
@@ -534,7 +867,34 @@
       "reference_designs": [
         "smart_warehouse"
       ],
-      "summary": "Watcher 听懂指令并识别操作人，结果写入内置仓管系统或已有 ERP / WMS；可选云端、本地主机或完全离线部署。"
+      "summary": "Watcher 听懂指令并识别操作人，结果写入内置仓管系统或已有 ERP / WMS；可选云端、本地主机或完全离线部署。",
+      "landing_url": "https://www.seeedstudio.com/solutions/smart-warehouse-management",
+      "repo_url": "",
+      "diagnostic_playbook": {
+        "domain": "智慧仓库管理 / 货位状态与托盘盘点",
+        "core_dimensions": [
+          "货架结构与无线遮挡",
+          "货位占空感知 vs 条码盘点",
+          "库区网络覆盖"
+        ],
+        "questions": [
+          {
+            "dimension": "rack_structure",
+            "question": "仓库的货物存储形式是托盘平库、高位重型货架还是自动化立体仓？货架高度大概多高？",
+            "rationale": "高位货架钢结构遮挡严重，需针对性设计相机俯视视角或工业无线天线布设。"
+          },
+          {
+            "dimension": "perception_mode",
+            "question": "核心诉求是“货位占用与空闲状态检测”（有货/无货），还是“具体托盘/货物条码精准盘点”？",
+            "rationale": "货位空闲检测推荐边缘视觉一体机俯视感知；托盘精准身份盘点需结合 RFID 或蓝牙 Asset Tag。"
+          },
+          {
+            "dimension": "network_coverage",
+            "question": "库区内是否具备完整的有线网络或 Wi-Fi 覆盖？",
+            "rationale": "无网络覆盖时需要配置长距离 LoRaWAN 或 4G 无线网关回传数据。"
+          }
+        ]
+      }
     },
     {
       "id": "voicecollectionanalysis",
@@ -566,7 +926,10 @@
       "reference_designs": [
         "retail_voice"
       ],
-      "summary": "固定点位对话在端侧直接转成结构化文本，音频不出店。员工随身佩戴录音的场景见「线下客户对话分析」。"
+      "summary": "固定点位对话在端侧直接转成结构化文本，音频不出店。员工随身佩戴录音的场景见「线下客户对话分析」。",
+      "landing_url": "https://www.seeedstudio.com/solutions/voicecollectionanalysis",
+      "repo_url": "",
+      "diagnostic_playbook": null
     },
     {
       "id": "whole-home-smart-living",
@@ -608,7 +971,10 @@
         "edge_security",
         "home-assistant-local-voice-hub"
       ],
-      "summary": "所有设备接入同一台本地 Home Assistant 主机，自动化规则在本地运行。"
+      "summary": "所有设备接入同一台本地 Home Assistant 主机，自动化规则在本地运行。",
+      "landing_url": "https://www.seeedstudio.com/solutions/whole-home-smart-living",
+      "repo_url": "",
+      "diagnostic_playbook": null
     }
   ],
   "reference_designs": [
@@ -623,11 +989,38 @@
         "en": "Put SenseCAP soil and air sensors on a Home Assistant dashboard — through the SenseCAP cloud, or through a LoRaWAN network server you run yourself with no internet at all."
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/agri_env_monitor",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/agri_env_monitor",
       "presets": [
         "cloud",
         "tts_local",
         "chirpstack_local"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "智慧农业 / 环境监测与微气象",
+        "core_dimensions": [
+          "集中大棚 vs 广域农田",
+          "市电 vs 太阳能/电池供电",
+          "监测指标与探头深度"
+        ],
+        "questions": [
+          {
+            "dimension": "topology",
+            "question": "监测区域是集中式连栋温室大棚（百米级），还是大面积户外大田/果园（数公里级）？",
+            "rationale": "大棚内百米级可采用 RS485 有线总线集中组网；广域大田推荐 LoRaWAN 远距离低功耗无线传输，配合 SenseCAP M2 网关。"
+          },
+          {
+            "dimension": "power",
+            "question": "现场测点是否有 220V 市电供电，还是需要野外太阳能板/锂电池长续航供电？",
+            "rationale": "市电可支持持续高频数据上报；无市电需要选用带内置超大锂电池、支持休眠唤醒的低功耗无线传感器（如 S2100/S210x）。"
+          },
+          {
+            "dimension": "sensing_depth",
+            "question": "需要监测哪些核心环境指标？仅是空气温湿度/光照/CO2，还是包括土壤剖面墒情（深层水分/EC/pH）或气象风速风向？",
+            "rationale": "决定是配置一体化多合一微气象站（如 S700/S2120），还是选配工业级土壤三参数/水肥专用探针与变送器。"
+          }
+        ]
+      }
     },
     {
       "id": "ai_lab",
@@ -640,11 +1033,14 @@
         "en": "## What This Reference Design Is\n\n**Three kinds of AI model to try on one Rockchip box.**\n\nObject detection, text chat and image Q&A all run on the built-in NPU.\n\nPick a preset, deploy with one click, and call the API. Detection is REST; chat is OpenAI-compatible.\n\nAll three presets can share one RK3576 box. Existing cameras, NVRs or chat apps connect by changing an address.\n\nImages and conversations stay on the device, and it runs offline after deployment.\n\n**Limits:** chat and vision chat need the reComputer RK3576 Series. 7B chat and vision chat need 8GB of RAM or more.\n"
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/ai_lab",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/ai_lab",
       "presets": [
         "object_detection",
         "llm_chat",
         "vlm_chat"
-      ]
+      ],
+      "diagnostic_playbook": null
     },
     {
       "id": "conversational_voice_ai",
@@ -657,10 +1053,37 @@
         "en": "A voice terminal that answers on the device and can be interrupted mid-answer. Listening and speaking stay local; the conversation model is either your own cloud endpoint or on-device. Runs on a reComputer RK, a reComputer J30 / J40 (Orin) or a reComputer R2000 series, with the conversation language fixed at deploy time."
       },
       "wiki_url": "https://wiki.seeedstudio.com/solutions/conversational-voice-ai/",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/conversational_voice_ai",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/conversational_voice_ai",
       "presets": [
         "cloud_llm",
         "local_llm"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "声学与音频 AI / 设备故障听诊",
+        "core_dimensions": [
+          "被测机械类型与异响特征",
+          "声学麦克风 vs 振动声发射传感器",
+          "车间环境背景噪音"
+        ],
+        "questions": [
+          {
+            "dimension": "machine_defect",
+            "question": "被监测的机械设备是什么（例如电机、轴承、齿轮箱、还是水泵压缩机）？想捕获的异常特征是什么（异响磨损、撞击声还是高压气体泄漏）？",
+            "rationale": "决定选择声学麦克风阵列还是接触式高频振动/声发射探头。"
+          },
+          {
+            "dimension": "ambient_noise",
+            "question": "设备周边是否有其他强烈机械运转的背景杂音？",
+            "rationale": "强背景杂音需利用端侧硬件 DSP 滤波器及降噪算法将工作主频滤除，突出异常脉冲。"
+          },
+          {
+            "dimension": "alarm_latency",
+            "question": "检测到异响异常后，希望在多长时间内告警，并通过何种方式通知维护人员？",
+            "rationale": "确定边缘推理实时性要求以及告警输出联动链路（声光/短信/PLC 停机信号）。"
+          }
+        ]
+      }
     },
     {
       "id": "depth_anything_v3",
@@ -673,9 +1096,12 @@
         "en": "## What This Reference Design Is\n\n**Distance estimates from an ordinary USB camera.** The depth model runs on the Jetson GPU.\n\nThe output is one video stream showing the original picture, a colour depth map and a 3D point cloud together. Any RTSP player or the platform preview can show it.\n\nDeployment is one click over SSH. The first deploy builds the inference engine on the device; restarts reuse it.\n\nThe stream stays on the LAN, and it runs offline after deployment.\n\n**Limits:** depth is estimated by a single-camera model. It suits prototypes and demos, not lidar-grade ranging.\n"
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/depth_anything_v3",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/depth_anything_v3",
       "presets": [
         "jetson_depth"
-      ]
+      ],
+      "diagnostic_playbook": null
     },
     {
       "id": "edge-anpr-plate-recognition",
@@ -688,7 +1114,34 @@
         "en": ""
       },
       "wiki_url": "",
-      "presets": []
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/edge-anpr-plate-recognition",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/edge-anpr-plate-recognition",
+      "presets": [],
+      "diagnostic_playbook": {
+        "domain": "智慧交通 / 园区道闸与车牌识别",
+        "core_dimensions": [
+          "道闸卡口 vs 主干道抓拍",
+          "夜间补光与逆光条件",
+          "继电器开闸联动链路"
+        ],
+        "questions": [
+          {
+            "dimension": "traffic_speed",
+            "question": "抓拍点位是出入口道闸（低速停车抓拍，1~2 车道），还是园区/厂区主干道（车辆行驶中抓拍）？",
+            "rationale": "道闸场景普通高帧率相机即可胜任；行驶干道需全局快门与快速连续跟踪推理算法支持。"
+          },
+          {
+            "dimension": "lighting_condition",
+            "question": "夜间或逆光环境如何？安装点是否有充足照明，还是需要相机自带或外接强光抑制爆闪补光灯？",
+            "rationale": "车牌反光与大灯直射在出入口很常见，强光抑制与补光同步触发至关重要。"
+          },
+          {
+            "dimension": "gate_control",
+            "question": "车牌识别成功后，是需要边缘主机直接通过板载继电器/IO 接口控制道闸开杆，还是仅需通过网络上报给您现有的停车计费系统？",
+            "rationale": "决定是否需要硬件级隔离继电器控制配件，以及是否需要本地脱机白名单离线放行能力。"
+          }
+        ]
+      }
     },
     {
       "id": "edge_inspection_assembly",
@@ -701,11 +1154,38 @@
         "en": "Missing-part and dimension inspection on the edge device. One fixed camera per station checks the expected items and the measured sizes, and merges them into a single OK/NG verdict that reaches the PLC and the MES at the same time. Runs on a reComputer J30 / J40 (Orin) or on a reComputer R2000 Series with the Hailo-8 option (R2035-12)."
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/edge_inspection_assembly",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/edge_inspection_assembly",
       "presets": [
         "jetson",
         "hailo",
         "recamera_pro"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "工业视觉质检 / 表面缺陷与装配复检",
+        "core_dimensions": [
+          "产线生产节拍与相机快门",
+          "工件材质反光与照明",
+          "剔除执行与 PLC 信号闭环"
+        ],
+        "questions": [
+          {
+            "dimension": "line_speed",
+            "question": "现场流水线的生产节拍是怎样的（每分钟过检多少件产品，工件是静止拍照还是运动中飞拍）？",
+            "rationale": "决定相机曝光类型（运动飞拍必须全局快门 Global Shutter），以及端侧推理帧率与 Jetson 算力等级（Orin Nano vs Orin NX）。"
+          },
+          {
+            "dimension": "materials_lighting",
+            "question": "被测工件表面是什么材质（反光金属、高光塑料还是普通漫反射包装）？缺陷尺寸大概在什么毫米级别？",
+            "rationale": "反光表面需定制特殊工业光源（如偏光环形光、同轴光）消除眩光；缺陷精度决定工业相机分辨率与镜头焦距。"
+          },
+          {
+            "dimension": "plc_integration",
+            "question": "检测出不良品后，边缘设备是否需要直接向现场 PLC 或气缸发送剔除信号？",
+            "rationale": "决定是否需要选择带工业隔离数字量 I/O 的工控机型（如 reComputer Industrial 系列），并配置现场总线。"
+          }
+        ]
+      }
     },
     {
       "id": "edge_inspection_surface",
@@ -718,10 +1198,37 @@
         "en": "Steel surface defect inspection that runs on the edge device: a fixed camera on the strip or the part, one OK/NG verdict per frame, delivered to the PLC and to the MES at the same time. Runs on a reComputer J30 / J40 (Orin) or on a reComputer R2000 Series with the Hailo-8 option (R2035-12)."
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/edge_inspection_surface",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/edge_inspection_surface",
       "presets": [
         "orin",
         "pi_hailo"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "工业视觉质检 / 表面缺陷与装配复检",
+        "core_dimensions": [
+          "产线生产节拍与相机快门",
+          "工件材质反光与照明",
+          "剔除执行与 PLC 信号闭环"
+        ],
+        "questions": [
+          {
+            "dimension": "line_speed",
+            "question": "现场流水线的生产节拍是怎样的（每分钟过检多少件产品，工件是静止拍照还是运动中飞拍）？",
+            "rationale": "决定相机曝光类型（运动飞拍必须全局快门 Global Shutter），以及端侧推理帧率与 Jetson 算力等级（Orin Nano vs Orin NX）。"
+          },
+          {
+            "dimension": "materials_lighting",
+            "question": "被测工件表面是什么材质（反光金属、高光塑料还是普通漫反射包装）？缺陷尺寸大概在什么毫米级别？",
+            "rationale": "反光表面需定制特殊工业光源（如偏光环形光、同轴光）消除眩光；缺陷精度决定工业相机分辨率与镜头焦距。"
+          },
+          {
+            "dimension": "plc_integration",
+            "question": "检测出不良品后，边缘设备是否需要直接向现场 PLC 或气缸发送剔除信号？",
+            "rationale": "决定是否需要选择带工业隔离数字量 I/O 的工控机型（如 reComputer Industrial 系列），并配置现场总线。"
+          }
+        ]
+      }
     },
     {
       "id": "edge_retail_recognition",
@@ -734,11 +1241,38 @@
         "en": "## What This Reference Design Is\n\n**A camera reads the products on a shelf or a checkout belt.**\n\nIt boxes every item, then looks each one up in a product library to see which it is.\n\nAt the checkout each item is counted once. On the shelf every slot is reported as ok, empty, wrong item or unknown.\n\nAdding a product needs no retraining: photograph it 3 to 8 times and upload.\n\n**Limits:** an item has to be fully visible — occluded or stacked goods are missed. Each SKU needs at least three enrolment photos.\n\nChanging the embedding model rebuilds the whole library. The shipped weights are licensed for non-commercial use only.\n"
       },
       "wiki_url": "https://wiki.seeedstudio.com/solutions/edge-product-recognition/",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/edge_retail_recognition",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/edge_retail_recognition",
       "presets": [
         "p1_rockchip",
         "p2_pi5_hailo",
         "p3_jetson_orin"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "视觉与视频智能 / 通用边缘分析",
+        "core_dimensions": [
+          "分析目标与算法类型",
+          "多路 RTSP 汇聚 vs 独立一体机",
+          "夜间与恶劣环境"
+        ],
+        "questions": [
+          {
+            "dimension": "analytics_target",
+            "question": "主要需要检测什么目标与事件（如人员入侵、未戴安全帽反光衣、车辆违停、还是越界徘徊）？",
+            "rationale": "确定所需模型组合（检测 + 跟踪 + 属性识别）以及对 Jetson 算力大小的要求。"
+          },
+          {
+            "dimension": "stream_architecture",
+            "question": "现场是汇聚已有的多路网络监控摄像头（RTSP 流），还是需要在特定点位新装一体化 AI 相机？",
+            "rationale": "多路集中拉流推荐 reComputer J4012 (Orin NX)，支持 8~16 路视频流实时分析；单点分散推荐一体化智能相机。"
+          },
+          {
+            "dimension": "environment_lighting",
+            "question": "监控场景是否位于室外？夜间是否有照明，还是需要红外夜视/补光灯？",
+            "rationale": "室外点位需确认机壳防护等级（IP66 防水防尘）与低照度夜视传感器支持。"
+          }
+        ]
+      }
     },
     {
       "id": "edge_security",
@@ -751,12 +1285,39 @@
         "en": "Restricted-zone, line-crossing and loitering alerts judged on the edge box itself. Draw rules in a browser, watch the wall, clear alerts. Video stays on site."
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/edge_security",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/edge_security",
       "presets": [
         "jetson_hub",
         "rk3588",
         "hailo",
         "hub_only"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "视觉与视频智能 / 通用边缘分析",
+        "core_dimensions": [
+          "分析目标与算法类型",
+          "多路 RTSP 汇聚 vs 独立一体机",
+          "夜间与恶劣环境"
+        ],
+        "questions": [
+          {
+            "dimension": "analytics_target",
+            "question": "主要需要检测什么目标与事件（如人员入侵、未戴安全帽反光衣、车辆违停、还是越界徘徊）？",
+            "rationale": "确定所需模型组合（检测 + 跟踪 + 属性识别）以及对 Jetson 算力大小的要求。"
+          },
+          {
+            "dimension": "stream_architecture",
+            "question": "现场是汇聚已有的多路网络监控摄像头（RTSP 流），还是需要在特定点位新装一体化 AI 相机？",
+            "rationale": "多路集中拉流推荐 reComputer J4012 (Orin NX)，支持 8~16 路视频流实时分析；单点分散推荐一体化智能相机。"
+          },
+          {
+            "dimension": "environment_lighting",
+            "question": "监控场景是否位于室外？夜间是否有照明，还是需要红外夜视/补光灯？",
+            "rationale": "室外点位需确认机壳防护等级（IP66 防水防尘）与低照度夜视传感器支持。"
+          }
+        ]
+      }
     },
     {
       "id": "edge_waste_sorting",
@@ -769,13 +1330,40 @@
         "en": "Trigger a shot at the bin and get back what the item is made of and which of the four Chinese municipal waste streams it belongs in — one MQTT message per item, decided on the device, plus a GPIO output for a flap or a lane indicator."
       },
       "wiki_url": "https://wiki.seeedstudio.com/solutions/edge-waste-sorting/",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/edge_waste_sorting",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/edge_waste_sorting",
       "presets": [
         "orin",
         "recomputer_r20",
         "recamera",
         "recamera_pro",
         "recomputer_rk3588"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "视觉与视频智能 / 通用边缘分析",
+        "core_dimensions": [
+          "分析目标与算法类型",
+          "多路 RTSP 汇聚 vs 独立一体机",
+          "夜间与恶劣环境"
+        ],
+        "questions": [
+          {
+            "dimension": "analytics_target",
+            "question": "主要需要检测什么目标与事件（如人员入侵、未戴安全帽反光衣、车辆违停、还是越界徘徊）？",
+            "rationale": "确定所需模型组合（检测 + 跟踪 + 属性识别）以及对 Jetson 算力大小的要求。"
+          },
+          {
+            "dimension": "stream_architecture",
+            "question": "现场是汇聚已有的多路网络监控摄像头（RTSP 流），还是需要在特定点位新装一体化 AI 相机？",
+            "rationale": "多路集中拉流推荐 reComputer J4012 (Orin NX)，支持 8~16 路视频流实时分析；单点分散推荐一体化智能相机。"
+          },
+          {
+            "dimension": "environment_lighting",
+            "question": "监控场景是否位于室外？夜间是否有照明，还是需要红外夜视/补光灯？",
+            "rationale": "室外点位需确认机壳防护等级（IP66 防水防尘）与低照度夜视传感器支持。"
+          }
+        ]
+      }
     },
     {
       "id": "fall_detection",
@@ -788,13 +1376,40 @@
         "en": "On-device fall detection — pose estimation, a per-person temporal state machine and one MQTT event, all local. All-in-one camera, or your existing RTSP cameras on a Jetson, Rockchip NPU or Hailo-8 host."
       },
       "wiki_url": "https://wiki.seeedstudio.com/solutions/edge-fall-detection/",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/fall_detection",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/fall_detection",
       "presets": [
         "recamera",
         "recamera_pro",
         "jetson",
         "rk",
         "hailo"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "智慧养老 / 室内监护",
+        "core_dimensions": [
+          "集中 vs 分散空间分布",
+          "存量摄像头利旧",
+          "隐私保护与传感器形态"
+        ],
+        "questions": [
+          {
+            "dimension": "topology",
+            "question": "老人房间和公共区域是在同一层/同一楼栋比较集中，还是分散在多栋楼或较远区域？",
+            "rationale": "集中分布可用 1 台 reComputer 主机拉多路 RTSP 流摊薄成本；分散点位推荐每间房独立 reCamera 一体机免拉长线。"
+          },
+          {
+            "dimension": "asset_reuse",
+            "question": "现场是否已经安装了支持 RTSP/ONVIF 协议的监控摄像头（如海康、大华等）？",
+            "rationale": "已有摄像头可直接复用利旧，只需采购边缘算力盒，省去镜头重购成本；无摄像头则推荐成套硬件。"
+          },
+          {
+            "dimension": "privacy_boundary",
+            "question": "卫生间、卧室等高隐私区域是否对纯光学摄像头有顾虑，是否需要无视觉隐私的毫米波雷达方案？",
+            "rationale": "私密区域用 60GHz 毫米波雷达替代光学镜头，既可精确检测跌倒卧床，又彻底消除侵犯隐私争议。"
+          }
+        ]
+      }
     },
     {
       "id": "gpt_oss_20b",
@@ -807,9 +1422,12 @@
         "en": "## What This Reference Design Is\n\n**A 20-billion-parameter chat model on one Jetson.** No cloud and no cloud API key.\n\nDeployment opens an OpenAI-compatible API. Existing SDKs, chat apps or the OpenClaw gateway connect by changing an address.\n\nConversations travel only between your app and the device, and it runs offline after deployment.\n\nContext length and GPU layers are deploy-time settings.\n\n**Limits:** it needs the Orin NX 16GB module. The default context is 1024 tokens, and the first request after deployment warms up for a few minutes.\n"
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/gpt_oss_20b",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/gpt_oss_20b",
       "presets": [
         "jetson_got_oss"
-      ]
+      ],
+      "diagnostic_playbook": null
     },
     {
       "id": "gun_detection_frigate",
@@ -822,10 +1440,37 @@
         "en": "## What This Reference Design Is\n\n**Gun detection for the IP cameras you already have.** One edge AI host checks every frame. It raises an alert when a gun appears.\n\nEach detection saves a clip and a snapshot. Events play back in the web dashboard.\n\nAlerts go out over MQTT, so alarm and automation systems can subscribe.\n\nVideo is processed and stored on a host inside your network, not in the cloud. The host is a Jetson or a Hailo box.\n\n**Limits:** detection depends on how large and visible the gun is in the frame. This is an assistive alert, not a certified security product.\n"
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/gun_detection_frigate",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/gun_detection_frigate",
       "presets": [
         "jetson",
         "r2000_hailo"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "视觉与视频智能 / 通用边缘分析",
+        "core_dimensions": [
+          "分析目标与算法类型",
+          "多路 RTSP 汇聚 vs 独立一体机",
+          "夜间与恶劣环境"
+        ],
+        "questions": [
+          {
+            "dimension": "analytics_target",
+            "question": "主要需要检测什么目标与事件（如人员入侵、未戴安全帽反光衣、车辆违停、还是越界徘徊）？",
+            "rationale": "确定所需模型组合（检测 + 跟踪 + 属性识别）以及对 Jetson 算力大小的要求。"
+          },
+          {
+            "dimension": "stream_architecture",
+            "question": "现场是汇聚已有的多路网络监控摄像头（RTSP 流），还是需要在特定点位新装一体化 AI 相机？",
+            "rationale": "多路集中拉流推荐 reComputer J4012 (Orin NX)，支持 8~16 路视频流实时分析；单点分散推荐一体化智能相机。"
+          },
+          {
+            "dimension": "environment_lighting",
+            "question": "监控场景是否位于室外？夜间是否有照明，还是需要红外夜视/补光灯？",
+            "rationale": "室外点位需确认机壳防护等级（IP66 防水防尘）与低照度夜视传感器支持。"
+          }
+        ]
+      }
     },
     {
       "id": "home-assistant-local-voice-hub",
@@ -838,9 +1483,12 @@
         "en": ""
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/home-assistant-local-voice-hub",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/home-assistant-local-voice-hub",
       "presets": [
         "rpi_jetson"
-      ]
+      ],
+      "diagnostic_playbook": null
     },
     {
       "id": "indoor_positioning_ble_lorawan",
@@ -853,11 +1501,38 @@
         "en": "Track assets and people indoors and outdoors on one map — BLE beacons inside, GNSS outside, with floor-plan georeferencing, geofence alarms and an offline basemap option."
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/indoor_positioning_ble_lorawan",
+      "repo_url": "https://github.com/Seeed-Solution/Solution_IndoorPositioning_H5",
       "presets": [
         "starter",
         "standard",
         "enterprise"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "室内外定位 / 资产与人员追踪",
+        "core_dimensions": [
+          "纯室内 vs 室内外混合",
+          "定位精度期望（米级 vs 区域级）",
+          "佩戴形式与免维护续航"
+        ],
+        "questions": [
+          {
+            "dimension": "spatial_scope",
+            "question": "定位场景是纯室内（厂房/展厅/仓库），还是室内外混合（比如仓库到室外堆场，甚至货物长途运输）？",
+            "rationale": "纯室内基于 BLE 信标定位；室内外混合推荐 SenseCAP T1000 追踪器，室内切蓝牙/Wi-Fi 定位，室外切 GPS/北斗。"
+          },
+          {
+            "dimension": "accuracy_budget",
+            "question": "对定位精度的期望是怎样的？是需要精确到米级的具体坐标，还是只要知道人在哪间房/资产在哪个货架区域即可？",
+            "rationale": "米级需部署高密度蓝牙基站；区域级可大幅减少基站数量，极大节约硬件成本与施工布线。"
+          },
+          {
+            "dimension": "form_battery",
+            "question": "被追踪对象的形态是什么（人员佩戴胸卡工牌，还是贴在货物托盘/设备上）？期望续航时间是多久？",
+            "rationale": "决定选用超薄卡片型轻量 Tracker 还是超长续航工业 Tracker。"
+          }
+        ]
+      }
     },
     {
       "id": "jetson_voice_assistant",
@@ -870,9 +1545,12 @@
         "en": "A local speech service for your own application — send audio in and get text back, send text in and get speech back. Runs on reComputer J40 / J30, reComputer RK3588 / RK3576 or Pi 5, offline after the first deployment."
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/jetson_voice_assistant",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/jetson_voice_assistant",
       "presets": [
         "default"
-      ]
+      ],
+      "diagnostic_playbook": null
     },
     {
       "id": "multi_protocol_gateway",
@@ -885,9 +1563,36 @@
         "en": "## What This Reference Design Is\n\n**It merges four field protocols into one interface.**\n\nThe gateway talks to OPC UA, Modbus, BACnet and MQTT devices at once. The system above integrates once, not once per controller.\n\nSite differences become configuration: scan for devices, confirm which readings you want, then expose them. It manages up to 2,000 readings, 50 of them writable.\n\nEvery write is traceable: what was sent, what the device answered, and when it finished.\n\n**Limits:** a point the scan finds is confirmed on site before it is exposed. Serial devices need a different deployment profile, and production writes stay disabled until commissioning passes.\n"
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/multi_protocol_gateway",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/multi_protocol_gateway",
       "presets": [
         "standard"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "旧建筑节能改造 / 暖通与智能抄表",
+        "core_dimensions": [
+          "存量表计通信接口",
+          "配电间集中 vs 跨楼层分布",
+          "纯能耗采集 vs 闭环控制"
+        ],
+        "questions": [
+          {
+            "dimension": "meter_interface",
+            "question": "现场的电表、水表或空调机组目前是什么型号？是否自带 RS485（Modbus RTU / DL/T 645）通信接口，还是老旧机械表？",
+            "rationale": "带 485 接口可直接低成本手拉手总线抄表；无通信接口的老旧机械表需更换智能表或加装开口式开口互感器 CT。"
+          },
+          {
+            "dimension": "cable_distribution",
+            "question": "表计是集中在配电室/机房，还是分散在各楼层的强电井中？各楼层之间是否有现成弱电网线贯通？",
+            "rationale": "集中点位直接用有线网关接总线；跨楼层分散无布线推荐 SenseCAP LoRaWAN 采集器无线回传，大幅削减施工穿墙打洞成本。"
+          },
+          {
+            "dimension": "control_requirement",
+            "question": "需求是仅做“能耗监测与数据统计”，还是需要做“闭环节能控制”（如根据峰谷电价或人员在场调节空调回路）？",
+            "rationale": "决定是否需要配置带工业继电器与模拟量输出的控制型网关。"
+          }
+        ]
+      }
     },
     {
       "id": "openclaw_deploy",
@@ -900,10 +1605,13 @@
         "en": "## What This Reference Design Is\n\n**One AI assistant shared by more than 20 chat platforms.** WeChat, Telegram, Slack, DingTalk and Feishu all connect.\n\nThe gateway runs on your own reComputer. There is one integration to maintain; models and platforms change in the gateway.\n\nTwo routes are available. A Jetson runs the model locally, so message content is not sent to an AI provider. A lightweight host uses cloud models, paid per call.\n\n**Limits:** local models are small, 2B to 4B. On the cloud route, message content goes to the provider you configure.\n"
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/openclaw_deploy",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/openclaw_deploy",
       "presets": [
         "openclaw_basic",
         "openclaw_recomputer_r"
-      ]
+      ],
+      "diagnostic_playbook": null
     },
     {
       "id": "parking-entry-exit-counting",
@@ -916,9 +1624,36 @@
         "en": ""
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/parking-entry-exit-counting",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/parking-entry-exit-counting",
       "presets": [
         "ip_camera_box"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "智慧交通 / 园区道闸与车牌识别",
+        "core_dimensions": [
+          "道闸卡口 vs 主干道抓拍",
+          "夜间补光与逆光条件",
+          "继电器开闸联动链路"
+        ],
+        "questions": [
+          {
+            "dimension": "traffic_speed",
+            "question": "抓拍点位是出入口道闸（低速停车抓拍，1~2 车道），还是园区/厂区主干道（车辆行驶中抓拍）？",
+            "rationale": "道闸场景普通高帧率相机即可胜任；行驶干道需全局快门与快速连续跟踪推理算法支持。"
+          },
+          {
+            "dimension": "lighting_condition",
+            "question": "夜间或逆光环境如何？安装点是否有充足照明，还是需要相机自带或外接强光抑制爆闪补光灯？",
+            "rationale": "车牌反光与大灯直射在出入口很常见，强光抑制与补光同步触发至关重要。"
+          },
+          {
+            "dimension": "gate_control",
+            "question": "车牌识别成功后，是需要边缘主机直接通过板载继电器/IO 接口控制道闸开杆，还是仅需通过网络上报给您现有的停车计费系统？",
+            "rationale": "决定是否需要硬件级隔离继电器控制配件，以及是否需要本地脱机白名单离线放行能力。"
+          }
+        ]
+      }
     },
     {
       "id": "parking-space-occupancy-detection",
@@ -931,9 +1666,36 @@
         "en": ""
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/parking-space-occupancy-detection",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/parking-space-occupancy-detection",
       "presets": [
         "ip_camera_box"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "智慧交通 / 园区道闸与车牌识别",
+        "core_dimensions": [
+          "道闸卡口 vs 主干道抓拍",
+          "夜间补光与逆光条件",
+          "继电器开闸联动链路"
+        ],
+        "questions": [
+          {
+            "dimension": "traffic_speed",
+            "question": "抓拍点位是出入口道闸（低速停车抓拍，1~2 车道），还是园区/厂区主干道（车辆行驶中抓拍）？",
+            "rationale": "道闸场景普通高帧率相机即可胜任；行驶干道需全局快门与快速连续跟踪推理算法支持。"
+          },
+          {
+            "dimension": "lighting_condition",
+            "question": "夜间或逆光环境如何？安装点是否有充足照明，还是需要相机自带或外接强光抑制爆闪补光灯？",
+            "rationale": "车牌反光与大灯直射在出入口很常见，强光抑制与补光同步触发至关重要。"
+          },
+          {
+            "dimension": "gate_control",
+            "question": "车牌识别成功后，是需要边缘主机直接通过板载继电器/IO 接口控制道闸开杆，还是仅需通过网络上报给您现有的停车计费系统？",
+            "rationale": "决定是否需要硬件级隔离继电器控制配件，以及是否需要本地脱机白名单离线放行能力。"
+          }
+        ]
+      }
     },
     {
       "id": "people_counting",
@@ -946,7 +1708,10 @@
         "en": ""
       },
       "wiki_url": "",
-      "presets": []
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/people_counting",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/people_counting",
+      "presets": [],
+      "diagnostic_playbook": null
     },
     {
       "id": "reachy_claw_voice_robot",
@@ -959,11 +1724,38 @@
         "en": "## What This Reference Design Is\n\n**A Reachy Mini desktop robot that listens, replies and moves with emotion.**\n\nSpeech recognition, speech synthesis and the conversation model run on a Jetson. While replying, the robot shows 14 emotions through head motion and antenna poses.\n\nWhen nobody speaks, monologue mode has it talk to itself, for trade-show demos.\n\nAfter deployment it runs offline. Voice, camera frames and the conversation do not pass through a cloud service.\n\n**Limits:** replies come from a local 4B-class model with narrower knowledge than a cloud model. It is not suited to customer commitments, medical or safety questions.\n"
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/reachy_claw_voice_robot",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/reachy_claw_voice_robot",
       "presets": [
         "jetson",
         "r2000_hailo",
         "cm4"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "声学与音频 AI / 设备故障听诊",
+        "core_dimensions": [
+          "被测机械类型与异响特征",
+          "声学麦克风 vs 振动声发射传感器",
+          "车间环境背景噪音"
+        ],
+        "questions": [
+          {
+            "dimension": "machine_defect",
+            "question": "被监测的机械设备是什么（例如电机、轴承、齿轮箱、还是水泵压缩机）？想捕获的异常特征是什么（异响磨损、撞击声还是高压气体泄漏）？",
+            "rationale": "决定选择声学麦克风阵列还是接触式高频振动/声发射探头。"
+          },
+          {
+            "dimension": "ambient_noise",
+            "question": "设备周边是否有其他强烈机械运转的背景杂音？",
+            "rationale": "强背景杂音需利用端侧硬件 DSP 滤波器及降噪算法将工作主频滤除，突出异常脉冲。"
+          },
+          {
+            "dimension": "alarm_latency",
+            "question": "检测到异响异常后，希望在多长时间内告警，并通过何种方式通知维护人员？",
+            "rationale": "确定边缘推理实时性要求以及告警输出联动链路（声光/短信/PLC 停机信号）。"
+          }
+        ]
+      }
     },
     {
       "id": "recamera_depth_estimation",
@@ -976,9 +1768,12 @@
         "en": ""
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/recamera_depth_estimation",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/recamera_depth_estimation",
       "presets": [
         "default"
-      ]
+      ],
+      "diagnostic_playbook": null
     },
     {
       "id": "recamera_ecosystem",
@@ -991,10 +1786,37 @@
         "en": "## What This Reference Design Is\n\n**One AI camera; apps install and switch in the browser.**\n\nThe gallery has 9 apps, including object detection, text reading and fall detection.\n\nInference runs on the camera, and video and results stay on the local network.\n\nDetections are published over MQTT, and entities appear in Home Assistant on their own. Video goes out over RTSP to an NVR or player.\n\nYour computer downloads the apps; the camera itself needs no internet.\n\n**Limits:** one camera runs one app at a time. Detection quality depends on placement, light and distance; check it on the live preview before going live.\n"
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/recamera_ecosystem",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/recamera_ecosystem",
       "presets": [
         "recamera",
         "recamera_pro"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "视觉与视频智能 / 通用边缘分析",
+        "core_dimensions": [
+          "分析目标与算法类型",
+          "多路 RTSP 汇聚 vs 独立一体机",
+          "夜间与恶劣环境"
+        ],
+        "questions": [
+          {
+            "dimension": "analytics_target",
+            "question": "主要需要检测什么目标与事件（如人员入侵、未戴安全帽反光衣、车辆违停、还是越界徘徊）？",
+            "rationale": "确定所需模型组合（检测 + 跟踪 + 属性识别）以及对 Jetson 算力大小的要求。"
+          },
+          {
+            "dimension": "stream_architecture",
+            "question": "现场是汇聚已有的多路网络监控摄像头（RTSP 流），还是需要在特定点位新装一体化 AI 相机？",
+            "rationale": "多路集中拉流推荐 reComputer J4012 (Orin NX)，支持 8~16 路视频流实时分析；单点分散推荐一体化智能相机。"
+          },
+          {
+            "dimension": "environment_lighting",
+            "question": "监控场景是否位于室外？夜间是否有照明，还是需要红外夜视/补光灯？",
+            "rationale": "室外点位需确认机壳防护等级（IP66 防水防尘）与低照度夜视传感器支持。"
+          }
+        ]
+      }
     },
     {
       "id": "recamera_heatmap_grafana",
@@ -1007,13 +1829,40 @@
         "en": "## What This Reference Design Is\n\n**A people-flow heatmap for your store.** Cameras locate shoppers, showing which shelves draw people and which aisles stay empty.\n\nDwell states and entry and exit counts are recorded too. Trends are kept by hour, day and week on a dashboard.\n\nThe heatmap can sit on your floor plan, with several cameras sharing one plan.\n\nUse a single reCamera, or keep existing IP cameras and add one AI host. Video is processed on site; the backend stores numbers only.\n\n**Limits:** cameras must be mounted high, looking down. The heatmap shows where people are, not who they are.\n"
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/recamera_heatmap_grafana",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/recamera_heatmap_grafana",
       "presets": [
         "recamera",
         "recamera_pro",
         "rk",
         "hailo",
         "jetson"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "视觉与视频智能 / 通用边缘分析",
+        "core_dimensions": [
+          "分析目标与算法类型",
+          "多路 RTSP 汇聚 vs 独立一体机",
+          "夜间与恶劣环境"
+        ],
+        "questions": [
+          {
+            "dimension": "analytics_target",
+            "question": "主要需要检测什么目标与事件（如人员入侵、未戴安全帽反光衣、车辆违停、还是越界徘徊）？",
+            "rationale": "确定所需模型组合（检测 + 跟踪 + 属性识别）以及对 Jetson 算力大小的要求。"
+          },
+          {
+            "dimension": "stream_architecture",
+            "question": "现场是汇聚已有的多路网络监控摄像头（RTSP 流），还是需要在特定点位新装一体化 AI 相机？",
+            "rationale": "多路集中拉流推荐 reComputer J4012 (Orin NX)，支持 8~16 路视频流实时分析；单点分散推荐一体化智能相机。"
+          },
+          {
+            "dimension": "environment_lighting",
+            "question": "监控场景是否位于室外？夜间是否有照明，还是需要红外夜视/补光灯？",
+            "rationale": "室外点位需确认机壳防护等级（IP66 防水防尘）与低照度夜视传感器支持。"
+          }
+        ]
+      }
     },
     {
       "id": "recamera_onvif_nvr",
@@ -1026,9 +1875,12 @@
         "en": ""
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/recamera_onvif_nvr",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/recamera_onvif_nvr",
       "presets": [
         "recamera_2002"
-      ]
+      ],
+      "diagnostic_playbook": null
     },
     {
       "id": "recamera_parking_monitor",
@@ -1041,9 +1893,12 @@
         "en": "## What This Reference Design Is\n\n**One reCamera watching a row of parking spots.** It shows live which spots are free and which are taken.\n\nNo sensor per spot is needed. Free spots show green, taken spots red, with a free-spot count.\n\nA spot changes state only after 15 frames agree, so passers-by and shadows do not trigger it.\n\nDetection and the dashboard run on the camera, with no server. Any phone or laptop on the same network opens it in a browser.\n\n**Limits:** designed for three adjacent spots per camera in a front view. Works best in good light.\n"
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/recamera_parking_monitor",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/recamera_parking_monitor",
       "presets": [
         "default"
-      ]
+      ],
+      "diagnostic_playbook": null
     },
     {
       "id": "recamera_sheep_counter_lora",
@@ -1056,9 +1911,12 @@
         "en": "## What This Reference Design Is\n\n**Automatic sheep counting at the paddock gate.** A reCamera counts sheep going in and out. It keeps IN, OUT and INSIDE totals.\n\nCounts travel over LoRa radio, so the gate needs no WiFi or mobile signal.\n\nA gateway at the farmhouse feeds a Home Assistant dashboard with 24-hour history. The phone app can notify on each crossing.\n\nAfter a radio gap, a heartbeat every 15 minutes brings the totals back in sync.\n\n**Limits:** sheep must cross the count line in view; a tight bunch can be undercounted. Radio distance varies with terrain.\n"
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/recamera_sheep_counter_lora",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/recamera_sheep_counter_lora",
       "presets": [
         "lora_gateway"
-      ]
+      ],
+      "diagnostic_playbook": null
     },
     {
       "id": "respeaker_flex_soarm",
@@ -1071,9 +1929,12 @@
         "en": "Talk to a SO-ARM101 robotic arm. Say the wake word and a command; the arm replies through a speaker and performs the matching gesture. Speech, the language model and arm control all run on one reComputer J40 (Orin NX 16GB), with no cloud API."
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/respeaker_flex_soarm",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/respeaker_flex_soarm",
       "presets": [
         "default"
-      ]
+      ],
+      "diagnostic_playbook": null
     },
     {
       "id": "retail_voice",
@@ -1086,10 +1947,37 @@
         "en": "Store, meeting, consultation speech becomes back-office text. Mic array and on-site transcriber, or reSpeaker Clip and phone. Names, numbers masked before storage, deletable on request."
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/retail_voice",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/retail_voice",
       "presets": [
         "local_transcribe",
         "cloud_stack"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "声学与音频 AI / 设备故障听诊",
+        "core_dimensions": [
+          "被测机械类型与异响特征",
+          "声学麦克风 vs 振动声发射传感器",
+          "车间环境背景噪音"
+        ],
+        "questions": [
+          {
+            "dimension": "machine_defect",
+            "question": "被监测的机械设备是什么（例如电机、轴承、齿轮箱、还是水泵压缩机）？想捕获的异常特征是什么（异响磨损、撞击声还是高压气体泄漏）？",
+            "rationale": "决定选择声学麦克风阵列还是接触式高频振动/声发射探头。"
+          },
+          {
+            "dimension": "ambient_noise",
+            "question": "设备周边是否有其他强烈机械运转的背景杂音？",
+            "rationale": "强背景杂音需利用端侧硬件 DSP 滤波器及降噪算法将工作主频滤除，突出异常脉冲。"
+          },
+          {
+            "dimension": "alarm_latency",
+            "question": "检测到异响异常后，希望在多长时间内告警，并通过何种方式通知维护人员？",
+            "rationale": "确定边缘推理实时性要求以及告警输出联动链路（声光/短信/PLC 停机信号）。"
+          }
+        ]
+      }
     },
     {
       "id": "sensecraft_data_mcp",
@@ -1102,9 +1990,12 @@
         "en": "## What This Reference Design Is\n\n**Ask out loud and hear how your SenseCAP devices are doing.** No app and no dashboard.\n\nAsk for an overview and hear who is offline or low on battery first. Name a device and hear its current readings.\n\nAn always-on Docker host runs the bridge, reads from the platform and dials out to a XiaoZhi voice assistant. Any MCP-capable AI also works.\n\nThe bridge opens no port, and credentials are entered only at deployment.\n\n**Limits:** devices must already report to the SenseCAP platform, and the host needs internet access.\n"
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/sensecraft_data_mcp",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/sensecraft_data_mcp",
       "presets": [
         "default"
-      ]
+      ],
+      "diagnostic_playbook": null
     },
     {
       "id": "smart-badge-voice-transcription",
@@ -1117,9 +2008,12 @@
         "en": ""
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/smart-badge-voice-transcription",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/smart-badge-voice-transcription",
       "presets": [
         "clip_edge_box"
-      ]
+      ],
+      "diagnostic_playbook": null
     },
     {
       "id": "smart_hvac_control",
@@ -1132,9 +2026,36 @@
         "en": "Bring HVAC controller points and an energy meter into one point model, predict setpoints from the building's own history, and write them back only after a readback from the field matches — with rollback and alarms when it does not."
       },
       "wiki_url": "https://wiki.seeedstudio.com/solutions/hvac-setpoint-control/",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/smart_hvac_control",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/smart_hvac_control",
       "presets": [
         "default"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "旧建筑节能改造 / 暖通与智能抄表",
+        "core_dimensions": [
+          "存量表计通信接口",
+          "配电间集中 vs 跨楼层分布",
+          "纯能耗采集 vs 闭环控制"
+        ],
+        "questions": [
+          {
+            "dimension": "meter_interface",
+            "question": "现场的电表、水表或空调机组目前是什么型号？是否自带 RS485（Modbus RTU / DL/T 645）通信接口，还是老旧机械表？",
+            "rationale": "带 485 接口可直接低成本手拉手总线抄表；无通信接口的老旧机械表需更换智能表或加装开口式开口互感器 CT。"
+          },
+          {
+            "dimension": "cable_distribution",
+            "question": "表计是集中在配电室/机房，还是分散在各楼层的强电井中？各楼层之间是否有现成弱电网线贯通？",
+            "rationale": "集中点位直接用有线网关接总线；跨楼层分散无布线推荐 SenseCAP LoRaWAN 采集器无线回传，大幅削减施工穿墙打洞成本。"
+          },
+          {
+            "dimension": "control_requirement",
+            "question": "需求是仅做“能耗监测与数据统计”，还是需要做“闭环节能控制”（如根据峰谷电价或人员在场调节空调回路）？",
+            "rationale": "决定是否需要配置带工业继电器与模拟量输出的控制型网关。"
+          }
+        ]
+      }
     },
     {
       "id": "smart_space_assistant",
@@ -1147,11 +2068,38 @@
         "en": "## What This Reference Design Is\n\n**A Xiaozhi voice assistant that recognises people and shows the conversation on a large screen.**\n\nThe terminal's camera recognises registered people and greets them by name. Recognition runs inside the terminal, and the face list of up to 20 people stays on the device.\n\nA display service on a host in the local network shows the conversation live on an HDMI TV or monitor.\n\nFace recognition and display casting install separately and do not affect each other.\n\n**Limits:** it works best in normal indoor light with a frontal face. No field accuracy test is part of this design, so it is not suited to access control or attendance.\n"
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/smart_space_assistant",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/smart_space_assistant",
       "presets": [
         "reterminal_d1001",
         "display_cast",
         "face_recognition"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "旧建筑节能改造 / 暖通与智能抄表",
+        "core_dimensions": [
+          "存量表计通信接口",
+          "配电间集中 vs 跨楼层分布",
+          "纯能耗采集 vs 闭环控制"
+        ],
+        "questions": [
+          {
+            "dimension": "meter_interface",
+            "question": "现场的电表、水表或空调机组目前是什么型号？是否自带 RS485（Modbus RTU / DL/T 645）通信接口，还是老旧机械表？",
+            "rationale": "带 485 接口可直接低成本手拉手总线抄表；无通信接口的老旧机械表需更换智能表或加装开口式开口互感器 CT。"
+          },
+          {
+            "dimension": "cable_distribution",
+            "question": "表计是集中在配电室/机房，还是分散在各楼层的强电井中？各楼层之间是否有现成弱电网线贯通？",
+            "rationale": "集中点位直接用有线网关接总线；跨楼层分散无布线推荐 SenseCAP LoRaWAN 采集器无线回传，大幅削减施工穿墙打洞成本。"
+          },
+          {
+            "dimension": "control_requirement",
+            "question": "需求是仅做“能耗监测与数据统计”，还是需要做“闭环节能控制”（如根据峰谷电价或人员在场调节空调回路）？",
+            "rationale": "决定是否需要配置带工业继电器与模拟量输出的控制型网关。"
+          }
+        ]
+      }
     },
     {
       "id": "smart_warehouse",
@@ -1164,13 +2112,40 @@
         "en": "Voice-controlled warehouse management on edge hardware — speak the transaction, MCP writes it to inventory. Five tiers, from cloud trial to a fully offline Jetson deployment."
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/smart_warehouse",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/smart_warehouse",
       "presets": [
         "trial",
         "sensecraft_cloud",
         "private_cloud",
         "private_cloud_multi",
         "edge_computing"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "声学与音频 AI / 设备故障听诊",
+        "core_dimensions": [
+          "被测机械类型与异响特征",
+          "声学麦克风 vs 振动声发射传感器",
+          "车间环境背景噪音"
+        ],
+        "questions": [
+          {
+            "dimension": "machine_defect",
+            "question": "被监测的机械设备是什么（例如电机、轴承、齿轮箱、还是水泵压缩机）？想捕获的异常特征是什么（异响磨损、撞击声还是高压气体泄漏）？",
+            "rationale": "决定选择声学麦克风阵列还是接触式高频振动/声发射探头。"
+          },
+          {
+            "dimension": "ambient_noise",
+            "question": "设备周边是否有其他强烈机械运转的背景杂音？",
+            "rationale": "强背景杂音需利用端侧硬件 DSP 滤波器及降噪算法将工作主频滤除，突出异常脉冲。"
+          },
+          {
+            "dimension": "alarm_latency",
+            "question": "检测到异响异常后，希望在多长时间内告警，并通过何种方式通知维护人员？",
+            "rationale": "确定边缘推理实时性要求以及告警输出联动链路（声光/短信/PLC 停机信号）。"
+          }
+        ]
+      }
     },
     {
       "id": "unmanned_store_access",
@@ -1183,11 +2158,38 @@
         "en": "## What This Reference Design Is\n\n**Face access control for a door nobody stands behind.**\n\nThe camera recognises a face and checks it is a real person, not a photo. It then checks the roster and the time window before opening.\n\nEvery entry and refusal is recorded and cannot be altered.\n\nThe face list is edited in the cloud and fetched by the device. A failed fetch keeps the old list, so the door still opens offline.\n\nRecognition and liveness accuracy follow the face model you deploy, so measure them on your own site.\n\n**Limits:** the person faces the camera within its working distance, and a mask or strong backlight leads to a refusal. This is a base to build on, not a certified security product.\n"
       },
       "wiki_url": "https://wiki.seeedstudio.com/solutions/unmanned-store-face-access/",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/unmanned_store_access",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/unmanned_store_access",
       "presets": [
         "a_ai_camera",
         "a_recamera_std",
         "b_ai_host"
-      ]
+      ],
+      "diagnostic_playbook": {
+        "domain": "视觉与视频智能 / 通用边缘分析",
+        "core_dimensions": [
+          "分析目标与算法类型",
+          "多路 RTSP 汇聚 vs 独立一体机",
+          "夜间与恶劣环境"
+        ],
+        "questions": [
+          {
+            "dimension": "analytics_target",
+            "question": "主要需要检测什么目标与事件（如人员入侵、未戴安全帽反光衣、车辆违停、还是越界徘徊）？",
+            "rationale": "确定所需模型组合（检测 + 跟踪 + 属性识别）以及对 Jetson 算力大小的要求。"
+          },
+          {
+            "dimension": "stream_architecture",
+            "question": "现场是汇聚已有的多路网络监控摄像头（RTSP 流），还是需要在特定点位新装一体化 AI 相机？",
+            "rationale": "多路集中拉流推荐 reComputer J4012 (Orin NX)，支持 8~16 路视频流实时分析；单点分散推荐一体化智能相机。"
+          },
+          {
+            "dimension": "environment_lighting",
+            "question": "监控场景是否位于室外？夜间是否有照明，还是需要红外夜视/补光灯？",
+            "rationale": "室外点位需确认机壳防护等级（IP66 防水防尘）与低照度夜视传感器支持。"
+          }
+        ]
+      }
     },
     {
       "id": "voice_rebot_arm",
@@ -1200,9 +2202,12 @@
         "en": "Say \"Hey Jarvis, grab the water bottle\" and a reBot B601-DM arm finds the object with its wrist depth camera, picks it up and brings it back in about 11 seconds. Speech, the language model, detection and grasp planning all run on one reComputer J40 (Orin NX 16GB), with no cloud API."
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/voice_rebot_arm",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/voice_rebot_arm",
       "presets": [
         "default"
-      ]
+      ],
+      "diagnostic_playbook": null
     },
     {
       "id": "voice_robot_lekiwi",
@@ -1215,9 +2220,12 @@
         "en": "Drive a three-wheeled LeKiwi robot by voice. Say \"Hey Jarvis\" and a command in English; the robot replies and moves forward, back, sideways or turns. Speech recognition, the language model and the voice reply run on Groq's cloud API, so the robot needs internet."
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/voice_robot_lekiwi",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/voice_robot_lekiwi",
       "presets": [
         "default"
-      ]
+      ],
+      "diagnostic_playbook": null
     },
     {
       "id": "z_image_turbo",
@@ -1230,9 +2238,12 @@
         "en": "## What This Reference Design Is\n\n**Image generation on one Jetson.**\n\nSend a description and get a PNG, or add a prompt to a reference image to edit it.\n\nOn Orin NX 16GB, a 512px image takes about 100 s. One request runs at a time; the rest queue.\n\nApps call the HTTP API over the LAN. Prompts and images stay on the device, fully offline after deployment.\n\n**Limits:** generation is not real time. The first deploy downloads about 20GB of weights and about 12GB of inference engine.\n"
       },
       "wiki_url": "",
+      "landing_url": "https://www.seeedstudio.com/solutions/reference-designs/z_image_turbo",
+      "repo_url": "https://github.com/suharvest/sensecraft-solutions/tree/main/solutions/z_image_turbo",
       "presets": [
         "jetson_image_gen"
-      ]
+      ],
+      "diagnostic_playbook": null
     }
   ],
   "product_families": {
@@ -7966,5 +8977,332 @@
       },
       "audio_interface": "USB Audio Class 1.0 / 2.0, 4-mic linear array"
     }
+  },
+  "diagnostic_playbooks": {
+    "elderly-care-monitoring": {
+      "domain": "智慧养老 / 室内监护",
+      "core_dimensions": [
+        "集中 vs 分散空间分布",
+        "存量摄像头利旧",
+        "隐私保护与传感器形态"
+      ],
+      "questions": [
+        {
+          "dimension": "topology",
+          "question": "老人房间和公共区域是在同一层/同一楼栋比较集中，还是分散在多栋楼或较远区域？",
+          "rationale": "集中分布可用 1 台 reComputer 主机拉多路 RTSP 流摊薄成本；分散点位推荐每间房独立 reCamera 一体机免拉长线。"
+        },
+        {
+          "dimension": "asset_reuse",
+          "question": "现场是否已经安装了支持 RTSP/ONVIF 协议的监控摄像头（如海康、大华等）？",
+          "rationale": "已有摄像头可直接复用利旧，只需采购边缘算力盒，省去镜头重购成本；无摄像头则推荐成套硬件。"
+        },
+        {
+          "dimension": "privacy_boundary",
+          "question": "卫生间、卧室等高隐私区域是否对纯光学摄像头有顾虑，是否需要无视觉隐私的毫米波雷达方案？",
+          "rationale": "私密区域用 60GHz 毫米波雷达替代光学镜头，既可精确检测跌倒卧床，又彻底消除侵犯隐私争议。"
+        }
+      ]
+    },
+    "environment-monitoring": {
+      "domain": "智慧农业 / 环境监测与微气象",
+      "core_dimensions": [
+        "集中大棚 vs 广域农田",
+        "市电 vs 太阳能/电池供电",
+        "监测指标与探头深度"
+      ],
+      "questions": [
+        {
+          "dimension": "topology",
+          "question": "监测区域是集中式连栋温室大棚（百米级），还是大面积户外大田/果园（数公里级）？",
+          "rationale": "大棚内百米级可采用 RS485 有线总线集中组网；广域大田推荐 LoRaWAN 远距离低功耗无线传输，配合 SenseCAP M2 网关。"
+        },
+        {
+          "dimension": "power",
+          "question": "现场测点是否有 220V 市电供电，还是需要野外太阳能板/锂电池长续航供电？",
+          "rationale": "市电可支持持续高频数据上报；无市电需要选用带内置超大锂电池、支持休眠唤醒的低功耗无线传感器（如 S2100/S210x）。"
+        },
+        {
+          "dimension": "sensing_depth",
+          "question": "需要监测哪些核心环境指标？仅是空气温湿度/光照/CO2，还是包括土壤剖面墒情（深层水分/EC/pH）或气象风速风向？",
+          "rationale": "决定是配置一体化多合一微气象站（如 S700/S2120），还是选配工业级土壤三参数/水肥专用探针与变送器。"
+        }
+      ]
+    },
+    "industrial-visual-inspection": {
+      "domain": "工业视觉质检 / 表面缺陷与装配复检",
+      "core_dimensions": [
+        "产线生产节拍与相机快门",
+        "工件材质反光与照明",
+        "剔除执行与 PLC 信号闭环"
+      ],
+      "questions": [
+        {
+          "dimension": "line_speed",
+          "question": "现场流水线的生产节拍是怎样的（每分钟过检多少件产品，工件是静止拍照还是运动中飞拍）？",
+          "rationale": "决定相机曝光类型（运动飞拍必须全局快门 Global Shutter），以及端侧推理帧率与 Jetson 算力等级（Orin Nano vs Orin NX）。"
+        },
+        {
+          "dimension": "materials_lighting",
+          "question": "被测工件表面是什么材质（反光金属、高光塑料还是普通漫反射包装）？缺陷尺寸大概在什么毫米级别？",
+          "rationale": "反光表面需定制特殊工业光源（如偏光环形光、同轴光）消除眩光；缺陷精度决定工业相机分辨率与镜头焦距。"
+        },
+        {
+          "dimension": "plc_integration",
+          "question": "检测出不良品后，边缘设备是否需要直接向现场 PLC 或气缸发送剔除信号？",
+          "rationale": "决定是否需要选择带工业隔离数字量 I/O 的工控机型（如 reComputer Industrial 系列），并配置现场总线。"
+        }
+      ]
+    },
+    "parking-traffic-vision": {
+      "domain": "智慧交通 / 园区道闸与车牌识别",
+      "core_dimensions": [
+        "道闸卡口 vs 主干道抓拍",
+        "夜间补光与逆光条件",
+        "继电器开闸联动链路"
+      ],
+      "questions": [
+        {
+          "dimension": "traffic_speed",
+          "question": "抓拍点位是出入口道闸（低速停车抓拍，1~2 车道），还是园区/厂区主干道（车辆行驶中抓拍）？",
+          "rationale": "道闸场景普通高帧率相机即可胜任；行驶干道需全局快门与快速连续跟踪推理算法支持。"
+        },
+        {
+          "dimension": "lighting_condition",
+          "question": "夜间或逆光环境如何？安装点是否有充足照明，还是需要相机自带或外接强光抑制爆闪补光灯？",
+          "rationale": "车牌反光与大灯直射在出入口很常见，强光抑制与补光同步触发至关重要。"
+        },
+        {
+          "dimension": "gate_control",
+          "question": "车牌识别成功后，是需要边缘主机直接通过板载继电器/IO 接口控制道闸开杆，还是仅需通过网络上报给您现有的停车计费系统？",
+          "rationale": "决定是否需要硬件级隔离继电器控制配件，以及是否需要本地脱机白名单离线放行能力。"
+        }
+      ]
+    },
+    "conversational-voice-ai": {
+      "domain": "现场语音控制 / 离线语音助手",
+      "core_dimensions": [
+        "声学噪声与麦克风拾音距离",
+        "100% 离线隐私 vs 云端大模型",
+        "受控设备联动协议"
+      ],
+      "questions": [
+        {
+          "dimension": "acoustic_environment",
+          "question": "现场使用环境的噪音如何？通常是在安静的室内/会议室，还是存在环境背景噪音（如风扇、空调、人群嘈杂）？拾音距离多远？",
+          "rationale": "决定麦克风阵列选型：近场安静可用双麦；远场（3~5米）与嘈杂环境必须使用带硬件 DSP、回声消除 AEC 与波束成形的 ReSpeaker XVF3800 多麦阵列。"
+        },
+        {
+          "dimension": "privacy_connectivity",
+          "question": "系统对网络和隐私有什么硬性要求？是必须 100% 纯本地离线断网运行，还是可以联网访问云端大模型？",
+          "rationale": "纯离线需配置 Orin NX 等中高算力主机在端侧跑端到端小模型（Whisper + LLM + TTS）；联网混合模式可用轻量主机做前端拾音上云。"
+        },
+        {
+          "dimension": "target_control",
+          "question": "语音识别或大模型理解后，主要用来控制什么设备或执行什么业务？",
+          "rationale": "明确南向控制接口：是对接 Home Assistant 智能家居、发送 MQTT 报文、还是通过串口/Modbus 控制工业继电器。"
+        }
+      ]
+    },
+    "building-energy-retrofit": {
+      "domain": "旧建筑节能改造 / 暖通与智能抄表",
+      "core_dimensions": [
+        "存量表计通信接口",
+        "配电间集中 vs 跨楼层分布",
+        "纯能耗采集 vs 闭环控制"
+      ],
+      "questions": [
+        {
+          "dimension": "meter_interface",
+          "question": "现场的电表、水表或空调机组目前是什么型号？是否自带 RS485（Modbus RTU / DL/T 645）通信接口，还是老旧机械表？",
+          "rationale": "带 485 接口可直接低成本手拉手总线抄表；无通信接口的老旧机械表需更换智能表或加装开口式开口互感器 CT。"
+        },
+        {
+          "dimension": "cable_distribution",
+          "question": "表计是集中在配电室/机房，还是分散在各楼层的强电井中？各楼层之间是否有现成弱电网线贯通？",
+          "rationale": "集中点位直接用有线网关接总线；跨楼层分散无布线推荐 SenseCAP LoRaWAN 采集器无线回传，大幅削减施工穿墙打洞成本。"
+        },
+        {
+          "dimension": "control_requirement",
+          "question": "需求是仅做“能耗监测与数据统计”，还是需要做“闭环节能控制”（如根据峰谷电价或人员在场调节空调回路）？",
+          "rationale": "决定是否需要配置带工业继电器与模拟量输出的控制型网关。"
+        }
+      ]
+    },
+    "indoor-outdoor-positioning": {
+      "domain": "室内外定位 / 资产与人员追踪",
+      "core_dimensions": [
+        "纯室内 vs 室内外混合",
+        "定位精度期望（米级 vs 区域级）",
+        "佩戴形式与免维护续航"
+      ],
+      "questions": [
+        {
+          "dimension": "spatial_scope",
+          "question": "定位场景是纯室内（厂房/展厅/仓库），还是室内外混合（比如仓库到室外堆场，甚至货物长途运输）？",
+          "rationale": "纯室内基于 BLE 信标定位；室内外混合推荐 SenseCAP T1000 追踪器，室内切蓝牙/Wi-Fi 定位，室外切 GPS/北斗。"
+        },
+        {
+          "dimension": "accuracy_budget",
+          "question": "对定位精度的期望是怎样的？是需要精确到米级的具体坐标，还是只要知道人在哪间房/资产在哪个货架区域即可？",
+          "rationale": "米级需部署高密度蓝牙基站；区域级可大幅减少基站数量，极大节约硬件成本与施工布线。"
+        },
+        {
+          "dimension": "form_battery",
+          "question": "被追踪对象的形态是什么（人员佩戴胸卡工牌，还是贴在货物托盘/设备上）？期望续航时间是多久？",
+          "rationale": "决定选用超薄卡片型轻量 Tracker 还是超长续航工业 Tracker。"
+        }
+      ]
+    },
+    "industrial-control-automation": {
+      "domain": "现场控制与自动化 / PLC 边缘互联",
+      "core_dimensions": [
+        "工控总线协议种类",
+        "导轨安装与供电环境",
+        "边缘计算与控制响应周期"
+      ],
+      "questions": [
+        {
+          "dimension": "bus_protocol",
+          "question": "现场下位机设备主要采用什么总线和通信协议（如 Modbus TCP/RTU、CANopen、PROFINET、EtherNet/IP）？",
+          "rationale": "决定边缘网关的物理接口（隔离 RS485、双网口、CAN 接口）以及协议转换中间件配置。"
+        },
+        {
+          "dimension": "cabinet_power",
+          "question": "设备是安装在标准工业电控柜导轨上吗？现场供电是直流 24V DC 还是交流 220V？",
+          "rationale": "确认机型是否支持 DIN 导轨卡扣安装，以及宽压 DC 9~36V 输入。"
+        },
+        {
+          "dimension": "control_cycle",
+          "question": "业务需要做实时控制闭环（毫秒级控制周期），还是做上层数据采集与边缘分析诊断（秒级/分级）？",
+          "rationale": "实时控制需要带实时补丁（PREEMPT_RT）的边缘控制器；数据采集与分析常规工业边缘电脑即可满足。"
+        }
+      ]
+    },
+    "smart-warehouse-management": {
+      "domain": "智慧仓库管理 / 货位状态与托盘盘点",
+      "core_dimensions": [
+        "货架结构与无线遮挡",
+        "货位占空感知 vs 条码盘点",
+        "库区网络覆盖"
+      ],
+      "questions": [
+        {
+          "dimension": "rack_structure",
+          "question": "仓库的货物存储形式是托盘平库、高位重型货架还是自动化立体仓？货架高度大概多高？",
+          "rationale": "高位货架钢结构遮挡严重，需针对性设计相机俯视视角或工业无线天线布设。"
+        },
+        {
+          "dimension": "perception_mode",
+          "question": "核心诉求是“货位占用与空闲状态检测”（有货/无货），还是“具体托盘/货物条码精准盘点”？",
+          "rationale": "货位空闲检测推荐边缘视觉一体机俯视感知；托盘精准身份盘点需结合 RFID 或蓝牙 Asset Tag。"
+        },
+        {
+          "dimension": "network_coverage",
+          "question": "库区内是否具备完整的有线网络或 Wi-Fi 覆盖？",
+          "rationale": "无网络覆盖时需要配置长距离 LoRaWAN 或 4G 无线网关回传数据。"
+        }
+      ]
+    },
+    "smart-retail-store": {
+      "domain": "智慧零售门店 / 客流统计与货架动线",
+      "core_dimensions": [
+        "进出店客流计数 vs 店内热力动线",
+        "门头吊顶施工布线",
+        "多门店数据汇聚方式"
+      ],
+      "questions": [
+        {
+          "dimension": "analytics_scope",
+          "question": "统计的主要诉求是“出入口进店人数/客流双向计数”，还是“店内各货架区域的顾客停留时长与热力分布”？",
+          "rationale": "出入口仅需门头单台垂直俯视 AI 相机；货架热力需广角全景相机或多机拼接。"
+        },
+        {
+          "dimension": "ceiling_cabling",
+          "question": "现场安装点位（通常在门头吊顶或天花板）是否预留了网线和供电？",
+          "rationale": "支持 PoE 供电只需一根网线即可完成供电与通信，最利于商铺免破坏装修快速施工。"
+        },
+        {
+          "dimension": "data_aggregation",
+          "question": "连锁门店的数据汇总方式是怎样的？是单店本地显示，还是需要将多店客流数据自动上传到您的总部云端或 ERP 系统？",
+          "rationale": "确认网络上报协议（MQTT/HTTP REST）及离线断网本地缓存需求。"
+        }
+      ]
+    },
+    "off-grid-mesh-communication": {
+      "domain": "离网与自组网通信 / 应急 Mesh",
+      "core_dimensions": [
+        "地形遮挡与视距",
+        "便携手持 vs 高点中继基站",
+        "地区无线电免许可频段"
+      ],
+      "questions": [
+        {
+          "dimension": "terrain_los",
+          "question": "应急通信的使用环境是在城市建筑物密集区域，还是在无手机信号的野外山区、森林或野营开阔地？",
+          "rationale": "开阔地视距传输可达十几公里；建筑物阻隔多需要规划高点固定中继节点。"
+        },
+        {
+          "dimension": "node_roles",
+          "question": "组网节点主要是人员移动随身携带（如佩戴小巧终端配合手机发文字/位置），还是需要搭建固定的高位信号中继站？",
+          "rationale": "固定高位站需配置大功率玻璃钢天线与太阳能充电套件；随身节点强调便携长续航。"
+        },
+        {
+          "dimension": "rf_frequency",
+          "question": "项目部署在哪个国家或地区？",
+          "rationale": "确认合法的 LoRa 免许可频段，如中国 CN470、欧洲 EU868 或北美 US915，确保无线电合规。"
+        }
+      ]
+    },
+    "acoustic-audio-ai": {
+      "domain": "声学与音频 AI / 设备故障听诊",
+      "core_dimensions": [
+        "被测机械类型与异响特征",
+        "声学麦克风 vs 振动声发射传感器",
+        "车间环境背景噪音"
+      ],
+      "questions": [
+        {
+          "dimension": "machine_defect",
+          "question": "被监测的机械设备是什么（例如电机、轴承、齿轮箱、还是水泵压缩机）？想捕获的异常特征是什么（异响磨损、撞击声还是高压气体泄漏）？",
+          "rationale": "决定选择声学麦克风阵列还是接触式高频振动/声发射探头。"
+        },
+        {
+          "dimension": "ambient_noise",
+          "question": "设备周边是否有其他强烈机械运转的背景杂音？",
+          "rationale": "强背景杂音需利用端侧硬件 DSP 滤波器及降噪算法将工作主频滤除，突出异常脉冲。"
+        },
+        {
+          "dimension": "alarm_latency",
+          "question": "检测到异响异常后，希望在多长时间内告警，并通过何种方式通知维护人员？",
+          "rationale": "确定边缘推理实时性要求以及告警输出联动链路（声光/短信/PLC 停机信号）。"
+        }
+      ]
+    },
+    "intelligent-video-analytics": {
+      "domain": "视觉与视频智能 / 通用边缘分析",
+      "core_dimensions": [
+        "分析目标与算法类型",
+        "多路 RTSP 汇聚 vs 独立一体机",
+        "夜间与恶劣环境"
+      ],
+      "questions": [
+        {
+          "dimension": "analytics_target",
+          "question": "主要需要检测什么目标与事件（如人员入侵、未戴安全帽反光衣、车辆违停、还是越界徘徊）？",
+          "rationale": "确定所需模型组合（检测 + 跟踪 + 属性识别）以及对 Jetson 算力大小的要求。"
+        },
+        {
+          "dimension": "stream_architecture",
+          "question": "现场是汇聚已有的多路网络监控摄像头（RTSP 流），还是需要在特定点位新装一体化 AI 相机？",
+          "rationale": "多路集中拉流推荐 reComputer J4012 (Orin NX)，支持 8~16 路视频流实时分析；单点分散推荐一体化智能相机。"
+        },
+        {
+          "dimension": "environment_lighting",
+          "question": "监控场景是否位于室外？夜间是否有照明，还是需要红外夜视/补光灯？",
+          "rationale": "室外点位需确认机壳防护等级（IP66 防水防尘）与低照度夜视传感器支持。"
+        }
+      ]
+    }
   }
 }