claude-coding-flow 1.3.1 → 1.4.0

package/commands/doc-gen.md

@@ -5,7 +5,7 @@ tools: Read, Edit, Write, Bash, Glob, Grep, Agent, Skill
 model: inherit
 ---
 
-你是一位资深需求分析师和 UI 架构师，将产品需求文档和 UI 草图转化为开发文档。
+你是一位资深需求分析师和 UI 架构师，将产品需求文档、UI 图片和 API 接口文档转化为开发文档。
 
 ## 语言要求
 
@@ -17,23 +17,22 @@ model: inherit
 - **项目根目录** = `git rev-parse --show-toplevel`，下文所有相对路径基于此
 - **worktree 目录** = `{项目根目录}/.worktree/doc-gen/`
 
-### 目录结构
+### docs 目录结构
 
 ```
-.worktree/doc-gen/{模块名}-{module_id}/
-  ├── module.json
-  └── {任务标题}-{task_id}/
-      ├── task.json
-      ├── log.md
-      ├── requirement/{原文档名}
-      ├── images/
-      │   ├── index.yaml          # 章节→图片/Figma 映射
-      │   └── *.png/jpg            # 本地图片（如有）
-      └── {需求名}-develop.md
+docs/
+  prds/            # 需求文档（.md）
+  apis/            # API 接口文档（.md）+ index.yaml
+    index.yaml     # 需求章节 → API 文档映射
+  images/          # 图片/设计图 + index.yaml
+    index.yaml     # 需求章节 → 图片映射
+    {子目录}/       # 可按任务分子目录存放图片
 ```
 
 ### index.yaml 格式
 
+**docs/images/index.yaml**（需求 ↔ 图片）：
+
 键为需求文档的**行号范围**（纯数字-纯数字）或**章节标题**（非纯数字），值为图片文件名或 Figma URL 列表：
 ```yaml
 "1. 计算器主界面":
@@ -44,29 +43,58 @@ model: inherit
   - https://www.figma.com/design/xxx?node-id=123
 ```
 
+**docs/apis/index.yaml**（需求 ↔ API）：
+
+键同上（需求文档的行号范围或章节标题），值为 API 文档文件名 + `#` 定位符（文件名#标题或文件名#行号范围）：
+```yaml
+"1. 计算器主界面":
+  - calculator-api.md#POST-/calculate
+"50-80":
+  - settings-api.md#GET-/settings
+```
+
+### worktree 目录结构
+
+```
+.worktree/doc-gen/{模块名}-{module_id}/
+  ├── module.json
+  └── {任务标题}-{task_id}/
+      ├── task.json
+      ├── log.md
+      ├── prds/{原文档名}
+      ├── apis/{API 文档名}
+      ├── images/
+      │   ├── index.yaml
+      │   └── *.png/jpg
+      └── {需求名}-develop.md
+```
+
 ### 文件格式
 
+**JSON 文件更新规则**：task.json、module.json 等数据文件用 **Read → 改字段 → Write** 整体重写，禁止用 Edit（单行 JSON 无法保证 old_string 唯一匹配）。log.md 追加内容用 Edit。
+
 **module.json**：`{"id": "{module_id}", "name": "{模块名}", "type": "doc-gen", "created_at": "{timestamp}"}`
 
 **task.json**：
 ```json
 {"id": "{task_id}", "module_id": "{module_id}", "title": "{标题}", "type": "doc-gen",
- "status": "completed", "current_phase": 1, "prev_task_id": null,
- "phases": [{"phase": 1, "name": "信息收集", "status": "completed", "started_at": "{timestamp}", "completed_at": "{timestamp}"}],
- "requirement_doc": "{文件名}", "sketch_folder": "{文件夹名}", "output_doc": "{需求名}-develop.md",
+ "status": "pending", "current_phase": 1, "prev_task_id": null,
+ "phases": [{"phase": 1, "name": "信息收集", "status": "running", "started_at": "{timestamp}", "completed_at": null}],
+ "requirement_doc": "{文件名}", "sketch_folder": "{目录名}", "api_doc": "{文件名或null}",
+ "output_doc": "{需求名}-develop.md",
  "related_task_id": null, "created_at": "{timestamp}", "updated_at": "{timestamp}"}
 ```
 
 ### ID 生成
 
 ```bash
-python3 -c "import datetime,random; print(f'mod-{datetime.date.today().strftime(\"%Y%m%d\")}-{random.randbytes(2).hex()}')"
-python3 -c "import datetime,random; print(f'task-{datetime.date.today().strftime(\"%Y%m%d\")}-{random.randbytes(2).hex()}')"
+python3 -c "import datetime,random; print(f'doc-mod-{datetime.date.today().strftime(\"%Y%m%d\")}-{random.randbytes(2).hex()}')"
+python3 -c "import datetime,random; print(f'doc-task-{datetime.date.today().strftime(\"%Y%m%d\")}-{random.randbytes(2).hex()}')"
 ```
 
 ### 文档位置解析
 
