@cpzxrobot/sdk 1.3.120 → 1.3.121

package/aiform_gateway.ts

@@ -6,6 +6,11 @@ import type {
   AiformFileUploadResponse,
   AiformFileListResponse,
   AiformFileDetailResponse,
+  AiformTemplateHistoryResponse,
+  AiformTemplatePublishResponse,
+  AiformReplyResponse,
+  AiformConfirmResponse,
+  AiformReplyListResponse,
 } from ".";
 
 export class AiformGateway extends Object {
@@ -71,19 +76,25 @@ export class AiformGateway extends Object {
       /**
        * 上传表格图片提炼模板提示词
        * POST /api/v2/aiform/template/upload
-       * @param templateId 模板ID
+       * @param templateId 模板ID（可选，与factoryId二选一）
        * @param file 图片文件
+       * @param factoryId 工厂ID（可选，与templateId二选一）
        */
-      uploadTemplateImage: async (templateId: number, file: File): Promise<any> => {
+      uploadTemplateImage: async (templateId: number | null, file: File, factoryId?: number): Promise<any> => {
         const axios = await this.context.ready;
 
-        if (!templateId) {
-          throw new Error('模板ID不能为空');
+        if (!templateId && !factoryId) {
+          throw new Error('模板ID和工厂ID至少需要传一个');
         }
 
         const formData = new FormData();
         formData.append('file', file);
-        formData.append('templateId', String(templateId));
+        if (templateId) {
+          formData.append('templateId', String(templateId));
+        }
+        if (factoryId) {
+          formData.append('factoryId', String(factoryId));
+        }
 
         return axios.post('/api/v2/aiform/template/upload', formData, {
           headers: {
@@ -96,6 +107,70 @@ export class AiformGateway extends Object {
           return res.data;
         });
       },
+
+      /**
+       * 删除模板
+       * @param templateId 模板ID
+       * @returns Promise 包含删除结果
+       */
+      delete: async (templateId: number): Promise<any> => {
+        const axios = await this.context.ready;
+
+        if (!templateId) {
+          throw new Error('模板ID不能为空');
+        }
+
+        return axios.post(`/api/v2/aiform/template/delete/${templateId}`).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '删除模板失败');
+          }
+          return res.data;
+        });
+      },
+
+      /**
+       * 查询模板解析历史快照
+       * @param templateId 模板ID
+       * @returns Promise 包含历史快照列表
+       */
+      history: async (templateId: number): Promise<AiformTemplateHistoryResponse> => {
+        const axios = await this.context.ready;
+
+        if (!templateId) {
+          throw new Error('模板ID不能为空');
+        }
+
+        return axios.get(`/api/v2/aiform/template/${templateId}/history`).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '获取历史快照失败');
+          }
+          return res.data;
+        });
+      },
+
+      /**
+       * 按版本号将历史发布到主表
+       * @param templateId 模板ID
+       * @param snapshotVersion 解析版本号
+       * @returns Promise 包含更新后的模板
+       */
+      publishHistory: async (templateId: number, snapshotVersion: number): Promise<AiformTemplatePublishResponse> => {
+        const axios = await this.context.ready;
+
+        if (!templateId) {
+          throw new Error('模板ID不能为空');
+        }
+        if (!snapshotVersion || snapshotVersion <= 0) {
+          throw new Error('解析版本号必须大于0');
+        }
+
+        return axios.post(`/api/v2/aiform/template/${templateId}/history/${snapshotVersion}/publish`).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '发布历史失败');
+          }
+          return res.data;
+        });
+      },
     };
   }
 
