@yanhaidao/wecom 2.3.14 → 2.3.141

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yanhaidao/wecom",
-  "version": "2.3.14",
+  "version": "2.3.141",
   "type": "module",
   "description": "OpenClaw 企业微信（WeCom）插件，默认 Bot WebSocket，支持加密媒体解密、Agent 主动发消息与多账号接入",
   "repository": {

package/src/agent/handler.ts

@@ -708,7 +708,7 @@ const ctxPayload = core.channel.reply.finalizeInboundContext({
             ctx: ctxPayload,
             cfg: config,
             replyOptions: {
-                disableBlockStreaming: true,
+                disableBlockStreaming: false,
             },
             dispatcherOptions: {
                 deliver: async (payload: { text?: string }, info: { kind: string }) => {
@@ -735,9 +735,9 @@ const ctxPayload = core.channel.reply.finalizeInboundContext({
                                 touchTransportSession?.({ lastOutboundAt: Date.now(), running: true });
                                 log?.(`[wecom-agent] reply chunk delivered (${info.kind}) to ${fromUser}, len=${chunk.length}`);
                                 
-                                // 强制延时：确保企业微信有足够时间处理顺序
+                                // 强制延时：确保企业微信有足够时间处理顺序（优化：200ms → 50ms）
                                 if (i + MAX_CHUNK_SIZE < text.length) {
-                                    await new Promise(resolve => setTimeout(resolve, 200));
+                                    await new Promise(resolve => setTimeout(resolve, 50));
                                 }
                             } catch (err: unknown) {
                                 const message = err instanceof Error ? `${err.message}${err.cause ? ` (cause: ${String(err.cause)})` : ""}` : String(err);
@@ -756,9 +756,9 @@ const ctxPayload = core.channel.reply.finalizeInboundContext({
                             }
                         }
                         
-                        // 不同 Block 之间也增加一点间隔
+                        // 不同 Block 之间也增加一点间隔（优化：200ms → 50ms）
                         if (info.kind !== "final") {
-                            await new Promise(resolve => setTimeout(resolve, 200));
+                            await new Promise(resolve => setTimeout(resolve, 50));
                         }
                     };
 

package/src/capability/doc/client.ts

@@ -631,16 +631,108 @@ export class WecomDocClient {
         return json;
     }
 
-    async editSheetData(params: { agent: ResolvedAgentAccount; docId: string; request: any }) {
-        const { agent, docId, request } = params;
-        const body = { docid: readString(docId), ...readObject(request) };
+    async editSheetData(params: { 
+        agent: ResolvedAgentAccount; 
+        docId: string; 
+        sheetId: string;
+        startRow?: number;
+        startColumn?: number;
+        gridData?: any;
+    }) {
+        const { agent, docId, sheetId, startRow = 0, startColumn = 0, gridData } = params;
+        
+        // Validate required docId
+        const normalizedDocId = readString(docId);
+        if (!normalizedDocId) {
+            throw new Error('docId is required');
+        }
+        
+        // Validate required sheetId
+        const normalizedSheetId = readString(sheetId);
+        if (!normalizedSheetId) {
+            throw new Error('sheetId is required');
+        }
+        
+        // Build GridData per official API
+        // gridData.rows[i].values[j] must be: {cell_value: {text} | {link: {text, url}}, cell_format?: {...}}
+        const finalGridData = {
+            start_row: startRow,
+            start_column: startColumn,
+            rows: (gridData?.rows || []).map((row: any) => ({
+                values: (row.values || []).map((cell: any) => {
+                    // If already CellData format, use as-is
+                    if (cell && typeof cell === 'object' && cell.cell_value) {
+                        return cell;
+                    }
+                    // Otherwise wrap primitive as CellValue
+                    return { cell_value: { text: String(cell ?? '') } };
+                })
+            }))
+        };
+        
+        // Build batch_update request per official API
+        const body = {
+            docid: normalizedDocId,
+            requests: [{
+                update_range_request: {
+                    sheet_id: normalizedSheetId,
+                    grid_data: finalGridData
+                }
+            }]
+        };
+        
         const json = await this.postWecomDocApi({
-            path: "/cgi-bin/wedoc/spreadsheet/edit_data",
-            actionLabel: "edit_data",
+            path: "/cgi-bin/wedoc/spreadsheet/batch_update",
+            actionLabel: "spreadsheet_batch_update",
             agent, body,
         });
         return { raw: json, docId: body.docid as string };
     }
+    
+    /**
+     * Build CellFormat object per official API
+     */
+    private buildCellFormat(formatData: any): any {
+        const textFormat: any = {};
+        
+        // Font properties
+        if (formatData.font != null) {
+            textFormat.font = String(formatData.font);
+        }
+        if (formatData.font_size != null) {
+            textFormat.font_size = Math.min(72, Math.max(1, Number(formatData.font_size)));
+        }
+        if (formatData.bold != null) {
+            textFormat.bold = Boolean(formatData.bold);
+        }
+        if (formatData.italic != null) {
+            textFormat.italic = Boolean(formatData.italic);
+        }
+        if (formatData.strikethrough != null) {
+            textFormat.strikethrough = Boolean(formatData.strikethrough);
+        }
+        if (formatData.underline != null) {
+            textFormat.underline = Boolean(formatData.underline);
+        }
+        
+        // Color (RGBA)
+        if (formatData.color != null && typeof formatData.color === "object") {
+            const color = formatData.color;
+            textFormat.color = {
+                red: Math.min(255, Math.max(0, Number(color.red ?? 0))),
+                green: Math.min(255, Math.max(0, Number(color.green ?? 0))),
+                blue: Math.min(255, Math.max(0, Number(color.blue ?? 0))),
+                alpha: Math.min(255, Math.max(0, Number(color.alpha ?? 255)))
+            };
+        }
+        
+        // Return empty object if no format properties
+        if (Object.keys(textFormat).length === 0) {
+            return null;
+        }
+        
+        return { text_format: textFormat };
+    }
 
     async getSheetData(params: { agent: ResolvedAgentAccount; docId: string; sheetId: string; range: string }) {
         const { agent, docId, sheetId, range } = params;

package/src/capability/doc/schema.ts

@@ -877,7 +877,7 @@ export const wecomDocToolSchema = {
         {
             type: "object",
             additionalProperties: false,
-            required: ["action", "docId", "request"],
+            required: ["action", "docId", "sheetId", "gridData"],
             properties: {
                 action: { const: "edit_sheet_data" },
                 accountId: accountIdProperty,
@@ -885,24 +885,146 @@ export const wecomDocToolSchema = {
                     ...docIdProperty,
                     description: "在线表格 docid",
                 },
-                request: {
+                sheetId: {
+                    type: "string",
+                    minLength: 1,
+                    description: "工作表 sheet_id",
+                },
+                startRow: {
+                    type: "integer",
+                    minimum: 0,
+                    description: "起始行号（从 0 开始）",
+                },
+                startColumn: {
+                    type: "integer",
+                    minimum: 0,
+                    description: "起始列号（从 0 开始）",
+                },
+                gridData: {
                     type: "object",
-                    description: "编辑表格请求体，按企业微信官方 edit_data 定义填写",
-                    additionalProperties: true,
-                    required: ["sheet_id", "range", "values"],
+                    description: "表格数据，按企业微信官方 GridData 定义填写",
+                    additionalProperties: false,
+                    required: ["rows"],
                     properties: {
-                         sheet_id: { type: "string" },
-                         range: { type: "string" },
-                         values: { 
-                             type: "array",
-                             items: { 
-                                 type: "array",
-                                 items: { 
-                                     type: "object",
-                                     properties: { text: { type: "string" }, url: { type: "string" } }
-                                 }
-                             }
-                         }
+                        startRow: { type: "integer", minimum: 0, description: "起始行号（从 0 开始）" },
+                        startColumn: { type: "integer", minimum: 0, description: "起始列号（从 0 开始）" },
+                        rows: {
+                            type: "array",
+                            minItems: 1,
+                            description: "行数据列表",
+                            items: {
+                                type: "object",
+                                additionalProperties: false,
+                                required: ["values"],
+                                properties: {
+                                    values: {
+                                        type: "array",
+                                        minItems: 1,
+                                        description: "单元格数据列表（CellData 格式）",
+                                        items: {
+                                            type: "object",
+                                            additionalProperties: false,
+                                            required: ["cell_value"],
+                                            properties: {
+                                                cell_value: {
+                                                    type: "object",
+                                                    description: "单元格值（text 或 link 二选一）",
+                                                    additionalProperties: false,
+                                                    oneOf: [
+                                                        { required: ["text"], not: { required: ["link"] } },
+                                                        { required: ["link"], not: { required: ["text"] } }
+                                                    ],
+                                                    properties: {
+                                                        text: { type: "string", description: "文本内容" },
+                                                        link: {
+                                                            type: "object",
+                                                            description: "超链接内容",
+                                                            additionalProperties: false,
+                                                            required: ["text", "url"],
+                                                            properties: {
+                                                                text: { type: "string", description: "链接显示文本" },
+                                                                url: { type: "string", description: "链接地址" }
+                                                            }
+                                                        }
+                                                    }
+                                                },
+                                                cell_format: {
+                                                    type: "object",
+                                                    description: "单元格格式（可选）",
+                                                    additionalProperties: false,
+                                                    properties: {
+                                                        text_format: {
+                                                            type: "object",
+                                                            description: "文本格式",
+                                                            additionalProperties: false,
+                                                            properties: {
+                                                                font: {
+                                                                    type: "string",
+                                                                    description: "字体名称（Microsoft YaHei, SimSun, Arial 等）"
+                                                                },
+                                                                font_size: {
+                                                                    type: "integer",
+                                                                    minimum: 1,
+                                                                    maximum: 72,
+                                                                    description: "字体大小（最大 72）"
+                                                                },
+                                                                bold: {
+                                                                    type: "boolean",
+                                                                    description: "加粗"
+                                                                },
+                                                                italic: {
+                                                                    type: "boolean",
+                                                                    description: "斜体"
+                                                                },
+                                                                strikethrough: {
+                                                                    type: "boolean",
+                                                                    description: "删除线"
+                                                                },
+                                                                underline: {
+                                                                    type: "boolean",
+                                                                    description: "下划线"
+                                                                },
+                                                                color: {
+                                                                    type: "object",
+                                                                    description: "字体颜色（RGBA）",
+                                                                    additionalProperties: false,
+                                                                    properties: {
+                                                                        red: {
+                                                                            type: "integer",
+                                                                            minimum: 0,
+                                                                            maximum: 255,
+                                                                            description: "红色通道"
+                                                                        },
+                                                                        green: {
+                                                                            type: "integer",
+                                                                            minimum: 0,
+                                                                            maximum: 255,
+                                                                            description: "绿色通道"
+                                                                        },
+                                                                        blue: {
+                                                                            type: "integer",
+                                                                            minimum: 0,
+                                                                            maximum: 255,
+                                                                            description: "蓝色通道"
+                                                                        },
+                                                                        alpha: {
+                                                                            type: "integer",
+                                                                            minimum: 0,
+                                                                            maximum: 255,
+                                                                            description: "透明度（255 完全不透明）"
+                                                                        }
+                                                                    }
+                                                                }
+                                                            }
+                                                        }
+                                                    }
+                                                }
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                        }
                     }
                 },
             },
@@ -930,34 +1052,8 @@ export const wecomDocToolSchema = {
                 },
             },
         },
-        {
-            type: "object",
-            additionalProperties: false,
-            required: ["action", "docId", "requests"],
-            properties: {
-                action: { const: "modify_sheet_properties" },
-                accountId: accountIdProperty,
-                docId: {
-                    ...docIdProperty,
-                    description: "在线表格 docid",
-                },
-                requests: {
-                    type: "array",
-                    minItems: 1,
-                    maxItems: 5,
-                    description: "修改属性请求列表，必须遵循企业微信 modify_sheet_properties 定义",
-                    items: {
-                        type: "object",
-                        oneOf: [
-                            { required: ["add_sheet_request"], properties: { add_sheet_request: addSheetRequest } },
-                            { required: ["update_range_request"], properties: { update_range_request: updateRangeRequest } },
-                            { required: ["delete_dimension_request"], properties: { delete_dimension_request: deleteDimensionRequest } },
-                            { required: ["delete_sheet_request"], properties: { delete_sheet_request: deleteSheetRequest } }
-                        ]
-                    }
-                },
-            },
-        },
+        // Note: batch_update is the underlying API, but users should use edit_sheet_data action instead
+        // The edit_sheet_data action handles conversion to batch_update format internally
         {
             type: "object",
             additionalProperties: false,

package/src/capability/doc/tool.ts

@@ -909,7 +909,10 @@ export function registerWecomDocTools(api: OpenClawPluginApi) {
                         const result = await docClient.editSheetData({
                             agent: account,
                             docId: params.docId,
-                            request: params.request,
+                            sheetId: params.sheetId,
+                            startRow: params.startRow ?? 0,
+                            startColumn: params.startColumn ?? 0,
+                            gridData: params.gridData,
                         });
                         return buildToolResult({
                             ok: true,