# 需求规格说明书：PM-Agent v1.1.0

**版本**: v1.1
**创建日期**: 2026-02-17
**作者**: Agent 3 (PM Agent产品经理)
**版本号**: v1.1.0
**状态**: DRAFT

---

## 变更历史

| 版本 | 日期 | 变更 |
|------|------|------|
| v1.0.0 | 2026-02-16 | 初始版本 |
| v1.1.0 | 2026-02-17 | 整合Meeting Transcribe Proposal，新增材料去重和模板转换功能 |

---

## 零、核心架构参考

| 功能ID | 功能名称 | 架构模块 | 映射路径 | 优先级 |
|--------|----------|----------|----------|--------|
| F-001 | 多模态输入 | L3.PM.1 | 客户材料入口 | P0 |
| F-002 | 统一输入处理 | L3.PM.2 | 输入处理框架 | P0 |
| F-003 | 客户识别 | L3.PM.3 | 客户管理 | P0 |
| F-004 | 项目匹配 | L3.PM.4 | 项目管理 | P0 |
| F-005 | 自动路由 | L3.PM.5 | 资料库路由 | P0 |
| F-006 | oc-collab整合 | L3.PM.6 | Git集成 | P0 |
| F-007 | 开发文档汇总 | L3.PM.7 | 客户输出 | P1 |
| F-008 | 问题自动分类 | L3.PM.8 | BUG/需求识别 | P0 |
| F-009 | 自动生成BUG报告 | L3.PM.9 | BUG文档生成 | P0 |
| F-010 | 自动生成Proposal | L3.PM.10 | 需求文档生成 | P0 |
| F-011 | 动态状态反馈 | L3.PM.11 | 状态自动更新 | P0 |
| F-012 | 处理结果显示 | L3.PM.12 | 首页处理结果列表 | P0 |
| F-013 | 材料去重 | L3.PM.13 | 文件哈希查重 | P0 |
| F-014 | 项目模板转换 | L3.PM.14 | 模板转换 | P0 |

---

## 1. 概述

### 1.1 版本信息

| 项目 | 值 |
|------|-----|
| 前置版本 | v1.0.0 |
| 变更类型 | 功能增强 |

### 1.2 核心原则

| 原则 | 说明 |
|------|------|
| 单一入口 | 所有客户材料唯一入口 |
| 自动归属 | 根据内容自动判断客户和项目 |
| 完整闭环 | 入口→归属→路由→整合→输出 |
| 去重处理 | 相同文件避免重复处理 |
| 模板转换 | 根据项目需求转化为规范格式 |

---

## 2. 功能需求

### 2.1 F-001: 多模态输入 + 预处理

**来源**: RESEARCH_image_search_mcp.md + 卷宗系统dossierai

**描述**: 支持多种格式的客户材料输入，调用dossierai服务进行预处理

**验收标准**:
- [ ] 支持图片格式：PNG, JPG, JPEG, GIF, BMP, WebP
- [ ] 支持音频格式：MP3, WAV, M4A, OGG, FLAC, WebM
- [ ] 支持文档格式：PDF, DOCX, DOC, TXT, MD
- [ ] 支持数据格式：JSON, CSV, XLSX, LOG
- [ ] 调用dossierai API进行OCR（图片→文字）
- [ ] 调用dossierai API进行语音转文字
- [ ] 调用dossierai API进行文档解析
- [ ] 调用dossierai API进行意图识别（BUG vs 需求）
- [ ] 预处理结果显示在处理结果列表中
- [ ] 支持配置dossierai服务地址

**工时**: 4h（整合dossierai）

---

### 2.2 F-002: 统一输入处理

**描述**: 统一的输入处理框架，自动识别类型并调用对应处理器

**验收标准**:
- [ ] InputHandler自动检测输入类型
- [ ] 根据类型分发到对应Handler
- [ ] Handler调用LLM进行理解/分析/总结

**工时**: 3h

---

### 2.3 F-003: 客户识别

**描述**: 自动识别材料来源的客户

**验收标准**:
- [ ] 从材料内容中提取客户名称/标识
- [ ] 支持配置客户关键词映射表
- [ ] 新客户自动创建记录

**工时**: 2h

---

### 2.4 F-004: 项目匹配

**描述**: 根据内容自动判断属于哪个项目

**验收标准**:
- [ ] 从材料内容中提取项目关键词
- [ ] 与已有项目进行匹配
- [ ] 新项目自动创建记录

**工时**: 2h

---

### 2.5 F-005: 自动路由

