chore: Clean up documentation and temporary test files

- Remove CHANGES.txt changelog and documentation files (WORKFLOW_INTEGRATION.md, WORKFLOW_INTEGRATION_SUMMARY.md, 阶段性分析报告.md)
- Delete temporary test HTML files from public directory (check-duplication.html, test-api.html, test-dedup.html)
- Remove vitest.config.ts and services/README.md
- Update README.md with comprehensive project summary and architecture documentation
- Refactor App.tsx component and related service modules (documentService, exportService, exportRecordService)
- Improve component implementations in ChatPanel, DocumentManagement, EditorPanel, MarkdownPreview, and WYSIWYGEditor
- Clean up obsolete configuration and documentation to streamline repository

CHANGES.txt

@@ -1,268 +0,0 @@
-================================================================================
-                    布局更新 - 修改文件清单
-================================================================================
-
-更新日期：2026-06-24
-版本：v2.0.0
-目标：实现图三所示的三栏布局（左侧聊天 + 右侧编辑 + 固定目录）
-
-================================================================================
-                         修改的代码文件（4个）
-================================================================================
-
-1. src/components/MarkdownEditor/MarkdownEditor.tsx
-   ✏️ 修改类型：重大更新
-   
-   变更内容：
-   - 将垂直布局（编辑+预览）改为水平布局（编辑+目录）
-   - 移除预览面板，改为纯编辑模式
-   - 将目录从 Drawer 抽屉改为固定侧边栏
-   - 移除 outlineVisible 状态和 toggleOutline 函数
-   - 移除 Drawer 和 UnorderedListOutlined 导入
-   - Toast UI Editor 设置为 previewStyle="tab" 和 hideModeSwitch={true}
-   
-   影响范围：
-   - 编辑器布局完全改变
-   - 用户交互方式改变
-   - 目录始终可见
-
-   代码行数变化：约 ±50 行
-
---------------------------------------------------------------------------------
-
-2. src/components/MarkdownEditor/MarkdownEditor.css
-   ➕ 文件类型：新增
-   
-   内容：
-   - 目录项样式（基础、悬停、激活）
-   - 标题层级样式（H1-H6 不同样式）
-   - 滚动条样式
-   - 空状态样式
-   - 响应式规则（不同屏幕尺寸）
-   
-   影响范围：
-   - 目录视觉效果
-   - 交互反馈
-   - 响应式显示
-
-   代码行数：约 80 行
-
---------------------------------------------------------------------------------
-
-3. src/stores/chatStore.ts
-   🐛 修改类型：Bug 修复
-   
-   变更内容：
-   第 19 行：
-   - 错误: import { exportDoc } from '../services/exportService';
-   - 正确: import { exportToWord } from '../services/exportService';
-   
-   第 XX 行（使用处）：
-   - 错误: await exportDoc({...})
-   - 正确: await exportToWord({...})
-   
-   影响范围：
-   - 解决模块导入错误
-   - 修复导出功能
-
-   代码行数变化：2 行
-
---------------------------------------------------------------------------------
-
-4. src/App.tsx
-   📝 修改类型：文档更新
-   
-   变更内容：
-   - 更新文件头部注释
-   - 添加新布局结构的 ASCII 图示
-   - 说明三栏布局的实现
-   
-   影响范围：
-   - 仅文档说明，不影响功能
-   
-   代码行数变化：+15 行
-
-================================================================================
-                         新增的文档文件（5个）
-================================================================================
-
-1. docs/EDITOR_LAYOUT.md
-   📄 类型：技术设计文档
-   内容：完整的布局设计说明、技术实现、样式规范
-   字数：约 3000 字
-
-2. docs/EDITOR_LAYOUT_TEST.md
-   📄 类型：测试文档
-   内容：详细的测试用例、步骤、预期结果、兼容性测试
-   字数：约 2500 字
-
-3. docs/LAYOUT_COMPARISON.md
-   📄 类型：对比分析
-   内容：新旧布局的详细对比、用户场景分析、数据对比
-   字数：约 2000 字
-
-4. CHANGELOG_LAYOUT.md
-   📄 类型：变更日志
-   内容：完整的更新记录、功能列表、问题修复、未来计划
-   字数：约 2200 字
-
-5. UPDATE_SUMMARY.md
-   📄 类型：快速总结
-   内容：一页纸的更新总结、核心变化、测试清单
-   字数：约 1500 字
-
-6. QUICK_START.md
-   📄 类型：快速指南
-   内容：3步启动指南、功能测试、常见问题
-   字数：约 1000 字
-
-7. CHANGES.txt
-   📄 类型：修改清单
-   内容：本文件，简明的修改列表
-   字数：约 500 字
-
-================================================================================
-                            修改统计
-================================================================================
-
-代码文件修改：
-  - 修改文件：3 个（MarkdownEditor.tsx, chatStore.ts, App.tsx）
-  - 新增文件：1 个（MarkdownEditor.css）
-  - 删除文件：0 个
-  - 总计：4 个代码文件
-
-文档文件新增：
-  - 技术文档：2 个
-  - 测试文档：1 个
-  - 对比文档：1 个
-  - 总结文档：3 个
-  - 总计：7 个文档文件
-
-代码行数变化：
-  - 新增：约 130 行
-  - 修改：约 50 行
-  - 删除：约 30 行
-  - 净增：约 150 行
-
-================================================================================
-                          核心功能变更
-================================================================================
-
-✅ 已移除：
-  - Markdown 预览面板
-  - 预览/编辑模式切换按钮
-  - 目录抽屉（Drawer）
-  - 目录切换按钮
-
-✅ 已新增：
-  - 固定目录侧边栏（280px）
-  - 目录层级样式
-  - 目录悬停效果
-  - 响应式目录显示
-
-✅ 已改进：
-  - 编辑空间增加约 80%
-  - 目录访问便捷性提升
-  - 工作流程简化
-  - 用户体验优化
-
-================================================================================
-                          重要提示
-================================================================================
-
-⚠️ 破坏性变更：
-  - 无破坏性变更
-  - 所有 API 保持兼容
-  - 组件属性未改变
-
-⚠️ 用户影响：
-  - 不再有预览功能
-  - 目录始终显示（桌面设备）
-  - 工具栏布局略有变化
-
-⚠️ 浏览器要求：
-  - 支持 CSS Flexbox
-  - 支持 CSS Grid（可选）
-  - 支持 ES6+
-
-⚠️ 性能影响：
-  - 移除预览渲染，性能可能提升
-  - 目录实时更新，CPU 占用略增
-  - 整体性能影响：中性偏正面
-
-================================================================================
-                          验证清单
-================================================================================
-
-编译验证：
-  ✅ TypeScript 编译通过（npx tsc --noEmit）
-  ✅ 无 ESLint 错误
-  ✅ 无 TypeScript 类型错误
-
-功能验证：
-  ⏳ 应用启动测试（需手动）
-  ⏳ 布局显示测试（需手动）
-  ⏳ 目录功能测试（需手动）
-  ⏳ 编辑器功能测试（需手动）
-  ⏳ 导出功能测试（需手动）
-
-兼容性验证：
-  ⏳ Chrome 测试（需手动）
-  ⏳ Firefox 测试（需手动）
-  ⏳ Safari 测试（需手动）
-  ⏳ Edge 测试（需手动）
-
-================================================================================
-                          快速启动
-================================================================================
-
-1. 启动开发服务器：
-   cd ax-frontend-app
-   npm run dev
-
-2. 打开浏览器：
-   http://localhost:5173
-
-3. 查看布局：
-   应该看到左侧聊天 + 中间编辑 + 右侧目录的三栏布局
-
-4. 测试功能：
-   - 输入 Markdown 文本
-   - 查看右侧目录自动生成
-   - 点击目录项跳转
-   - 测试保存和导出
-
-================================================================================
-                          相关资源
-================================================================================
-
-详细文档：
-  - 设计文档：docs/EDITOR_LAYOUT.md
-  - 测试指南：docs/EDITOR_LAYOUT_TEST.md
-  - 对比分析：docs/LAYOUT_COMPARISON.md
-
-快速文档：
-  - 更新总结：UPDATE_SUMMARY.md
-  - 快速指南：QUICK_START.md
-  - 变更日志：CHANGELOG_LAYOUT.md
-
-在线资源：
-  - Toast UI Editor: https://github.com/nhn/tui.editor
-  - Ant Design: https://ant.design
-  - React 文档: https://react.dev
-
-================================================================================
-                          联系方式
-================================================================================
-
-技术支持：[待填写]
-问题反馈：[待填写]
-功能建议：[待填写]
-
-================================================================================
-
-最后更新：2026-06-24
-文档版本：1.0
-状态：✅ 开发完成，等待测试
-
-================================================================================

docs/WORKFLOW_INTEGRATION.md