@@ -104,9 +179,10 @@ export class AiformGateway extends Object {
       /**
        * 上传表格图片
        * @param templateId 关联的模板ID
+       * @param watermark 图片是否带水印
        * @returns Promise 包含文件记录信息
        */
-      upload: async (templateId: number): Promise<AiformFileUploadResponse> => {
+      upload: async (templateId: number, watermark: boolean = false): Promise<AiformFileUploadResponse> => {
         const axios = await this.context.ready;
 
         if (!templateId) {
@@ -117,6 +193,7 @@ export class AiformGateway extends Object {
           title: "请选择要解析的表格图片",
           data: {
             templateId,
+            watermark,
           }
         }).then((res) => {
           if (res.data.code !== 200) {
@@ -167,6 +244,139 @@ export class AiformGateway extends Object {
           return res.data;
         });
       },
+
+      /**
+       * 根据reply_id获取解析结果
+       * @param replyId reply记录ID
+       * @returns Promise 包含解析结果详情
+       */
+      getReplyDetail: async (replyId: number): Promise<AiformFileDetailResponse> => {
+        const axios = await this.context.ready;
+
+        if (!replyId) {
+          throw new Error('reply记录ID不能为空');
+        }
+
+        return axios.get(`/api/v2/aiform/file/detail/reply/${replyId}`).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '获取解析结果失败');
+          }
+          return res.data;
+        });
+      },
+
+      /**
+       * 根据解析结果提交反馈（reply）
+       * @param code 文件业务编码
+       * @param reply 用户的修改意见/反馈内容
+       * @returns Promise 包含调整后的解析结果
+       */
+      reply: async (code: string, reply: string): Promise<AiformReplyResponse> => {
+        const axios = await this.context.ready;
+
+        if (!code) {
+          throw new Error('文件业务编码不能为空');
+        }
+        if (!reply) {
+          throw new Error('反馈内容不能为空');
+        }
+
+        return axios.post(`/api/v2/aiform/file/reply`, {
+          code,
+          reply
+        }, {
+          headers: {
+            'Content-Type': 'application/x-www-form-urlencoded'
+          }
+        }).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '提交反馈失败');
+          }
+          return res.data;
+        });
+      },
+
+      /**
+       * 用户确认并保存
+       * @param id 解析结果记录ID
+       * @param content 表格文本，markdown表格格式
+       * @param headerRowCount 表头行数（可选）
+       * @param headers 表头单元格列表（可选）
+       * @returns Promise 包含保存结果
+       */
+      confirm: async (id: number, content: string, headerRowCount?: number, headers?: any[]): Promise<AiformConfirmResponse> => {
+        const axios = await this.context.ready;
+
+        if (!id) {
+          throw new Error('解析结果记录ID不能为空');
+        }
+        if (!content) {
+          throw new Error('表格内容不能为空');
+        }
+
+        const data: any = {
+          content,
+        };
+
+        if (headerRowCount !== undefined) {
+          data.headerRowCount = headerRowCount;
+        }
+
+        if (headers) {
+          data.headers = headers;
+        }
+
+        return axios.post(`/api/v2/aiform/file/confirm?id=${id}`, data, {
+          headers: {
+            'Content-Type': 'application/json'
+          }
+        }).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '确认保存失败');
+          }
+          return res.data;
+        });
+      },
+
+      /**
+       * 查询文件的reply调整历史
+       * @param code 文件业务编码
+       * @returns Promise 包含reply记录列表
+       */
+      getReplyList: async (code: string): Promise<AiformReplyListResponse> => {
+        const axios = await this.context.ready;
+
+        if (!code) {
+          throw new Error('文件业务编码不能为空');
+        }
+
+        return axios.get(`/api/v2/aiform/file/reply/list/${code}`).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '获取reply历史失败');
+          }
+          return res.data;
+        });
+      },
+
+      /**
+       * 根据文件code删除记录
+       * @param code 文件业务编码
+       * @returns Promise 包含删除结果
+       */
+      delete: async (code: string): Promise<any> => {
+        const axios = await this.context.ready;
+
+        if (!code) {
+          throw new Error('文件业务编码不能为空');
+        }
+
+        return axios.post(`/api/v2/aiform/file/delete/${code}`).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '删除记录失败');
+          }
+          return res.data;
+        });
+      },
     };
   }
 }

package/dist/aiform_gateway.js