**描述**: 将材料推送到对应项目的资料库

**验收标准**:
- [ ] 根据客户+项目确定目标目录
- [ ] 材料自动保存到对应位置
- [ ] 记录路由历史

**工时**: 2h

---

### 2.6 F-006: oc-collab整合

**描述**: 通过Git与oc-collab项目整合

**验收标准**:
- [ ] 识别需要转为需求的内容
- [ ] 生成oc-collab格式的需求
- [ ] 写入oc-collab项目Git仓库
- [ ] 自动创建对应TODO

**工时**: 4h

---

### 2.7 F-007: 开发文档汇总

**描述**: 将项目组开发文档自动汇总给客户

**验收标准**:
- [ ] 从oc-collab项目拉取开发文档
- [ ] 按配置模板生成汇总报告
- [ ] 支持推送给对应客户

**工时**: 3h

---

### 2.8 F-008: 问题自动分类

**描述**: 根据客户材料内容自动识别是BUG报告还是功能需求

**验收标准**:
- [ ] LLM分析材料内容，识别问题类型
- [ ] 区分BUG（功能异常/错误）和新功能需求
- [ ] 提取BUG关键信息：复现步骤、错误信息、环境
- [ ] 提取需求关键信息：用户场景、期望行为
- [ ] 支持人工确认/纠正分类结果

**工时**: 2h（整合dossierai意图识别）

---

### 2.9 F-009: 自动生成BUG报告

**描述**: 自动生成符合oc-collab格式的BUG报告

**验收标准**:
- [ ] 根据分类结果自动生成BUG报告
- [ ] 报告包含：问题描述、影响范围、复现步骤、优先级
- [ ] 自动写入对应项目的BUG报告目录
- [ ] 自动添加到问题跟踪列表

**工时**: 3h

---

### 2.10 F-010: 自动生成Proposal

**描述**: 自动生成功能需求的Proposal文档

**验收标准**:
- [ ] 根据分类结果自动生成功能Proposal
- [ ] Proposal包含：背景、解决方案、用户场景、验收标准
- [ ] 自动写入对应项目的需求目录
- [ ] 自动添加到需求池

**工时**: 3h

---

### 2.11 F-011: 动态状态反馈

**描述**: BUG修复或功能上线后自动更新问题跟踪状态

**验收标准**:
- [ ] 监听oc-collab项目状态变化
- [ ] BUG修复后自动标记为"已修复"
- [ ] 功能上线后自动标记为"已完成"
- [ ] 问题解决情况自动汇总给客户

**工时**: 4h

---

### 2.12 F-012: 处理结果显示

**描述**: 首页显示每份上传文件的处理结果

**验收标准**:
- [ ] 显示文件列表：文件名、文件类型图标
- [ ] 显示自动识别的问题类型：[BUG] / [需求] / [其他]
- [ ] 显示自动匹配的项目名称
- [ ] 显示自动生成的反馈编号（BUG-XXXX / REQ-XXXX）
- [ ] 显示处理状态：处理中 / 已处理 / 需确认
- [ ] 显示预处理结果：OCR提取的文字 / 转录内容 / 提取的摘要
- [ ] 支持点击查看详情
- [ ] 支持人工确认/纠正分类结果

**工时**: 2h

---

### 2.13 F-013: 材料去重

**来源**: PROPOSAL_2026-02-017_meeting_transcribe.md

**描述**: 根据文件内容生成哈希值，避免重复处理相同文件

**验收标准**:
- [ ] 上传文件时计算文件哈希值（SHA256）
- [ ] 检查是否存在相同哈希值的文件
- [ ] 相同文件直接返回已有的处理结果
- [ ] 存储文件哈希与处理结果的映射

**工时**: 2h

---

### 2.14 F-014: 项目模板转换

**来源**: PROPOSAL_2026-02-017_meeting_transcribe.md

**描述**: 根据项目模板将材料转化为规范格式

**验收标准**:
- [ ] 支持配置项目专属的转换模板
- [ ] 模板类型：庭审记录、会议纪要、需求文档、证据材料
- [ ] 根据模板自动提取关键信息
- [ ] 输出结构化格式（JSON/Markdown）
- [ ] 支持用户选择/切换模板

**模板类型示例**：

| 模板类型 | 提取字段 |
|----------|----------|
| 庭审记录 | 当事人、案由、争议焦点、判决结果 |
| 会议纪要 | 参会人员、会议议题、讨论要点、决议事项 |
| 需求文档 | 需求描述、优先级、预期效果 |
| 证据材料 | 证据名称、来源、证明目的 |