@@ -1,456 +0,0 @@
-# 工作流集成文档 (Workflow Integration)
-
-## 概述
-
-本文档描述了外部AI平台工作流与AX文档编辑器前端的集成。通过此集成，用户可以在聊天界面输入自然语言指令（如"生成一个地质报告"），系统会自动触发工作流，生成文档并返回可下载的URL链接。
-
-## 架构设计
-
-### 整体流程图
-
-```
-用户输入（聊天）
-    ↓
-Chat Store (检查是否触发工作流)
-    ↓
-Workflow Service (调用外部AI平台 v2 API)
-    ↓
-外部工作流平台 (http://114.242.25.27:3000/api/v2/chat/completions)
-    ↓
-本地后端 API (http://192.168.0.200:8000/api/v1/export/records)
-    ↓
-返回导出记录 (Export Record with downloadUrl)
-    ↓
-在聊天中显示文档卡片
-    ↓
-用户点击查看/下载文档
-```
-
-## 核心组件
-
-### 1. Workflow Service (`src/services/workflowService.ts`)
-
-**作用**: 处理与外部工作流API的通信。
-
-**关键函数**:
-
-#### `shouldTriggerWorkflow(input: string): boolean`
-判断用户输入是否应该触发文档生成工作流。
-
-**触发模式**:
-- **生成动作**: 生成、创建、制作、编写、generate、create
-- **文档类型**: 报告、文档、方案、总结、分析、report、document、doc
-
-**示例**:
-```typescript
-shouldTriggerWorkflow("生成一个地质报告") // true
-shouldTriggerWorkflow("创建技术文档")     // true
-shouldTriggerWorkflow("你好")           // false
-```
-
-#### `triggerDocumentWorkflow(userInput: string, chatId: string)`
-调用工作流API生成文档并返回导出记录。
-
-**API端点**:
-```
-POST http://114.242.25.27:3000/api/v2/chat/completions
-```
-
-**请求头**:
-```
-Content-Type: application/json
-Authorization: Bearer XAgent-mWHBqQw06psUYRqx6PrHWiKdfY05ebt7I9drDBHzaG9QQesIkVEICj
-```
-
-**请求体**:
-```json
-{
-  "chatId": "session-uuid",
-  "stream": false,
-  "detail": false,
-  "messages": [
-    {
-      "role": "user",
-      "content": "生成一个地质报告"
-    }
-  ]
-}
-```
-
-**响应格式**:
-```json
-{
-  "content": "已为您生成地质报告",
-  "exportRecord": {
-    "recordId": "rec-e22bbf07350d",
-    "userId": "default-user",
-    "fileName": "地质报告_1782369497876.doc",
-    "fileSize": 39076,
-    "downloadUrl": "http://192.168.0.200:8000/api/v1/export/records/rec-e22bbf07350d/download?userId=default-user",
-    "documentId": "doc-d2ef5b701b5c",
-    "styleId": "default",
-    "createdAt": 1782369497764
-  }
-}
-```
-
-或者数组格式：
-```json
-{
-  "content": "已为您生成地质报告",
-  "records": [
-    {
-      "recordId": "rec-e22bbf07350d",
-      ...
-    }
-  ]
-}
-```
-
-### 2. Chat Store (`src/stores/chatStore.ts`)
-
-**修改内容**:
-
-#### 导入工作流服务
-```typescript
-import { shouldTriggerWorkflow, triggerDocumentWorkflow } from '../services/workflowService';
-```
-
-#### 修改 `sendMessage` 函数
-```typescript
-// 检查是否需要触发工作流
-const shouldUseWorkflow = shouldTriggerWorkflow(content);
-
-if (shouldUseWorkflow) {
-  // 使用工作流生成文档
-  const workflowResult = await triggerDocumentWorkflow(content, sessionId);
-  aiResponse = workflowResult.content;
-  exportRecord = workflowResult.exportRecord;
-} else {
-  // 使用常规AI服务
-  const aiResult = await getAIResponse(content, sessionId, get().messages);
-  aiResponse = aiResult.response;
-}
-
-// 创建AI消息并附加导出记录
-const aiMessage: ChatMessage = {
-  id: uuidv4(),
-  role: 'assistant',
-  content: aiResponse,
-  timestamp: Date.now(),
-  exportRecord: exportRecord, // 附加导出记录
-};
-```
-
-### 3. Message Item Component (`src/components/ChatPanel/MessageItem.tsx`)
-
-**功能**: 已有支持渲染导出记录为可点击文档卡片。
-
-当消息中包含 `exportRecord` 时，会显示一个文档卡片：
-- Word图标
-- 文件名
-- "点击预览文档"文本
-- 眼睛图标
-
-用户点击卡片会触发 `onDocumentClick` 回调。
-
-### 4. App Component (`src/App.tsx`)
-
-**功能**: 处理文档点击事件，在编辑器中打开文档。
-
-```typescript
-const handleDocumentClick = useCallback((exportRecord: ExportRecordInfo) => {
-  setPreviewDocument({
-    downloadUrl: exportRecord.downloadUrl,
-    fileName: exportRecord.fileName,
-    recordId: exportRecord.recordId,
-    userId: exportRecord.userId,
-    documentId: exportRecord.documentId,
-  });
-  setPreviewMode('editor');
-}, []);
-```
-
-## 配置
-
-### 环境变量
-
-在 `.env` 文件中添加：
-
-```bash
-# 工作流API配置
-# 工作流API URL（v2 - 带工作流）
-VITE_WORKFLOW_API_URL=http://114.242.25.27:3000/api/v2/chat/completions
-
-# 工作流API密钥
-VITE_WORKFLOW_API_KEY=XAgent-mWHBqQw06psUYRqx6PrHWiKdfY05ebt7I9drDBHzaG9QQesIkVEICj
-```
-
-在 `.env.example` 文件中添加（示例）：
-
-```bash
-# 工作流API配置
-VITE_WORKFLOW_API_URL=http://114.242.25.27:3000/api/v2/chat/completions
-VITE_WORKFLOW_API_KEY=your_workflow_api_key_here
-```
-
-## 使用方法
-
-### 终端用户使用
-
-1. **打开聊天面板**
-2. **输入文档生成请求**，例如：
-   - "生成一个地质报告"
-   - "创建技术文档"
-   - "制作项目分析报告"
-   
-3. **系统自动处理**：
-   - 检测到文档生成请求
-   - 触发工作流
-   - 调用外部AI平台
-   - 生成文档
-   - 返回导出记录
-   
-4. **查看结果**：
-   - AI回复消息
-   - 文档卡片出现在消息下方
-   - 显示文件名和预览按钮
-   
-5. **点击文档卡片**：
-   - 在编辑器中打开文档
-   - 或在新标签页下载文档
-
-### 触发条件示例
-
-✅ **会触发工作流**:
-- "生成一个地质报告"
-- "创建技术文档"
-- "制作项目分析报告"
-- "编写总结文档"
-- "generate a report"
-
-❌ **不会触发工作流**:
-- "你好" (无生成动作或文档类型)
-- "生成图片" (无文档类型关键词)
-- "打开文档" (无生成动作)
-- "分析一下数据" (无生成动作)
-
-## 错误处理
-
-### 优雅降级
-
-工作流集成设计为优雅降级：
-
-1. **API密钥未配置**:
-   - 跳过工作流
-   - 控制台警告
-   - 返回提示消息
-
-2. **工作流API调用失败**:
-   - 错误记录到控制台
-   - 返回错误消息给用户
-   - 不中断聊天体验
-
-3. **工作流未返回导出记录**:
-   - 控制台警告
-   - 显示AI响应
-   - 不显示文档卡片
-
-### 调试日志
-
-在浏览器控制台可以看到工作流执行日志：
-
-- `🔄 Using workflow for document generation` - 开始使用工作流
-- `🔄 Triggering document generation workflow...` - 触发工作流
-- `📝 User input: 生成一个地质报告` - 用户输入
-- `✅ Workflow response received:` - 收到工作流响应
-- `📄 Export record extracted:` - 提取导出记录
-- `⚠️ No export record found in workflow response` - 未找到导出记录
-- `❌ Workflow API error:` - 工作流API错误
-
-## 测试
-
-### 手动测试步骤
-
-1. **启动开发服务器**:
-   ```bash
-   cd d:\work space\ax-shell\ax-frontend-app
-   npm run dev
-   ```
-
-2. **打开应用**: 浏览器访问 `http://localhost:5173`
-
-3. **创建新会话**: 点击聊天面板
-
-4. **输入文档生成请求**:
-   ```
-   生成一个地质报告
-   ```
-
-5. **验证工作流**:
-   - 检查浏览器控制台日志
-   - 等待AI响应
-   - 查看消息下方的文档卡片
-   - 验证文件名显示正确
-
-6. **测试文档下载**:
-   - 点击文档卡片
-   - 文档应在编辑器中打开
-   - 或在新标签页下载
-
-### 预期行为
-
-1. 用户输入："生成一个地质报告"
-2. 聊天显示加载指示器
-3. 工作流在后台触发
-4. AI响应显示
-5. 文档卡片出现，显示：
-   - 文件图标
-   - 文件名（例如："地质报告_1782369497876.doc"）
-   - "点击预览文档"文本
-6. 点击卡片在编辑器中打开文档
-7. 显示成功提示："✅ 文档已生成，点击下方卡片查看"
-
-## 后端集成
-
-### 导出记录API
-
-工作流内部调用本地后端导出记录API：
-
-```
-GET http://192.168.0.200:8000/api/v1/export/records?userId=default-user&page=1&pageSize=20
-```
-
-此API返回生成的导出记录列表，工作流将其转发给前端。
-
-### 文档下载
-
-文档通过以下端点下载：
-
-```
-GET http://192.168.0.200:8000/api/v1/export/records/{recordId}/download?userId={userId}
-```
-
-## 工作流平台配置
-
-### 工作流设置
-
-在外部AI平台 (http://114.242.25.27:3000) 中，工作流应该配置为：
-
-1. **接收用户输入**: 从聊天消息中提取文档生成请求
-2. **处理请求**: 根据请求类型（地质报告、技术文档等）生成文档
-3. **调用后端API**: 调用 `http://192.168.0.200:8000/api/v1/export/records`
-4. **返回结果**: 将导出记录数据返回给前端
-
-### API响应格式
-
-工作流API应该返回以下格式之一：
-
-**格式1：单个导出记录**
-```json
-{
-  "content": "AI响应文本",
-  "exportRecord": {
-    "recordId": "rec-xxx",
-    "fileName": "地质报告_xxx.doc",
-    "downloadUrl": "http://192.168.0.200:8000/api/v1/export/records/rec-xxx/download?userId=xxx",
-    "documentId": "doc-xxx",
-    "userId": "default-user",
-    "fileSize": 39076,
-    "styleId": "default",
-    "createdAt": 1782369497764
-  }
-}
-```
-
-**格式2：导出记录数组**
-```json
-{
-  "content": "AI响应文本",
-  "records": [
-    {
-      "recordId": "rec-xxx",
-      "fileName": "地质报告_xxx.doc",
-      "downloadUrl": "http://...",
-      ...
-    }
-  ]
-}
-```
-
-## 安全考虑
-
-1. **API密钥存储**: 
-   - 存储在环境变量中
-   - 不提交到版本控制
-   - `.env.example` 中使用占位符
-
-2. **身份验证**:
-   - 使用 `Bearer` token 进行工作流认证
-   - 每个请求包含用户ID用于授权
-
-3. **CORS**:
-   - 工作流API必须允许来自前端源的CORS
-   - 后端API必须允许来自前端源的CORS
-
-## 故障排查
-
-### 问题：工作流未触发
-
-**检查**:
-1. `.env` 中是否设置了 `VITE_WORKFLOW_API_KEY`？
-2. 输入是否匹配触发模式？
-3. 检查浏览器控制台错误
-4. 验证工作流API可访问性
-
-### 问题：未显示文档链接
-
-**检查**:
-1. 工作流是否返回了记录？检查控制台日志
-2. `exportRecord` 是否正确附加到消息？
-3. 检查网络标签中的工作流API响应
-4. 验证响应格式是否匹配预期结构
-
-### 问题：文档下载失败
-
-**检查**:
-1. 后端API是否运行？
-2. 下载URL是否包含正确的记录ID？
-3. 检查后端日志错误
-4. 验证文件在服务器上存在
-
-## 未来增强
-
-1. **多文档生成**: 
-   - 支持一次请求生成多个文档
-   - 显示多个文档卡片
-
-2. **文档模板**:
-   - 允许用户在生成前选择模板
-   - 将模板ID传递给工作流
-
-3. **进度指示**:
-   - 显示文档生成进度条
-   - 显示预计剩余时间
-
-4. **重试逻辑**:
-   - 工作流失败时自动重试
-   - 指数退避策略
-
-5. **文档预览**:
-   - 聊天中内联文档预览
-   - 下载前预览
-
-## 相关文档
-
-- [导出记录API](../../ax-backend-shell/docs/text-editor-backend-api.md)
-- [聊天面板架构](./text-editor-architecture.md)
-- [导出服务设计](./export-doc-content-mapping.md)
-
-## 版本历史
-
-- **v1.0** (2026-06-25): 工作流集成初始实现
-  - 添加工作流服务
-  - 集成到聊天store
-  - 更新消息渲染
-  - 添加环境配置

docs/WORKFLOW_INTEGRATION_SUMMARY.md

@@ -1,562 +0,0 @@
-# Workflow Integration Summary
-
-## 概述
-
-本文档说明了如何将外部 AI 工作流平台与前端聊天功能集成，实现"输入文字 → 生成文档 → 返回链接"的完整流程。
-
----
-
-## 功能流程
-
-```
-用户输入: "生成一个地质报告"
-    ↓
-前端检测关键词 (chatStore.ts)
-    ↓
-调用工作流 API (workflowService.ts)
-    ↓
-工作流平台处理
-    ↓
-工作流调用本地后端 API
-    ↓
-返回导出记录 JSON
-    ↓
-前端解析并显示文档卡片 (MessageItem.tsx)
-    ↓
-用户点击卡片
-    ↓
-打开文档预览 (DocumentViewerLayout.tsx)
-```
-
----
-
-## 核心组件
-
-### 1. 环境变量配置 (.env)
-
-```env
-# 本地后端 API
-VITE_API_BASE_URL=http://192.168.0.195:8000
-
-# 工作流 API
-VITE_WORKFLOW_API_URL=http://114.242.25.27:3000/api/v2/chat/completions
-VITE_WORKFLOW_API_KEY=XAgent-mWHBqQw06psUYRqx6PrHWiKdfY05ebt7I9drDBHzaG9QQesIkVEICj
-```
-
-**重要**: 修改 `.env` 后必须重启开发服务器！
-
-```bash
-# 停止服务器
-Ctrl+C
-
-# 重新启动
-npm run dev
-
-# 清除浏览器缓存
-Ctrl+Shift+Delete
-```
-
----
-
-### 2. 工作流服务 (workflowService.ts)
-
-**位置**: `src/services/workflowService.ts`
-
-**功能**:
-- 检测用户输入是否需要生成文档 (`shouldTriggerWorkflow`)
-- 调用外部工作流 API (`triggerDocumentWorkflow`)
-- 解析返回的导出记录信息
-- 提取文档类型 (`extractReportType`)
-
-**关键函数**:
-
-```typescript
-// 检测是否应该触发工作流
-export const shouldTriggerWorkflow = (input: string): boolean => {
-  const lowerInput = input.toLowerCase().trim();
-  
-  const generatePatterns = ['生成', '创建', '制作', '编写'];
-  const documentPatterns = ['报告', '文档', '方案', '总结'];
-  
-  const hasGenerateAction = generatePatterns.some(p => lowerInput.includes(p));
-  const hasDocumentType = documentPatterns.some(p => lowerInput.includes(p));
-  
-  return hasGenerateAction && hasDocumentType;
-};
-
-// 调用工作流生成文档
-export const triggerDocumentWorkflow = async (
-  userInput: string,
-  chatId: string
-): Promise<{ content: string; exportRecord?: ExportRecordInfo }> => {
-  // 调用外部 API
-  const response = await fetch(config.apiUrl, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${config.apiKey}`,
-    },
-    body: JSON.stringify({
-      chatId,
-      stream: false,
-      detail: false,
-      messages: [{ role: 'user', content: userInput }],
-    }),
-  });
-  
-  const data = await response.json();
-  
-  // 解析导出记录
-  // 可能在 data.content (JSON字符串)
-  // 或 data.exportRecord (对象)
-  // 或 data.records (数组)
-  
-  return { content, exportRecord };
-};
-```
-
----
-
-### 3. 聊天状态管理 (chatStore.ts)
-
-**位置**: `src/stores/chatStore.ts`
-
-**集成点**: `sendMessage` 函数
-
-```typescript
-sendMessage: async (content: string) => {
-  // 创建用户消息
-  const userMessage = { ... };
-  
-  // 检查是否需要触发工作流
-  const shouldUseWorkflow = shouldTriggerWorkflow(content);
-  
-  let aiResponse: string;
-  let exportRecord: ExportRecordInfo | undefined;
-  
-  if (shouldUseWorkflow) {
-    // 使用工作流生成文档
-    const result = await triggerDocumentWorkflow(content, sessionId);
-    aiResponse = result.content;
-    exportRecord = result.exportRecord;
-  } else {
-    // 使用普通 AI 聊天
-    const result = await getAIResponse(content, sessionId, messages);
-    aiResponse = result.response;
-  }
-  
-  // 创建 AI 消息（带有 exportRecord）
-  const aiMessage = {
-    id: uuidv4(),
-    role: 'assistant',
-    content: aiResponse,
-    timestamp: Date.now(),
-    exportRecord: exportRecord,  // 关键！
-  };
-  
-  // 添加到消息列表
-  set(state => ({
-    messages: [...state.messages, aiMessage],
-  }));
-  
-  // 如果有文档生成，显示成功提示
-  if (exportRecord) {
-    message.success('✅ 文档已生成，点击下方卡片查看');
-  }
-}
-```
-
----
-
-### 4. 消息显示组件 (MessageItem.tsx)
-
-**位置**: `src/components/ChatPanel/MessageItem.tsx`
-
-**功能**:
-- 显示聊天消息气泡
-- 如果消息包含 `exportRecord`，显示可点击的文档卡片
-- 点击卡片触发 `onDocumentClick` 回调
-
-```typescript
-const MessageItem: React.FC<MessageItemProps> = ({ 
-  message, 
-  onDocumentClick 
-}) => {
-  const { content, exportRecord } = message;
-  
-  return (
-    <div>
-      {/* 消息气泡 */}
-      <div>{content}</div>
-      
-      {/* 文档卡片（如果有 exportRecord） */}
-      {exportRecord && (
-        <Card
-          onClick={() => onDocumentClick?.(exportRecord)}
-          hoverable
-        >
-          <FileWordOutlined />
-          <div>
-            <Text>📄 {exportRecord.fileName}</Text>
-            <Text>点击预览文档</Text>
-          </div>
-          <EyeOutlined />
-        </Card>
-      )}
-    </div>
-  );
-};
-```
-
----
-
-### 5. 文档内容解析 (documentContentService.ts)
-
-**位置**: `src/services/documentContentService.ts`
-
-**更新内容**: 现在真实下载并解析 Word 文档
-
-```typescript
-export const fetchDocumentStructure = async (
-  recordId: string,
-  userId: string
-): Promise<DocumentStructure> => {
-  // 1. 构建下载 URL
-  const baseUrl = import.meta.env.VITE_API_BASE_URL;
-  const downloadUrl = `${baseUrl}/api/v1/export/records/${recordId}/download?userId=${userId}`;
-  
-  // 2. 下载 Word 文件
-  const response = await fetch(downloadUrl);
-  const blob = await response.blob();
-  const arrayBuffer = await blob.arrayBuffer();
-  
-  // 3. 使用 mammoth.js 解析
-  const mammoth = await import('mammoth');
-  const result = await mammoth.convertToHtml({ arrayBuffer });
-  
-  // 4. 解析 HTML 提取结构
-  const parser = new DOMParser();
-  const doc = parser.parseFromString(result.value, 'text/html');
-  
-  // 5. 提取标题、段落、表格
-  const outline: OutlineItem[] = [];
-  const content: ContentBlock[] = [];
-  
-  doc.body.querySelectorAll('*').forEach(element => {
-    if (element.tagName.match(/^H[1-6]$/)) {
-      // 处理标题
-    } else if (element.tagName === 'P') {
-      // 处理段落
-    } else if (element.tagName === 'TABLE') {
-      // 处理表格
-    }
-  });
-  
-  return { recordId, fileName, outline, content, metadata };
-};
-```
-
-**依赖**: mammoth.js (已在 package.json 中安装)
-
----
-
-## 工作流 API 响应格式
-
-工作流平台可能返回以下格式之一：
-
-### 格式 1: JSON 字符串在 content 中
-
-```json
-{
-  "content": "{\"records\":[{\"recordId\":\"rec-xxx\",\"fileName\":\"地质报告.doc\",\"downloadUrl\":\"http://...\",\"documentId\":\"doc-xxx\"}]}",
-  "choices": [...]
-}
-```
-
-### 格式 2: 顶层 exportRecord 对象
-
-```json
-{
-  "content": "文档已生成",
-  "exportRecord": {
-    "recordId": "rec-xxx",
-    "fileName": "地质报告.doc",
-    "downloadUrl": "http://...",
-    "documentId": "doc-xxx"
-  }
-}
-```
-
-### 格式 3: 顶层 records 数组
-
-```json
-{
-  "content": "文档已生成",
-  "records": [
-    {
-      "recordId": "rec-xxx",
-      "fileName": "地质报告.doc",
-      "downloadUrl": "http://...",
-      "documentId": "doc-xxx"
-    }
-  ]
-}
-```
-
-**workflowService.ts 会自动处理所有这些格式！**
-
----
-
-## 后端 API 端点
-
-### 1. 获取导出记录列表
-
-```
-GET http://192.168.0.195:8000/api/v1/export/records?userId=default-user&page=1&pageSize=20
-```
-
-**响应**:
-```json
-{
-  "records": [
-    {
-      "recordId": "rec-xxx",
-      "userId": "default-user",
-      "fileName": "地质报告.doc",
-      "fileSize": 39076,
-      "downloadUrl": "http://192.168.0.195:8000/api/v1/export/records/rec-xxx/download?userId=default-user",
-      "documentId": "doc-xxx",
-      "styleId": "default",
-      "createdAt": 1782369497764
-    }
-  ],
-  "pagination": { ... }
-}
-```
-
-### 2. 下载文档
-
-```
-GET http://192.168.0.195:8000/api/v1/export/records/{recordId}/download?userId={userId}
-```
-
-**响应**: Word 文档二进制数据 (application/vnd.openxmlformats-officedocument.wordprocessingml.document)
-
----
-
-## 类型定义
-
-### ExportRecordInfo
-
-```typescript
-export interface ExportRecordInfo {
-  recordId: string;      // 导出记录 ID
-  fileName: string;      // 文件名
-  downloadUrl: string;   // 下载 URL
-  documentId: string;    // 文档 ID
-}
-```
-
-### ChatMessage
-
-```typescript
-export interface ChatMessage {
-  id: string;
-  role: 'user' | 'assistant';
-  content: string;
-  timestamp: number;
-  documentId?: string;
-  exportRecord?: ExportRecordInfo;  // 关键字段！
-}
-```
-
----
-
-## 测试流程
-
-### 1. 启动后端服务
-
-```bash
-cd ax-backend-shell
-python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
-```
-
-确保后端运行在 `http://192.168.0.195:8000`
-
-### 2. 启动前端服务
-
-```bash
-cd ax-frontend-app
-npm run dev
-```
-
-前端运行在 `http://localhost:5173`
-
-### 3. 测试工作流集成
-
-在聊天面板输入：
-
-- ✅ "生成一个地质报告" → 应触发工作流
-- ✅ "创建技术文档" → 应触发工作流
-- ✅ "制作项目方案" → 应触发工作流
-- ❌ "你好" → 不触发工作流，普通聊天
-- ❌ "什么是地质报告" → 不触发工作流，普通聊天
-
-### 4. 验证文档显示
-
-1. 触发工作流后，应该看到：
-   - AI 回复消息
-   - 下方显示文档卡片
-   - 卡片包含文件名和"点击预览文档"
-
-2. 点击文档卡片后：
-   - 打开文档查看器
-   - 左侧显示文档大纲
-   - 中间显示文档内容（标题、段落、表格）
-   - 右侧显示写入/预览切换
-
----
-
-## 常见问题
-
-### Q1: 修改 .env 后没有生效？
-
-**A**: Vite 不会热重载环境变量，必须重启开发服务器：
-
-```bash
-# 停止
-Ctrl+C
-
-# 启动
-npm run dev
-
-# 清除浏览器缓存
-Ctrl+Shift+Delete → 清除缓存和 Cookie → 清除数据
-```
-
-### Q2: 工作流没有被触发？
-
-**A**: 检查关键词匹配逻辑：
-
-```typescript
-// 必须同时包含"生成类"词汇和"文档类"词汇
-生成 + 报告 ✅
-创建 + 文档 ✅
-制作 + 方案 ✅
-生成 + 什么 ❌  (没有文档类词汇)
-报告 + 是什么 ❌  (没有生成类词汇)
-```
-
-### Q3: 文档内容显示为空？
-
-**A**: 可能的原因：
-
-1. **网络问题**: 检查后端 API 是否可访问
-   ```bash
-   curl http://192.168.0.195:8000/api/v1/export/records/{recordId}/download?userId=default-user
-   ```
-
-2. **CORS 问题**: 检查浏览器控制台是否有 CORS 错误
-
-3. **文档格式问题**: mammoth.js 只支持 .docx 格式，不支持旧的 .doc 格式
-
-### Q4: 工作流返回的数据格式不对？
-
-**A**: workflowService.ts 支持多种格式：
-
-1. JSON 字符串在 `content` 字段
-2. 对象在 `exportRecord` 字段
-3. 数组在 `records` 字段
-
-如果都不匹配，检查实际返回数据：
-
-```typescript
-console.log('[workflowService] Response:', data);
-```
-
----
-
-## 架构图
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                         Frontend (React)                         │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  ┌──────────────┐      ┌──────────────┐     ┌─────────────┐   │
-│  │  ChatPanel   │─────▶│  chatStore   │────▶│ MessageItem │   │
-│  │  (用户输入)   │      │  (状态管理)   │     │ (显示卡片)   │   │
-│  └──────────────┘      └──────┬───────┘     └─────────────┘   │
-│                               │                                 │
-│                               ▼                                 │
-│                    ┌──────────────────┐                        │
-│                    │ workflowService  │                        │
-│                    │ (检测&调用工作流) │                        │
-│                    └─────────┬────────┘                        │
-└──────────────────────────────┼─────────────────────────────────┘
-                               │
-                               ▼
-┌─────────────────────────────────────────────────────────────────┐
-│              External AI Platform (工作流平台)                    │
-│  http://114.242.25.27:3000/api/v2/chat/completions             │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  1. 接收用户请求                                                  │
-│  2. 生成文档内容                                                  │
-│  3. 调用本地后端 API                                              │
-│  4. 返回导出记录                                                  │
-│                                                                  │
-└──────────────────────────────┬──────────────────────────────────┘
-                               │
-                               ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                Local Backend API (FastAPI)                      │
-│             http://192.168.0.195:8000                           │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  GET  /api/v1/export/records                                    │
-│  GET  /api/v1/export/records/{recordId}/download                │
-│  POST /api/v1/export                                            │
-│                                                                  │
-└─────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 文件清单
-
-### 核心文件
-
-- ✅ `.env` - 环境变量配置
-- ✅ `src/services/workflowService.ts` - 工作流服务
-- ✅ `src/stores/chatStore.ts` - 聊天状态管理
-- ✅ `src/components/ChatPanel/MessageItem.tsx` - 消息显示
-- ✅ `src/services/documentContentService.ts` - 文档内容解析
-- ✅ `src/types/chat.ts` - 类型定义
-
-### 文档
-
-- ✅ `docs/WORKFLOW_INTEGRATION_SUMMARY.md` - 本文档
-
----
-
-## 下一步改进
-
-1. **错误处理增强**
-   - 工作流 API 失败时的友好提示
-   - 文档解析失败时的降级方案
-
-2. **性能优化**
-   - 文档缓存机制
-   - 大文档分页加载
-
-3. **功能扩展**
-   - 支持更多文档格式 (PDF, Excel)
-   - 文档编辑功能
-   - 版本历史
-
----
-
-**文档版本**: 1.0  
-**最后更新**: 2026-06-25  
-**维护者**: AX Team

