docs: 开发文档索引补 00/6测试 · 脚本路径 tools 纠偏
开发文档 README 链到项目总览；验收脚本内 tools/ 引用改为 6、测试/scripts/。 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Manus AI
@@ -20,6 +20,7 @@
|
||||
|
||||
### 进度
|
||||
- 根目录非 SDK 整理：**100%**
|
||||
- 补全包目录移除：**100%**（`f5df311` 已推 GitHub）
|
||||
- 总进度：**99.5%**
|
||||
|
||||
---
|
||||
|
||||
@@ -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 符号。扫描结果仅作为接口矩阵初稿，下一步还必须结合真实调用链和真机证据复核。
|
||||
|
||||
| 指标 | 数量 |
|
||||
|---|---:|
|
||||
|
||||
@@ -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 = {}
|
||||
|
||||
@@ -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", []):
|
||||
|
||||
@@ -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
|
||||
```
|
||||
|
||||
@@ -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/<device_
|
||||
|
||||
## 归档对照
|
||||
|
||||
补全包源码仍留仓库根目录供 diff，README 均跳转主手册：
|
||||
|
||||
- `补全包/微信Frida_SDK_20260518/`
|
||||
- `工作手机SDK补全包_微信Frida/`
|
||||
2026-05-24 起根目录补全包已移除。历史 ZIP：`资料/archive/微信Frida_SDK_20260518_补全包.zip`；桥接模板：`sdk/agent/hook/wechat_hook_bridge.js`。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# 工作手机SDK v3.0 - 开发文档
|
||||
|
||||
> **🗂️ 项目目录总览（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-计划与专项/` | 进度与验收（唯一进度入口） |
|
||||
| **[平台分析](平台分析/)** | 按平台分子目录 | **各平台专项：接口+功能+自动化方案统一放此处** |
|
||||
|
||||
Reference in New Issue
Block a user