diff --git a/.obsidian/snippets/workphone-devdoc.css b/.obsidian/snippets/workphone-devdoc.css index 8c55e0cc97..25cfe815f9 100644 --- a/.obsidian/snippets/workphone-devdoc.css +++ b/.obsidian/snippets/workphone-devdoc.css @@ -70,6 +70,12 @@ color: #0277BD !important; font-weight: 600; } +.nav-folder-title[data-path^="开发文档/6、后端/0"] > .nav-folder-title-content { + color: #0288D1 !important; +} +.nav-folder-title[data-path="开发文档/6、后端/images"] > .nav-folder-title-content { + color: #78909C !important; +} .nav-folder-title[data-path="开发文档/7、数据库"] > .nav-folder-title-content { color: #558B2F !important; font-weight: 600; diff --git a/开发文档/10、项目管理/工作日志.md b/开发文档/10、项目管理/工作日志.md index fe7ebc3365..5880b3c8c7 100644 --- a/开发文档/10、项目管理/工作日志.md +++ b/开发文档/10、项目管理/工作日志.md @@ -3059,3 +3059,13 @@ v3.1: Agent 内置 AI Brain → 心跳驱动自主决策 → Frida优先/u2兜 3. 机擎/开发文档 Skill/资料/手册 引用路径批量更新 **进度**: 99.5% + +--- + +### 2026-05-24 | 6、后端 顶层轻量分层 + +**完成项**: +1. 三主文档迁入 `01-服务端/` `02-设备端/` `03-规范汇总/` +2. `docs/`、`github-repos/` 未动;各层 README + images 占位 + +**进度**: 99.5% diff --git a/开发文档/6、后端/01-服务端/README.md b/开发文档/6、后端/01-服务端/README.md new file mode 100644 index 0000000000..a990b442ad --- /dev/null +++ b/开发文档/6、后端/01-服务端/README.md @@ -0,0 +1,9 @@ +--- +obsidian-color: "#0277BD" +--- + +# 01 · 服务端 + +| 文档 | 说明 | +|------|------| +| [SDK服务端实现文档.md](SDK服务端实现文档.md) | FastAPI、WebSocket Hub、unified API、脚本引擎 | diff --git a/开发文档/6、后端/SDK服务端实现文档.md b/开发文档/6、后端/01-服务端/SDK服务端实现文档.md similarity index 100% rename from 开发文档/6、后端/SDK服务端实现文档.md rename to 开发文档/6、后端/01-服务端/SDK服务端实现文档.md diff --git a/开发文档/6、后端/Agent端技能实现文档.md b/开发文档/6、后端/02-设备端/Agent端技能实现文档.md similarity index 100% rename from 开发文档/6、后端/Agent端技能实现文档.md rename to 开发文档/6、后端/02-设备端/Agent端技能实现文档.md diff --git a/开发文档/6、后端/02-设备端/README.md b/开发文档/6、后端/02-设备端/README.md new file mode 100644 index 0000000000..8e2ca6772a --- /dev/null +++ b/开发文档/6、后端/02-设备端/README.md @@ -0,0 +1,9 @@ +--- +obsidian-color: "#0277BD" +--- + +# 02 · 设备端 + +| 文档 | 说明 | +|------|------| +| [Agent端技能实现文档.md](Agent端技能实现文档.md) | Agent、u2、各平台 Skill、script/action/params | diff --git a/开发文档/6、后端/03-规范汇总/README.md b/开发文档/6、后端/03-规范汇总/README.md new file mode 100644 index 0000000000..0014406433 --- /dev/null +++ b/开发文档/6、后端/03-规范汇总/README.md @@ -0,0 +1,9 @@ +--- +obsidian-color: "#455A64" +--- + +# 03 · 规范汇总 + +| 文档 | 说明 | +|------|------| +| [后端规范与代码汇总.md](后端规范与代码汇总.md) | 编码规范摘要 + github核心代码 索引 | diff --git a/开发文档/6、后端/后端规范与代码汇总.md b/开发文档/6、后端/03-规范汇总/后端规范与代码汇总.md similarity index 100% rename from 开发文档/6、后端/后端规范与代码汇总.md rename to 开发文档/6、后端/03-规范汇总/后端规范与代码汇总.md diff --git a/开发文档/6、后端/README.md b/开发文档/6、后端/README.md index 94ca6c331e..414ba53adc 100644 --- a/开发文档/6、后端/README.md +++ b/开发文档/6、后端/README.md @@ -1,19 +1,40 @@ +--- +obsidian-color: "#0277BD" +cssclasses: + - devdoc-index +--- + # 6、后端 -**项目**:工作手机SDK v3.0(服务端 FastAPI + WebSocket Hub + 脚本引擎;设备端 Agent + u2 + 各 Skill;M5 脚本引擎约 75%,M8 Agent 约 95%。) - -**规则**:本目录除本 README 外最多 **3 个主文档**,与全站开发文档规则一致;子目录(github核心代码/、docs/)不计入 3 个主文档数量。 - -**当前项目状态**:总进度 96%;服务端 API、Agent 连接、微信 Skill 已完整,抖音/小红书服务端路由待补。进度以 [10、项目管理/开发进度总表.md](../10、项目管理/开发进度总表.md) 为准。 +**项目**:工作手机 SDK v3.0 — 服务端 FastAPI + WebSocket Hub;设备端 Agent + u2 + Skill +**规则**:顶层 **3 主文档** 已分层;`docs/`、`github核心代码/`、`github-repos/` **不计入** 3 文档限额且 **不移动**。 --- -## 本目录主文档(≤3) +## 目录树 -| 文档 | 说明 | +```text +6、后端/ +├── README.md +├── images/ +├── 01-服务端/ SDK服务端实现文档.md +├── 02-设备端/ Agent端技能实现文档.md +├── 03-规范汇总/ 后端规范与代码汇总.md +├── docs/ 深度技术文档(Hook/脚本/部署等) +├── github核心代码/ 核心代码索引 +└── github-repos/ 克隆仓库(勿改结构) +``` + +--- + +## 快速跳转 + +| 大类 | 入口 | |------|------| -| [SDK服务端实现文档.md](SDK服务端实现文档.md) | SDK 服务端实现 | -| [Agent端技能实现文档.md](Agent端技能实现文档.md) | Agent 端技能实现 | -| [后端规范与代码汇总.md](后端规范与代码汇总.md) | 后端规范摘要 + 核心代码汇总索引 | +| **01 服务端** | [SDK服务端实现文档.md](01-服务端/SDK服务端实现文档.md) | +| **02 设备端** | [Agent端技能实现文档.md](02-设备端/Agent端技能实现文档.md) | +| **03 规范汇总** | [后端规范与代码汇总.md](03-规范汇总/后端规范与代码汇总.md) | +| **深度文档** | [docs/](docs/) | +| **代码索引** | [github核心代码/README.md](github核心代码/README.md) | -**子目录**:`github核心代码/`(u2/DroidRun/闲鱼/抖音/Frida)、`docs/`(历史技术文档)。 +**维护规范**:[机擎/阿表/开发文档结构规范/SKILL.md](../../机擎/阿表/开发文档结构规范/SKILL.md) diff --git a/开发文档/6、后端/images/README.md b/开发文档/6、后端/images/README.md new file mode 100644 index 0000000000..85aa5c497c --- /dev/null +++ b/开发文档/6、后端/images/README.md @@ -0,0 +1,3 @@ +# images + +后端架构/流程 PNG 放此目录(按 `01-子类/` 分子文件夹)。 diff --git a/开发文档/README.md b/开发文档/README.md index 27b0096f29..69eeca3fd4 100644 --- a/开发文档/README.md +++ b/开发文档/README.md @@ -78,7 +78,7 @@ | [3、原型](3、原型/) | 原型设计规范 | 原型规范 | | [4、前端](4、前端/) | 前端开发规范、管理端前端开发规范、v0配置 | 前端规范 | | [5、接口](5、接口/) | **分层** `01-规范与统一层/`~`05-交互图/`;OpenAPI 在 `04-OpenAPI/` | API 与对接 | -| [6、后端](6、后端/) | SDK服务端实现文档、Agent端技能实现文档、后端规范与代码汇总 | 服务端+Agent+规范 | +| [6、后端](6、后端/) | **分层** `01-服务端/` `02-设备端/` `03-规范汇总/`;`docs/`、`github-repos/` 不动 | 服务端+Agent+规范 | | [7、数据库](7、数据库/) | 数据库设计文档、数据库管理规范 | 数据层 | | [8、部署](8、部署/) | 本地Docker部署指南、设备端Hook安装部署、本地环境凭证 | 部署与凭证 | | [9、手册](9、手册/) | **工作手机·五图总览与使用手册(v2.0 主入口)**、SDK操作手册、微信消息E2E验证指南 | 操作与验证;补全包文档已并入总览手册 | diff --git a/机擎/阿表/开发文档结构规范/SKILL.md b/机擎/阿表/开发文档结构规范/SKILL.md index 40c14ee38c..ddaf54bfdb 100644 --- a/机擎/阿表/开发文档结构规范/SKILL.md +++ b/机擎/阿表/开发文档结构规范/SKILL.md @@ -66,6 +66,20 @@ version: 1.0.0 **接口文档归类**:规范/统一层 → 01;对接方文档 → 02;Hook/微信 → 03;JSON → 04;HTML → 05。 +## 二C、`6、后端` 标准树(轻量,2026-05-24 起) + +```text +开发文档/6、后端/ +├── README.md +├── images/ +├── 01-服务端/ SDK服务端实现文档.md +├── 02-设备端/ Agent端技能实现文档.md +├── 03-规范汇总/ 后端规范与代码汇总.md +├── docs/ 深度文档(不移动) +├── github核心代码/ +└── github-repos/ 克隆库(禁止重组) +``` + ### 新架构资产归类决策树 ```text