public/check-duplication.html

@@ -1,334 +0,0 @@
-<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>文档重复检查工具</title>
-    <style>
-        body {
-            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
-            max-width: 1200px;
-            margin: 0 auto;
-            padding: 20px;
-            background: #f5f5f5;
-        }
-        .container {
-            background: white;
-            padding: 30px;
-            border-radius: 8px;
-            box-shadow: 0 2px 8px rgba(0,0,0,0.1);
-        }
-        h1 {
-            color: #333;
-            border-bottom: 3px solid #1890ff;
-            padding-bottom: 10px;
-        }
-        .section {
-            margin: 20px 0;
-            padding: 15px;
-            background: #fafafa;
-            border-left: 4px solid #1890ff;
-            border-radius: 4px;
-        }
-        .input-group {
-            margin: 15px 0;
-        }
-        label {
-            display: block;
-            margin-bottom: 5px;
-            font-weight: 600;
-            color: #555;
-        }
-        input, select {
-            width: 100%;
-            padding: 10px;
-            border: 1px solid #d9d9d9;
-            border-radius: 4px;
-            font-size: 14px;
-            box-sizing: border-box;
-        }
-        button {
-            background: #1890ff;
-            color: white;
-            border: none;
-            padding: 12px 24px;
-            border-radius: 4px;
-            cursor: pointer;
-            font-size: 14px;
-            font-weight: 600;
-            margin-right: 10px;
-            margin-top: 10px;
-        }
-        button:hover {
-            background: #40a9ff;
-        }
-        button:disabled {
-            background: #d9d9d9;
-            cursor: not-allowed;
-        }
-        .results {
-            margin-top: 20px;
-        }
-        .result-box {
-            background: white;
-            border: 1px solid #e8e8e8;
-            padding: 15px;
-            margin: 10px 0;
-            border-radius: 4px;
-            white-space: pre-wrap;
-            font-family: 'Courier New', monospace;
-            font-size: 12px;
-            max-height: 400px;
-            overflow-y: auto;
-        }
-        .success {
-            color: #52c41a;
-            font-weight: 600;
-        }
-        .error {
-            color: #ff4d4f;
-            font-weight: 600;
-        }
-        .warning {
-            color: #faad14;
-            font-weight: 600;
-        }
-        .info {
-            color: #1890ff;
-            font-weight: 600;
-        }
-        .stat {
-            display: inline-block;
-            background: #e6f7ff;
-            padding: 5px 15px;
-            margin: 5px 5px 5px 0;
-            border-radius: 20px;
-            font-size: 13px;
-            font-weight: 600;
-            color: #0050b3;
-        }
-    </style>
-</head>
-<body>
-    <div class="container">
-        <h1>🔍 文档重复检查工具</h1>
-        
-        <div class="section">
-            <h3>步骤 1: 从数据库获取文档</h3>
-            <div class="input-group">
-                <label>后端 API 地址:</label>
-                <input type="text" id="apiBase" value="http://192.168.0.195:8000" />
-            </div>
-            <div class="input-group">
-                <label>文档 ID:</label>
-                <input type="text" id="documentId" placeholder="例如: doc-7791bc371ad7" />
-            </div>
-            <button onclick="fetchDocument()">获取文档</button>
-            <button onclick="fetchLatestDocument()">获取最新文档</button>
-        </div>
-
-        <div class="section">
-            <h3>步骤 2: 检查导出的Word文件</h3>
-            <div class="input-group">
-                <label>导出记录 ID:</label>
-                <input type="text" id="recordId" placeholder="例如: rec-xxx" />
-            </div>
-            <div class="input-group">
-                <label>用户 ID:</label>
-                <input type="text" id="userId" value="default-user" />
-            </div>
-            <button onclick="checkExportedWord()">下载并检查Word文件</button>
-        </div>
-
-        <div id="results" class="results"></div>
-    </div>
-
-    <script>
-        const API_BASE = () => document.getElementById('apiBase').value;
-
-        function showResult(message, type = 'info') {
-            const results = document.getElementById('results');
-            const box = document.createElement('div');
-            box.className = 'result-box';
-            box.innerHTML = `<span class="${type}">[${type.toUpperCase()}]</span> ${message}`;
-            results.appendChild(box);
-            results.scrollTop = results.scrollHeight;
-        }
-
-        async function fetchLatestDocument() {
-            showResult('正在获取最新文档...', 'info');
-            
-            try {
-                const response = await fetch(`${API_BASE()}/api/v1/documents?userId=default-user&page=1&pageSize=1&sortBy=createdAt&sortOrder=desc`);
-                
-                if (!response.ok) {
-                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-                }
-
-                const data = await response.json();
-                
-                if (data.code === 200 && data.data.documents.length > 0) {
-                    const doc = data.data.documents[0];
-                    document.getElementById('documentId').value = doc.id;
-                    showResult(`最新文档 ID: ${doc.id}`, 'success');
-                    
-                    // 自动获取文档详情
-                    await fetchDocument();
-                } else {
-                    showResult('未找到文档', 'warning');
-                }
-            } catch (error) {
-                showResult(`错误: ${error.message}`, 'error');
-            }
-        }
-
-        async function fetchDocument() {
-            const docId = document.getElementById('documentId').value;
-            
-            if (!docId) {
-                showResult('请输入文档ID', 'warning');
-                return;
-            }
-
-            showResult(`正在获取文档 ${docId}...`, 'info');
-            
-            try {
-                const response = await fetch(`${API_BASE()}/api/v1/documents/${docId}`);
-                
-                if (!response.ok) {
-                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-                }
-
-                const data = await response.json();
-                
-                if (data.code === 200) {
-                    const doc = data.data;
-                    const content = doc.content;
-                    
-                    showResult(`文档ID: ${doc.id}`, 'info');
-                    showResult(`格式: ${doc.format}`, 'info');
-                    showResult(`创建时间: ${new Date(doc.createdAt).toLocaleString()}`, 'info');
-                    
-                    // 统计信息
-                    const totalLength = content.length;
-                    const lines = content.split('\n');
-                    const totalLines = lines.length;
-                    
-                    showResult(`
-<span class="stat">总长度: ${totalLength} 字符</span>
-<span class="stat">总行数: ${totalLines} 行</span>
-                    `, 'info');
-                    
-                    // 检查是否有重复
-                    const halfLength = Math.floor(totalLength / 2);
-                    const firstHalf = content.substring(0, halfLength);
-                    const secondHalf = content.substring(halfLength);
-                    
-                    // 检查前500字符是否在后半部分重复出现
-                    const sample = content.substring(0, Math.min(500, halfLength));
-                    const isDuplicated = secondHalf.includes(sample);
-                    
-                    if (isDuplicated) {
-                        showResult('⚠️ 警告: 检测到内容可能重复！前500字符在后半部分也出现了', 'warning');
-                    } else {
-                        showResult('✓ 数据库内容没有重复', 'success');
-                    }
-                    
-                    // 显示前1000字符
-                    showResult('数据库中的前1000字符:\n' + content.substring(0, 1000), 'info');
-                    
-                    // 显示后500字符
-                    showResult('数据库中的后500字符:\n' + content.substring(totalLength - 500), 'info');
-                    
-                } else {
-                    showResult(`API错误: ${data.message}`, 'error');
-                }
-            } catch (error) {
-                showResult(`错误: ${error.message}`, 'error');
-            }
-        }
-
-        async function checkExportedWord() {
-            const recordId = document.getElementById('recordId').value;
-            const userId = document.getElementById('userId').value;
-            
-            if (!recordId || !userId) {
-                showResult('请输入导出记录ID和用户ID', 'warning');
-                return;
-            }
-
-            showResult(`正在下载并检查Word文件...`, 'info');
-            
-            try {
-                const downloadUrl = `${API_BASE()}/api/v1/export/records/${recordId}/download?userId=${encodeURIComponent(userId)}`;
-                showResult(`下载URL: ${downloadUrl}`, 'info');
-                
-                const response = await fetch(downloadUrl);
-                
-                if (!response.ok) {
-                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-                }
-
-                const blob = await response.blob();
-                const arrayBuffer = await blob.arrayBuffer();
-                
-                showResult(`Word文件大小: ${arrayBuffer.byteLength} bytes`, 'info');
-                
-                // 使用mammoth解析Word文件
-                showResult('正在解析Word文档...', 'info');
-                
-                // 动态加载mammoth库
-                if (typeof mammoth === 'undefined') {
-                    const script = document.createElement('script');
-                    script.src = 'https://cdn.jsdelivr.net/npm/mammoth@1.6.0/mammoth.browser.min.js';
-                    document.head.appendChild(script);
-                    
-                    await new Promise((resolve, reject) => {
-                        script.onload = resolve;
-                        script.onerror = reject;
-                    });
-                }
-                
-                const result = await mammoth.convertToHtml({ arrayBuffer });
-                const html = result.value;
-                
-                showResult(`HTML长度: ${html.length} 字符`, 'info');
-                
-                // 提取纯文本
-                const parser = new DOMParser();
-                const doc = parser.parseFromString(html, 'text/html');
-                const text = doc.body.textContent || '';
-                
-                showResult(`纯文本长度: ${text.length} 字符`, 'info');
-                
-                // 检查是否有重复
-                const lines = text.split('\n').filter(line => line.trim());
-                const halfPoint = Math.floor(lines.length / 2);
-                
-                let matchCount = 0;
-                for (let i = 0; i < Math.min(10, halfPoint); i++) {
-                    if (lines[i] === lines[halfPoint + i]) {
-                        matchCount++;
-                    }
-                }
-                
-                if (matchCount >= 8) {
-                    showResult(`⚠️ 警告: Word文件中检测到重复内容！前10行有${matchCount}行与后半部分匹配`, 'warning');
-                } else {
-                    showResult('✓ Word文件内容没有明显重复', 'success');
-                }
-                
-                // 显示前1000字符
-                showResult('Word文件的前1000字符:\n' + text.substring(0, 1000), 'info');
-                
-            } catch (error) {
-                showResult(`错误: ${error.message}`, 'error');
-                console.error(error);
-            }
-        }
-
-        // 初始化
-        showResult('工具已就绪。请使用上面的按钮检查文档。', 'success');
-    </script>
-</body>
-</html>

