@cpzxrobot/sdk 1.3.124 → 1.3.126

package/aiform_gateway.ts

@@ -12,6 +12,14 @@ import type {
   AiformReplyDetailResponse,
   AiformConfirmResponse,
   AiformReplyListResponse,
+  AiformTemplateReplyResponse,
+  AiformTemplateReplyDetailResponse,
+  AiformTemplateConfirmResponse,
+  AiformRecordConfirmResponse,
+  AiformRecordHistoryResponse,
+  AiformStructTypeResponse,
+  AiformStructListResponse,
+  AiformStructDetailResponse,
 } from ".";
 
 export class AiformGateway extends Object {
@@ -151,6 +159,7 @@ export class AiformGateway extends Object {
 
       /**
        * 按版本号将历史发布到主表
+       * POST /api/v2/aiform/template/{templateId}/history/publish
        * @param templateId 模板ID
        * @param snapshotVersion 解析版本号
        * @returns Promise 包含更新后的模板
@@ -165,13 +174,138 @@ export class AiformGateway extends Object {
           throw new Error('解析版本号必须大于0');
         }
 
-        return axios.post(`/api/v2/aiform/template/${templateId}/history/${snapshotVersion}/publish`).then((res) => {
+        return axios.post(`/api/v2/aiform/template/${templateId}/history/publish`, {
+          snapshotVersion
+        }).then((res) => {
           if (res.data.code !== 200) {
             throw new Error(res.data.message || '发布历史失败');
           }
           return res.data;
         });
       },
+
+      /**
+       * 提交模板 Reply（异步）
+       * POST /api/v2/aiform/template/reply
+       * @param templateId 模板ID
+       * @param reply 用户修改意见
+       * @param replyId 链式调整的 replyId（可选）
+       * @returns Promise 包含 replyId、templateId 和 status
+       */
+      reply: async (templateId: number, reply: string, replyId?: number): Promise<AiformTemplateReplyResponse> => {
+        const axios = await this.context.ready;
+
+        if (!templateId) {
+          throw new Error('模板ID不能为空');
+        }
+        if (!reply) {
+          throw new Error('反馈内容不能为空');
+        }
+
+        const data: any = {
+          templateId,
+          reply
+        };
+
+        if (replyId) {
+          data.replyId = replyId;
+        }
+
+        return axios.post(`/api/v2/aiform/template/reply`, data).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '提交反馈失败');
+          }
+          return res.data;
+        });
+      },
+
+      /**
+       * 查询模板 Reply 历史列表
+       * GET /api/v2/aiform/template/reply/list/{templateId}
+       * @param templateId 模板ID
+       * @returns Promise 包含 reply 记录列表
+       */
+      getReplyList: async (templateId: number): Promise<any> => {
+        const axios = await this.context.ready;
+
+        if (!templateId) {
+          throw new Error('模板ID不能为空');
+        }
+
+        return axios.get(`/api/v2/aiform/template/reply/list/${templateId}`).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '获取reply历史失败');
+          }
+          return res.data;
+        });
+      },
+
+      /**
+       * 按 ReplyId 轮询模板 Reply 结果
+       * GET /api/v2/aiform/template/reply/detail/{replyId}
+       * @param replyId reply记录ID
+       * @returns Promise 包含 replyId、templateId、status 和 result
+       */
+      getReplyDetail: async (replyId: number): Promise<AiformTemplateReplyDetailResponse> => {
+        const axios = await this.context.ready;
+
+        if (!replyId) {
+          throw new Error('reply记录ID不能为空');
+        }
+
+        return axios.get(`/api/v2/aiform/template/reply/detail/${replyId}`).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '获取解析结果失败');
+          }
+          return res.data;
+        });
+      },
+
+      /**
+       * 确认 Reply 写入历史快照（可带手工润色）
+       * POST /api/v2/aiform/template/{templateId}/reply/confirm
+       * @param templateId 模板ID
+       * @param replyId 要确认的 replyId
+       * @param name 手工覆盖名称（可选）
+       * @param content 手工覆盖模板说明（可选）
+       * @param parsePrompt 手工覆盖解析提示词（可选）
+       * @param attention 手工覆盖注意事项（可选）
+       * @returns Promise 包含历史快照
+       */
+      confirmReply: async (templateId: number, replyId: number, name?: string, content?: string, parsePrompt?: string, attention?: any): Promise<AiformTemplateConfirmResponse> => {
+        const axios = await this.context.ready;
+
+        if (!templateId) {
+          throw new Error('模板ID不能为空');
+        }
+        if (!replyId) {
+          throw new Error('reply记录ID不能为空');
+        }
+
+        const data: any = {
+          replyId
+        };
+
+        if (name !== undefined) {
+          data.name = name;
+        }
+        if (content !== undefined) {
+          data.content = content;
+        }
+        if (parsePrompt !== undefined) {
+          data.parsePrompt = parsePrompt;
+        }
+        if (attention !== undefined) {
+          data.attention = attention;
+        }
+
+        return axios.post(`/api/v2/aiform/template/${templateId}/reply/confirm`, data).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '确认保存失败');
+          }
+          return res.data;
+        });
+      },
     };
   }
 
