diff --git a/.obsidian/appearance.json b/.obsidian/appearance.json index 9e26dfeeb6..9218393dc1 100644 --- a/.obsidian/appearance.json +++ b/.obsidian/appearance.json @@ -1 +1,5 @@ -{} \ No newline at end of file +{ + "enabledCssSnippets": [ + "workphone-devdoc" + ] +} diff --git a/.obsidian/snippets/workphone-devdoc.css b/.obsidian/snippets/workphone-devdoc.css new file mode 100644 index 0000000000..272548d9da --- /dev/null +++ b/.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; +} diff --git a/.obsidian/workspace.json b/.obsidian/workspace.json index 42d646e995..1b5d8e1b5a 100644 --- a/.obsidian/workspace.json +++ b/.obsidian/workspace.json @@ -11,12 +11,10 @@ "id": "dcfc7855fc8fae84", "type": "leaf", "state": { - "type": "image", - "state": { - "file": "开发文档/2、架构/本地控制模式_5_scrcpy可视化控制模式.png" - }, - "icon": "lucide-image", - "title": "本地控制模式_5_scrcpy可视化控制模式" + "type": "empty", + "state": {}, + "icon": "lucide-file", + "title": "新标签页" } } ] @@ -181,29 +179,46 @@ "bases:新建数据库": false } }, - "active": "dcfc7855fc8fae84", + "active": "214e9888679abd96", "lastOpenFiles": [ - "开发文档/6、测试/v9_verify_result_1779114110.json", - "开发文档/6、测试/v9_final_1779114109.png", - "开发文档/6、测试/v9_moments_1779114104.png", - "开发文档/6、测试/v9_after_send_1779114098.png", - "开发文档/6、测试/v9_before_send_1779114095.png", - "开发文档/6、测试/v9_verify_result_1779113967.json", - "开发文档/6、测试/v9_final_1779113966.png", - "开发文档/6、测试/v9_moments_1779113961.png", - "开发文档/6、测试/v9_after_send_1779113955.png", - "开发文档/6、测试/v9_before_send_1779113952.png", - "verify_v9_final.py", - "sdk/agent/hook/wechat_api_v9_final.js", - "debug_contacts.py", - "开发文档/6、测试/v12_verify_results.json", - "开发文档/6、测试/v12_final.png", - "开发文档/6、测试/v12_after_post_moment.png", - "verify_v12.py", - "开发文档/6、测试/v11_verify_results.json", - "verify_v11.py", - "开发文档/6、测试/v10_verify_results.json", - "verify_v10.py", + "机擎/阿表/开发文档结构规范/SKILL.md", + "机擎/阿表/开发文档结构规范", + "开发文档/2、架构/images/README.md", + "开发文档/2、架构/05-规范/README.md", + "开发文档/2、架构/04-交互图/README.md", + "开发文档/2、架构/03-通道与设备/README.md", + "开发文档/2、架构/02-技术基座/README.md", + "开发文档/2、架构/01-总览/README.md", + "开发文档/2、架构/images/04-防封/防封服务端核心能力拆细图.png", + "开发文档/2、架构/images/04-防封/防封模块架构图.png", + "开发文档/2、架构/images/03-微信与Hook/Hook与服务器交互流程图.png", + "开发文档/2、架构/images/03-微信与Hook/设备与服务器交互流程_微信控制.png", + "开发文档/2、架构/images/02-控制通道/本地控制模式_5_scrcpy可视化控制模式.png", + "开发文档/2、架构/images/02-控制通道/本地控制模式_4_AI_Agent自然语言模式.png", + "开发文档/2、架构/images/02-控制通道/本地控制模式_3_Agent_WebSocket远控模式.png", + "开发文档/2、架构/images/02-控制通道/本地控制模式_2_ADB静默控制模式.png", + "开发文档/2、架构/images/02-控制通道/本地控制模式_1_Hook_Frida模式.png", + "开发文档/2、架构/05-规范/架构图风格标准.md", + "开发文档/2、架构/05-规范", + "开发文档/2、架构/04-交互图/防封模块架构图.mmd", + "开发文档/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_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" + "开发文档/6、测试/wireless_frida_20260518/无线Frida微信控制批量验证报告.md" ] } \ No newline at end of file diff --git a/sdk/app/main.py b/sdk/app/main.py index 37f03b04a3..ebb425ead3 100644 --- a/sdk/app/main.py +++ b/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"), - "wechat-server-flow": 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、架构", "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-flow": "设备与服务器交互流程_微信控制.png", - "arch-device": "工作手机设备端运转逻辑.png", - "arch-agent-total": "卡若AI手机_Agent与服务器工作流总图.png", - "arch-hook": "Hook与服务器交互流程图.png", - "arch-ban": "防封模块架构图.png", - "arch-ban-detail": "防封服务端核心能力拆细图.png", - "mode-hook": "本地控制模式_1_Hook_Frida模式.png", - "mode-adb": "本地控制模式_2_ADB静默控制模式.png", - "mode-agent": "本地控制模式_3_Agent_WebSocket远控模式.png", - "mode-ai": "本地控制模式_4_AI_Agent自然语言模式.png", - "mode-scrcpy": "本地控制模式_5_scrcpy可视化控制模式.png", + "arch-sdk": "images/01-整体总览/工作手机SDK架构图.png", + "arch-flow": "images/03-微信与Hook/设备与服务器交互流程_微信控制.png", + "arch-device": "images/01-整体总览/工作手机设备端运转逻辑.png", + "arch-agent-total": "images/01-整体总览/卡若AI手机_Agent与服务器工作流总图.png", + "arch-hook": "images/03-微信与Hook/Hook与服务器交互流程图.png", + "arch-ban": "images/04-防封/防封模块架构图.png", + "arch-ban-detail": "images/04-防封/防封服务端核心能力拆细图.png", + "mode-hook": "images/02-控制通道/本地控制模式_1_Hook_Frida模式.png", + "mode-adb": "images/02-控制通道/本地控制模式_2_ADB静默控制模式.png", + "mode-agent": "images/02-控制通道/本地控制模式_3_Agent_WebSocket远控模式.png", + "mode-ai": "images/02-控制通道/本地控制模式_4_AI_Agent自然语言模式.png", + "mode-scrcpy": "images/02-控制通道/本地控制模式_5_scrcpy可视化控制模式.png", } result = [] for aid, title, summary in known: diff --git a/工作手机SDK补全包_微信Frida/开发文档/2、架构/系统架构.md b/工作手机SDK补全包_微信Frida/开发文档/2、架构/系统架构.md index 7cca61680c..1ae0bb614c 100644 --- a/工作手机SDK补全包_微信Frida/开发文档/2、架构/系统架构.md +++ b/工作手机SDK补全包_微信Frida/开发文档/2、架构/系统架构.md @@ -1,6 +1,6 @@ # 系统架构（补全包归档） > **已并入**：[开发文档/9、手册/工作手机·五图总览与使用手册.md](../../../开发文档/9、手册/工作手机·五图总览与使用手册.md) §一、§二 -> 完整架构见 [开发文档/2、架构/系统架构.md](../../../开发文档/2、架构/系统架构.md) +> 完整架构见 [开发文档/2、架构/01-总览/系统架构.md](../../../开发文档/2、架构/01-总览/系统架构.md) 本文件为补全包内副本，勿再扩写。 diff --git a/开发文档/10、项目管理/README.md b/开发文档/10、项目管理/README.md index c1a3969c26..d00ede2bf0 100644 --- a/开发文档/10、项目管理/README.md +++ b/开发文档/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。 --- diff --git a/开发文档/10、项目管理/工作日志.md b/开发文档/10、项目管理/工作日志.md index 8a865a40f8..2588667363 100644 --- a/开发文档/10、项目管理/工作日志.md +++ b/开发文档/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` diff --git a/开发文档/10、项目管理/验收与项目说明.md b/开发文档/10、项目管理/验收与项目说明.md index cbd117fc85..1bf8a90404 100644 --- a/开发文档/10、项目管理/验收与项目说明.md +++ b/开发文档/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开发引擎》《模板使用说明书》《开发计划》全文、《开发进度追踪》等已合并入本说明；详细任务分解见开发计划历史。 diff --git a/开发文档/1、需求/业务需求.md b/开发文档/1、需求/业务需求.md index bf71b2cfd3..81fbf7a9cb 100644 --- a/开发文档/1、需求/业务需求.md +++ b/开发文档/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 | diff --git a/开发文档/1、需求/项目概述.md b/开发文档/1、需求/项目概述.md index 4f22992337..cad96d47ab 100644 --- a/开发文档/1、需求/项目概述.md +++ b/开发文档/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) diff --git a/开发文档/2、架构/01-总览/README.md b/开发文档/2、架构/01-总览/README.md new file mode 100644 index 0000000000..c60c88ed37 --- /dev/null +++ b/开发文档/2、架构/01-总览/README.md @@ -0,0 +1,11 @@ +--- +obsidian-color: "#2E7D32" +--- + +# 01 · 总览 + +| 文档 | 说明 | +|------|------| +| [系统架构.md](系统架构.md) | **主文档**：五层架构、v4.0 APK、M1～M12、§3.0 模块拆解、存客宝对接 | + +**关联图**：`../images/01-整体总览/` diff --git a/开发文档/2、架构/系统架构.md b/开发文档/2、架构/01-总览/系统架构.md similarity index 97% rename from 开发文档/2、架构/系统架构.md rename to 开发文档/2、架构/01-总览/系统架构.md index 05532b83ae..b7fce480ea 100644 --- a/开发文档/2、架构/系统架构.md +++ b/开发文档/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) -> - 微信控制·设备服务器交互：[微信控制-设备服务器交互图.html](微信控制-设备服务器交互图.html)（浏览器打开） -> - **v4.0**：[AI数智员工v4.0架构图.html](AI数智员工v4.0架构图.html)（浏览器打开） -> - 风格标准：[架构图风格标准.md](架构图风格标准.md)（以后生成架构图按此风格） +> - 整体架构：[工作手机SDK架构图.png](../images/01-整体总览/工作手机SDK架构图.png) +> - 微信控制·设备服务器交互：[微信控制-设备服务器交互图.html](../04-交互图/微信控制-设备服务器交互图.html)（浏览器打开） +> - **v4.0**：[AI数智员工v4.0架构图.html](../04-交互图/AI数智员工v4.0架构图.html)（浏览器打开） +> - 风格标准：[架构图风格标准.md](../05-规范/架构图风格标准.md)（以后生成架构图按此风格） ``` ┌─────────────────────────────────────────────────────────────────────────────┐ @@ -306,8 +306,8 @@ class CaptureService: ## 四、数据流设计 -> **图形化流程图**：设备与服务器交互（微信控制）见 [设备与服务器交互流程_微信控制.png](设备与服务器交互流程_微信控制.png)。 -> **架构图风格标准**：见 [架构图风格标准.md](架构图风格标准.md)，后续架构图均按此风格生成。 +> **图形化流程图**：设备与服务器交互（微信控制）见 [设备与服务器交互流程_微信控制.png](../images/03-微信与Hook/设备与服务器交互流程_微信控制.png)。 +> **架构图风格标准**：见 [架构图风格标准.md](../05-规范/架构图风格标准.md)，后续架构图均按此风格生成。 ### 4.1 API请求流程 diff --git a/开发文档/2、架构/02-技术基座/README.md b/开发文档/2、架构/02-技术基座/README.md new file mode 100644 index 0000000000..8984a0acae --- /dev/null +++ b/开发文档/2、架构/02-技术基座/README.md @@ -0,0 +1,9 @@ +--- +obsidian-color: "#6A1B9A" +--- + +# 02 · 技术基座 + +| 文档 | 说明 | +|------|------| +| [技术选型与数据库.md](技术选型与数据库.md) | FastAPI/MongoDB/Redis 选型 + 数据层设计 | diff --git a/开发文档/2、架构/技术选型与数据库.md b/开发文档/2、架构/02-技术基座/技术选型与数据库.md similarity index 100% rename from 开发文档/2、架构/技术选型与数据库.md rename to 开发文档/2、架构/02-技术基座/技术选型与数据库.md diff --git a/开发文档/2、架构/Hook通道与多设备多服务器架构.md b/开发文档/2、架构/03-通道与设备/Hook通道与多设备多服务器架构.md similarity index 100% rename from 开发文档/2、架构/Hook通道与多设备多服务器架构.md rename to 开发文档/2、架构/03-通道与设备/Hook通道与多设备多服务器架构.md diff --git a/开发文档/2、架构/03-通道与设备/README.md b/开发文档/2、架构/03-通道与设备/README.md new file mode 100644 index 0000000000..41b9179ea7 --- /dev/null +++ b/开发文档/2、架构/03-通道与设备/README.md @@ -0,0 +1,11 @@ +--- +obsidian-color: "#EF6C00" +--- + +# 03 · 通道与设备 + +| 文档 | 说明 | +|------|------| +| [Hook通道与多设备多服务器架构.md](Hook通道与多设备多服务器架构.md) | 双通道路由、Frida、多设备多服务器、模块管理 | + +**关联图**：`../images/02-控制通道/` · `../images/03-微信与Hook/` diff --git a/开发文档/2、架构/AI数智员工v4.0架构图.html b/开发文档/2、架构/04-交互图/AI数智员工v4.0架构图.html similarity index 100% rename from 开发文档/2、架构/AI数智员工v4.0架构图.html rename to 开发文档/2、架构/04-交互图/AI数智员工v4.0架构图.html diff --git a/开发文档/2、架构/04-交互图/README.md b/开发文档/2、架构/04-交互图/README.md new file mode 100644 index 0000000000..d8b729942f --- /dev/null +++ b/开发文档/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` diff --git a/开发文档/2、架构/微信控制-设备服务器交互图.html b/开发文档/2、架构/04-交互图/微信控制-设备服务器交互图.html similarity index 100% rename from 开发文档/2、架构/微信控制-设备服务器交互图.html rename to 开发文档/2、架构/04-交互图/微信控制-设备服务器交互图.html diff --git a/开发文档/2、架构/防封模块架构图.html b/开发文档/2、架构/04-交互图/防封模块架构图.html similarity index 100% rename from 开发文档/2、架构/防封模块架构图.html rename to 开发文档/2、架构/04-交互图/防封模块架构图.html diff --git a/开发文档/2、架构/防封模块架构图.mmd b/开发文档/2、架构/04-交互图/防封模块架构图.mmd similarity index 100% rename from 开发文档/2、架构/防封模块架构图.mmd rename to 开发文档/2、架构/04-交互图/防封模块架构图.mmd diff --git a/开发文档/2、架构/05-规范/README.md b/开发文档/2、架构/05-规范/README.md new file mode 100644 index 0000000000..6b2883e597 --- /dev/null +++ b/开发文档/2、架构/05-规范/README.md @@ -0,0 +1,9 @@ +--- +obsidian-color: "#455A64" +--- + +# 05 · 规范 + +| 文档 | 说明 | +|------|------| +| [架构图风格标准.md](架构图风格标准.md) | 出图风格 + **images/ 四类归档规则** | diff --git a/开发文档/2、架构/架构图风格标准.md b/开发文档/2、架构/05-规范/架构图风格标准.md similarity index 55% rename from 开发文档/2、架构/架构图风格标准.md rename to 开发文档/2、架构/05-规范/架构图风格标准.md index f15d91d726..a7252cf996 100644 --- a/开发文档/2、架构/架构图风格标准.md +++ b/开发文档/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 | 整体四层架构 | -| 设备-服务器交互 | 设备与服务器交互流程_微信控制.png | 设备↔服务器、微信控制完整链路 | +| 系统架构图 | `images/01-整体总览/工作手机SDK架构图.png` | 整体四层架构 | +| 设备-服务器交互 | `images/03-微信与Hook/设备与服务器交互流程_微信控制.png` | 微信控制完整链路 | --- -*后续生成架构图时，按以上标准执行。* +*后续生成架构图时：先定分类 → 放入对应 `images/` 子目录 → 在正文用相对路径引用。* diff --git a/开发文档/2、架构/README.md b/开发文档/2、架构/README.md index d82d778a60..dd7a3014bf 100644 --- a/开发文档/2、架构/README.md +++ b/开发文档/2、架构/README.md @@ -1,24 +1,85 @@ +--- +cssclasses: + - devdoc-index +obsidian-color: "#1565C0" +--- + # 2、架构 -**项目**：工作手机SDK v3.0（双通道架构：u2主通道 + Hook增强通道） - -**规则**：本目录除本 README 外最多 **3 个主文档**。 - -**当前状态**：v4.0 APK + Frida 110 action 已验收。进度 **99.5%** — 用户手册见 **[9、手册/工作手机·五图总览与使用手册.md](../9、手册/工作手机·五图总览与使用手册.md)**（v2.1，含补全包并入）。 +**项目**：工作手机SDK v3.0 → v4.0 +**规则**：本目录按 **大类 → 子类 → 文件** 分层；**所有 PNG 仅放 `images/`**；每子目录除 README 外 ≤3 个主文档。 +**进度**：99.5% · 用户手册 [9、手册/工作手机·五图总览与使用手册.md](../9、手册/工作手机·五图总览与使用手册.md) --- -## 本目录主文档（≤3） +## 目录树（从大到小） -| 文档 | 说明 | -|------|------| -| [系统架构.md](系统架构.md) | 整体架构图、M1-M12模块、数据流、存客宝对接（含原对接补充内容） | -| [技术选型与数据库.md](技术选型与数据库.md) | 技术选型决策+MongoDB/Redis数据库设计 | -| [Hook通道与多设备多服务器架构.md](Hook通道与多设备多服务器架构.md) | **新增**：双通道路由+Frida集成+多设备多服务器+模块管理 | +```text +2、架构/ +├── README.md ← 你在这里（总索引） +├── images/ ← 全部架构图 PNG（禁止放根目录） +│ ├── 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-02-10: 新增 `Hook通道与多设备多服务器架构.md` +- 2026-05-24：目录分层重组；PNG 迁入 `images/` 四类子目录 +- 2026-02-10：`对接与方案补充.md` 已合并入 `01-总览/系统架构.md` diff --git a/开发文档/2、架构/卡若AI手机_Agent与服务器工作流总图.png b/开发文档/2、架构/images/01-整体总览/卡若AI手机_Agent与服务器工作流总图.png similarity index 100% rename from 开发文档/2、架构/卡若AI手机_Agent与服务器工作流总图.png rename to 开发文档/2、架构/images/01-整体总览/卡若AI手机_Agent与服务器工作流总图.png diff --git a/开发文档/2、架构/工作手机SDK架构图.png b/开发文档/2、架构/images/01-整体总览/工作手机SDK架构图.png similarity index 100% rename from 开发文档/2、架构/工作手机SDK架构图.png rename to 开发文档/2、架构/images/01-整体总览/工作手机SDK架构图.png diff --git a/开发文档/2、架构/工作手机设备端运转逻辑.png b/开发文档/2、架构/images/01-整体总览/工作手机设备端运转逻辑.png similarity index 100% rename from 开发文档/2、架构/工作手机设备端运转逻辑.png rename to 开发文档/2、架构/images/01-整体总览/工作手机设备端运转逻辑.png diff --git a/开发文档/2、架构/本地控制模式_1_Hook_Frida模式.png b/开发文档/2、架构/images/02-控制通道/本地控制模式_1_Hook_Frida模式.png similarity index 100% rename from 开发文档/2、架构/本地控制模式_1_Hook_Frida模式.png rename to 开发文档/2、架构/images/02-控制通道/本地控制模式_1_Hook_Frida模式.png diff --git a/开发文档/2、架构/本地控制模式_2_ADB静默控制模式.png b/开发文档/2、架构/images/02-控制通道/本地控制模式_2_ADB静默控制模式.png similarity index 100% rename from 开发文档/2、架构/本地控制模式_2_ADB静默控制模式.png rename to 开发文档/2、架构/images/02-控制通道/本地控制模式_2_ADB静默控制模式.png diff --git a/开发文档/2、架构/本地控制模式_3_Agent_WebSocket远控模式.png b/开发文档/2、架构/images/02-控制通道/本地控制模式_3_Agent_WebSocket远控模式.png similarity index 100% rename from 开发文档/2、架构/本地控制模式_3_Agent_WebSocket远控模式.png rename to 开发文档/2、架构/images/02-控制通道/本地控制模式_3_Agent_WebSocket远控模式.png diff --git a/开发文档/2、架构/本地控制模式_4_AI_Agent自然语言模式.png b/开发文档/2、架构/images/02-控制通道/本地控制模式_4_AI_Agent自然语言模式.png similarity index 100% rename from 开发文档/2、架构/本地控制模式_4_AI_Agent自然语言模式.png rename to 开发文档/2、架构/images/02-控制通道/本地控制模式_4_AI_Agent自然语言模式.png diff --git a/开发文档/2、架构/本地控制模式_5_scrcpy可视化控制模式.png b/开发文档/2、架构/images/02-控制通道/本地控制模式_5_scrcpy可视化控制模式.png similarity index 100% rename from 开发文档/2、架构/本地控制模式_5_scrcpy可视化控制模式.png rename to 开发文档/2、架构/images/02-控制通道/本地控制模式_5_scrcpy可视化控制模式.png diff --git a/开发文档/2、架构/Hook与服务器交互流程图.png b/开发文档/2、架构/images/03-微信与Hook/Hook与服务器交互流程图.png similarity index 100% rename from 开发文档/2、架构/Hook与服务器交互流程图.png rename to 开发文档/2、架构/images/03-微信与Hook/Hook与服务器交互流程图.png diff --git a/开发文档/2、架构/设备与服务器交互流程_微信控制.png b/开发文档/2、架构/images/03-微信与Hook/设备与服务器交互流程_微信控制.png similarity index 100% rename from 开发文档/2、架构/设备与服务器交互流程_微信控制.png rename to 开发文档/2、架构/images/03-微信与Hook/设备与服务器交互流程_微信控制.png diff --git a/开发文档/2、架构/防封服务端核心能力拆细图.png b/开发文档/2、架构/images/04-防封/防封服务端核心能力拆细图.png similarity index 100% rename from 开发文档/2、架构/防封服务端核心能力拆细图.png rename to 开发文档/2、架构/images/04-防封/防封服务端核心能力拆细图.png diff --git a/开发文档/2、架构/防封模块架构图.png b/开发文档/2、架构/images/04-防封/防封模块架构图.png similarity index 100% rename from 开发文档/2、架构/防封模块架构图.png rename to 开发文档/2、架构/images/04-防封/防封模块架构图.png diff --git a/开发文档/2、架构/images/README.md b/开发文档/2、架构/images/README.md new file mode 100644 index 0000000000..dc13c04661 --- /dev/null +++ b/开发文档/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) +``` diff --git a/开发文档/7、数据库/README.md b/开发文档/7、数据库/README.md index 4b85a8628b..9b14fb73bd 100644 --- a/开发文档/7、数据库/README.md +++ b/开发文档/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) 为准。 --- diff --git a/开发文档/9、手册/工作手机·五图总览与使用手册.html b/开发文档/9、手册/工作手机·五图总览与使用手册.html index 3014ed4cdd..f2b8ed2790 100644 --- a/开发文档/9、手册/工作手机·五图总览与使用手册.html +++ b/开发文档/9、手册/工作手机·五图总览与使用手册.html @@ -7,7 +7,7 @@ th{background:#f5f9ff} code,pre{background:#f4f4f4;padding:2px 6px;border-radius