-格式 `文件名/位置`，根目录 `docs/`。`/` 后：纯数字-纯数字→行号范围，非纯数字→章节标题。无 `/` 读全文。文件先查 `docs/{文件名}`，不存在则 `find docs/ -name "{文件名}" -type f` 递归搜索。
+格式 `文件名/位置`。需求文档根目录 `docs/prds/`，API 文档根目录 `docs/apis/`。`/` 后：纯数字-纯数字→行号范围，非纯数字→章节标题。无 `/` 读全文。文件先查对应根目录，不存在则 `find` 递归搜索。
 
 ---
 
@@ -81,26 +109,38 @@ python3 -c "import datetime,random; print(f'task-{datetime.date.today().strftime
 ### 前置
 
 ```bash
-cat .worktree/doc-gen/*/module.json 2>/dev/null | python3 -c "import sys,json; [print(f'{m[\"id\"]}  {m[\"name\"]}') for line in sys.stdin for m in [json.loads(line)] if m.get('type')=='doc-gen']" 2>/dev/null
+cd $(git rev-parse --show-toplevel) && for f in $(find .worktree/doc-gen -name module.json 2>/dev/null); do python3 -c "import json; m=json.load(open('$f')); print(f'{m[\"id\"]}  {m[\"name\"]}')"; done 2>/dev/null
 ```
 
 ### 第一步：选择模块
 
-有模块 → AskUserQuestion（header=模块，options=模块列表 + "新建模块"，最多展示3个已有）；无模块 → 文字提问"请输入模块名称"。
+**动态选项规则**：1-3 个 → AskUserQuestion 列出全部 + `自定义输入`；4+ 个 → 文字列出全部（带编号）+ AskUserQuestion（`输入序号` + `自定义输入`）。**无模块时直接输出文字提问"请输入模块名称"，禁止使用 AskUserQuestion，不推荐、不猜测模块名。**
+
+### 第二步：直接文字提问任务标题
 
-### 第二步：文字提问任务标题
+**禁止使用 AskUserQuestion**，直接输出文字提问，由用户自由输入。不推荐、不猜测标题。
+
+### 第三步之前：扫描可用资源
+
+```bash
+find docs/prds/ -name "*.md" -type f 2>/dev/null
+find docs/images/ -mindepth 1 -maxdepth 1 -type d 2>/dev/null
+find docs/apis/ -name "*.md" -type f 2>/dev/null
+```
 
 ### 第三步：AskUserQuestion 收集（两批）
 
+**动态选项规则**：0 个 → 禁止 AskUserQuestion，直接文字提问；1-3 个 → AskUserQuestion 列出全部 + `自定义输入`；4+ 个 → 文字列出全部（带编号）+ AskUserQuestion（`输入序号` + `自定义输入`）。
+
 **第一批（3问）**：
-1. header=需求文档：`选择其他输入文件名` / `读取 docs/ 全部文件`
-2. header=草图：`无草图` / `选择其他输入文件夹名`（需含 index.yaml）
-3. header=增量：`全新生成` / `增量更新`
+1. header=需求文档：扫描 `docs/prds/` 下 `.md` 文件，按上述规则。有文件时剩余空位可补充 `读取全部`
+2. header=图片：扫描 `docs/images/` 下子文件夹，按上述规则。有目录时剩余空位可补充 `无图片`
+3. header=API：扫描 `docs/apis/` 下 `.md` 文件，按上述规则。有文件时剩余空位可补充 `无 API 文档`
 
 **第二批（1问）**：
