MemRelay/projects/6f47523e-e22e-4cdd-bd18-76e5e474ee0c/curated/development/Ax9000WRTBuild – System Architecture Overview.md

title, type, permalink, stable_id, scope, project_id, workspace_type, usage_profile_id, preference_context, document_type, revision, source_memory_ids, source_checkpoint_ids, source_file_ids, source_git_commit, source_git_commits, source_agent_sync_ids, model_connection, model_name, source_count, source_revisions, source_dispositions, cited_source_ids, job_cited_source_ids, conflicts, supersedes, preferences, source_cursor, source_hash, prompt_version, schema_version, curation_job_id, created_at, updated_at, tags, restored_from_commit

title	type	permalink	stable_id	scope	project_id	workspace_type	usage_profile_id	preference_context	document_type	revision	source_memory_ids	source_checkpoint_ids	source_file_ids	source_git_commit	source_git_commits	source_agent_sync_ids	model_connection	model_name	source_count	source_revisions	source_dispositions	cited_source_ids	job_cited_source_ids	conflicts	supersedes	preferences	source_cursor	source_hash	prompt_version	schema_version	curation_job_id	created_at	updated_at	tags	restored_from_commit
Ax9000WRTBuild – System Architecture Overview	curated	main/projects/6f47523e-e22e-4cdd-bd18-76e5e474ee0c/curated/development/ax9000-wrtbuild-system-architecture-overview	ac351f5e-5eb7-4752-8666-56550b5b2130	project	6f47523e-e22e-4cdd-bd18-76e5e474ee0c	general	null	general	architecture	1				c62e79c3b986262321aa4242f0ece56c4629ae0e	c62e79c3b986262321aa4242f0ece56c4629ae0e		Sub2API	git-restore	81		processed unchanged unsupported skipped 81 0 0 0						13	a3dc8f049fcd5e54d4e2bc4b420c13cce749fadf5c3ca6178780171167541cf3	2026-08-12.3	3	null	2026-08-12T18:38:12.167256+00:00	2026-09-23T14:59:01.480700+00:00	architecture system docker fastapi vue	6a6a895eaf

主机层

• 操作系统：Windows 10/11 + WSL2（Docker Desktop 使用 Linux 容器），所有命令和路径需兼容 Windows（ff34c6eb-6bba-41e5-9e43-ff80941fa823、6973450e-6ecc-48e3-8cdd-4d7d7707d843）。

虚拟化层

• Docker Engine（Ubuntu 24.04）运行在 WSL2 中，容器名 openwrt‑local‑builder:25.12（ac351f5e-5eb7-4752-8666-56550b5b2130）。
• 持久化卷 openwrt‑build‑work（> 50 GB）缓存交叉编译工具链和中间产物（同上）。

容器内服务

• FastAPI（0.139）监听 0.0.0.0:9001（开发模式未认证），提供 RESTful API、构建状态、日志 SSE 等（ff34c6eb-6bba-41e5-9e43-ff80941fa823）。
• Vue 3 + Vite 前端在 localhost:9000，通过代理将 /api/**、/artifacts/** 转发至 FastAPI（同上）。

构建流水线（步骤 1‑10）

1. Docker 镜像构建（基础 Ubuntu + OpenWrt 依赖）。
2. 拉取 OpenWrt 源码（https://github.com/qosmio/openwrt-ipq.git，25.12‑nss 分支）。
3. 拉取外部包（external‑packages.json）。
4. 应用设备专属补丁 patch_ax9000.py（修改 DTS、分区布局、EMC2305 PWM）。
5. 生成配置（UCI 默认脚本、主题、Web 服务器）。
6. 验证 defconfig 并检查 NSS、IPv6、Proxy 兼容性。
7. 编译（make -j$(nproc+1)）。
8. 打包固件（sysupgrade, factory.ubi, initramfs-*.itb）。
9. 将产物复制至 outputs/ax9000/ 并生成 ZIP，命名 OpenWRT‑AX9000‑YYYY‑MM‑DD_HH‑mm‑ss.zip。
10. 记录构建日志至 outputs/ax9000/logs/。

关键组件

• luci‑app‑ax900‑hardware：用户空间守护进程 ax900‑hardware‑control、ax900‑led‑control 与 LuCI 页面（git:packages/luci-app-ax900-hardware/*）。
• EMC2305 驱动补丁（830‑01‑830‑05）使 PWM 节点可通过 DT 配置（git:profiles/ax9000/kernel-patches/*）。
• NSS 加速：内核模块 kmod‑qca‑nss‑*、固件 nss‑firmware‑ipq807x（4f3555d5-bffb-45c9-9c35-a04e7c41800f）。

来源: ac351f5e-5eb7-4752-8666-56550b5b2130, 7b8945b7-d58e-4bbd-93d0-63b5569c98e4, ff34c6eb-6bba-41e5-9e43-ff80941fa823, 6973450e-6ecc-48e3-8cdd-4d7d7707d843, 4f3555d5-bffb-45c9-9c35-a04e7c41800f, git:profiles/ax9000/kernel-patches/*, git:packages/luci-app-ax900-hardware/*。