From 30c8a20ca80508c1006197b7a2f0ef9b5ae1a440 Mon Sep 17 00:00:00 2001 From: Manus AI Date: Sun, 24 May 2026 09:17:37 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BC=80=E5=8F=91=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E7=B4=A2=E5=BC=95=E8=A1=A5=2000/6=E6=B5=8B=E8=AF=95=20=C2=B7?= =?UTF-8?q?=20=E8=84=9A=E6=9C=AC=E8=B7=AF=E5=BE=84=20tools=20=E7=BA=A0?= =?UTF-8?q?=E5=81=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 开发文档 README 链到项目总览；验收脚本内 tools/ 引用改为 6、测试/scripts/。 Co-authored-by: Cursor --- 开发文档/10、项目管理/工作日志.md | 1 + .../scripts/extract_wechat_sdk_control_interfaces_1838.py | 2 +- 开发文档/6、测试/scripts/inventory_routes.py | 2 +- 开发文档/6、测试/scripts/live_phone_verify.py | 2 +- 开发文档/8、部署/04-Gitea门户/gitea/README.md | 4 ++-- 开发文档/8、部署/04-Gitea门户/wiki-gitea/完整整合手册.md | 7 ++----- 开发文档/README.md | 8 ++++++-- 7 files changed, 14 insertions(+), 12 deletions(-) diff --git a/开发文档/10、项目管理/工作日志.md b/开发文档/10、项目管理/工作日志.md index 4f201a2650..cb95ea07dd 100644 --- a/开发文档/10、项目管理/工作日志.md +++ b/开发文档/10、项目管理/工作日志.md @@ -20,6 +20,7 @@ ### 进度 - 根目录非 SDK 整理：**100%** +- 补全包目录移除：**100%**（`f5df311` 已推 GitHub） - 总进度：**99.5%** --- diff --git a/开发文档/6、测试/scripts/extract_wechat_sdk_control_interfaces_1838.py b/开发文档/6、测试/scripts/extract_wechat_sdk_control_interfaces_1838.py index 8efef33976..f606ec1314 100644 --- a/开发文档/6、测试/scripts/extract_wechat_sdk_control_interfaces_1838.py +++ b/开发文档/6、测试/scripts/extract_wechat_sdk_control_interfaces_1838.py @@ -277,7 +277,7 @@ def write_outputs(items: list[InterfaceItem]) -> tuple[Path, Path, Path]: ## 一、扫描结论 -本次从 `sdk/app/routers`、`sdk/app/services`、`sdk/agent/hook`、`sdk/tests`、`tools` 中提取服务器路由、Python 符号和 Frida/JS 符号。扫描结果仅作为接口矩阵初稿，下一步还必须结合真实调用链和真机证据复核。 +本次从 `sdk/app/routers`、`sdk/app/services`、`sdk/agent/hook`、`sdk/tests`、`开发文档/6、测试/scripts` 中提取服务器路由、Python 符号和 Frida/JS 符号。扫描结果仅作为接口矩阵初稿，下一步还必须结合真实调用链和真机证据复核。 | 指标 | 数量 | |---|---:| diff --git a/开发文档/6、测试/scripts/inventory_routes.py b/开发文档/6、测试/scripts/inventory_routes.py index 2c9c39d6f6..034af77c26 100644 --- a/开发文档/6、测试/scripts/inventory_routes.py +++ b/开发文档/6、测试/scripts/inventory_routes.py @@ -93,7 +93,7 @@ def main(): "reason": reason, }) routes = [r for r in routes if "method" in r] - md = ["# 110接口真机验证清单", "", "本清单由 `tools/inventory_routes.py` 自动扫描 SDK 路由生成，优先服务于 Type-C 连接真机验证。", "", "| 序号 | 方法 | 路径 | 函数 | 文件 | 分类 | 原因 |", "|---:|---|---|---|---|---|---|"] + md = ["# 110接口真机验证清单", "", "本清单由 `开发文档/6、测试/scripts/inventory_routes.py` 自动扫描 SDK 路由生成，优先服务于 Type-C 连接真机验证。", "", "| 序号 | 方法 | 路径 | 函数 | 文件 | 分类 | 原因 |", "|---:|---|---|---|---|---|---|"] for i, r in enumerate(routes, 1): md.append(f"| {i} | {r['method']} | `{r['path']}` | `{r['function']}` | `{r['file']}:{r['line']}` | {r['verify_class']} | {r['reason']} |") summary = {} diff --git a/开发文档/6、测试/scripts/live_phone_verify.py b/开发文档/6、测试/scripts/live_phone_verify.py index 930e275ecc..012b58fc1b 100644 --- a/开发文档/6、测试/scripts/live_phone_verify.py +++ b/开发文档/6、测试/scripts/live_phone_verify.py @@ -80,7 +80,7 @@ def capture(name: str) -> str: def load_routes(limit: int) -> list[dict[str, Any]]: inv = OUT_DIR / "接口清单.json" if not inv.exists(): - run(["python3", "tools/inventory_routes.py"], timeout=60) + run(["python3", str(ROOT / "开发文档" / "6、测试" / "scripts" / "inventory_routes.py")], timeout=60) data = json.loads(inv.read_text(encoding="utf-8")) routes = [] for r in data.get("routes", []): diff --git a/开发文档/8、部署/04-Gitea门户/gitea/README.md b/开发文档/8、部署/04-Gitea门户/gitea/README.md index 9e9873df8d..d4f68adccd 100644 --- a/开发文档/8、部署/04-Gitea门户/gitea/README.md +++ b/开发文档/8、部署/04-Gitea门户/gitea/README.md @@ -9,10 +9,10 @@ | [PROJECTS.md](./PROJECTS.md) | 看板列与里程碑建议 | | [WIKI_SYNC.md](./WIKI_SYNC.md) | 百科与仓库 `docs/wiki-gitea` 的对应关系 | -百科 Markdown 源文件目录：**`docs/wiki-gitea/`**（推代码后仍在仓库内；同步到 Gitea Wiki 用 **`python3 docs/gitea/publish_wiki.py`**）。 +百科 Markdown 源文件目录：**`开发文档/8、部署/04-Gitea门户/wiki-gitea/`**（推代码后仍在仓库内；同步到 Gitea Wiki 用 **`python3 开发文档/8、部署/04-Gitea门户/gitea/publish_wiki.py`**）。 NAS 离线期间已在 GitHub 推送时，恢复后一键补推： ```bash -bash docs/gitea/sync_when_online.sh +bash 开发文档/8、部署/04-Gitea门户/gitea/sync_when_online.sh ``` diff --git a/开发文档/8、部署/04-Gitea门户/wiki-gitea/完整整合手册.md b/开发文档/8、部署/04-Gitea门户/wiki-gitea/完整整合手册.md index 2234eefba9..c56d3c2fe8 100644 --- a/开发文档/8、部署/04-Gitea门户/wiki-gitea/完整整合手册.md +++ b/开发文档/8、部署/04-Gitea门户/wiki-gitea/完整整合手册.md @@ -7,7 +7,7 @@ ## 一句话 -`补全包/` 与 `工作手机SDK补全包_微信Frida/` 的 Frida 闭环文档 **已全部并入开发文档一份**；日常只读主手册，代码只认 `sdk/`。 +`补全包/` 与 `工作手机SDK补全包_微信Frida/` 的 Frida 闭环 **已收编进 `sdk/` 并移除根目录**；日常只读主手册，代码只认 `sdk/`。 ## 内容目录（Wiki 摘要） @@ -61,10 +61,7 @@ cd sdk/agent && python3 agent.py --server ws://127.0.0.1:8899/ws/device/ **🗂️ 项目目录总览（Obsidian 入口）**：[00-项目总览/README.md](00-项目总览/README.md) + > ## 📖 必读 · 完整整合手册（补全包已并入） > > **[9、手册/工作手机·五图总览与使用手册.md](9、手册/工作手机·五图总览与使用手册.md)** — v2.1 @@ -62,7 +64,7 @@ | **一、需求与架构** | 1、需求；2、架构；3、原型 | 需求、架构设计、原型规范 | | **二、开发与接口** | 4、前端；5、接口；6、后端 | 前端/接口/后端实现与规范 | | **三、部署与数据** | 7、数据库；8、部署 | 数据库、部署与凭证 | -| **四、手册、验收与平台分析** | 9、手册；10、项目管理；**平台分析** | 操作手册、进度验收；**各平台（如 Soul）专项分析统一放在「平台分析」** | +| **四、手册、验收与平台分析** | 9、手册；10、项目管理；**6、测试**；**平台分析** | 操作手册、进度验收、真机验收脚本与截图；**各平台（如 Soul）专项分析统一放在「平台分析」** | - **平台分析**：按平台分子目录（如 `平台分析/Soul/`），该平台的所有文档（项目分析、接口与功能清单、自动化方案等）**只放在该平台目录内**，不散落在 1～10 其他目录。 - 根目录**不放置**除本 README 以外的文档。 @@ -80,7 +82,9 @@ | [5、接口](5、接口/) | **分层** `01-规范与统一层/`～`05-交互图/`；OpenAPI 在 `04-OpenAPI/` | API 与对接 | | [6、后端](6、后端/) | **分层** `01-服务端/` `02-设备端/` `03-规范汇总/`；`docs/`、`github-repos/` 不动 | 服务端+Agent+规范 | | [7、数据库](7、数据库/) | **分层** `01-设计/` `02-规范/` | 数据层 | -| [8、部署](8、部署/) | **分层** `01-本地环境/` `02-设备Hook/` `03-运维同步/` | 部署与凭证 | +| [8、部署](8、部署/) | **分层** `01-本地环境/` `02-设备Hook/` `03-运维同步/` `04-Gitea门户/` | 部署、凭证、Wiki | +| [6、测试](6、测试/) | **分层** `scripts/` `screenshots/` `110项功能逐项确认/` | 验收脚本、真机截图、矩阵报告 | +| [00-项目总览](00-项目总览/) | 仓库顶层结构 + 架构总览图 | Obsidian 导航入口 | | [9、手册](9、手册/) | **主手册根目录** + `02-操作指南/` `03-验证/` `04-专项/`；`images/fig01～09` | 操作与验证 | | [10、项目管理](10、项目管理/) | **根目录真源** 3 文件 + `02-测试报告/` `03-计划与专项/` | 进度与验收（唯一进度入口） | | **[平台分析](平台分析/)** | 按平台分子目录 | **各平台专项：接口+功能+自动化方案统一放此处** |