docs: organize product design by feature

Define repository and feature-scoped documentation rules for PRDs, User Stories, logic, UI, technical design, and progress evidence.

Move feature-owned documents under docs/features, add one entry point per feature, remove the redundant docs index, and update all affected cross-references. Expand the local tool environment design with explicit product, story, logic, UI, technical, and progress documents.
This commit is contained in:
mesalogo
2026-09-01 14:52:22 +08:00
parent dba3380a06
commit 2f1881a414
56 changed files with 1763 additions and 765 deletions
+3 -3
View File
@@ -9,7 +9,7 @@
| 版本 | 0.4 |
| 日期 | 2026-08-22 |
| 适用产品 | GoodBuddy 桌面端 |
| 相关设计 | [通用助手工作栏与执行空间 PRD](../prd/assistant-experience/assistant-workbar-and-execution-spaces-prd.md)、[Task 与 Job 统一领域模型](../prd/task-and-job/task-and-job-model.md)、[智能心跳 PRD](../prd/smart-heartbeat/smart-heartbeat-prd.md)、[全双工实时语音交互设计](../architecture/full-duplex-voice-design.md) |
| 相关设计 | [通用助手工作栏与执行空间 PRD](../features/assistant-workbar/prd.md)、[Task 与 Job 统一领域模型](../features/task-and-job/task-and-job-model.md)、[智能心跳 PRD](../features/smart-heartbeat/prd.md)、[全双工实时语音交互设计](../features/full-duplex-voice/technical-design.md) |
## 1. 文档目标
@@ -58,7 +58,7 @@ GoodBuddy 应能够:
### 3.2 右侧工作栏
本节的范围、选择、执行空间与安全契约以
[通用助手工作栏与执行空间 PRD](../prd/assistant-experience/assistant-workbar-and-execution-spaces-prd.md) 为准。
[通用助手工作栏与执行空间 PRD](../features/assistant-workbar/prd.md) 为准。
#### 任务中心
@@ -208,7 +208,7 @@ GoodBuddy 应能够:
- 当前已提供点击开始、再次点击停止或到达 20 秒上限后停止的本地一次性语音听写。
- 转写结果先进入可编辑输入框,不自动发送。
- 后续按[全双工实时语音交互设计](../architecture/full-duplex-voice-design.md)增加持续听说、
- 后续按[全双工实时语音交互设计](../features/full-duplex-voice/technical-design.md)增加持续听说、
Barge-in、流式文本转语音、本地与云端显式语音引擎。
- 活动会话冻结引擎、Provider、模型、地域、数据位置和能力;引擎失败时明确停止或重试
当前选择,不在本地/云端、原生/模块化、语音/文本之间静默降级。
@@ -89,7 +89,7 @@
- 发布说明准确标注已验证架构和仍未验证范围。
- **外部依赖:** Agent 发布审批、双架构正式产物、真实 Linux arm64 环境。
- **起始证据:** `package.json`、`agent-runtime-lock.json`、
`docs/architecture/remote-host-and-goodbuddy-agent-design.md`。
`docs/features/remote-host/technical-design.md`。
### REL-02 正式 Latest 签名门槛
@@ -208,7 +208,7 @@
- **验收:** 创建、编辑、重启恢复和到期触发均按本地日历执行且不重复。
- **依赖:** `FUN-01`、`FUN-07`。
- **起始证据:** `src/shared/assistant-contracts.ts`、
`docs/prd/task-and-job/scheduled-task-prd.md`。
`docs/features/task-and-job/scheduled-task-prd.md`。
### FUN-07 时区和错过执行策略
@@ -222,7 +222,7 @@
- 重启或系统恢复后不会形成补跑风暴。
- 时区和策略可创建、编辑、持久化并在界面复现。
- **起始证据:** `src/main/assistant/assistant-database.ts`、
`docs/prd/task-and-job/scheduled-task-prd.md`。
`docs/features/task-and-job/scheduled-task-prd.md`。
### FUN-08 旧版 Office 文件