@cpzxrobot/sdk 1.3.119 → 1.3.121

package/AIFORM_GATEWAY.md

@@ -40,7 +40,20 @@ interface AiformTemplate {
   factoryId: number;    // 工厂ID
   name: string;         // 模板名称
   content: string;      // 模板内容
-  attention?: string;   // 注意事项
+  attention: {          // 注意事项
+    hasFixedContent: boolean;     // 是否有固定内容
+    fixedContentList: string[];   // 固定内容列表
+    hasFixedRowContent: boolean;  // 是否有固定行内容
+    rowContent: string;           // 行内容
+    hasFixedColumnContent: boolean; // 是否有固定列内容
+    columnContent: string;        // 列内容
+    otherNotes: string;           // 其他备注
+  };
+  status: number;       // 解析状态：null-未上传 0-已上传 1-解析中 2-已解析
+  parsePrompt: string;  // 从表格图片提炼的解析提示词
+  curVersion: number;   // 当前解析版本号
+  createTime: string;   // 创建时间
+  updateTime: string;   // 更新时间
 }
 ```
 
@@ -57,9 +70,8 @@ if (response.code === 200) {
   templates.forEach(template => {
     console.log(`ID: ${template.id}, 名称: ${template.name}`);
     console.log(`内容: ${template.content.substring(0, 100)}...`);
-    if (template.attention) {
-      console.log(`注意事项: ${template.attention}`);
-    }
+    console.log(`状态: ${template.status === 2 ? '已解析' : template.status === 1 ? '解析中' : '已上传'}`);
+    console.log(`版本: ${template.curVersion}`);
   });
 } else {
   console.error('获取模板列表失败:', response.message);
@@ -81,7 +93,18 @@ interface AiformTemplateSaveRequest {
   factoryId: number;  // 工厂ID，必填
   name: string;       // 模板名称，必填
   content: string;    // 模板内容，必填
-  attention?: string; // 注意事项，可选
+  attention?: {       // 注意事项（可选）
+    hasFixedContent: boolean;     // 是否有固定内容
+    fixedContentList: string[];   // 固定内容列表
+    hasFixedRowContent: boolean;  // 是否有固定行内容
+    rowContent: string;           // 行内容
+    hasFixedColumnContent: boolean; // 是否有固定列内容
+    columnContent: string;        // 列内容
+    otherNotes: string;           // 其他备注
+  };
+  status?: number;    // 解析状态（一般由上传接口更新）
+  parsePrompt?: string; // 解析提示词（由上传表格图片接口提炼）
+  curVersion?: number;  // 一般由解析/发布接口维护
 }
 ```
 
