diff --git a/.obsidian/graph.json b/.obsidian/graph.json index e01e9d2df5..073371423f 100644 --- a/.obsidian/graph.json +++ b/.obsidian/graph.json @@ -1,7 +1,7 @@ { "collapse-filter": false, "search": "", - "showTags": false, + "showTags": true, "showAttachments": true, "hideUnresolved": false, "showOrphans": false, @@ -9,35 +9,59 @@ "colorGroups": [ { "query": "path:开发文档/2、架构/01-总览", - "color": { "a": 1, "rgb": 14010688 } + "color": { + "a": 1, + "rgb": 14010688 + } }, { "query": "path:开发文档/2、架构", - "color": { "a": 1, "rgb": 14010688 } + "color": { + "a": 1, + "rgb": 14010688 + } }, { "query": "path:开发文档/8、部署/05-测试验收", - "color": { "a": 1, "rgb": 16338757 } + "color": { + "a": 1, + "rgb": 16338757 + } }, { "query": "path:开发文档/8、部署", - "color": { "a": 1, "rgb": 5606192 } + "color": { + "a": 1, + "rgb": 5606192 + } }, { "query": "path:开发文档/9、手册", - "color": { "a": 1, "rgb": 14010688 } + "color": { + "a": 1, + "rgb": 14010688 + } }, { "query": "path:开发文档/10、项目管理", - "color": { "a": 1, "rgb": 12976168 } + "color": { + "a": 1, + "rgb": 12976168 + } }, { "query": "path:机擎", - "color": { "a": 1, "rgb": 6954649 } + "color": { + "a": 1, + "rgb": 6954649 + } }, { "query": "path:资料", - "color": { "a": 1, "rgb": 11337755 } + "color": { + "a": 1, + "rgb": 11337755 + } } ], "collapse-display": true, @@ -50,6 +74,6 @@ "repelStrength": 10, "linkStrength": 1, "linkDistance": 200, - "scale": 0.9, + "scale": 1.0913542234099265, "close": false -} +} \ No newline at end of file diff --git a/开发文档/10、项目管理/02-测试报告/110个接口全面测试报告.md b/开发文档/10、项目管理/02-测试报告/110个接口全面测试报告.md index dfdeaedd1b..d9f4ac11d8 100644 --- a/开发文档/10、项目管理/02-测试报告/110个接口全面测试报告.md +++ b/开发文档/10、项目管理/02-测试报告/110个接口全面测试报告.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 项目管理 + - 测试报告 + - 主文档 +doc-type: 主文档 +layer: 10、项目管理/02-测试报告 +parent: [[10、项目管理/02-测试报告/README|02-测试报告]] +related: + - "[[开发进度总表]]" + - "[[工作日志]]" + - "[[项目目录总览]]" + - "[[开发文档/README|开发文档总入口]]" +--- # 微信 Hook 接口全面测试报告 (110个接口) > **测试日期**：2026-05-15 @@ -54,3 +69,9 @@ --- *Manus AI 自动化测试中心* +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[10、项目管理/02-测试报告/README|02-测试报告]] | +| ↔ 相关 | [[开发进度总表]] · [[工作日志]] · [[项目目录总览]] · [[开发文档/README|开发文档总入口]] | diff --git a/开发文档/10、项目管理/02-测试报告/110个接口视觉验证报告.md b/开发文档/10、项目管理/02-测试报告/110个接口视觉验证报告.md index 7c9b7aa507..7d354de1c6 100644 --- a/开发文档/10、项目管理/02-测试报告/110个接口视觉验证报告.md +++ b/开发文档/10、项目管理/02-测试报告/110个接口视觉验证报告.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 项目管理 + - 测试报告 + - 主文档 +doc-type: 主文档 +layer: 10、项目管理/02-测试报告 +parent: [[10、项目管理/02-测试报告/README|02-测试报告]] +related: + - "[[开发进度总表]]" + - "[[工作日志]]" + - "[[项目目录总览]]" + - "[[开发文档/README|开发文档总入口]]" +--- # 微信 Hook 接口视觉验证报告 (110个接口全量) > **测试结论**：✅ **110个接口全部验证成功** @@ -34,3 +49,9 @@ --- *报告由 Manus 自动化视觉验证套件生成* +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[10、项目管理/02-测试报告/README|02-测试报告]] | +| ↔ 相关 | [[开发进度总表]] · [[工作日志]] · [[项目目录总览]] · [[开发文档/README|开发文档总入口]] | diff --git a/开发文档/10、项目管理/02-测试报告/Frida接口开发与对接进度.md b/开发文档/10、项目管理/02-测试报告/Frida接口开发与对接进度.md index fcef5e01de..b33f4f4be7 100644 --- a/开发文档/10、项目管理/02-测试报告/Frida接口开发与对接进度.md +++ b/开发文档/10、项目管理/02-测试报告/Frida接口开发与对接进度.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 项目管理 + - 测试报告 + - 主文档 +doc-type: 主文档 +layer: 10、项目管理/02-测试报告 +parent: [[10、项目管理/02-测试报告/README|02-测试报告]] +related: + - "[[开发进度总表]]" + - "[[工作日志]]" + - "[[项目目录总览]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[设备端Hook安装部署]]" +--- # Frida 接口开发与存客宝对接进度 > **最后更新**：2026-05-15 08:00 (GMT+8) @@ -117,3 +133,9 @@ **当前总开发进度：52%** **当前阶段进度：100%（存客宝对接核心模块）** +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[10、项目管理/02-测试报告/README|02-测试报告]] | +| ↔ 相关 | [[开发进度总表]] · [[工作日志]] · [[项目目录总览]] · [[开发文档/README|开发文档总入口]] · [[设备端Hook安装部署]] | diff --git a/开发文档/10、项目管理/02-测试报告/README.md b/开发文档/10、项目管理/02-测试报告/README.md index 8eae2b4770..5f01e22329 100644 --- a/开发文档/10、项目管理/02-测试报告/README.md +++ b/开发文档/10、项目管理/02-测试报告/README.md @@ -1,7 +1,25 @@ --- -obsidian-color: "#F9A825" +tags: + - 工作手机 + - 项目管理 + - 测试报告 + - 索引 +doc-type: 索引 +layer: 10、项目管理/02-测试报告 +parent: [[README|10、项目管理]] +related: + - "[[开发进度总表]]" + - "[[工作日志]]" + - "[[项目目录总览]]" + - "[[开发文档/README|开发文档总入口]]" +obsidian-color: #F9A825 --- # 02 · 测试报告 验收/E2E/Frida 专项报告（非进度真源，真源见上级 `开发进度总表.md`）。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[开发进度总表]] · [[工作日志]] · [[项目目录总览]] · [[开发文档/README|开发文档总入口]] | diff --git a/开发文档/10、项目管理/02-测试报告/全端交互测试报告.md b/开发文档/10、项目管理/02-测试报告/全端交互测试报告.md index 297990df6a..750031d9dc 100644 --- a/开发文档/10、项目管理/02-测试报告/全端交互测试报告.md +++ b/开发文档/10、项目管理/02-测试报告/全端交互测试报告.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 项目管理 + - 测试报告 + - 主文档 +doc-type: 主文档 +layer: 10、项目管理/02-测试报告 +parent: [[10、项目管理/02-测试报告/README|02-测试报告]] +related: + - "[[开发进度总表]]" + - "[[工作日志]]" + - "[[项目目录总览]]" + - "[[开发文档/README|开发文档总入口]]" +--- # Frida Hook 全量真机测试报告 > 设备: 21121119SC (dc9c23e00510) | Android 11 | WeChat 8.0.69 | Frida 16.5.6 @@ -230,4 +245,10 @@ - **getDeviceInfo**: TypeError: cannot read property 'RELEASE' of undefined - **getFavorites**: Favorite.db 未找到 -- **setNickname**: 缺少 nickname \ No newline at end of file +- **setNickname**: 缺少 nickname +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[10、项目管理/02-测试报告/README|02-测试报告]] | +| ↔ 相关 | [[开发进度总表]] · [[工作日志]] · [[项目目录总览]] · [[开发文档/README|开发文档总入口]] | diff --git a/开发文档/10、项目管理/03-计划与专项/README.md b/开发文档/10、项目管理/03-计划与专项/README.md index 69d7b187b9..8e587818ab 100644 --- a/开发文档/10、项目管理/03-计划与专项/README.md +++ b/开发文档/10、项目管理/03-计划与专项/README.md @@ -1,7 +1,25 @@ --- -obsidian-color: "#F9A825" +tags: + - 工作手机 + - 项目管理 + - 计划与专项 + - 索引 +doc-type: 索引 +layer: 10、项目管理/03-计划与专项 +parent: [[README|10、项目管理]] +related: + - "[[开发进度总表]]" + - "[[工作日志]]" + - "[[项目目录总览]]" + - "[[开发文档/README|开发文档总入口]]" +obsidian-color: #F9A825 --- # 03 · 计划与专项 落地执行表、APK 产品说明、五方向调研等规划类文档。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[开发进度总表]] · [[工作日志]] · [[项目目录总览]] · [[开发文档/README|开发文档总入口]] | diff --git a/开发文档/10、项目管理/03-计划与专项/五方向学习与调查结论.md b/开发文档/10、项目管理/03-计划与专项/五方向学习与调查结论.md index 1121372278..8979f8bbda 100644 --- a/开发文档/10、项目管理/03-计划与专项/五方向学习与调查结论.md +++ b/开发文档/10、项目管理/03-计划与专项/五方向学习与调查结论.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 项目管理 + - 计划与专项 + - 主文档 +doc-type: 主文档 +layer: 10、项目管理/03-计划与专项 +parent: [[10、项目管理/03-计划与专项/README|03-计划与专项]] +related: + - "[[开发进度总表]]" + - "[[工作日志]]" + - "[[项目目录总览]]" + - "[[开发文档/README|开发文档总入口]]" +--- # 五方向学习与调查结论 > **来源**：用户要求安置五个问题方向，向卡若AI 分配学习与调查并继续完成 @@ -44,3 +59,9 @@ - 存客宝/触客宝接入时，直接使用 PHP/TS SDK 最新类型，便于处理 `data.success`、`data.error_code`、`data.sent/failed/total`。 - 联调排障：先看 `/health`、设备列表、[message/send] 日志与 9、手册/微信消息E2E验证指南。 - 新需求或新接口：先更新 unified 与 接口规范，再由阿桥同步两 SDK 与本文档。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[10、项目管理/03-计划与专项/README|03-计划与专项]] | +| ↔ 相关 | [[开发进度总表]] · [[工作日志]] · [[项目目录总览]] · [[开发文档/README|开发文档总入口]] | diff --git a/开发文档/10、项目管理/03-计划与专项/工作手机APK产品说明与审核.md b/开发文档/10、项目管理/03-计划与专项/工作手机APK产品说明与审核.md index 2c2715f1de..523cac3ba6 100644 --- a/开发文档/10、项目管理/03-计划与专项/工作手机APK产品说明与审核.md +++ b/开发文档/10、项目管理/03-计划与专项/工作手机APK产品说明与审核.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 项目管理 + - 计划与专项 + - 主文档 +doc-type: 主文档 +layer: 10、项目管理/03-计划与专项 +parent: [[10、项目管理/03-计划与专项/README|03-计划与专项]] +related: + - "[[开发进度总表]]" + - "[[工作日志]]" + - "[[项目目录总览]]" + - "[[开发文档/README|开发文档总入口]]" +--- # 工作手机 APK 产品说明与审核 > 用于产品说明与审核。本应用为**工作手机被控端**，安装于被控制的手机上，主要连接工作手机服务端、用于被远程控制。 @@ -55,3 +70,9 @@ ## 说明 上述正文已写清：工作手机被控端定位、有 Root/无 Root 两版、安装后自动连接服务端并向服务端反应、静默安装与静默弹窗要求、七类控制能力、角色边界与交付形态，便于开发与审核对照。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[10、项目管理/03-计划与专项/README|03-计划与专项]] | +| ↔ 相关 | [[开发进度总表]] · [[工作日志]] · [[项目目录总览]] · [[开发文档/README|开发文档总入口]] | diff --git a/开发文档/10、项目管理/03-计划与专项/项目落地执行表.md b/开发文档/10、项目管理/03-计划与专项/项目落地执行表.md index af90790d9f..c794561234 100644 --- a/开发文档/10、项目管理/03-计划与专项/项目落地执行表.md +++ b/开发文档/10、项目管理/03-计划与专项/项目落地执行表.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 项目管理 + - 计划与专项 + - 主文档 +doc-type: 主文档 +layer: 10、项目管理/03-计划与专项 +parent: [[10、项目管理/03-计划与专项/README|03-计划与专项]] +related: + - "[[开发进度总表]]" + - "[[工作日志]]" + - "[[项目目录总览]]" + - "[[开发文档/README|开发文档总入口]]" +--- # 项目落地执行表 > **人设**：Atlas (Manus QA Owner) @@ -370,3 +385,9 @@ **总结**：本轮完成接口接线、skill 安装和事实校准，给后续继续开发微信控制接口建立了可追踪矩阵。 **下一步执行**：优先补齐 v9 Hook 中缺失的读类 RPC，并按矩阵分批真机验证；写类动作必须使用测试对象和显式参数，禁止默认触发支付、改密、解绑、删好友等高风险动作。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[10、项目管理/03-计划与专项/README|03-计划与专项]] | +| ↔ 相关 | [[开发进度总表]] · [[工作日志]] · [[项目目录总览]] · [[开发文档/README|开发文档总入口]] | diff --git a/开发文档/10、项目管理/README.md b/开发文档/10、项目管理/README.md index 6a789f62d9..c5b63655ff 100644 --- a/开发文档/10、项目管理/README.md +++ b/开发文档/10、项目管理/README.md @@ -1,5 +1,17 @@ --- -obsidian-color: "#C62828" +tags: + - 工作手机 + - 项目管理 + - 索引 +doc-type: 索引 +layer: 10、项目管理 +parent: [[10、项目管理/README|10、项目管理]] +related: + - "[[开发进度总表]]" + - "[[工作日志]]" + - "[[项目目录总览]]" + - "[[开发文档/README|开发文档总入口]]" +obsidian-color: #C62828 cssclasses: - devdoc-index --- @@ -29,3 +41,8 @@ cssclasses: | [03-计划与专项](03-计划与专项/) | 落地执行表、产品说明、调研结论 | 模块拆解：[2、架构/01-总览/系统架构.md §3.0](../2、架构/01-总览/系统架构.md) +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[开发进度总表]] · [[工作日志]] · [[项目目录总览]] · [[开发文档/README|开发文档总入口]] | diff --git a/开发文档/10、项目管理/工作日志.md b/开发文档/10、项目管理/工作日志.md index a7df61d4cb..4e96b830ac 100644 --- a/开发文档/10、项目管理/工作日志.md +++ b/开发文档/10、项目管理/工作日志.md @@ -3434,4 +3434,15 @@ v3.1: Agent 内置 AI Brain → 心跳驱动自主决策 → Frida优先/u2兜 **进度**: 99.5% +--- + +### 2026-05-24 | 开发文档标签与关联（Obsidian 图谱） + +**完成项**: +1. `机擎/阿表/开发文档结构规范/SKILL.md` 新增 **§四B 标签与关联规范** +2. 脚本 `8、部署/05-测试验收/scripts/apply_doc_tags_links.py` 批量处理 **158** 篇 MD（tags/related/parent + 🔗 关联导航） +3. `.obsidian/graph.json` 开启 `showTags`；`机擎/SKILL.md` 与 `开发文档/README.md` 同步说明 + +**进度**: 99.5% + --- \ No newline at end of file diff --git a/开发文档/10、项目管理/开发进度总表.md b/开发文档/10、项目管理/开发进度总表.md index 63642386e1..b74b3654a8 100644 --- a/开发文档/10、项目管理/开发进度总表.md +++ b/开发文档/10、项目管理/开发进度总表.md @@ -1,3 +1,17 @@ +--- +tags: + - 工作手机 + - 项目管理 + - 进度 +doc-type: 进度 +layer: 10、项目管理 +parent: [[10、项目管理/README|10、项目管理]] +related: + - "[[开发进度总表]]" + - "[[工作日志]]" + - "[[项目目录总览]]" + - "[[开发文档/README|开发文档总入口]]" +--- # 工作手机SDK v3.1 → v4.0 - 开发进度总表 > **唯一进度文档** | 更新：2026-05-05 @@ -460,3 +474,9 @@ Phase 5: 防封模块 ✅ 已完成 ← AF1-AF12 全部完成 **当前总开发百分比：20%** **当前开发进度百分比：0% (本阶段)** +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[10、项目管理/README|10、项目管理]] | +| ↔ 相关 | [[开发进度总表]] · [[工作日志]] · [[项目目录总览]] · [[开发文档/README|开发文档总入口]] | diff --git a/开发文档/10、项目管理/验收与项目说明.md b/开发文档/10、项目管理/验收与项目说明.md index 4e96e6044b..8ea6808acd 100644 --- a/开发文档/10、项目管理/验收与项目说明.md +++ b/开发文档/10、项目管理/验收与项目说明.md @@ -1,3 +1,17 @@ +--- +tags: + - 工作手机 + - 项目管理 + - 主文档 +doc-type: 主文档 +layer: 10、项目管理 +parent: [[10、项目管理/README|10、项目管理]] +related: + - "[[开发进度总表]]" + - "[[工作日志]]" + - "[[项目目录总览]]" + - "[[开发文档/README|开发文档总入口]]" +--- # 验收与项目说明（合并） > 合并自：验收清单、对接清单、差距分析与完成报告、开发计划、项目管理说明与计划 | 更新：2026-02-07 @@ -197,3 +211,9 @@ curl -s -X POST http://localhost:8081/v1/auth/login -H "Content-Type: applicatio | 通讯录/聊天记录 | 📋 | 后期扩展 | **遗留**：微信消息 E2E（高）、通讯录/聊天记录（中）。**启动验证**：`cd sdk && ./scripts/start_sdk.sh`；存客宝后端 `cd cunkebao_v3/Server && php -S 0.0.0.0:8081 -t public`。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[10、项目管理/README|10、项目管理]] | +| ↔ 相关 | [[开发进度总表]] · [[工作日志]] · [[项目目录总览]] · [[开发文档/README|开发文档总入口]] | diff --git a/开发文档/1、需求/01-概述/README.md b/开发文档/1、需求/01-概述/README.md index ab0feec988..27cf073721 100644 --- a/开发文档/1、需求/01-概述/README.md +++ b/开发文档/1、需求/01-概述/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#5E35B1" +tags: + - 工作手机 + - 需求 + - 概述 + - 索引 +doc-type: 索引 +layer: 1、需求/01-概述 +parent: [[README|1、需求]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #5E35B1 --- # 01 · 概述 @@ -7,3 +21,8 @@ obsidian-color: "#5E35B1" | 文档 | 说明 | |------|------| | [项目概述.md](项目概述.md) | 背景、愿景、成本估算 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/01-概述/项目概述.md b/开发文档/1、需求/01-概述/项目概述.md index 776b01f07b..1a8d4b2792 100644 --- a/开发文档/1、需求/01-概述/项目概述.md +++ b/开发文档/1、需求/01-概述/项目概述.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 需求 + - 概述 + - 主文档 +doc-type: 主文档 +layer: 1、需求/01-概述 +parent: [[1、需求/01-概述/README|01-概述]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK v3.0 项目概述 > 版本：v3.0 | 更新：2026-01-26 | 状态：开发中 > @@ -220,3 +236,9 @@ | 开发资源 | 2人全职 | | 测试设备 | 5台红米 | | 互联网资源 | 闲鱼有完整开源；微信需自研 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[1、需求/01-概述/README|01-概述]] | +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/02-业务/README.md b/开发文档/1、需求/02-业务/README.md index bf2e62f611..f5b9c54c42 100644 --- a/开发文档/1、需求/02-业务/README.md +++ b/开发文档/1、需求/02-业务/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#5E35B1" +tags: + - 工作手机 + - 需求 + - 业务 + - 索引 +doc-type: 索引 +layer: 1、需求/02-业务 +parent: [[README|1、需求]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #5E35B1 --- # 02 · 业务 @@ -7,3 +21,8 @@ obsidian-color: "#5E35B1" | 文档 | 说明 | |------|------| | [业务需求.md](业务需求.md) | 功能清单、KPI、竞品；**对话沉淀需求**章节（机擎每轮追加） | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/02-业务/业务需求.md b/开发文档/1、需求/02-业务/业务需求.md index 81fbf7a9cb..f67ef028ad 100644 --- a/开发文档/1、需求/02-业务/业务需求.md +++ b/开发文档/1、需求/02-业务/业务需求.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 需求 + - 业务 + - 主文档 +doc-type: 主文档 +layer: 1、需求/02-业务 +parent: [[1、需求/02-业务/README|02-业务]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK v3.0 业务需求文档 > 创建日期：2026-01-26 | 负责人：卡若 | 状态：已确认 @@ -408,3 +424,9 @@ $sdk->execute($deviceId, 'wechat', 'send_message', [ | SA5 | 查询 AI Brain 状态 API | 已完成 | GET /devices/{id}/ai/status | | SA6 | AI Agent 同步执行 API | 已完成 | POST /devices/{id}/ai/execute | | SA7 | 默认 standing_orders（3条） | 已完成 | config.json | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[1、需求/02-业务/README|02-业务]] | +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/03-调研/README.md b/开发文档/1、需求/03-调研/README.md index d75786aeb6..6cc8932895 100644 --- a/开发文档/1、需求/03-调研/README.md +++ b/开发文档/1、需求/03-调研/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#5E35B1" +tags: + - 工作手机 + - 需求 + - 调研 + - 索引 +doc-type: 索引 +layer: 1、需求/03-调研 +parent: [[README|1、需求]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #5E35B1 --- # 03 · 调研 @@ -8,3 +22,8 @@ obsidian-color: "#5E35B1" |------|------| | [技术调研与方案选型.md](技术调研与方案选型.md) | 奥创拆解、Frida/Hook 方案对比、选型结论 | | [平台分析/](平台分析/) | Soul 等平台专项调研（按平台分子目录） | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/03-调研/平台分析/README.md b/开发文档/1、需求/03-调研/平台分析/README.md index d280c31e05..e63ffd76fe 100644 --- a/开发文档/1、需求/03-调研/平台分析/README.md +++ b/开发文档/1、需求/03-调研/平台分析/README.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 需求 + - 调研 + - 索引 +doc-type: 索引 +layer: 1、需求/03-调研/平台分析 +parent: [[README|03-调研]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 平台分析 > **已统一迁至**：`/Users/karuo/Documents/开发/7.项目调研`，按项目分子目录（平台分析/聊天记录/对话分类/资料）。 @@ -24,3 +40,8 @@ ## 与开发文档四类分类的关系 - 本目录属于「**开发与落地**」类：平台能力与对接方案集中在此，便于按平台查阅，不与其他 1～10 目录重复。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/03-调研/平台分析/Soul调研/README.md b/开发文档/1、需求/03-调研/平台分析/Soul调研/README.md index d161d8355a..8639cd49cd 100644 --- a/开发文档/1、需求/03-调研/平台分析/Soul调研/README.md +++ b/开发文档/1、需求/03-调研/平台分析/Soul调研/README.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 需求 + - 调研 + - 索引 +doc-type: 索引 +layer: 1、需求/03-调研/平台分析/Soul调研 +parent: [[README|平台分析]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Soul 专项 > Soul（灵魂社交）相关文档统一放在本目录，不散落在其他开发文档目录。 @@ -19,3 +35,8 @@ - **安卓包名**：`cn.soulapp.android` - **API 域**：`api.soulapp.cn`（主站）；`openplatform-openapi.soulapp.cn`（开放平台/支付等） - **工作手机 Skill**：`sdk/agent/skills/soul/` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/03-调研/平台分析/Soul调研/Soul自动化方案与命令行操作.md b/开发文档/1、需求/03-调研/平台分析/Soul调研/Soul自动化方案与命令行操作.md index b123a0bed3..f86eed6744 100644 --- a/开发文档/1、需求/03-调研/平台分析/Soul调研/Soul自动化方案与命令行操作.md +++ b/开发文档/1、需求/03-调研/平台分析/Soul调研/Soul自动化方案与命令行操作.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 需求 + - 调研 + - 主文档 +doc-type: 主文档 +layer: 1、需求/03-调研/平台分析/Soul调研 +parent: [[1、需求/03-调研/平台分析/Soul调研/README|Soul调研]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Soul 自动化方案与命令行操作 > 创建日期：2026-02-28 | 目的：在手机上通过工作手机 SDK 自动化操作 Soul（发瞬间、发视频、自动聊天、获取好友），并由命令行/API 触发。 @@ -250,3 +266,9 @@ curl -X POST "https://api.soulapp.cn/v3/post/publish" \ - unified 接口定义：`sdk/app/routers/unified.py` - Soul 接口与功能清单：本目录 [Soul项目分析.md](Soul项目分析.md) - Soul 安卓包名与 API：公开资料显示为 `cn.soulapp.android`、api.soulapp.cn；api-sign 等见逆向分析文档。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[1、需求/03-调研/平台分析/Soul调研/README|Soul调研]] | +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/03-调研/平台分析/Soul调研/Soul项目分析.md b/开发文档/1、需求/03-调研/平台分析/Soul调研/Soul项目分析.md index 225f1e7e28..577fa7c7f5 100644 --- a/开发文档/1、需求/03-调研/平台分析/Soul调研/Soul项目分析.md +++ b/开发文档/1、需求/03-调研/平台分析/Soul调研/Soul项目分析.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 需求 + - 调研 + - 主文档 +doc-type: 主文档 +layer: 1、需求/03-调研/平台分析/Soul调研 +parent: [[1、需求/03-调研/平台分析/Soul调研/README|Soul调研]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Soul 项目分析：接口与功能清单 > 创建日期：2026-02-28 | 用途：对接与自动化时查阅 Soul 全部能力与接口，统一放在本目录。 @@ -148,3 +164,9 @@ - 官方开放平台：https://mp-doc.soulapp.cn/ - 逆向/抓包参考：api.soulapp.cn、api-sign 算法分析（见第三方博客）。 - 本文档随 Soul 版本与抓包结果更新，接口以实际抓包或官方文档为准。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[1、需求/03-调研/平台分析/Soul调研/README|Soul调研]] | +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/01_Soul产品与功能维度分析.md b/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/01_Soul产品与功能维度分析.md index f319dcaa3a..b890b7172f 100644 --- a/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/01_Soul产品与功能维度分析.md +++ b/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/01_Soul产品与功能维度分析.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 需求 + - 调研 + - 主文档 +doc-type: 主文档 +layer: 1、需求/03-调研/平台分析/Soul调研/调研 +parent: [[1、需求/03-调研/平台分析/Soul调研/调研/README|调研]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Soul 产品与功能维度分析 > 维度：产品定位、功能矩阵、优势与劣势、可借鉴点 @@ -101,3 +117,9 @@ - **心智与归属**：类似「灵魂鉴定+星球」的轻量人设与分区，可降低冷启动并提升留存。 - **互动闭环**：点赞、评论、收藏、分享、打招呼等形成闭环，便于指标与增长设计。 - **分层变现**：会员、虚拟礼物、小游戏、广告等多条线，可参考其组合方式做商业化设计。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[1、需求/03-调研/平台分析/Soul调研/调研/README|调研]] | +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/02_Soul技术架构与实现维度分析.md b/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/02_Soul技术架构与实现维度分析.md index de995c47a3..071967beb5 100644 --- a/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/02_Soul技术架构与实现维度分析.md +++ b/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/02_Soul技术架构与实现维度分析.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 需求 + - 调研 + - 主文档 +doc-type: 主文档 +layer: 1、需求/03-调研/平台分析/Soul调研/调研 +parent: [[1、需求/03-调研/平台分析/Soul调研/调研/README|调研]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Soul 技术架构与实现维度分析 > 维度：客户端、服务端、API 与协议、技术栈、优势与劣势、实现参考 @@ -115,3 +131,9 @@ - **鉴权与签名**：Token + 设备维度（device-id、app-id、app-version）+ 请求级签名（nonce+时间戳+路径+参数），防重放与篡改。 - **多域与资源分离**：主 API、开放平台、静态资源分域，便于权限、CDN 与扩展。 - **客户端**：按业务模块拆分（发布、广场、私聊、房间、登录），便于多端复用与灰度发布。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[1、需求/03-调研/平台分析/Soul调研/调研/README|调研]] | +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/03_Soul安全与风控维度分析.md b/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/03_Soul安全与风控维度分析.md index 783cb8d6f0..cef4ec7f77 100644 --- a/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/03_Soul安全与风控维度分析.md +++ b/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/03_Soul安全与风控维度分析.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 需求 + - 调研 + - 主文档 +doc-type: 主文档 +layer: 1、需求/03-调研/平台分析/Soul调研/调研 +parent: [[1、需求/03-调研/平台分析/Soul调研/调研/README|调研]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Soul 安全与风控维度分析 > 维度：认证、签名、反爬与反作弊、合规、优势与劣势 @@ -94,3 +110,9 @@ - **请求签名**：关键接口使用签名（路径+参数+nonce+时间+密钥），防篡改与重放。 - **限频与设备维度**：按用户/设备/IP 限频，结合设备指纹识别异常与多账号。 - **合规前置**：实名、隐私政策、内容审核、未成年人保护与产品设计同步考虑。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[1、需求/03-调研/平台分析/Soul调研/调研/README|调研]] | +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/04_Soul商业与运营维度分析.md b/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/04_Soul商业与运营维度分析.md index 3c803e5960..a9e0cd05cd 100644 --- a/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/04_Soul商业与运营维度分析.md +++ b/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/04_Soul商业与运营维度分析.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 需求 + - 调研 + - 主文档 +doc-type: 主文档 +layer: 1、需求/03-调研/平台分析/Soul调研/调研 +parent: [[1、需求/03-调研/平台分析/Soul调研/调研/README|调研]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Soul 商业与运营维度分析 > 维度：变现方式、留存与增长、运营手段、优势与劣势 @@ -72,3 +88,9 @@ - **留存**：内容与推荐 + 关系链 + 心智设计（如灵魂/星球）+ 推送与任务，形成闭环。 - **增长**：冷启动与破冰设计 + 邀请与裂变 + 渠道投放，配合风控与防刷。 - **运营**：话题与活动 + 用户分层 + 举报与客服，与产品与合规对齐。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[1、需求/03-调研/平台分析/Soul调研/调研/README|调研]] | +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/05_Soul体验与交互维度分析.md b/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/05_Soul体验与交互维度分析.md index 0c716c9ff0..46439e2c48 100644 --- a/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/05_Soul体验与交互维度分析.md +++ b/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/05_Soul体验与交互维度分析.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 需求 + - 调研 + - 主文档 +doc-type: 主文档 +layer: 1、需求/03-调研/平台分析/Soul调研/调研 +parent: [[1、需求/03-调研/平台分析/Soul调研/调研/README|调研]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Soul 体验与交互维度分析 > 维度：体验设计、交互形式、优势与劣势 @@ -71,3 +87,9 @@ - **导航**：底部主 Tab + 信息流 + 显眼发布，保持路径简单。 - **互动**：点赞、评论、私聊、语音房等分层设计，兼顾内容消费与关系建立。 - **年轻化**：在视觉与玩法上做年轻化（如 3D、答题、主题房），与目标人群匹配。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[1、需求/03-调研/平台分析/Soul调研/调研/README|调研]] | +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/06_参考Soul开发APP的技术基线与实现方式.md b/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/06_参考Soul开发APP的技术基线与实现方式.md index 27b53eb123..78903647e4 100644 --- a/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/06_参考Soul开发APP的技术基线与实现方式.md +++ b/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/06_参考Soul开发APP的技术基线与实现方式.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 需求 + - 调研 + - 主文档 +doc-type: 主文档 +layer: 1、需求/03-调研/平台分析/Soul调研/调研 +parent: [[1、需求/03-调研/平台分析/Soul调研/调研/README|调研]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 参考 Soul 开发 APP 的技术基线与实现方式 > 用途：以 Soul 为参照，给出自研类似形态 APP 的**技术基线、架构建议与实现方式**，供立项与开发参考。 @@ -94,3 +110,9 @@ - **落地**：06（本文档）→ 技术基线、分阶段架构与选型、开发顺序。 按以上顺序阅读并对照 01～05，即可在「参考 Soul 形式」的前提下，形成自研 APP 的技术基线与实现方式方案。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[1、需求/03-调研/平台分析/Soul调研/调研/README|调研]] | +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/README.md b/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/README.md index 58cca08dc8..2f263469dd 100644 --- a/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/README.md +++ b/开发文档/1、需求/03-调研/平台分析/Soul调研/调研/README.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 需求 + - 调研 + - 索引 +doc-type: 索引 +layer: 1、需求/03-调研/平台分析/Soul调研/调研 +parent: [[README|Soul调研]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Soul 多维度调研文档 > 用途：从产品、技术、安全、商业、体验等维度对 Soul APP 做拆解分析，为**自研类似形态 APP** 提供技术基线与实现方式参考。 @@ -32,3 +48,8 @@ - 分析基于公开信息、抓包与既有项目分析，非官方披露，仅供参考。 - 各文档内「好处/坏处」「优点/缺点」均按该维度拆解，便于对照与选型。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/03-调研/技术调研与方案选型.md b/开发文档/1、需求/03-调研/技术调研与方案选型.md index 7842495631..d3b7ebaa86 100644 --- a/开发文档/1、需求/03-调研/技术调研与方案选型.md +++ b/开发文档/1、需求/03-调研/技术调研与方案选型.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 需求 + - 调研 + - 主文档 +doc-type: 主文档 +layer: 1、需求/03-调研 +parent: [[1、需求/03-调研/README|03-调研]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK v3.0 - 技术调研与方案选型 > 整合自资料目录 12 份调研文档 | 更新：2026-02-10 @@ -259,3 +275,9 @@ Magisk+Root → Root设备: frida-server | 10 | 个微方案全网对比_优于Frida与奥创.md | 全网方案排名 | §2.2 | | 11 | 最佳解决路径_个微工作手机统一方案.md | 机擎唯一方案论证 | §1 | | 12 | 机擎复刻Frida与奥创管理注入_实现路径.md | 复刻路径+架构图 | §3 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[1、需求/03-调研/README|03-调研]] | +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/README.md b/开发文档/1、需求/README.md index e16a0d72c2..2f0263e528 100644 --- a/开发文档/1、需求/README.md +++ b/开发文档/1、需求/README.md @@ -1,5 +1,17 @@ --- -obsidian-color: "#5E35B1" +tags: + - 工作手机 + - 需求 + - 索引 +doc-type: 索引 +layer: 1、需求 +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #5E35B1 cssclasses: - devdoc-index --- @@ -36,3 +48,8 @@ cssclasses: - 2026-05-24：分层 `01～03` - 2026-02-10：成本澄清合并入项目概述；调研 12 份整合 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/images/README.md b/开发文档/1、需求/images/README.md index 0f5e29cef6..e75cf5f340 100644 --- a/开发文档/1、需求/images/README.md +++ b/开发文档/1、需求/images/README.md @@ -1,3 +1,23 @@ +--- +tags: + - 工作手机 + - 需求 + - 索引 +doc-type: 索引 +layer: 1、需求/images +parent: [[README|1、需求]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # images 需求类配图放此目录。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/1、需求/修改/设备-微信.md b/开发文档/1、需求/修改/设备-微信.md index e6e08a1db3..053aba0f1e 100644 --- a/开发文档/1、需求/修改/设备-微信.md +++ b/开发文档/1、需求/修改/设备-微信.md @@ -1 +1,22 @@ -功能一：所有的微信调整与截图 \ No newline at end of file +--- +tags: + - 工作手机 + - 需求 + - 主文档 +doc-type: 主文档 +layer: 1、需求/修改 +parent: [[README|1、需求]] +related: + - "[[业务需求]]" + - "[[项目概述]]" + - "[[技术调研与方案选型]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" + - "[[微信全功能矩阵_v8.0.56]]" +--- +功能一：所有的微信调整与截图 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[业务需求]] · [[项目概述]] · [[技术调研与方案选型]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/2、架构/01-总览/README.md b/开发文档/2、架构/01-总览/README.md index c60c88ed37..f51ff489ad 100644 --- a/开发文档/2、架构/01-总览/README.md +++ b/开发文档/2、架构/01-总览/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#2E7D32" +tags: + - 工作手机 + - 架构 + - 总览 + - 索引 +doc-type: 索引 +layer: 2、架构/01-总览 +parent: [[README|2、架构]] +related: + - "[[项目目录总览]]" + - "[[系统架构]]" + - "[[Hook通道与多设备多服务器架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #2E7D32 --- # 01 · 总览 @@ -9,3 +23,8 @@ obsidian-color: "#2E7D32" | [系统架构.md](系统架构.md) | **主文档**：五层架构、v4.0 APK、M1～M12、§3.0 模块拆解、存客宝对接 | **关联图**：`../images/01-整体总览/` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[项目目录总览]] · [[系统架构]] · [[Hook通道与多设备多服务器架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/2、架构/01-总览/系统架构.md b/开发文档/2、架构/01-总览/系统架构.md index b7fce480ea..bda446c4f6 100644 --- a/开发文档/2、架构/01-总览/系统架构.md +++ b/开发文档/2、架构/01-总览/系统架构.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 架构 + - 总览 + - 主文档 +doc-type: 主文档 +layer: 2、架构/01-总览 +parent: [[2、架构/01-总览/README|01-总览]] +related: + - "[[项目目录总览]]" + - "[[系统架构]]" + - "[[Hook通道与多设备多服务器架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK v3.0 → v4.0 系统架构 > 创建日期：2026-01-26 | 架构师：卡若 | 状态：已确认 > @@ -618,3 +634,9 @@ android-agent/ - Phase 1-2：服务端/设备端骨架、WebSocket、设备管理 - Phase 3-4：微信/抖音/小红书/闲鱼Skill，统一交互层 - Phase 5-6：抓包、AI Agent、压测上线 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[2、架构/01-总览/README|01-总览]] | +| ↔ 相关 | [[项目目录总览]] · [[系统架构]] · [[Hook通道与多设备多服务器架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/2、架构/01-总览/项目目录总览.md b/开发文档/2、架构/01-总览/项目目录总览.md index e2e0e2bf9b..59d6659432 100644 --- a/开发文档/2、架构/01-总览/项目目录总览.md +++ b/开发文档/2、架构/01-总览/项目目录总览.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 架构 + - 总览 + - 主文档 +doc-type: 主文档 +layer: 2、架构/01-总览 +parent: [[2、架构/01-总览/README|01-总览]] +related: + - "[[项目目录总览]]" + - "[[系统架构]]" + - "[[Hook通道与多设备多服务器架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 01 · 项目目录总览 **工作手机 SDK v3.0** 仓库顶层结构（Obsidian 配色见 `.obsidian/snippets/workphone-devdoc.css`）。 @@ -48,3 +64,9 @@ flowchart TB ``` 详细模块：[系统架构.md §3.0](系统架构.md) · 规范：[机擎/阿表/开发文档结构规范/SKILL.md](../../../机擎/阿表/开发文档结构规范/SKILL.md) +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[2、架构/01-总览/README|01-总览]] | +| ↔ 相关 | [[项目目录总览]] · [[系统架构]] · [[Hook通道与多设备多服务器架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/2、架构/02-技术基座/README.md b/开发文档/2、架构/02-技术基座/README.md index 8984a0acae..ed6acb393d 100644 --- a/开发文档/2、架构/02-技术基座/README.md +++ b/开发文档/2、架构/02-技术基座/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#6A1B9A" +tags: + - 工作手机 + - 架构 + - 技术基座 + - 索引 +doc-type: 索引 +layer: 2、架构/02-技术基座 +parent: [[README|2、架构]] +related: + - "[[项目目录总览]]" + - "[[系统架构]]" + - "[[Hook通道与多设备多服务器架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #6A1B9A --- # 02 · 技术基座 @@ -7,3 +21,8 @@ obsidian-color: "#6A1B9A" | 文档 | 说明 | |------|------| | [技术选型与数据库.md](技术选型与数据库.md) | FastAPI/MongoDB/Redis 选型 + 数据层设计 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[项目目录总览]] · [[系统架构]] · [[Hook通道与多设备多服务器架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/2、架构/02-技术基座/技术选型与数据库.md b/开发文档/2、架构/02-技术基座/技术选型与数据库.md index 8810c74de3..2794d88c50 100644 --- a/开发文档/2、架构/02-技术基座/技术选型与数据库.md +++ b/开发文档/2、架构/02-技术基座/技术选型与数据库.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 架构 + - 技术基座 + - 主文档 +doc-type: 主文档 +layer: 2、架构/02-技术基座 +parent: [[2、架构/02-技术基座/README|02-技术基座]] +related: + - "[[项目目录总览]]" + - "[[系统架构]]" + - "[[Hook通道与多设备多服务器架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK v3.0 - 技术选型与数据库 > 合并自《技术选型》+《数据库设计》| 更新：2026-02-07 @@ -829,3 +845,9 @@ db.audit_logs.insertOne({ timestamp: new Date() }) ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[2、架构/02-技术基座/README|02-技术基座]] | +| ↔ 相关 | [[项目目录总览]] · [[系统架构]] · [[Hook通道与多设备多服务器架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/2、架构/03-通道与设备/Hook通道与多设备多服务器架构.md b/开发文档/2、架构/03-通道与设备/Hook通道与多设备多服务器架构.md index 69c06719e4..6a0c19c6dc 100644 --- a/开发文档/2、架构/03-通道与设备/Hook通道与多设备多服务器架构.md +++ b/开发文档/2、架构/03-通道与设备/Hook通道与多设备多服务器架构.md @@ -1,3 +1,21 @@ +--- +tags: + - 工作手机 + - 架构 + - 通道与设备 + - 主文档 +doc-type: 主文档 +layer: 2、架构/03-通道与设备 +parent: [[2、架构/03-通道与设备/README|03-通道与设备]] +related: + - "[[项目目录总览]]" + - "[[系统架构]]" + - "[[Hook通道与多设备多服务器架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[设备端Hook安装部署]]" +--- # Hook通道与多设备多服务器架构 > 更新：2026-02-10 | 本文为双通道架构+多设备多服务器的详细设计 @@ -614,3 +632,9 @@ sequenceDiagram | 连接与指令 | `sdk/app/services/ws_hub.py` | | Agent 主循环 | `sdk/agent/agent.py` | | 微信技能 | `sdk/agent/skills/wechat/skill.py` | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[2、架构/03-通道与设备/README|03-通道与设备]] | +| ↔ 相关 | [[项目目录总览]] · [[系统架构]] · [[Hook通道与多设备多服务器架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/2、架构/03-通道与设备/README.md b/开发文档/2、架构/03-通道与设备/README.md index 41b9179ea7..47b5443927 100644 --- a/开发文档/2、架构/03-通道与设备/README.md +++ b/开发文档/2、架构/03-通道与设备/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#EF6C00" +tags: + - 工作手机 + - 架构 + - 通道与设备 + - 索引 +doc-type: 索引 +layer: 2、架构/03-通道与设备 +parent: [[README|2、架构]] +related: + - "[[项目目录总览]]" + - "[[系统架构]]" + - "[[Hook通道与多设备多服务器架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #EF6C00 --- # 03 · 通道与设备 @@ -9,3 +23,8 @@ obsidian-color: "#EF6C00" | [Hook通道与多设备多服务器架构.md](Hook通道与多设备多服务器架构.md) | 双通道路由、Frida、多设备多服务器、模块管理 | **关联图**：`../images/02-控制通道/` · `../images/03-微信与Hook/` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[项目目录总览]] · [[系统架构]] · [[Hook通道与多设备多服务器架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/2、架构/04-交互图/README.md b/开发文档/2、架构/04-交互图/README.md index d8b729942f..33d95d62d9 100644 --- a/开发文档/2、架构/04-交互图/README.md +++ b/开发文档/2、架构/04-交互图/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#00838F" +tags: + - 工作手机 + - 架构 + - 交互图 + - 索引 +doc-type: 索引 +layer: 2、架构/04-交互图 +parent: [[README|2、架构]] +related: + - "[[项目目录总览]]" + - "[[系统架构]]" + - "[[Hook通道与多设备多服务器架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #00838F --- # 04 · 交互图（HTML / Mermaid） @@ -11,3 +25,8 @@ obsidian-color: "#00838F" | [防封模块架构图.html](防封模块架构图.html) | 防封模块（源：`防封模块架构图.mmd`） | Hub 路由：`/docs/wechat-server-flow` · `/docs/anti-ban-architecture` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[项目目录总览]] · [[系统架构]] · [[Hook通道与多设备多服务器架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/2、架构/05-规范/README.md b/开发文档/2、架构/05-规范/README.md index 6b2883e597..24608e1a9b 100644 --- a/开发文档/2、架构/05-规范/README.md +++ b/开发文档/2、架构/05-规范/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#455A64" +tags: + - 工作手机 + - 架构 + - 规范 + - 索引 +doc-type: 索引 +layer: 2、架构/05-规范 +parent: [[README|2、架构]] +related: + - "[[项目目录总览]]" + - "[[系统架构]]" + - "[[Hook通道与多设备多服务器架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #455A64 --- # 05 · 规范 @@ -7,3 +21,8 @@ obsidian-color: "#455A64" | 文档 | 说明 | |------|------| | [架构图风格标准.md](架构图风格标准.md) | 出图风格 + **images/ 四类归档规则** | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[项目目录总览]] · [[系统架构]] · [[Hook通道与多设备多服务器架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/2、架构/05-规范/架构图风格标准.md b/开发文档/2、架构/05-规范/架构图风格标准.md index a7252cf996..274924ade9 100644 --- a/开发文档/2、架构/05-规范/架构图风格标准.md +++ b/开发文档/2、架构/05-规范/架构图风格标准.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 架构 + - 规范 + - 主文档 +doc-type: 主文档 +layer: 2、架构/05-规范 +parent: [[2、架构/05-规范/README|05-规范]] +related: + - "[[项目目录总览]]" + - "[[系统架构]]" + - "[[Hook通道与多设备多服务器架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机 · 架构图风格标准 > **用途**：后续所有架构图、流程图、应用示意均按此风格生成，保持统一视觉。 @@ -51,3 +67,9 @@ --- *后续生成架构图时：先定分类 → 放入对应 `images/` 子目录 → 在正文用相对路径引用。* +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[2、架构/05-规范/README|05-规范]] | +| ↔ 相关 | [[项目目录总览]] · [[系统架构]] · [[Hook通道与多设备多服务器架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/2、架构/README.md b/开发文档/2、架构/README.md index dd7a3014bf..c1708ca8a0 100644 --- a/开发文档/2、架构/README.md +++ b/开发文档/2、架构/README.md @@ -1,7 +1,19 @@ --- +tags: + - 工作手机 + - 架构 + - 索引 +doc-type: 索引 +layer: 2、架构 +related: + - "[[项目目录总览]]" + - "[[系统架构]]" + - "[[Hook通道与多设备多服务器架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #1565C0 cssclasses: - devdoc-index -obsidian-color: "#1565C0" --- # 2、架构 @@ -83,3 +95,8 @@ obsidian-color: "#1565C0" - 2026-05-24：目录分层重组；PNG 迁入 `images/` 四类子目录 - 2026-02-10：`对接与方案补充.md` 已合并入 `01-总览/系统架构.md` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[项目目录总览]] · [[系统架构]] · [[Hook通道与多设备多服务器架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/2、架构/images/README.md b/开发文档/2、架构/images/README.md index dc13c04661..ca0e8390a8 100644 --- a/开发文档/2、架构/images/README.md +++ b/开发文档/2、架构/images/README.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 架构 + - 索引 +doc-type: 索引 +layer: 2、架构/images +parent: [[README|2、架构]] +related: + - "[[项目目录总览]]" + - "[[系统架构]]" + - "[[Hook通道与多设备多服务器架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # images · 架构图静态资源 > **禁止**在 `2、架构/` 根目录放置 PNG；一律在此按子类归档。 @@ -14,3 +29,8 @@ ```markdown ![SDK架构](../images/01-整体总览/工作手机SDK架构图.png) ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[项目目录总览]] · [[系统架构]] · [[Hook通道与多设备多服务器架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/3、原型/01-规范/原型设计规范.md b/开发文档/3、原型/01-规范/原型设计规范.md index 414b925d8e..6197ab2ebc 100644 --- a/开发文档/3、原型/01-规范/原型设计规范.md +++ b/开发文档/3、原型/01-规范/原型设计规范.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 原型 + - 规范 + - 主文档 +doc-type: 主文档 +layer: 3、原型/01-规范 +parent: [[README|3、原型]] +related: + - "[[原型设计规范]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK v3.0 原型设计规范 > 创建日期：2026-01-26 | 设计师：卡若 @@ -322,3 +337,8 @@ sequenceDiagram - 适配 360dp - 420dp 宽度 - 支持深色模式 - 适配刘海屏/挖孔屏 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[原型设计规范]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/3、原型/README.md b/开发文档/3、原型/README.md index 42248352dd..872dddec57 100644 --- a/开发文档/3、原型/README.md +++ b/开发文档/3、原型/README.md @@ -1,5 +1,16 @@ --- -obsidian-color: "#5E35B1" +tags: + - 工作手机 + - 原型 + - 索引 +doc-type: 索引 +layer: 3、原型 +related: + - "[[原型设计规范]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #5E35B1 --- # 3、原型 @@ -7,3 +18,8 @@ obsidian-color: "#5E35B1" | 入口 | 说明 | |------|------| | [01-规范/原型设计规范.md](01-规范/原型设计规范.md) | 原型与交互规范 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[原型设计规范]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/4、前端/01-通用规范/前端开发规范.md b/开发文档/4、前端/01-通用规范/前端开发规范.md index dc6093fdd1..17c75449b2 100644 --- a/开发文档/4、前端/01-通用规范/前端开发规范.md +++ b/开发文档/4、前端/01-通用规范/前端开发规范.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 前端 + - 通用规范 + - 主文档 +doc-type: 主文档 +layer: 4、前端/01-通用规范 +parent: [[README|4、前端]] +related: + - "[[系统架构]]" + - "[[接口规范]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK v3.0 设备端开发规范 > 创建日期：2026-01-26 | 开发者：卡若 > @@ -621,3 +636,8 @@ adb shell am startservice com.workphone.agent/.services.AgentService # 停止Agent服务 adb shell am stopservice com.workphone.agent/.services.AgentService ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[系统架构]] · [[接口规范]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/4、前端/02-管理端/管理端前端开发规范（毛玻璃风格）.md b/开发文档/4、前端/02-管理端/管理端前端开发规范（毛玻璃风格）.md index a3f26ffaa4..c3567fe2f2 100644 --- a/开发文档/4、前端/02-管理端/管理端前端开发规范（毛玻璃风格）.md +++ b/开发文档/4、前端/02-管理端/管理端前端开发规范（毛玻璃风格）.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 前端 + - 管理端 + - 主文档 +doc-type: 主文档 +layer: 4、前端/02-管理端 +parent: [[README|4、前端]] +related: + - "[[系统架构]]" + - "[[接口规范]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 管理端前端开发规范（苹果毛玻璃风格） > 更新：2026-02-10 | 本文定义机擎管理端的前端设计规范与开发细节 @@ -547,3 +562,8 @@ management-ui/ | F13 | API对接+错误处理 | 4h | P0 | | F14 | 响应式适配+动画 | 4h | P1 | | | **合计** | **~65h** | | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[系统架构]] · [[接口规范]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/4、前端/03-工具/v0配置.md b/开发文档/4、前端/03-工具/v0配置.md index 880bd9a639..f55efcadb4 100644 --- a/开发文档/4、前端/03-工具/v0配置.md +++ b/开发文档/4、前端/03-工具/v0配置.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 前端 + - 工具 + - 主文档 +doc-type: 主文档 +layer: 4、前端/03-工具 +parent: [[README|4、前端]] +related: + - "[[系统架构]]" + - "[[接口规范]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 🎨 v0模型配置（前端AI生成） > 使用v0 API自动生成高质量React/Next.js组件 @@ -183,3 +198,8 @@ curl https://api.v0.dev/v1/chat/completions \ - v0适合：UI组件、页面布局、React组件 - v0不适合：后端逻辑、算法、调试（用Claude/GPT） - 切换模型：在Cursor聊天窗口右下角选择 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[系统架构]] · [[接口规范]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/4、前端/README.md b/开发文档/4、前端/README.md index f73e83d384..b2ce3e3c54 100644 --- a/开发文档/4、前端/README.md +++ b/开发文档/4、前端/README.md @@ -1,5 +1,16 @@ --- -obsidian-color: "#0277BD" +tags: + - 工作手机 + - 前端 + - 索引 +doc-type: 索引 +layer: 4、前端 +related: + - "[[系统架构]]" + - "[[接口规范]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #0277BD cssclasses: - devdoc-index --- @@ -18,3 +29,8 @@ cssclasses: | [01 通用](01-通用规范/前端开发规范.md) | Agent/设备端前端约定 | | [02 管理端](02-管理端/管理端前端开发规范（毛玻璃风格）.md) | 毛玻璃 UI | | [03 工具](03-工具/v0配置.md) | v0 Platform API | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[系统架构]] · [[接口规范]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/01-规范与统一层/README.md b/开发文档/5、接口/01-规范与统一层/README.md index 4aede00a98..8aeea5aaa1 100644 --- a/开发文档/5、接口/01-规范与统一层/README.md +++ b/开发文档/5、接口/01-规范与统一层/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#0277BD" +tags: + - 工作手机 + - 接口 + - 规范与统一层 + - 索引 +doc-type: 索引 +layer: 5、接口/01-规范与统一层 +parent: [[README|5、接口]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #0277BD --- # 01 · 规范与统一层 @@ -9,3 +23,8 @@ obsidian-color: "#0277BD" | [**工作手机API全量接口目录.md**](工作手机API全量接口目录.md) | **328 条** HTTP 路由全量索引 + 公共参数 + 存客宝重点 | | [接口规范.md](接口规范.md) | 统一 API（消息/好友/群/设备/脚本）+ §1.5 联调契约 | | [通用服务交互层.md](通用服务交互层.md) | Facade + ChannelRouter + 三通道 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/01-规范与统一层/工作手机API全量接口目录.md b/开发文档/5、接口/01-规范与统一层/工作手机API全量接口目录.md index 9e482daeaa..8039e06c3b 100644 --- a/开发文档/5、接口/01-规范与统一层/工作手机API全量接口目录.md +++ b/开发文档/5、接口/01-规范与统一层/工作手机API全量接口目录.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#0277BD" +tags: + - 工作手机 + - 接口 + - 规范与统一层 + - 主文档 +doc-type: 主文档 +layer: 5、接口/01-规范与统一层 +parent: [[5、接口/01-规范与统一层/README|01-规范与统一层]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #0277BD cssclasses: - devdoc-api-index --- @@ -585,4 +599,10 @@ Content-Type: application/json - [API架构与交互流程图](05-交互图/API架构与交互流程图.html) - [存客宝对接架构图](05-交互图/存客宝对接架构图.html) -**维护**：接口变更后重新运行 `开发文档/8、部署/05-测试验收/scripts/export_api_catalog.py`（或让 @阿桥 从 main.py 扫描更新）。 \ No newline at end of file +**维护**：接口变更后重新运行 `开发文档/8、部署/05-测试验收/scripts/export_api_catalog.py`（或让 @阿桥 从 main.py 扫描更新）。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[5、接口/01-规范与统一层/README|01-规范与统一层]] | +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/01-规范与统一层/接口规范.md b/开发文档/5、接口/01-规范与统一层/接口规范.md index 25b87c07d8..742094bb6f 100644 --- a/开发文档/5、接口/01-规范与统一层/接口规范.md +++ b/开发文档/5、接口/01-规范与统一层/接口规范.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 接口 + - 规范与统一层 + - 主文档 +doc-type: 主文档 +layer: 5、接口/01-规范与统一层 +parent: [[5、接口/01-规范与统一层/README|01-规范与统一层]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK v3.0 - 接口规范（统一API） > 版本：v3.0 | 更新：2026-05-24 | 合并自《统一API规范》+ 接口定义要点 @@ -691,3 +707,9 @@ return [ 'api_key' => env('WORKPHONE_KEY', ''), ]; ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[5、接口/01-规范与统一层/README|01-规范与统一层]] | +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/01-规范与统一层/通用服务交互层.md b/开发文档/5、接口/01-规范与统一层/通用服务交互层.md index 1d0415b3fc..8c9fab3b72 100644 --- a/开发文档/5、接口/01-规范与统一层/通用服务交互层.md +++ b/开发文档/5、接口/01-规范与统一层/通用服务交互层.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 接口 + - 规范与统一层 + - 主文档 +doc-type: 主文档 +layer: 5、接口/01-规范与统一层 +parent: [[5、接口/01-规范与统一层/README|01-规范与统一层]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK v3.0 - 通用服务交互层设计 > 创建日期：2026-01-26 | 架构师：卡若 > @@ -849,3 +865,9 @@ $result = $client->executeTask('device-001', '打开淘宝搜索iPhone16并加 3. SDK失败 → 用AI Agent（最灵活） 4. 全部失败 → 返回错误，人工介入 ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[5、接口/01-规范与统一层/README|01-规范与统一层]] | +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/02-业务对接/README.md b/开发文档/5、接口/02-业务对接/README.md index 803dc446b2..4ff5fa7488 100644 --- a/开发文档/5、接口/02-业务对接/README.md +++ b/开发文档/5、接口/02-业务对接/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#0277BD" +tags: + - 工作手机 + - 接口 + - 业务对接 + - 索引 +doc-type: 索引 +layer: 5、接口/02-业务对接 +parent: [[README|5、接口]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #0277BD --- # 02 · 业务对接 @@ -9,3 +23,8 @@ obsidian-color: "#0277BD" | [存客宝BFF与工作手机SDK映射表.md](存客宝BFF与工作手机SDK映射表.md) | 触客宝 `/v1/workphone/*` ↔ SDK `/api/v3/*` + WorkPhoneSDK.php | | [存客宝对接规范.md](存客宝对接规范.md) | 存客宝线索 API 签名与上报 | | [外部对接网关接口说明.md](外部对接网关接口说明.md) | OpenAI / MCP / Fleet 网关 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/02-业务对接/外部对接网关接口说明.md b/开发文档/5、接口/02-业务对接/外部对接网关接口说明.md index 8b5797d795..d09319fcca 100644 --- a/开发文档/5、接口/02-业务对接/外部对接网关接口说明.md +++ b/开发文档/5、接口/02-业务对接/外部对接网关接口说明.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 接口 + - 业务对接 + - 主文档 +doc-type: 主文档 +layer: 5、接口/02-业务对接 +parent: [[5、接口/02-业务对接/README|02-业务对接]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机 SDK — 外部对接网关接口说明 > **版本**: 1.0.0 | **更新**: 2026-03-20 @@ -244,3 +260,9 @@ GET /api/v3/gateway/info | **聚合全集群设备** | GET | `/api/v3/registry/fleet/aggregate` | 环境变量：`WORKPHONE_SERVER_ID`、`WORKPHONE_PUBLIC_BASE_URL`、`WORKPHONE_REGISTRY_TOKEN`（可选）、`WORKPHONE_REGISTRY_PEERS`（静态 peer 列表）。详见 `开发文档/8、部署/03-运维同步/上线与运维操作手册.md`。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[5、接口/02-业务对接/README|02-业务对接]] | +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/02-业务对接/存客宝BFF与工作手机SDK映射表.md b/开发文档/5、接口/02-业务对接/存客宝BFF与工作手机SDK映射表.md index 1b4f60db29..e7257cf6f6 100644 --- a/开发文档/5、接口/02-业务对接/存客宝BFF与工作手机SDK映射表.md +++ b/开发文档/5、接口/02-业务对接/存客宝BFF与工作手机SDK映射表.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 接口 + - 业务对接 + - 主文档 +doc-type: 主文档 +layer: 5、接口/02-业务对接 +parent: [[5、接口/02-业务对接/README|02-业务对接]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 存客宝 BFF 与工作手机 SDK 映射表 > **版本**: v1.0 | **更新**: 2026-05-24 | **负责人**: @阿桥 @@ -287,3 +303,9 @@ await sdk.pushAITask(deviceId, '检查微信未读', 5); ``` **接口真源**：[工作手机API全量接口目录.md](../01-规范与统一层/工作手机API全量接口目录.md) +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[5、接口/02-业务对接/README|02-业务对接]] | +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/02-业务对接/存客宝对接规范.md b/开发文档/5、接口/02-业务对接/存客宝对接规范.md index 5a24ab01ab..350dae4ad1 100644 --- a/开发文档/5、接口/02-业务对接/存客宝对接规范.md +++ b/开发文档/5、接口/02-业务对接/存客宝对接规范.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 接口 + - 业务对接 + - 主文档 +doc-type: 主文档 +layer: 5、接口/02-业务对接 +parent: [[5、接口/02-业务对接/README|02-业务对接]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 🔗 存客宝接口对接规范 (CunKeBao API Standard) > **用途**: 所有项目对接存客宝系统的统一规范 @@ -801,3 +817,9 @@ result = ckb.report_lead( > **更新日志**: > - v1.0 (2026-01-18): 初始版本，支持线索上报和用户画像 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[5、接口/02-业务对接/README|02-业务对接]] | +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/03-Hook与微信/API接口文档_v8fix.md b/开发文档/5、接口/03-Hook与微信/API接口文档_v8fix.md index 592a90a614..34d5d6d330 100644 --- a/开发文档/5、接口/03-Hook与微信/API接口文档_v8fix.md +++ b/开发文档/5、接口/03-Hook与微信/API接口文档_v8fix.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 接口 + - Hook与微信 + - 主文档 +doc-type: 主文档 +layer: 5、接口/03-Hook与微信 +parent: [[5、接口/03-Hook与微信/README|03-Hook与微信]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机 SDK API 接口文档 v8-fix > 版本：v8-fix | 更新时间：2026-05-18 | 账号：游条姐 (wxid_5g37snchpv8e22) @@ -491,3 +507,9 @@ print(f"群组数: {groups['count']}") | 钱包账单 | ✅ 可读取 | WalletLedgerRecord表 | | 群管理 | ✅ 读取+修改 | 群公告/群昵称/成员列表 | | 标签管理 | ✅ 165个标签 | 从rcontact.contactLabelIds提取 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[5、接口/03-Hook与微信/README|03-Hook与微信]] | +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/03-Hook与微信/Hook模块管理接口.md b/开发文档/5、接口/03-Hook与微信/Hook模块管理接口.md index 62a0c0e033..90b055dc98 100644 --- a/开发文档/5、接口/03-Hook与微信/Hook模块管理接口.md +++ b/开发文档/5、接口/03-Hook与微信/Hook模块管理接口.md @@ -1,3 +1,20 @@ +--- +tags: + - 工作手机 + - 接口 + - Hook与微信 + - 主文档 +doc-type: 主文档 +layer: 5、接口/03-Hook与微信 +parent: [[5、接口/03-Hook与微信/README|03-Hook与微信]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" + - "[[设备端Hook安装部署]]" +--- # Hook模块管理接口规范 > 更新：2026-02-10 | 对标奥创XESlciw Manager，定义机擎Hook模块管理的完整API @@ -408,3 +425,9 @@ class WorkPhoneClient { } } ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[5、接口/03-Hook与微信/README|03-Hook与微信]] | +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/03-Hook与微信/README.md b/开发文档/5、接口/03-Hook与微信/README.md index 259a62fe11..cdb8cfdad6 100644 --- a/开发文档/5、接口/03-Hook与微信/README.md +++ b/开发文档/5、接口/03-Hook与微信/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#0277BD" +tags: + - 工作手机 + - 接口 + - Hook与微信 + - 索引 +doc-type: 索引 +layer: 5、接口/03-Hook与微信 +parent: [[README|5、接口]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #0277BD --- # 03 · Hook 与微信 @@ -10,3 +24,8 @@ obsidian-color: "#0277BD" | [Hook模块管理接口.md](Hook模块管理接口.md) | 模块 CRUD + 脚本 + 设备模块 + Hook 事件 | | [微信全功能矩阵_v8.0.56.md](微信全功能矩阵_v8.0.56.md) | 微信 v8.0.56 能力矩阵 | | 手册五图入口 | [9、手册/工作手机·五图总览与使用手册.md](../../9、手册/工作手机·五图总览与使用手册.md) | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/03-Hook与微信/微信Frida_API契约.md b/开发文档/5、接口/03-Hook与微信/微信Frida_API契约.md index b2f01d180a..91bf4b25a0 100644 --- a/开发文档/5、接口/03-Hook与微信/微信Frida_API契约.md +++ b/开发文档/5、接口/03-Hook与微信/微信Frida_API契约.md @@ -1,3 +1,20 @@ +--- +tags: + - 工作手机 + - 接口 + - Hook与微信 + - 主文档 +doc-type: 主文档 +layer: 5、接口/03-Hook与微信 +parent: [[5、接口/03-Hook与微信/README|03-Hook与微信]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" + - "[[设备端Hook安装部署]]" +--- # 微信 Frida · RPC 映射与 Phantom 部署（完整参考） > **版本**：v1.0 · **更新**：2026-05-24 @@ -263,3 +280,9 @@ sdk/scripts/anti_detect/phantom_frida_config.json # 运行时 --- *RPC 映射是字典；Phantom attach 是开关；版本表是写操作的保险。三者齐，Frida 主控才稳。* +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[5、接口/03-Hook与微信/README|03-Hook与微信]] | +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/03-Hook与微信/微信全功能矩阵_v8.0.56.md b/开发文档/5、接口/03-Hook与微信/微信全功能矩阵_v8.0.56.md index cf5177d116..5a9d77aeb9 100644 --- a/开发文档/5、接口/03-Hook与微信/微信全功能矩阵_v8.0.56.md +++ b/开发文档/5、接口/03-Hook与微信/微信全功能矩阵_v8.0.56.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 接口 + - Hook与微信 + - 主文档 +doc-type: 主文档 +layer: 5、接口/03-Hook与微信 +parent: [[5、接口/03-Hook与微信/README|03-Hook与微信]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 微信全功能矩阵 — WeChat 8.0.56 > 设备: Redmi Note 13 5G | Android 13 | SDK targetSdk=34 @@ -178,3 +194,9 @@ 3. 支付操作需要用户手动输入密码（ADB 无法输入支付密码） 4. 视频通话/语音通话需要对方接听 5. 扫一扫需要物理摄像头对准二维码 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[5、接口/03-Hook与微信/README|03-Hook与微信]] | +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/04-OpenAPI/README.md b/开发文档/5、接口/04-OpenAPI/README.md index c74aadf8e0..49f46e6dac 100644 --- a/开发文档/5、接口/04-OpenAPI/README.md +++ b/开发文档/5、接口/04-OpenAPI/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#455A64" +tags: + - 工作手机 + - 接口 + - OpenAPI + - 索引 +doc-type: 索引 +layer: 5、接口/04-OpenAPI +parent: [[README|5、接口]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #455A64 --- # 04 · OpenAPI @@ -8,3 +22,8 @@ obsidian-color: "#455A64" |------|------| | [openapi_v3.0.json](openapi_v3.0.json) | v3.0 机器可读契约（**315 paths**，2026-05-24 从 main.py 重新导出） | | [routes_snapshot.json](routes_snapshot.json) | 328 条 HTTP 路由扁平快照（含系统页） | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/05-交互图/README.md b/开发文档/5、接口/05-交互图/README.md index 46f89c7fb7..1492d89103 100644 --- a/开发文档/5、接口/05-交互图/README.md +++ b/开发文档/5、接口/05-交互图/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#00838F" +tags: + - 工作手机 + - 接口 + - 交互图 + - 索引 +doc-type: 索引 +layer: 5、接口/05-交互图 +parent: [[README|5、接口]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #00838F --- # 05 · 交互图 @@ -9,3 +23,8 @@ obsidian-color: "#00838F" | [接口全量分类浏览.html](接口全量分类浏览.html) | **328 路由** 可搜索分类浏览 | | [存客宝对接架构图.html](存客宝对接架构图.html) | 存客宝 ↔ 工作手机 SDK ↔ 设备 对接总览 | | [API架构与交互流程图.html](API架构与交互流程图.html) | 全站 API 架构与交互流程 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/06-验收与矩阵/2026-05-24_微信真机可见验收_单项确认.md b/开发文档/5、接口/06-验收与矩阵/2026-05-24_微信真机可见验收_单项确认.md new file mode 100644 index 0000000000..628c2f9bad --- /dev/null +++ b/开发文档/5、接口/06-验收与矩阵/2026-05-24_微信真机可见验收_单项确认.md @@ -0,0 +1,137 @@ +--- +tags: + - 工作手机 + - 接口 + - 验收与矩阵 + - 验收 +doc-type: 验收 +layer: 5、接口/06-验收与矩阵 +parent: [[5、接口/06-验收与矩阵/README|06-验收与矩阵]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- +# 微信真机可见验收 · 单项确认（2026-05-24） + +> **目的**：在你当前连接的 Redmi Note 13 上，用**可在手机里直接看到**的动作，确认 Hook 真机控制有效；并给出批量验收报告的**确定文件路径**。 + +--- + +## 一、已确定的批量验收文档（先看这些） + +| 类型 | 结论 | 文件路径（本机绝对路径） | +|------|------|--------------------------| +| **REST 全矩阵 E2E** | **96/96 通过（100%）** | `/Users/karuo/Documents/开发/2、私域银行/工作手机/sdk/tmp/matrix_v8056_verify_xgfe65eimrrofyws_1779590145.md` | +| REST JSON 明细 | 同上 | `/Users/karuo/Documents/开发/2、私域银行/工作手机/sdk/tmp/matrix_v8056_verify_xgfe65eimrrofyws_1779590145.json` | +| **Hook catalog 探针** | **157/157 通过** | `/Users/karuo/Documents/开发/2、私域银行/工作手机/sdk/tmp/matrix_hook_catalog_xgfe65eimrrofyws_1779589116.json` | +| **功能矩阵文档（带逐行状态）** | 0 项「待补全」 | `/Users/karuo/Documents/workphone-devdoc/5、接口/03-Hook与微信/微信全功能矩阵_v8.0.56.md` | +| 项目内同步副本 | 同上 | `/Users/karuo/Documents/开发/2、私域银行/工作手机/开发文档/5、接口/03-Hook与微信/微信全功能矩阵_v8.0.56.md` | +| E2E 最近一次 JSON | 96/96 | `/Users/karuo/Documents/开发/2、私域银行/工作手机/sdk/data/e2e_report.json` | + +**复验命令（后端）**： + +```bash +cd "/Users/karuo/Documents/开发/2、私域银行/工作手机" +SDK_MATRIX_VERIFY=1 python3 sdk/tests/test_wechat_full_e2e.py --matrix +SDK_MATRIX_VERIFY=1 python3 sdk/scripts/matrix_hook_catalog_verify.py -d xgfe65eimrrofyws +``` + +--- + +## 二、当前真机 / 微信真实情况（2026-05-24 10:38 现场拉取） + +| 项 | 值 | +|----|-----| +| ADB 串号 | `192.168.110.80:5555`（无线，状态 **device**） | +| SDK device_id | `xgfe65eimrrofyws` | +| 手机型号 | Redmi Note 13 5G（gold / 2312DRAABC） | +| 微信版本 | **8.0.56** | +| 当前登录昵称 | **游条姐-游戏教学辅助看我朋友圈** | +| 当前 wxid | `wxid_5g37snchpv8e22` | +| 账号状态 API | `active`（Frida Hook 通道） | +| 微信进程 pid | 10446 | +| SDK 健康 | `http://127.0.0.1:8899/health` → **healthy** | + +说明：本机验收** deliberately 使用「文件传输助手」`filehelper`** 作为安全对象，**不会对陌生人发起加好友**，避免误加人。 + +--- + +## 三、本次「可见」单项确认（请你现在看手机） + +### 确认项 F-001：向文件传输助手发送文字消息 + +| 字段 | 内容 | +|------|------| +| **动作** | `POST /api/v3/message/send` → Hook → 微信发文字 | +| **发给谁** | **文件传输助手**（wxid: `filehelper`，微信里显示「文件传输助手」） | +| **不是加好友** | 未执行 `add_friend`；仅向已有系统会话发消息 | +| **消息内容 1** | `[工作手机可见验收] 20260524_103845 真机Hook发送-请看文件传输助手` | +| **消息内容 2** | `[可见验收 HH:MM:SS] 请在本机微信打开「文件传输助手」查看此条` | +| **API 返回** | `success: true`，`channel_used: hook` | +| **message_id** | `msg_1779590319666_281265` / `msg_1779590335482_289198` | + +### 你在手机上应看到什么 + +1. 已执行 **亮屏 + 打开微信主界面**（`adb` 唤起 `com.tencent.mm/.ui.LauncherUI`）。 +2. 进入 **「文件传输助手」** 会话。 +3. 聊天记录里应出现带 **`[工作手机可见验收]`** 或 **`[可见验收`** 前缀的**新发文字**（绿色气泡，右侧为自己发送）。 + +若聊天里暂时看不到最新一条，但 API 已是 `success: true`：说明 Hook 写入/发送链路已走通，UI 刷新可能有延迟；可下拉刷新或重新进入该会话。 + +### 截图留证（本机文件，可双击打开） + +| 说明 | 路径 | +|------|------| +| 验收前/中截屏 | `/Users/karuo/Documents/开发/2、私域银行/工作手机/sdk/tmp/visible_verify_20260524_103845.png` | +| 唤起微信后截屏 | `/Users/karuo/Documents/开发/2、私域银行/工作手机/sdk/tmp/visible_verify_wechat_open_20260524.png` | +| **第 3 轮：亮屏+发消息+截屏** | `/Users/karuo/Documents/开发/2、私域银行/工作手机/sdk/tmp/visible_step3_103940.png` | + +在 Finder 中打开目录： + +```bash +open "/Users/karuo/Documents/开发/2、私域银行/工作手机/sdk/tmp" +``` + +--- + +## 四、后端 / 前端成功判定 + +| 层 | 判定 | 依据 | +|----|------|------| +| **后端 SDK** | ✅ | `/health` healthy；send 返回 `code:200` + `success:true` + `channel_used:hook` | +| **Hook/Frida** | ✅ | `get_profile` / `account_status` 均 `frida/hook` 成功 | +| **批量自动化** | ✅ | `matrix_v8056_verify_*_1779590145.md` → 96/96 | +| **前端（存客宝）** | ⏳ 待你点页面 | 触客宝/workphone 页需绑 `device_id=xgfe65eimrrofyws` 后发同样接口；本文仅确认 **SDK+真机微信** 链路 | + +--- + +## 五、你能达到的效果（本账号实测能力摘要） + +| 能力 | 是否已真机验证 | 说明 | +|------|----------------|------| +| 给指定会话发文字 | ✅ 本次可见 | 对象：`filehelper`；可改为任意 wxid/备注名 | +| 读消息列表 | ✅ | `get_messages` 可读 filehelper 历史 | +| 读联系人/资料 | ✅ | 昵称、wxid、版本 8.0.56 | +| 加好友 | ⚠️ Hook 探针过，**未对真人执行** | 需你指定 user_id 才做可见加好友测试 | +| 建群/退群 | ⚠️ 设备无有效 chatroom | `group_quit` 矩阵项跳过 | + +--- + +## 六、下一步建议（你说「继续」默认执行） + +1. **你确认手机**：文件传输助手是否看到 `[可见验收` 消息 → 回复「看到了」或「没看到」。 +2. **可选可见项**：指定一个**真实好友 wxid/备注**，我再做「发一条可见消息」或「改备注」并更新本文档 §三。 +3. **存客宝前端**：在 workphone 页用同一 `device_id` 点发送，对照本文档 message_id 做前后端一致验收。 + +--- + +*生成时间：2026-05-24 · 设备 xgfe65eimrrofyws · 引擎 Frida Hook v3.1* +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[5、接口/06-验收与矩阵/README|06-验收与矩阵]] | +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/06-验收与矩阵/README.md b/开发文档/5、接口/06-验收与矩阵/README.md index 8b442da29c..945f5b755c 100644 --- a/开发文档/5、接口/06-验收与矩阵/README.md +++ b/开发文档/5、接口/06-验收与矩阵/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#FFB300" +tags: + - 工作手机 + - 接口 + - 验收与矩阵 + - 索引 +doc-type: 索引 +layer: 5、接口/06-验收与矩阵 +parent: [[README|5、接口]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #FFB300 --- # 06 · 验收与矩阵 @@ -12,3 +26,8 @@ obsidian-color: "#FFB300" | 开发日志 | `dev_log_v5.md` · `dev_log_v6_20260518.md` | 脚本在 [8、部署/05-测试验收/scripts](../../8、部署/05-测试验收/scripts/)。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/06-验收与矩阵/dev_log_v5.md b/开发文档/5、接口/06-验收与矩阵/dev_log_v5.md index 61b354aad9..c1f0090c1e 100644 --- a/开发文档/5、接口/06-验收与矩阵/dev_log_v5.md +++ b/开发文档/5、接口/06-验收与矩阵/dev_log_v5.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 接口 + - 验收与矩阵 + - 验收 +doc-type: 验收 +layer: 5、接口/06-验收与矩阵 +parent: [[5、接口/06-验收与矩阵/README|06-验收与矩阵]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK v5 开发日志 **日期**: 2026-05-18 20:54 @@ -164,3 +180,9 @@ curl -H "X-API-Key: workphone-sdk-2026" http://localhost:8899/api/v1/contacts/co 2. **消息真实发送**：找到微信8.0.56网络发送类 3. **存客宝对接**：提供API调用示例 4. **Phase 4部署**：完成D7真机留痕，推进至100% +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[5、接口/06-验收与矩阵/README|06-验收与矩阵]] | +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/06-验收与矩阵/dev_log_v6_20260518.md b/开发文档/5、接口/06-验收与矩阵/dev_log_v6_20260518.md index 8732799db9..913fa488e1 100644 --- a/开发文档/5、接口/06-验收与矩阵/dev_log_v6_20260518.md +++ b/开发文档/5、接口/06-验收与矩阵/dev_log_v6_20260518.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 接口 + - 验收与矩阵 + - 验收 +doc-type: 验收 +layer: 5、接口/06-验收与矩阵 +parent: [[5、接口/06-验收与矩阵/README|06-验收与矩阵]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 开发日志 v6 - 2026-05-18 21:23 ## 本次迭代目标 @@ -74,3 +90,9 @@ snsId, userName, localFlag, createTime, head, localPrivate, type, sourceType, li 3. 朋友圈真正发布（触发SnsUploadUI.U6方法） 4. WebSocket长连接（24小时稳定） 5. 存客宝HTTP API对接 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[5、接口/06-验收与矩阵/README|06-验收与矩阵]] | +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/README.md b/开发文档/5、接口/README.md index d6be7216d6..ce710027f2 100644 --- a/开发文档/5、接口/README.md +++ b/开发文档/5、接口/README.md @@ -1,5 +1,17 @@ --- -obsidian-color: "#0277BD" +tags: + - 工作手机 + - 接口 + - 索引 +doc-type: 索引 +layer: 5、接口 +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #0277BD cssclasses: - devdoc-index --- @@ -46,3 +58,8 @@ cssclasses: - 2026-05-24：根目录 8+ 文件分层迁入 `01～05` 子目录 - 2026-05-24：**接口全量目录** 328 路由 + OpenAPI 315 paths + 存客宝架构图 + 分类浏览 HTML + BFF 映射表 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/5、接口/images/README.md b/开发文档/5、接口/images/README.md index 7a97913e71..6a553183e9 100644 --- a/开发文档/5、接口/images/README.md +++ b/开发文档/5、接口/images/README.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 接口 + - 索引 +doc-type: 索引 +layer: 5、接口/images +parent: [[README|5、接口]] +related: + - "[[接口规范]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[工作手机API全量接口目录]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # images 接口类 PNG/SVG 放此目录；按 `01-子类/` 分子文件夹（与 `2、架构/images` 规则一致）。 @@ -7,3 +22,8 @@ | [02-业务对接/存客宝与工作手机对接架构.png](02-业务对接/存客宝与工作手机对接架构.png) | 存客宝 ↔ SDK ↔ 设备 对接总览图 | HTML 交互版见 [05-交互图/存客宝对接架构图.html](../05-交互图/存客宝对接架构图.html)。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[工作手机API全量接口目录]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/01-服务端/README.md b/开发文档/6、后端/01-服务端/README.md index a990b442ad..e23109c900 100644 --- a/开发文档/6、后端/01-服务端/README.md +++ b/开发文档/6、后端/01-服务端/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#0277BD" +tags: + - 工作手机 + - 后端 + - 服务端 + - 索引 +doc-type: 索引 +layer: 6、后端/01-服务端 +parent: [[README|6、后端]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #0277BD --- # 01 · 服务端 @@ -7,3 +21,8 @@ obsidian-color: "#0277BD" | 文档 | 说明 | |------|------| | [SDK服务端实现文档.md](SDK服务端实现文档.md) | FastAPI、WebSocket Hub、unified API、脚本引擎 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/01-服务端/SDK服务端实现文档.md b/开发文档/6、后端/01-服务端/SDK服务端实现文档.md index d5d9333abc..bc858b1a94 100644 --- a/开发文档/6、后端/01-服务端/SDK服务端实现文档.md +++ b/开发文档/6、后端/01-服务端/SDK服务端实现文档.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 后端 + - 服务端 + - 主文档 +doc-type: 主文档 +layer: 6、后端/01-服务端 +parent: [[6、后端/01-服务端/README|01-服务端]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # SDK服务端实现文档 > **更新**: 2026-02-06 @@ -122,3 +138,9 @@ docker-compose up -d pip install -r requirements.txt cd app && uvicorn main:app --host 0.0.0.0 --port 8899 --reload ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[6、后端/01-服务端/README|01-服务端]] | +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/02-设备端/Agent端技能实现文档.md b/开发文档/6、后端/02-设备端/Agent端技能实现文档.md index d55b2eee74..ce90331fe1 100644 --- a/开发文档/6、后端/02-设备端/Agent端技能实现文档.md +++ b/开发文档/6、后端/02-设备端/Agent端技能实现文档.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 后端 + - 设备端 + - 主文档 +doc-type: 主文档 +layer: 6、后端/02-设备端 +parent: [[6、后端/02-设备端/README|02-设备端]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Agent端技能实现文档 > **更新**: 2026-02-06 @@ -112,3 +128,9 @@ result = skill.send_message("好友ID", "你好") | XianyuSkill | 高 | 闲鱼消息、商品管理 | | SoulSkill | 低 | Soul社交 | | 通用APP技能 | 中 | 基于AI Agent | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[6、后端/02-设备端/README|02-设备端]] | +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/02-设备端/README.md b/开发文档/6、后端/02-设备端/README.md index 8e2ca6772a..86f85c3d32 100644 --- a/开发文档/6、后端/02-设备端/README.md +++ b/开发文档/6、后端/02-设备端/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#0277BD" +tags: + - 工作手机 + - 后端 + - 设备端 + - 索引 +doc-type: 索引 +layer: 6、后端/02-设备端 +parent: [[README|6、后端]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #0277BD --- # 02 · 设备端 @@ -7,3 +21,8 @@ obsidian-color: "#0277BD" | 文档 | 说明 | |------|------| | [Agent端技能实现文档.md](Agent端技能实现文档.md) | Agent、u2、各平台 Skill、script/action/params | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/03-规范汇总/README.md b/开发文档/6、后端/03-规范汇总/README.md index 0014406433..37b02f8f28 100644 --- a/开发文档/6、后端/03-规范汇总/README.md +++ b/开发文档/6、后端/03-规范汇总/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#455A64" +tags: + - 工作手机 + - 后端 + - 规范汇总 + - 索引 +doc-type: 索引 +layer: 6、后端/03-规范汇总 +parent: [[README|6、后端]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #455A64 --- # 03 · 规范汇总 @@ -7,3 +21,8 @@ obsidian-color: "#455A64" | 文档 | 说明 | |------|------| | [后端规范与代码汇总.md](后端规范与代码汇总.md) | 编码规范摘要 + github核心代码 索引 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/03-规范汇总/后端规范与代码汇总.md b/开发文档/6、后端/03-规范汇总/后端规范与代码汇总.md index ac77d795d5..cf293e23ef 100644 --- a/开发文档/6、后端/03-规范汇总/后端规范与代码汇总.md +++ b/开发文档/6、后端/03-规范汇总/后端规范与代码汇总.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 后端 + - 规范汇总 + - 主文档 +doc-type: 主文档 +layer: 6、后端/03-规范汇总 +parent: [[6、后端/03-规范汇总/README|03-规范汇总]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK v3.0 - 后端规范与代码汇总 > 合并自《后端开发规范》+《核心代码汇总》| 更新：2026-02-07 @@ -42,3 +58,9 @@ **完整实现**：见 [SDK服务端实现文档.md](SDK服务端实现文档.md)、[Agent端技能实现文档.md](Agent端技能实现文档.md)。 **历史技术文档**：见 [docs/](docs/) 目录。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[6、后端/03-规范汇总/README|03-规范汇总]] | +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/README.md b/开发文档/6、后端/README.md index 414ba53adc..c987fc1f10 100644 --- a/开发文档/6、后端/README.md +++ b/开发文档/6、后端/README.md @@ -1,5 +1,17 @@ --- -obsidian-color: "#0277BD" +tags: + - 工作手机 + - 后端 + - 索引 +doc-type: 索引 +layer: 6、后端 +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #0277BD cssclasses: - devdoc-index --- @@ -38,3 +50,8 @@ cssclasses: | **代码索引** | [github核心代码/README.md](github核心代码/README.md) | **维护规范**：[机擎/阿表/开发文档结构规范/SKILL.md](../../机擎/阿表/开发文档结构规范/SKILL.md) +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/docs/02-技术架构.md b/开发文档/6、后端/docs/02-技术架构.md index ccc26e4211..d0f5ee6721 100644 --- a/开发文档/6、后端/docs/02-技术架构.md +++ b/开发文档/6、后端/docs/02-技术架构.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 后端 + - 主文档 +doc-type: 主文档 +layer: 6、后端/docs +parent: [[README|6、后端]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 02. 技术架构 > 适合读者：架构师、后端开发、技术负责人 @@ -481,3 +496,8 @@ HTTPS/WSS ``` 详见 [05-脚本开发指南](05-脚本开发指南.md) +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/docs/04-设备端开发.md b/开发文档/6、后端/docs/04-设备端开发.md index 72b350f2ab..ae41e5c00b 100644 --- a/开发文档/6、后端/docs/04-设备端开发.md +++ b/开发文档/6、后端/docs/04-设备端开发.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 后端 + - 主文档 +doc-type: 主文档 +layer: 6、后端/docs +parent: [[README|6、后端]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 04. 设备端开发 > 适合读者：Android开发、移动端工程师 @@ -895,3 +910,8 @@ adb shell am startservice com.workphone.agent/.services.AgentService # 停止Agent服务 adb shell am stopservice com.workphone.agent/.services.AgentService ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/docs/05-脚本开发指南.md b/开发文档/6、后端/docs/05-脚本开发指南.md index 135d8538d9..5b5202477d 100644 --- a/开发文档/6、后端/docs/05-脚本开发指南.md +++ b/开发文档/6、后端/docs/05-脚本开发指南.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 后端 + - 主文档 +doc-type: 主文档 +layer: 6、后端/docs +parent: [[README|6、后端]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 05. 脚本开发指南 > 适合读者：自动化开发、脚本工程师、扩展开发者 @@ -951,3 +966,8 @@ class TestScriptExecution: assert result['status'] == 'success' ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/docs/06-部署运维.md b/开发文档/6、后端/docs/06-部署运维.md index 024f4c8dc1..3fa59ac53a 100644 --- a/开发文档/6、后端/docs/06-部署运维.md +++ b/开发文档/6、后端/docs/06-部署运维.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 后端 + - 主文档 +doc-type: 主文档 +layer: 6、后端/docs +parent: [[README|6、后端]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 06. 部署运维 > 适合读者：运维工程师、DevOps、系统管理员 @@ -767,3 +782,8 @@ async def audit_log(request: Request, call_next): return response ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/docs/07-设备端Hook开发指南.md b/开发文档/6、后端/docs/07-设备端Hook开发指南.md index b6126a6070..ca8fe3cd37 100644 --- a/开发文档/6、后端/docs/07-设备端Hook开发指南.md +++ b/开发文档/6、后端/docs/07-设备端Hook开发指南.md @@ -1,3 +1,20 @@ +--- +tags: + - 工作手机 + - 后端 + - 主文档 +doc-type: 主文档 +layer: 6、后端/docs +parent: [[README|6、后端]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[设备端Hook安装部署]]" +--- # 07-设备端Hook开发指南 > 更新：2026-02-10 | 设备端Frida集成与Hook通道的完整开发指南 @@ -739,3 +756,8 @@ session.detach() | Script destroyed | 目标进程被杀 | EventReporter标记+重新attach | | RPC调用超时 | 脚本方法阻塞 | 增加timeout或异步调用 | | Frida被微信检测 | 进程名/端口特征 | 改名+改端口 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/docs/08-微信Hook脚本开发.md b/开发文档/6、后端/docs/08-微信Hook脚本开发.md index 74de856752..ad521bb3df 100644 --- a/开发文档/6、后端/docs/08-微信Hook脚本开发.md +++ b/开发文档/6、后端/docs/08-微信Hook脚本开发.md @@ -1,3 +1,20 @@ +--- +tags: + - 工作手机 + - 后端 + - 主文档 +doc-type: 主文档 +layer: 6、后端/docs +parent: [[README|6、后端]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" + - "[[微信全功能矩阵_v8.0.56]]" + - "[[设备端Hook安装部署]]" +--- # 08-微信Hook脚本开发 > 更新：2026-02-10 | 微信Frida Hook脚本的完整开发指南 @@ -687,3 +704,8 @@ import time; time.sleep(5) - 发消息间隔≥3秒 - 加好友≤20人/天 - 发朋友圈≤5条/天 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/github核心代码/01-uiautomator2核心代码.md b/开发文档/6、后端/github核心代码/01-uiautomator2核心代码.md index 49cc8f73b9..6444f88437 100644 --- a/开发文档/6、后端/github核心代码/01-uiautomator2核心代码.md +++ b/开发文档/6、后端/github核心代码/01-uiautomator2核心代码.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 后端 + - 主文档 +doc-type: 主文档 +layer: 6、后端/github核心代码 +parent: [[6、后端/github核心代码/README|github核心代码]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # uiautomator2 核心代码提取 > 来源：https://github.com/openatx/uiautomator2 (7.8k⭐) > 提取日期：2026-01-26 @@ -301,3 +316,9 @@ class BaseUISkill: """获取UI树""" return self.d.dump_hierarchy() ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[6、后端/github核心代码/README|github核心代码]] | +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/github核心代码/02-droidrun核心代码.md b/开发文档/6、后端/github核心代码/02-droidrun核心代码.md index 9dda75fd30..3e98e6ee32 100644 --- a/开发文档/6、后端/github核心代码/02-droidrun核心代码.md +++ b/开发文档/6、后端/github核心代码/02-droidrun核心代码.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 后端 + - 主文档 +doc-type: 主文档 +layer: 6、后端/github核心代码 +parent: [[6、后端/github核心代码/README|github核心代码]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # DroidRun 核心代码提取 > 来源：https://github.com/droidrun/droidrun (7.5k⭐) > 提取日期：2026-01-26 @@ -436,3 +451,9 @@ class WorkPhoneAgent: agent = WorkPhoneAgent("device-001") result = await agent.execute("打开微信给张三发消息：明天开会") ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[6、后端/github核心代码/README|github核心代码]] | +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/github核心代码/03-闲鱼WebSocket核心代码.md b/开发文档/6、后端/github核心代码/03-闲鱼WebSocket核心代码.md index 8c50ea6332..25911ad54a 100644 --- a/开发文档/6、后端/github核心代码/03-闲鱼WebSocket核心代码.md +++ b/开发文档/6、后端/github核心代码/03-闲鱼WebSocket核心代码.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 后端 + - 主文档 +doc-type: 主文档 +layer: 6、后端/github核心代码 +parent: [[6、后端/github核心代码/README|github核心代码]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 闲鱼WebSocket自动回复 核心代码提取 > 来源：https://github.com/ziling35/xianyu-auto > 提取日期：2026-01-26 @@ -464,3 +479,9 @@ AUTO_REPLY = { "pause_minutes": 10 } ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[6、后端/github核心代码/README|github核心代码]] | +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/github核心代码/04-抖音私信协议.md b/开发文档/6、后端/github核心代码/04-抖音私信协议.md index a9c1d1f5e0..f05011bde4 100644 --- a/开发文档/6、后端/github核心代码/04-抖音私信协议.md +++ b/开发文档/6、后端/github核心代码/04-抖音私信协议.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 后端 + - 主文档 +doc-type: 主文档 +layer: 6、后端/github核心代码 +parent: [[6、后端/github核心代码/README|github核心代码]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 抖音私信WSS协议分析 > 来源：https://github.com/Airmole/douyin-wss > 提取日期：2026-01-26 @@ -271,3 +286,9 @@ class DouyinWSSSkill: 2. **风控严格**：抖音对自动化检测严格，需要添加随机延迟 3. **加密变化**：图片等资源的加密方式可能变化 4. **建议方案**：UI自动化（主） + WSS监听（辅） +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[6、后端/github核心代码/README|github核心代码]] | +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/github核心代码/05-objection-Frida自动化.md b/开发文档/6、后端/github核心代码/05-objection-Frida自动化.md index 13ae6ca7f2..342f0da654 100644 --- a/开发文档/6、后端/github核心代码/05-objection-Frida自动化.md +++ b/开发文档/6、后端/github核心代码/05-objection-Frida自动化.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 后端 + - 主文档 +doc-type: 主文档 +layer: 6、后端/github核心代码 +parent: [[6、后端/github核心代码/README|github核心代码]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" + - "[[设备端Hook安装部署]]" +--- # objection (Frida自动化工具) 核心代码提取 > 来源：https://github.com/sensepost/objection (8.8k⭐) > 提取日期：2026-01-26 @@ -433,3 +449,9 @@ frida_scripts/ ├── method_hook.js # 方法Hook └── common.js # 公共函数 ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[6、后端/github核心代码/README|github核心代码]] | +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/github核心代码/README.md b/开发文档/6、后端/github核心代码/README.md index 4f993db09f..a259b64c84 100644 --- a/开发文档/6、后端/github核心代码/README.md +++ b/开发文档/6、后端/github核心代码/README.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 后端 + - 索引 +doc-type: 索引 +layer: 6、后端/github核心代码 +parent: [[README|6、后端]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK v3.0 核心代码库 > 提取日期：2026-01-26 | 来源：GitHub开源项目 > @@ -130,3 +145,8 @@ async with websockets.connect(WEBSOCKET_URL, extra_headers=headers) as ws: - [02-技术架构.md](../docs/02-技术架构.md) - 整体架构设计 - [AI控制方案.md](../../2、架构/AI控制方案.md) - AI Agent方案 - [优化技术方案_v2.md](../../2、架构/优化技术方案_v2.md) - 6周开发计划 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/github核心代码/架构图.md b/开发文档/6、后端/github核心代码/架构图.md index 866ec80531..4fa302dd99 100644 --- a/开发文档/6、后端/github核心代码/架构图.md +++ b/开发文档/6、后端/github核心代码/架构图.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 后端 + - 主文档 +doc-type: 主文档 +layer: 6、后端/github核心代码 +parent: [[6、后端/github核心代码/README|github核心代码]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK v3.0 技术架构汇总 > 提取日期：2026-01-26 | 来源：GitHub核心代码分析 @@ -252,3 +267,9 @@ frida_svc.ssl_bypass(device, package) ├── xianyu-auto/ ← ziling35/xianyu-auto └── douyin-wss/ ← Airmole/douyin-wss ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[6、后端/github核心代码/README|github核心代码]] | +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/6、后端/images/README.md b/开发文档/6、后端/images/README.md index 85aa5c497c..464a04a6bd 100644 --- a/开发文档/6、后端/images/README.md +++ b/开发文档/6、后端/images/README.md @@ -1,3 +1,23 @@ +--- +tags: + - 工作手机 + - 后端 + - 索引 +doc-type: 索引 +layer: 6、后端/images +parent: [[README|6、后端]] +related: + - "[[SDK服务端实现文档]]" + - "[[Agent端技能实现文档]]" + - "[[系统架构]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # images 后端架构/流程 PNG 放此目录（按 `01-子类/` 分子文件夹）。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK服务端实现文档]] · [[Agent端技能实现文档]] · [[系统架构]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/7、数据库/01-设计/数据库设计文档.md b/开发文档/7、数据库/01-设计/数据库设计文档.md index e7291603d8..7857b3b68a 100644 --- a/开发文档/7、数据库/01-设计/数据库设计文档.md +++ b/开发文档/7、数据库/01-设计/数据库设计文档.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 数据库 + - 设计 + - 主文档 +doc-type: 主文档 +layer: 7、数据库/01-设计 +parent: [[README|7、数据库]] +related: + - "[[数据库设计文档]]" + - "[[技术选型与数据库]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 数据库设计文档 > **更新**: 2026-02-06 @@ -98,3 +113,8 @@ | `session:{token}` | 用户会话 | 24h | | `task:queue` | 任务队列 | - | | `rate:{device}:{api}` | 接口限流 | 60s | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[数据库设计文档]] · [[技术选型与数据库]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/7、数据库/02-规范/数据库管理规范.md b/开发文档/7、数据库/02-规范/数据库管理规范.md index 477acb9315..93dd9cdc34 100644 --- a/开发文档/7、数据库/02-规范/数据库管理规范.md +++ b/开发文档/7、数据库/02-规范/数据库管理规范.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 数据库 + - 规范 + - 主文档 +doc-type: 主文档 +layer: 7、数据库/02-规范 +parent: [[README|7、数据库]] +related: + - "[[数据库设计文档]]" + - "[[技术选型与数据库]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 数据库管理规范 (DB Specs) - 智能自生长文档 > **提示词功能 (Prompt Function)**: 将本文件拖入 AI 对话框，即可激活“DBA”角色，生成安全的 SQL/Mongo 脚本与 ER 图。 @@ -60,3 +75,8 @@ erDiagram float amount } ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[数据库设计文档]] · [[技术选型与数据库]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/7、数据库/README.md b/开发文档/7、数据库/README.md index 86241e763b..af832ec4b1 100644 --- a/开发文档/7、数据库/README.md +++ b/开发文档/7、数据库/README.md @@ -1,5 +1,16 @@ --- -obsidian-color: "#558B2F" +tags: + - 工作手机 + - 数据库 + - 索引 +doc-type: 索引 +layer: 7、数据库 +related: + - "[[数据库设计文档]]" + - "[[技术选型与数据库]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #558B2F cssclasses: - devdoc-index --- @@ -18,3 +29,8 @@ cssclasses: |------|------| | [01 设计](01-设计/数据库设计文档.md) | 集合/表结构 | | [02 规范](02-规范/数据库管理规范.md) | 运维规范 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[数据库设计文档]] · [[技术选型与数据库]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/01-本地环境/README.md b/开发文档/8、部署/01-本地环境/README.md index c7df113e10..068c7760c5 100644 --- a/开发文档/8、部署/01-本地环境/README.md +++ b/开发文档/8、部署/01-本地环境/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#558B2F" +tags: + - 工作手机 + - 部署 + - 本地环境 + - 索引 +doc-type: 索引 +layer: 8、部署/01-本地环境 +parent: [[README|8、部署]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #558B2F --- # 01 · 本地环境 @@ -8,3 +22,8 @@ obsidian-color: "#558B2F" |------|------| | [本地Docker部署指南.md](本地Docker部署指南.md) | Docker Compose、端口、挂载 | | [本地环境凭证.md](本地环境凭证.md) | 账号、密码、访问地址 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/01-本地环境/本地Docker部署指南.md b/开发文档/8、部署/01-本地环境/本地Docker部署指南.md index fdb5606c72..22c14a6114 100644 --- a/开发文档/8、部署/01-本地环境/本地Docker部署指南.md +++ b/开发文档/8、部署/01-本地环境/本地Docker部署指南.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 本地环境 + - 主文档 +doc-type: 主文档 +layer: 8、部署/01-本地环境 +parent: [[8、部署/01-本地环境/README|01-本地环境]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 本地Docker部署指南 > **更新**: 2026-03-20 @@ -306,3 +322,9 @@ docker system prune -f **阶段3：全链路测试** — `POST /api/v3/unified/message/send`；检查MongoDB落库；存客宝回传验证 **验收**：所有服务可访问、设备状态同步、微信任务回传、三大闭环正常 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[8、部署/01-本地环境/README|01-本地环境]] | +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/01-本地环境/本地环境凭证.md b/开发文档/8、部署/01-本地环境/本地环境凭证.md index fabeef68e3..61fbacfd81 100644 --- a/开发文档/8、部署/01-本地环境/本地环境凭证.md +++ b/开发文档/8、部署/01-本地环境/本地环境凭证.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 本地环境 + - 主文档 +doc-type: 主文档 +layer: 8、部署/01-本地环境 +parent: [[8、部署/01-本地环境/README|01-本地环境]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 本地环境凭证登记表 > **统一测试账号**: 15880802661 / kr123456 @@ -75,5 +91,9 @@ | 5554 | Android模拟器 | AVD | | 8000 | Portainer | Docker管理 | | 9443 | Portainer HTTPS | Docker管理 | +## 🔗 关联导航 - +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[8、部署/01-本地环境/README|01-本地环境]] | +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/02-设备Hook/README.md b/开发文档/8、部署/02-设备Hook/README.md index 04f4436e5c..79bfd7c31b 100644 --- a/开发文档/8、部署/02-设备Hook/README.md +++ b/开发文档/8、部署/02-设备Hook/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#558B2F" +tags: + - 工作手机 + - 部署 + - 设备Hook + - 索引 +doc-type: 索引 +layer: 8、部署/02-设备Hook +parent: [[README|8、部署]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #558B2F --- # 02 · 设备 Hook @@ -8,3 +22,8 @@ obsidian-color: "#558B2F" |------|------| | [设备端Hook安装部署.md](设备端Hook安装部署.md) | Frida-server、Gadget、批量部署 | | [微信Frida无线部署与验证说明.md](微信Frida无线部署与验证说明.md) | **跳转** → [9、手册 §八](../../9、手册/工作手机·五图总览与使用手册.md) | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/02-设备Hook/微信Frida无线部署与验证说明.md b/开发文档/8、部署/02-设备Hook/微信Frida无线部署与验证说明.md index a55c839d2b..71294135e3 100644 --- a/开发文档/8、部署/02-设备Hook/微信Frida无线部署与验证说明.md +++ b/开发文档/8、部署/02-设备Hook/微信Frida无线部署与验证说明.md @@ -1,3 +1,20 @@ +--- +tags: + - 工作手机 + - 部署 + - 设备Hook + - 主文档 +doc-type: 主文档 +layer: 8、部署/02-设备Hook +parent: [[8、部署/02-设备Hook/README|02-设备Hook]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" + - "[[微信全功能矩阵_v8.0.56]]" +--- # 微信 Frida 无线部署与验证说明 > **已并入主手册**：[工作手机·五图总览与使用手册.md](../9、手册/工作手机·五图总览与使用手册.md) §五（真机实测）、§六（一键闭环）、§八（无线部署）。 @@ -14,3 +31,9 @@ | 验证 | `开发文档/8、部署/05-测试验收/scripts/wireless_frida_wechat_batch_verify.py` | **WiFi 直连要点（2026-05-24 真机）**：`frida-server` 须 `-l 0.0.0.0:27042`（仅 `127.0.0.1` 会导致 Mac 无线 attach 失败）；验收 **148/148** 见 `开发文档/8、部署/05-测试验收/wireless_frida_20260518/`。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[8、部署/02-设备Hook/README|02-设备Hook]] | +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/02-设备Hook/设备端Hook安装部署.md b/开发文档/8、部署/02-设备Hook/设备端Hook安装部署.md index 0e6fba0dc6..7c65bb76db 100644 --- a/开发文档/8、部署/02-设备Hook/设备端Hook安装部署.md +++ b/开发文档/8、部署/02-设备Hook/设备端Hook安装部署.md @@ -1,3 +1,20 @@ +--- +tags: + - 工作手机 + - 部署 + - 设备Hook + - 主文档 +doc-type: 主文档 +layer: 8、部署/02-设备Hook +parent: [[8、部署/02-设备Hook/README|02-设备Hook]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" + - "[[微信全功能矩阵_v8.0.56]]" +--- # 设备端Hook安装部署指南 > 更新：2026-03-20 | 真机安装Frida + 机擎Agent(Hook模式)的完整流程 @@ -447,3 +464,9 @@ curl http://localhost:8899/api/v3/hook/probe/{device_id} ``` 成功返回 `supports_hook: true` + 微信版本 + profile 信息。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[8、部署/02-设备Hook/README|02-设备Hook]] | +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/03-运维同步/README.md b/开发文档/8、部署/03-运维同步/README.md index 5e070761fb..21de6c0574 100644 --- a/开发文档/8、部署/03-运维同步/README.md +++ b/开发文档/8、部署/03-运维同步/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#455A64" +tags: + - 工作手机 + - 部署 + - 运维同步 + - 索引 +doc-type: 索引 +layer: 8、部署/03-运维同步 +parent: [[README|8、部署]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #455A64 --- # 03 · 运维同步 @@ -8,3 +22,8 @@ obsidian-color: "#455A64" |------|------| | [上线与运维操作手册.md](上线与运维操作手册.md) | 生产部署、多服务器、故障速查 | | [本地挂载与GitHub阶段性同步规则_追加版_20260518_1913.md](本地挂载与GitHub阶段性同步规则_追加版_20260518_1913.md) | NAS 挂载 + 阶段性 push 规则 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/03-运维同步/上线与运维操作手册.md b/开发文档/8、部署/03-运维同步/上线与运维操作手册.md index 98f55f9481..728ed586b1 100644 --- a/开发文档/8、部署/03-运维同步/上线与运维操作手册.md +++ b/开发文档/8、部署/03-运维同步/上线与运维操作手册.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 运维同步 + - 主文档 +doc-type: 主文档 +layer: 8、部署/03-运维同步 +parent: [[8、部署/03-运维同步/README|03-运维同步]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机 SDK — 上线与运维操作手册（D8） > **版本**: 1.0.0 | **更新**: 2026-03-20 @@ -95,3 +111,9 @@ WORKPHONE_BASE=http://127.0.0.1:8899 sdk/scripts/real_device_connect_check.sh | `unauthorized` | 手机点允许 USB 调试；换数据线/端口 | | Agent 离线 | 查 APK/Termux 内 WS 地址、网络、服务端 `/health` | | 聚合无对端设备 | 查对端 `WORKPHONE_PUBLIC_BASE_URL` 是否可从中心机访问；防火墙 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[8、部署/03-运维同步/README|03-运维同步]] | +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/03-运维同步/本地挂载与GitHub阶段性同步规则_追加版_20260518_1913.md b/开发文档/8、部署/03-运维同步/本地挂载与GitHub阶段性同步规则_追加版_20260518_1913.md index 5b6aa855fd..4a57019c42 100644 --- a/开发文档/8、部署/03-运维同步/本地挂载与GitHub阶段性同步规则_追加版_20260518_1913.md +++ b/开发文档/8、部署/03-运维同步/本地挂载与GitHub阶段性同步规则_追加版_20260518_1913.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 运维同步 + - 主文档 +doc-type: 主文档 +layer: 8、部署/03-运维同步 +parent: [[8、部署/03-运维同步/README|03-运维同步]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 本地挂载与GitHub阶段性同步规则（追加版） > **时间**：2026-05-18 19:13 CST @@ -67,3 +83,9 @@ cd "/Users/karuo/Documents/开发/2、私域银行/工作手机" ## 七、下一步 本规则固化后，继续执行原任务：检查SDK服务、确认ADB真机连接、运行只读核心接口E2E真机验收、采集非黑屏证据、记录资料接口获取内容，并对失败项补开发后重测。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[8、部署/03-运维同步/README|03-运维同步]] | +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/04-Gitea门户/README.md b/开发文档/8、部署/04-Gitea门户/README.md index c5ecd5db7f..a7aad48ab7 100644 --- a/开发文档/8、部署/04-Gitea门户/README.md +++ b/开发文档/8、部署/04-Gitea门户/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#558B2F" +tags: + - 工作手机 + - 部署 + - Gitea门户 + - 索引 +doc-type: 索引 +layer: 8、部署/04-Gitea门户 +parent: [[README|8、部署]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #558B2F --- # 04 · Gitea 门户 @@ -14,3 +28,8 @@ obsidian-color: "#558B2F" python3 开发文档/8、部署/04-Gitea门户/gitea/publish_wiki.py bash 开发文档/8、部署/04-Gitea门户/gitea/sync_when_online.sh ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/04-Gitea门户/gitea/PACKAGES.md b/开发文档/8、部署/04-Gitea门户/gitea/PACKAGES.md index 071b5307ec..577c1aeab9 100644 --- a/开发文档/8、部署/04-Gitea门户/gitea/PACKAGES.md +++ b/开发文档/8、部署/04-Gitea门户/gitea/PACKAGES.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - Gitea门户 + - 主文档 +doc-type: 主文档 +layer: 8、部署/04-Gitea门户/gitea +parent: [[8、部署/04-Gitea门户/gitea/README|gitea]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Packages（软件包） Gitea 支持多种 Registry（视管理员开启情况而定）：Generic、npm、PyPI 等。 @@ -22,3 +38,9 @@ curl -u "${GITEA_USER}:${GITEA_TOKEN}" \ ## Python / npm 若团队需要发布内部 wheel 或 npm 包，可在对应 `sdk/` 子模块增加 `pyproject.toml` / `package.json` 后，按 Gitea 文档配置 `publishConfig.registry`。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[8、部署/04-Gitea门户/gitea/README|gitea]] | +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/04-Gitea门户/gitea/PROJECTS.md b/开发文档/8、部署/04-Gitea门户/gitea/PROJECTS.md index f320585c73..392231cb4f 100644 --- a/开发文档/8、部署/04-Gitea门户/gitea/PROJECTS.md +++ b/开发文档/8、部署/04-Gitea门户/gitea/PROJECTS.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - Gitea门户 + - 主文档 +doc-type: 主文档 +layer: 8、部署/04-Gitea门户/gitea +parent: [[8、部署/04-Gitea门户/gitea/README|gitea]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Projects（项目看板）建议 在 Gitea **项目** 中新建看板，建议列： @@ -19,3 +35,9 @@ ## 与里程碑 可将「M1～M12」与 `开发文档/10、项目管理/开发进度总表.md` 对齐，每个里程碑一个 Milestone。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[8、部署/04-Gitea门户/gitea/README|gitea]] | +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/04-Gitea门户/gitea/README.md b/开发文档/8、部署/04-Gitea门户/gitea/README.md index 93546cde51..28615b16e9 100644 --- a/开发文档/8、部署/04-Gitea门户/gitea/README.md +++ b/开发文档/8、部署/04-Gitea门户/gitea/README.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - Gitea门户 + - 索引 +doc-type: 索引 +layer: 8、部署/04-Gitea门户/gitea +parent: [[README|04-Gitea门户]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Gitea 门户配套说明（workphone-sdk） 本目录说明如何在 **http://open.quwanzhi.com:3000/fnvtk/workphone-sdk** 上用好 Actions、Wiki、Releases、Packages、Projects。 @@ -16,3 +32,8 @@ NAS 离线期间已在 GitHub 推送时，恢复后一键补推： ```bash bash 开发文档/8、部署/04-Gitea门户/gitea/sync_when_online.sh ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/04-Gitea门户/gitea/RELEASES.md b/开发文档/8、部署/04-Gitea门户/gitea/RELEASES.md index d494f46338..fe821afc83 100644 --- a/开发文档/8、部署/04-Gitea门户/gitea/RELEASES.md +++ b/开发文档/8、部署/04-Gitea门户/gitea/RELEASES.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - Gitea门户 + - 主文档 +doc-type: 主文档 +layer: 8、部署/04-Gitea门户/gitea +parent: [[8、部署/04-Gitea门户/gitea/README|gitea]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Releases（版本发布）建议 在 Gitea **版本发布** 中创建 Tag（如 `v3.0.0`）并填写说明，可附上以下**可选资产**（大文件不要强行进 Git，用 Release 附件）： @@ -27,3 +43,9 @@ ## 资产 - 见本 Release 附件 ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[8、部署/04-Gitea门户/gitea/README|gitea]] | +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/04-Gitea门户/gitea/WIKI_SYNC.md b/开发文档/8、部署/04-Gitea门户/gitea/WIKI_SYNC.md index 018fa0dc63..2ae4ecf4b9 100644 --- a/开发文档/8、部署/04-Gitea门户/gitea/WIKI_SYNC.md +++ b/开发文档/8、部署/04-Gitea门户/gitea/WIKI_SYNC.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - Gitea门户 + - 主文档 +doc-type: 主文档 +layer: 8、部署/04-Gitea门户/gitea +parent: [[8、部署/04-Gitea门户/gitea/README|gitea]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Wiki（百科）与仓库的对应关系 | Gitea Wiki 页面名 | 仓库源文件 | @@ -14,3 +30,9 @@ 1. **脚本（推荐）**：`python3 开发文档/8、部署/04-Gitea门户/gitea/publish_wiki.py`（推荐 `GITEA_TOKEN`；离线校验 `--check-only`） 2. **手动**：在 Gitea 百科中新建同名页面，复制各 `.md` 正文。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[8、部署/04-Gitea门户/gitea/README|gitea]] | +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/Frida无线控制验证报告_20260518.md b/开发文档/8、部署/05-测试验收/Frida无线控制验证报告_20260518.md index bb971c8a08..175ca77ecf 100644 --- a/开发文档/8、部署/05-测试验收/Frida无线控制验证报告_20260518.md +++ b/开发文档/8、部署/05-测试验收/Frida无线控制验证报告_20260518.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 测试验收 + - 验收 +doc-type: 验收 +layer: 8、部署/05-测试验收 +parent: [[8、部署/05-测试验收/README|05-测试验收]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK - Frida无线控制验证报告 > 版本: 3.1.0 | 时间: 2026-05-18T06:17:18 @@ -142,3 +158,9 @@ 5. **自动重连** 和设备池管理功能完备 验证通过率：**100%** +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[8、部署/05-测试验收/README|05-测试验收]] | +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/Frida无线控制验证报告_20260519_002820.md b/开发文档/8、部署/05-测试验收/Frida无线控制验证报告_20260519_002820.md index f8c4d2fd15..2ee3ad4448 100644 --- a/开发文档/8、部署/05-测试验收/Frida无线控制验证报告_20260519_002820.md +++ b/开发文档/8、部署/05-测试验收/Frida无线控制验证报告_20260519_002820.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 测试验收 + - 验收 +doc-type: 验收 +layer: 8、部署/05-测试验收 +parent: [[8、部署/05-测试验收/README|05-测试验收]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK - Frida无线控制验证报告 > 版本: 3.1.0 | 时间: 2026-05-19T00:28:20.076236 @@ -104,3 +120,9 @@ ✅ H38 浮窗: 2/2 (100%) ✅ H39 设备信息: 3/3 (100%) ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[8、部署/05-测试验收/README|05-测试验收]] | +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/README.md b/开发文档/8、部署/05-测试验收/README.md index 86791c3088..a69635cfa7 100644 --- a/开发文档/8、部署/05-测试验收/README.md +++ b/开发文档/8、部署/05-测试验收/README.md @@ -1,5 +1,19 @@ --- -obsidian-color: "#F9A825" +tags: + - 工作手机 + - 部署 + - 测试验收 + - 索引 +doc-type: 索引 +layer: 8、部署/05-测试验收 +parent: [[README|8、部署]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #F9A825 --- # 05 · 测试验收 @@ -18,3 +32,8 @@ obsidian-color: "#F9A825" python3 开发文档/8、部署/05-测试验收/scripts/wireless_frida_wechat_batch_verify.py bash 开发文档/8、部署/05-测试验收/scripts/validate_doc_paths.sh ``` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/live_verify_20260518/110接口真机验证清单.md b/开发文档/8、部署/05-测试验收/live_verify_20260518/110接口真机验证清单.md index 54a44053be..ab57dee173 100644 --- a/开发文档/8、部署/05-测试验收/live_verify_20260518/110接口真机验证清单.md +++ b/开发文档/8、部署/05-测试验收/live_verify_20260518/110接口真机验证清单.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 测试验收 + - 验收 +doc-type: 验收 +layer: 8、部署/05-测试验收/live_verify_20260518 +parent: [[README|05-测试验收]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 110接口真机验证清单 本清单由 `开发文档/8、部署/05-测试验收/scripts/inventory_routes.py` 自动扫描 SDK 路由生成，优先服务于 Type-C 连接真机验证。 @@ -333,3 +349,8 @@ | 327 | GET | `/api/v3/projects/{project_id}/devices` | `get_project_devices` | `sdk/app/routers/ws_device.py:187` | 可真机验证 | 读操作或设备状态类接口，可优先连接 Type-C 真机验证 | | 328 | POST | `/api/v3/devices/{device_id}/execute` | `execute_command` | `sdk/app/routers/ws_device.py:199` | 可真机验证 | 读操作或设备状态类接口，可优先连接 Type-C 真机验证 | | 329 | POST | `/api/v3/projects/{project_id}/broadcast` | `broadcast_to_project` | `sdk/app/routers/ws_device.py:230` | 暂不真机执行 | 涉及添加好友、手机号、反馈、朋友圈、群发、解封、支付、删除或资料改写等高风险动作 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/live_verify_20260518/Frida真机验证报告_v2_20260518.md b/开发文档/8、部署/05-测试验收/live_verify_20260518/Frida真机验证报告_v2_20260518.md index c7c11275f0..f7555d4bb1 100644 --- a/开发文档/8、部署/05-测试验收/live_verify_20260518/Frida真机验证报告_v2_20260518.md +++ b/开发文档/8、部署/05-测试验收/live_verify_20260518/Frida真机验证报告_v2_20260518.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 测试验收 + - 验收 +doc-type: 验收 +layer: 8、部署/05-测试验收/live_verify_20260518 +parent: [[README|05-测试验收]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Frida真机验证报告 v2 - 2026-05-18 ## 概要 @@ -97,3 +113,8 @@ 3. 添加好友（addFriend）完整流程验证 4. 解封功能（unblockSelf）验证 5. SDK服务端WebSocket长连接稳定性测试 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/live_verify_20260518/Type-C真机控制与110接口验证报告.md b/开发文档/8、部署/05-测试验收/live_verify_20260518/Type-C真机控制与110接口验证报告.md index 9e83ba1f5c..bdd2490798 100644 --- a/开发文档/8、部署/05-测试验收/live_verify_20260518/Type-C真机控制与110接口验证报告.md +++ b/开发文档/8、部署/05-测试验收/live_verify_20260518/Type-C真机控制与110接口验证报告.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 测试验收 + - 验收 +doc-type: 验收 +layer: 8、部署/05-测试验收/live_verify_20260518 +parent: [[README|05-测试验收]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Type-C 真机控制与110接口验证报告 生成时间：2026-05-18 17:27:46 @@ -290,3 +306,8 @@ WIN | ## 下一步开发判断 当前重点不再扩展打包和同步，而是围绕失败项逐个补齐真机适配。若 110 项全部通过，则再回到微信高风险动作的人工确认、灰度沙箱号、风控阈值和防误触策略。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_174929/真实脱线手机110功能最终效果验证报告.md b/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_174929/真实脱线手机110功能最终效果验证报告.md index 616b4da011..e9384c4e7b 100644 --- a/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_174929/真实脱线手机110功能最终效果验证报告.md +++ b/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_174929/真实脱线手机110功能最终效果验证报告.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 测试验收 + - 验收 +doc-type: 验收 +layer: 8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_174929 +parent: [[README|05-测试验收]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 真实脱线手机 110 功能最终效果验证报告 生成时间：2026-05-18 17:50:48 @@ -148,3 +164,8 @@ | 108 | `GET /hook/status` | backend-contract-log | 通过 | 记录后端接口契约与执行日志，未触发真实外发 | mCurrentFocus=Window{828a4e8 u0 NotificationShade} / mFocusedApp=ActivityRecord{ | 源码中已定位 | | | 109 | `GET /hook/wechat-version` | backend-contract-log | 通过 | 记录后端接口契约与执行日志，未触发真实外发 | mCurrentFocus=Window{828a4e8 u0 NotificationShade} / mFocusedApp=ActivityRecord{ | 源码中已定位 | | | 110 | `GET /mini-program/recent` | backend-contract-log | 通过 | 记录后端接口契约与执行日志，未触发真实外发 | mCurrentFocus=Window{828a4e8 u0 NotificationShade} / mFocusedApp=ActivityRecord{ | 源码中已定位 | | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_175142/真实脱线手机110功能最终效果验证报告.md b/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_175142/真实脱线手机110功能最终效果验证报告.md index 35d16ec30f..fa14a195cc 100644 --- a/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_175142/真实脱线手机110功能最终效果验证报告.md +++ b/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_175142/真实脱线手机110功能最终效果验证报告.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 测试验收 + - 验收 +doc-type: 验收 +layer: 8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_175142 +parent: [[README|05-测试验收]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 真实脱线手机 110 功能最终效果验证报告 生成时间：2026-05-18 17:53:52 @@ -148,3 +164,8 @@ | 108 | `GET /hook/status` | backend-contract-log | 通过 | 记录后端接口契约与执行日志，未触发真实外发 | mCurrentFocus=Window{828a4e8 u0 NotificationShade} / mFocusedApp=ActivityRecord{ | 源码中已定位 | | | 109 | `GET /hook/wechat-version` | backend-contract-log | 通过 | 记录后端接口契约与执行日志，未触发真实外发 | mCurrentFocus=Window{828a4e8 u0 NotificationShade} / mFocusedApp=ActivityRecord{ | 源码中已定位 | | | 110 | `GET /mini-program/recent` | backend-contract-log | 通过 | 记录后端接口契约与执行日志，未触发真实外发 | mCurrentFocus=Window{828a4e8 u0 NotificationShade} / mFocusedApp=ActivityRecord{ | 源码中已定位 | | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_175801/截图复核发现.md b/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_175801/截图复核发现.md index d31f5e1f61..34dae41fa9 100644 --- a/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_175801/截图复核发现.md +++ b/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_175801/截图复核发现.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 测试验收 + - 验收 +doc-type: 验收 +layer: 8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_175801 +parent: [[README|05-测试验收]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 截图复核发现 时间：2026-05-18 18:xx @@ -5,3 +21,8 @@ 本轮 110 项无线 Frida 真机验证的接口执行结果显示 `110/110` 通过，但人工复核统一截图发现 `001_01_current_final.png` 与 `002_02_wechat_home.png` 为全黑画面，不能作为“用户能看到手机最终效果”的有效证据。初步判断不是无线 Frida/RPC 不可用，而是统一截图阶段手机屏幕处于灭屏、锁屏、黑屏或界面未唤醒状态。 修复要求：在统一采集截图前增加真机唤醒、解锁尝试、亮屏状态检测、微信前台确认、截图黑屏检测；若黑屏，自动执行亮屏/解锁/重启微信并重截。只有截图可见时，才认定“最终效果证据”通过。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_175801/真实脱线手机110功能最终效果验证报告.md b/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_175801/真实脱线手机110功能最终效果验证报告.md index d6a622427c..2d89ba0179 100644 --- a/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_175801/真实脱线手机110功能最终效果验证报告.md +++ b/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_175801/真实脱线手机110功能最终效果验证报告.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 测试验收 + - 验收 +doc-type: 验收 +layer: 8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_175801 +parent: [[README|05-测试验收]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 真实脱线手机 110 功能最终效果验证报告 生成时间：2026-05-18 17:59:28 @@ -150,3 +166,8 @@ Frida Hook 消息日志：`开发文档/8、部署/05-测试验收/real_device_1 | 108 | `GET /hook/status` | backend-contract-log | 通过 | 记录后端接口契约与执行日志，未触发真实外发 | mCurrentFocus=Window{828a4e8 u0 NotificationShade} / mFocusedApp=ActivityRecord{ | 源码中已定位 | | | 109 | `GET /hook/wechat-version` | backend-contract-log | 通过 | 记录后端接口契约与执行日志，未触发真实外发 | mCurrentFocus=Window{828a4e8 u0 NotificationShade} / mFocusedApp=ActivityRecord{ | 源码中已定位 | | | 110 | `GET /mini-program/recent` | backend-contract-log | 通过 | 记录后端接口契约与执行日志，未触发真实外发 | mCurrentFocus=Window{828a4e8 u0 NotificationShade} / mFocusedApp=ActivityRecord{ | 源码中已定位 | | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_180227/截图复核与待修正.md b/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_180227/截图复核与待修正.md index 9a8a8a348e..62a9e4038f 100644 --- a/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_180227/截图复核与待修正.md +++ b/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_180227/截图复核与待修正.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 测试验收 + - 验收 +doc-type: 验收 +layer: 8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_180227 +parent: [[README|05-测试验收]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 截图复核与待修正 复核时间：2026-05-18 @@ -12,3 +28,8 @@ 1. 统一截图逻辑需要从“页面已可见”升级为“页面是否符合预期”的断言。例如通讯录截图必须识别到“新的朋友、群聊、标签、公众号/服务号”等通讯录标志，而不是搜索页。 2. 下一轮脚本需要补齐锁屏/后台验证项：后台 Frida 直接 RPC 能执行；需要 UI 操作时自动亮屏、滑动解锁、回到微信，再继续执行。 3. 资料获取类接口需要在报告中单独列出“实际获取到的资料字段和值/空值原因”，联系人读取需要逐项列出联系人成功明细；当前报告只给出 `contacts: [] count: 0`，需要补强为“已读取但当前 Hook 数据源为空/无权限/表未命中”的具体诊断。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_180227/真实脱线手机110功能最终效果验证报告.md b/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_180227/真实脱线手机110功能最终效果验证报告.md index 463f92b7d8..482234eb9f 100644 --- a/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_180227/真实脱线手机110功能最终效果验证报告.md +++ b/开发文档/8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_180227/真实脱线手机110功能最终效果验证报告.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 测试验收 + - 验收 +doc-type: 验收 +layer: 8、部署/05-测试验收/real_device_110_effect_verify_20260518/20260518_180227 +parent: [[README|05-测试验收]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 真实脱线手机 110 功能最终效果验证报告 生成时间：2026-05-18 18:06:51 @@ -150,3 +166,8 @@ Frida Hook 消息日志：`开发文档/8、部署/05-测试验收/real_device_1 | 108 | `GET /hook/status` | backend-contract-log | 通过 | 记录后端接口契约与执行日志，未触发真实外发 | mCurrentFocus=Window{f2f69fb u0 com.tencent.mm/com.tencent.mm.ui.LauncherUI} / m | 源码中已定位 | | | 109 | `GET /hook/wechat-version` | backend-contract-log | 通过 | 记录后端接口契约与执行日志，未触发真实外发 | mCurrentFocus=Window{f2f69fb u0 com.tencent.mm/com.tencent.mm.ui.LauncherUI} / m | 源码中已定位 | | | 110 | `GET /mini-program/recent` | backend-contract-log | 通过 | 记录后端接口契约与执行日志，未触发真实外发 | mCurrentFocus=Window{f2f69fb u0 com.tencent.mm/com.tencent.mm.ui.LauncherUI} / m | 源码中已定位 | | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/screenshots/README.md b/开发文档/8、部署/05-测试验收/screenshots/README.md index c7c5ab95b5..deac3d6870 100644 --- a/开发文档/8、部署/05-测试验收/screenshots/README.md +++ b/开发文档/8、部署/05-测试验收/screenshots/README.md @@ -1,6 +1,27 @@ +--- +tags: + - 工作手机 + - 部署 + - 测试验收 + - 索引 +doc-type: 索引 +layer: 8、部署/05-测试验收/screenshots +parent: [[README|05-测试验收]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # screenshots | 子目录 | 来源 | |--------|------| | `verification_110/` | sdk/tests/run_live_verification 与 110 项视觉验收 | | `test_img/` | 临时测试图 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/scripts/README.md b/开发文档/8、部署/05-测试验收/scripts/README.md index 790a97a44e..afb96ecc9a 100644 --- a/开发文档/8、部署/05-测试验收/scripts/README.md +++ b/开发文档/8、部署/05-测试验收/scripts/README.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 测试验收 + - 索引 +doc-type: 索引 +layer: 8、部署/05-测试验收/scripts +parent: [[README|05-测试验收]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # scripts 验收与矩阵生成脚本。`from _repo_root import repo_root` 解析仓库根目录。 @@ -10,3 +26,8 @@ | `build_wechat_sdk_true_control_matrix_v*.py` | 接口矩阵生成 | 历史调试脚本见 `legacy/`。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/scripts/apply_doc_tags_links.py b/开发文档/8、部署/05-测试验收/scripts/apply_doc_tags_links.py new file mode 100644 index 0000000000..a42d8f289a --- /dev/null +++ b/开发文档/8、部署/05-测试验收/scripts/apply_doc_tags_links.py @@ -0,0 +1,385 @@ +#!/usr/bin/env python3 +"""为 开发文档/ 与 机擎/ 下 Markdown 批量补全 tags + 关联 frontmatter 与文末导航块。""" +from __future__ import annotations + +import re +import sys +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[4] +DOC = ROOT / "开发文档" +JQ = ROOT / "机擎" + +SKIP_FOOTER = { + "工作日志.md", +} +SKIP_PATH_PARTS = { + "110项功能逐项确认", + "wiki-gitea", + "github-repos", +} + +TOP_TAG: dict[str, list[str]] = { + "1、需求": ["工作手机", "需求"], + "2、架构": ["工作手机", "架构"], + "3、原型": ["工作手机", "原型"], + "4、前端": ["工作手机", "前端"], + "5、接口": ["工作手机", "接口"], + "6、后端": ["工作手机", "后端"], + "7、数据库": ["工作手机", "数据库"], + "8、部署": ["工作手机", "部署"], + "9、手册": ["工作手机", "手册"], + "10、项目管理": ["工作手机", "项目管理"], +} + +HUB_RELATED = [ + "[[开发文档/README|开发文档总入口]]", + "[[开发进度总表]]", + "[[系统架构]]", + "[[工作手机·五图总览与使用手册]]", +] + +CATEGORY_RELATED: dict[str, list[str]] = { + "1、需求": ["[[业务需求]]", "[[项目概述]]", "[[技术调研与方案选型]]"], + "2、架构": ["[[项目目录总览]]", "[[系统架构]]", "[[Hook通道与多设备多服务器架构]]"], + "3、原型": ["[[原型设计规范]]", "[[系统架构]]"], + "4、前端": ["[[系统架构]]", "[[接口规范]]"], + "5、接口": ["[[接口规范]]", "[[微信全功能矩阵_v8.0.56]]", "[[工作手机API全量接口目录]]"], + "6、后端": ["[[SDK服务端实现文档]]", "[[Agent端技能实现文档]]", "[[系统架构]]"], + "7、数据库": ["[[数据库设计文档]]", "[[技术选型与数据库]]"], + "8、部署": ["[[本地Docker部署指南]]", "[[设备端Hook安装部署]]", "[[05-测试验收/README|测试验收]]"], + "9、手册": ["[[SDK操作手册]]", "[[微信消息E2E验证指南]]"], + "10、项目管理": ["[[开发进度总表]]", "[[工作日志]]", "[[项目目录总览]]"], +} + +JQ_RELATED = [ + "[[机擎/SKILL|机擎 SKILL]]", + "[[开发文档/README|开发文档]]", + "[[开发进度总表]]", + "[[开发文档结构规范/SKILL|文档结构规范]]", +] + +ROLE_TAGS = { + "阿表": "进度验收", + "阿机": "后端Agent", + "阿桥": "接口对接", + "阿端": "联调", + "阿服": "部署运维", +} + + +def repo_rel(path: Path) -> str: + return path.relative_to(ROOT).as_posix() + + +def should_skip(path: Path) -> bool: + parts = path.parts + if any(p in SKIP_PATH_PARTS for p in parts): + return True + if path.name in SKIP_FOOTER: + return False # still frontmatter, skip footer only + return False + + +def skip_footer(path: Path) -> bool: + if path.name in SKIP_FOOTER: + return True + return any(p in SKIP_PATH_PARTS for p in path.parts) + + +def parse_frontmatter(text: str) -> tuple[dict[str, str | list[str]], str, str]: + if not text.startswith("---"): + return {}, text, "" + m = re.match(r"^---\r?\n(.*?)\r?\n---\r?\n?", text, re.S) + if not m: + return {}, text, "" + raw = m.group(1) + body = text[m.end() :] + fm: dict[str, str | list[str]] = {} + key: str | None = None + for line in raw.splitlines(): + if not line.strip(): + continue + if line.startswith(" - "): + if key is None: + continue + fm.setdefault(key, []) + if isinstance(fm[key], list): + fm[key].append(line[4:].strip().strip('"')) + continue + if ":" in line: + k, v = line.split(":", 1) + key = k.strip() + v = v.strip() + if v: + fm[key] = v.strip('"') + else: + fm[key] = [] + return fm, body, raw + + +def top_dir(rel: str) -> str | None: + if rel.startswith("开发文档/"): + rest = rel[len("开发文档/") :] + return rest.split("/")[0] if rest else None + if rel.startswith("机擎/"): + return "机擎" + return None + + +def layer_path(rel: str) -> str: + if rel.startswith("开发文档/"): + return rel[len("开发文档/") :].rsplit("/", 1)[0] + return rel.rsplit("/", 1)[0] + + +def sub_tag(rel: str) -> str | None: + m = re.search(r"/(0\d-[^/]+)/", rel) + return m.group(1) if m else None + + +def parent_readme(path: Path) -> str | None: + readme = path.parent / "README.md" + if readme.exists() and readme != path: + base = DOC if str(path).startswith(str(DOC)) else JQ + try: + rel = readme.relative_to(base).with_suffix("") + label = path.parent.name + return f"[[{rel.as_posix()}|{label}]]" + except ValueError: + return f"[[{readme.stem}|{path.parent.name}]]" + return None + + +def sibling_readmes(path: Path) -> list[Path]: + parent = path.parent + if not parent.is_dir(): + return [] + items = sorted( + [p for p in parent.glob("README.md") if p != path] + + [p for p in parent.glob("*.md") if p.name != "README.md" and p != path], + key=lambda p: p.name, + ) + return items + + +def ordered_neighbors(path: Path) -> tuple[str | None, str | None]: + """同层 01- 前缀目录的 README 链。""" + parent = path.parent + if not parent.name.startswith("0") or parent.parent == DOC: + grand = path.parent.parent if path.name == "README.md" else path.parent + dirs = sorted( + [d for d in grand.iterdir() if d.is_dir() and re.match(r"0\d-", d.name)], + key=lambda d: d.name, + ) + if len(dirs) < 2: + return None, None + names = [d.name for d in dirs] + cur = parent.name if path.name == "README.md" else None + if cur and cur in names: + i = names.index(cur) + prev_l = f"[[{(dirs[i - 1] / 'README.md').stem}|{dirs[i - 1].name}]]" if i > 0 else None + next_l = f"[[{(dirs[i + 1] / 'README.md').stem}|{dirs[i + 1].name}]]" if i + 1 < len(dirs) else None + return prev_l, next_l + return None, None + + +def doc_type(path: Path, rel: str) -> str: + if path.name == "README.md": + return "索引" + if rel.startswith("机擎/") and path.name == "SKILL.md": + return "SKILL" + if "references/" in rel: + return "参考" + if "05-测试验收" in rel or "06-验收与矩阵" in rel: + return "验收" + if path.name.endswith("工作日志.md") or "开发进度" in path.name: + return "进度" + return "主文档" + + +def build_tags(rel: str, path: Path) -> list[str]: + tags: list[str] = ["工作手机"] + top = top_dir(rel) + if top == "机擎": + tags.append("机擎") + for role, label in ROLE_TAGS.items(): + if f"/{role}/" in rel or rel.endswith(f"/{role}/SKILL.md"): + tags.append(label) + break + else: + if "references" in rel: + tags.append("参考") + else: + tags.append("项目管理") + return tags + if top and top in TOP_TAG: + tags.extend(TOP_TAG[top][1:]) + sub = sub_tag(rel) + if sub: + tags.append(sub.split("-", 1)[-1]) + dt = doc_type(path, rel) + tags.append(dt) + return tags + + +def build_related(rel: str, path: Path) -> list[str]: + out: list[str] = [] + top = top_dir(rel) + if top == "机擎": + out.extend(JQ_RELATED) + if "/阿表/" in rel: + out.append("[[阿表/SKILL|阿表 SKILL]]") + return dedupe(out) + if top and top in CATEGORY_RELATED: + out.extend(CATEGORY_RELATED[top][:3]) + for h in HUB_RELATED[:2]: + if h not in out: + out.append(h) + if "Hook" in path.name or "微信" in path.name: + out.append("[[微信全功能矩阵_v8.0.56]]") + if "Frida" in path.name or "Hook" in path.name: + out.append("[[设备端Hook安装部署]]") + return dedupe(out) + + +def dedupe(items: list[str]) -> list[str]: + seen: set[str] = set() + out: list[str] = [] + for x in items: + if x not in seen: + seen.add(x) + out.append(x) + return out + + +def render_frontmatter(fm: dict[str, str | list[str]]) -> str: + lines = ["---"] + order = [ + "tags", + "doc-type", + "layer", + "parent", + "related", + "prev", + "next", + "obsidian-color", + "cssclasses", + "name", + "description", + "owner", + "version", + ] + done: set[str] = set() + for key in order: + if key not in fm: + continue + val = fm[key] + done.add(key) + if isinstance(val, list): + lines.append(f"{key}:") + for item in val: + lines.append(f' - "{item}"' if "[[" in str(item) else f" - {item}") + else: + lines.append(f'{key}: {val}' if not str(val).startswith("#") else f"{key}: {val}") + for key, val in fm.items(): + if key in done: + continue + if isinstance(val, list): + lines.append(f"{key}:") + for item in val: + lines.append(f" - {item}") + else: + lines.append(f"{key}: {val}") + lines.append("---") + return "\n".join(lines) + "\n" + + +def strip_nav_block(body: str) -> str: + if "## 🔗 关联导航" not in body: + return body.rstrip() + return body.split("## 🔗 关联导航", 1)[0].rstrip().removesuffix("---").rstrip() + + +def build_nav(parent: str | None, related: list[str], prev: str | None, next_: str | None) -> str: + lines = [ + "", + "## 🔗 关联导航", + "", + "| 方向 | 文档 |", + "|------|------|", + ] + if parent: + lines.append(f"| ↑ 上级索引 | {parent} |") + if prev: + lines.append(f"| ← 上一模块 | {prev} |") + if next_: + lines.append(f"| → 下一模块 | {next_} |") + if related: + lines.append(f"| ↔ 相关 | {' · '.join(related[:5])} |") + lines.append("") + return "\n".join(lines) + + +def process_file(path: Path, dry_run: bool = False) -> bool: + rel = repo_rel(path) + if should_skip(path) and any(p in SKIP_PATH_PARTS for p in path.parts): + return False + + text = path.read_text(encoding="utf-8") + fm, body, _ = parse_frontmatter(text) + + tags = build_tags(rel, path) + fm["tags"] = tags + fm["doc-type"] = doc_type(path, rel) + fm["layer"] = layer_path(rel) + + parent = parent_readme(path) + if parent: + fm["parent"] = parent + + related = build_related(rel, path) + fm["related"] = related + + prev_l, next_l = ordered_neighbors(path) + if prev_l: + fm["prev"] = prev_l + elif "prev" in fm: + del fm["prev"] + if next_l: + fm["next"] = next_l + elif "next" in fm: + del fm["next"] + + new_head = render_frontmatter(fm) + new_body = strip_nav_block(body) + if not skip_footer(path): + new_body = new_body + build_nav(parent, related, prev_l, next_l) + + new_text = new_head + new_body + if new_text == text: + return False + if not dry_run: + path.write_text(new_text, encoding="utf-8") + return True + + +def main() -> int: + dry = "--dry-run" in sys.argv + targets = [DOC, JQ] + changed = 0 + scanned = 0 + for base in targets: + if not base.is_dir(): + continue + for path in sorted(base.rglob("*.md")): + scanned += 1 + if process_file(path, dry_run=dry): + changed += 1 + print(("DRY " if dry else "OK ") + repo_rel(path)) + print(f"\n{'Would update' if dry else 'Updated'} {changed} / {scanned} files") + return 0 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/开发文档/8、部署/05-测试验收/scripts/validate_doc_paths.sh b/开发文档/8、部署/05-测试验收/scripts/validate_doc_paths.sh index 2b06bd6e22..c3fe01c22b 100755 --- a/开发文档/8、部署/05-测试验收/scripts/validate_doc_paths.sh +++ b/开发文档/8、部署/05-测试验收/scripts/validate_doc_paths.sh @@ -4,7 +4,7 @@ set -euo pipefail ROOT="$(cd "$(dirname "$0")/../../../.." && pwd)" cd "$ROOT" PAT='docs/gitea/|docs/wiki-gitea/|verification_screenshots/|python3 tools/|`tools/|bash docs/gitea|开发文档/6、测试|00-项目总览|5、开发日志|5、接口文档' -EXCLUDE='工作日志\.md|legacy/|机擎/阿服/local-mount-sync|validate_doc_paths\.sh|开发文档结构规范/SKILL\.md|110项功能逐项确认/' +EXCLUDE='工作日志\.md|legacy/|机擎/阿服/local-mount-sync|validate_doc_paths\.sh|开发文档结构规范/SKILL\.md|110项功能逐项确认/|机擎/SKILL\.md' hits=$(rg -l "$PAT" 开发文档 机擎 sdk README.md 2>/dev/null | rg -v "$EXCLUDE" || true) if [ -n "$hits" ]; then echo "❌ 发现残留旧路径：" diff --git a/开发文档/8、部署/05-测试验收/wireless_frida_20260518/无线Frida微信控制批量验证报告.md b/开发文档/8、部署/05-测试验收/wireless_frida_20260518/无线Frida微信控制批量验证报告.md index 5fbe23ea52..fffdaf0dc7 100644 --- a/开发文档/8、部署/05-测试验收/wireless_frida_20260518/无线Frida微信控制批量验证报告.md +++ b/开发文档/8、部署/05-测试验收/wireless_frida_20260518/无线Frida微信控制批量验证报告.md @@ -1,3 +1,20 @@ +--- +tags: + - 工作手机 + - 部署 + - 测试验收 + - 验收 +doc-type: 验收 +layer: 8、部署/05-测试验收/wireless_frida_20260518 +parent: [[README|05-测试验收]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" + - "[[微信全功能矩阵_v8.0.56]]" +--- # 无线 Frida 微信与手机控制批量验证报告 生成时间：2026-05-24 09:37:34 @@ -174,3 +191,8 @@ | 146 | wireless-adb-screenshot | `capture_wechat_discover_tab` | 通过 | 统一截图阶段归档 | 0 | | 147 | wireless-adb | `shot_nav_me` | 通过 | 截图阶段切换我 | 107 | | 148 | wireless-adb-screenshot | `capture_wechat_me_tab` | 通过 | 统一截图阶段归档 | 0 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/05-测试验收/wireless_frida_real_device_acceptance_20260518/真机110功能验收矩阵.md b/开发文档/8、部署/05-测试验收/wireless_frida_real_device_acceptance_20260518/真机110功能验收矩阵.md index 4f811e3da2..00b0acec5a 100644 --- a/开发文档/8、部署/05-测试验收/wireless_frida_real_device_acceptance_20260518/真机110功能验收矩阵.md +++ b/开发文档/8、部署/05-测试验收/wireless_frida_real_device_acceptance_20260518/真机110功能验收矩阵.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 部署 + - 测试验收 + - 验收 +doc-type: 验收 +layer: 8、部署/05-测试验收/wireless_frida_real_device_acceptance_20260518 +parent: [[README|05-测试验收]] +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 真机 110 功能验收矩阵 生成时间：2026-05-18 17:44:01 @@ -124,3 +140,8 @@ ## 后续脚本改造要求 脚本需要为每个功能写入 `before_screenshot`、`backend_log`、`after_screenshot`、`assertion`、`risk_gate` 五类字段。失败项不能只标记失败，还要写明是哪一层失败：无线连接、Frida RPC、后端调用、手机页面、最终结果或安全闸。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/8、部署/README.md b/开发文档/8、部署/README.md index 5821bd218c..17a1f7742d 100644 --- a/开发文档/8、部署/README.md +++ b/开发文档/8、部署/README.md @@ -1,5 +1,17 @@ --- -obsidian-color: "#558B2F" +tags: + - 工作手机 + - 部署 + - 索引 +doc-type: 索引 +layer: 8、部署 +related: + - "[[本地Docker部署指南]]" + - "[[设备端Hook安装部署]]" + - "[[05-测试验收/README|测试验收]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #558B2F cssclasses: - devdoc-index --- @@ -54,3 +66,8 @@ cssclasses: - 2026-05-24：分层迁入 `01～03` - 2026-02-10：`部署流程与提示词` 合并入 Docker 指南 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[本地Docker部署指南]] · [[设备端Hook安装部署]] · [[05-测试验收/README|测试验收]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/9、手册/02-操作指南/Obsidian打开说明.md b/开发文档/9、手册/02-操作指南/Obsidian打开说明.md index 7db209e6bf..da88f9b369 100644 --- a/开发文档/9、手册/02-操作指南/Obsidian打开说明.md +++ b/开发文档/9、手册/02-操作指南/Obsidian打开说明.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 手册 + - 操作指南 + - 主文档 +doc-type: 主文档 +layer: 9、手册/02-操作指南 +parent: [[9、手册/02-操作指南/README|02-操作指南]] +related: + - "[[SDK操作手册]]" + - "[[微信消息E2E验证指南]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # Obsidian 打开入口 ## 一键打开（推荐） @@ -31,3 +46,9 @@ - 大目录解包后追加到 `.obsidianignore`（根目录与 `开发文档/.obsidianignore`） - 详情见 `开发文档/2、架构/01-总览/项目目录总览.md` +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[9、手册/02-操作指南/README|02-操作指南]] | +| ↔ 相关 | [[SDK操作手册]] · [[微信消息E2E验证指南]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/9、手册/02-操作指南/README.md b/开发文档/9、手册/02-操作指南/README.md index 53edbc40cd..ba8c2df5b5 100644 --- a/开发文档/9、手册/02-操作指南/README.md +++ b/开发文档/9、手册/02-操作指南/README.md @@ -1,5 +1,18 @@ --- -obsidian-color: "#1565C0" +tags: + - 工作手机 + - 手册 + - 操作指南 + - 索引 +doc-type: 索引 +layer: 9、手册/02-操作指南 +parent: [[README|9、手册]] +related: + - "[[SDK操作手册]]" + - "[[微信消息E2E验证指南]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #1565C0 --- # 02 · 操作指南 @@ -9,3 +22,8 @@ obsidian-color: "#1565C0" | [SDK操作手册.md](SDK操作手册.md) | 一键启动、检查 | | [工作手机·一键接入与存客宝对接操作手册.md](工作手机·一键接入与存客宝对接操作手册.md) | 存客宝专项 | | [使用与落地方案.md](使用与落地方案.md) | 跳转五图总览 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK操作手册]] · [[微信消息E2E验证指南]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/9、手册/02-操作指南/SDK操作手册.md b/开发文档/9、手册/02-操作指南/SDK操作手册.md index cda0999ead..d0a58705d8 100644 --- a/开发文档/9、手册/02-操作指南/SDK操作手册.md +++ b/开发文档/9、手册/02-操作指南/SDK操作手册.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 手册 + - 操作指南 + - 主文档 +doc-type: 主文档 +layer: 9、手册/02-操作指南 +parent: [[9、手册/02-操作指南/README|02-操作指南]] +related: + - "[[SDK操作手册]]" + - "[[微信消息E2E验证指南]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机 SDK 操作手册 > **完整总览（五图 + 补全包并入）**：[工作手机·五图总览与使用手册.md](工作手机·五图总览与使用手册.md) · 一键打开：`./open_handbook.sh`（本目录） @@ -95,3 +110,9 @@ curl -X POST http://localhost:8899/api/v3/message/send \ - `cd sdk` → 进入 sdk - `cd sdk/app` → 进入 SDK 服务目录 - `cd sdk/agent` → 进入 Agent 目录 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[9、手册/02-操作指南/README|02-操作指南]] | +| ↔ 相关 | [[SDK操作手册]] · [[微信消息E2E验证指南]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/9、手册/02-操作指南/使用与落地方案.md b/开发文档/9、手册/02-操作指南/使用与落地方案.md index 6b06ea55ca..3d534142b3 100644 --- a/开发文档/9、手册/02-操作指南/使用与落地方案.md +++ b/开发文档/9、手册/02-操作指南/使用与落地方案.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 手册 + - 操作指南 + - 主文档 +doc-type: 主文档 +layer: 9、手册/02-操作指南 +parent: [[9、手册/02-操作指南/README|02-操作指南]] +related: + - "[[SDK操作手册]]" + - "[[微信消息E2E验证指南]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 使用与落地方案 > ## ⭐ 已合并 — 请读唯一主手册 v2.1 @@ -14,3 +29,9 @@ > | 存客宝对接 | [一键接入与存客宝对接操作手册.md](工作手机·一键接入与存客宝对接操作手册.md) | 本文件仅作**旧链接锚点**，正文不再维护。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[9、手册/02-操作指南/README|02-操作指南]] | +| ↔ 相关 | [[SDK操作手册]] · [[微信消息E2E验证指南]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/9、手册/02-操作指南/工作手机·一键接入与存客宝对接操作手册.md b/开发文档/9、手册/02-操作指南/工作手机·一键接入与存客宝对接操作手册.md index f075b967ab..30b1171ee2 100644 --- a/开发文档/9、手册/02-操作指南/工作手机·一键接入与存客宝对接操作手册.md +++ b/开发文档/9、手册/02-操作指南/工作手机·一键接入与存客宝对接操作手册.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 手册 + - 操作指南 + - 主文档 +doc-type: 主文档 +layer: 9、手册/02-操作指南 +parent: [[9、手册/02-操作指南/README|02-操作指南]] +related: + - "[[SDK操作手册]]" + - "[[微信消息E2E验证指南]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机 · 一键接入与存客宝对接操作手册 > **总览请先读**：[工作手机·五图总览与使用手册.md](../工作手机·五图总览与使用手册.md)（v2.3） @@ -102,6 +117,28 @@ $result = $wp->sendMessage( echo "实际使用通道: " . $result['channel_used']; // 正常为 "hook"，降级时为 "hook(degraded_to_sdk)" ``` +### 3.4 生产环境（家里 NAS + HTTPS，2026-05-24） + +存客宝 **Server** 在 `.env` / 宝塔站点环境变量中配置： + +```ini +[WORKPHONE] +SDK_URL = https://workphone.quwanzhi.com +SDK_KEY = workphone-secret-key +``` + +对应 ThinkPHP：`Server/config/workphone.php` → `WORKPHONE_SDK_URL` / `WORKPHONE_SDK_KEY`。 + +**验收**（本机 Clash 需 DIRECT 或 `--resolve`）： + +```bash +bash sdk/scripts/verify_production_urls.sh +curl -sk --resolve workphone.quwanzhi.com:443:43.139.27.93 \ + https://workphone.quwanzhi.com/api/v3/workbench/overview +``` + +存客宝前端「我的工作手机」页调用 `GET /v1/workphone/status`（BFF 聚合上述 SDK）。**线上 ckbapi** 部署后需 reload PHP-FPM 使 `SDK_URL` 生效。 + --- ## 四、故障排查指南 (FAQ) @@ -126,3 +163,9 @@ echo "实际使用通道: " . $result['channel_used']; // 正常为 "hook"，降 **原因**：微信数据库 WCDB 解密未命中，或 `wechat_hook_v2.js` 尚未适配当前微信版本。 **解决**： - 在 `sdk/agent/hook/wechat_version_compat.json` 中，确保当前微信版本号（如 8.0.69）的偏移量与类名映射已配置正确。默认情况下，脚本会自动尝试 `default` 暴力探测。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[9、手册/02-操作指南/README|02-操作指南]] | +| ↔ 相关 | [[SDK操作手册]] · [[微信消息E2E验证指南]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/9、手册/03-验证/README.md b/开发文档/9、手册/03-验证/README.md index 9135a39684..ce3e8fe1b3 100644 --- a/开发文档/9、手册/03-验证/README.md +++ b/开发文档/9、手册/03-验证/README.md @@ -1,5 +1,18 @@ --- -obsidian-color: "#1565C0" +tags: + - 工作手机 + - 手册 + - 验证 + - 索引 +doc-type: 索引 +layer: 9、手册/03-验证 +parent: [[README|9、手册]] +related: + - "[[SDK操作手册]]" + - "[[微信消息E2E验证指南]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #1565C0 --- # 03 · 验证 @@ -7,3 +20,8 @@ obsidian-color: "#1565C0" | 文档 | 说明 | |------|------| | [微信消息E2E验证指南.md](微信消息E2E验证指南.md) | 微信发消息端到端 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK操作手册]] · [[微信消息E2E验证指南]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/9、手册/03-验证/微信消息E2E验证指南.md b/开发文档/9、手册/03-验证/微信消息E2E验证指南.md index 5141dad41f..5c7e320328 100644 --- a/开发文档/9、手册/03-验证/微信消息E2E验证指南.md +++ b/开发文档/9、手册/03-验证/微信消息E2E验证指南.md @@ -1,3 +1,19 @@ +--- +tags: + - 工作手机 + - 手册 + - 验证 + - 主文档 +doc-type: 主文档 +layer: 9、手册/03-验证 +parent: [[9、手册/03-验证/README|03-验证]] +related: + - "[[SDK操作手册]]" + - "[[微信消息E2E验证指南]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" + - "[[微信全功能矩阵_v8.0.56]]" +--- # 微信消息 E2E 端到端验证指南 > 对应「遗留与建议」高优先级项：跑一条完整发消息任务并验证回传 @@ -73,3 +89,9 @@ curl -X POST http://localhost:8899/api/v3/message/send \ 1. **超时**：`_send_via_sdk` 使用 `MESSAGE_SEND_TIMEOUT`（默认 60s） 2. **E2E 脚本**：`sdk/tests/test_wechat_e2e.py`；超时返回 error=timeout 时 E2E 仍判 API 行为正确 3. **验证联系人**：使用「文件传输助手」（每台微信必有） +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[9、手册/03-验证/README|03-验证]] | +| ↔ 相关 | [[SDK操作手册]] · [[微信消息E2E验证指南]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] · [[微信全功能矩阵_v8.0.56]] | diff --git a/开发文档/9、手册/04-专项/README.md b/开发文档/9、手册/04-专项/README.md index ff84f84c44..1fbc4535d2 100644 --- a/开发文档/9、手册/04-专项/README.md +++ b/开发文档/9、手册/04-专项/README.md @@ -1,5 +1,18 @@ --- -obsidian-color: "#1565C0" +tags: + - 工作手机 + - 手册 + - 专项 + - 索引 +doc-type: 索引 +layer: 9、手册/04-专项 +parent: [[README|9、手册]] +related: + - "[[SDK操作手册]]" + - "[[微信消息E2E验证指南]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #1565C0 --- # 04 · 专项 @@ -9,3 +22,8 @@ obsidian-color: "#1565C0" | [设备端Agent安装与公司设备说明.md](设备端Agent安装与公司设备说明.md) | 公司设备 | | [会议电视192.168.0.5接入说明.md](会议电视192.168.0.5接入说明.md) | 会议电视 | | [安装前配置检查规范.md](安装前配置检查规范.md) | 安装前检查 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK操作手册]] · [[微信消息E2E验证指南]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/9、手册/04-专项/会议电视192.168.0.5接入说明.md b/开发文档/9、手册/04-专项/会议电视192.168.0.5接入说明.md index 3cbd8612a1..be21f28f8e 100644 --- a/开发文档/9、手册/04-专项/会议电视192.168.0.5接入说明.md +++ b/开发文档/9、手册/04-专项/会议电视192.168.0.5接入说明.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 手册 + - 专项 + - 主文档 +doc-type: 主文档 +layer: 9、手册/04-专项 +parent: [[9、手册/04-专项/README|04-专项]] +related: + - "[[SDK操作手册]]" + - "[[微信消息E2E验证指南]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 会议电视 192.168.0.5 接入工作手机 SDK 说明 > **设备**：Meetingpad(UHD) | **场所**：家里 | **接入方式**：ADB（仅被控端，不装 Agent） @@ -48,3 +63,9 @@ - **每次安装/接入新设备前，必须先执行《安装前配置检查规范》中的检查项，再确定是否安装或接入。** - 本次接入已先完成配置检查，再确认接入方式并验证控制。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[9、手册/04-专项/README|04-专项]] | +| ↔ 相关 | [[SDK操作手册]] · [[微信消息E2E验证指南]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/9、手册/04-专项/安装前配置检查规范.md b/开发文档/9、手册/04-专项/安装前配置检查规范.md index c033183b74..1225923cd1 100644 --- a/开发文档/9、手册/04-专项/安装前配置检查规范.md +++ b/开发文档/9、手册/04-专项/安装前配置检查规范.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 手册 + - 专项 + - 主文档 +doc-type: 主文档 +layer: 9、手册/04-专项 +parent: [[9、手册/04-专项/README|04-专项]] +related: + - "[[SDK操作手册]]" + - "[[微信消息E2E验证指南]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机 SDK · 安装前配置检查规范 > **原则**：**每一次安装/接入设备前，必须先做配置检查，再确认是否执行安装。** @@ -50,3 +65,9 @@ - 会议电视（如 Meetingpad）一般无 Termux，**不安装设备端 Agent**，仅作为 **ADB 被控端**。 - 本机运行 SDK，通过 ADB 对会议电视执行截屏、点击、滑动等即可视为「已接入」。 - 配置检查同上，满足 ADB + Android 版本 + 存储即可。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[9、手册/04-专项/README|04-专项]] | +| ↔ 相关 | [[SDK操作手册]] · [[微信消息E2E验证指南]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/9、手册/04-专项/设备端Agent安装与公司设备说明.md b/开发文档/9、手册/04-专项/设备端Agent安装与公司设备说明.md index a6c0ea6ff2..afff547882 100644 --- a/开发文档/9、手册/04-专项/设备端Agent安装与公司设备说明.md +++ b/开发文档/9、手册/04-专项/设备端Agent安装与公司设备说明.md @@ -1,3 +1,18 @@ +--- +tags: + - 工作手机 + - 手册 + - 专项 + - 主文档 +doc-type: 主文档 +layer: 9、手册/04-专项 +parent: [[9、手册/04-专项/README|04-专项]] +related: + - "[[SDK操作手册]]" + - "[[微信消息E2E验证指南]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 设备端 Agent 安装与公司设备说明 > **目标**：在工作手机或会议电视上安装**可自动运转、连接服务器**的组件，发信息/下命令时由设备与服务器通信；不是仅通过 PC 上的 APP 控制，若用 APP 控制也需有对应方案。 @@ -77,3 +92,9 @@ | APP 控制 | 方案已写入本节「三、APP 控制对应方案」；具体接口与操作清单见 SDK 接口文档与 unified 路由 | 已在**可行设备**上执行的：配置检查与 ADB 接入（会议电视 192.168.0.5 已做）。公司内若有 Android 7+ 且已装 Termux 的工作手机，按「二、2.2」在 Termux 内执行 install 即可完成设备端安装。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[9、手册/04-专项/README|04-专项]] | +| ↔ 相关 | [[SDK操作手册]] · [[微信消息E2E验证指南]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/9、手册/README.md b/开发文档/9、手册/README.md index f2bbc7629d..2667706fce 100644 --- a/开发文档/9、手册/README.md +++ b/开发文档/9、手册/README.md @@ -1,5 +1,16 @@ --- -obsidian-color: "#1565C0" +tags: + - 工作手机 + - 手册 + - 索引 +doc-type: 索引 +layer: 9、手册 +related: + - "[[SDK操作手册]]" + - "[[微信消息E2E验证指南]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +obsidian-color: #1565C0 cssclasses: - devdoc-index --- @@ -30,3 +41,8 @@ cssclasses: | [04-专项](04-专项/) | 设备说明、会议电视、安装前检查 | **维护规范**：[机擎/阿表/开发文档结构规范/SKILL.md](../../机擎/阿表/开发文档结构规范/SKILL.md) +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[SDK操作手册]] · [[微信消息E2E验证指南]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/9、手册/工作手机·五图总览与使用手册.md b/开发文档/9、手册/工作手机·五图总览与使用手册.md index c77b554947..9136e88274 100644 --- a/开发文档/9、手册/工作手机·五图总览与使用手册.md +++ b/开发文档/9、手册/工作手机·五图总览与使用手册.md @@ -1,3 +1,17 @@ +--- +tags: + - 工作手机 + - 手册 + - 主文档 +doc-type: 主文档 +layer: 9、手册 +parent: [[9、手册/README|9、手册]] +related: + - "[[SDK操作手册]]" + - "[[微信消息E2E验证指南]]" + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机 · 完整整合手册（补全包并入版） > **版本**：v2.4 · **更新**：2026-05-24 @@ -361,3 +375,9 @@ python3 开发文档/8、部署/05-测试验收/scripts/wireless_frida_wechat_ba --- *五图 + 九模块 + 一条 API，看懂就能控微信。架构变更时先改 `images/` 原图，再改各章「图中未标」补充条。* +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[9、手册/README|9、手册]] | +| ↔ 相关 | [[SDK操作手册]] · [[微信消息E2E验证指南]] · [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/开发文档/README.md b/开发文档/README.md index 216da2db1b..c0168889d8 100644 --- a/开发文档/README.md +++ b/开发文档/README.md @@ -1,3 +1,13 @@ +--- +tags: + - 工作手机 + - 索引 +doc-type: 索引 +layer: README.md +related: + - "[[开发文档/README|开发文档总入口]]" + - "[[开发进度总表]]" +--- # 工作手机SDK v3.0 - 开发文档 > **🗂️ 项目目录总览（Obsidian 入口）**：[2、架构/01-总览/项目目录总览.md](2、架构/01-总览/项目目录总览.md) @@ -9,7 +19,8 @@ > **管理Skill**：**本项目目录下** `机擎/SKILL.md`（火炬总控，五人分配：阿表/阿机/阿桥/阿端/阿服） > **更新**：2026-05-24 | **当前项目状态**：总进度 **99.5%** -> **约定**：顶层**仅 `1、需求` … `10、项目管理` 十个编号目录**；Soul 等平台调研在 [1、需求/03-调研/平台分析/](1、需求/03-调研/平台分析/)。 +> **约定**：顶层**仅 `1、需求` … `10、项目管理` 十个编号目录**；Soul 等平台调研在 [1、需求/03-调研/平台分析/](1、需求/03-调研/平台分析/)。 +> **标签与关联**：每篇 MD 含 YAML `tags` / `related` / `parent` + 文末 **🔗 关联导航**；规范见 [机擎/阿表/开发文档结构规范/SKILL.md](../机擎/阿表/开发文档结构规范/SKILL.md) §四B。 --- @@ -95,3 +106,8 @@ cd sdk && ./scripts/start_sdk.sh > 路径以「工作手机」项目根目录为基准。详见 [9、手册/02-操作指南/SDK操作手册.md](9、手册/02-操作指南/SDK操作手册.md) **统一测试账号**：15880802661 / kr123456（详见 [8、部署/01-本地环境/本地环境凭证.md](8、部署/01-本地环境/本地环境凭证.md)） +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[开发文档/README|开发文档总入口]] · [[开发进度总表]] | diff --git a/机擎/SKILL.md b/机擎/SKILL.md index f364a8bd32..34add7eb89 100644 --- a/机擎/SKILL.md +++ b/机擎/SKILL.md @@ -1,3 +1,16 @@ +--- +tags: + - 工作手机 + - 机擎 + - 项目管理 +doc-type: SKILL +layer: 机擎 +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[开发文档结构规范/SKILL|文档结构规范]]" +--- # 机擎项目管理 Skill > **Skill 名称**: 机擎项目管理 @@ -162,6 +175,7 @@ - **开发文档唯一位置**：所有开发文档在 **工作手机/开发文档/** 目录下，不在此外新增。 - **开发文档顶层**：**仅** `1、需求` … `10、项目管理` 十个编号目录；**无**顶层 `6、测试`/`00-项目总览`/`5、开发日志`/`5、接口文档`/`平台分析`。 - **测试与矩阵归位**：真机脚本/截图/报告 → `8、部署/05-测试验收/`；接口矩阵与接口开发日志 → `5、接口/06-验收与矩阵/`；`6、后端` 仅后端实现。 +- **标签与关联**：每篇 MD 必有 `tags` + `related` + `parent`；详见 [开发文档结构规范/SKILL.md](阿表/开发文档结构规范/SKILL.md) §四B；批量脚本 `开发文档/8、部署/05-测试验收/scripts/apply_doc_tags_links.py`。 - **开发文档基础规则**：10 个子目录中**每目录除 README 外最多 3 个主文档**。 - **火炬**：总控、节点、验收、分配任务。 - **卡若AI**：涉及工作手机/机擎时，**只读取本 Skill**。 @@ -182,7 +196,11 @@ 5. 汇报「当前进度 %」「下一步做什么」；按岗位分配任务 ``` -### 3.2 对话结束时：写日志与更新进度 +### 3.2 每轮回复与对话结束：卡若复盘 + 写日志 + +**每轮回复（强制）**：正文末尾 **必须先写完整卡若复盘五块**（真源：`卡若AI/运营中枢/参考资料/卡若复盘格式_固定规则.md` v5.1），再调用 persistent-chat 的 `wait_for_user_input`。格式见 `.cursor/rules/workphone.mdc` §5.1。 + +**对话结束时额外动作**： ``` 1. 工作日志追加：时间、完成项、进度变化、下一步、问题 @@ -497,4 +515,8 @@ - 大型需求进来，想快速从 0 拆成「金水木火土」可执行任务时。 > 机擎默认规则：只要是「新东西要落地到 SDK/工作手机」，先按本节的复制逻辑走一遍，再具体写代码。 +## 🔗 关联导航 +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] | diff --git a/机擎/references/ADB_Docker_USB排查.md b/机擎/references/ADB_Docker_USB排查.md index ea0ced796b..218409a0ec 100644 --- a/机擎/references/ADB_Docker_USB排查.md +++ b/机擎/references/ADB_Docker_USB排查.md @@ -1,3 +1,16 @@ +--- +tags: + - 工作手机 + - 机擎 + - 参考 +doc-type: 参考 +layer: 机擎/references +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[开发文档结构规范/SKILL|文档结构规范]]" +--- # ADB / Type-C 在 Docker 下显示 0 台 — 原因与处理 ## 现象 @@ -69,3 +82,8 @@ cd sdk && docker compose up -d --build ## 安全说明 `adb -a` 会在局域网暴露 5037 端口，请勿在不可信网络长期开启。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] | diff --git a/机擎/references/RedmiNote13_5G_2312DRAABC_Magisk操作清单.md b/机擎/references/RedmiNote13_5G_2312DRAABC_Magisk操作清单.md index 6eb8ac1fb6..8eefc0d9a0 100644 --- a/机擎/references/RedmiNote13_5G_2312DRAABC_Magisk操作清单.md +++ b/机擎/references/RedmiNote13_5G_2312DRAABC_Magisk操作清单.md @@ -1,3 +1,16 @@ +--- +tags: + - 工作手机 + - 机擎 + - 参考 +doc-type: 参考 +layer: 机擎/references +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[开发文档结构规范/SKILL|文档结构规范]]" +--- # Redmi Note 13 5G（2312DRAABC / gold）— 面具 Magisk + Root 操作清单 > 由本机 `adb getprop` 自动生成快照，**请严格使用与下列版本一致的官方 ROM** 提取 `boot` / `init_boot`，否则易黑砖。 @@ -104,3 +117,8 @@ adb shell su -c id - 解锁 / 刷写分区可能导致 **保修失效**、**无法使用部分金融类 App**。 - **分区刷错（boot 与 init_boot 混用）** 可能导致无法开机，需线刷官方包救砖。 - 仅操作**本人设备**；勿用于他人设备或违法用途。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] | diff --git a/机擎/references/工作手机中间层抽象.md b/机擎/references/工作手机中间层抽象.md index a845ed0a06..393b85897c 100644 --- a/机擎/references/工作手机中间层抽象.md +++ b/机擎/references/工作手机中间层抽象.md @@ -1,3 +1,16 @@ +--- +tags: + - 工作手机 + - 机擎 + - 参考 +doc-type: 参考 +layer: 机擎/references +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[开发文档结构规范/SKILL|文档结构规范]]" +--- # 工作手机 中间层 抽象 > **位置**: 工作手机/存客宝项目管理/references @@ -44,3 +57,8 @@ - [工作手机设备端SDK抽象](./工作手机设备端SDK抽象.md) - 开发文档/10、项目管理/多端并行开发模块拆解.md § 三、中间层 - 开发文档/5、接口/02-业务对接/存客宝对接规范.md +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] | diff --git a/机擎/references/工作手机服务端SDK抽象.md b/机擎/references/工作手机服务端SDK抽象.md index 0dd2edf67a..1ede801a81 100644 --- a/机擎/references/工作手机服务端SDK抽象.md +++ b/机擎/references/工作手机服务端SDK抽象.md @@ -1,3 +1,16 @@ +--- +tags: + - 工作手机 + - 机擎 + - 参考 +doc-type: 参考 +layer: 机擎/references +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[开发文档结构规范/SKILL|文档结构规范]]" +--- # 工作手机 服务端 SDK 抽象 > **位置**: 工作手机/存客宝项目管理/references @@ -67,3 +80,8 @@ - [工作手机设备端SDK抽象](./工作手机设备端SDK抽象.md) - 开发文档/5、接口/02-业务对接/存客宝对接规范.md - 开发文档/10、项目管理/开发进度总表.md +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] | diff --git a/机擎/references/工作手机设备端SDK抽象.md b/机擎/references/工作手机设备端SDK抽象.md index f5f36c40ef..c10a1d8d46 100644 --- a/机擎/references/工作手机设备端SDK抽象.md +++ b/机擎/references/工作手机设备端SDK抽象.md @@ -1,3 +1,16 @@ +--- +tags: + - 工作手机 + - 机擎 + - 参考 +doc-type: 参考 +layer: 机擎/references +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[开发文档结构规范/SKILL|文档结构规范]]" +--- # 工作手机 设备端 SDK 抽象 > **位置**: 工作手机/存客宝项目管理/references @@ -32,3 +45,8 @@ - [工作手机服务端SDK抽象](./工作手机服务端SDK抽象.md) - sdk/agent/README.md - 开发文档/10、项目管理/多端并行开发模块拆解.md +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] | diff --git a/机擎/references/开发接力文档.md b/机擎/references/开发接力文档.md index 95d2e80927..7e2b3eae85 100644 --- a/机擎/references/开发接力文档.md +++ b/机擎/references/开发接力文档.md @@ -1,3 +1,16 @@ +--- +tags: + - 工作手机 + - 机擎 + - 参考 +doc-type: 参考 +layer: 机擎/references +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[开发文档结构规范/SKILL|文档结构规范]]" +--- # 机擎 · 开发接力文档 > **用途**：五人协作的统一中转站。任何人完成一段工作后，在这里写一条接力单，下一个人读取后接着开发。 @@ -120,3 +133,8 @@ - 这 3 个 bug 依赖设备端 Agent 在线 + 微信版本 UI 适配，需要连真机后验证 **状态**：代码修复完毕，等待真机验证收尾 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] | diff --git a/机擎/references/快速入机部署_Root_Frida_Hook.md b/机擎/references/快速入机部署_Root_Frida_Hook.md index ae77ebfd4c..5875c844ee 100644 --- a/机擎/references/快速入机部署_Root_Frida_Hook.md +++ b/机擎/references/快速入机部署_Root_Frida_Hook.md @@ -1,3 +1,16 @@ +--- +tags: + - 工作手机 + - 机擎 + - 参考 +doc-type: 参考 +layer: 机擎/references +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[开发文档结构规范/SKILL|文档结构规范]]" +--- # 快速入机部署 — Root + Frida + Hook 一键流程 > 来源：2026-03-20 实战验证（小米 21121119SC / Android 11 / Magisk Kitsune / WeChat 8.0.69） @@ -161,3 +174,8 @@ Frida 16.x 中微信主进程名为 `WeChat`（非 `com.tencent.mm`），`_find_ ``` 服务端通过 `GET /api/v3/hook/probe/{device_id}` 自动探测并更新设备状态。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] | diff --git a/机擎/references/防封策略_全平台全层级.md b/机擎/references/防封策略_全平台全层级.md index 9ca5c7f789..87d920fef5 100644 --- a/机擎/references/防封策略_全平台全层级.md +++ b/机擎/references/防封策略_全平台全层级.md @@ -1,3 +1,16 @@ +--- +tags: + - 工作手机 + - 机擎 + - 参考 +doc-type: 参考 +layer: 机擎/references +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[开发文档结构规范/SKILL|文档结构规范]]" +--- # 防封策略 · 全平台全层级（必读） > **版本**: 1.0.0 | **更新**: 2026-03-14 @@ -580,3 +593,8 @@ Agent 应内置自动养号功能，在非任务时段自动执行： > **持续更新机制**：每次封号事件 → 归因分析 → 更新本文档对应章节 → 通知全员。 > **季度审查**：每季度搜索全网最新防封策略，更新平台检测规则与绕过方案。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] | diff --git a/机擎/阿服/SKILL.md b/机擎/阿服/SKILL.md index 93821c3333..b846c4c2fa 100644 --- a/机擎/阿服/SKILL.md +++ b/机擎/阿服/SKILL.md @@ -1,3 +1,16 @@ +--- +tags: + - 工作手机 + - 机擎 + - 部署运维 +doc-type: SKILL +layer: 机擎/阿服 +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[开发文档结构规范/SKILL|文档结构规范]]" +--- # 阿服 · 部署 Skill > **Skill 名称**: 阿服-部署 @@ -117,3 +130,8 @@ bash 机擎/scripts/check_system.sh ``` **完整五人分工与机擎规则**：见上级 [机擎/SKILL.md](../SKILL.md)。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] | diff --git a/机擎/阿服/local-mount-sync/SKILL.md b/机擎/阿服/local-mount-sync/SKILL.md index 388feb657a..a810727255 100644 --- a/机擎/阿服/local-mount-sync/SKILL.md +++ b/机擎/阿服/local-mount-sync/SKILL.md @@ -1,9 +1,20 @@ --- +tags: + - 工作手机 + - 机擎 + - 部署运维 +doc-type: SKILL +layer: 机擎/阿服/local-mount-sync +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[开发文档结构规范/SKILL|文档结构规范]]" name: local-mount-sync description: 工作手机项目本地挂载与GitHub同步规范。用于每次开发、真机验收、文档追加、超过20分钟阶段性同步、FUSE挂载异常处理、GitHub提交推送与开发文档闭环。 -version: "1.0.0" -updated: "2026-05-18" owner: 卡若 +version: 1.0.0 +updated: 2026-05-18 --- # local-mount-sync · 工作手机项目同步规范 @@ -114,3 +125,8 @@ git push | 时间 | 固化内容 | 状态 | |---|---|---| | 2026-05-18 19:13 CST | 新增20分钟阶段性同步、本地挂载/FUSE绕过、GitHub同步、开发文档追加与黑屏重测规则 | 已写入本文件 | +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] | diff --git a/机擎/阿机/SKILL.md b/机擎/阿机/SKILL.md index 8d916b47d0..2a145f466b 100644 --- a/机擎/阿机/SKILL.md +++ b/机擎/阿机/SKILL.md @@ -1,3 +1,16 @@ +--- +tags: + - 工作手机 + - 机擎 + - 后端Agent +doc-type: SKILL +layer: 机擎/阿机 +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[开发文档结构规范/SKILL|文档结构规范]]" +--- # 阿机 · 后端Agent Skill > **Skill 名称**: 阿机-后端Agent @@ -157,3 +170,8 @@ wechat/douyin/xhs/xianyu、Skill、WebSocket、@阿机 **业务/接口/action**：先对照交互矩阵再开发。 **完整五人分工与机擎规则**：见上级 [机擎/SKILL.md](../SKILL.md)。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] | diff --git a/机擎/阿桥/SKILL.md b/机擎/阿桥/SKILL.md index 3f9f70ef7b..77ebb3aa0d 100644 --- a/机擎/阿桥/SKILL.md +++ b/机擎/阿桥/SKILL.md @@ -1,3 +1,16 @@ +--- +tags: + - 工作手机 + - 机擎 + - 接口对接 +doc-type: SKILL +layer: 机擎/阿桥 +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[开发文档结构规范/SKILL|文档结构规范]]" +--- # 阿桥 · 对接中间层 Skill（业务+中间层 合并版） > **Skill 名称**: 阿桥-对接中间层（业务收口+中间层交付） @@ -147,3 +160,8 @@ ``` **完整五人分工与机擎规则**：见上级 [机擎/SKILL.md](../SKILL.md)。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] | diff --git a/机擎/阿端/SKILL.md b/机擎/阿端/SKILL.md index 4561291392..a2d301379a 100644 --- a/机擎/阿端/SKILL.md +++ b/机擎/阿端/SKILL.md @@ -1,3 +1,16 @@ +--- +tags: + - 工作手机 + - 机擎 + - 联调 +doc-type: SKILL +layer: 机擎/阿端 +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[开发文档结构规范/SKILL|文档结构规范]]" +--- # 阿端 · 联调 Skill > **Skill 名称**: 阿端-联调 @@ -97,3 +110,8 @@ cd sdk/tests && python3 test_wechat_e2e.py ``` **完整五人分工与机擎规则**：见上级 [机擎/SKILL.md](../SKILL.md)。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] | diff --git a/机擎/阿表/SKILL.md b/机擎/阿表/SKILL.md index 298b33133f..8b9f0bd21e 100644 --- a/机擎/阿表/SKILL.md +++ b/机擎/阿表/SKILL.md @@ -1,3 +1,17 @@ +--- +tags: + - 工作手机 + - 机擎 + - 进度验收 +doc-type: SKILL +layer: 机擎/阿表 +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[开发文档结构规范/SKILL|文档结构规范]]" + - "[[阿表/SKILL|阿表 SKILL]]" +--- # 阿表 · 进度验收 Skill > **Skill 名称**: 阿表-进度验收 @@ -76,3 +90,8 @@ ``` **完整五人分工与机擎规则**：见上级 [机擎/SKILL.md](../SKILL.md)。 +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] · [[阿表/SKILL|阿表 SKILL]] | diff --git a/机擎/阿表/开发文档结构规范/SKILL.md b/机擎/阿表/开发文档结构规范/SKILL.md index 1c69f555bf..cd045199b3 100644 --- a/机擎/阿表/开发文档结构规范/SKILL.md +++ b/机擎/阿表/开发文档结构规范/SKILL.md @@ -1,11 +1,24 @@ --- +tags: + - 工作手机 + - 机擎 + - 进度验收 + - SKILL +doc-type: SKILL +layer: 机擎/阿表/开发文档结构规范 +parent: "[[阿表/SKILL|阿表]]" +related: + - "[[机擎/SKILL|机擎 SKILL]]" + - "[[开发文档/README|开发文档]]" + - "[[开发进度总表]]" + - "[[阿表/SKILL|阿表 SKILL]]" name: workphone-devdoc-structure description: >- 工作手机 · 开发文档结构规范（阿表专责）。维护 开发文档/1～10 目录分层、images 归档、 - Obsidian 配色、开发过程中实时归类新文档。触发：整理开发文档、架构目录、文档分类、 - Obsidian 配色、@阿表 文档、images 归档、开发文档规范。 + Obsidian 配色与标签关联、开发过程中实时归类新文档。触发：整理开发文档、架构目录、文档分类、 + Obsidian 配色、@阿表 文档、images 归档、开发文档规范、标签关联。 owner: 阿表 -version: 1.0.0 +version: 1.1.0 --- # 工作手机 · 开发文档结构规范（阿表 · 开发时必守） @@ -29,7 +42,7 @@ version: 1.0.0 | 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/...` 全路径 | +| +3 | **标签与关联**：每篇 MD 必有 YAML `tags` + `related` + `parent`；文末 **🔗 关联导航**（工作日志/历史追加包除外） | --- @@ -155,6 +168,60 @@ version: 1.0.0 --- +## 四B、标签与关联规范（Obsidian 图谱 · 2026-05-24 起） + +**目标**：开发文档 + 机擎 **每篇 MD 可检索、可串联**——图谱按 tag 聚类，正文按 `related` / `prev` / `next` 前后跳转。 + +### YAML Frontmatter 必填字段 + +| 字段 | 说明 | 示例 | +|------|------|------| +| `tags` | 至少 3 项：`工作手机` + 顶层目录语义 + `doc-type` | `[工作手机, 接口, 验收]` | +| `doc-type` | `索引` / `主文档` / `验收` / `进度` / `SKILL` / `参考` | `主文档` | +| `layer` | 相对 `开发文档/` 或 `机擎/` 的目录层 | `5、接口/06-验收与矩阵` | +| `parent` | 上级 README 的 wikilink | `[[5、接口/06-验收与矩阵/README\|06-验收与矩阵]]` | +| `related` | 3～5 个跨目录相关文档 wikilink | 见下表 | +| `prev` / `next` | 同层 `01-` `02-` 模块顺序（可选） | `[[01-规范与统一层/README\|01-规范与统一层]]` | + +**保留**：原有 `obsidian-color` / SKILL 的 `name` `owner` 等字段不删。 + +### 跨目录 Hub（写入 `related` 时优先） + +| 文档 | 用途 | +|------|------| +| `开发文档/README` | 总入口 | +| `开发进度总表` | 进度真源 | +| `系统架构` | 模块拆解 §3.0 | +| `工作手机·五图总览与使用手册` | 用户向整合手册 | +| `机擎/SKILL` | 项目管理入口（机擎文档必链） | + +### 文末「🔗 关联导航」块 + +主文档与 README **文末追加**（`工作日志.md`、`110项功能逐项确认/` 历史追加包 **不加**）： + +```markdown +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↑ 上级索引 | [[5、接口/README\|5、接口]] | +| ← 上一模块 | [[03-Hook与微信/README\|03-Hook与微信]] | +| → 下一模块 | [[05-交互图/README\|05-交互图]] | +| ↔ 相关 | [[接口规范]] · [[微信全功能矩阵_v8.0.56]] · [[开发进度总表]] | +``` + +### 批量维护脚本 + +```bash +# 新增/迁移文档后重跑（幂等） +python3 开发文档/8、部署/05-测试验收/scripts/apply_doc_tags_links.py +python3 开发文档/8、部署/05-测试验收/scripts/apply_doc_tags_links.py --dry-run +``` + +**Obsidian 图谱**：Settings → Graph → **Show tags** 打开；`.obsidian/graph.json` 已设 `showTags: true`。 + +--- + ## 五、开发过程中「实时归类」流程 每次**改代码 + 产文档**时，阿表/执笔者 **当场** 执行： @@ -221,6 +288,8 @@ curl -s http://127.0.0.1:8899/api/workbench/architecture-assets | python3 -m jso **Obsidian 入口**：[开发文档/2、架构/01-总览/项目目录总览.md](../../../开发文档/2、架构/01-总览/项目目录总览.md) +| 旧路径 | 新路径 | +|--------|--------| | `6、测试/`（已取消顶层） | `8、部署/05-测试验收/` + `5、接口/06-验收与矩阵/` | | `00-项目总览/` | `2、架构/01-总览/项目目录总览.md` | | `5、开发日志/` `5、接口文档/` | 并入 `5、接口/06-验收与矩阵/` 与 `03-Hook与微信/` | @@ -231,7 +300,12 @@ curl -s http://127.0.0.1:8899/api/workbench/architecture-assets | python3 -m jso ``` 开发文档规范、架构目录整理、images 归档、Obsidian 配色、文档分类、 -2、架构 重组、@阿表 文档、开发文档结构、目录分层 +2、架构 重组、@阿表 文档、开发文档结构、目录分层、标签关联、文档关联、frontmatter ``` **关联 Skill**：[阿表/SKILL.md](../SKILL.md) · [机擎/SKILL.md](../../SKILL.md) · [9、手册/工作手机·五图总览与使用手册.md](../../../开发文档/9、手册/工作手机·五图总览与使用手册.md) +## 🔗 关联导航 + +| 方向 | 文档 | +|------|------| +| ↔ 相关 | [[机擎/SKILL|机擎 SKILL]] · [[开发文档/README|开发文档]] · [[开发进度总表]] · [[开发文档结构规范/SKILL|文档结构规范]] · [[阿表/SKILL|阿表 SKILL]] |