diff --git a/.obsidian/snippets/workphone-devdoc.css b/.obsidian/snippets/workphone-devdoc.css index 13cc982d28..8ba88f2d27 100644 --- a/.obsidian/snippets/workphone-devdoc.css +++ b/.obsidian/snippets/workphone-devdoc.css @@ -49,6 +49,9 @@ color: #5E35B1 !important; font-weight: 600; } +.nav-folder-title[data-path^="开发文档/1、需求/0"] > .nav-folder-title-content { + color: #7E57C2 !important; +} .nav-folder-title[data-path="开发文档/3、原型"] > .nav-folder-title-content { color: #5E35B1 !important; } diff --git a/开发文档/10、项目管理/工作日志.md b/开发文档/10、项目管理/工作日志.md index 723ca3dcbd..fa726cbe3b 100644 --- a/开发文档/10、项目管理/工作日志.md +++ b/开发文档/10、项目管理/工作日志.md @@ -3080,3 +3080,11 @@ v3.1: Agent 内置 AI Brain → 心跳驱动自主决策 → Frida优先/u2兜 3. 机擎阿服、手册、wiki、local-mount-sync 路径更新 **进度**: 99.5% + +--- + +### 2026-05-24 | 1、需求 分层 + +**完成项**: `01-概述/` `02-业务/` `03-调研/`;机擎对话沉淀路径 → `02-业务/业务需求.md` + +**进度**: 99.5% diff --git a/开发文档/1、需求/01-概述/README.md b/开发文档/1、需求/01-概述/README.md new file mode 100644 index 0000000000..ab0feec988 --- /dev/null +++ b/开发文档/1、需求/01-概述/README.md @@ -0,0 +1,9 @@ +--- +obsidian-color: "#5E35B1" +--- + +# 01 · 概述 + +| 文档 | 说明 | +|------|------| +| [项目概述.md](项目概述.md) | 背景、愿景、成本估算 | diff --git a/开发文档/1、需求/项目概述.md b/开发文档/1、需求/01-概述/项目概述.md similarity index 98% rename from 开发文档/1、需求/项目概述.md rename to 开发文档/1、需求/01-概述/项目概述.md index cf6df2d405..776b01f07b 100644 --- a/开发文档/1、需求/项目概述.md +++ b/开发文档/1、需求/01-概述/项目概述.md @@ -188,9 +188,9 @@ ## 六、下一步 -1. **架构设计**:查看 [2、架构/01-总览/系统架构.md](../2、架构/01-总览/系统架构.md) -2. **接口对接**:查看 [5、接口/01-规范与统一层/接口规范.md](../5、接口/01-规范与统一层/接口规范.md) -3. **开发计划**:查看 [10、项目管理/开发进度总表.md](../10、项目管理/开发进度总表.md) +1. **架构设计**:查看 [2、架构/01-总览/系统架构.md](../../2、架构/01-总览/系统架构.md) +2. **接口对接**:查看 [5、接口/01-规范与统一层/接口规范.md](../../5、接口/01-规范与统一层/接口规范.md) +3. **开发计划**:查看 [10、项目管理/开发进度总表.md](../../10、项目管理/开发进度总表.md) --- diff --git a/开发文档/1、需求/02-业务/README.md b/开发文档/1、需求/02-业务/README.md new file mode 100644 index 0000000000..bf2e62f611 --- /dev/null +++ b/开发文档/1、需求/02-业务/README.md @@ -0,0 +1,9 @@ +--- +obsidian-color: "#5E35B1" +--- + +# 02 · 业务 + +| 文档 | 说明 | +|------|------| +| [业务需求.md](业务需求.md) | 功能清单、KPI、竞品;**对话沉淀需求**章节(机擎每轮追加) | diff --git a/开发文档/1、需求/业务需求.md b/开发文档/1、需求/02-业务/业务需求.md similarity index 100% rename from 开发文档/1、需求/业务需求.md rename to 开发文档/1、需求/02-业务/业务需求.md diff --git a/开发文档/1、需求/03-调研/README.md b/开发文档/1、需求/03-调研/README.md new file mode 100644 index 0000000000..ff73dfbe3e --- /dev/null +++ b/开发文档/1、需求/03-调研/README.md @@ -0,0 +1,9 @@ +--- +obsidian-color: "#5E35B1" +--- + +# 03 · 调研 + +| 文档 | 说明 | +|------|------| +| [技术调研与方案选型.md](技术调研与方案选型.md) | 奥创拆解、Frida/Hook 方案对比、选型结论 | diff --git a/开发文档/1、需求/技术调研与方案选型.md b/开发文档/1、需求/03-调研/技术调研与方案选型.md similarity index 100% rename from 开发文档/1、需求/技术调研与方案选型.md rename to 开发文档/1、需求/03-调研/技术调研与方案选型.md diff --git a/开发文档/1、需求/README.md b/开发文档/1、需求/README.md index 55955bee3b..e16a0d72c2 100644 --- a/开发文档/1、需求/README.md +++ b/开发文档/1、需求/README.md @@ -1,24 +1,38 @@ +--- +obsidian-color: "#5E35B1" +cssclasses: + - devdoc-index +--- + # 1、需求 -**项目**:工作手机SDK v3.0(存客宝AI手机控制引擎,替代奥创+Hook增强) - -**规则**:本目录除本 README 外最多 **3 个主文档**。 - -**当前状态**:Phase 1 需求100%完成;Phase 2 Hook增强需求已整理。进度以 [开发进度总表](../10、项目管理/开发进度总表.md) 为准。 +**规则**:三主文档分层;`修改/` 为增量补丁子目录。 --- -## 本目录主文档(≤3) +## 目录树 -| 文档 | 说明 | +```text +1、需求/ +├── README.md +├── images/ +├── 01-概述/ 项目概述.md +├── 02-业务/ 业务需求.md(含「对话沉淀需求」章节) +├── 03-调研/ 技术调研与方案选型.md +└── 修改/ 设备级增量需求 +``` + +| 大类 | 入口 | |------|------| -| [项目概述.md](项目概述.md) | 项目背景、愿景、成本估算(含原成本与需求澄清内容) | -| [业务需求.md](业务需求.md) | 功能清单、用户画像、KPI、竞品对比 | -| [技术调研与方案选型.md](技术调研与方案选型.md) | **12份调研整合**:奥创拆解+全网方案对比+复刻路径+选型结论 | +| [01 概述](01-概述/项目概述.md) | 背景、愿景、成本 | +| [02 业务](02-业务/业务需求.md) | 功能清单、KPI、对话沉淀 | +| [03 调研](03-调研/技术调研与方案选型.md) | 12 份调研整合 | + +**维护规范**:[机擎/阿表/开发文档结构规范/SKILL.md](../../机擎/阿表/开发文档结构规范/SKILL.md) --- ## 合并记录 -- 2026-02-10: `成本与需求澄清.md` 内容合并入 `项目概述.md` 附录 -- 2026-02-10: 新增 `技术调研与方案选型.md`,整合资料目录全部12份调研文档 +- 2026-05-24:分层 `01~03` +- 2026-02-10:成本澄清合并入项目概述;调研 12 份整合 diff --git a/开发文档/1、需求/images/README.md b/开发文档/1、需求/images/README.md new file mode 100644 index 0000000000..0f5e29cef6 --- /dev/null +++ b/开发文档/1、需求/images/README.md @@ -0,0 +1,3 @@ +# images + +需求类配图放此目录。 diff --git a/开发文档/README.md b/开发文档/README.md index 50092d009e..6fd541c832 100644 --- a/开发文档/README.md +++ b/开发文档/README.md @@ -73,7 +73,7 @@ | 目录 | 主文档(≤3) | 说明 | |------|----------------|------| -| [1、需求](1、需求/) | 项目概述、业务需求、技术调研与方案选型 | 需求与澄清 | +| [1、需求](1、需求/) | **分层** `01-概述/` `02-业务/` `03-调研/`;`修改/` 增量 | 需求与澄清 | | [2、架构](2、架构/) | **分层目录** `01-总览/` `02-技术基座/` `03-通道与设备/` `04-交互图/` `05-规范/`;PNG 在 `images/01~04/` | 架构与 §3.0 模块拆解;规范见 [机擎/阿表/开发文档结构规范](../机擎/阿表/开发文档结构规范/SKILL.md) | | [3、原型](3、原型/) | 原型设计规范 | 原型规范 | | [4、前端](4、前端/) | 前端开发规范、管理端前端开发规范、v0配置 | 前端规范 | diff --git a/机擎/SKILL.md b/机擎/SKILL.md index 5253382323..19819eb3b9 100644 --- a/机擎/SKILL.md +++ b/机擎/SKILL.md @@ -187,7 +187,7 @@ 3. 新功能跑通 → 更新对应开发文档与架构 4. 存客宝侧同步:更新 cunkebao_v3 工作手机开发进度与总表一致 5. 若有完整功能交付 → 触发飞书群复盘(见下 §3.2.1,必执行) -6. 对话沉淀需求:检查本轮对话是否有可沉淀的功能需求/流程改进/技术方案 → 追加到 开发文档/1、需求/业务需求.md「对话沉淀需求」章节 +6. 对话沉淀需求:检查本轮对话是否有可沉淀的功能需求/流程改进/技术方案 → 追加到 开发文档/1、需求/02-业务/业务需求.md「对话沉淀需求」章节 7. 经验沉淀:把优秀做法、稳定流程、关键判断写回 references 或开发文档,方便下次直接调用 ``` @@ -254,7 +254,7 @@ **共写区域**(所有人可追加): - `开发文档/10、项目管理/工作日志.md` — 各写各的段落 -- `开发文档/1、需求/业务需求.md`「对话沉淀需求」章节 — 各追加各的需求 +- `开发文档/1、需求/02-业务/业务需求.md`「对话沉淀需求」章节 — 各追加各的需求 - `机擎/references/开发接力文档.md` — 统一接力文档(见 5.3) ### 5.2 跨区域协作规则(不直接改对方文件) diff --git a/机擎/references/开发接力文档.md b/机擎/references/开发接力文档.md index 496850e586..95d2e80927 100644 --- a/机擎/references/开发接力文档.md +++ b/机擎/references/开发接力文档.md @@ -48,7 +48,7 @@ - sdk/app/static/hub.html — 统一工作台壳页面 - sdk/app/main.py — 新增 /api/v3/workbench/* 接口 - cunkebao_v3 controller + index.tsx — 存客宝侧同步 -- 开发文档/1、需求/业务需求.md — 对话沉淀需求章节 +- 开发文档/1、需求/02-业务/业务需求.md — 对话沉淀需求章节 **验收标准**: - [ ] 阿机:确认后端接口 /workbench/overview、/docs、/docs/{id} 正常 - [ ] 阿桥:确认存客宝 PHP 聚合接口消费统一 DTO 正常 diff --git a/机擎/阿表/开发文档结构规范/SKILL.md b/机擎/阿表/开发文档结构规范/SKILL.md index be6f0cbbe4..1d542cabe3 100644 --- a/机擎/阿表/开发文档结构规范/SKILL.md +++ b/机擎/阿表/开发文档结构规范/SKILL.md @@ -88,6 +88,12 @@ version: 1.0.0 02-测试报告/ 03-计划与专项/ ``` +## 二E、`1、需求`(2026-05-24 起) + +```text +1、需求/01-概述/ 02-业务/ 03-调研/ + 修改/ 增量补丁 +``` + ### 新架构资产归类决策树 ```text