@@ -103,7 +126,15 @@ const response = await cpzxrobot().aiform.template.save({
   factoryId: 1001,
   name: "生产日报模板",
   content: "## 生产日报\n\n日期: {{date}}\n\n产量: {{production}}\n\n质量: {{quality}}",
-  attention: "请确保填写真实数据"
+  attention: {
+    hasFixedContent: false,
+    fixedContentList: [],
+    hasFixedRowContent: true,
+    rowContent: "每头母猪和仔猪的日常记录情况",
+    hasFixedColumnContent: false,
+    columnContent: "",
+    otherNotes: ""
+  }
 });
 
 if (response.code === 200) {
@@ -122,7 +153,15 @@ const response = await cpzxrobot().aiform.template.save({
   factoryId: 1001,
   name: "生产日报模板（更新版）",
   content: "## 生产日报\n\n日期: {{date}}\n\n产量: {{production}}\n\n质量: {{quality}}\n\n备注: {{remark}}",
-  attention: "请确保填写真实数据，新增加了备注字段"
+  attention: {
+    hasFixedContent: true,
+    fixedContentList: ["温度", "湿度"],
+    hasFixedRowContent: true,
+    rowContent: "每头母猪和仔猪的日常记录情况",
+    hasFixedColumnContent: false,
+    columnContent: "",
+    otherNotes: "需关注异常情况"
+  }
 });
 
 if (response.code === 200) {
@@ -132,40 +171,193 @@ if (response.code === 200) {
 }
 ```
 
-### 3. 上传表格图片
+### 3. 上传表格图片提炼模板提示词
+
+**方法**: `uploadTemplateImage(templateId: number | null, file: File, factoryId?: number): Promise<any>`
+
+**接口路径**: `POST /api/v2/aiform/template/upload`
+
+**功能**: 上传表格图片到 MinIO，异步调用视觉大模型提炼模板字段。
+
+**参数**:
+- `templateId` (number | null): 模板ID（可选，与factoryId二选一）
+- `file` (File): 表格图片文件，必填
+- `factoryId` (number): 工厂ID（可选，与templateId二选一）
+
+**返回值**:
+```typescript
+interface AiformTemplateUploadResponse {
+  code: number;    // 状态码
+  message: string; // 提示信息
+  data: AiformTemplate; // 当前模板快照
+}
+```
+
+**使用示例**:
+
+```javascript
+// 上传图片到已有模板
+const fileInput = document.getElementById('fileInput');
+const file = fileInput.files[0];
+const templateId = 1;
+
+try {
+  const response = await cpzxrobot().aiform.template.uploadTemplateImage(templateId, file);
+  console.log('上传成功:', response.data);
+  console.log('模板状态:', response.data.status);
+} catch (error) {
+  console.error('上传失败:', error.message);
+}
+
+// 上传图片创建新模板
+const factoryId = 1001;
+try {
+  const response = await cpzxrobot().aiform.template.uploadTemplateImage(null, file, factoryId);
+  console.log('上传成功，新模板ID:', response.data.id);
+} catch (error) {
+  console.error('上传失败:', error.message);
+}
+```
+
+### 4. 删除模板
+
+**方法**: `delete(templateId: number): Promise<any>`
+
+**接口路径**: `POST /api/v2/aiform/template/delete/{templateId}`
+
+**功能**: 根据模板ID删除模板，级联删除关联的历史记录和文件。
+
+**参数**:
+- `templateId` (number): 模板ID，必填
+
+**返回值**:
+```typescript
+interface AiformTemplateDeleteResponse {
+  code: number;    // 状态码
+  message: string; // 提示信息
+}
+```
+
+**使用示例**:
+
+```javascript
+// 删除模板
+const templateId = 1;
+try {
+  const response = await cpzxrobot().aiform.template.delete(templateId);
+  console.log('删除成功:', response.message);
+} catch (error) {
+  console.error('删除失败:', error.message);
+}
+```
+
+### 5. 查询模板解析历史快照
+
+**方法**: `history(templateId: number): Promise<AiformTemplateHistoryResponse>`
+
+**接口路径**: `GET /api/v2/aiform/template/{templateId}/history`
+
+**功能**: 查询指定模板的解析快照列表，按版本号从新到旧排序。
+
+**参数**:
+- `templateId` (number): 模板ID，必填
+
+**返回值**:
+```typescript
+interface AiformTemplateHistoryResponse {
+  code: number;    // 状态码
+  message: string; // 提示信息
+  data: AiformTemplateHistory[]; // 历史快照列表
+}
+
+interface AiformTemplateHistory {
+  id: number;           // 历史表主键
+  templateId: number;   // 模板ID
+  snapshotVersion: number; // 解析版本号
+  name: string;         // 名称快照
+  content: string;      // 内容快照
+  attention: object;    // 注意事项快照
+  parsePrompt: string;  // 解析提示词快照
+  createTime: string;   // 归档时间
+}
+```
+
+**使用示例**:
+
+```javascript
+// 查询模板历史
+const templateId = 1;
+try {
+  const response = await cpzxrobot().aiform.template.history(templateId);
+  console.log('历史快照:', response.data);
+} catch (error) {
+  console.error('获取历史失败:', error.message);
+}
+```
+
+### 6. 按版本号将历史发布到主表
+
+**方法**: `publishHistory(templateId: number, snapshotVersion: number): Promise<AiformTemplatePublishResponse>`
+
+**接口路径**: `POST /api/v2/aiform/template/{templateId}/history/{snapshotVersion}/publish`
 
-**方法**: `upload(templateId: number): Promise<AiformFileUploadResponse>`
+**功能**: 根据解析版本号将对应历史快照写回主表。
+
+**参数**:
+- `templateId` (number): 模板ID，必填
+- `snapshotVersion` (number): 解析版本号，必填（必须大于0）
+
+**返回值**:
+```typescript
+interface AiformTemplatePublishResponse {
+  code: number;    // 状态码
+  message: string; // 提示信息
+  data: AiformTemplate; // 更新后的模板
+}
+```
+
+**使用示例**:
+
+```javascript
+// 发布历史版本
+const templateId = 1;
+const snapshotVersion = 2;
+try {
+  const response = await cpzxrobot().aiform.template.publishHistory(templateId, snapshotVersion);
+  console.log('发布成功:', response.data);
+} catch (error) {
+  console.error('发布失败:', error.message);
+}
+```
+
+### 7. 上传表格图片
+
+**方法**: `upload(templateId: number, watermark: boolean = false): Promise<AiformFileUploadResponse>`
 
 **接口路径**: `POST /api/v2/aiform/file/upload`
 
-**功能**: 上传表格图片到 MinIO，并关联到指定的模板。上传成功后自动异步触发大模型解析。
+**功能**: 上传表格图片到 MinIO，并关联到指定的模板。上传成功后自动触发大模型解析。
 
 **参数**:
 - `templateId` (number): 关联的模板ID，必填
+- `watermark` (boolean): 图片是否带水印，默认 false
 
 **返回值**:
 ```typescript
 interface AiformFileUploadResponse {
   code: number;    // 状态码
   message: string; // 提示信息
-  data: File;      // 文件记录
-}
-
-interface File {
-  id: number;           // 文件记录ID
-  code?: string;        // 业务编码
-  tableKey: number;     // 关联业务ID（模板ID）
-  tableName: string;    // 关联业务表名（固定值 aiform_template）
-  fileName: string;     // 原始文件名
-  storageName: string;  // 存储文件名
-  fileUrl: string;      // MinIO存储路径
-  accessUrl: string;    // 预签名访问链接
-  fileExt: string;      // 文件扩展名
-  server: string;       // 存储服务（minio）
-  type: string;         // 文件类型（image）
-  status: number;       // 状态：0-已上传 1-解析中 2-已解析
-  createTime: string;   // 创建时间
-  updateTime: string;   // 更新时间
+  data: AiformRecordVO; // 上传记录
+}
+
+interface AiformRecordVO {
+  code: string;       // 业务编码（用于调用详情接口）
+  storageName: string; // 存储文件名
+  status: number;     // 解析状态：0-已上传 1-解析中 2-已解析
+  watermark: boolean; // 图片是否带水印
+  createUserId: number; // 创建用户ID
+  createTime: string; // 创建时间
+  updateTime: string; // 更新时间
 }
 ```
 
@@ -175,15 +367,16 @@ interface File {
 // 上传文件
 async function uploadFile() {
   const templateId = 1; // 模板ID
+  const watermark = false; // 图片是否带水印
   
   try {
-    const response = await cpzxrobot().aiform.record.upload(templateId);
+    const response = await cpzxrobot().aiform.record.upload(templateId, watermark);
     console.log('上传成功:', response.data);
     console.log('文件状态:', getFileStatusText(response.data.status));
-    console.log('访问链接:', response.data.accessUrl);
+    console.log('业务编码:', response.data.code);
     
     // 可以开始轮询状态
-    trackFileStatus(templateId, response.data.id);
+    trackFileStatus(templateId, response.data.code);
   } catch (error) {
     console.error('上传失败:', error.message);
   }
@@ -202,7 +395,7 @@ function getFileStatusText(status) {
 uploadFile();
 ```
 
-### 4. 根据模板ID查询上传记录
+### 8. 根据模板ID查询上传记录
 
 **方法**: `list(templateId: number): Promise<AiformFileListResponse>`
 
@@ -218,7 +411,7 @@ uploadFile();
 interface AiformFileListResponse {
   code: number;    // 状态码
   message: string; // 提示信息
-  data: File[];    // 文件记录列表（精简版）
+  data: AiformRecordVO[]; // 文件记录列表（精简版）
 }
 ```
 
@@ -236,10 +429,10 @@ async function getTemplateRecords(templateId) {
       
       records.forEach((record, index) => {
         console.log(`\n记录 ${index + 1}:`);
-        console.log(`文件名: ${record.fileName}`);
+        console.log(`文件名: ${record.storageName}`);
         console.log(`状态: ${getFileStatusText(record.status)}`);
+        console.log(`业务编码: ${record.code}`);
         console.log(`创建时间: ${record.createTime}`);
-        console.log(`访问链接: ${record.accessUrl}`);
       });
     }
   } catch (error) {
@@ -251,13 +444,13 @@ async function getTemplateRecords(templateId) {
 getTemplateRecords(1); // 查询模板ID为1的上传记录
 ```
 
-### 5. 根据文件业务编码获取详情
+### 9. 根据文件业务编码获取详情
 
 **方法**: `detail(code: string): Promise<AiformFileDetailResponse>`
 
 **接口路径**: `GET /api/v2/aiform/file/detail/{code}`
 
-**功能**: 根据文件业务编码获取解析结果详情。
+**功能**: 根据文件业务编码获取解析结果和预签名访问链接。
 
 **参数**:
 - `code` (string): 文件业务编码，必填
@@ -267,7 +460,16 @@ getTemplateRecords(1); // 查询模板ID为1的上传记录
 interface AiformFileDetailResponse {
   code: number;    // 状态码
   message: string; // 提示信息
-  data: any;       // 解析结果详情
+  data: AiformParseResultVO; // 解析结果详情
+}
+
+interface AiformParseResultVO {
+  id: number;           // 解析结果记录ID
+  content: string;      // markdown 解析的表格内容
+  unclears: string[];   // 疑似不清晰处的描述说明
+  description: string;  // 整体解析说明
+  parseResult: string;  // 解析结果（兼容旧数据或解析失败时的原始结果）
+  accessUrl: string;    // 预签名访问链接（有效期7天）
 }
 ```
 
@@ -281,6 +483,8 @@ async function getFileDetail(code) {
     
     if (response.code === 200) {
       console.log('文件详情:', response.data);
+      console.log('解析内容:', response.data.content);
+      console.log('访问链接:', response.data.accessUrl);
     }
   } catch (error) {
     console.error('获取文件详情失败:', error.message);
@@ -288,17 +492,237 @@ async function getFileDetail(code) {
 }
 
 // 调用示例
-getFileDetail('FILE_20240101_001'); // 查询业务编码为FILE_20240101_001的文件详情
+getFileDetail('a1b2c3d4-e5f6-7890-abcd-ef1234567890');
 ```
 
-### 6. 轮询文件解析状态
+### 10. 根据reply_id获取解析结果
+
+**方法**: `getReplyDetail(replyId: number): Promise<AiformFileDetailResponse>`
+
+**接口路径**: `GET /api/v2/aiform/file/detail/reply/{replyId}`
+
+**功能**: 根据 reply_id 获取该次 reply 对应的解析结果。
+
+**参数**:
+- `replyId` (number): reply 记录ID，必填
+
+**返回值**:
+```typescript
+interface AiformFileDetailResponse {
+  code: number;    // 状态码
+  message: string; // 提示信息
+  data: AiformParseResultVO; // 解析结果详情
+}
+```
+
+**使用示例**:
+
+```javascript
+// 获取reply对应的解析结果
+async function getReplyDetail(replyId) {
+  try {
+    const response = await cpzxrobot().aiform.record.getReplyDetail(replyId);
+    
+    if (response.code === 200) {
+      console.log('解析结果:', response.data);
+    }
+  } catch (error) {
+    console.error('获取解析结果失败:', error.message);
+  }
+}
+
+// 调用示例
+getReplyDetail(123);
+```
+
+### 11. 根据解析结果提交反馈（reply）
+
+**方法**: `reply(code: string, reply: string): Promise<AiformReplyResponse>`
+
+**接口路径**: `POST /api/v2/aiform/file/reply`
+
+**功能**: 用户根据解析结果提交反馈，让大模型对结果进行调整或修改。
+
+**参数**:
+- `code` (string): 文件业务编码，必填
+- `reply` (string): 用户的修改意见/反馈内容，必填
+
+**返回值**:
+```typescript
+interface AiformReplyResponse {
+  code: number;    // 状态码
+  message: string; // 提示信息
+  data: AiformParseResultVO; // 调整后的解析结果
+}
+```
+
+**使用示例**:
+
+```javascript
+// 提交反馈
+async function submitReply(code, feedback) {
+  try {
+    const response = await cpzxrobot().aiform.record.reply(code, feedback);
+    console.log('反馈提交成功:', response.data);
+    console.log('调整后的内容:', response.data.content);
+  } catch (error) {
+    console.error('提交反馈失败:', error.message);
+  }
+}
+
+// 调用示例
+submitReply('a1b2c3d4-e5f6-7890-abcd-ef1234567890', '请把第3列的数据改成数字格式');
+```
+
+### 12. 用户确认并保存
+
+**方法**: `confirm(id: number, content: string, headerRowCount?: number, headers?: any[]): Promise<AiformConfirmResponse>`
+
+**接口路径**: `POST /api/v2/aiform/file/confirm`
+
+**功能**: 用户对解析结果进行最终确认，将表格转为标准数据存入数据库。
+
+**参数**:
+- `id` (number): 解析结果记录ID，必填
+- `content` (string): 表格文本，markdown 表格格式，必填
+- `headerRowCount` (number): 表头行数（可选）
+- `headers` (any[]): 表头单元格列表（可选，用于复杂表头）
+
+**返回值**:
+```typescript
+interface AiformConfirmResponse {
+  code: number;    // 状态码
+  message: string; // 提示信息
+}
+```
+
+**使用示例**:
+
+```javascript
+// 确认保存
+async function confirmSave(parseResultId, tableContent) {
+  try {
+    const response = await cpzxrobot().aiform.record.confirm(parseResultId, tableContent);
+    console.log('确认保存成功:', response.message);
+  } catch (error) {
+    console.error('确认保存失败:', error.message);
+  }
+}
+
+// 调用示例
+const tableContent = '| 序号 | 栋舍 | 栏位 |\n| --- | --- | --- |\n| 1 | A栋 | 1栏 |';
+confirmSave(123, tableContent);
+
+// 带复杂表头的确认
+async function confirmWithHeaders(parseResultId, tableContent) {
+  const headers = [
+    {row: 0, col: 0, rowSpan: 3, colSpan: 1, value: '栏位'},
+    {row: 0, col: 1, rowSpan: 3, colSpan: 1, value: '耳号'},
+    {row: 0, col: 2, rowSpan: 3, colSpan: 1, value: '异常情况'},
+    {row: 0, col: 3, rowSpan: 2, colSpan: 3, value: '治疗及采样记录'},
+    {row: 2, col: 3, rowSpan: 1, colSpan: 1, value: '时间'},
+    {row: 2, col: 4, rowSpan: 1, colSpan: 1, value: '体温'},
+    {row: 2, col: 5, rowSpan: 1, colSpan: 1, value: '方案'}
+  ];
+  
+  try {
+    const response = await cpzxrobot().aiform.record.confirm(parseResultId, tableContent, undefined, headers);
+    console.log('确认保存成功:', response.message);
+  } catch (error) {
+    console.error('确认保存失败:', error.message);
+  }
+}
+```
+
+### 13. 查询文件的reply调整历史
+
+**方法**: `getReplyList(code: string): Promise<AiformReplyListResponse>`
+
+**接口路径**: `GET /api/v2/aiform/file/reply/list/{code}`
+
+**功能**: 根据文件业务编码查询该文件的所有 reply 调整历史记录，按创建时间倒序。
+
+**参数**:
+- `code` (string): 文件业务编码，必填
+
+**返回值**:
+```typescript
+interface AiformReplyListResponse {
+  code: number;    // 状态码
+  message: string; // 提示信息
+  data: AiformRecordReply[]; // reply 记录列表
+}
+
+interface AiformRecordReply {
+  id: number;         // 主键
+  recordId: number;   // 记录ID，关联 aiform_record
+  reply: string;      // 用户的修改意见/反馈内容
+  createUserId: number; // 创建用户ID
+  createTime: string; // 创建时间
+}
+```
+
+**使用示例**:
+
+```javascript
+// 查询reply历史
+async function getReplyHistory(code) {
+  try {
+    const response = await cpzxrobot().aiform.record.getReplyList(code);
+    console.log('Reply历史:', response.data);
+  } catch (error) {
+    console.error('获取Reply历史失败:', error.message);
+  }
+}
+
+// 调用示例
+getReplyHistory('a1b2c3d4-e5f6-7890-abcd-ef1234567890');
+```
+
+### 14. 根据文件code删除记录
+
+**方法**: `delete(code: string): Promise<any>`
+
+**接口路径**: `POST /api/v2/aiform/file/delete/{code}`
+
+**功能**: 根据文件业务编码删除记录，级联删除关联的标准数据、解析结果、reply、文件等。
+
+**参数**:
+- `code` (string): 文件业务编码，必填
+
+**返回值**:
+```typescript
+interface AiformFileDeleteResponse {
+  code: number;    // 状态码
+  message: string; // 提示信息
+}
+```
+
+**使用示例**:
+
+```javascript
+// 删除文件记录
+async function deleteRecord(code) {
+  try {
+    const response = await cpzxrobot().aiform.record.delete(code);
+    console.log('删除成功:', response.message);
+  } catch (error) {
+    console.error('删除失败:', error.message);
+  }
+}
+
+// 调用示例
+deleteRecord('a1b2c3d4-e5f6-7890-abcd-ef1234567890');
+```
+
+### 15. 轮询文件解析状态
 
 **功能**: 上传文件后，需要轮询文件状态以确认解析进度。
 
 **使用示例**:
 
 ```javascript
-async function trackFileStatus(templateId, fileId) {
+async function trackFileStatus(templateId, fileCode) {
   let status = 0; // 初始状态
   let attempts = 0;
   const maxAttempts = 30; // 最多轮询30次
@@ -308,7 +732,7 @@ async function trackFileStatus(templateId, fileId) {
   while (status !== 2 && attempts < maxAttempts) {
     try {
       const response = await cpzxrobot().aiform.record.list(templateId);
-      const fileRecord = response.data.find(record => record.id === fileId);
+      const fileRecord = response.data.find(record => record.code === fileCode);
       
       if (fileRecord) {
         status = fileRecord.status;
@@ -345,6 +769,10 @@ async function trackFileStatus(templateId, fileId) {
    - `模板内容不能为空` - 未提供content参数
    - `文件不能为空` - 未提供file参数
    - `模板ID不能为空` - 未提供templateId参数
+   - `文件业务编码不能为空` - 未提供code参数
+   - `反馈内容不能为空` - 未提供reply参数
+   - `解析结果记录ID不能为空` - 未提供id参数
+   - `表格内容不能为空` - 未提供content参数
 
 2. **API错误**:
    - 当API返回非200状态码时，会抛出包含错误信息的异常
@@ -374,8 +802,7 @@ try {
 
 try {
   // 尝试上传文件
-  const file = document.getElementById('fileInput').files[0];
-  const response = await cpzxrobot().aiform.record.upload(file, 1);
+  const response = await cpzxrobot().aiform.record.upload(1, false);
   console.log('上传成功:', response.data);
 } catch (error) {
   console.error('上传失败:', error.message);
@@ -391,11 +818,27 @@ try {
 
 try {
   // 尝试获取文件详情
-  const response = await cpzxrobot().aiform.record.detail('FILE_20240101_001');
+  const response = await cpzxrobot().aiform.record.detail('a1b2c3d4-e5f6-7890-abcd-ef1234567890');
   console.log('文件详情:', response.data);
 } catch (error) {
   console.error('获取文件详情失败:', error.message);
 }
+
+try {
+  // 尝试提交反馈
+  const response = await cpzxrobot().aiform.record.reply('a1b2c3d4-e5f6-7890-abcd-ef1234567890', '请修正表格格式');
+  console.log('反馈提交成功:', response.data);
+} catch (error) {
+  console.error('提交反馈失败:', error.message);
+}
+
+try {
+  // 尝试确认保存
+  const response = await cpzxrobot().aiform.record.confirm(123, '| 列1 | 列2 |\n| --- | --- |\n| 值1 | 值2 |');
+  console.log('确认保存成功:', response.message);
+} catch (error) {
+  console.error('确认保存失败:', error.message);
+}
 ```
 
 ## 完整使用示例
@@ -414,7 +857,7 @@ async function manageAITemplates() {
     if (listResponse.code === 200) {
       console.log(`找到 ${listResponse.data.length} 个模板:`);
       listResponse.data.forEach((template, index) => {
-        console.log(`  ${index + 1}. ${template.name} (ID: ${template.id})`);
+        console.log(`  ${index + 1}. ${template.name} (ID: ${template.id}, 状态: ${template.status === 2 ? '已解析' : '未解析'})`);
       });
     }
     
@@ -424,7 +867,15 @@ async function manageAITemplates() {
       factoryId: factoryId,
       name: "新增测试模板",
       content: "## 测试模板\n\n这是一个测试模板",
-      attention: "测试用模板"
+      attention: {
+        hasFixedContent: false,
+        fixedContentList: [],
+        hasFixedRowContent: true,
+        rowContent: "测试行内容",
+        hasFixedColumnContent: false,
+        columnContent: "",
+        otherNotes: ""
+      }
     });
     console.log(`新增结果: ${createResponse.message}`);
     
@@ -448,7 +899,7 @@ async function manageAITemplates() {
         factoryId: factoryId,
         name: `${lastTemplate.name} (已更新)`,
         content: lastTemplate.content + '\n\n更新时间: ' + new Date().toLocaleString(),
-        attention: lastTemplate.attention + ' - 已更新'
+        attention: lastTemplate.attention
       });
       console.log(`修改结果: ${updateResponse.message}`);
     }
