docs(架构): 2、架构分层重组 + 开发文档结构 Skill

将架构文档按 01-总览～05-规范 分层，12 张 PNG 迁入 images/ 四类子目录；
新增阿表开发文档结构规范 Skill 与 Obsidian 目录配色 snippet；同步 Hub 扫描路径。

Co-authored-by: Cursor <cursoragent@cursor.com>

.obsidian/appearance.json

@@ -1 +1,5 @@
-{}
+{
+  "enabledCssSnippets": [
+    "workphone-devdoc"
+  ]
+}

.obsidian/snippets/workphone-devdoc.css

@@ -0,0 +1,45 @@
+/* 工作手机 · 开发文档 Obsidian 目录配色
+ * 启用：Settings → Appearance → CSS snippets → workphone-devdoc
+ * 依赖：Obsidian 文件资源管理器 nav-folder-title data-path 属性
+ */
+
+.nav-folder-title[data-path="开发文档/2、架构"] > .nav-folder-title-content {
+  color: #1565C0 !important;
+  font-weight: 600;
+}
+.nav-folder-title[data-path="开发文档/2、架构/01-总览"] > .nav-folder-title-content {
+  color: #2E7D32 !important;
+}
+.nav-folder-title[data-path="开发文档/2、架构/02-技术基座"] > .nav-folder-title-content {
+  color: #6A1B9A !important;
+}
+.nav-folder-title[data-path="开发文档/2、架构/03-通道与设备"] > .nav-folder-title-content {
+  color: #EF6C00 !important;
+}
+.nav-folder-title[data-path="开发文档/2、架构/04-交互图"] > .nav-folder-title-content {
+  color: #00838F !important;
+}
+.nav-folder-title[data-path="开发文档/2、架构/05-规范"] > .nav-folder-title-content {
+  color: #455A64 !important;
+}
+.nav-folder-title[data-path="开发文档/2、架构/images"] > .nav-folder-title-content {
+  color: #78909C !important;
+}
+.nav-folder-title[data-path^="开发文档/2、架构/images/"] > .nav-folder-title-content {
+  color: #546E7A !important;
+}
+
+/* 9、手册 · 五图总览 */
+.nav-folder-title[data-path="开发文档/9、手册"] > .nav-folder-title-content {
+  color: #1565C0 !important;
+  font-weight: 600;
+}
+.nav-folder-title[data-path="开发文档/9、手册/images"] > .nav-folder-title-content {
+  color: #78909C !important;
+}
+
+/* 10、项目管理 */
+.nav-folder-title[data-path="开发文档/10、项目管理"] > .nav-folder-title-content {
+  color: #C62828 !important;
+  font-weight: 600;
+}

.obsidian/workspace.json

@@ -11,12 +11,10 @@
             "id": "dcfc7855fc8fae84",
             "type": "leaf",
             "state": {
-              "type": "image",
+              "type": "empty",
-              "state": {
+              "state": {},
-                "file": "开发文档/2、架构/本地控制模式_5_scrcpy可视化控制模式.png"
+              "icon": "lucide-file",
-              },
+              "title": "新标签页"
-              "icon": "lucide-image",
-              "title": "本地控制模式_5_scrcpy可视化控制模式"
             }
           }
         ]
@@ -181,29 +179,46 @@
       "bases:新建数据库": false
     }
   },
-  "active": "dcfc7855fc8fae84",
+  "active": "214e9888679abd96",
   "lastOpenFiles": [
-    "开发文档/6、测试/v9_verify_result_1779114110.json",
+    "机擎/阿表/开发文档结构规范/SKILL.md",
-    "开发文档/6、测试/v9_final_1779114109.png",
+    "机擎/阿表/开发文档结构规范",
-    "开发文档/6、测试/v9_moments_1779114104.png",
+    "开发文档/2、架构/images/README.md",
-    "开发文档/6、测试/v9_after_send_1779114098.png",
+    "开发文档/2、架构/05-规范/README.md",
-    "开发文档/6、测试/v9_before_send_1779114095.png",
+    "开发文档/2、架构/04-交互图/README.md",
-    "开发文档/6、测试/v9_verify_result_1779113967.json",
+    "开发文档/2、架构/03-通道与设备/README.md",
-    "开发文档/6、测试/v9_final_1779113966.png",
+    "开发文档/2、架构/02-技术基座/README.md",
-    "开发文档/6、测试/v9_moments_1779113961.png",
+    "开发文档/2、架构/01-总览/README.md",
-    "开发文档/6、测试/v9_after_send_1779113955.png",
+    "开发文档/2、架构/images/04-防封/防封服务端核心能力拆细图.png",
-    "开发文档/6、测试/v9_before_send_1779113952.png",
+    "开发文档/2、架构/images/04-防封/防封模块架构图.png",
-    "verify_v9_final.py",
+    "开发文档/2、架构/images/03-微信与Hook/Hook与服务器交互流程图.png",
-    "sdk/agent/hook/wechat_api_v9_final.js",
+    "开发文档/2、架构/images/03-微信与Hook/设备与服务器交互流程_微信控制.png",
-    "debug_contacts.py",
+    "开发文档/2、架构/images/02-控制通道/本地控制模式_5_scrcpy可视化控制模式.png",
-    "开发文档/6、测试/v12_verify_results.json",
+    "开发文档/2、架构/images/02-控制通道/本地控制模式_4_AI_Agent自然语言模式.png",
-    "开发文档/6、测试/v12_final.png",
+    "开发文档/2、架构/images/02-控制通道/本地控制模式_3_Agent_WebSocket远控模式.png",
-    "开发文档/6、测试/v12_after_post_moment.png",
+    "开发文档/2、架构/images/02-控制通道/本地控制模式_2_ADB静默控制模式.png",
-    "verify_v12.py",
+    "开发文档/2、架构/images/02-控制通道/本地控制模式_1_Hook_Frida模式.png",
-    "开发文档/6、测试/v11_verify_results.json",
+    "开发文档/2、架构/05-规范/架构图风格标准.md",
-    "verify_v11.py",
+    "开发文档/2、架构/05-规范",
-    "开发文档/6、测试/v10_verify_results.json",
+    "开发文档/2、架构/04-交互图/防封模块架构图.mmd",
-    "verify_v10.py",
+    "开发文档/2、架构/04-交互图/防封模块架构图.html",
+    "开发文档/2、架构/04-交互图/微信控制-设备服务器交互图.html",
+    "开发文档/2、架构/04-交互图/AI数智员工v4.0架构图.html",
+    "开发文档/2、架构/04-交互图",
+    "开发文档/2、架构/03-通道与设备/Hook通道与多设备多服务器架构.md",
+    "开发文档/2、架构/03-通道与设备",
+    "开发文档/2、架构/02-技术基座/技术选型与数据库.md",
+    "开发文档/2、架构/02-技术基座",
+    "开发文档/2、架构/01-总览/系统架构.md",
+    "开发文档/2、架构/01-总览",
+    "开发文档/2、架构/images/01-整体总览/工作手机设备端运转逻辑.png",
+    "docs/wiki-gitea/完整整合手册.md",
+    "补全包/README.md",
+    "开发文档/1、需求/业务需求.md",
+    "开发文档/1、需求/项目概述.md",
+    "开发文档/1、需求/修改/设备-微信.md",
+    "补全包/微信Frida_SDK_20260518/开发文档/5、接口/微信Frida_API契约.md",
+    "工作手机SDK补全包_微信Frida/开发文档/2、架构/系统架构.md",
     "开发文档/5、接口文档/API接口文档_v8fix.md",
     "开发文档/5、开发日志/dev_log_v6_20260518.md",
     "开发文档/6、测试/real_device_110_effect_verify_20260518/20260518_180227/真实脱线手机110功能最终效果验证报告.md",
@@ -211,23 +226,6 @@
     "开发文档/6、测试/live_verify_20260518/Frida真机验证报告_v2_20260518.md",
     "开发文档/6、测试/real_device_110_effect_verify_20260518/20260518_180227/截图复核与待修正.md",
     "开发文档/6、测试/real_device_110_effect_verify_20260518/20260518_174929/真实脱线手机110功能最终效果验证报告.md",
-    "开发文档/6、测试/wireless_frida_20260518/无线Frida微信控制批量验证报告.md",
+    "开发文档/6、测试/wireless_frida_20260518/无线Frida微信控制批量验证报告.md"
-    "开发文档/6、测试/wireless_frida_real_device_acceptance_20260518/真机110功能验收矩阵.md",
-    "开发文档/6、测试/Frida无线控制验证报告_20260518.md",
-    "开发文档/8、部署/本地挂载与GitHub阶段性同步规则_追加版_20260518_1913.md",
-    "local-mount-sync/SKILL.md",
-    "开发文档/6、测试/110项功能逐项确认/2026-05-18/非微信接口剔除与核心完成率口径_追加版_1903.md",
-    "开发文档/6、测试/110项功能逐项确认/2026-05-18/微信SDK真实控制接口矩阵V4_追加版_190130.md",
-    "开发文档/6、测试/110项功能逐项确认/2026-05-18/微信SDK真实控制接口矩阵V3_追加版_185935.md",
-    "开发文档/6、测试/110项功能逐项确认/2026-05-18/微信SDK真实控制接口矩阵V2_追加版_184504.md",
-    "开发文档/6、测试/110项功能逐项确认/2026-05-18/微信SDK服务器核心控制接口矩阵_追加版_184154.md",
-    "开发文档/6、测试/110项功能逐项确认/2026-05-18/微信SDK服务器控制接口扫描_追加版_183545.md",
-    "开发文档/6、测试/110项功能逐项确认/2026-05-18/微信SDK服务器控制接口纠偏规则_追加版_1834.md",
-    "开发文档/6、测试/110项功能逐项确认/2026-05-18/黑屏人工确认图片识别证据扫描_追加版_182830.md",
-    "开发文档/6、测试/110项功能逐项确认/2026-05-18/黑屏与人工确认重测规则_追加版_1830.md",
-    "开发文档/6、测试/live_verify_20260518/Type-C真机控制与110接口验证报告.md",
-    "开发文档/6、测试/110项功能逐项确认/2026-05-18/lockscreen_live_verify/锁屏亮屏解锁复核记录_追加.md",
-    "开发文档/6、测试/110项功能逐项确认/2026-05-18/资料读取与锁屏后台证据复核_追加版_181855.md",
-    "开发文档/6、测试/110项功能逐项确认/2026-05-18/README_追加索引_1819.md"
   ]
 }

