refactor: Remove mock service and integrate real API layer

- Remove MockDocumentSelector component and related mock UI logic
- Delete mock service files (mockService.ts, mockData.ts)
- Remove mock mode initialization from main.tsx
- Update blockService.ts to use only real API endpoints with improved type safety
- Update documentService.ts to integrate real API with enhanced error handling
- Refactor store types and API response types for consistency
- Simplify imports across services layer by removing mockAPI references
- Improve type definitions in editor and document types for real API contracts
- These changes complete the migration from mock-only development to production API integration

src/App.tsx

@@ -32,7 +32,6 @@ import zhCN from 'antd/locale/zh_CN';
 import { ErrorBoundary } from './components/common';
 import ResizableLayout from './components/Layout/ResizableLayout';
 import { useUIStore } from './stores/uiStore';
-import MockDocumentSelector from './components/MockDocumentSelector';
 
 // ── Lazy-loaded panel components (Req 13.2, 13.8) ────────────────────────────
 // These non-first-screen panels are split into separate chunks by Vite,
@@ -315,9 +314,6 @@ const App: React.FC = () => {
               />
             </div>
           </div>
-
-          {/* Mock文档选择器(仅Mock模式显示) */}
-          <MockDocumentSelector />
         </div>
       </ErrorBoundary>
     </ConfigProvider>

src/components/MockDocumentSelector.tsx

@@ -1,85 +0,0 @@
-/**
- * MockDocumentSelector.tsx - Mock文档选择器
- * 
- * 用于在Mock模式下快速选择测试文档
- * 
- * @module components
- */
-
-import React from 'react';
-import { Button, Space, Typography, Card } from 'antd';
-import { FileTextOutlined, ExperimentOutlined } from '@ant-design/icons';
-import { mockStorage } from '../services/mockData';
-import { isMockEnabled } from '../services/mockService';
-import { useUIStore } from '../stores/uiStore';
-
-const { Text } = Typography;
-
-/**
- * MockDocumentSelector - Mock文档选择器
- * 
- * 只在Mock模式下显示,提供快速打开测试文档的按钮
- */
-export const MockDocumentSelector: React.FC = () => {
-  const openDocumentPreview = useUIStore((state) => state.openDocumentPreview);
-
-  // 只在Mock模式下显示
-  if (!isMockEnabled()) {
-    return null;
-  }
-
-  const documents = mockStorage.getDocuments();
-
-  const handleOpenDocument = (documentId: string, title: string) => {
-    openDocumentPreview(documentId, title);
-  };
-
-  return (
-    <Card
-      style={{
-        position: 'fixed',
-        bottom: 20,
-        right: 20,
-        zIndex: 1000,
-        width: 350,
-        boxShadow: '0 4px 12px rgba(0, 0, 0, 0.15)',
-      }}
-      title={
-        <Space>
-          <ExperimentOutlined style={{ color: '#52c41a' }} />
-          <span>Mock测试模式</span>
-        </Space>
-      }
-      size="small"
-    >
-      <div style={{ marginBottom: 12 }}>
-        <Text type="secondary" style={{ fontSize: 12 }}>
-          当前为Mock模式,后端无需运行。点击下方按钮打开测试文档:
-        </Text>
-      </div>
-
-      <Space direction="vertical" style={{ width: '100%' }} size="small">
-        {documents.map((doc) => (
-          <Button
-            key={doc.id}
-            block
-            icon={<FileTextOutlined />}
-            onClick={() => handleOpenDocument(doc.id, doc.title)}
-            type="default"
-            size="small"
-          >
-            {doc.title}
-          </Button>
-        ))}
-      </Space>
-
-      <div style={{ marginTop: 12, paddingTop: 12, borderTop: '1px solid #f0f0f0' }}>
-        <Text type="secondary" style={{ fontSize: 11 }}>
-          提示: 在 main.tsx 中注释掉 enableMockService() 即可切换到真实后端
-        </Text>
-      </div>
-    </Card>
-  );
-};
-
-export default MockDocumentSelector;

src/main.tsx

@@ -2,11 +2,6 @@ import { StrictMode } from 'react';
 import { createRoot } from 'react-dom/client';
 import './index.css';
 import App from './App.tsx';
-import { enableMockService } from './services/mockService';
-
-// 启用Mock Service(后端不可用时使用)
-// 准备对接后端时,注释掉下面这行即可
-enableMockService();
 
 createRoot(document.getElementById('root')!).render(
   <StrictMode>

src/services/blockService.ts

@@ -2,18 +2,25 @@
  * blockService.ts - Block API服务
  * 
  * 与后端blocks API交互的服务层
- * 支持Mock模式(用于前端独立开发)
+ * 
+ * 功能包括：
+ * - CRUD操作：获取、创建、更新、删除blocks
+ * - 高级功能：搜索、目录树、统计信息
  * 
  * @module services/blockService
  */
 
 import apiClient from './api';
-import { mockAPI } from './mockService';
 import type {
   DocumentBlock,
   GetBlocksResponse,
-  UpdateBlocksRequest,
+  GetBlockResponse,
+  UpdateBlockRequest,
+  UpdateBlockResponse,
   CreateBlockRequest,
+  SearchBlocksResponse,
+  GetTOCResponse,
+  BlockStatsResponse,
 } from '../types/editor';
 
 // ══════════════════════════════════════════════════════════════════════════════
@@ -43,21 +50,13 @@ export const blockService = {
    * ```
    */
   async getBlocks(documentId: string): Promise<GetBlocksResponse> {
-    // Mock模式
-    if (mockAPI.isEnabled()) {
-      return mockAPI.blocks.getBlocks(documentId);
-    }
-
-    // 真实API
     try {
       const response = await apiClient.get(`${BLOCKS_BASE_URL}/${documentId}/blocks`);
       
-      // 后端返回格式: { data: { documentId, title, blocks } }
+      // 后端返回格式: { code: 0, data: { blocks: [] } }
       const data = response.data?.data || response.data;
       
       return {
-        documentId: data.documentId || documentId,
-        title: data.title || '',
         blocks: data.blocks || [],
       };
     } catch (error: any) {
@@ -67,30 +66,31 @@ export const blockService = {
   },
 
   /**
-   * 批量更新文档的所有blocks
+   * 获取单个block
    * 
    * @param documentId 文档ID
-   * @param blocks 所有blocks数据
+   * @param blockId 块ID
+   * @returns Block数据
    * 
    * @example
    * ```ts
-   * await blockService.updateBlocks('doc-123', blocks);
+   * const data = await blockService.getBlock('doc-123', 'block-h1-0');
+   * console.log(data.block);
    * ```
    */
-  async updateBlocks(documentId: string, blocks: DocumentBlock[]): Promise<void> {
-    // Mock模式
-    if (mockAPI.isEnabled()) {
-      return mockAPI.blocks.updateBlocks(documentId, blocks);
-    }
-
-    // 真实API
+  async getBlock(documentId: string, blockId: string): Promise<GetBlockResponse> {
     try {
-      const requestData: UpdateBlocksRequest = { blocks };
+      const response = await apiClient.get(
+        `${BLOCKS_BASE_URL}/${documentId}/blocks/${blockId}`
+      );
       
-      await apiClient.put(`${BLOCKS_BASE_URL}/${documentId}/blocks`, requestData);
+      const data = response.data?.data || response.data;
+      return {
+        block: data.block,
+      };
     } catch (error: any) {
-      console.error('Failed to update blocks:', error);
-      throw new Error(error.response?.data?.message || '更新文档块失败');
+      console.error('Failed to get block:', error);
+      throw new Error(error.response?.data?.message || '获取块失败');
     }
   },
 
@@ -100,6 +100,7 @@ export const blockService = {
    * @param documentId 文档ID
    * @param blockId 块ID
    * @param updates 更新的字段
+   * @returns 更新响应
    * 
    * @example
    * ```ts
@@ -111,19 +112,19 @@ export const blockService = {
   async updateBlock(
     documentId: string,
     blockId: string,
-    updates: Partial<DocumentBlock>
-  ): Promise<void> {
-    // Mock模式
-    if (mockAPI.isEnabled()) {
-      return mockAPI.blocks.updateBlock(documentId, blockId, updates);
-    }
-
-    // 真实API
+    updates: UpdateBlockRequest
+  ): Promise<UpdateBlockResponse> {
     try {
-      await apiClient.patch(
+      const response = await apiClient.put(
         `${BLOCKS_BASE_URL}/${documentId}/blocks/${blockId}`,
         updates
       );
+      
+      const data = response.data?.data || response.data;
+      return {
+        blockId: data.blockId || blockId,
+        message: data.message || 'Block updated successfully',
+      };
     } catch (error: any) {
       console.error('Failed to update block:', error);
       throw new Error(error.response?.data?.message || '更新块失败');
@@ -141,7 +142,6 @@ export const blockService = {
    * ```ts
    * const newBlock = await blockService.createBlock('doc-123', {
    *   type: 'paragraph',
-   *   block_order: 100,
    *   level: 0,
    *   index: 0,
    *   content: '新段落',
@@ -153,12 +153,6 @@ export const blockService = {
     documentId: string,
     block: CreateBlockRequest
   ): Promise<DocumentBlock> {
-    // Mock模式
-    if (mockAPI.isEnabled()) {
-      return mockAPI.blocks.createBlock(documentId, block);
-    }
-
-    // 真实API
     try {
       const response = await apiClient.post(
         `${BLOCKS_BASE_URL}/${documentId}/blocks`,
@@ -184,12 +178,6 @@ export const blockService = {
    * ```
    */
   async deleteBlock(documentId: string, blockId: string): Promise<void> {
-    // Mock模式
-    if (mockAPI.isEnabled()) {
-      return mockAPI.blocks.deleteBlock(documentId, blockId);
-    }
-
-    // 真实API
     try {
       await apiClient.delete(`${BLOCKS_BASE_URL}/${documentId}/blocks/${blockId}`);
     } catch (error: any) {
@@ -199,58 +187,101 @@ export const blockService = {
   },
 
   /**
-   * 移动block(调整block_order)
+   * 搜索blocks
    * 
    * @param documentId 文档ID
-   * @param blockId 块ID
-   * @param newOrder 新的block_order
+   * @param query 搜索关键词
+   * @param type 可选的block类型筛选
+   * @returns 搜索结果
    * 
    * @example
    * ```ts
-   * await blockService.moveBlock('doc-123', 'block-h1-0', 150);
+   * const results = await blockService.searchBlocks('doc-123', '关键词');
+   * console.log(results.blocks, results.total);
    * ```
    */
-  async moveBlock(
+  async searchBlocks(
     documentId: string,
-    blockId: string,
-    newOrder: number
-  ): Promise<void> {
+    query: string,
+    type?: string
+  ): Promise<SearchBlocksResponse> {
+    try {
+      const params: Record<string, string> = { q: query };
+      if (type) {
+        params.type = type;
+      }
+
+      const response = await apiClient.get(
+        `${BLOCKS_BASE_URL}/${documentId}/blocks/search`,
+        { params }
+      );
+      
+      const data = response.data?.data || response.data;
+      return {
+        blocks: data.blocks || [],
+        total: data.total || 0,
+        query: data.query || query,
+      };
+    } catch (error: any) {
+      console.error('Failed to search blocks:', error);
+      throw new Error(error.response?.data?.message || '搜索块失败');
+    }
+  },
+
+  /**
+   * 获取文档目录树
+   * 
+   * @param documentId 文档ID
+   * @returns 目录树
+   * 
+   * @example
+   * ```ts
+   * const { toc } = await blockService.getTOC('doc-123');
+   * console.log(toc); // 树形结构的标题目录
+   * ```
+   */
+  async getTOC(documentId: string): Promise<GetTOCResponse> {
     try {
-      await apiClient.patch(`${BLOCKS_BASE_URL}/${documentId}/blocks/${blockId}`, {
-        block_order: newOrder,
-      });
+      const response = await apiClient.get(
+        `${BLOCKS_BASE_URL}/${documentId}/blocks/toc`
+      );
+      
+      const data = response.data?.data || response.data;
+      return {
+        toc: data.toc || [],
+      };
     } catch (error: any) {
-      console.error('Failed to move block:', error);
-      throw new Error(error.response?.data?.message || '移动块失败');
+      console.error('Failed to get TOC:', error);
+      throw new Error(error.response?.data?.message || '获取目录树失败');
     }
   },
 
   /**
-   * 重新排序所有blocks(批量更新block_order)
+   * 获取block统计信息
    * 
    * @param documentId 文档ID
-   * @param blockOrders block ID到新order的映射
+   * @returns 统计信息
    * 
    * @example
    * ```ts
-   * await blockService.reorderBlocks('doc-123', {
-   *   'block-h1-0': 0,
-   *   'block-p-1': 100,
-   *   'block-p-2': 200,
-   * });
+   * const stats = await blockService.getStats('doc-123');
+   * console.log(stats.total, stats.by_type);
    * ```
    */
-  async reorderBlocks(
-    documentId: string,
-    blockOrders: Record<string, number>
-  ): Promise<void> {
+  async getStats(documentId: string): Promise<BlockStatsResponse> {
     try {
-      await apiClient.post(`${BLOCKS_BASE_URL}/${documentId}/blocks/reorder`, {
-        blockOrders,
-      });
+      const response = await apiClient.get(
+        `${BLOCKS_BASE_URL}/${documentId}/blocks/stats`
+      );
+      
+      const data = response.data?.data || response.data;
+      return {
+        total: data.total || 0,
+        by_type: data.by_type || data.byType || {},
+      };
     } catch (error: any) {
-      console.error('Failed to reorder blocks:', error);
-      throw new Error(error.response?.data?.message || '重新排序块失败');
+      console.error('Failed to get stats:', error);
+      throw new Error(error.response?.data?.message || '获取统计信息失败');
     }
   },
 };

src/services/documentService.ts

@@ -2,13 +2,15 @@
  * Document Service Module
  *
  * Provides methods for document management operations:
- * - createDocument: Parse Word document and create Markdown document
- * - getDocument: Get document details by ID
- * - updateDocument: Update document content (full or partial)
+ * - createDocument: Parse Word document and create document with blocks stored in SQLite
+ * - getDocument: Get document details by ID (optionally with blocks)
  * - deleteDocuments: Delete all documents for a session
  * - listDocuments: Get paginated list of documents
  *
  * All methods use the configured API client and provide error normalization.
+ * 
+ * Note: Document content is stored as blocks in SQLite (via contentDbPath).
+ * Use blockService to read/update document content.
  *
  * @module services/documentService
  */
@@ -19,20 +21,19 @@ import type {
   CreateDocumentRequest,
   CreateDocumentResponse,
   Document,
-  UpdateDocumentRequest,
-  UpdateDocumentResponse,
   ListDocumentsResponse,
   DocumentListFilters,
+  GetDocumentOptions,
 } from '../types/document';
 
 /**
  * Create a new document from a Word file URL
  *
- * Sends a Word document URL to the backend for parsing into Markdown format.
- * The backend downloads the file, parses it, and stores the Markdown content.
+ * Sends a Word document URL to the backend for parsing into blocks.
+ * The backend downloads the file, parses it, and stores blocks in SQLite.
  *
  * @param request - Create document request payload
- * @returns Created document metadata
+ * @returns Created document metadata including contentDbPath
  * @throws {Error} When the API request fails or file cannot be parsed
  */
 export const createDocument = async (
@@ -61,80 +62,33 @@ export const createDocument = async (
 /**
  * Get document details by ID
  *
- * Retrieves the full document including its Markdown content.
+ * Retrieves document metadata. Optionally includes blocks array.
  *
  * @param documentId - Document ID to retrieve
- * @returns Document entity with full content
+ * @param options - Options including includeBlocks flag
+ * @returns Document entity (with blocks if requested)
  * @throws {Error} When the document is not found or request fails
  */
-export const getDocument = async (documentId: string): Promise<Document> => {
+export const getDocument = async (
+  documentId: string,
+  options: GetDocumentOptions = {}
+): Promise<Document> => {
   try {
-    const response = await apiClient.get<ApiResponse<Document>>(
-      `/api/v1/documents/${documentId}`
-    );
-    return response.data.data;
-  } catch (error: any) {
-    let friendlyMessage = '获取文档失败';
-
-    if (error?.response?.status === 404) {
-      friendlyMessage = '文档不存在';
+    const params: Record<string, any> = {};
+    if (options.includeBlocks) {
+      params.includeBlocks = true;
     }
 
-    const message = getErrorMessage(error);
-    throw new Error(`${friendlyMessage}: ${message}`, { cause: error });
-  }
-};
-
-/**
- * Get document content by ID (convenience method)
- *
- * This is an alias for getDocument() that retrieves the full document
- * including its title and Markdown content. Useful for preview/editing scenarios.
- *
- * @param documentId - Document ID to retrieve
- * @returns Document with title and content
- * @throws {Error} When the document is not found or request fails
- */
-export const getDocumentContent = async (
-  documentId: string
-): Promise<{ title: string; content: string; id: string }> => {
-  const document = await getDocument(documentId);
-  return {
-    id: document.id,
-    title: document.title,
-    content: document.content,
-  };
-};
-
-/**
- * Update document content
- *
- * Supports two update modes:
- * - Full update: Pass `content` to replace entire document
- * - Partial update: Pass `blocks` to update specific sections by heading level
- *
- * @param documentId - Document ID to update
- * @param request - Update request (content OR blocks, not both)
- * @returns Update response with new timestamp
- * @throws {Error} When document not found or validation fails
- */
-export const updateDocument = async (
-  documentId: string,
-  request: UpdateDocumentRequest
-): Promise<UpdateDocumentResponse> => {
-  try {
-    const response = await apiClient.put<ApiResponse<UpdateDocumentResponse>>(
+    const response = await apiClient.get<ApiResponse<Document>>(
       `/api/v1/documents/${documentId}`,
-      request
+      { params }
     );
     return response.data.data;
   } catch (error: any) {
-    let friendlyMessage = '更新文档失败';
+    let friendlyMessage = '获取文档失败';
 
     if (error?.response?.status === 404) {
       friendlyMessage = '文档不存在';
-    } else if (error?.response?.status === 422) {
-      friendlyMessage = '更新数据验证失败（content和blocks不能同时传入）';
     }
 
     const message = getErrorMessage(error);
@@ -200,8 +154,6 @@ export const listDocuments = async (
 export const documentService = {
   create: createDocument,
   get: getDocument,
-  getContent: getDocumentContent,
-  update: updateDocument,
   delete: deleteDocuments,
   list: listDocuments,
 };

src/services/index.ts

@@ -11,11 +11,19 @@ export {
   createDocument,
   getDocument,
   listDocuments,
-  updateDocument,
   deleteDocuments,
   documentService,
 } from './documentService';
 
 export { exportToWord, exportService } from './exportService';
 
+export {
+  listExportRecords,
+  downloadExportRecord,
+  deleteExportRecord,
+  getAdminStorage,
+  exportRecordService,
+} from './exportRecordService';
+
 export { blockService } from './blockService';
+

src/services/mockData.ts

@@ -1,384 +0,0 @@
-/**
- * mockData.ts - Mock数据存储
- * 
- * 提供测试用的示例文档和块数据
- * 
- * @module services/mockData
- */
-
-import type { DocumentBlock, HeadingBlock, ParagraphBlock, TableBlock } from '../types/editor';
-
-// ══════════════════════════════════════════════════════════════════════════════
-// Mock文档数据
-// ══════════════════════════════════════════════════════════════════════════════
-
-interface MockDocument {
-  id: string;
-  title: string;
-  createdAt: string;
-  updatedAt: string;
-}
-
-const mockDocuments: MockDocument[] = [
-  {
-    id: 'doc-demo-1',
-    title: '示例文档 - 完整功能演示',
-    createdAt: '2026-01-01T00:00:00Z',
-    updatedAt: '2026-01-01T00:00:00Z',
-  },
-  {
-    id: 'doc-demo-2',
-    title: '空白文档',
-    createdAt: '2026-01-02T00:00:00Z',
-    updatedAt: '2026-01-02T00:00:00Z',
-  },
-];
-
-// ══════════════════════════════════════════════════════════════════════════════
-// Mock Block数据
-// ══════════════════════════════════════════════════════════════════════════════
-
-/**
- * 示例文档的blocks
- */
-const demoBlocks: DocumentBlock[] = [
-  // H1 标题
-  {
-    id: 'block-h1-1',
-    type: 'heading',
-    level: 1,
-    index: 0,
-    block_order: 0,
-    word_style: 'Heading1',
-    content: '第一章 文档编辑器功能演示',
-    style: {},
-    metadata: {
-      parent_id: null,
-    },
-  } as HeadingBlock,
-
-  // 段落
-  {
-    id: 'block-p-1',
-    type: 'paragraph',
-    level: 0,
-    index: 0,
-    block_order: 100,
-    word_style: 'Normal',
-    content: '这是一个功能完整的文档编辑器,支持标题、段落、表格、图片等多种块类型。',
-    style: {},
-    metadata: {
-      parent_heading_id: 'block-h1-1',
-    },
-  } as ParagraphBlock,
-
-  // H2 标题
-  {
-    id: 'block-h2-1',
-    type: 'heading',
-    level: 2,
-    index: 0,
-    block_order: 200,
-    word_style: 'Heading2',
-    content: '1.1 富文本编辑',
-    style: {},
-    metadata: {
-      parent_id: 'block-h1-1',
-    },
-  } as HeadingBlock,
-
-  // 段落 - 富文本
-  {
-    id: 'block-p-2',
-    type: 'paragraph',
-    level: 0,
-    index: 0,
-    block_order: 300,
-    word_style: 'Normal',
-    content: [
-      { text: '支持 ', style: {} },
-      { text: '加粗', style: { bold: true } },
-      { text: '、', style: {} },
-      { text: '斜体', style: { italic: true } },
-      { text: '、', style: {} },
-      { text: '下划线', style: { underline: true } },
-      { text: ' 等格式。', style: {} },
-    ],
-    style: {},
-    metadata: {
-      parent_heading_id: 'block-h2-1',
-    },
-  } as ParagraphBlock,
-
-  // H2 标题
-  {
-    id: 'block-h2-2',
-    type: 'heading',
-    level: 2,
-    index: 1,
-    block_order: 400,
-    word_style: 'Heading2',
-    content: '1.2 表格功能',
-    style: {},
-    metadata: {
-      parent_id: 'block-h1-1',
-    },
-  } as HeadingBlock,
-
-  // 段落
-  {
-    id: 'block-p-3',
-    type: 'paragraph',
-    level: 0,
-    index: 0,
-    block_order: 500,
-    word_style: 'Normal',
-    content: '表格支持插入、删除行列,以及单元格合并与拆分:',
-    style: {},
-    metadata: {
-      parent_heading_id: 'block-h2-2',
-    },
-  } as ParagraphBlock,
-
-  // 表格
-  {
-    id: 'block-tbl-1',
-    type: 'table',
-    level: 0,
-    index: 0,
-    block_order: 600,
-    word_style: 'TableNormal',
-    content: {
-      rows: [
-        {
-          cells: [
-            { text: '功能', rowspan: 1, colspan: 1, style: { bold: true } },
-            { text: '说明', rowspan: 1, colspan: 1, style: { bold: true } },
-            { text: '快捷键', rowspan: 1, colspan: 1, style: { bold: true } },
-          ],
-        },
-        {
-          cells: [
-            { text: '插入行', rowspan: 1, colspan: 1, style: {} },
-            { text: '在当前行下方插入新行', rowspan: 1, colspan: 1, style: {} },
-            { text: '-', rowspan: 1, colspan: 1, style: {} },
-          ],
-        },
-        {
-          cells: [
-            { text: '合并单元格', rowspan: 1, colspan: 1, style: {} },
-            { text: 'Shift+点击选择范围后合并', rowspan: 1, colspan: 1, style: {} },
-            { text: 'Shift+Click', rowspan: 1, colspan: 1, style: {} },
-          ],
-        },
-      ],
-    },
-    style: {},
-    metadata: {
-      cols: 3,
-      rows: 3,
-      table_width: 100,
-      table_width_unit: 'percent',
-      col_widths: [25, 50, 25],
-      parent_heading_id: 'block-h2-2',
-    },
-  } as TableBlock,
-
-  // H1 标题
-  {
-    id: 'block-h1-2',
-    type: 'heading',
-    level: 1,
-    index: 1,
-    block_order: 700,
-    word_style: 'Heading1',
-    content: '第二章 文档大纲',
-    style: {},
-    metadata: {
-      parent_id: null,
-    },
-  } as HeadingBlock,
-
-  // 段落
-  {
-    id: 'block-p-4',
-    type: 'paragraph',
-    level: 0,
-    index: 0,
-    block_order: 800,
-    word_style: 'Normal',
-    content: '右侧显示文档大纲,可以快速导航到各个章节。点击大纲节点会自动滚动到对应位置。',
-    style: {},
-    metadata: {
-      parent_heading_id: 'block-h1-2',
-    },
-  } as ParagraphBlock,
-
-  // H2 标题
-  {
-    id: 'block-h2-3',
-    type: 'heading',
-    level: 2,
-    index: 0,
-    block_order: 900,
-    word_style: 'Heading2',
-    content: '2.1 大纲功能',
-    style: {},
-    metadata: {
-      parent_id: 'block-h1-2',
-    },
-  } as HeadingBlock,
-
-  // 段落
-  {
-    id: 'block-p-5',
-    type: 'paragraph',
-    level: 0,
-    index: 0,
-    block_order: 1000,
-    word_style: 'Normal',
-    content: '• 展开/折叠子标题\n• 点击跳转定位\n• 高亮当前位置',
-    style: {},
-    metadata: {
-      parent_heading_id: 'block-h2-3',
-    },
-  } as ParagraphBlock,
-
-  // H3 标题
-  {
-    id: 'block-h3-1',
-    type: 'heading',
-    level: 3,
-    index: 0,
-    block_order: 1100,
-    word_style: 'Heading3',
-    content: '2.1.1 树形结构',
-    style: {},
-    metadata: {
-      parent_id: 'block-h2-3',
-    },
-  } as HeadingBlock,
-
-  // 段落
-  {
-    id: 'block-p-6',
-    type: 'paragraph',
-    level: 0,
-    index: 0,
-    block_order: 1200,
-    word_style: 'Normal',
-    content: '大纲自动根据标题层级构建树形结构,支持多级嵌套。',
-    style: {},
-    metadata: {
-      parent_heading_id: 'block-h3-1',
-    },
-  } as ParagraphBlock,
-];
-
-/**
- * 空白文档的blocks
- */
-const emptyBlocks: DocumentBlock[] = [];
-
-// ══════════════════════════════════════════════════════════════════════════════
-// Mock数据存储管理
-// ══════════════════════════════════════════════════════════════════════════════
-
-class MockStorage {
-  private documents: Map<string, MockDocument>;
-  private blocks: Map<string, DocumentBlock[]>;
-
-  constructor() {
-    this.documents = new Map();
-    this.blocks = new Map();
-    this.initialize();
-  }
-
-  /**
-   * 初始化Mock数据
-   */
-  private initialize() {
-    // 添加文档
-    mockDocuments.forEach((doc) => {
-      this.documents.set(doc.id, doc);
-    });
-
-    // 添加blocks
-    this.blocks.set('doc-demo-1', demoBlocks);
-    this.blocks.set('doc-demo-2', emptyBlocks);
-  }
-
-  /**
-   * 获取所有文档
-   */
-  getDocuments(): MockDocument[] {
-    return Array.from(this.documents.values());
-  }
-
-  /**
-   * 获取单个文档
-   */
-  getDocument(id: string): MockDocument | undefined {
-    return this.documents.get(id);
-  }
-
-  /**
-   * 创建文档
-   */
-  createDocument(title: string): MockDocument {
-    const id = `doc-${Date.now()}`;
-    const doc: MockDocument = {
-      id,
-      title,
-      createdAt: new Date().toISOString(),
-      updatedAt: new Date().toISOString(),
-    };
-
-    this.documents.set(id, doc);
-    this.blocks.set(id, []);
-
-    return doc;
-  }
-
-  /**
-   * 删除文档
-   */
-  deleteDocument(id: string): boolean {
-    const deleted = this.documents.delete(id);
-    if (deleted) {
-      this.blocks.delete(id);
-    }
-    return deleted;
-  }
-
-  /**
-   * 获取文档的blocks
-   */
-  getBlocks(documentId: string): DocumentBlock[] {
-    return this.blocks.get(documentId) || [];
-  }
-
-  /**
-   * 更新文档的blocks
-   */
-  updateBlocks(documentId: string, blocks: DocumentBlock[]): void {
-    this.blocks.set(documentId, blocks);
-  }
-
-  /**
-   * 重置所有数据
-   */
-  reset(): void {
-    this.documents.clear();
-    this.blocks.clear();
-    this.initialize();
-  }
-}
-
-// ══════════════════════════════════════════════════════════════════════════════
-// 导出
-// ══════════════════════════════════════════════════════════════════════════════
-
-export const mockStorage = new MockStorage();
-
-export default mockStorage;

src/services/mockService.ts

@@ -1,285 +0,0 @@
-/**
- * mockService.ts - Mock API服务
- * 
- * 模拟后端API响应,用于前端独立开发测试
- * 
- * 使用方法:
- * 1. 在main.tsx中导入并启用: `enableMockService()`
- * 2. 正常使用API,会自动被拦截并返回Mock数据
- * 3. 准备对接后端时,移除enableMockService()调用
- * 
- * @module services/mockService
- */
-
-import { mockStorage } from './mockData';
-import type { DocumentBlock, GetBlocksResponse } from '../types/editor';
-
-// ══════════════════════════════════════════════════════════════════════════════
-// Mock延迟(模拟网络请求)
-// ══════════════════════════════════════════════════════════════════════════════
-
-const MOCK_DELAY = 300; // 毫秒
-
-function delay(ms: number = MOCK_DELAY): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-// ══════════════════════════════════════════════════════════════════════════════
-// Mock API实现
-// ══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Mock Blocks API
- */
-export const mockBlocksAPI = {
-  /**
-   * 获取文档blocks
-   */
-  async getBlocks(documentId: string): Promise<GetBlocksResponse> {
-    await delay();
-    
-    const doc = mockStorage.getDocument(documentId);
-    const blocks = mockStorage.getBlocks(documentId);
-    
-    if (!doc) {
-      throw new Error(`文档不存在: ${documentId}`);
-    }
-    
-    console.log(`[Mock API] GET /api/v1/documents/${documentId}/blocks`, {
-      documentId,
-      title: doc.title,
-      blocksCount: blocks.length,
-    });
-    
-    return {
-      documentId: doc.id,
-      title: doc.title,
-      blocks,
-    };
-  },
-
-  /**
-   * 更新文档blocks
-   */
-  async updateBlocks(documentId: string, blocks: DocumentBlock[]): Promise<void> {
-    await delay();
-    
-    const doc = mockStorage.getDocument(documentId);
-    if (!doc) {
-      throw new Error(`文档不存在: ${documentId}`);
-    }
-    
-    mockStorage.updateBlocks(documentId, blocks);
-    
-    console.log(`[Mock API] PUT /api/v1/documents/${documentId}/blocks`, {
-      documentId,
-      blocksCount: blocks.length,
-      success: true,
-    });
-  },
-
-  /**
-   * 更新单个block
-   */
-  async updateBlock(
-    documentId: string,
-    blockId: string,
-    updates: Partial<DocumentBlock>
-  ): Promise<void> {
-    await delay();
-    
-    const blocks = mockStorage.getBlocks(documentId);
-    const index = blocks.findIndex((b: DocumentBlock) => b.id === blockId);
-    
-    if (index === -1) {
-      throw new Error(`Block不存在: ${blockId}`);
-    }
-    
-    // 使用类型断言来合并更新,因为Partial<DocumentBlock>与联合类型兼容
-    blocks[index] = { ...blocks[index], ...updates } as DocumentBlock;
-    mockStorage.updateBlocks(documentId, blocks);
-    
-    console.log(`[Mock API] PATCH /api/v1/documents/${documentId}/blocks/${blockId}`, {
-      blockId,
-      updates,
-      success: true,
-    });
-  },
-
-  /**
-   * 创建block
-   */
-  async createBlock(documentId: string, block: any): Promise<DocumentBlock> {
-    await delay();
-    
-    const blocks = mockStorage.getBlocks(documentId);
-    const newBlock = {
-      id: `block-${Date.now()}`,
-      ...block,
-    } as DocumentBlock;
-    
-    blocks.push(newBlock);
-    mockStorage.updateBlocks(documentId, blocks);
-    
-    console.log(`[Mock API] POST /api/v1/documents/${documentId}/blocks`, {
-      documentId,
-      blockId: newBlock.id,
-      success: true,
-    });
-    
-    return newBlock;
-  },
-
-  /**
-   * 删除block
-   */
-  async deleteBlock(documentId: string, blockId: string): Promise<void> {
-    await delay();
-    
-    const blocks = mockStorage.getBlocks(documentId);
-    const filtered = blocks.filter((b: DocumentBlock) => b.id !== blockId);
-    
-    mockStorage.updateBlocks(documentId, filtered);
-    
-    console.log(`[Mock API] DELETE /api/v1/documents/${documentId}/blocks/${blockId}`, {
-      blockId,
-      success: true,
-    });
-  },
-};
-
-/**
- * Mock Documents API
- */
-export const mockDocumentsAPI = {
-  /**
-   * 获取文档列表
-   */
-  async listDocuments(): Promise<any[]> {
-    await delay();
-    
-    const docs = mockStorage.getDocuments();
-    
-    console.log(`[Mock API] GET /api/v1/documents`, {
-      count: docs.length,
-    });
-    
-    return docs;
-  },
-
-  /**
-   * 获取单个文档
-   */
-  async getDocument(id: string): Promise<any> {
-    await delay();
-    
-    const doc = mockStorage.getDocument(id);
-    
-    if (!doc) {
-      throw new Error(`文档不存在: ${id}`);
-    }
-    
-    console.log(`[Mock API] GET /api/v1/documents/${id}`, doc);
-    
-    return doc;
-  },
-
-  /**
-   * 创建文档
-   */
-  async createDocument(title: string): Promise<any> {
-    await delay();
-    
-    const doc = mockStorage.createDocument(title);
-    
-    console.log(`[Mock API] POST /api/v1/documents`, doc);
-    
-    return doc;
-  },
-
-  /**
-   * 删除文档
-   */
-  async deleteDocument(id: string): Promise<void> {
-    await delay();
-    
-    const success = mockStorage.deleteDocument(id);
-    
-    if (!success) {
-      throw new Error(`删除失败: ${id}`);
-    }
-    
-    console.log(`[Mock API] DELETE /api/v1/documents/${id}`, {
-      success: true,
-    });
-  },
-};
-
-// ══════════════════════════════════════════════════════════════════════════════
-// Mock Service启用/禁用
-// ══════════════════════════════════════════════════════════════════════════════
-
-let mockEnabled = false;
-
-/**
- * 启用Mock Service
- * 
- * 在main.tsx中调用此方法来启用Mock模式
- * 
- * @example
- * ```ts
- * import { enableMockService } from './services/mockService';
- * 
- * if (import.meta.env.DEV) {
- *   enableMockService();
- * }
- * ```
- */
-export function enableMockService() {
-  mockEnabled = true;
-  console.log(
-    '%c[Mock Service] 已启用',
-    'color: #52c41a; font-weight: bold; font-size: 14px;'
-  );
-  console.log(
-    '%c所有API请求将返回Mock数据,后端无需运行',
-    'color: #1890ff; font-size: 12px;'
-  );
-  console.log(
-    '%c可用的测试文档:',
-    'color: #722ed1; font-weight: bold; font-size: 12px;'
-  );
-  mockStorage.getDocuments().forEach((doc: any, index: number) => {
-    console.log(`  ${index + 1}. ${doc.title} (${doc.id})`);
-  });
-}
-
-/**
- * 禁用Mock Service
- */
-export function disableMockService() {
-  mockEnabled = false;
-  console.log(
-    '%c[Mock Service] 已禁用',
-    'color: #ff4d4f; font-weight: bold; font-size: 14px;'
-  );
-}
-
-/**
- * 检查Mock是否启用
- */
-export function isMockEnabled(): boolean {
-  return mockEnabled;
-}
-
-// ══════════════════════════════════════════════════════════════════════════════
-// 导出Mock API(供blockService使用)
-// ══════════════════════════════════════════════════════════════════════════════
-
-export const mockAPI = {
-  blocks: mockBlocksAPI,
-  documents: mockDocumentsAPI,
-  isEnabled: isMockEnabled,
-};
-
-export default mockAPI;

src/stores/documentStore.ts

@@ -13,8 +13,8 @@
 
 import { create } from 'zustand';
 import type { DocumentStoreState } from '../types/store';
-import type { Document, DocumentListFilters } from '../types/document';
-import type { CreateDocumentRequest, UpdateDocumentRequest, ListFilters } from '../types/api';
+import type { Document, DocumentListFilters, CreateDocumentRequest } from '../types/document';
+import type { ListFilters } from '../types/api';
 import * as documentService from '../services/documentService';
 
 /**
@@ -69,23 +69,15 @@ export const useDocumentStore = create<DocumentStoreState>((set, get) => ({
    * Creates a document via the API and sets it as the current document.
    * Save status is set to 'saved' after successful creation.
    *
-   * @param req - Document creation request
+   * @param req - Document creation request (userId, fileUrl, sessionId)
    * @throws {Error} When document creation fails
    */
   createDocument: async (req: CreateDocumentRequest) => {
     try {
       set({ saveStatus: 'saving' });
 
-      // 转换API请求格式到documentService需要的格式
-      const serviceReq: import('../types/document').CreateDocumentRequest = {
-        userId: 'default-user', // TODO: 从认证上下文获取
-        fileUrl: '', // API类型中不需要此字段,使用空字符串
-        sessionId: req.sessionId || 'default-session',
-        title: req.title,
-      };
-
       // Call API to create document
-      const response = await documentService.createDocument(serviceReq);
+      const response = await documentService.createDocument(req);
 
       // Fetch the full document to set as current
       const fullDocument = await documentService.getDocument(response.documentId);
@@ -108,13 +100,15 @@ export const useDocumentStore = create<DocumentStoreState>((set, get) => ({
    * Fetch a document by ID
    *
    * Retrieves a document from the API and sets it as the current document.
+   * Optionally includes blocks array.
    *
    * @param id - Document ID to fetch
+   * @param includeBlocks - Whether to include blocks in response
    * @throws {Error} When document fetch fails
    */
-  fetchDocument: async (id: string) => {
+  fetchDocument: async (id: string, includeBlocks: boolean = false) => {
     try {
-      const document = await documentService.getDocument(id);
+      const document = await documentService.getDocument(id, { includeBlocks });
 
       set({
         currentDocument: document,
@@ -137,12 +131,14 @@ export const useDocumentStore = create<DocumentStoreState>((set, get) => ({
    */
   fetchDocumentList: async (filters?: ListFilters) => {
     try {
-      // 提供默认的filters以满足API要求
+      // 转换前端的camelCase字段名为后端的snake_case
       const apiFilters: DocumentListFilters = {
         userId: 'default-user', // TODO: 从认证上下文获取
         page: filters?.page,
         pageSize: filters?.pageSize,
-        sortBy: filters?.sortBy,
+        sortBy: filters?.sortBy === 'createdAt' ? 'created_at' : 
+                filters?.sortBy === 'updatedAt' ? 'updated_at' : 
+                undefined,
         sortOrder: filters?.sortOrder,
       };
       
@@ -159,54 +155,20 @@ export const useDocumentStore = create<DocumentStoreState>((set, get) => ({
   },
 
   /**
-   * Update an existing document
-   *
-   * Updates a document via the API. If the updated document is the current document,
-   * refreshes the current document state.
-   *
-   * @param id - Document ID to update
-   * @param req - Update request (partial fields supported)
-   * @throws {Error} When document update fails
-   */
-  updateDocument: async (id: string, req: UpdateDocumentRequest) => {
-    try {
-      set({ saveStatus: 'saving' });
-
-      await documentService.updateDocument(id, req);
-
-      // If we updated the current document, refresh it
-      const currentDoc = get().currentDocument;
-      if (currentDoc && currentDoc.id === id) {
-        await get().fetchDocument(id);
-      }
-
-      set({ saveStatus: 'saved' });
-
-      // Refresh document list to reflect changes
-      await get().fetchDocumentList();
-    } catch (error) {
-      set({ saveStatus: 'error' });
-      throw error;
-    }
-  },
-
-  /**
-   * Delete a document by ID
+   * Delete documents by session ID
    *
-   * Deletes a document via the API. If the deleted document is the current document,
-   * clears the current document state.
+   * Deletes all documents for a session via the API.
+   * If any deleted document is the current document, clears the current document state.
    *
-   * @param id - Document ID to delete
+   * @param sessionId - Session ID whose documents to delete
    * @throws {Error} When document deletion fails
    */
-  deleteDocument: async (id: string) => {
-    // 注意: documentService.deleteDocuments 接收 sessionId 参数
-    // 这里使用文档ID作为sessionId (需要根据实际API调整)
-    await documentService.deleteDocuments(id);
+  deleteDocumentsBySession: async (sessionId: string) => {
+    await documentService.deleteDocuments(sessionId);
 
-    // If we deleted the current document, clear it
+    // Clear current document if it belonged to this session
     const currentDoc = get().currentDocument;
-    if (currentDoc && currentDoc.id === id) {
+    if (currentDoc && currentDoc.sessionId === sessionId) {
       set({ currentDocument: null, saveStatus: 'saved' });
     }
 
@@ -215,56 +177,17 @@ export const useDocumentStore = create<DocumentStoreState>((set, get) => ({
   },
 
   /**
-   * Update current document content (local state only)
-   *
-   * Updates the content of the current document in local state only.
-   * Does NOT persist to the backend. Sets save status to 'unsaved'.
-   *
-   * This is typically used for real-time editing, with auto-save
-   * handling the actual persistence.
-   *
-   * @param content - New content string
-   */
-  updateContent: (content: string) => {
-    const currentDoc = get().currentDocument;
-    if (!currentDoc) return;
-
-    const updatedDoc: Document = {
-      ...currentDoc,
-      content,
-      updatedAt: Date.now(),
-    };
-
-    set({
-      currentDocument: updatedDoc,
-      saveStatus: 'unsaved',
-    });
-  },
-
-  /**
-   * Update current document title (local state only)
+   * Set current document
    *
-   * Updates the title of the current document in local state only.
-   * Does NOT persist to the backend. Sets save status to 'unsaved'.
+   * Directly sets the current document in state (local only).
+   * Used when document is already loaded.
    *
-   * This is typically used for real-time editing, with auto-save
-   * handling the actual persistence.
-   *
-   * @param title - New title string
+   * @param document - Document to set as current
    */
-  updateTitle: (title: string) => {
-    const currentDoc = get().currentDocument;
-    if (!currentDoc) return;
-
-    const updatedDoc: Document = {
-      ...currentDoc,
-      title,
-      updatedAt: Date.now(),
-    };
-
+  setCurrentDocument: (document: Document | null) => {
     set({
-      currentDocument: updatedDoc,
-      saveStatus: 'unsaved',
+      currentDocument: document,
+      saveStatus: 'saved',
     });
   },
 

src/stores/editorStore.ts

@@ -91,6 +91,11 @@ interface EditorStore {
   getBlocksByType: (type: BlockType) => DocumentBlock[];
   
   /**
+   * 保存单个block的更改
+   */
+  saveBlock: (id: string) => Promise<void>;
+  
+  /**
    * 重新计算所有块的block_order(稀疏排序)
    */
   recomputeBlockOrders: () => void;
@@ -171,7 +176,7 @@ export const useEditorStore = create<EditorStore>((set, get) => ({
       
       set({
         documentId,
-        documentTitle: data.title || '未命名文档',
+        documentTitle: '未命名文档', // 后端不返回title，使用默认值
         blocks: data.blocks,
         isLoading: false,
       });
@@ -195,7 +200,18 @@ export const useEditorStore = create<EditorStore>((set, get) => ({
     set({ isSaving: true, error: null });
     
     try {
-      await blockService.updateBlocks(documentId, blocks);
+      // 后端不支持批量更新，需要逐个更新block
+      // 注意：这是一个临时方案，实际使用中应该优化为仅更新变化的blocks
+      // 或者使用防抖/节流策略减少API调用
+      for (const block of blocks) {
+        await blockService.updateBlock(documentId, block.id, {
+          content: block.content as any, // 类型断言：不同block类型的content类型不同
+          style: block.style,
+          word_style: block.word_style,
+          metadata: block.metadata,
+        });
+      }
+      
       set({ isSaving: false });
     } catch (error: any) {
       set({
@@ -308,6 +324,39 @@ export const useEditorStore = create<EditorStore>((set, get) => ({
     return blocks.filter((block) => block.type === type);
   },
 
+  // ── saveBlock ───────────────────────────────────────────────────────────
+  saveBlock: async (id: string) => {
+    const { documentId, blocks } = get();
+    
+    if (!documentId) {
+      throw new Error('没有打开的文档');
+    }
+    
+    const block = blocks.find(b => b.id === id);
+    if (!block) {
+      throw new Error('块不存在');
+    }
+    
+    set({ isSaving: true, error: null });
+    
+    try {
+      await blockService.updateBlock(documentId, id, {
+        content: block.content as any, // 类型断言：不同block类型的content类型不同
+        style: block.style,
+        word_style: block.word_style,
+        metadata: block.metadata,
+      });
+      
+      set({ isSaving: false });
+    } catch (error: any) {
+      set({
+        error: error.message || '保存块失败',
+        isSaving: false,
+      });
+      throw error;
+    }
+  },
+  
   // ── recomputeBlockOrders ────────────────────────────────────────────────
   recomputeBlockOrders: () => {
     const { blocks } = get();

src/types/api.ts

@@ -2,50 +2,28 @@
  * API request and response type definitions
  */
 
-// Re-export export-related types from export.ts to avoid duplication
-export type { ExportDocRequest, ExportDocResponse } from './export';
+// Re-export document and export types
+export type { 
+  CreateDocumentRequest,
+  CreateDocumentResponse,
+  Document,
+  DocumentListItem,
+  DocumentListFilters,
+  GetDocumentOptions,
+  ListDocumentsResponse,
+  DocumentPagination,
+} from './document';
 
-/**
- * Request payload for creating a new document
- */
-export interface CreateDocumentRequest {
-  /** Document title */
-  title: string;
-  /** Markdown content */
-  content: string;
-  /** Document format (fixed as markdown) */
-  format: 'markdown';
-  /** Optional chat session ID */
-  sessionId?: string;
-  /** Optional template ID */
-  templateId?: string;
-  /** Document source */
-  source: 'chat' | 'workflow';
-}
-
-/**
- * Block update for partial document updates
- */
-export interface BlockUpdate {
-  /** Heading level (1-6) */
-  level: number;
-  /** Index of this heading level */
-  index: number;
-  /** Block content */
-  content: string;
-}
-
-/**
- * Request payload for updating an existing document
- */
-export interface UpdateDocumentRequest {
-  /** Updated title */
-  title?: string;
-  /** Updated content (mutually exclusive with blocks) */
-  content?: string;
-  /** Partial block updates (mutually exclusive with content) */
-  blocks?: BlockUpdate[];
-}
+export type { 
+  ExportDocRequest, 
+  ExportDocResponse,
+  ExportRecord,
+  ExportRecordListItem,
+  ExportRecordListFilters,
+  ListExportRecordsResponse,
+  ExportRecordPagination,
+  StorageInfo,
+} from './export';
 
 /**
  * Generic API response wrapper
@@ -76,6 +54,7 @@ export interface PaginationInfo {
 
 /**
  * List filters for document queries
+ * @deprecated Use DocumentListFilters from ./document instead
  */
 export interface ListFilters {
   /** Filter by source */

src/types/document.ts

@@ -6,19 +6,6 @@
  */
 
 /**
- * Block update for partial document updates
- * Used to update specific sections by heading level and index
- */
-export interface BlockUpdate {
-  /** Heading level (1-6, where 1 = H1, 2 = H2, etc.) */
-  level: number;
-  /** Index of this heading level in the document (0-based) */
-  index: number;
-  /** New content for this block (including the heading itself) */
-  content: string;
-}
-
-/**
  * Request payload for creating a document
  */
 export interface CreateDocumentRequest {
@@ -28,60 +15,38 @@ export interface CreateDocumentRequest {
   fileUrl: string;
   /** Session ID to associate this document with */
   sessionId: string;
-  /** Optional document title (if not provided, will be extracted from content) */
-  title?: string;
-}
-
-/**
- * Request payload for updating a document
- * Either content (full update) or blocks (partial update) must be provided
- */
-export interface UpdateDocumentRequest {
-  /** Document title */
-  title?: string;
-  /** Full document content (mutually exclusive with blocks) */
-  content?: string;
-  /** List of blocks to update (mutually exclusive with content) */
-  blocks?: BlockUpdate[];
 }
 
 /**
  * Document entity (full details)
+ * 对应后端Document模型，使用SQLite存储blocks内容
  */
 export interface Document {
   /** Document ID (format: doc-{uuid[:12]}) */
   id: string;
-  /** Document title */
-  title: string;
-  /** Document content in Markdown format */
-  content: string;
-  /** Content format (always "markdown") */
-  format: string;
+  /** Path to SQLite content database */
+  contentDbPath: string;
   /** Associated session ID */
   sessionId: string;
-  /** Document source (chat or workflow) */
-  source: 'chat' | 'workflow';
   /** User ID who created the document */
-  userId: string;
+  userId: string | null;
   /** Creation timestamp (milliseconds) */
   createdAt: number;
   /** Last update timestamp (milliseconds) */
   updatedAt: number;
+  /** Optional: blocks array (only when includeBlocks=true) */
+  blocks?: any[];
 }
 
 /**
- * Document list item (without content field)
+ * Document list item (without blocks)
  * Used in list responses to reduce payload size
  */
 export interface DocumentListItem {
   /** Document ID */
   id: string;
-  /** Document title */
-  title: string;
   /** Associated session ID */
   sessionId: string;
-  /** Document source (chat or workflow) */
-  source: 'chat' | 'workflow';
   /** Creation timestamp (milliseconds) */
   createdAt: number;
   /** Last update timestamp (milliseconds) */
@@ -94,21 +59,13 @@ export interface DocumentListItem {
 export interface CreateDocumentResponse {
   /** Created document ID */
   documentId: string;
-  /** Content format (always "markdown") */
-  format: string;
+  /** Path to SQLite content database */
+  contentDbPath: string;
   /** Creation timestamp (milliseconds) */
   createdAt: number;
 }
 
-/**
- * Response from update document API
- */
-export interface UpdateDocumentResponse {
-  /** Updated document ID */
-  documentId: string;
-  /** Update timestamp (milliseconds) */
-  updatedAt: number;
-}
+
 
 /**
  * Pagination info for document list
@@ -144,10 +101,18 @@ export interface DocumentListFilters {
   page?: number;
   /** Number of items per page */
   pageSize?: number;
-  /** Filter by session ID */
+  /** Filter by session ID (optional) */
   sessionId?: string;
-  /** Sort by field (createdAt or updatedAt) */
-  sortBy?: 'createdAt' | 'updatedAt';
+  /** Sort by field (created_at or updated_at) */
+  sortBy?: 'created_at' | 'updated_at';
   /** Sort order */
   sortOrder?: 'asc' | 'desc';
 }
+
+/**
+ * Options for getting document details
+ */
+export interface GetDocumentOptions {
+  /** Whether to include blocks array in response */
+  includeBlocks?: boolean;
+}

src/types/editor.ts

@@ -207,36 +207,86 @@ export interface EditorState {
  * 获取blocks的API响应
  */
 export interface GetBlocksResponse {
-  documentId: string;
-  title: string;
   blocks: DocumentBlock[];
 }
 
 /**
- * 更新blocks的API请求
+ * 获取单个block的API响应
  */
-export interface UpdateBlocksRequest {
+export interface GetBlockResponse {
+  block: DocumentBlock;
+}
+
+/**
+ * 更新block的API请求（部分字段）
+ */
+export interface UpdateBlockRequest {
+  content?: string | RichText[] | TableContent;
+  style?: StyleOverrides;
+  word_style?: string;
+  metadata?: Record<string, any>;
+}
+
+/**
+ * 更新block的API响应
+ */
+export interface UpdateBlockResponse {
+  blockId: string;
+  message: string;
+}
+
+/**
+ * 搜索blocks的API响应
+ */
+export interface SearchBlocksResponse {
   blocks: DocumentBlock[];
+  total: number;
+  query: string;
 }
 
 /**
+ * 目录树节点
+ */
+export interface TOCNode {
+  id: string;
+  level: number;
+  content: string;
+  children: TOCNode[];
+}
+
+/**
+ * 获取目录树的API响应
+ */
+export interface GetTOCResponse {
+  toc: TOCNode[];
+}
+
+/**
+ * 统计信息
+ */
+export interface BlockStatsResponse {
+  total: number;
+  by_type: Record<string, number>;
+}
+
+// ══════════════════════════════════════════════════════════════════════════════
+// Utility Types
+// ══════════════════════════════════════════════════════════════════════════════
+
+/**
  * 创建block的请求
  */
 export interface CreateBlockRequest {
   type: BlockType;
-  block_order: number;
   level: number;
   index: number;
   content: any;
   word_style: string;
   style?: StyleOverrides;
   metadata?: Record<string, any>;
+  after_block_id?: string;  // 在哪个block后插入
 }
 
-// ══════════════════════════════════════════════════════════════════════════════
-// Utility Types
-// ══════════════════════════════════════════════════════════════════════════════
-
 /**
  * Block创建参数(部分字段可选)
  */

src/types/index.ts

@@ -3,19 +3,63 @@
  */
 
 // Document types
-export type { Document, DocumentListItem } from './document';
+export type {
+  Document,
+  DocumentListItem,
+  CreateDocumentRequest,
+  CreateDocumentResponse,
+  DocumentListFilters,
+  GetDocumentOptions,
+  ListDocumentsResponse,
+  DocumentPagination,
+} from './document';
+
+// Export types
+export type {
+  ExportDocRequest,
+  ExportDocResponse,
+  ExportRecord,
+  ExportRecordListItem,
+  ExportRecordListFilters,
+  ListExportRecordsResponse,
+  ExportRecordPagination,
+  StorageInfo,
+} from './export';
+
+// Editor/Block types
+export type {
+  BlockType,
+  RichText,
+  RichTextStyle,
+  StyleOverrides,
+  DocumentBlock,
+  HeadingBlock,
+  ParagraphBlock,
+  TableBlock,
+  ImageBlock,
+  TableCell,
+  TableRow,
+  TableContent,
+  EditorState,
+  GetBlocksResponse,
+  GetBlockResponse,
+  UpdateBlockRequest,
+  UpdateBlockResponse,
+  CreateBlockRequest,
+  SearchBlocksResponse,
+  TOCNode,
+  GetTOCResponse,
+  BlockStatsResponse,
+  BlockUpdate,
+  PartialBlock,
+} from './editor';
 
 // Chat types
 export type { ChatMessage } from './chat';
 
 // API types
 export type {
-  CreateDocumentRequest,
-  UpdateDocumentRequest,
-  ExportDocRequest,
-  ExportDocResponse,
   ApiResponse,
-  BlockUpdate,
   PaginationInfo,
   ListFilters,
 } from './api';
@@ -25,3 +69,4 @@ export type { SaveStatus } from './ui';
 
 // Store types
 export type { DocumentStoreState, ChatStoreState, UIStoreState } from './store';
+

src/types/store.ts

@@ -2,12 +2,10 @@
  * Zustand store state type definitions
  */
 
-import type { Document, DocumentListItem } from './document';
+import type { Document, DocumentListItem, CreateDocumentRequest } from './document';
 import type { ChatMessage, ChatSession } from './chat';
 import type { SaveStatus } from './ui';
 import type {
-  CreateDocumentRequest,
-  UpdateDocumentRequest,
   ListFilters,
   PaginationInfo,
 } from './api';
@@ -30,17 +28,13 @@ export interface DocumentStoreState {
   /** Create a new document */
   createDocument: (req: CreateDocumentRequest) => Promise<void>;
   /** Fetch a document by ID */
-  fetchDocument: (id: string) => Promise<void>;
+  fetchDocument: (id: string, includeBlocks?: boolean) => Promise<void>;
   /** Fetch document list with optional filters */
   fetchDocumentList: (filters?: ListFilters) => Promise<void>;
-  /** Update an existing document */
-  updateDocument: (id: string, req: UpdateDocumentRequest) => Promise<void>;
-  /** Delete a document by ID */
-  deleteDocument: (id: string) => Promise<void>;
-  /** Update current document content (local state only) */
-  updateContent: (content: string) => void;
-  /** Update current document title (local state only) */
-  updateTitle: (title: string) => void;
+  /** Delete documents by session ID */
+  deleteDocumentsBySession: (sessionId: string) => Promise<void>;
+  /** Set current document (local state only) */
+  setCurrentDocument: (document: Document | null) => void;
   /** Set save status */
   setSaveStatus: (status: SaveStatus) => void;
 }