public/test-api.html

@@ -1,199 +0,0 @@
-<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>API 测试</title>
-    <style>
-        body {
-            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
-            max-width: 900px;
-            margin: 50px auto;
-            padding: 20px;
-            background: #f5f5f5;
-        }
-        .container {
-            background: white;
-            padding: 30px;
-            border-radius: 8px;
-            box-shadow: 0 2px 8px rgba(0,0,0,0.1);
-        }
-        button {
-            background: #1890ff;
-            color: white;
-            border: none;
-            padding: 10px 20px;
-            border-radius: 4px;
-            cursor: pointer;
-            font-size: 14px;
-            margin-right: 10px;
-        }
-        button:hover {
-            background: #40a9ff;
-        }
-        .result {
-            margin-top: 20px;
-            padding: 15px;
-            background: #f0f0f0;
-            border-radius: 4px;
-            white-space: pre-wrap;
-            font-family: 'Courier New', monospace;
-            font-size: 12px;
-            max-height: 500px;
-            overflow: auto;
-        }
-        .error {
-            color: #ff4d4f;
-            background: #fff2f0;
-            border: 1px solid #ffccc7;
-        }
-        .success {
-            color: #52c41a;
-            background: #f6ffed;
-            border: 1px solid #b7eb8f;
-        }
-        input {
-            padding: 8px;
-            border: 1px solid #d9d9d9;
-            border-radius: 4px;
-            width: 300px;
-            font-size: 14px;
-        }
-        .input-group {
-            margin: 15px 0;
-        }
-        label {
-            display: inline-block;
-            width: 120px;
-            font-weight: 500;
-        }
-    </style>
-</head>
-<body>
-    <div class="container">
-        <h1>📡 Document Content API 测试</h1>
-        
-        <div class="input-group">
-            <label>API Base URL:</label>
-            <input type="text" id="baseUrl" value="http://192.168.0.195:8000" />
-        </div>
-        
-        <div class="input-group">
-            <label>Record ID:</label>
-            <input type="text" id="recordId" value="rec-48d00cf5664a" />
-        </div>
-        
-        <div class="input-group">
-            <label>User ID:</label>
-            <input type="text" id="userId" value="default-user" />
-        </div>
-        
-        <div>
-            <button onclick="testListRecords()">测试列表 API</button>
-            <button onclick="testContentAPI()">测试内容 API</button>
-            <button onclick="clearResult()">清空结果</button>
-        </div>
-        
-        <div id="result" class="result"></div>
-    </div>
-
-    <script>
-        function getBaseUrl() {
-            return document.getElementById('baseUrl').value;
-        }
-        
-        function getRecordId() {
-            return document.getElementById('recordId').value;
-        }
-        
-        function getUserId() {
-            return document.getElementById('userId').value;
-        }
-        
-        function showResult(data, isError = false) {
-            const resultDiv = document.getElementById('result');
-            resultDiv.className = 'result ' + (isError ? 'error' : 'success');
-            resultDiv.textContent = JSON.stringify(data, null, 2);
-        }
-        
-        function clearResult() {
-            document.getElementById('result').textContent = '';
-            document.getElementById('result').className = 'result';
-        }
-        
-        async function testListRecords() {
-            try {
-                const baseUrl = getBaseUrl();
-                const userId = getUserId();
-                const url = `${baseUrl}/api/v1/export/records?userId=${userId}&page=1&pageSize=5`;
-                
-                console.log('Fetching:', url);
-                const response = await fetch(url);
-                
-                if (!response.ok) {
-                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-                }
-                
-                const data = await response.json();
-                console.log('Response:', data);
-                
-                showResult({
-                    status: '✅ SUCCESS',
-                    code: data.code,
-                    records: data.data.records.length,
-                    data: data
-                });
-            } catch (error) {
-                console.error('Error:', error);
-                showResult({
-                    status: '❌ ERROR',
-                    message: error.message,
-                    error: error
-                }, true);
-            }
-        }
-        
-        async function testContentAPI() {
-            try {
-                const baseUrl = getBaseUrl();
-                const recordId = getRecordId();
-                const userId = getUserId();
-                const url = `${baseUrl}/api/v1/export/records/${recordId}/content?userId=${userId}`;
-                
-                console.log('Fetching:', url);
-                const response = await fetch(url);
-                
-                if (!response.ok) {
-                    const text = await response.text();
-                    throw new Error(`HTTP ${response.status}: ${response.statusText}\n${text}`);
-                }
-                
-                const data = await response.json();
-                console.log('Response:', data);
-                
-                showResult({
-                    status: '✅ SUCCESS',
-                    code: data.code,
-                    fileName: data.data.fileName,
-                    outlineItems: data.data.outline.length,
-                    contentBlocks: data.data.content.length,
-                    outline: data.data.outline,
-                    sample_content: data.data.content.slice(0, 3)
-                });
-            } catch (error) {
-                console.error('Error:', error);
-                showResult({
-                    status: '❌ ERROR',
-                    message: error.message,
-                    error: error.toString()
-                }, true);
-            }
-        }
-        
-        // Auto-test on load
-        window.addEventListener('load', () => {
-            console.log('Page loaded, ready to test');
-        });
-    </script>
-</body>
-</html>