@@ -269,14 +403,15 @@ export class AiformGateway extends Object {
       },
 
       /**
-       * 根据解析结果提交反馈（reply）
+       * 提交文件 Reply（异步）
        * POST /api/v2/aiform/file/reply
        * @param code 文件业务编码
        * @param reply 用户的修改意见/反馈内容
+       * @param replyId 链式调整的 replyId（可选）
        * @returns Promise 包含 replyId、status 和 accessUrl
        * 注意：接口为异步，立即返回 replyId 与 status=1，需使用 getReplyDetail 按 replyId 轮询直至 status=2 或 0
        */
-      reply: async (code: string, reply: string): Promise<AiformReplyResponse> => {
+      reply: async (code: string, reply: string, replyId?: number): Promise<AiformReplyResponse> => {
         const axios = await this.context.ready;
 
         if (!code) {
@@ -286,14 +421,16 @@ export class AiformGateway extends Object {
           throw new Error('反馈内容不能为空');
         }
 
-        return axios.post(`/api/v2/aiform/file/reply`, {
+        const data: any = {
           code,
           reply
-        }, {
-          headers: {
-            'Content-Type': 'application/x-www-form-urlencoded'
-          }
-        }).then((res) => {
+        };
+
+        if (replyId) {
+          data.replyId = replyId;
+        }
+
+        return axios.post(`/api/v2/aiform/file/reply`, data).then((res) => {
           if (res.data.code !== 200) {
             throw new Error(res.data.message || '提交反馈失败');
           }
@@ -302,42 +439,76 @@ export class AiformGateway extends Object {
       },
 
       /**
-       * 用户确认并保存
-       * @param id 解析结果记录ID
-       * @param content 表格文本，markdown表格格式
-       * @param headerRowCount 表头行数（可选）
-       * @param headers 表头单元格列表（可选）
+       * 用户确认并保存（Markdown）
+       * POST /api/v2/aiform/file/confirm
+       * @param code 文件业务编码
+       * @param replyId 已成功的 replyId（可选）
+       * @param content 确认的 Markdown 全文（可选）
        * @returns Promise 包含保存结果
        */
-      confirm: async (id: number, content: string, headerRowCount?: number, headers?: any[]): Promise<AiformConfirmResponse> => {
+      confirm: async (code: string, replyId?: number, content?: string): Promise<AiformConfirmResponse> => {
         const axios = await this.context.ready;
 
-        if (!id) {
-          throw new Error('解析结果记录ID不能为空');
-        }
-        if (!content) {
-          throw new Error('表格内容不能为空');
+        if (!code) {
+          throw new Error('文件业务编码不能为空');
         }
 
         const data: any = {
-          content,
+          code
         };
 
-        if (headerRowCount !== undefined) {
-          data.headerRowCount = headerRowCount;
+        if (replyId) {
+          data.replyId = replyId;
+        }
+        if (content !== undefined) {
+          data.content = content;
         }
 
-        if (headers) {
-          data.headers = headers;
+        return axios.post(`/api/v2/aiform/file/confirm`, data).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '确认保存失败');
+          }
+          return res.data;
+        });
+      },
+
+      /**
+       * 查询确认主表当前快照
+       * GET /api/v2/aiform/file/confirm/current/{code}
+       * @param code 文件业务编码
+       * @returns Promise 包含当前确认快照
+       */
+      getConfirmCurrent: async (code: string): Promise<AiformRecordConfirmResponse> => {
+        const axios = await this.context.ready;
+
+        if (!code) {
+          throw new Error('文件业务编码不能为空');
         }
 
-        return axios.post(`/api/v2/aiform/file/confirm?id=${id}`, data, {
-          headers: {
-            'Content-Type': 'application/json'
+        return axios.get(`/api/v2/aiform/file/confirm/current/${code}`).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '获取确认快照失败');
           }
-        }).then((res) => {
+          return res.data;
+        });
+      },
+
+      /**
+       * 查询确认内容历史快照
+       * GET /api/v2/aiform/file/confirm/history/{code}
+       * @param code 文件业务编码
+       * @returns Promise 包含确认历史快照列表
+       */
+      getConfirmHistory: async (code: string): Promise<AiformRecordHistoryResponse> => {
+        const axios = await this.context.ready;
+
+        if (!code) {
+          throw new Error('文件业务编码不能为空');
+        }
+
+        return axios.get(`/api/v2/aiform/file/confirm/history/${code}`).then((res) => {
           if (res.data.code !== 200) {
-            throw new Error(res.data.message || '确认保存失败');
+            throw new Error(res.data.message || '获取确认历史失败');
           }
           return res.data;
         });
@@ -384,4 +555,107 @@ export class AiformGateway extends Object {
       },
     };
   }
+
+  get data() {
+    return {
+      /**
+       * 按工厂 + structType 查询已落库表头列表
+       * GET /api/v2/form/pigfarm/list
+       * @param factoryId 工厂ID
+       * @param structType 报表结构化类型
+       * @returns Promise 包含表头列表
+       */
+      list: async (factoryId: number, structType: string): Promise<AiformStructListResponse> => {
+        const axios = await this.context.ready;
+
+        if (!factoryId) {
+          throw new Error('工厂ID不能为空');
+        }
+        if (!structType) {
+          throw new Error('结构化类型不能为空');
+        }
+
+        return axios.get(`/api/v2/form/pigfarm/list`, {
+          params: {
+            factoryId,
+            structType
+          }
+        }).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '获取结构化列表失败');
+          }
+          return res.data;
+        });
+      },
+
+      /**
+       * 按表头 id 查询完整结构化内容
+       * GET /api/v2/form/pigfarm/detail
+       * @param id 表头ID
+       * @returns Promise 包含完整结构化内容
+       */
+      detail: async (id: number): Promise<AiformStructDetailResponse> => {
+        const axios = await this.context.ready;
+
+        if (!id) {
+          throw new Error('表头ID不能为空');
+        }
+
+        return axios.get(`/api/v2/form/pigfarm/detail`, {
+          params: {
+            id
+          }
+        }).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '获取结构化详情失败');
+          }
+          return res.data;
+        });
+      },
+
+      /**
+       * 查询标准化支持的 structType 枚举
+       * GET /api/v2/form/pigfarm/standardize/struct-types
+       * @returns Promise 包含 structType 列表
+       */
+      getStructTypes: async (): Promise<AiformStructTypeResponse> => {
+        const axios = await this.context.ready;
+
+        return axios.get(`/api/v2/form/pigfarm/standardize/struct-types`).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '获取结构化类型失败');
+          }
+          return res.data;
+        });
+      },
+
+      /**
+       * 从已确认 Markdown 写入结构化表
+       * POST /api/v2/form/pigfarm/standardize
+       * @param code 文件业务编码
+       * @param structType 报表结构化类型
+       * @returns Promise 包含保存结果
+       */
+      standardize: async (code: string, structType: string): Promise<any> => {
+        const axios = await this.context.ready;
+
+        if (!code) {
+          throw new Error('文件业务编码不能为空');
+        }
+        if (!structType) {
+          throw new Error('结构化类型不能为空');
+        }
+
+        return axios.post(`/api/v2/form/pigfarm/standardize`, {
+          code,
+          structType
+        }).then((res) => {
+          if (res.data.code !== 200) {
+            throw new Error(res.data.message || '标准化失败');
+          }
+          return res.data;
+        });
+      },
+    };
+  }
 }