**工时**: 4h

---

## 3. 自动化流程

### 3.1 完整自动化流程

```
客户材料（任意形式）
    │
    ▼
┌─────────────────────┐
│  PM-Agent           │
│  ┌───────────────┐  │
│  │ 内容理解       │  │ ← F-002 统一输入处理
│  │ 客户识别      │  │ ← F-003 客户识别
│  │ 项目匹配      │  │ ← F-004 项目匹配
│  │ 材料去重      │  │ ← F-013 材料去重
│  │ 问题分类      │  │ ← F-008 问题自动分类
│  └───────────────┘  │
└─────────────────────┘
    │
    ├─────────────────────┐
    │                     │
    ▼                     ▼
BUG报告              功能Proposal
    │                     │
    │ ← F-009           │ ← F-010
    │                     │
    │ ← F-014 模板转换  │ ← F-014 模板转换
    ▼                     ▼
问题跟踪 ←──────→ 需求池
    │                     │
    │ BUG修复/功能上线   │
    │ ← F-011 动态反馈  │
    └─────────┬───────────┘
              ▼
        状态自动更新
              │
              ▼
        客户反馈汇总
```

---

## 4. 工时预估

| 功能 | 工时 | 说明 |
|------|------|------|
| F-001 多模态输入+预处理 | 4h | 整合dossierai |
| F-002 统一输入处理 | 3h | 整合dossierai |
| F-003 客户识别 | 2h | |
| F-004 项目匹配 | 2h | |
| F-005 自动路由 | 2h | |
| F-006 oc-collab整合 | 4h | |
| F-007 开发文档汇总 | 3h | |
| F-008 问题自动分类 | 2h | 整合dossierai意图识别 |
| F-009 自动生成BUG报告 | 3h | |
| F-010 自动生成Proposal | 3h | |
| F-011 动态状态反馈 | 4h | |
| F-012 处理结果显示 | 2h | |
| F-013 材料去重 | 2h | 新增（来自Proposal） |
| F-014 项目模板转换 | 4h | 新增（来自Proposal） |
| 界面开发 | 10h | 复用卷宗前端组件 |
| 测试 + 修复 | 8h | |
| **总计** | **58h** | |

---

## 5. 依赖关系

| 功能 | 依赖 | 被依赖 |
|------|------|--------|
| F-002 统一输入处理 | F-001 多模态输入 | F-003~F-014 |
| F-003 客户识别 | F-002 统一输入处理 | F-004~F-005 |
| F-004 项目匹配 | F-003 客户识别 | F-005~F-006, F-014 |
| F-005 自动路由 | F-004 项目匹配 | F-007 |
| F-006 oc-collab整合 | F-005 自动路由 | F-009~F-010 |
| F-007 开发文档汇总 | F-006 oc-collab整合 | - |
| F-008 问题自动分类 | F-004 项目匹配 | F-009~F-010 |
| F-009 自动生成BUG报告 | F-008 问题自动分类 | F-011 |
| F-010 自动生成Proposal | F-008 问题自动分类 | F-011 |
| F-011 动态状态反馈 | F-009~F-010 + F-006 | - |
| F-012 处理结果显示 | F-001~F-008 | - |
| F-013 材料去重 | F-001 多模态输入 | - |
| F-014 项目模板转换 | F-002 统一输入处理 + F-004 | - |

---

## 6. 风险与应对

| 风险 | 可能性 | 影响 | 应对措施 |
|------|--------|------|----------|
| LLM理解不准确 | 中 | 中 | 提供人工确认机制 |
| Git权限配置复杂 | 低 | 高 | 提供配置向导 |
| 多客户数据隔离 | 中 | 高 | 使用不同Git仓库 |
| dossierai服务不可用 | 中 | 高 | 添加本地fallback处理逻辑 |
| 模板匹配不准 | 中 | 中 | 支持手动选择和调整模板 |

---

## 7. 签署确认

### Agent 3 创建

| 角色 | 姓名 | 日期 | 确认 |
|------|------|------|------|
| 产品负责人 | Agent 3 | 2026-02-17 | ✅ |

### Agent 4 评审

| 角色 | 姓名 | 日期 | 确认 |
|------|------|------|------|
| 架构师 | Agent 4 | - | ⏳ |

---

**文档版本**: v1.1
**创建日期**: 2026-02-17
**修订日期**: 2026-02-17
**状态**: DRAFT