sdk/app/main.py

@@ -33,8 +33,8 @@ _STATIC_DIR = os.path.join(_APP_DIR, "static")
 _DOCS_ROOT = os.path.normpath(os.path.join(_APP_DIR, "..", "..", "开发文档"))
 _DOC_PAGE_MAP = {
     "api-architecture": os.path.join(_DOCS_ROOT, "5、接口", "API架构与交互流程图.html"),
-    "anti-ban-architecture": os.path.join(_DOCS_ROOT, "2、架构", "防封模块架构图.html"),
+    "anti-ban-architecture": os.path.join(_DOCS_ROOT, "2、架构", "04-交互图", "防封模块架构图.html"),
-    "wechat-server-flow": os.path.join(_DOCS_ROOT, "2、架构", "微信控制-设备服务器交互图.html"),
+    "wechat-server-flow": os.path.join(_DOCS_ROOT, "2、架构", "04-交互图", "微信控制-设备服务器交互图.html"),
 }
 _AGENT_ROOT = os.path.normpath(os.path.join(_APP_DIR, "..", "agent"))
 _AGENT_DOCS = [
@@ -137,7 +137,7 @@ _WORKBENCH_DOCS = [
         "category": "architecture",
         "section": "架构与经验",
         "folder": "2、架构",
-        "file": "系统架构.md",
+        "file": "01-总览/系统架构.md",
         "keywords": ["架构", "模块", "分层", "链路"],
     },
     {
@@ -147,7 +147,7 @@ _WORKBENCH_DOCS = [
         "category": "architecture",
         "section": "架构与经验",
         "folder": "2、架构",
-        "file": "Hook通道与多设备多服务器架构.md",
+        "file": "03-通道与设备/Hook通道与多设备多服务器架构.md",
         "keywords": ["Hook", "Frida", "多设备", "多服务器"],
     },
     {
@@ -199,18 +199,18 @@ def _scan_arch_assets():
         ("mode-scrcpy", "本地控制模式五：scrcpy可视化控制", "投屏与人工接管。"),
     ]
     fname_map = {
-        "arch-sdk": "工作手机SDK架构图.png",
+        "arch-sdk": "images/01-整体总览/工作手机SDK架构图.png",
-        "arch-flow": "设备与服务器交互流程_微信控制.png",
+        "arch-flow": "images/03-微信与Hook/设备与服务器交互流程_微信控制.png",
-        "arch-device": "工作手机设备端运转逻辑.png",
+        "arch-device": "images/01-整体总览/工作手机设备端运转逻辑.png",
-        "arch-agent-total": "卡若AI手机_Agent与服务器工作流总图.png",
+        "arch-agent-total": "images/01-整体总览/卡若AI手机_Agent与服务器工作流总图.png",
-        "arch-hook": "Hook与服务器交互流程图.png",
+        "arch-hook": "images/03-微信与Hook/Hook与服务器交互流程图.png",
-        "arch-ban": "防封模块架构图.png",
+        "arch-ban": "images/04-防封/防封模块架构图.png",
-        "arch-ban-detail": "防封服务端核心能力拆细图.png",
+        "arch-ban-detail": "images/04-防封/防封服务端核心能力拆细图.png",
-        "mode-hook": "本地控制模式_1_Hook_Frida模式.png",
+        "mode-hook": "images/02-控制通道/本地控制模式_1_Hook_Frida模式.png",
-        "mode-adb": "本地控制模式_2_ADB静默控制模式.png",
+        "mode-adb": "images/02-控制通道/本地控制模式_2_ADB静默控制模式.png",
-        "mode-agent": "本地控制模式_3_Agent_WebSocket远控模式.png",
+        "mode-agent": "images/02-控制通道/本地控制模式_3_Agent_WebSocket远控模式.png",
-        "mode-ai": "本地控制模式_4_AI_Agent自然语言模式.png",
+        "mode-ai": "images/02-控制通道/本地控制模式_4_AI_Agent自然语言模式.png",
-        "mode-scrcpy": "本地控制模式_5_scrcpy可视化控制模式.png",
+        "mode-scrcpy": "images/02-控制通道/本地控制模式_5_scrcpy可视化控制模式.png",
     }
     result = []
     for aid, title, summary in known:

工作手机SDK补全包_微信Frida/开发文档/2、架构/系统架构.md

@@ -1,6 +1,6 @@
 # 系统架构（补全包归档）
 
 > **已并入**：[开发文档/9、手册/工作手机·五图总览与使用手册.md](../../../开发文档/9、手册/工作手机·五图总览与使用手册.md) §一、§二  
-> 完整架构见 [开发文档/2、架构/系统架构.md](../../../开发文档/2、架构/系统架构.md)
+> 完整架构见 [开发文档/2、架构/01-总览/系统架构.md](../../../开发文档/2、架构/01-总览/系统架构.md)
 
 本文件为补全包内副本，勿再扩写。

开发文档/10、项目管理/README.md

@@ -4,7 +4,7 @@
 
 **规则**：本目录除本 README 外最多 **3 个主文档**，与全站开发文档规则一致；超出须合并。
 
-**当前项目状态**：总进度 **96%**；M1～M4、M7～M11 已 100%，M5 约 75%、M8 约 95%，M6 待做、M12 约 50%。模块拆解见 [2、架构/系统架构.md](../2、架构/系统架构.md) §3.0。
+**当前项目状态**：总进度 **96%**；M1～M4、M7～M11 已 100%，M5 约 75%、M8 约 95%，M6 待做、M12 约 50%。模块拆解见 [2、架构/01-总览/系统架构.md](../2、架构/01-总览/系统架构.md) §3.0。
 
 ---
 

开发文档/10、项目管理/工作日志.md

@@ -29,9 +29,6 @@
 - [x] `/api/v3/frida/discover` 验证：`success: true`（修复前 ModuleNotFoundError）。
 - [x] Commit `9bea66c` 已推 GitHub；SDK 已重启（8899）。
 
----
-- ~~可选：补全包根目录 README 加「已并入开发文档/9、手册」跳转。~~ ✅ 已完成（`补全包/README.md`、双补全包 README 及内嵌开发文档均已跳转）
-
 ---
 
 ## 2026-05-24 08:00 | 五图 PNG 统一版 + 手册补全
@@ -3034,3 +3031,20 @@ v3.1: Agent 内置 AI Brain → 心跳驱动自主决策 → Frida优先/u2兜
 6. **已执行**：`git push gitea main`；**已执行**：Wiki 全量创建/更新（6 页）
 
 **说明**: 软件包/项目看板/带附件的 Release 需在 Gitea Web 按 `docs/gitea/*.md` 继续操作；大二进制勿入库，用 Release 附件或 Generic 包。
+
+---
+
+### 2026-05-24 | 2、架构 目录分层重组 + 开发文档结构 Skill
+
+**完成项**:
+1. **`开发文档/2、架构/`** 按大类重组：`01-总览/` `02-技术基座/` `03-通道与设备/` `04-交互图/` `05-规范/`
+2. **12 张 PNG** 迁入 `images/01-整体总览/`～`04-防封/` 四类子目录
+3. **`2、架构/README.md`** 重写：目录树、图片索引、Obsidian 配色表
+4. **Obsidian**：`.obsidian/snippets/workphone-devdoc.css` 目录配色；各层 README 带 `obsidian-color`
+5. **`sdk/app/main.py`**：`_DOC_PAGE_MAP`、`_scan_arch_assets` 路径对齐新结构
+6. **Skill 新增**：`机擎/阿表/开发文档结构规范/SKILL.md`（开发时实时归类、images 规则、Obsidian）
+7. 联动更新：`机擎/SKILL.md`、`机擎/阿表/SKILL.md`、`开发文档/README.md`、手册 HTML、资料目录旧路径
+
+**进度**: 99.5%（文档结构无功能阻塞）
+
+**下一步**: 新功能文档当场按 Skill 归类；Gitea NAS 在线后 `bash docs/gitea/sync_when_online.sh`

开发文档/10、项目管理/验收与项目说明.md

@@ -48,7 +48,7 @@
 
 ## 五、项目管理说明
 
-- **进度只看两处**：[开发进度总表.md](开发进度总表.md) + [2、架构/系统架构.md](../2、架构/系统架构.md) §3.0 模块拆解。
+- **进度只看两处**：[开发进度总表.md](开发进度总表.md) + [2、架构/01-总览/系统架构.md](../2、架构/01-总览/系统架构.md) §3.0 模块拆解。
 - **工作日志**：每次对话追加 [工作日志.md](工作日志.md)。
 - 原《AI开发引擎》《模板使用说明书》《开发计划》全文、《开发进度追踪》等已合并入本说明；详细任务分解见开发计划历史。
 

开发文档/1、需求/业务需求.md

@@ -328,7 +328,7 @@ $sdk->execute($deviceId, 'wechat', 'send_message', [
 
 | 编号 | 需求 | 状态 | 落点 |
 |------|------|------|------|
-| A1 | 生成工作手机SDK系统架构图（中文、扁平蓝绿风格） | 已完成 | 开发文档/2、架构/工作手机SDK架构图.png |
+| A1 | 生成工作手机SDK系统架构图（中文、扁平蓝绿风格） | 已完成 | 开发文档/2、架构/images/01-整体总览/工作手机SDK架构图.png |
 | A2 | 生成设备与服务器交互流程图（微信控制链路） | 已完成 | 设备与服务器交互流程_微信控制.png |
 | A3 | 生成设备端运转逻辑图（从启动到心跳到 Skill 执行） | 已完成 | 工作手机设备端运转逻辑.png |
 | A4 | 生成防封模块架构图 + 防封服务端核心能力拆细图 | 已完成 | 防封模块架构图.png + 防封服务端核心能力拆细图.png |

开发文档/1、需求/项目概述.md

@@ -188,7 +188,7 @@
 
 ## 六、下一步
 
-1. **架构设计**：查看 [2、架构/系统架构.md](../2、架构/系统架构.md)
+1. **架构设计**：查看 [2、架构/01-总览/系统架构.md](../2、架构/01-总览/系统架构.md)
 2. **接口对接**：查看 [5、接口/接口规范.md](../5、接口/接口规范.md)
 3. **开发计划**：查看 [10、项目管理/开发进度总表.md](../10、项目管理/开发进度总表.md)
 

开发文档/2、架构/01-总览/README.md

@@ -0,0 +1,11 @@
+---
+obsidian-color: "#2E7D32"
+---
+
+# 01 · 总览
+
+| 文档 | 说明 |
+|------|------|
+| [系统架构.md](系统架构.md) | **主文档**：五层架构、v4.0 APK、M1～M12、§3.0 模块拆解、存客宝对接 |
+
+**关联图**：`../images/01-整体总览/`

开发文档/2、架构/01-总览/系统架构.md

@@ -16,7 +16,7 @@
 - **PWA核心界面**：首页加载 AI数智员工 Next.js PWA，控制台内嵌 hub.html
 
 ### 架构图（交互式HTML）
-> - **v4.0完整架构图**：[AI数智员工v4.0架构图.html](AI数智员工v4.0架构图.html)（浏览器打开）
+> - **v4.0完整架构图**：[AI数智员工v4.0架构图.html](../04-交互图/AI数智员工v4.0架构图.html)（浏览器打开）
 
 ### APK内部模块
 
@@ -42,10 +42,10 @@
 ## 一、整体架构图（AI+Skill版）
 
 > **图形化架构图**：  
-> - 整体架构：[工作手机SDK架构图.png](工作手机SDK架构图.png)  
+> - 整体架构：[工作手机SDK架构图.png](../images/01-整体总览/工作手机SDK架构图.png)  
-> - 微信控制·设备服务器交互：[微信控制-设备服务器交互图.html](微信控制-设备服务器交互图.html)（浏览器打开）  
+> - 微信控制·设备服务器交互：[微信控制-设备服务器交互图.html](../04-交互图/微信控制-设备服务器交互图.html)（浏览器打开）  
-> - **v4.0**：[AI数智员工v4.0架构图.html](AI数智员工v4.0架构图.html)（浏览器打开）  
+> - **v4.0**：[AI数智员工v4.0架构图.html](../04-交互图/AI数智员工v4.0架构图.html)（浏览器打开）  
-> - 风格标准：[架构图风格标准.md](架构图风格标准.md)（以后生成架构图按此风格）
+> - 风格标准：[架构图风格标准.md](../05-规范/架构图风格标准.md)（以后生成架构图按此风格）
 
 ```
 ┌─────────────────────────────────────────────────────────────────────────────┐
@@ -306,8 +306,8 @@ class CaptureService:
 
 ## 四、数据流设计
 
-> **图形化流程图**：设备与服务器交互（微信控制）见 [设备与服务器交互流程_微信控制.png](设备与服务器交互流程_微信控制.png)。  
+> **图形化流程图**：设备与服务器交互（微信控制）见 [设备与服务器交互流程_微信控制.png](../images/03-微信与Hook/设备与服务器交互流程_微信控制.png)。  
-> **架构图风格标准**：见 [架构图风格标准.md](架构图风格标准.md)，后续架构图均按此风格生成。
+> **架构图风格标准**：见 [架构图风格标准.md](../05-规范/架构图风格标准.md)，后续架构图均按此风格生成。
 
 ### 4.1 API请求流程
 

开发文档/2、架构/02-技术基座/README.md

@@ -0,0 +1,9 @@
+---
+obsidian-color: "#6A1B9A"
+---
+
+# 02 · 技术基座
+
+| 文档 | 说明 |
+|------|------|
+| [技术选型与数据库.md](技术选型与数据库.md) | FastAPI/MongoDB/Redis 选型 + 数据层设计 |

开发文档/2、架构/03-通道与设备/README.md

@@ -0,0 +1,11 @@
+---
+obsidian-color: "#EF6C00"
+---
+
+# 03 · 通道与设备
+
+| 文档 | 说明 |
+|------|------|
+| [Hook通道与多设备多服务器架构.md](Hook通道与多设备多服务器架构.md) | 双通道路由、Frida、多设备多服务器、模块管理 |
+
+**关联图**：`../images/02-控制通道/` · `../images/03-微信与Hook/`

开发文档/2、架构/04-交互图/README.md

@@ -0,0 +1,13 @@
+---
+obsidian-color: "#00838F"
+---
+
+# 04 · 交互图（HTML / Mermaid）
+
+| 文件 | 说明 |
+|------|------|
+| [AI数智员工v4.0架构图.html](AI数智员工v4.0架构图.html) | v4.0 完整交互架构 |
+| [微信控制-设备服务器交互图.html](微信控制-设备服务器交互图.html) | 微信控制链路 |
+| [防封模块架构图.html](防封模块架构图.html) | 防封模块（源：`防封模块架构图.mmd`） |
+
+Hub 路由：`/docs/wechat-server-flow` · `/docs/anti-ban-architecture`

开发文档/2、架构/05-规范/README.md

@@ -0,0 +1,9 @@
+---
+obsidian-color: "#455A64"
+---
+
+# 05 · 规范
+
+| 文档 | 说明 |
+|------|------|
+| [架构图风格标准.md](架构图风格标准.md) | 出图风格 + **images/ 四类归档规则** |

开发文档/2、架构/05-规范/架构图风格标准.md

@@ -1,6 +1,7 @@
 # 工作手机 · 架构图风格标准
 
-> **用途**：后续所有架构图、流程图、应用示意均按此风格生成，保持统一视觉。
+> **用途**：后续所有架构图、流程图、应用示意均按此风格生成，保持统一视觉。  
+> **图片目录**：`../images/`（按子目录分组，禁止 PNG 散落在架构根目录）
 
 ---
 
@@ -33,13 +34,20 @@
 
 ---
 
-## 四、参考图
+## 四、图片归档目录（images/）
+
+| 子目录 | 内容 |
+|--------|------|
+| `images/01-整体总览/` | SDK 全景、Agent 工作流、设备端运转 |
+| `images/02-控制通道/` | 五通道本地控制模式 P1～P5 |
+| `images/03-微信与Hook/` | 微信控制链路、Hook 与服务器交互 |
+| `images/04-防封/` | 防封模块、服务端能力拆细 |
 
 | 图名 | 路径 | 说明 |
 |------|------|------|
-| 系统架构图 | 工作手机SDK架构图.png | 整体四层架构 |
+| 系统架构图 | `images/01-整体总览/工作手机SDK架构图.png` | 整体四层架构 |
-| 设备-服务器交互 | 设备与服务器交互流程_微信控制.png | 设备↔服务器、微信控制完整链路 |
+| 设备-服务器交互 | `images/03-微信与Hook/设备与服务器交互流程_微信控制.png` | 微信控制完整链路 |
 
 ---
 
-*后续生成架构图时，按以上标准执行。*
+*后续生成架构图时：先定分类 → 放入对应 `images/` 子目录 → 在正文用相对路径引用。*

开发文档/2、架构/README.md

@@ -1,24 +1,85 @@
+---
+cssclasses:
+  - devdoc-index
+obsidian-color: "#1565C0"
+---
+
 # 2、架构
 
-**项目**：工作手机SDK v3.0（双通道架构：u2主通道 + Hook增强通道）
+**项目**：工作手机SDK v3.0 → v4.0  
-
+**规则**：本目录按 **大类 → 子类 → 文件** 分层；**所有 PNG 仅放 `images/`**；每子目录除 README 外 ≤3 个主文档。  
-**规则**：本目录除本 README 外最多 **3 个主文档**。
+**进度**：99.5% · 用户手册 [9、手册/工作手机·五图总览与使用手册.md](../9、手册/工作手机·五图总览与使用手册.md)
-
-**当前状态**：v4.0 APK + Frida 110 action 已验收。进度 **99.5%** — 用户手册见 **[9、手册/工作手机·五图总览与使用手册.md](../9、手册/工作手机·五图总览与使用手册.md)**（v2.1，含补全包并入）。
 
 ---
 
-## 本目录主文档（≤3）
+## 目录树（从大到小）
 
-| 文档 | 说明 |
+```text
-|------|------|
+2、架构/
-| [系统架构.md](系统架构.md) | 整体架构图、M1-M12模块、数据流、存客宝对接（含原对接补充内容） |
+├── README.md                 ← 你在这里（总索引）
-| [技术选型与数据库.md](技术选型与数据库.md) | 技术选型决策+MongoDB/Redis数据库设计 |
+├── images/                   ← 全部架构图 PNG（禁止放根目录）
-| [Hook通道与多设备多服务器架构.md](Hook通道与多设备多服务器架构.md) | **新增**：双通道路由+Frida集成+多设备多服务器+模块管理 |
+│   ├── 01-整体总览/
+│   ├── 02-控制通道/
+│   ├── 03-微信与Hook/
+│   └── 04-防封/
+├── 01-总览/                  ← 系统全景、模块拆解 §3.0
+├── 02-技术基座/              ← 技术选型 + 数据库
+├── 03-通道与设备/            ← Hook / 多设备 / 多服务器
+├── 04-交互图/                ← HTML / Mermaid 可交互图
+└── 05-规范/                  ← 架构图风格标准
+```
+
+---
+
+## 快速跳转
+
+| 大类 | 说明 | 入口 |
+|------|------|------|
+| **01 总览** | 五层架构、v4.0 APK、§3.0 模块拆解 | [01-总览/系统架构.md](01-总览/系统架构.md) |
+| **02 技术基座** | MongoDB/Redis、技术选型 | [02-技术基座/技术选型与数据库.md](02-技术基座/技术选型与数据库.md) |
+| **03 通道与设备** | Frida Hook、双通道、集群 | [03-通道与设备/Hook通道与多设备多服务器架构.md](03-通道与设备/Hook通道与多设备多服务器架构.md) |
+| **04 交互图** | 浏览器打开的 HTML 架构图 | [04-交互图/README.md](04-交互图/README.md) |
+| **05 规范** | 出图风格、images 归档规则 | [05-规范/架构图风格标准.md](05-规范/架构图风格标准.md) |
+
+---
+
+## 图片索引（images/）
+
+| 子目录 | 图 |
+|--------|-----|
+| [01-整体总览](images/01-整体总览/) | SDK架构图 · Agent工作流 · 设备端运转 |
+| [02-控制通道](images/02-控制通道/) | 本地控制模式 P1～P5（Hook/ADB/WS/AI/scrcpy） |
+| [03-微信与Hook](images/03-微信与Hook/) | 微信控制链路 · Hook服务器交互 |
+| [04-防封](images/04-防封/) | 防封模块 · 服务端能力拆细 |
+
+---
+
+## Obsidian 配色（File Explorer）
+
+| 目录 | 色值 | 含义 |
+|------|------|------|
+| `2、架构` | `#1565C0` 蓝 | 架构总根 |
+| `01-总览` | `#2E7D32` 绿 | 全景 |
+| `02-技术基座` | `#6A1B9A` 紫 | 基建 |
+| `03-通道与设备` | `#EF6C00` 橙 | 通道 |
+| `04-交互图` | `#00838F` 青 | 交互 HTML |
+| `05-规范` | `#455A64` 灰蓝 | 规范 |
+| `images` | `#78909C` 灰 | 静态图 |
+
+启用：Settings → Appearance → CSS snippets → 打开 `workphone-devdoc`（见 `.obsidian/snippets/`）。
+
+---
+
+## 维护规则（开发时必守）
+
+1. **新架构 PNG** → 先判分类 → 放入 `images/xx-子类/` → 在 MD 用相对路径引用  
+2. **新架构 MD** → 放入对应 `0x-大类/`；超 3 篇则合并  
+3. **改路径后** → 同步 `sdk/app/main.py` 的 `_scan_arch_assets` 与 `_DOC_PAGE_MAP`  
+4. **详细规范** → [机擎/阿表/开发文档结构规范/SKILL.md](../../机擎/阿表/开发文档结构规范/SKILL.md)
 
 ---
 
 ## 合并记录
 
-- 2026-02-10: `对接与方案补充.md` 内容合并入 `系统架构.md` 附录
+- 2026-05-24：目录分层重组；PNG 迁入 `images/` 四类子目录  
-- 2026-02-10: 新增 `Hook通道与多设备多服务器架构.md`
+- 2026-02-10：`对接与方案补充.md` 已合并入 `01-总览/系统架构.md`

开发文档/2、架构/images/README.md

@@ -0,0 +1,16 @@
+# images · 架构图静态资源
+
+> **禁止**在 `2、架构/` 根目录放置 PNG；一律在此按子类归档。
+
+| 子目录 | Obsidian 色 | 内容 |
+|--------|-------------|------|
+| [01-整体总览](01-整体总览/) | `#2E7D32` | SDK 全景、Agent 工作流、设备运转 |
+| [02-控制通道](02-控制通道/) | `#EF6C00` | 五通道控制模式图 |
+| [03-微信与Hook](03-微信与Hook/) | `#00838F` | 微信链路、Hook 交互 |
+| [04-防封](04-防封/) | `#C62828` | 防封架构与能力拆细 |
+
+引用示例（从 `01-总览/系统架构.md`）：
+
+```markdown
+![SDK架构](../images/01-整体总览/工作手机SDK架构图.png)
+```

开发文档/7、数据库/README.md

@@ -4,7 +4,7 @@
 
 **规则**：本目录除本 README 外最多 **3 个主文档**，与全站开发文档规则一致；超出须合并。
 
-**当前项目状态**：总进度 97%；M10 数据与存储 100%。完整数据层设计见 [2、架构/技术选型与数据库.md](../2、架构/技术选型与数据库.md) Part B。进度以 [10、项目管理/开发进度总表.md](../10、项目管理/开发进度总表.md) 为准。
+**当前项目状态**：总进度 97%；M10 数据与存储 100%。完整数据层设计见 [2、架构/02-技术基座/技术选型与数据库.md](../2、架构/02-技术基座/技术选型与数据库.md) Part B。进度以 [10、项目管理/开发进度总表.md](../10、项目管理/开发进度总表.md) 为准。
 
 ---
 

开发文档/9、手册/工作手机·五图总览与使用手册.html

@@ -7,7 +7,7 @@ th{background:#f5f9ff} code,pre{background:#f4f4f4;padding:2px 6px;border-radius
 <p><strong>版本</strong>：v2.1 · <strong>更新</strong>：2026-05-24<br />
 <strong>一句话</strong>：把 <code>补全包/</code> 与 <code>工作手机SDK补全包_微信Frida/</code> 里散落的 Frida 闭环，<strong>全部收编进开发文档这一份</strong>——五图看全局，正文只补图中没有的命令、路径与验收数字。<br />
 <strong>进度真源</strong>：<a href="../10、项目管理/开发进度总表.md">开发进度总表.md</a>（<strong>99.5%</strong>）<br />
-<strong>图形风格</strong>：<a href="../2、架构/架构图风格标准.md">架构图风格标准.md</a></p>
+<strong>图形风格</strong>：<a href="../2、架构/05-规范/架构图风格标准.md">架构图风格标准.md</a></p>
 </blockquote>
 <hr />
 <h2>导读 · 为什么值得现在就读</h2>
@@ -224,7 +224,7 @@ JSON 回执 / 控制台 / 验收报告
 <ul>
 <li>统一入参：<code>device_id</code> + <code>platform</code> + <code>action</code> + <code>params</code> → <code>POST /api/v3/hook/execute</code></li>
 <li>可观测：<code>GET /api/v3/hook/probe/{id}</code>、<code>GET /api/v3/connection/status</code>、回执 <code>_channel_used</code></li>
-<li>更细模块拆分：<a href="../2、架构/系统架构.md">系统架构.md</a></li>
+<li>更细模块拆分：<a href="../2、架构/01-总览/系统架构.md">系统架构.md</a></li>
 </ul>
 <hr />
 <h2>三、对接与集成全景</h2>
@@ -464,7 +464,7 @@ python3 tools/wireless_frida_wechat_batch_verify.py
 </tr>
 <tr>
 <td>架构详文</td>
-<td><a href="../2、架构/系统架构.md">系统架构.md</a></td>
+<td><a href="../2、架构/01-总览/系统架构.md">系统架构.md</a></td>
 </tr>
 <tr>
 <td>命令速查</td>

开发文档/9、手册/工作手机·五图总览与使用手册.md

@@ -3,7 +3,7 @@
 > **版本**：v2.1 · **更新**：2026-05-24  
 > **一句话**：把 `补全包/` 与 `工作手机SDK补全包_微信Frida/` 里散落的 Frida 闭环，**全部收编进开发文档这一份**——五图看全局，正文只补图中没有的命令、路径与验收数字。  
 > **进度真源**：[开发进度总表.md](../10、项目管理/开发进度总表.md)（**99.5%**）  
-> **图形风格**：[架构图风格标准.md](../2、架构/架构图风格标准.md)
+> **图形风格**：[架构图风格标准.md](../2、架构/05-规范/架构图风格标准.md)
 
 ---
 
@@ -105,7 +105,7 @@ JSON 回执 / 控制台 / 验收报告
 
 - 统一入参：`device_id` + `platform` + `action` + `params` → `POST /api/v3/hook/execute`
 - 可观测：`GET /api/v3/hook/probe/{id}`、`GET /api/v3/connection/status`、回执 `_channel_used`
-- 更细模块拆分：[系统架构.md](../2、架构/系统架构.md)
+- 更细模块拆分：[系统架构.md](../2、架构/01-总览/系统架构.md)
 
 ---
 
@@ -292,7 +292,7 @@ python3 tools/wireless_frida_wechat_batch_verify.py
 | 主线代码 | `sdk/app` · `sdk/agent` · `sdk/php-sdk` |
 | 补全包归档（只读对照） | `补全包/微信Frida_SDK_20260518/` · `工作手机SDK补全包_微信Frida/` |
 | 五图 + 附图原文件 | `images/workphone_fig01~09.png`（01～05 五图；06～07 无线真机；08～09 架构附） |
-| 架构详文 | [系统架构.md](../2、架构/系统架构.md) |
+| 架构详文 | [系统架构.md](../2、架构/01-总览/系统架构.md) |
 | 命令速查 | [SDK操作手册.md](SDK操作手册.md) |
 | E2E 验收 | [微信消息E2E验证指南.md](微信消息E2E验证指南.md) |
 | 存客宝对接 | [工作手机·一键接入与存客宝对接操作手册.md](工作手机·一键接入与存客宝对接操作手册.md) |

开发文档/README.md

@@ -47,7 +47,7 @@
 | 文档 | 说明 |
 |------|------|
 | **[10、项目管理/开发进度总表.md](10、项目管理/开发进度总表.md)** | 唯一进度文档：按模块 M1～M12 的完成度、待办、验证方式 |
-| **[2、架构/系统架构.md](2、架构/系统架构.md) § 3.0** | 模块拆解基准：需求→任务→进度对应表 |
+| **[2、架构/01-总览/系统架构.md](2、架构/01-总览/系统架构.md) § 3.0** | 模块拆解基准：需求→任务→进度对应表 |
 
 看进度时：先看 **开发进度总表**，再按需看 **系统架构 § 3.0** 的模块拆解。
 
@@ -74,7 +74,7 @@
 | 目录 | 主文档（≤3） | 说明 |
 |------|----------------|------|
 | [1、需求](1、需求/) | 项目概述、业务需求、技术调研与方案选型 | 需求与澄清 |
-| [2、架构](2、架构/) | 系统架构、技术选型与数据库、Hook通道与多设备多服务器架构 | 架构与 §3.0 模块拆解 |
+| [2、架构](2、架构/) | **分层目录** `01-总览/` `02-技术基座/` `03-通道与设备/` `04-交互图/` `05-规范/`；PNG 在 `images/01～04/` | 架构与 §3.0 模块拆解；规范见 [机擎/阿表/开发文档结构规范](../机擎/阿表/开发文档结构规范/SKILL.md) |
 | [3、原型](3、原型/) | 原型设计规范 | 原型规范 |
 | [4、前端](4、前端/) | 前端开发规范、管理端前端开发规范、v0配置 | 前端规范 |
 | [5、接口](5、接口/) | 接口规范、通用服务交互层、Hook模块管理接口 | API 与对接 |

开发文档/平台分析/Soul调研/Soul自动化方案与命令行操作.md

@@ -246,7 +246,7 @@ curl -X POST "https://api.soulapp.cn/v3/post/publish" \
 
 ## 八、参考
 
-- 系统架构：`开发文档/2、架构/系统架构.md`
+- 系统架构：`开发文档/2、架构/01-总览/系统架构.md`
 - unified 接口定义：`sdk/app/routers/unified.py`
 - Soul 接口与功能清单：本目录 [Soul项目分析.md](Soul项目分析.md)
 - Soul 安卓包名与 API：公开资料显示为 `cn.soulapp.android`、api.soulapp.cn；api-sign 等见逆向分析文档。

机擎/SKILL.md

@@ -32,7 +32,7 @@
 | 1 | 开发文档总入口 | 开发文档/README.md | 项目简述、10 目录、**主手册 v2.0 链接** |
 | 2 | **完整整合手册（必读）** | 开发文档/9、手册/工作手机·五图总览与使用手册.md | 五图 + 补全包九模块 + API + 真机 + 无线 Frida · **一份读通** |
 | 3 | 开发进度总表 | 开发文档/10、项目管理/开发进度总表.md | 当前进度 %、M1～M12、下一步 |
-| 4 | 系统架构 §3.0 | 开发文档/2、架构/系统架构.md §3.0 | 模块拆解与需求→任务对应 |
+| 4 | 系统架构 §3.0 | 开发文档/2、架构/01-总览/系统架构.md §3.0 | 模块拆解与需求→任务对应 |
 | 5 | 本 Skill 岗位职责 | 本 SKILL § 一 | 五人名字-岗位、负责板块、开发文档、代码模块 |
 | 6 | 工作日志（最近） | 开发文档/10、项目管理/工作日志.md（最近 3 条） | 近期完成与待办 |
 
@@ -339,7 +339,9 @@
 | 开发进度总表 | 开发文档/10、项目管理/开发进度总表.md |
 | 工作日志 | 开发文档/10、项目管理/工作日志.md |
 | 多端并行拆解 | 开发文档/10、项目管理/多端并行开发模块拆解.md |
-| 系统架构 | 开发文档/2、架构/系统架构.md |
+| 系统架构 | 开发文档/2、架构/01-总览/系统架构.md |
+| **开发文档结构规范** | 机擎/阿表/开发文档结构规范/SKILL.md |
+| 架构目录索引 | 开发文档/2、架构/README.md |
 | 服务端SDK抽象 | 机擎/references/工作手机服务端SDK抽象.md |
 | 设备端SDK抽象 | 机擎/references/工作手机设备端SDK抽象.md |
 | 中间层抽象 | 机擎/references/工作手机中间层抽象.md |

机擎/阿机/SKILL.md

@@ -33,7 +33,7 @@
 | 设备端 Skill | sdk/agent/skills/{wechat,douyin,xhs,xianyu}/skill.py |
 | 后端实现文档 | 开发文档/6、后端/ |
 | 交互矩阵（先对照再开发） | 机擎/references/业务-服务端-设备端交互矩阵.md |
-| 系统架构 | 开发文档/2、架构/系统架构.md |
+| 系统架构 | 开发文档/2、架构/01-总览/系统架构.md |
 
 ---
 

机擎/阿表/SKILL.md

@@ -30,7 +30,8 @@
 | 验收与项目说明 | 开发文档/10、项目管理/验收与项目说明.md |
 | 多端并行开发模块拆解 | 开发文档/10、项目管理/多端并行开发模块拆解.md |
 | 存客宝侧进度同步 | cunkebao_v3/开发文档/工作手机对接/工作手机开发进度.md |
-| 系统架构 | 开发文档/2、架构/系统架构.md §3.0 |
+| 系统架构 | 开发文档/2、架构/01-总览/系统架构.md §3.0 |
+| **开发文档结构规范** | [开发文档结构规范/SKILL.md](开发文档结构规范/SKILL.md) |
 
 ---
 
@@ -44,6 +45,7 @@
 | 必报三项 | 机擎 SKILL §3.3 | 开头/结尾报：进度 %、下一步、完成了什么 |
 | 与卡若AI 同步 | 存客宝侧进度 | 更新 cunkebao_v3 工作手机开发进度与总表一致 |
 | 多端并行拆解 | 10、项目管理/多端并行开发模块拆解 | 四层拆解（服务端/设备端/中间层/前端）并行边界与进度 |
+| **开发文档分层与 images 归档** | [开发文档结构规范/SKILL.md](开发文档结构规范/SKILL.md) | 开发时实时归类；Obsidian 配色；`2、架构/images/` 四类子目录 |
 
 ---
 
@@ -69,7 +71,8 @@
 ## 四、触发词
 
 ```
-进度、总表、工作日志、验收、多端并行、更新进度、与卡若AI同步、@阿表
+进度、总表、工作日志、验收、多端并行、更新进度、与卡若AI同步、@阿表、
+开发文档规范、架构目录整理、images归档、Obsidian配色、文档分类
 ```
 
 **完整五人分工与机擎规则**：见上级 [机擎/SKILL.md](../SKILL.md)。

机擎/阿表/开发文档结构规范/SKILL.md

@@ -0,0 +1,143 @@
+---
+name: workphone-devdoc-structure
+description: >-
+  工作手机 · 开发文档结构规范（阿表专责）。维护 开发文档/1～10 目录分层、images 归档、
+  Obsidian 配色、开发过程中实时归类新文档。触发：整理开发文档、架构目录、文档分类、
+  Obsidian 配色、@阿表 文档、images 归档、开发文档规范。
+owner: 阿表
+version: 1.0.0
+---
+
+# 工作手机 · 开发文档结构规范（阿表 · 开发时必守）
+
+> **归属**：机擎 / 阿表  
+> **范围**：`开发文档/` 全部 1～10 目录；本 Skill 与 [机擎/阿表/SKILL.md](../SKILL.md) **同时加载**  
+> **激情原则**：文档不是事后补录——**每做一个功能，当场归类、当场写进对应目录**，保持 Obsidian 里一眼能扫清。
+
+---
+
+## 一、总规则（8+2 条）
+
+| # | 规则 |
+|---|------|
+| 1 | 所有开发文档 **只在** `开发文档/` 下，禁止散落仓库根 |
+| 2 | 每子目录除 **README** 外 **≤3 个主文档**；超出须合并，不得丢内容 |
+| 3 | **PNG/JPG 架构图** 一律进该目录的 **`images/`** 子树，**禁止**与 MD 混放根目录 |
+| 4 | 目录命名：**`01-大类名/`** 数字前缀表示从大到小；`images/` 内用 **`01-子类/`** |
+| 5 | 每个大类目录必须有 **README.md**（索引 + Obsidian `obsidian-color`） |
+| 6 | 新功能开发完 → **同步 3 处**：功能 MD + `10、项目管理/工作日志.md` + 涉及目录 README |
+| 7 | 改路径 → 同步 **`sdk/app/main.py`**（`_DOC_PAGE_MAP`、`_scan_arch_assets`） |
+| 8 | 进度真源不变：`10、项目管理/开发进度总表.md` + `2、架构/01-总览/系统架构.md` §3.0 |
+| +1 | **Obsidian**：新目录在 `.obsidian/snippets/workphone-devdoc.css` 登记配色 |
+| +2 | **跨目录引用** 用相对路径；对外统一用 `开发文档/x、yyy/...` 全路径 |
+
+---
+
+## 二、`2、架构` 标准树（现行真源）
+
+```text
+开发文档/2、架构/
+├── README.md
+├── images/
+│   ├── README.md
+│   ├── 01-整体总览/      # SDK全景、Agent工作流、设备运转
+│   ├── 02-控制通道/      # 五通道 P1～P5
+│   ├── 03-微信与Hook/    # 微信链路、Hook交互
+│   └── 04-防封/
+├── 01-总览/              # 系统架构.md（§3.0 模块拆解）
+├── 02-技术基座/          # 技术选型与数据库.md
+├── 03-通道与设备/        # Hook通道与多设备多服务器架构.md
+├── 04-交互图/            # *.html、*.mmd
+└── 05-规范/              # 架构图风格标准.md
+```
+
+### 新架构资产归类决策树
+
+```text
+是 PNG/JPG？
+  ├─ 是 → 整体/SDK/APK？        → images/01-整体总览/
+  │       五通道/控制模式？      → images/02-控制通道/
+  │       微信/Hook 链路？       → images/03-微信与Hook/
+  │       防封？                 → images/04-防封/
+  └─ 否 → 可交互 HTML/Mermaid？  → 04-交互图/
+          技术选型/数据库？      → 02-技术基座/
+          Hook/多设备？          → 03-通道与设备/
+          出图规范？             → 05-规范/
+          其他总览/模块？        → 01-总览/
+```
+
+---
+
+## 三、其他目录 images 约定
+
+| 目录 | images 位置 | 用途 |
+|------|-------------|------|
+| `9、手册` | `9、手册/images/` | 五图 fig01～09、手册配图 |
+| `2、架构` | `2、架构/images/01～04/` | 架构 PNG（见上） |
+| `6、测试` | 按日期子目录 `screenshots/` | 验收截图，不进架构 images |
+
+---
+
+## 四、Obsidian 配色规范
+
+**Snippet 路径**：`.obsidian/snippets/workphone-devdoc.css`  
+**启用**：Settings → Appearance → CSS snippets → **workphone-devdoc**（已在 `appearance.json` 登记）
+
+| 路径 | 色值 | 语义 |
+|------|------|------|
+| `开发文档/2、架构` | `#1565C0` | 架构根 |
+| `…/01-总览` | `#2E7D32` | 全景 |
+| `…/02-技术基座` | `#6A1B9A` | 基建 |
+| `…/03-通道与设备` | `#EF6C00` | 通道 |
+| `…/04-交互图` | `#00838F` | HTML |
+| `…/05-规范` | `#455A64` | 规范 |
+| `…/images` | `#78909C` | 静态图 |
+| `开发文档/9、手册` | `#1565C0` | 用户手册 |
+| `开发文档/10、项目管理` | `#C62828` | 进度 |
+
+**新建子目录时**：在 CSS 追加 `.nav-folder-title[data-path="…"]` 规则；README frontmatter 写 `obsidian-color: "#xxxxxx"`。
+
+可选插件：**Icon Folder** — 可为 `01-总览` 设 📐、`images` 设 🖼️，与 CSS 色并存。
+
+---
+
+## 五、开发过程中「实时归类」流程
+
+每次**改代码 + 产文档**时，阿表/执笔者 **当场** 执行：
+
+```text
+1. 判断文档类型（架构/接口/手册/测试/进度）
+2. 选定 开发文档/N、xxx/ 与 01-子目录/
+3. PNG → images/对应子类/（先 mkdir）
+4. 写 MD + 更新该层 README 索引表
+5. 若架构图被 Hub 引用 → 改 sdk/app/main.py _scan_arch_assets
+6. 工作日志追加一条（路径写全）
+7. Obsidian 新目录 → 更新 workphone-devdoc.css
+```
+
+**禁止**：先堆在 `2、架构/` 根目录「以后再整理」。
+
+---
+
+## 六、路径迁移检查清单
+
+迁移或重命名后必跑：
+
+```bash
+# 旧路径应无结果（除工作日志历史条目可保留）
+rg '2、架构/系统架构\.md' 开发文档 机擎 sdk/app
+
+# Hub 架构图扫描
+curl -s http://127.0.0.1:8899/api/workbench/architecture-assets | python3 -m json.tool
+```
+
+---
+
+## 七、触发词
+
+```
+开发文档规范、架构目录整理、images 归档、Obsidian 配色、文档分类、
+2、架构 重组、@阿表 文档、开发文档结构、目录分层
+```
+
+**关联 Skill**：[阿表/SKILL.md](../SKILL.md) · [机擎/SKILL.md](../../SKILL.md) · [9、手册/工作手机·五图总览与使用手册.md](../../../开发文档/9、手册/工作手机·五图总览与使用手册.md)

资料/XESlciw与Frida及机擎详细对比分析.md

@@ -348,7 +348,7 @@
 |------|------|
 | XESlciw 接口与 Hook 手册 | `资料/XESlciw接口与设备Hook开发手册.md` |
 | XESlciw 详解与技术方案对比 | `资料/XESlciw详解与工作手机技术方案对比.md` |
-| 系统架构 | `开发文档/2、架构/系统架构.md` |
+| 系统架构 | `开发文档/2、架构/01-总览/系统架构.md` |
 | 接口规范 | `开发文档/5、接口/接口规范.md` |
 | Frida 官方文档 | https://frida.re/docs/javascript-api/ |
 | LSPosed Native Hook | https://github.com/LSPosed/LSPosed/wiki/Native-Hook |

资料/个微方案全网对比_优于Frida与奥创.md

@@ -209,5 +209,5 @@
 | wxMaster | https://github.com/xz-soft/wxMaster |
 | GeweChat | 搜索 GeweChat Docker |
 | Wechaty | https://wechaty.gitbook.io/wechaty/ |
-| 机擎 | 开发文档/2、架构/系统架构.md |
+| 机擎 | 开发文档/2、架构/01-总览/系统架构.md |
 | 微信互通替代方案 | 资料/微信互通方案对比与更好替代.md |

资料/奥创.md

@@ -598,7 +598,7 @@ AI Agent 收到任务（如"发消息给张三"）
 | 资料 | 说明 |
 |------|------|
 | 本文档 | 工作手机/资料/奥创.md |
-| 机擎SDK架构 | 开发文档/2、架构/系统架构.md |
+| 机擎SDK架构 | 开发文档/2、架构/01-总览/系统架构.md |
 | 机擎进度 | 开发文档/10、项目管理/开发进度总表.md |
 | 服务端SDK抽象 | 机擎/references/工作手机服务端SDK抽象.md |
 | 设备端SDK抽象 | 机擎/references/工作手机设备端SDK抽象.md |

资料/奥创微信控制接口与插件提取复用指南.md

@@ -326,5 +326,5 @@ batch_send_message
 | APK 提取 | 资料/奥创工作手机APK提取/README.md |
 | XESlciw 接口手册 | 资料/XESlciw接口与设备Hook开发手册.md |
 | XESlciw 详解 | 资料/XESlciw详解与工作手机技术方案对比.md |
-| 机擎架构 | 开发文档/2、架构/系统架构.md |
+| 机擎架构 | 开发文档/2、架构/01-总览/系统架构.md |
 | 机擎接口规范 | 开发文档/5、接口/接口规范.md |

资料/机擎复刻Frida与奥创管理注入_实现路径.md

@@ -261,4 +261,4 @@ Java.perform(function() {
 | XESlciw 接口与 Hook 手册 | 资料/XESlciw接口与设备Hook开发手册.md |
 | 奥创复刻与微信 Hook 拆解 | 资料/奥创工作手机-复刻开发详解.md |
 | 奥创 Hook 与 Frida 对比 | 资料/奥创Hook与Frida详细对比及微信互通.md |
-| 系统架构 | 开发文档/2、架构/系统架构.md |
+| 系统架构 | 开发文档/2、架构/01-总览/系统架构.md |