package/dist/aiform_gateway.js

@@ -125,6 +125,7 @@ class AiformGateway extends Object {
             }),
             /**
              * 按版本号将历史发布到主表
+             * POST /api/v2/aiform/template/{templateId}/history/publish
              * @param templateId 模板ID
              * @param snapshotVersion 解析版本号
              * @returns Promise 包含更新后的模板
@@ -137,13 +138,122 @@ class AiformGateway extends Object {
                 if (!snapshotVersion || snapshotVersion <= 0) {
                     throw new Error('解析版本号必须大于0');
                 }
-                return axios.post(`/api/v2/aiform/template/${templateId}/history/${snapshotVersion}/publish`).then((res) => {
+                return axios.post(`/api/v2/aiform/template/${templateId}/history/publish`, {
+                    snapshotVersion
+                }).then((res) => {
                     if (res.data.code !== 200) {
                         throw new Error(res.data.message || '发布历史失败');
                     }
                     return res.data;
                 });
             }),
+            /**
+             * 提交模板 Reply（异步）
+             * POST /api/v2/aiform/template/reply
+             * @param templateId 模板ID
+             * @param reply 用户修改意见
+             * @param replyId 链式调整的 replyId（可选）
+             * @returns Promise 包含 replyId、templateId 和 status
+             */
+            reply: (templateId, reply, replyId) => __awaiter(this, void 0, void 0, function* () {
+                const axios = yield this.context.ready;
+                if (!templateId) {
+                    throw new Error('模板ID不能为空');
+                }
+                if (!reply) {
+                    throw new Error('反馈内容不能为空');
+                }
+                const data = {
+                    templateId,
+                    reply
+                };
+                if (replyId) {
+                    data.replyId = replyId;
+                }
+                return axios.post(`/api/v2/aiform/template/reply`, data).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '提交反馈失败');
+                    }
+                    return res.data;
+                });
+            }),
+            /**
+             * 查询模板 Reply 历史列表
+             * GET /api/v2/aiform/template/reply/list/{templateId}
+             * @param templateId 模板ID
+             * @returns Promise 包含 reply 记录列表
+             */
+            getReplyList: (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/reply/list/${templateId}`).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '获取reply历史失败');
+                    }
+                    return res.data;
+                });
+            }),
+            /**
+             * 按 ReplyId 轮询模板 Reply 结果
+             * GET /api/v2/aiform/template/reply/detail/{replyId}
+             * @param replyId reply记录ID
+             * @returns Promise 包含 replyId、templateId、status 和 result
+             */
+            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/template/reply/detail/${replyId}`).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '获取解析结果失败');
+                    }
+                    return res.data;
+                });
+            }),
+            /**
+             * 确认 Reply 写入历史快照（可带手工润色）
+             * POST /api/v2/aiform/template/{templateId}/reply/confirm
+             * @param templateId 模板ID
+             * @param replyId 要确认的 replyId
+             * @param name 手工覆盖名称（可选）
+             * @param content 手工覆盖模板说明（可选）
+             * @param parsePrompt 手工覆盖解析提示词（可选）
+             * @param attention 手工覆盖注意事项（可选）
+             * @returns Promise 包含历史快照
+             */
+            confirmReply: (templateId, replyId, name, content, parsePrompt, attention) => __awaiter(this, void 0, void 0, function* () {
+                const axios = yield this.context.ready;
+                if (!templateId) {
+                    throw new Error('模板ID不能为空');
+                }
+                if (!replyId) {
+                    throw new Error('reply记录ID不能为空');
+                }
+                const data = {
+                    replyId
+                };
+                if (name !== undefined) {
+                    data.name = name;
+                }
+                if (content !== undefined) {
+                    data.content = content;
+                }
+                if (parsePrompt !== undefined) {
+                    data.parsePrompt = parsePrompt;
+                }
+                if (attention !== undefined) {
+                    data.attention = attention;
+                }
+                return axios.post(`/api/v2/aiform/template/${templateId}/reply/confirm`, data).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '确认保存失败');
+                    }
+                    return res.data;
+                });
+            }),
         };
     }
     get record() {
@@ -228,14 +338,15 @@ class AiformGateway extends Object {
                 });
             }),
             /**
-             * 根据解析结果提交反馈（reply）
+             * 提交文件 Reply（异步）
              * POST /api/v2/aiform/file/reply
              * @param code 文件业务编码
              * @param reply 用户的修改意见/反馈内容
+             * @param replyId 链式调整的 replyId（可选）
              * @returns Promise 包含 replyId、status 和 accessUrl
              * 注意：接口为异步，立即返回 replyId 与 status=1，需使用 getReplyDetail 按 replyId 轮询直至 status=2 或 0
              */