public/test-dedup.html

@@ -1,128 +0,0 @@
-<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>测试去重逻辑</title>
-    <style>
-        body {
-            font-family: Arial, sans-serif;
-            max-width: 800px;
-            margin: 50px auto;
-            padding: 20px;
-        }
-        button {
-            padding: 10px 20px;
-            font-size: 16px;
-            cursor: pointer;
-            margin: 10px 0;
-        }
-        #result {
-            margin-top: 20px;
-            padding: 20px;
-            background: #f5f5f5;
-            border-radius: 4px;
-        }
-        .log {
-            margin: 5px 0;
-            padding: 5px;
-            background: white;
-            border-left: 3px solid #4CAF50;
-        }
-        .log.duplicate {
-            border-left-color: #f44336;
-        }
-    </style>
-</head>
-<body>
-    <h1>文档去重测试</h1>
-    <p>这个页面用于测试文档内容去重逻辑是否正常工作。</p>
-    
-    <div>
-        <label>
-            Record ID: 
-            <input type="text" id="recordId" value="请从实际记录中获取" style="width: 300px;">
-        </label>
-    </div>
-    
-    <div>
-        <label>
-            User ID: 
-            <input type="text" id="userId" value="default-user" style="width: 200px;">
-        </label>
-    </div>
-    
-    <button onclick="testDedup()">测试去重逻辑</button>
-    <button onclick="clearResult()">清除结果</button>
-    
-    <div id="result"></div>
-
-    <script>
-        async function testDedup() {
-            const recordId = document.getElementById('recordId').value;
-            const userId = document.getElementById('userId').value;
-            const resultDiv = document.getElementById('result');
-            
-            resultDiv.innerHTML = '<div class="log">开始测试...</div>';
-            
-            try {
-                // 模拟内容数组（完全重复的情况）
-                const mockContent = [
-                    { type: 'heading', level: 1, text: '东河塘油田东河1****区块****DH1-10H****井', id: 'h1' },
-                    { type: 'paragraph', text: '调剖****地质设计', id: 'p1' },
-                    { type: 'paragraph', text: '作业类型：调剖', id: 'p2' },
-                    // 重复内容
-                    { type: 'heading', level: 1, text: '东河塘油田东河1****区块****DH1-10H****井', id: 'h1-dup' },
-                    { type: 'paragraph', text: '调剖****地质设计', id: 'p1-dup' },
-                    { type: 'paragraph', text: '作业类型：调剖', id: 'p2-dup' },
-                ];
-                
-                resultDiv.innerHTML += `<div class="log">原始内容块数量: ${mockContent.length}</div>`;
-                
-                // 执行去重逻辑
-                const uniqueContent = [];
-                const seenTexts = new Map();
-                let duplicateCount = 0;
-                
-                mockContent.forEach((block, index) => {
-                    let key = '';
-                    if (block.type === 'heading') {
-                        key = `H${block.level}:${block.text}`;
-                    } else if (block.type === 'paragraph') {
-                        key = `P:${block.text}`;
-                    }
-                    
-                    const firstIndex = seenTexts.get(key);
-                    if (firstIndex === undefined) {
-                        seenTexts.set(key, uniqueContent.length);
-                        uniqueContent.push(block);
-                        resultDiv.innerHTML += `<div class="log">✓ 保留 [${index}]: ${block.text?.substring(0, 50)}...</div>`;
-                    } else {
-                        duplicateCount++;
-                        resultDiv.innerHTML += `<div class="log duplicate">✗ 跳过重复 [${index}]: ${block.text?.substring(0, 50)}... (首次出现在 ${firstIndex})</div>`;
-                    }
-                });
-                
-                resultDiv.innerHTML += `<div class="log"><strong>去重结果:</strong></div>`;
-                resultDiv.innerHTML += `<div class="log">- 原始: ${mockContent.length} 个块</div>`;
-                resultDiv.innerHTML += `<div class="log">- 唯一: ${uniqueContent.length} 个块</div>`;
-                resultDiv.innerHTML += `<div class="log">- 移除: ${duplicateCount} 个重复块</div>`;
-                resultDiv.innerHTML += `<div class="log">- 移除比例: ${((duplicateCount / mockContent.length) * 100).toFixed(1)}%</div>`;
-                
-                if (duplicateCount === 3) {
-                    resultDiv.innerHTML += `<div class="log" style="border-left-color: #4CAF50; font-weight: bold;">✓ 去重逻辑工作正常！</div>`;
-                } else {
-                    resultDiv.innerHTML += `<div class="log duplicate" style="font-weight: bold;">✗ 去重逻辑可能有问题</div>`;
-                }
-                
-            } catch (error) {
-                resultDiv.innerHTML += `<div class="log duplicate">错误: ${error.message}</div>`;
-            }
-        }
-        
-        function clearResult() {
-            document.getElementById('result').innerHTML = '';
-        }
-    </script>
-</body>
-</html>

