MemRelay/projects/6f47523e-e22e-4cdd-bd18-76e5e474ee0c/核心架构与技术选型.md

title, type, permalink, stable_id, scope, memory_type, project_id, usage_profile_id, status, revision, request_id, created_at, updated_at, tags

title	type	permalink	stable_id	scope	memory_type	project_id	usage_profile_id	status	revision	request_id	created_at	updated_at	tags
核心架构与技术选型	decision	main/projects/6f47523e-e22e-4cdd-bd18-76e5e474ee0c/核心架构与技术选型	7687d956-f904-4629-bd5d-4f5b55ec2b84	project	decision	6f47523e-e22e-4cdd-bd18-76e5e474ee0c	7aee455b-24cc-4008-bdaf-443721e6f939	active	1	migrate-decision-01	2026-08-12T17:20:43.326366+00:00	2026-08-12T17:20:43.326366+00:00	architecture decisions

1. 构建源码：选择 Qosmio openwrt-ipq 25.12-nss，而非官方 OpenWrt，因为它提供 AX9000 IPQ807x 设备支持和 NSS 数据平面加速。
2. Docker 构建隔离：Docker 容器中编译，避免污染主机环境；命名卷 openwrt-build-work 保留增量构建缓存（>50GB）。
3. FastAPI + Vue 3：分离前后端，后端负责构建任务编排、配置校验和产物服务，前端提供可视化操作界面。
4. 大分区布局：将 Qosmio 双 UBI 布局改为单 rootfs 232 MiB，最大化可用空间，配合暗云 U-Boot。
5. 设备侧硬件控制：自研 luci-app-ax900-hardware，通过 Linux hwmon 和 LED 子系统提供温控/风扇/RGB 控制，而非使用第三方工具。
6. 单设备专注：后端有 profile 抽象，但 ZIP 名、分区修补和默认文本仍固定 AX9000，扩展第二设备需进一步拆分。