-            reply: (code, reply) => __awaiter(this, void 0, void 0, function* () {
+            reply: (code, reply, replyId) => __awaiter(this, void 0, void 0, function* () {
                 const axios = yield this.context.ready;
                 if (!code) {
                     throw new Error('文件业务编码不能为空');
@@ -243,14 +354,14 @@ class AiformGateway extends Object {
                 if (!reply) {
                     throw new Error('反馈内容不能为空');
                 }
-                return axios.post(`/api/v2/aiform/file/reply`, {
+                const data = {
                     code,
                     reply
-                }, {
-                    headers: {
-                        'Content-Type': 'application/x-www-form-urlencoded'
-                    }
-                }).then((res) => {
+                };
+                if (replyId) {
+                    data.replyId = replyId;
+                }
+                return axios.post(`/api/v2/aiform/file/reply`, data).then((res) => {
                     if (res.data.code !== 200) {
                         throw new Error(res.data.message || '提交反馈失败');
                     }
@@ -258,41 +369,70 @@ class AiformGateway extends Object {
                 });
             }),
             /**
-             * 用户确认并保存
-             * @param id 解析结果记录ID
-             * @param content 表格文本，markdown表格格式
-             * @param headerRowCount 表头行数（可选）
-             * @param headers 表头单元格列表（可选）
+             * 用户确认并保存（Markdown）
+             * POST /api/v2/aiform/file/confirm
+             * @param code 文件业务编码
+             * @param replyId 已成功的 replyId（可选）
+             * @param content 确认的 Markdown 全文（可选）
              * @returns Promise 包含保存结果
              */
-            confirm: (id, content, headerRowCount, headers) => __awaiter(this, void 0, void 0, function* () {
+            confirm: (code, replyId, content) => __awaiter(this, void 0, void 0, function* () {
                 const axios = yield this.context.ready;
-                if (!id) {
-                    throw new Error('解析结果记录ID不能为空');
-                }
-                if (!content) {
-                    throw new Error('表格内容不能为空');
+                if (!code) {
+                    throw new Error('文件业务编码不能为空');
                 }
                 const data = {
-                    content,
+                    code
                 };
-                if (headerRowCount !== undefined) {
-                    data.headerRowCount = headerRowCount;
+                if (replyId) {
+                    data.replyId = replyId;
                 }
-                if (headers) {
-                    data.headers = headers;
+                if (content !== undefined) {
+                    data.content = content;
                 }
-                return axios.post(`/api/v2/aiform/file/confirm?id=${id}`, data, {
-                    headers: {
-                        'Content-Type': 'application/json'
-                    }
-                }).then((res) => {
+                return axios.post(`/api/v2/aiform/file/confirm`, data).then((res) => {
                     if (res.data.code !== 200) {
                         throw new Error(res.data.message || '确认保存失败');
                     }
                     return res.data;
                 });
             }),
+            /**
+             * 查询确认主表当前快照
+             * GET /api/v2/aiform/file/confirm/current/{code}
+             * @param code 文件业务编码
+             * @returns Promise 包含当前确认快照
+             */
+            getConfirmCurrent: (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/confirm/current/${code}`).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '获取确认快照失败');
+                    }
+                    return res.data;
+                });
+            }),
+            /**
+             * 查询确认内容历史快照
+             * GET /api/v2/aiform/file/confirm/history/{code}
+             * @param code 文件业务编码
+             * @returns Promise 包含确认历史快照列表
+             */
+            getConfirmHistory: (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/confirm/history/${code}`).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '获取确认历史失败');
+                    }
+                    return res.data;
+                });
+            }),
             /**
              * 查询文件的reply调整历史
              * @param code 文件业务编码
@@ -329,5 +469,97 @@ class AiformGateway extends Object {
             }),
         };
     }
+    get data() {
+        return {
+            /**
+             * 按工厂 + structType 查询已落库表头列表
+             * GET /api/v2/form/pigfarm/list
+             * @param factoryId 工厂ID
+             * @param structType 报表结构化类型
+             * @returns Promise 包含表头列表
+             */
+            list: (factoryId, structType) => __awaiter(this, void 0, void 0, function* () {
+                const axios = yield this.context.ready;
+                if (!factoryId) {
+                    throw new Error('工厂ID不能为空');
+                }
+                if (!structType) {
+                    throw new Error('结构化类型不能为空');
+                }
+                return axios.get(`/api/v2/form/pigfarm/list`, {
+                    params: {
+                        factoryId,
+                        structType
+                    }
+                }).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '获取结构化列表失败');
+                    }
+                    return res.data;
+                });
+            }),
+            /**
+             * 按表头 id 查询完整结构化内容
+             * GET /api/v2/form/pigfarm/detail
+             * @param id 表头ID
+             * @returns Promise 包含完整结构化内容
+             */
+            detail: (id) => __awaiter(this, void 0, void 0, function* () {
+                const axios = yield this.context.ready;
+                if (!id) {
+                    throw new Error('表头ID不能为空');
+                }
+                return axios.get(`/api/v2/form/pigfarm/detail`, {
+                    params: {
+                        id
+                    }
+                }).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '获取结构化详情失败');
+                    }
+                    return res.data;
+                });
+            }),
+            /**
+             * 查询标准化支持的 structType 枚举
+             * GET /api/v2/form/pigfarm/standardize/struct-types
+             * @returns Promise 包含 structType 列表
+             */
+            getStructTypes: () => __awaiter(this, void 0, void 0, function* () {
+                const axios = yield this.context.ready;
+                return axios.get(`/api/v2/form/pigfarm/standardize/struct-types`).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '获取结构化类型失败');
+                    }
+                    return res.data;
+                });
+            }),
+            /**
+             * 从已确认 Markdown 写入结构化表
+             * POST /api/v2/form/pigfarm/standardize
+             * @param code 文件业务编码
+             * @param structType 报表结构化类型
+             * @returns Promise 包含保存结果
+             */
+            standardize: (code, structType) => __awaiter(this, void 0, void 0, function* () {
+                const axios = yield this.context.ready;
+                if (!code) {
+                    throw new Error('文件业务编码不能为空');
+                }
+                if (!structType) {
+                    throw new Error('结构化类型不能为空');
+                }
+                return axios.post(`/api/v2/form/pigfarm/standardize`, {
+                    code,
+                    structType
+                }).then((res) => {
+                    if (res.data.code !== 200) {
+                        throw new Error(res.data.message || '标准化失败');
+                    }
+                    return res.data;
+                });
+            }),
+        };
+    }
 }
 exports.AiformGateway = AiformGateway;