src/App.tsx

@@ -163,10 +163,7 @@ const App: React.FC = () => {
    */
   const handleDocumentSelect = useCallback(
     async (documentId: string) => {
-      console.log('Document selected:', documentId);
-      // Close drawer after selection
       setDocListOpen(false);
-      // Future: could open document in viewer or perform other actions
     },
     [],
   );

src/components/ChatPanel/MessageItem.tsx

@@ -155,7 +155,6 @@ const MessageItem: React.FC<MessageItemProps> = memo(
           // URL format: http://xxx/api/v1/export/records/{recordId}/download?userId=xxx
           const urlMatch = exportRecord.downloadUrl.match(/\/export\/records\/([^/]+)\/download/);
           if (!urlMatch) {
-            console.error('[MessageItem] Cannot extract recordId from URL:', exportRecord.downloadUrl);
             return;
           }
           
@@ -200,10 +199,7 @@ const MessageItem: React.FC<MessageItemProps> = memo(
             document.body.removeChild(link);
             URL.revokeObjectURL(blobUrl);
           }, 100);
-          
-          console.log('[MessageItem] Download triggered:', fileName);
         } catch (error) {
-          console.error('[MessageItem] Download failed:', error);
         }
       },
       [exportRecord]

src/components/DocumentManagement/DocumentManagement.tsx

@@ -169,14 +169,10 @@ export const DocumentManagement: React.FC<DocumentManagementProps> = ({
           document.body.removeChild(link);
           URL.revokeObjectURL(blobUrl);
         }, 100);
-        
-        console.log('[DocumentManagement] Word 文档下载已触发:', result.fileName);
       } catch (downloadError) {
-        console.error('[DocumentManagement] 下载失败:', downloadError);
         message.error('文件下载失败');
       }
     } catch (error) {
-      console.error('[DocumentManagement] 导出失败:', error);
       message.error('导出失败: ' + (error instanceof Error ? error.message : '未知错误'));
     } finally {
       setExporting((prev) => ({ ...prev, [documentId]: false }));

src/components/DocumentManagementLayout/DocumentManagementLayout.tsx

@@ -276,10 +276,7 @@ const DocumentManagementLayout: React.FC<DocumentManagementLayoutProps> = ({
         document.body.removeChild(link);
         URL.revokeObjectURL(blobUrl);
       }, 100);
-      
-      console.log('[DocumentManagementLayout] Word 文档下载已触发:', result.fileName);
     } catch (error) {
-      console.error('[DocumentManagementLayout] 导出失败:', error);
       message.error('导出失败: ' + (error instanceof Error ? error.message : '未知错误'));
     } finally {
       setLoading(false);
@@ -341,9 +338,7 @@ const DocumentManagementLayout: React.FC<DocumentManagementLayoutProps> = ({
       }, 100);
       
       message.success('下载已开始');
-      console.log('[DocumentManagementLayout] 下载已触发:', fileName);
     } catch (error) {
-      console.error('[DocumentManagementLayout] 下载失败:', error);
       message.error('下载失败: ' + (error instanceof Error ? error.message : '未知错误'));
     }
   }, [selectedRecordId, userId]);

src/components/EditorPanel/EditorPanel.tsx

@@ -303,14 +303,10 @@ export const EditorPanel: React.FC<EditorPanelProps> = ({
           document.body.removeChild(link);
           URL.revokeObjectURL(blobUrl);
         }, 100);
-        
-        console.log('[EditorPanel] Word 文档下载已触发:', result.fileName);
       } catch (downloadError) {
-        console.error('[EditorPanel] 下载失败:', downloadError);
         message.error('文件下载失败');
       }
     } catch (error) {
-      console.error('[EditorPanel] 导出失败:', error);
       message.error('导出失败: ' + (error instanceof Error ? error.message : '未知错误'));
     } finally {
       setExporting(false);

src/components/EditorPanel/WYSIWYGEditor.tsx

@@ -68,7 +68,6 @@ const sanitizeMarkdown = (content: string): string => {
     
     return cleaned;
   } catch (error) {
-    console.error('Error sanitizing markdown:', error);
     return content;
   }
 };
