# Troubleshoot助手功能优化需求文档

## 代码路径
- 前端代码：[.claude/skills/Troubleshoot/code/web/templates/index.html]
- 后端代码：[.claude/skills/Troubleshoot/code/web/server.py]
- 缓存模块：[.claude/skills/Troubleshoot/code/web/cache_manager.py]

## 功能需求

### 功能目标
**目标：** 针对 Troubleshoot 助手当前使用中的三个痛点问题进行优化，提升用户体验和实用性。

### 需求描述

#### 需求一：模型选择 localStorage 持久化（0.2 天）

**背景问题：**
- 当前前端下拉框未实现记忆功能，用户刷新页面后需重新选择模型
- 用户习惯使用某一特定模型（如快速模式），每次刷新都要重新选择，体验不友好

**需求说明：**
- 使用浏览器 localStorage 存储用户选择的模型
- 页面加载时自动读取并设置上次的模型选择
- 实现简单，工作量小，快速提升体验

**功能实现方式：**
- 在前端 JavaScript 中监听模型下拉框的 `change` 事件
- 选择变化时,将选中的值保存到 `localStorage`
- 页面加载时，从 `localStorage` 读取并恢复选择

**验收标准：**
- [x] 用户选择模型后，刷新页面，下拉框保持上次的选择
- [x] localStorage 存储格式正确，键名为 `troubleshoot_model`
- [x] 首次访问（无 localStorage）时，默认选择"标准模式（20-50秒，推荐）"

---

#### 需求二：缓存管理界面（0.5 天）

**背景问题：**
- 后端已有缓存机制（cache_manager.py），但用户无法查看缓存状态
- 管理员无法直观了解缓存命中率、缓存大小等关键指标
- 缓存过多时影响磁盘空间，缺乏清理入口

**需求说明：**

**前端功能：**
- 在页面底部或侧边增加"缓存管理"按钮（仅管理员可见）
- 点击后展示缓存统计信息：
  - 缓存文件总数
  - 缓存总大小（MB）
  - 最早缓存时间
  - 最新缓存时间
- 提供"清除所有缓存"按钮（需二次确认）

**后端接口：**
- 新增 `/api/cache/stats` 接口：返回缓存统计信息
- 新增 `/api/cache/clear` 接口：清空所有缓存（需管理员权限）

**功能实现方式：**
- 前端：在 index.html 中增加缓存管理按钮和模态框
- 后端：在 server.py 中新增两个 API 接口
- 权限控制：通过配置文件或环境变量设置管理员名单

**验收标准：**
- [x] 点击"缓存管理"按钮，能正确显示缓存统计信息
- [x] 点击"清除缓存"按钮，弹出二次确认对话框
- [x] 确认后，缓存被清空，页面显示"已清除 X 个缓存文件"
- [x] 非管理员用户看不到"缓存管理"按钮

---

#### 需求三：排查结果导出（0.5 天）

**背景问题：**
- 现场同事排查问题后，需要将排查步骤发送给其他同事参考
- 当前只能截图或复制文本，不够正式和完整
- 导出为 PDF/Word 格式更方便分享和归档

**需求说明：**

**导出功能：**
- 在排查结果区域增加"导出"按钮
- 支持导出为 Word（.docx）格式（优先，兼容性好）
- 可选支持导出为 PDF 格式（需要额外依赖）

**导出内容包含：**
- 项目名称
- 系统类型
- APK 产品（如有）
- 问题描述
- 匹配的历史案例
- AI 分析的排查步骤
- 根因分析
- 导出时间

**功能实现方式：**
- 后端新增 `/api/export` 接口，接收排查结果数据
- 使用 `python-docx` 库生成 Word 文档
- 返回文件流，前端触发下载
- 文件名格式：`排查报告_项目名称_时间戳.docx`

**验收标准：**
- [x] 点击"导出"按钮，能成功下载 Word 文档
- [x] 文档内容完整，包含项目、系统类型、问题描述、排查步骤等
- [x] 文档格式清晰，标题层级分明
- [x] 文件名符合规范：`排查报告_厦门银行_20260712_143025.docx`

---

## 规范文档
- 代码规范: `Docs/PRD/01规范文档/_PRD_规范文档_代码规范.md`
- 文档规范: `Docs/PRD/01规范文档/_PRD_规范文档_文档规范.md`

## 优化功能回填
- [ ] 导出功能支持 PDF 格式
- [ ] 缓存命中率统计
- [ ] 导出模板自定义