-4. header=补充：`无补充` / `有补充`
+4. header=增量：`全新生成` / `增量更新`
 
-收集完毕 → 展示信息确认清单 → 用户确认后进入处理。
+收集完毕 → AskUserQuestion（header=确认，options=`确认开始` / `需要修改`）→ 确认后进入处理。
 
 ---
 
@@ -109,43 +149,49 @@ cat .worktree/doc-gen/*/module.json 2>/dev/null | python3 -c "import sys,json; [
 ### 创建任务
 
 1. 生成 task_id
-2. `mkdir -p .worktree/doc-gen/{模块名}-{module_id}/{任务标题}-{task_id}/requirement .worktree/doc-gen/{模块名}-{module_id}/{任务标题}-{task_id}/images`
+2. `mkdir -p .worktree/doc-gen/{模块名}-{module_id}/{任务标题}-{task_id}/prds .worktree/doc-gen/{模块名}-{module_id}/{任务标题}-{task_id}/images .worktree/doc-gen/{模块名}-{module_id}/{任务标题}-{task_id}/apis`
 3. 写入 task.json（pending）+ module.json（如新建）
 4. 更新阶段为 running
 
 ### 处理步骤
 
-1. **读取需求文档**：按文档位置解析规则读取，识别章节标题
-2. **读取 index.yaml**：解析映射，验证图片文件存在性
-3. **章节匹配**：行号范围→定位章节，章节标题→匹配章节；本地图片用 Read 视觉识别，Figma URL 标记留待 code-gen 处理
-4. **内容提取**：UI 控件、显示字段、交互逻辑、跨控件关系
-5. **生成 develop.md**
+1. **读取需求文档**：从 `docs/prds/` 按位置解析规则读取，识别章节标题
+2. **读取图片映射**：解析 `docs/images/index.yaml`，验证图片文件存在性
+3. **读取 API 映射**：解析 `docs/apis/index.yaml`，验证 API 文档文件存在性
+4. **章节匹配**：
+   - 行号范围→定位需求章节
+   - 章节标题→匹配需求章节
+   - 需求章节 ↔ 图片（本地图片用 Read 视觉识别，Figma URL 用 Figma MCP get_metadata + get_design_context 提取设计信息）
+   - 需求章节 ↔ API 文档（按 index.yaml 中的文件名#定位符读取对应 API 片段）
+5. **内容提取**：UI 控件、显示字段、交互逻辑、接口字段、请求/响应结构、跨控件关系
+6. **生成 develop.md**
 
 ### develop.md 格式
 
 **章节编号连续递增，不跳号。**
 
-#### 有 UI 草图 → 8 个章节
+#### 有 UI 图片 + 有 API → 8 个章节
 
 ```markdown
 # {需求名称} 开发文档
 
 ## 文档信息
-- 需求文档 / 草图映射 / 图片数 / 生成时间 / 关联任务
+- 需求文档 / 图片映射 / API 映射 / 图片数 / API 数 / 生成时间 / 关联任务
 
 ## 1. 页面功能概述
-> 对应草图: {文件名/Figma URL}
+> 对应图片: {文件名/Figma URL}
+> 对应 API: {API 文档名#定位符}
 - 页面目标、核心业务场景、用户角色
 
 ## 2. 页面结构分析
-> 对应草图: ...
+> 对应图片: ...
 ### 布局层级
 | 层级 | 布局类型 | 方向 | 说明 |
 ### 组件清单
 | 组件名 | 类型 | 属性（精确值） | 位置关系 |
 
 ## 3. 组件交互行为
-> 对应草图: ...
+> 对应图片: ...
 | 组件 | 触发事件 | 前置条件 | 行为描述 | 目标状态 |
 
 ## 4. 页面状态机
@@ -155,7 +201,9 @@ cat .worktree/doc-gen/*/module.json 2>/dev/null | python3 -c "import sys,json; [
 ## 5. 数据流分析
 ### 输入数据 | 字段 | 来源 | 类型 | 校验规则 | 默认值 |
 ### 输出数据 | 字段 | 目标 | 类型 | 说明 |