@@ -104,16 +103,12 @@ export const WYSIWYGEditor: React.FC<WYSIWYGEditorProps> = ({
 
   // Sanitize markdown when it changes
   useEffect(() => {
-    console.log('[WYSIWYGEditor] Markdown input:', markdown?.substring(0, 100)); // 打印前100个字符
     try {
       const sanitized = sanitizeMarkdown(markdown);
-      console.log('[WYSIWYGEditor] Sanitized markdown:', sanitized?.substring(0, 100));
       setCleanedMarkdown(sanitized);
       setError(null);
-      // 强制重新创建编辑器实例
       setEditorKey(prev => prev + 1);
     } catch (err) {
-      console.error('Failed to sanitize markdown:', err);
       setError('文档内容包含无效字符，请在源码模式下修复');
       setCleanedMarkdown('');
     }
@@ -178,8 +173,6 @@ export const WYSIWYGEditor: React.FC<WYSIWYGEditorProps> = ({
             readOnly={readOnly}
             placeholder={placeholder}
             onError={(payload) => {
-              console.error('MDXEditor error:', payload);
-              // MDXEditor的错误对象可能有不同的结构
               const errorMessage = typeof payload === 'object' && payload !== null
                 ? ('error' in payload ? String(payload.error) : '编辑器发生错误')
                 : String(payload);

src/components/MarkdownPreview/MarkdownPreview.tsx

@@ -385,14 +385,10 @@ export const MarkdownPreview: React.FC<MarkdownPreviewProps> = ({
           document.body.removeChild(link);
           URL.revokeObjectURL(blobUrl);
         }, 100);
-        
-        console.log('[MarkdownPreview] Word 文档下载已触发:', result.fileName);
       } catch (downloadError) {
-        console.error('[MarkdownPreview] 下载失败:', downloadError);
         message.error('文件下载失败');
       }
     } catch (error) {
-      console.error('[MarkdownPreview] 导出失败:', error);
       message.error('导出失败: ' + (error instanceof Error ? error.message : '未知错误'));
     } finally {
       setExporting(false);

src/services/README.md

@@ -1,253 +0,0 @@
-# Services Layer
-
-This directory contains the business logic services that handle API communication and data operations.
-
-## Files
-
-### `api.ts` - API Client
-
-The core HTTP client built on Axios with the following features:
-
-#### Features
-
-1. **Base URL Configuration**
-   - Reads from `VITE_API_BASE_URL` environment variable
-   - Defaults to `http://localhost:8000` if not set
-
-2. **Request Timeout**
-   - Default timeout: 30 seconds (30000ms)
-   - Configurable per request
-
-3. **Request Interceptor**
-   - Adds `Content-Type: application/json` header
-   - Debug logging when `VITE_DEBUG=true`
-   - Extensible for authentication tokens
-
-4. **Response Interceptor**
-   - Handles business errors (code !== 0)
-   - Normalizes error responses
-   - Debug logging support
-
-5. **Error Handling**
-   - **Network Errors**: Connection failures, timeouts
-   - **Client Errors (4xx)**: Bad requests, unauthorized, not found
-   - **Server Errors (5xx)**: Internal server errors
-   - **Business Errors**: Backend returns code !== 0
-
-6. **Request Cancellation**
-   - Full support for `AbortController`
-   - Cancel in-flight requests
-
-#### Usage
-
-```typescript
-import apiClient, { getErrorMessage, isApiError } from './services/api';
-
-// GET request
-const response = await apiClient.get('/api/v1/documents/123');
-const document = response.data.data;
-
-// POST request
-const response = await apiClient.post('/api/v1/documents', {
-  title: 'New Document',
-  content: 'Content here',
-  format: 'markdown',
-  source: 'chat',
-});
-
-// PATCH request
-await apiClient.patch('/api/v1/documents/123', {
-  content: 'Updated content',
-});
-
-// DELETE request
-await apiClient.delete('/api/v1/documents/123');
-
-// With cancellation
-const controller = new AbortController();
-const response = await apiClient.get('/api/v1/documents', {
-  signal: controller.signal,
-});
-// Cancel: controller.abort();
-
-// Error handling
-try {
-  await apiClient.get('/api/v1/documents/123');
-} catch (error) {
-  if (isApiError(error)) {
-    console.error(error.type, error.message);
-  } else {
-    console.error(getErrorMessage(error));
-  }
-}
-```
-
-#### Error Types
-
-| Type       | Description          | Example                            |
-| ---------- | -------------------- | ---------------------------------- |
-| `network`  | No response received | Connection timeout, offline        |
-| `client`   | 4xx status codes     | 400 Bad Request, 404 Not Found     |
-| `server`   | 5xx status codes     | 500 Internal Server Error          |
-| `business` | Backend code !== 0   | Business logic validation failures |
-| `unknown`  | Unexpected errors    | Other edge cases                   |
-
-#### Exported Utilities
-
-- `apiClient` (default): Configured Axios instance
-- `isApiError(error)`: Type guard for ApiError
-- `getErrorMessage(error)`: Extract user-friendly message
-- `axios`: Raw axios for advanced use cases
-
----
-
-### `documentService.ts` - Document CRUD Operations
-
-Provides methods for managing documents through the backend API.
-
-#### Available Methods
-
-1. **`createDocument(request)`** - Create a new document
-   - POST `/api/v1/documents`
-   - Returns: `{ documentId, title, format, createdAt }`
-
-2. **`getDocument(documentId)`** - Retrieve a document by ID
-   - GET `/api/v1/documents/:id`
-   - Returns: Full `Document` object
-
-3. **`listDocuments(filters?)`** - List documents with pagination
-   - GET `/api/v1/documents`
-   - Supports filtering by source, sorting, pagination
-   - Returns: `{ documents, pagination }`
-
-4. **`updateDocument(documentId, request)`** - Update a document
-   - PUT `/api/v1/documents/:id`
-   - Supports full content update or partial block updates
-   - Returns: `{ documentId, updatedAt }`
-
-5. **`deleteDocument(documentId)`** - Delete a document
-   - DELETE `/api/v1/documents/:id`
-   - Returns: `void` on success
-
-#### Usage Examples
-
-```typescript
-import { documentService } from './services';
-// or
-import {
-  createDocument,
-  getDocument,
-  listDocuments,
-  updateDocument,
-  deleteDocument,
-} from './services/documentService';
-
-// Create a document
-const result = await createDocument({
-  title: 'My Document',
-  content: '# Hello World',
-  format: 'markdown',
-  source: 'chat',
-  sessionId: 'session-123', // optional
-});
-console.log('Created:', result.documentId);
-
-// Get a document
-const document = await getDocument('doc-123');
-console.log('Title:', document.title);
-
-// List documents with filters
-const { documents, pagination } = await listDocuments({
-  source: 'chat',
-  sortBy: 'createdAt',
-  sortOrder: 'desc',
-  page: 1,
-  pageSize: 20,
-});
-
-// Update document content
-await updateDocument('doc-123', {
-  content: '# Updated content',
-});
-
-// Update document title
-await updateDocument('doc-123', {
-  title: 'New Title',
-});
-
-// Update with blocks (partial update)
-await updateDocument('doc-123', {
-  blocks: [
-    { level: 1, index: 0, content: '# Updated heading' },
-  ],
-});
-
-// Delete a document
-await deleteDocument('doc-123');
-
-// Using namespace pattern
-await documentService.create({ ... });
-await documentService.get('doc-123');
-await documentService.list({ source: 'chat' });
-await documentService.update('doc-123', { title: 'New' });
-await documentService.delete('doc-123');
-```
-
-#### Error Handling
-
-All methods throw errors with Chinese error messages on failure:
-
-```typescript
-try {
-  await getDocument('invalid-id');
-} catch (error) {
-  console.error(error.message); // "获取文档失败: 请求的资源不存在"
-}
-```
-
-Error messages include:
-
-- `创建文档失败: ...` - Document creation failed
-- `获取文档失败: ...` - Document retrieval failed
-- `获取文档列表失败: ...` - Document list retrieval failed
-- `更新文档失败: ...` - Document update failed
-- `删除文档失败: ...` - Document deletion failed
-
----
-
-## Future Services
-
-- **`exportService.ts`** - Document export and download handling
-- **`autoSaveService.ts`** - Debounced auto-save logic
-
----
-
-## Best Practices
-
-1. **Always use the configured `apiClient`** - Don't create new axios instances
-2. **Handle errors consistently** - Use `isApiError()` and `getErrorMessage()`
-3. **Type all responses** - Use `ApiResponse<T>` wrapper
-4. **Cancel requests when unmounting** - Use AbortController with useEffect
-5. **Don't expose raw errors to users** - Always provide friendly messages
-
----
-
-## Environment Variables
-
-```bash
-# .env
-VITE_API_BASE_URL=http://localhost:8000  # Backend API URL
-VITE_DEBUG=false                          # Enable debug logging
-```
-
----
-
-## Testing
-
-See `api.test.example.ts` for usage examples and patterns.
-
-For actual tests, use tools like:
-
-- **Vitest** - Unit testing
-- **MSW** (Mock Service Worker) - API mocking
-- **Playwright** - E2E testing

src/services/documentService.ts

@@ -34,18 +34,6 @@ import type {
  * @param request - Create document request payload
  * @returns Created document metadata
  * @throws {Error} When the API request fails or file cannot be parsed
- *
- * @example
- * ```typescript
- * const result = await createDocument({
- *   userId: 'user-123',
- *   fileUrl: 'https://example.com/report.docx',
- *   sessionId: 'session-456',
- * });
- *
- * console.log('Document ID:', result.documentId);
- * console.log('Format:', result.format); // 'markdown'
- * ```
  */
 export const createDocument = async (
   request: CreateDocumentRequest
@@ -78,13 +66,6 @@ export const createDocument = async (
  * @param documentId - Document ID to retrieve
  * @returns Document entity with full content
  * @throws {Error} When the document is not found or request fails
- *
- * @example
- * ```typescript
- * const document = await getDocument('doc-abc123');
- * console.log('Content:', document.content);
- * console.log('Last updated:', new Date(document.updatedAt));
- * ```
  */
 export const getDocument = async (documentId: string): Promise<Document> => {
   try {
@@ -113,13 +94,6 @@ export const getDocument = async (documentId: string): Promise<Document> => {
  * @param documentId - Document ID to retrieve
  * @returns Document with title and content
  * @throws {Error} When the document is not found or request fails
- *
- * @example
- * ```typescript
- * const doc = await getDocumentContent('doc-abc123');
- * console.log('Title:', doc.title);
- * console.log('Content:', doc.content);
- * ```
  */
 export const getDocumentContent = async (
   documentId: string
@@ -143,25 +117,6 @@ export const getDocumentContent = async (
  * @param request - Update request (content OR blocks, not both)
  * @returns Update response with new timestamp
  * @throws {Error} When document not found or validation fails
- *
- * @example
- * ```typescript
- * // Full update
- * await updateDocument('doc-abc123', {
- *   content: '# Updated Title\n\nNew content...',
- * });
- *
- * // Partial block update
- * await updateDocument('doc-abc123', {
- *   blocks: [
- *     {
- *       level: 2,
- *       index: 1,
- *       content: '## Updated Section\n\nUpdated paragraph...',
- *     },
- *   ],
- * });
- * ```
  */
 export const updateDocument = async (
   documentId: string,
@@ -196,12 +151,6 @@ export const updateDocument = async (
  * @param sessionId - Session ID whose documents should be deleted
  * @returns Success message with deletion count
  * @throws {Error} When the delete operation fails
- *
- * @example
- * ```typescript
- * const result = await deleteDocuments('session-456');
- * console.log(result); // "Deleted 3 document(s) successfully"
- * ```
  */
 export const deleteDocuments = async (sessionId: string): Promise<string> => {
   try {
@@ -227,23 +176,6 @@ export const deleteDocuments = async (sessionId: string): Promise<string> => {
  * @param filters - Query filters including userId, pagination, and sorting
  * @returns Paginated list of documents
  * @throws {Error} When the request fails
- *
- * @example
- * ```typescript
- * const result = await listDocuments({
- *   userId: 'user-123',
- *   page: 1,
- *   pageSize: 20,
- *   sessionId: 'session-456',
- *   sortBy: 'updatedAt',
- *   sortOrder: 'desc',
- * });
- *
- * console.log('Total documents:', result.pagination.total);
- * result.documents.forEach(doc => {
- *   console.log(doc.id, new Date(doc.updatedAt));
- * });
- * ```
  */
 export const listDocuments = async (
   filters: DocumentListFilters

src/services/exportRecordService.ts

@@ -27,19 +27,6 @@ import type {
  * @param filters - Filters for listing export records (userId is required)
  * @returns List of export records and pagination information
  * @throws {Error} When the API request fails
- *
- * @example
- * ```typescript
- * const result = await listExportRecords({
- *   userId: 'user-123',
- *   page: 1,
- *   pageSize: 20,
- *   sortOrder: 'desc',
- * });
- *
- * console.log('Total records:', result.pagination.total);
- * console.log('Records:', result.records);
- * ```
  */
 export const listExportRecords = async (
   filters: ExportRecordListFilters
@@ -69,7 +56,6 @@ export const listExportRecords = async (
             const urlObj = new URL(record.downloadUrl);
             const correctUrlObj = new URL(correctBaseURL);
             if (urlObj.origin !== correctUrlObj.origin) {
-              console.warn(`[ExportRecord] Replacing origin in record ${record.recordId}: ${urlObj.origin} -> ${correctUrlObj.origin}`);
               return {
                 ...record,
                 downloadUrl: record.downloadUrl.replace(urlObj.origin, correctUrlObj.origin)
@@ -99,15 +85,6 @@ export const listExportRecords = async (
  * @param recordId - The export record ID
  * @param userId - The user ID who owns the record
  * @throws {Error} When the download fails
- *
- * @example
- * ```typescript
- * try {
- *   await downloadExportRecord('record-123', 'user-456');
- * } catch (error) {
- *   console.error('Download failed:', error);
- * }
- * ```
  */
 export const downloadExportRecord = async (
   recordId: string,
@@ -151,8 +128,6 @@ export const downloadExportRecord = async (
       document.body.removeChild(link);
       URL.revokeObjectURL(blobUrl);
     }, 100);
-    
-    console.log('[ExportRecord] Download completed:', fileName);
   } catch (error) {
     const message = getErrorMessage(error);
     throw new Error(`下载文件失败: ${message}`, { cause: error });
@@ -168,16 +143,6 @@ export const downloadExportRecord = async (
  * @param userId - The user ID who owns the record
  * @returns Promise that resolves when deletion is successful
  * @throws {Error} When the API request fails or record not found
- *
- * @example
- * ```typescript
- * try {
- *   await deleteExportRecord('record-123', 'user-456');
- *   console.log('Export record deleted successfully');
- * } catch (error) {
- *   console.error('Failed to delete export record:', error);
- * }
- * ```
  */
 export const deleteExportRecord = async (
   recordId: string,
@@ -206,17 +171,6 @@ export const deleteExportRecord = async (
  *
  * @returns Storage usage information
  * @throws {Error} When the API request fails or user is not authorized
- *
- * @example
- * ```typescript
- * try {
- *   const info = await getAdminStorage();
- *   console.log('Total users:', info.activeUsers);
- *   console.log('Quota exceeded:', info.quotaExceeded);
- * } catch (error) {
- *   console.error('Failed to get storage info:', error);
- * }
- * ```
  */
 export const getAdminStorage = async (): Promise<StorageInfo> => {
   try {

src/services/exportService.ts

@@ -31,56 +31,18 @@ import type { ExportDocRequest, ExportDocResponse } from '../types/export';
  * @param request - Export request payload (documentId required, styleId optional)
  * @returns Export response with download URL, filename, and record ID
  * @throws {Error} When the API request fails or document not found
- *
- * @example
- * ```typescript
- * // Export with default style
- * const result = await exportToWord({
- *   documentId: 'doc-abc123',
- * });
- *
- * console.log('Download URL:', result.downloadUrl);
- * console.log('File name:', result.fileName);
- * console.log('Record ID:', result.recordId);
- *
- * // Export with custom style
- * const result = await exportToWord({
- *   documentId: 'doc-abc123',
- *   styleId: 'custom-style-1',
- * });
- *
- * if (result.warning) {
- *   console.warn('Storage warning:', result.warning);
- * }
- * ```
  */
 export const exportToWord = async (
   request: ExportDocRequest
 ): Promise<ExportDocResponse> => {
   try {
-    // Debug logging
-    console.log('[Export Service] Sending request:', {
-      url: '/api/v1/export/doc',
-      documentId: request.documentId,
-      styleId: request.styleId,
-    });
-    
     const response = await apiClient.post<ApiResponse<ExportDocResponse>>(
       '/api/v1/export/doc',
       request
     );
     
-    console.log('[Export Service] Response received:', {
-      status: response.status,
-      data: response.data,
-    });
-    
     const data = response.data.data;
     
-    if (data.warning) {
-      console.warn('[Export Service] Warning:', data.warning);
-    }
-    
     // Ensure downloadUrl is properly formatted and uses correct base URL
     if (data.downloadUrl) {
       // If URL doesn't start with http, prepend base URL
@@ -95,32 +57,14 @@ export const exportToWord = async (
           const urlObj = new URL(data.downloadUrl);
           const correctUrlObj = new URL(correctBaseURL);
           if (urlObj.origin !== correctUrlObj.origin) {
-            console.warn(`[Export Service] Replacing origin ${urlObj.origin} with ${correctUrlObj.origin}`);
             data.downloadUrl = data.downloadUrl.replace(urlObj.origin, correctUrlObj.origin);
           }
         }
       }
     }
     
-    console.log('[Export Service] Export successful:', {
-      fileName: data.fileName,
-      downloadUrl: data.downloadUrl,
-    });
-    
     return data;
   } catch (error: any) {
-    // Enhanced error logging
-    console.error('[Export Service] Export failed:', {
-      status: error?.response?.status,
-      statusText: error?.response?.statusText,
-      data: error?.response?.data,
-      message: error?.message,
-      request: {
-        documentId: request.documentId,
-        styleId: request.styleId,
-      },
-    });
-    
     let friendlyMessage = '导出Word文档失败';
     let detailMessage = '';
 
@@ -132,7 +76,6 @@ export const exportToWord = async (
       detailMessage = error?.response?.data?.detail || error?.response?.data?.message || '';
     } else if (error?.response?.status === 500) {
       friendlyMessage = '服务器内部错误';
-      // Try to extract detailed error from response
       const backendError = error?.response?.data?.detail || error?.response?.data?.message || '';
       detailMessage = backendError ? `后端错误: ${backendError}` : 'Markdown解析或文件写入失败';
     } else if (error?.code === 'ECONNREFUSED' || error?.code === 'NETWORK_ERROR') {

vitest.config.ts

@@ -1,11 +0,0 @@
-import { defineConfig } from 'vitest/config';
-import react from '@vitejs/plugin-react';
-
-export default defineConfig({
-  plugins: [react()],
-  test: {
-    environment: 'jsdom',
-    globals: true,
-    setupFiles: ['./src/test-setup.ts'],
-  },
-});

阶段性分析报告.md

@@ -1,271 +0,0 @@
-# AX Frontend App 开发报告
-
-**项目定位**: 本地辅助工具 - Word 文档生成助手  
-**报告日期**: 2026年6月18日  
-**项目类型**: 微前端应用（部署在本地）
-
----
-
-## 📋 项目概述
-
-### 核心功能
-这是一个部署在本地的轻量级辅助工具，帮助工程师快速生成 Word 文档：
-
-1. **双栏布局**
-   - 左侧：聊天面板（与 AI 交互，描述文档需求）
-   - 右侧：编辑器面板（编辑生成的文档内容）
-
-2. **Word 模板驱动**
-   - 上传 .doc 模板文件
-   - AI 根据模板和对话内容生成文档
-   - 导出为格式化的 Word 文档
-
-3. **微前端架构**
-   - 独立部署运行
-   - 可集成到其他平台
-
-### 技术栈
-- **前端框架**: React 18 + TypeScript
-- **UI 组件**: Ant Design 5
-- **富文本编辑**: Slate.js
-- **状态管理**: Zustand
-- **构建工具**: Vite
-
----
-
-## ✅ 已完成的部分
-
-### 1. 基础架构（100%）
-- ✅ React 18 + TypeScript 项目搭建
-- ✅ Vite 构建配置
-- ✅ 微前端架构基础
-- ✅ 代码规范（ESLint + Prettier）
-
-### 2. 核心 UI（100%）
-- ✅ **双栏布局**
-  - 左侧聊天面板
-  - 右侧编辑器面板
-  - 可拖拽调整宽度
-  - 布局状态持久化
-
-- ✅ **聊天面板**
-  - 消息列表展示
-  - 消息输入框
-  - AI 响应显示（Mock）
-  - 滚动到底部
-
-- ✅ **编辑器面板**
-  - Markdown 编辑器（基于 Slate.js）
-  - 文档标题编辑
-  - 基础格式化工具栏
-  - 自动保存提示
-
-### 3. 基础功能（80%）
-- ✅ 文档列表查看
-- ✅ 文档创建/编辑/删除
-- ✅ 自动保存（防抖 3 秒）
-- ⚠️ 文档导出（当前为 .doc，需支持模板）
-- ⚠️ AI 对话（Mock 数据，待接入真实服务）
-
-### 4. 状态管理（100%）
-- ✅ documentStore（文档 CRUD）
-- ✅ chatStore（聊天消息）
-- ✅ uiStore（UI 状态）
-
----
-
-## ❌ 未完成的部分
-
-### 1. Word 模板核心功能（优先级最高）
-- ❌ **模板上传**
-  - 上传 .doc 模板文件
-  - 模板预览
-  - 模板管理（列表、删除）
-
-- ❌ **模板样式提取**
-  - 提取 Word 文档样式（字体、标题、段落格式）
-  - 样式存储和缓存
-  - 样式应用到编辑器
-
-- ❌ **基于模板导出**
-  - 使用模板样式生成 Word 文档
-  - 占位符填充
-  - 格式保真
-
-### 2. AI 集成（优先级高）
-- ❌ 接入真实 AI 服务
-- ❌ AI 理解模板结构
-- ❌ 根据对话生成符合模板的内容
-
-### 3. 用户体验优化（优先级中）
-- ❌ 离线提示
-- ❌ 错误处理优化
-- ❌ 加载状态优化
-- ❌ 快捷键支持
-
----
-
-## 📅 下周工作计划
-
-### 核心任务：完成 Word 模板功能
-
-**第 1-2 天：模板上传与管理**
-- [ ] 实现模板上传组件（拖拽上传或点击上传）
-- [ ] 模板列表展示
-- [ ] 选择/切换当前使用的模板
-- [ ] 模板删除功能
-
-**第 3-4 天：模板样式提取**
-- [ ] 后端实现样式提取（python-docx）
-  - 提取段落样式
-  - 提取字符样式
-  - 提取标题层级
-- [ ] 前端接收样式数据
-- [ ] 样式缓存管理
-
-**第 5-6 天：基于模板导出**
-- [ ] 后端实现模板填充逻辑
-  - 识别占位符
-  - 填充文档内容
-  - 保持格式一致
-- [ ] 前端触发导出
-- [ ] 下载生成的 Word 文档
-
-**第 7 天：测试与优化**
-- [ ] 完整流程测试
-  - 上传模板 → 对话生成内容 → 编辑 → 导出
-- [ ] 修复 Bug
-- [ ] 用户体验优化
-
-### 次要任务：AI 集成（如果时间允许）
-- [ ] 替换 Mock AI 为真实服务
-- [ ] 测试 AI 生成质量
-
----
-
-## ⚠️ 遇到的问题
-
-### 1. React 版本兼容性 ✅ 已解决
-**问题**: Ant Design v5 不支持 React 19
-
-**解决**: 使用 React 18.3.1，记录在 `REACT_VERSION_NOTES.md`
-
----
-
-### 2. 响应式布局需求变更 ✅ 已解决
-**问题**: 最初计划支持移动端，但实际只需桌面端
-
-**解决**: 移除响应式布局代码，专注桌面体验
-
----
-
-### 3. Word 模板样式提取复杂度 ⚠️ 待解决
-**问题**: 
-- Word 样式系统复杂（字体、颜色、段落、标题、列表等）
-- 样式提取可能不完整
-- 导出文档与模板格式不一致
-
-**计划**: 
-- 第一版先支持基础样式（标题、正文、字体、颜色）
-- 复杂样式（表格、页眉页脚、图片）后续迭代
-- 明确告知用户当前支持的样式范围
-
-**技术方案**: 
-- 后端使用 `python-docx` 提取样式
-- 样式序列化为 JSON 传给前端
-- 导出时加载样式并注入
-
----
-
-### 4. 后端 API 未就绪 ⚠️ 进行中
-**问题**: 
-- 前端开发快于后端
-- 无法联调测试
-
-**应对**: 
-- 使用 Mock 数据继续开发
-- 定义清晰的 API 接口规范
-- 等待后端完成后快速联调
-
----
-
-### 5. 微前端架构待实现 ⚠️ 待规划
-**问题**: 
-- 当前是独立应用
-- 需要作为微前端模块集成到其他平台
-
-**计划**: 
-- 使用 Vite Module Federation 或 qiankun
-- 封装为独立模块
-- 提供清晰的集成接口
-
----
-
-## 📊 项目进度
-
-### 当前完成度：**60%**
-
-| 模块 | 完成度 | 说明 |
-|------|-------|------|
-| 前端架构 | 100% | React + TS + Vite |
-| 双栏布局 | 100% | 聊天 + 编辑器 |
-| 基础编辑器 | 100% | Markdown 编辑 |
-| 文档管理 | 80% | CRUD 功能完成 |
-| **模板上传** | 0% | **核心功能待开发** |
-| **模板样式提取** | 0% | **核心功能待开发** |
-| **基于模板导出** | 0% | **核心功能待开发** |
-| AI 集成 | 20% | Mock 实现 |
-| 微前端化 | 0% | 待规划 |
-
-### 预计时间
-- **下周**: 完成 Word 模板核心功能（上传、样式提取、导出）
-- **下下周**: AI 集成 + 微前端架构 + 测试优化
-
----
-
-### 前端关键组件
-
-```
-src/
-├── components/
-│   ├── ChatPanel/          # 聊天面板
-│   ├── EditorPanel/        # 编辑器面板
-│   ├── TemplateManager/    # 模板管理（待开发）
-│   └── Layout/             # 双栏布局
-├── services/
-│   ├── documentService.ts  # 文档 CRUD
-│   ├── templateService.ts  # 模板管理（待开发）
-│   └── exportService.ts    # 导出服务
-└── stores/
-    ├── documentStore.ts
-    ├── chatStore.ts
-    └── templateStore.ts    # 模板状态（待开发）
-```
-
----
-
-## 💡 总结
-
-### 项目定位
-这是一个**本地部署的轻量级辅助工具**，不是企业级应用，功能聚焦在：
-1. 通过对话生成 Word 文档内容
-2. 基于模板保持格式一致
-3. 快速导出可用的 Word 文件
-
-### 优势
-- ✅ 前端基础架构完成
-- ✅ 双栏布局和编辑器可用
-- ✅ 代码质量高（TypeScript + 规范）
-
-### 挑战
-- ⚠️ Word 模板样式提取是核心难点
-- ⚠️ 格式保真需要大量测试
-- ⚠️ 后端开发进度待跟进
-
-### 下周重点
-**完成 Word 模板功能（上传 → 样式提取 → 导出）**
-
----
-
-**报告编制**: Kiro AI Assistant  
-**下次更新**: 2026-06-27