版本：v2.1 · 更新：2026-05-24
一句话：把 补全包/ 与 工作手机SDK补全包_微信Frida/ 里散落的 Frida 闭环，全部收编进开发文档这一份——五图看全局，正文只补图中没有的命令、路径与验收数字。
进度真源：开发进度总表.md（99.5%）
-图形风格：架构图风格标准.md

+图形风格：架构图风格标准.md

导读 · 为什么值得现在就读

@@ -224,7 +224,7 @@ JSON 回执 / 控制台 / 验收报告

三、对接与集成全景

@@ -464,7 +464,7 @@ python3 tools/wireless_frida_wechat_batch_verify.py 架构详文 -系统架构.md +系统架构.md 命令速查 diff --git a/开发文档/9、手册/工作手机·五图总览与使用手册.md b/开发文档/9、手册/工作手机·五图总览与使用手册.md index c2257f20c2..dce8a88548 100644 --- a/开发文档/9、手册/工作手机·五图总览与使用手册.md +++ b/开发文档/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) | diff --git a/开发文档/README.md b/开发文档/README.md index 8e12160e87..62410046b7 100644 --- a/开发文档/README.md +++ b/开发文档/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 与对接 | diff --git a/开发文档/平台分析/Soul调研/Soul自动化方案与命令行操作.md b/开发文档/平台分析/Soul调研/Soul自动化方案与命令行操作.md index 18b223a71c..b123a0bed3 100644 --- a/开发文档/平台分析/Soul调研/Soul自动化方案与命令行操作.md +++ b/开发文档/平台分析/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 等见逆向分析文档。 diff --git a/机擎/SKILL.md b/机擎/SKILL.md index b70de73278..e394e63be8 100644 --- a/机擎/SKILL.md +++ b/机擎/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 | diff --git a/机擎/阿机/SKILL.md b/机擎/阿机/SKILL.md index a3dcdbee13..5eea338446 100644 --- a/机擎/阿机/SKILL.md +++ b/机擎/阿机/SKILL.md @@ -33,7 +33,7 @@ | 设备端 Skill | sdk/agent/skills/{wechat,douyin,xhs,xianyu}/skill.py | | 后端实现文档 | 开发文档/6、后端/ | | 交互矩阵（先对照再开发） | 机擎/references/业务-服务端-设备端交互矩阵.md | -| 系统架构 | 开发文档/2、架构/系统架构.md | +| 系统架构 | 开发文档/2、架构/01-总览/系统架构.md | --- diff --git a/机擎/阿表/SKILL.md b/机擎/阿表/SKILL.md index 31f7e253fc..298b33133f 100644 --- a/机擎/阿表/SKILL.md +++ b/机擎/阿表/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)。 diff --git a/机擎/阿表/开发文档结构规范/SKILL.md b/机擎/阿表/开发文档结构规范/SKILL.md new file mode 100644 index 0000000000..a42bbbe04f --- /dev/null +++ b/机擎/阿表/开发文档结构规范/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) diff --git a/资料/XESlciw与Frida及机擎详细对比分析.md b/资料/XESlciw与Frida及机擎详细对比分析.md index 5325fd11c6..dce12b0cf4 100644 --- a/资料/XESlciw与Frida及机擎详细对比分析.md +++ b/资料/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 | diff --git a/资料/个微方案全网对比_优于Frida与奥创.md b/资料/个微方案全网对比_优于Frida与奥创.md index 7a4931d37e..e3b34950fc 100644 --- a/资料/个微方案全网对比_优于Frida与奥创.md +++ b/资料/个微方案全网对比_优于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 | diff --git a/资料/奥创.md b/资料/奥创.md index 87ac667650..b5e1f8ff63 100644 --- a/资料/奥创.md +++ b/资料/奥创.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 | diff --git a/资料/奥创微信控制接口与插件提取复用指南.md b/资料/奥创微信控制接口与插件提取复用指南.md index f7294e7e73..5f3be70a79 100644 --- a/资料/奥创微信控制接口与插件提取复用指南.md +++ b/资料/奥创微信控制接口与插件提取复用指南.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 | diff --git a/资料/机擎复刻Frida与奥创管理注入_实现路径.md b/资料/机擎复刻Frida与奥创管理注入_实现路径.md index 3847aac93b..95224755aa 100644 --- a/资料/机擎复刻Frida与奥创管理注入_实现路径.md +++ b/资料/机擎复刻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 |