@@ -64,17 +64,23 @@ class AiformGateway extends Object {
             /**
              * 上传表格图片提炼模板提示词
              * POST /api/v2/aiform/template/upload
-             * @param templateId 模板ID
+             * @param templateId 模板ID（可选，与factoryId二选一）
              * @param file 图片文件
+             * @param factoryId 工厂ID（可选，与templateId二选一）
              */
-            uploadTemplateImage: (templateId, file) => __awaiter(this, void 0, void 0, function* () {
+            uploadTemplateImage: (templateId, file, factoryId) => __awaiter(this, void 0, void 0, function* () {
                 const axios = yield this.context.ready;
-                if (!templateId) {
-                    throw new Error('模板ID不能为空');
+                if (!templateId && !factoryId) {
+                    throw new Error('模板ID和工厂ID至少需要传一个');
                 }
                 const formData = new FormData();
                 formData.append('file', file);
-                formData.append('templateId', String(templateId));
+                if (templateId) {
+                    formData.append('templateId', String(templateId));
+                }
+                if (factoryId) {
+                    formData.append('factoryId', String(factoryId));
+                }
                 return axios.post('/api/v2/aiform/template/upload', formData, {
                     headers: {
                         'Content-Type': 'multipart/form-data'
@@ -86,6 +92,61 @@ class AiformGateway extends Object {
                     return res.data;
                 });
             }),
+            /**
+             * 删除模板
+             * @param templateId 模板ID
+             * @returns Promise 包含删除结果
+             */
+            delete: (templateId) => __awaiter(this, void 0, void 0, function* () {
+                const axios = yield this.context.ready;
+                if (!templateId) {
+                    throw new Error('模板ID不能为空');
+                }
+                return axios.post(`/api/v2/aiform/template/delete/${templateId}`).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '删除模板失败');
+                    }
+                    return res.data;
+                });
+            }),
+            /**
+             * 查询模板解析历史快照
+             * @param templateId 模板ID
+             * @returns Promise 包含历史快照列表
+             */
+            history: (templateId) => __awaiter(this, void 0, void 0, function* () {
+                const axios = yield this.context.ready;
+                if (!templateId) {
+                    throw new Error('模板ID不能为空');
+                }
+                return axios.get(`/api/v2/aiform/template/${templateId}/history`).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '获取历史快照失败');
+                    }
+                    return res.data;
+                });
+            }),
+            /**
+             * 按版本号将历史发布到主表
+             * @param templateId 模板ID
+             * @param snapshotVersion 解析版本号
+             * @returns Promise 包含更新后的模板
+             */
+            publishHistory: (templateId, snapshotVersion) => __awaiter(this, void 0, void 0, function* () {
+                const axios = yield this.context.ready;
+                if (!templateId) {
+                    throw new Error('模板ID不能为空');
+                }
+                if (!snapshotVersion || snapshotVersion <= 0) {
+                    throw new Error('解析版本号必须大于0');
+                }
+                return axios.post(`/api/v2/aiform/template/${templateId}/history/${snapshotVersion}/publish`).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '发布历史失败');
+                    }
+                    return res.data;
+                });
+            }),
         };
     }
     get record() {
@@ -93,9 +154,10 @@ class AiformGateway extends Object {
             /**
              * 上传表格图片
              * @param templateId 关联的模板ID
+             * @param watermark 图片是否带水印
              * @returns Promise 包含文件记录信息
              */
-            upload: (templateId) => __awaiter(this, void 0, void 0, function* () {
+            upload: (templateId_1, ...args_1) => __awaiter(this, [templateId_1, ...args_1], void 0, function* (templateId, watermark = false) {
                 const axios = yield this.context.ready;
                 if (!templateId) {
                     throw new Error('模板ID不能为空');
@@ -104,6 +166,7 @@ class AiformGateway extends Object {
                     title: "请选择要解析的表格图片",
                     data: {
                         templateId,
+                        watermark,
                     }
                 }).then((res) => {
                     if (res.data.code !== 200) {
@@ -148,6 +211,121 @@ class AiformGateway extends Object {
                     return res.data;
                 });
             }),
+            /**
+             * 根据reply_id获取解析结果
+             * @param replyId reply记录ID
+             * @returns Promise 包含解析结果详情
+             */
+            getReplyDetail: (replyId) => __awaiter(this, void 0, void 0, function* () {
+                const axios = yield this.context.ready;
+                if (!replyId) {
+                    throw new Error('reply记录ID不能为空');
+                }
+                return axios.get(`/api/v2/aiform/file/detail/reply/${replyId}`).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '获取解析结果失败');
+                    }
+                    return res.data;
+                });
+            }),
+            /**
+             * 根据解析结果提交反馈（reply）
+             * @param code 文件业务编码
+             * @param reply 用户的修改意见/反馈内容
+             * @returns Promise 包含调整后的解析结果
+             */
+            reply: (code, reply) => __awaiter(this, void 0, void 0, function* () {
+                const axios = yield this.context.ready;
+                if (!code) {
+                    throw new Error('文件业务编码不能为空');
+                }
+                if (!reply) {
+                    throw new Error('反馈内容不能为空');
+                }
+                return axios.post(`/api/v2/aiform/file/reply`, {
+                    code,
+                    reply
+                }, {
+                    headers: {
+                        'Content-Type': 'application/x-www-form-urlencoded'
+                    }
+                }).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '提交反馈失败');
+                    }
+                    return res.data;
+                });
+            }),
+            /**
+             * 用户确认并保存
+             * @param id 解析结果记录ID
+             * @param content 表格文本，markdown表格格式
+             * @param headerRowCount 表头行数（可选）
+             * @param headers 表头单元格列表（可选）
+             * @returns Promise 包含保存结果
+             */
+            confirm: (id, content, headerRowCount, headers) => __awaiter(this, void 0, void 0, function* () {
+                const axios = yield this.context.ready;
+                if (!id) {
+                    throw new Error('解析结果记录ID不能为空');
+                }
+                if (!content) {
+                    throw new Error('表格内容不能为空');
+                }
+                const data = {
+                    content,
+                };
+                if (headerRowCount !== undefined) {
+                    data.headerRowCount = headerRowCount;
+                }
+                if (headers) {
+                    data.headers = headers;
+                }
+                return axios.post(`/api/v2/aiform/file/confirm?id=${id}`, data, {
+                    headers: {
+                        'Content-Type': 'application/json'
+                    }
+                }).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '确认保存失败');
+                    }
+                    return res.data;
+                });
+            }),
+            /**
+             * 查询文件的reply调整历史
+             * @param code 文件业务编码
+             * @returns Promise 包含reply记录列表
+             */
+            getReplyList: (code) => __awaiter(this, void 0, void 0, function* () {
+                const axios = yield this.context.ready;
+                if (!code) {
+                    throw new Error('文件业务编码不能为空');
+                }
+                return axios.get(`/api/v2/aiform/file/reply/list/${code}`).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '获取reply历史失败');
+                    }
+                    return res.data;
+                });
+            }),
+            /**
+             * 根据文件code删除记录
+             * @param code 文件业务编码
+             * @returns Promise 包含删除结果
+             */
+            delete: (code) => __awaiter(this, void 0, void 0, function* () {
+                const axios = yield this.context.ready;
+                if (!code) {
+                    throw new Error('文件业务编码不能为空');
+                }
+                return axios.post(`/api/v2/aiform/file/delete/${code}`).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '删除记录失败');
+                    }
+                    return res.data;
+                });
+            }),
         };
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cpzxrobot/sdk",
-  "version": "1.3.120",
+  "version": "1.3.121",
   "description": "提供给上海正芯数智APP第三方H5应用使用的SDK",
   "main": "dist/index.js",
   "scripts": {

package/types.d.ts

@@ -820,7 +820,159 @@ interface AiformTemplate {
   /** 是否包含水印 */
   watermark?: boolean;
   /** 注意事项 */
-  attention?: string;
+  attention?: {
+    hasFixedContent: boolean;
+    fixedContentList: string[];
+    hasFixedRowContent: boolean;
+    rowContent: string;
+    hasFixedColumnContent: boolean;
+    columnContent: string;
+    otherNotes: string;
+  };
+  /** 解析状态：null-未上传 0-已上传 1-解析中 2-已解析 */
+  status?: number;
+  /** 从表格图片提炼的解析提示词 */
+  parsePrompt?: string;
+  /** 当前解析版本号 */
+  curVersion?: number;
+  /** 创建时间 */
+  createTime?: string;
+  /** 更新时间 */
+  updateTime?: string;
+}
+
+/**
+ * 模板历史快照接口
+ */
+interface AiformTemplateHistory {
+  /** 历史表主键 */
+  id: number;
+  /** 模板ID */
+  templateId: number;
+  /** 解析版本号 */
+  snapshotVersion: number;
+  /** 名称快照 */
+  name: string;
+  /** 内容快照 */
+  content: string;
+  /** 注意事项快照 */
+  attention: object;
+  /** 解析提示词快照 */
+  parsePrompt: string;
+  /** 归档时间 */
+  createTime: string;
+}
+
+/**
+ * 模板历史响应接口
+ */
+interface AiformTemplateHistoryResponse {
+  /** 响应码 */
+  code: number;
+  /** 提示信息 */
+  message: string;
+  /** 历史快照列表 */
+  data: AiformTemplateHistory[];
+}
+
+/**
+ * 模板发布响应接口
+ */
+interface AiformTemplatePublishResponse {
+  /** 响应码 */
+  code: number;
+  /** 提示信息 */
+  message: string;
+  /** 更新后的模板 */
+  data: AiformTemplate;
+}
+
+/**
+ * 记录VO接口
+ */
+interface AiformRecordVO {
+  /** 业务编码（用于调用详情接口） */
+  code: string;
+  /** 存储文件名 */
+  storageName: string;
+  /** 解析状态：0-已上传 1-解析中 2-已解析 */
+  status: number;
+  /** 图片是否带水印 */
+  watermark: boolean;
+  /** 创建用户ID */
+  createUserId: number;
+  /** 创建时间 */
+  createTime: string;
+  /** 更新时间 */
+  updateTime: string;
+}
+
+/**
+ * 解析结果详情接口（AiformParseResultVO）
+ */
+interface AiformParseResultVO {
+  /** 解析结果记录ID */
+  id: number;
+  /** markdown 解析的表格内容 */
+  content: string;
+  /** 疑似不清晰处的描述说明 */
+  unclears: string[];
+  /** 整体解析说明 */
+  description: string;
+  /** 解析结果（兼容旧数据或解析失败时的原始结果） */
+  parseResult: string | null;
+  /** 预签名访问链接（有效期7天） */
+  accessUrl: string;
+}
+
+/**
+ * Reply响应接口
+ */
+interface AiformReplyResponse {
+  /** 响应码 */
+  code: number;
+  /** 提示信息 */
+  message: string;
+  /** 调整后的解析结果 */
+  data: AiformParseResultVO;
+}
+
+/**
+ * Confirm响应接口
+ */
+interface AiformConfirmResponse {
+  /** 响应码 */
+  code: number;
+  /** 提示信息 */
+  message: string;
+}
+
+/**
+ * Reply记录接口
+ */
+interface AiformRecordReply {
+  /** 主键 */
+  id: number;
+  /** 记录ID，关联 aiform_record */
+  recordId: number;
+  /** 用户的修改意见/反馈内容 */
+  reply: string;
+  /** 创建用户ID */
+  createUserId: number;
+  /** 创建时间 */
+  createTime: string;
+}
+
+/**
+ * Reply列表响应接口
+ */
+interface AiformReplyListResponse {
+  /** 响应码 */
+  code: number;
+  /** 提示信息 */
+  message: string;
+  /** reply 记录列表 */
+  data: AiformRecordReply[];
 }
 
 /**
@@ -1074,12 +1226,18 @@ declare module "@cpzxrobot/sdk" {
     AiformTemplateListResponse,
     AiformTemplateSaveRequest,
     AiformTemplateSaveResponse,
-    File,
-    FileVO,
+    AiformTemplateHistory,
+    AiformTemplateHistoryResponse,
+    AiformTemplatePublishResponse,
+    AiformRecordVO,
     AiformParseResultVO,
     AiformFileUploadResponse,
     AiformFileListResponse,
     AiformFileDetailResponse,
+    AiformReplyResponse,
+    AiformConfirmResponse,
+    AiformRecordReply,
+    AiformReplyListResponse,
     AlarmRuleDetail,
     AlarmRuleListResponse,
     AlarmRuleDetailResponse,