From 6b4610019ed2b5a4a4dbe27a11f994a678ff0c74 Mon Sep 17 00:00:00 2001 From: Manus AI Date: Sun, 24 May 2026 09:01:11 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E6=89=8B=E5=86=8C):=209=E3=80=81=E6=89=8B?= =?UTF-8?q?=E5=86=8C=2002=EF=BD=9E04=20=E5=88=86=E5=B1=82=EF=BC=8C?= =?UTF-8?q?=E4=B8=BB=E6=89=8B=E5=86=8C=E7=95=99=E6=A0=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 副手册迁入操作/验证/专项子目录；五图总览内链与 HTML 同步。 Co-authored-by: Cursor --- .obsidian/snippets/workphone-devdoc.css | 4 +- 开发文档/10、项目管理/工作日志.md | 8 ++++ .../9、手册/{ => 02-操作指南}/SDK操作手册.md | 0 .../9、手册/{ => 02-操作指南}/使用与落地方案.md | 0 .../工作手机·一键接入与存客宝对接操作手册.md | 0 .../9、手册/{ => 03-验证}/微信消息E2E验证指南.md | 0 .../{ => 04-专项}/会议电视192.168.0.5接入说明.md | 0 .../9、手册/{ => 04-专项}/安装前配置检查规范.md | 0 .../{ => 04-专项}/设备端Agent安装与公司设备说明.md | 0 开发文档/9、手册/README.md | 38 +++++++++++++------ .../9、手册/工作手机·五图总览与使用手册.html | 8 ++-- .../9、手册/工作手机·五图总览与使用手册.md | 8 ++-- 开发文档/README.md | 4 +- 机擎/SKILL.md | 2 +- 机擎/阿端/SKILL.md | 10 ++--- 机擎/阿表/开发文档结构规范/SKILL.md | 1 + 16 files changed, 53 insertions(+), 30 deletions(-) rename 开发文档/9、手册/{ => 02-操作指南}/SDK操作手册.md (100%) rename 开发文档/9、手册/{ => 02-操作指南}/使用与落地方案.md (100%) rename 开发文档/9、手册/{ => 02-操作指南}/工作手机·一键接入与存客宝对接操作手册.md (100%) rename 开发文档/9、手册/{ => 03-验证}/微信消息E2E验证指南.md (100%) rename 开发文档/9、手册/{ => 04-专项}/会议电视192.168.0.5接入说明.md (100%) rename 开发文档/9、手册/{ => 04-专项}/安装前配置检查规范.md (100%) rename 开发文档/9、手册/{ => 04-专项}/设备端Agent安装与公司设备说明.md (100%) diff --git a/.obsidian/snippets/workphone-devdoc.css b/.obsidian/snippets/workphone-devdoc.css index 8ba88f2d27..39973f8efc 100644 --- a/.obsidian/snippets/workphone-devdoc.css +++ b/.obsidian/snippets/workphone-devdoc.css @@ -34,8 +34,8 @@ color: #1565C0 !important; font-weight: 600; } -.nav-folder-title[data-path="开发文档/9、手册/images"] > .nav-folder-title-content { - color: #78909C !important; +.nav-folder-title[data-path^="开发文档/9、手册/0"] > .nav-folder-title-content { + color: #0288D1 !important; } /* 10、项目管理 */ diff --git a/开发文档/10、项目管理/工作日志.md b/开发文档/10、项目管理/工作日志.md index fa726cbe3b..6553d07cbd 100644 --- a/开发文档/10、项目管理/工作日志.md +++ b/开发文档/10、项目管理/工作日志.md @@ -3088,3 +3088,11 @@ v3.1: Agent 内置 AI Brain → 心跳驱动自主决策 → Frida优先/u2兜 **完成项**: `01-概述/` `02-业务/` `03-调研/`；机擎对话沉淀路径 → `02-业务/业务需求.md` **进度**: 99.5% + +--- + +### 2026-05-24 | 9、手册 分层（主手册留根） + +**完成项**: 主手册/HTML 留根；操作/验证/专项迁入 `02/` `03/` `04/`；手册内链与 HTML 更新 + +**进度**: 99.5% diff --git a/开发文档/9、手册/SDK操作手册.md b/开发文档/9、手册/02-操作指南/SDK操作手册.md similarity index 100% rename from 开发文档/9、手册/SDK操作手册.md rename to 开发文档/9、手册/02-操作指南/SDK操作手册.md diff --git a/开发文档/9、手册/使用与落地方案.md b/开发文档/9、手册/02-操作指南/使用与落地方案.md similarity index 100% rename from 开发文档/9、手册/使用与落地方案.md rename to 开发文档/9、手册/02-操作指南/使用与落地方案.md diff --git a/开发文档/9、手册/工作手机·一键接入与存客宝对接操作手册.md b/开发文档/9、手册/02-操作指南/工作手机·一键接入与存客宝对接操作手册.md similarity index 100% rename from 开发文档/9、手册/工作手机·一键接入与存客宝对接操作手册.md rename to 开发文档/9、手册/02-操作指南/工作手机·一键接入与存客宝对接操作手册.md diff --git a/开发文档/9、手册/微信消息E2E验证指南.md b/开发文档/9、手册/03-验证/微信消息E2E验证指南.md similarity index 100% rename from 开发文档/9、手册/微信消息E2E验证指南.md rename to 开发文档/9、手册/03-验证/微信消息E2E验证指南.md diff --git a/开发文档/9、手册/会议电视192.168.0.5接入说明.md b/开发文档/9、手册/04-专项/会议电视192.168.0.5接入说明.md similarity index 100% rename from 开发文档/9、手册/会议电视192.168.0.5接入说明.md rename to 开发文档/9、手册/04-专项/会议电视192.168.0.5接入说明.md diff --git a/开发文档/9、手册/安装前配置检查规范.md b/开发文档/9、手册/04-专项/安装前配置检查规范.md similarity index 100% rename from 开发文档/9、手册/安装前配置检查规范.md rename to 开发文档/9、手册/04-专项/安装前配置检查规范.md diff --git a/开发文档/9、手册/设备端Agent安装与公司设备说明.md b/开发文档/9、手册/04-专项/设备端Agent安装与公司设备说明.md similarity index 100% rename from 开发文档/9、手册/设备端Agent安装与公司设备说明.md rename to 开发文档/9、手册/04-专项/设备端Agent安装与公司设备说明.md diff --git a/开发文档/9、手册/README.md b/开发文档/9、手册/README.md index e186e27460..f2bbc7629d 100644 --- a/开发文档/9、手册/README.md +++ b/开发文档/9、手册/README.md @@ -1,18 +1,32 @@ +--- +obsidian-color: "#1565C0" +cssclasses: + - devdoc-index +--- + # 9、手册 -**项目**：工作手机SDK v3.0（使用与操作以 SDK 操作手册、微信 E2E 验证为主；存客宝通过 API/SDK 调用。） - -**规则**：本目录除本 README 外最多 **3 个主文档**，与全站开发文档规则一致；超出须合并。**Soul 相关手册已迁至 [平台分析/Soul/](../平台分析/Soul/)**，不在此目录。 - -**当前项目状态**：总进度 100%；微信消息 E2E 可按验证指南执行（需本地 SDK+Agent+模拟器微信）。进度以 [10、项目管理/开发进度总表.md](../10、项目管理/开发进度总表.md) 为准。 +**主入口（根目录不动）**：[工作手机·五图总览与使用手册.md](工作手机·五图总览与使用手册.md) · [HTML](工作手机·五图总览与使用手册.html) · `./open_handbook.sh` --- -## 本目录主文档（≤3） +## 目录树 -| 文档 | 说明 | -|------|------| -| [工作手机·五图总览与使用手册.md](工作手机·五图总览与使用手册.md) | **唯一主入口（v2.1）**：五图 + **补全包已并入** + 九图（fig01～09）+ RPC + 无线部署；[HTML 可打印版](工作手机·五图总览与使用手册.html) | -| [SDK操作手册.md](SDK操作手册.md) | 一键启动、检查、验证（必看） | -| [微信消息E2E验证指南.md](微信消息E2E验证指南.md) | 微信发消息端到端验证 | -| [使用与落地方案.md](使用与落地方案.md) | 跳转至五图总览（落地方案已合并） | +```text +9、手册/ +├── 工作手机·五图总览与使用手册.md ← 唯一主入口（v2.1） +├── 工作手机·五图总览与使用手册.html +├── open_handbook.sh +├── images/ fig01～09 +├── 02-操作指南/ SDK / 一键接入 / 落地方案 +├── 03-验证/ 微信 E2E +└── 04-专项/ Agent安装 / 会议电视 / 配置检查 +``` + +| 子目录 | 内容 | +|--------|------| +| [02-操作指南](02-操作指南/) | SDK 操作、存客宝一键接入、落地方案跳转 | +| [03-验证](03-验证/) | 微信消息 E2E | +| [04-专项](04-专项/) | 设备说明、会议电视、安装前检查 | + +**维护规范**：[机擎/阿表/开发文档结构规范/SKILL.md](../../机擎/阿表/开发文档结构规范/SKILL.md) diff --git a/开发文档/9、手册/工作手机·五图总览与使用手册.html b/开发文档/9、手册/工作手机·五图总览与使用手册.html index 51e1b24de2..4152475794 100644 --- a/开发文档/9、手册/工作手机·五图总览与使用手册.html +++ b/开发文档/9、手册/工作手机·五图总览与使用手册.html @@ -468,15 +468,15 @@ python3 tools/wireless_frida_wechat_batch_verify.py 命令速查 -SDK操作手册.md +SDK操作手册.md E2E 验收 -微信消息E2E验证指南.md +微信消息E2E验证指南.md 存客宝对接 -工作手机·一键接入与存客宝对接操作手册.md +工作手机·一键接入与存客宝对接操作手册.md 接口 OpenAPI @@ -491,7 +491,7 @@ python3 tools/wireless_frida_wechat_batch_verify.py