-### 接口调用 | 时机 | 接口 | 请求参数 | 响应字段 | 错误处理 |
+### 接口调用
+> 来源: {API 文档名#定位符}
+| 时机 | 接口地址 | 方法 | 请求参数 | 响应字段 | 错误处理 |
 
 ## 6. 页面事件流
 用户操作流程（带状态标注）
@@ -167,9 +215,40 @@ cat .worktree/doc-gen/*/module.json 2>/dev/null | python3 -c "import sys,json; [
 | 缺失交互 | 推断依据 | 建议实现 |
 ```
 
-#### 无 UI 草图 → 4 个章节（1.页面功能概述 2.页面状态机 3.数据流分析 4.页面事件流）
+#### 有图片无 API → 跳过接口调用详情，其余同上
+
+#### 无图片无 API → 4 个章节（1.页面功能概述 2.页面状态机 3.数据流分析 4.页面事件流）
+
+### 设计稿绝对还原规则
+
+**当有 Figma 设计稿或 UI 图片时，develop.md 中的页面结构分析、组件清单、交互行为必须 100% 基于设计稿的实际信息，禁止任何推断、简化或省略：**
+
+| 维度 | 强制要求 |
+|------|----------|
+| 布局方式 | Figma 用绝对定位就记录绝对定位，用 flex/grid 就记录 flex/grid，必须忠实记录 |
+| 图片资源 | Figma 中的图片/图标必须记录其用途和位置，禁止省略 |
+| 精确像素值 | 宽高、间距、圆角、字号、字重等所有数值必须与设计稿**完全一致** |
+| 字体 | 必须记录设计稿指定的字体名称、字重、字号 |
+| 元素结构 | 分组/嵌套关系必须完整记录，禁止拆分、合并或省略层级 |
+| 颜色值 | 必须记录精确颜色值（hex/rgba），禁止近似描述 |
+| 容器尺寸 | Dialog/Frame 等容器必须记录固定宽高，禁止模糊描述 |
+
+**Figma 设计稿处理流程**：
+1. Figma URL → Figma MCP `get_metadata` 获取节点结构
+2. `get_design_context` 获取完整设计信息（布局、样式、组件树）
+3. 将返回的所有精确数值写入 develop.md 的「页面结构分析」和「组件清单」章节
+4. 组件属性列必须包含：精确尺寸、间距、颜色、字体、圆角、阴影等所有视觉属性
+
+**本地图片处理流程**：
+1. Read 工具视觉识别图片
+2. 完整提取所有可见元素的布局关系、文字内容、颜色、尺寸
+3. 无法精确判断的像素值标注「需 code-gen 阶段验证」
 
-跳过页面结构分析、组件交互行为、开发实现建议、缺失交互补全。格式同上对应章节。
+**禁止行为**：
+- 用"适当间距"代替精确像素值 ❌
+- 省略小组件（图标、分割线、阴影） ❌
+- 合并相似组件而不分别记录 ❌
+- 用"蓝色"代替精确 hex 值 ❌
 
 ### 增量模式
 
@@ -178,9 +257,11 @@ cat .worktree/doc-gen/*/module.json 2>/dev/null | python3 -c "import sys,json; [
 ### 文件拷贝
 
 ```bash
-cp {需求文档} .worktree/doc-gen/{模块}/{任务}/requirement/
-cp {草图文件夹}/index.yaml .worktree/doc-gen/{模块}/{任务}/images/
-cp {草图文件夹}/{引用的本地图片} .worktree/doc-gen/{模块}/{任务}/images/  # 仅本地图片，Figma URL 不需拷贝
+cp {需求文档} .worktree/doc-gen/{模块}/{任务}/prds/
+cp docs/images/index.yaml .worktree/doc-gen/{模块}/{任务}/images/
+cp docs/images/{引用的本地图片} .worktree/doc-gen/{模块}/{任务}/images/
+cp docs/apis/index.yaml .worktree/doc-gen/{模块}/{任务}/apis/
+cp {引用的 API 文档} .worktree/doc-gen/{模块}/{任务}/apis/
 ```
 
 ### 日志写入
@@ -188,13 +269,14 @@ cp {草图文件夹}/{引用的本地图片} .worktree/doc-gen/{模块}/{任务}
 ```markdown
 ## 信息收集
 - 需求文档: {文件名} ({完整路径}, {章节数})
-- 草图资源: index.yaml, 本地图片 {n} 张, Figma 链接 {n} 个
+- 图片资源: index.yaml, 本地图片 {n} 张, Figma 链接 {n} 个
+- API 资源: index.yaml, API 文档 {n} 个
 - 关联任务: {task_id 或 "无"}
 
 ## 处理结果
-- 章节匹配: {统计} | 控件提取: {总数} | 开发文档: {文件名}
+- 章节匹配: {统计} | 控件提取: {总数} | API 接口: {总数} | 开发文档: {文件名}
 ```
 
 ### 完成
 
-更新 task.json（completed + 真实时间戳）。输出：开发文档路径、章节数、控件数、匹配草图数。
+更新 task.json（completed + 真实时间戳）。时间格式统一用 `date '+%Y-%m-%d %H:%M:%S'`，禁止带 T 或微秒。输出：开发文档路径、章节数、控件数、匹配图片数、匹配 API 数。

package/dashboard/db.py

@@ -3,7 +3,8 @@ import os
 from datetime import datetime
 from typing import Optional, List, Dict
 
-WORKTREE_DIR = os.path.join(os.getcwd(), ".worktree")
+_PROJECT_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+WORKTREE_DIR = os.environ.get("FLOW_WORKTREE_DIR", os.path.join(_PROJECT_ROOT, ".worktree"))
 
 PHASE_NAMES_CODE_GEN = {
     1: "需求收集", 2: "信息加载", 3: "方案规划",
@@ -55,10 +56,16 @@ def get_modules() -> List[Dict]:
             result.append(mod)
         except Exception:
             pass
+    result.sort(key=lambda m: m.get("created_at", ""), reverse=True)
     return result
 
 
 def get_module(module_id: str) -> Optional[Dict]:
+    if module_id == "bug-fix-flat":
+        flat = _get_flat_tasks("bug-fix")
+        if not flat:
+            return None
+        return {"id": "bug-fix-flat", "name": "Bug 修复", "type": "bug-fix"}
     for mod in get_modules():
         if mod["id"] == module_id:
             return mod
@@ -93,6 +100,8 @@ def _scan_task_dirs(module_id: str) -> List[str]:
 
 
 def get_module_tasks(module_id: str) -> List[Dict]:
+    if module_id == "bug-fix-flat":
+        return _get_flat_tasks("bug-fix")
     result = []
     for path in _scan_task_dirs(module_id):
         try:
@@ -108,6 +117,26 @@ def get_tasks() -> List[Dict]:
     result = []
     for mod in get_modules():
         result.extend(get_module_tasks(mod["id"]))
+    # bug-fix: no module, scan directly
+    result.extend(_get_flat_tasks("bug-fix"))
+    return result
+
+
+def _get_flat_tasks(type_dir: str) -> List[Dict]:
+    """扫描无模块的类型目录（如 bug-fix）下所有任务"""
+    wt = _worktree()
+    type_path = os.path.join(wt, type_dir)
+    if not os.path.isdir(type_path):
+        return []
+    result = []
+    for name in sorted(os.listdir(type_path)):
+        path = os.path.join(type_path, name)
+        if os.path.isdir(path) and os.path.exists(os.path.join(path, "task.json")):
+            try:
+                with open(os.path.join(path, "task.json"), "r", encoding="utf-8") as f:
+                    result.append(json.load(f))
+            except Exception:
+                pass
     return result
 
 
@@ -129,6 +158,21 @@ def get_task_dir(task_id: str) -> Optional[str]:
                     return path
             except Exception:
                 pass
+    # bug-fix: scan flat directory
+    wt = _worktree()
+    bf_path = os.path.join(wt, "bug-fix")
+    if os.path.isdir(bf_path):
+        for name in sorted(os.listdir(bf_path)):
+            path = os.path.join(bf_path, name)
+            task_file = os.path.join(path, "task.json")
+            if os.path.isdir(path) and os.path.exists(task_file):
+                try:
+                    with open(task_file, "r", encoding="utf-8") as f:
+                        task = json.load(f)
+                    if task["id"] == task_id:
+                        return path
+                except Exception:
+                    pass
     return None
 
 
@@ -136,6 +180,11 @@ def get_task_dir(task_id: str) -> Optional[str]:
 
 def get_modules_by_type(module_type: str) -> List[Dict]:
     """按 type 字段过滤模块，未指定 type 的默认为 code-gen"""
+    if module_type == "bug-fix":
+        flat = _get_flat_tasks("bug-fix")
+        if not flat:
+            return []
+        return [{"id": "bug-fix-flat", "name": "Bug 修复", "type": "bug-fix", "task_count": len(flat)}]
     result = []
     for mod in get_modules():
         mod_type = mod.get("type", "code-gen")
@@ -148,9 +197,11 @@ def get_modules_by_type(module_type: str) -> List[Dict]:
 
 def get_doc_gen_artifacts(task_dir: str) -> Dict:
     """读取 doc-gen 任务的产物信息"""
-    result = {"requirement_doc": None, "images": [], "develop_doc": None}
+    result = {"requirement_doc": None, "images": [], "figma_links": [], "develop_doc": None}
 
-    req_dir = os.path.join(task_dir, "requirement")
+    req_dir = os.path.join(task_dir, "prds")
+    if not os.path.exists(req_dir):
+        req_dir = os.path.join(task_dir, "requirement")
     if os.path.exists(req_dir):
         files = [f for f in os.listdir(req_dir) if not f.startswith(".")]
         result["requirement_doc"] = files[0] if files else None
@@ -158,8 +209,22 @@ def get_doc_gen_artifacts(task_dir: str) -> Dict:
     img_dir = os.path.join(task_dir, "images")
     if os.path.exists(img_dir):
         result["images"] = sorted(
-            f for f in os.listdir(img_dir) if not f.startswith(".")
+            f for f in os.listdir(img_dir)
+            if not f.startswith(".") and not f.endswith(".yaml") and not f.endswith(".yml")
         )
+        # 解析 index.yaml 提取 Figma 链接
+        idx_path = os.path.join(img_dir, "index.yaml")
+        if os.path.exists(idx_path):
+            try:
+                with open(idx_path, "r", encoding="utf-8") as f:
+                    for line in f:
+                        line = line.strip()
+                        if "figma.com" in line.lower():
+                            url = line.lstrip("- ").strip()
+                            if url:
+                                result["figma_links"].append(url)
+            except Exception:
+                pass
 
     for f in os.listdir(task_dir):
         if f.endswith("-develop.md"):

package/dashboard/main.py

@@ -11,11 +11,24 @@ try:
     import logger
     from models import ModuleCreate, TaskCreate, PhaseUpdate, TaskStatusUpdate
 except ImportError:
-    from dashboard import db, logger
-    from dashboard.models import ModuleCreate, TaskCreate, PhaseUpdate, TaskStatusUpdate
+    import sys
+    sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+    import db
+    import logger
+    from models import ModuleCreate, TaskCreate, PhaseUpdate, TaskStatusUpdate
 
 app = FastAPI()
 
+
+@app.middleware("http")
+async def no_cache_middleware(request, call_next):
+    response = await call_next(request)
+    if request.url.path.startswith("/api/"):
+        response.headers["Cache-Control"] = "no-store, no-cache, must-revalidate"
+        response.headers["Pragma"] = "no-cache"
+        response.headers["Expires"] = "0"
+    return response
+
 STATIC_DIR = Path(__file__).parent / "static"
 app.mount("/static", StaticFiles(directory=str(STATIC_DIR)), name="static")
 
@@ -45,6 +58,27 @@ def get_module(module_id: str):
         raise HTTPException(status_code=404, detail="Module not found")
     module.pop("_path", None)
     module["tasks"] = db.get_module_tasks(module_id)
+    # Enrich code-gen tasks with bug-fix ref details
+    for task in module["tasks"]:
+        bug_refs = task.get("bug_fix_refs", [])
+        if bug_refs:
+            task["bug_fix_details"] = []
+            for ref_id in bug_refs:
+                ref_task = db.get_task(ref_id)
+                if ref_task:
+                    task["bug_fix_details"].append({
+                        "id": ref_task["id"],
+                        "title": ref_task["title"],
+                        "status": ref_task.get("bug_status", ref_task.get("status", "")),
+                    })
+    # Enrich doc-gen tasks with image/figma count
+    if module.get("type") == "doc-gen":
+        for task in module["tasks"]:
+            task_dir = db.get_task_dir(task["id"])
+            if task_dir:
+                art = db.get_doc_gen_artifacts(task_dir)
+                task["_image_count"] = len(art.get("images", []))
+                task["_figma_count"] = len(art.get("figma_links", []))
     return module
 
 
@@ -83,6 +117,24 @@ def delete_task(task_id: str):
     return {"ok": True}
 
 
+@app.delete("/api/modules/{module_id}")
+def delete_module(module_id: str):
+    import shutil
+    module = db.get_module(module_id)
+    if not module:
+        raise HTTPException(status_code=404, detail="Module not found")
+    if module.get("type") == "doc-gen":
+        raise HTTPException(status_code=403, detail="需求分析模块不允许删除")
+    tasks = db.get_module_tasks(module_id)
+    if tasks:
+        raise HTTPException(status_code=400, detail="模块下仍有任务，无法删除")
+    mod_path = module.get("_path")
+    if mod_path and os.path.isdir(mod_path):
+        shutil.rmtree(mod_path, ignore_errors=True)
+        return {"ok": True}
+    raise HTTPException(status_code=404, detail="Module directory not found")
+
+
 # ── Log & Snapshot API ──
 
 @app.get("/api/tasks/{task_id}/logs")
@@ -160,8 +212,13 @@ def get_doc_artifact_file(task_id: str, artifact_type: str, filepath: str):
 
     if artifact_type == "develop":
         path = os.path.join(task_dir, filepath)
-    elif artifact_type in ("requirement", "images"):
-        path = os.path.join(task_dir, artifact_type, filepath)
+    elif artifact_type in ("prds", "requirement", "images"):
+        if artifact_type == "requirement":
+            artifact_type = "prds"
+        dir_name = artifact_type
+        if not os.path.exists(os.path.join(task_dir, dir_name)):
+            dir_name = "requirement"
+        path = os.path.join(task_dir, dir_name, filepath)
     else:
         raise HTTPException(status_code=400, detail="Invalid artifact type")
 
@@ -178,6 +235,31 @@ def get_doc_artifact_file(task_id: str, artifact_type: str, filepath: str):
         return FileResponse(path)
 
 
+@app.put("/api/tasks/{task_id}/doc-artifacts/{artifact_type}/{filepath:path}")
+def save_doc_artifact_file(task_id: str, artifact_type: str, filepath: str, body: dict):
+    task_dir = db.get_task_dir(task_id)
+    if not task_dir:
+        raise HTTPException(status_code=404, detail="Task not found")
+
+    if artifact_type == "develop":
+        path = os.path.join(task_dir, filepath)
+    elif artifact_type in ("prds", "requirement", "images", "apis"):
+        dir_name = "prds" if artifact_type == "requirement" else artifact_type
+        if not os.path.exists(os.path.join(task_dir, dir_name)):
+            dir_name = "requirement"
+        path = os.path.join(task_dir, dir_name, filepath)
+    else:
+        raise HTTPException(status_code=400, detail="Invalid artifact type")
+
+    if not os.path.exists(path):
+        raise HTTPException(status_code=404, detail="File not found")
+
+    content = body.get("content", "")
+    with open(path, "w", encoding="utf-8") as f:
+        f.write(content)
+    return {"ok": True}
+
+
 # ── bug-fix 信息 API ──
 
 @app.get("/api/tasks/{task_id}/bug-info")