@@ -470,6 +921,47 @@ async function manageAITemplates() {
 
 // 执行操作
 manageAITemplates();
+
+// 文件上传和解析流程
+async function processFileUpload() {
+  try {
+    const record = cpzxrobot().aiform.record;
+    const templateId = 1;
+    
+    console.log('=== 文件上传和解析流程 ===');
+    
+    // 1. 上传文件
+    console.log('\n1. 上传文件:');
+    const uploadResponse = await record.upload(templateId, false);
+    console.log(`上传成功，业务编码: ${uploadResponse.data.code}`);
+    
+    // 2. 轮询解析状态
+    console.log('\n2. 轮询解析状态:');
+    await trackFileStatus(templateId, uploadResponse.data.code);
+    
+    // 3. 获取解析结果
+    console.log('\n3. 获取解析结果:');
+    const detailResponse = await record.detail(uploadResponse.data.code);
+    console.log('解析内容:', detailResponse.data.content);
+    console.log('访问链接:', detailResponse.data.accessUrl);
+    
+    // 4. 提交反馈（如果需要）
+    console.log('\n4. 提交反馈:');
+    const replyResponse = await record.reply(uploadResponse.data.code, '请将表格格式调整为标准格式');
+    console.log('反馈处理结果:', replyResponse.data.content);
+    
+    // 5. 确认保存
+    console.log('\n5. 确认保存:');
+    const confirmResponse = await record.confirm(detailResponse.data.id, replyResponse.data.content);
+    console.log('确认保存结果:', confirmResponse.message);
+    
+  } catch (error) {
+    console.error('流程执行失败:', error.message);
+  }
+}
+
+// 执行文件处理流程
+// processFileUpload();
 ```
 
 ## 注意事项
@@ -479,6 +971,9 @@ manageAITemplates();
 3. **参数验证**: 所有必填参数必须提供，否则会抛出错误
 4. **错误处理**: 建议使用 try-catch 捕获可能的错误
 5. **网络请求**: 这些接口是异步网络请求，需要使用 `async/await` 或 Promise 处理
+6. **解析耗时**: 表格图片解析可能耗时较长，建议使用轮询机制监控解析状态
+7. **文件上传**: 上传表格图片时，模板ID和工厂ID至少需要传一个
+8. **历史版本**: 模板支持多版本管理，可通过历史接口查看和恢复历史版本
 
 ## 版本信息
 
@@ -487,6 +982,33 @@ manageAITemplates();
 
 ## 接口变更说明
 
-- **新增接口**: `cpzxrobot().aiform.record.detail(code)` - 根据文件业务编码获取解析结果详情
-- **变更接口**: `cpzxrobot().aiform.record.upload()` - 不再需要传递File参数，改为内部处理文件选择
-- **变更接口**: `cpzxrobot().aiform.record.list()` - 返回精简版文件记录，去掉了内容字段
+- **新增接口**: `cpzxrobot().aiform.template.delete(templateId)` - 删除模板
+- **新增接口**: `cpzxrobot().aiform.template.history(templateId)` - 查询模板解析历史快照
+- **新增接口**: `cpzxrobot().aiform.template.publishHistory(templateId, snapshotVersion)` - 按版本号将历史发布到主表
+- **变更接口**: `cpzxrobot().aiform.template.uploadTemplateImage()` - 支持同时传templateId和factoryId，二选一即可
+- **新增接口**: `cpzxrobot().aiform.record.getReplyDetail(replyId)` - 根据reply_id获取解析结果
+- **新增接口**: `cpzxrobot().aiform.record.reply(code, reply)` - 根据解析结果提交反馈
+- **新增接口**: `cpzxrobot().aiform.record.confirm(id, content, headerRowCount?, headers?)` - 用户确认并保存
+- **新增接口**: `cpzxrobot().aiform.record.getReplyList(code)` - 查询文件的reply调整历史
+- **新增接口**: `cpzxrobot().aiform.record.delete(code)` - 根据文件code删除记录
+- **变更接口**: `cpzxrobot().aiform.record.upload()` - 新增watermark参数
+- **变更接口**: `cpzxrobot().aiform.record.list()` - 返回精简版文件记录，包含code字段
+- **变更接口**: `cpzxrobot().aiform.record.detail()` - 返回更详细的解析结果，包含content、unclears、description等字段
+
+## 典型业务流程
+
+1. **模板管理流程**:
+   - 创建模板：`template.save()` 或通过 `template.uploadTemplateImage()` 上传图片自动创建
+   - 查询模板：`template.list()`
+   - 修改模板：`template.save()`
+   - 删除模板：`template.delete()`
+   - 管理历史版本：`template.history()` 和 `template.publishHistory()`
+
+2. **文件解析流程**:
+   - 上传文件：`record.upload()`
+   - 轮询状态：`record.list()`
+   - 获取详情：`record.detail()`
+   - 提交反馈：`record.reply()`
+   - 确认保存：`record.confirm()`
+   - 查询历史：`record.getReplyList()`
+   - 删除记录：`record.delete()`