以下文档 已并入本章，保留文件仅为旧链接锚点，勿再扩写：

十、版本记录

diff --git a/开发文档/9、手册/工作手机·五图总览与使用手册.md b/开发文档/9、手册/工作手机·五图总览与使用手册.md index 19ddd4b86a..6ff30ed368 100644 --- a/开发文档/9、手册/工作手机·五图总览与使用手册.md +++ b/开发文档/9、手册/工作手机·五图总览与使用手册.md @@ -293,16 +293,16 @@ python3 tools/wireless_frida_wechat_batch_verify.py | 补全包归档（只读对照） | `补全包/微信Frida_SDK_20260518/` · `工作手机SDK补全包_微信Frida/` | | 五图 + 附图原文件 | `images/workphone_fig01~09.png`（01～05 五图；06～07 无线真机；08～09 架构附） | | 架构详文 | [系统架构.md](../2、架构/01-总览/系统架构.md) | -| 命令速查 | [SDK操作手册.md](SDK操作手册.md) | -| E2E 验收 | [微信消息E2E验证指南.md](微信消息E2E验证指南.md) | -| 存客宝对接 | [工作手机·一键接入与存客宝对接操作手册.md](工作手机·一键接入与存客宝对接操作手册.md) | +| 命令速查 | [SDK操作手册.md](02-操作指南/SDK操作手册.md) | +| E2E 验收 | [微信消息E2E验证指南.md](03-验证/微信消息E2E验证指南.md) | +| 存客宝对接 | [工作手机·一键接入与存客宝对接操作手册.md](02-操作指南/工作手机·一键接入与存客宝对接操作手册.md) | | 接口 OpenAPI | [5、接口/04-OpenAPI/openapi_v3.0.json](../5、接口/04-OpenAPI/openapi_v3.0.json) | | 进度 | [开发进度总表.md](../10、项目管理/开发进度总表.md) | 以下文档 **已并入本章**，保留文件仅为旧链接锚点，勿再扩写： - [微信Frida_API契约.md](../5、接口/微信Frida_API契约.md) → 见 §3.1 -- [微信Frida无线部署与验证说明.md](../8、部署/微信Frida无线部署与验证说明.md) → 见 §八 +- [微信Frida无线部署与验证说明.md](../8、部署/02-设备Hook/微信Frida无线部署与验证说明.md) → 见 §八 --- diff --git a/开发文档/README.md b/开发文档/README.md index 8ab803c340..becbbe15b7 100644 --- a/开发文档/README.md +++ b/开发文档/README.md @@ -81,7 +81,7 @@ | [6、后端](6、后端/) | **分层** `01-服务端/` `02-设备端/` `03-规范汇总/`；`docs/`、`github-repos/` 不动 | 服务端+Agent+规范 | | [7、数据库](7、数据库/) | **分层** `01-设计/` `02-规范/` | 数据层 | | [8、部署](8、部署/) | **分层** `01-本地环境/` `02-设备Hook/` `03-运维同步/` | 部署与凭证 | -| [9、手册](9、手册/) | **工作手机·五图总览与使用手册（v2.0 主入口）**、SDK操作手册、微信消息E2E验证指南 | 操作与验证；补全包文档已并入总览手册 | +| [9、手册](9、手册/) | **主手册根目录** + `02-操作指南/` `03-验证/` `04-专项/`；`images/fig01～09` | 操作与验证 | | [10、项目管理](10、项目管理/) | **根目录真源** 3 文件 + `02-测试报告/` `03-计划与专项/` | 进度与验收（唯一进度入口） | | **[平台分析](平台分析/)** | 按平台分子目录 | **各平台专项：接口+功能+自动化方案统一放此处** | | [平台分析/Soul/](平台分析/Soul/) | Soul项目分析、Soul自动化方案与命令行操作 | **Soul 全部内容集中此目录** | @@ -94,6 +94,6 @@ cd sdk && ./scripts/start_sdk.sh ``` -> 路径以「工作手机」项目根目录为基准。详见 [9、手册/SDK操作手册.md](9、手册/SDK操作手册.md) +> 路径以「工作手机」项目根目录为基准。详见 [9、手册/02-操作指南/SDK操作手册.md](9、手册/02-操作指南/SDK操作手册.md) **统一测试账号**：15880802661 / kr123456（详见 [8、部署/01-本地环境/本地环境凭证.md](8、部署/01-本地环境/本地环境凭证.md)） diff --git a/机擎/SKILL.md b/机擎/SKILL.md index 19819eb3b9..dce6ba5dea 100644 --- a/机擎/SKILL.md +++ b/机擎/SKILL.md @@ -287,7 +287,7 @@ **接收方**：阿机 **任务**：微信发消息 E2E 测试发现 3 个 bug **当前状态**：测试完毕，bug 已记录 -**相关文件**：sdk/tests/test_wechat_e2e.py、开发文档/9、手册/微信消息E2E验证指南.md +**相关文件**：sdk/tests/test_wechat_e2e.py、开发文档/9、手册/03-验证/微信消息E2E验证指南.md **验收标准**： - [ ] bug1: send_message 超时未返回 → 需阿机修复 unified.py - [ ] bug2: 截图返回空 → 需阿机检查 adb 模块 diff --git a/机擎/阿端/SKILL.md b/机擎/阿端/SKILL.md index 1d247c4dbd..4561291392 100644 --- a/机擎/阿端/SKILL.md +++ b/机擎/阿端/SKILL.md @@ -27,12 +27,12 @@ |------|------| | E2E 脚本 | sdk/tests/test_wechat_e2e.py | | **完整整合手册（主入口）** | 开发文档/9、手册/工作手机·五图总览与使用手册.md | -| 微信 E2E 验证指南 | 开发文档/9、手册/微信消息E2E验证指南.md | -| SDK 操作手册 | 开发文档/9、手册/SDK操作手册.md | -| 使用与落地方案 | 开发文档/9、手册/使用与落地方案.md（→ 跳转主手册） | +| 微信 E2E 验证指南 | 开发文档/9、手册/03-验证/微信消息E2E验证指南.md | +| SDK 操作手册 | 开发文档/9、手册/02-操作指南/SDK操作手册.md | +| 使用与落地方案 | 开发文档/9、手册/02-操作指南/使用与落地方案.md（→ 跳转主手册） | | 前端规范与 v0 | 开发文档/4、前端/03-工具/v0配置.md、前端开发规范.md | -| 设备端Agent安装说明 | 开发文档/9、手册/设备端Agent安装与公司设备说明.md | -| 安装前配置检查 | 开发文档/9、手册/安装前配置检查规范.md | +| 设备端Agent安装说明 | 开发文档/9、手册/04-专项/设备端Agent安装与公司设备说明.md | +| 安装前配置检查 | 开发文档/9、手册/04-专项/安装前配置检查规范.md | --- diff --git a/机擎/阿表/开发文档结构规范/SKILL.md b/机擎/阿表/开发文档结构规范/SKILL.md index 8a432d7b41..b38be94bc7 100644 --- a/机擎/阿表/开发文档结构规范/SKILL.md +++ b/机擎/阿表/开发文档结构规范/SKILL.md @@ -93,6 +93,7 @@ version: 1.0.0 ```text 1、需求/01-概述/ 02-业务/ 03-调研/ + 修改/ 增量补丁 3、原型/01-规范/ | 4、前端/01～03/ | 7、数据库/01-设计/ 02-规范/ +9、手册/ 主手册留根 + 02-操作指南/ 03-验证/ 04-专项/ + images/ ``` ### 新架构资产归类决策树