package/package.json

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

package/types.d.ts

@@ -813,6 +813,8 @@ interface AiformTemplate {
   id: number;
   /** 工厂ID */
   factoryId: number;
+  /** 报表结构化类型（如 WEANING） */
+  structType?: string;
   /** 模板名称 */
   name: string;
   /** 模板内容 */
@@ -829,10 +831,12 @@ interface AiformTemplate {
     columnContent: string;
     otherNotes: string;
   };
-  /** 解析状态：null-未上传 0-已上传 1-解析中 2-已解析 */
+  /** 解析状态：null-未上传 0-已上传 1-解析中 2-已解析且与主表版本一致 3-历史中存在高于 curVersion 的快照待发布 */
   status?: number;
   /** 从表格图片提炼的解析提示词 */
   parsePrompt?: string;
+  /** 创建人用户ID */
+  createUserId?: number;
   /** 当前解析版本号 */
   curVersion?: number;
   /** 创建时间 */
@@ -1003,6 +1007,227 @@ interface AiformReplyListResponse {
   data: AiformRecordReply[];
 }
 
+/**
+ * 模板 Reply 响应接口
+ */
+interface AiformTemplateReplyResponse {
+  /** 响应码 */
+  code: number;
+  /** 提示信息 */
+  message: string;
+  /** 提交结果 */
+  data: {
+    /** 用于轮询的 replyId */
+    replyId: number;
+    /** 模板 ID */
+    templateId: number;
+    /** 提交后固定为 1 */
+    status: number;
+  };
+}
+
+/**
+ * 模板 Reply 详情响应接口
+ */
+interface AiformTemplateReplyDetailResponse {
+  /** 响应码 */
+  code: number;
+  /** 提示信息 */
+  message: string;
+  /** 轮询结果 */
+  data: {
+    /** 本条 reply 主键 */
+    replyId: number;
+    /** 模板 ID */
+    templateId: number;
+    /** 状态：0/1/2 */
+    status: number;
+    /** 仅成功时非空 */
+    result?: {
+      /** 与路径 replyId 一致 */
+      id: number;
+      /** 模板 ID */
+      templateId: number;
+      /** 调整后名称 */
+      name: string;
+      /** 调整后内容 */
+      content: string;
+      /** 调整后解析提示词 */
+      parsePrompt: string;
+      /** 调整后注意事项 */
+      attention: any;
+    };
+  };
+}
+
+/**
+ * 模板确认响应接口
+ */
+interface AiformTemplateConfirmResponse {
+  /** 响应码 */
+  code: number;
+  /** 提示信息 */
+  message: string;
+  /** 历史快照 */
+  data: AiformTemplateHistory;
+}
+
+/**
+ * 记录确认响应接口
+ */
+interface AiformRecordConfirmResponse {
+  /** 响应码 */
+  code: number;
+  /** 提示信息 */
+  message: string;
+  /** 当前确认快照 */
+  data: {
+    /** aiform_record.id */
+    id: number;
+    /** 该次确认依据的 aiform_parse_result.id */
+    parseResultId: number;
+    /** 确认的 Markdown */
+    content: string;
+    /** 当前确认版本号 */
+    curVersion: number;
+    /** 创建时间 */
+    createTime: string;
+    /** 更新时间 */
+    updateTime: string;
+  };
+}
+
+/**
+ * 记录历史响应接口
+ */
+interface AiformRecordHistoryResponse {
+  /** 响应码 */
+  code: number;
+  /** 提示信息 */
+  message: string;
+  /** 确认历史快照列表 */
+  data: {
+    /** 历史行主键 */
+    id: number;
+    /** aiform_record.id */
+    recordId: number;
+    /** 被归档时的确认版本号 */
+    snapshotVersion: number;
+    /** Markdown 快照 */
+    content: string;
+    /** 该快照对应的解析结果 ID */
+    parseResultId: number;
+    /** 归档操作人用户 ID */
+    createUserId: number;
+    /** 归档时间 */
+    createTime: string;
+  }[];
+}
+
+/**
+ * 结构化类型响应接口
+ */
+interface AiformStructTypeResponse {
+  /** 响应码 */
+  code: number;
+  /** 提示信息 */
+  message: string;
+  /** structType 列表 */
+  data: {
+    /** 与库表 struct_type 一致 */
+    code: string;
+    /** 展示名 */
+    label: string;
+  }[];
+}
+
+/**
+ * 结构化列表响应接口
+ */
+interface AiformStructListResponse {
+  /** 响应码 */
+  code: number;
+  /** 提示信息 */
+  message: string;
+  /** 表头列表 */
+  data: {
+    /** aiform_record_struct_header.id */
+    id: number;
+    /** aiform_record.id */
+    recordId: number;
+    /** 模板 ID */
+    templateId: number;
+    /** 工厂/猪场 ID */
+    factoryId: number;
+    /** 关联文件 code */
+    fileCode: string;
+    /** 如 WEANING */
+    structType: string;
+    /** 业务日期 */
+    businessDate: string;
+    /** 签字人/场长等 */
+    signatory: string;
+    /** 创建时间 */
+    createTime: string;
+  }[];
+}
+
+/**
+ * 结构化详情响应接口
+ */
+interface AiformStructDetailResponse {
+  /** 响应码 */
+  code: number;
+  /** 提示信息 */
+  message: string;
+  /** 完整结构化内容 */
+  data: {
+    /** 与列表 fileCode 一致 */
+    fileCode: string;
+    /** aiform_record.id */
+    recordId: number;
+    /** aiform_record_struct_header.id */
+    headerId: number;
+    /** 与表头一致 */
+    structType: string;
+    /** 模板 ID */
+    templateId: number;
+    /** 工厂 ID */
+    factoryId: number;
+    /** 业务日期 */
+    businessDate: string;
+    /** 签字人 */
+    signatory: string;
+    /** 大模型抽取的扩展 JSON */
+    headerExtra: string;
+    /** aiform_record.content，已确认 Markdown */
+    confirmedContent: string;
+    /** 表头创建时间 */
+    headerCreateTime: string;
+    /** 仅 WEANING 时有数据 */
+    weaningRows: {
+      /** 序号 */
+      serialNo: string;
+      /** 栋舍 */
+      building: string;
+      /** 栏位 */
+      pen: string;
+      /** 母猪耳号 */
+      sowEarTag: string;
+      /** 品种代码 */
+      breedCode: string;
+      /** 公猪数 */
+      maleCount: number;
+      /** 母猪数 */
+      femaleCount: number;
+      /** 总数 */
+      totalCount: number;
+      /** 创建时间 */
+      createTime: string;
+    }[];
+  };
+}
+
 /**
  * AI报表模板列表响应接口
  */
@@ -1267,6 +1492,14 @@ declare module "@cpzxrobot/sdk" {
     AiformConfirmResponse,
     AiformRecordReply,
     AiformReplyListResponse,
+    AiformTemplateReplyResponse,
+    AiformTemplateReplyDetailResponse,
+    AiformTemplateConfirmResponse,
+    AiformRecordConfirmResponse,
+    AiformRecordHistoryResponse,
+    AiformStructTypeResponse,
+    AiformStructListResponse,
+    AiformStructDetailResponse,
     AlarmRuleDetail,
     AlarmRuleListResponse,
     AlarmRuleDetailResponse,