@yanhaidao/wecom 2.4.120 → 2.5.110

package/SKILLS_DOC.md

@@ -1,2288 +0,0 @@
-# OpenClaw 企业微信文档能力技能清单
-
-> 本清单列出所有企业微信文档相关的 MCP Tools，按功能模块分类，方便 OpenClaw 直接调用。
-
-## 一、文档基础操作 (Doc Basic Operations)
-
-### 1.1 创建文档
-```json
-{
-  "name": "wecom_doc",
-  "action": "create",
-  "description": "创建文档/表格/智能表格",
-  "parameters": {
-    "docName": "文档名称",
-    "docType": "doc|spreadsheet|smart_table|3|4|10",
-    "spaceId": "可选：空间 ID",
-    "fatherId": "可选：父目录 fileid",
-    "adminUsers": "可选但推荐：文档管理员 userid 列表，创建智能表格时建议填写",
-    "viewers": "可选：查看成员列表",
-    "collaborators": "可选：协作者列表",
-    "init_content": "可选：初始内容数组"
-  },
-  "returns": {
-    "docId": "文档 ID",
-    "url": "文档链接",
-    "title": "文档标题",
-    "resourceType": "资源类型"
-  }
-}
-```
-
-**⚠️ 智能表格创建注意事项**:
-1. **adminUsers 参数** - 创建智能表格时强烈建议传入 `adminUsers: ["userid1", "userid2"]`，确保有管理员权限
-2. **自动初始化** - 创建智能表格后会自动清理默认字段（5 个保留 1 个）和默认空白记录（5 条）
-3. **默认字段类型** - 文本、数字、日期、单选、人员，其中文本/数字/日期等可作为主键
-
-### 1.2 重命名文档
-```json
-{
-  "name": "wecom_doc",
-  "action": "rename",
-  "description": "重命名文档",
-  "parameters": {
-    "docId": "文档 ID",
-    "newName": "新名称"
-  }
-}
-```
-
-### 1.3 复制文档
-```json
-{
-  "name": "wecom_doc",
-  "action": "copy",
-  "description": "复制文档",
-  "parameters": {
-    "docId": "文档 ID",
-    "newName": "新文档名称",
-    "spaceId": "可选：目标空间 ID",
-    "fatherId": "可选：目标父目录"
-  }
-}
-```
-
-### 1.4 获取文档信息
-```json
-{
-  "name": "wecom_doc",
-  "action": "get_info",
-  "description": "获取文档基本信息",
-  "parameters": {
-    "docId": "文档 ID"
-  },
-  "returns": {
-    "doc_name": "文档名称",
-    "doc_type": "文档类型"
-  }
-}
-```
-
-### 1.5 获取分享链接
-```json
-{
-  "name": "wecom_doc",
-  "action": "share",
-  "description": "获取文档分享链接",
-  "parameters": {
-    "docId": "文档 ID"
-  },
-  "returns": {
-    "shareUrl": "分享链接"
-  }
-}
-```
-
-### 1.6 删除文档
-```json
-{
-  "name": "wecom_doc",
-  "action": "delete",
-  "description": "删除文档或收集表",
-  "parameters": {
-    "docId": "可选：文档 ID",
-    "formId": "可选：收集表 ID"
-  }
-}
-```
-
----
-
-## 二、文档权限管理 (Doc Permission Management)
-
-### 2.1 获取文档权限
-```json
-{
-  "name": "wecom_doc",
-  "action": "get_auth",
-  "description": "获取文档权限信息",
-  "parameters": {
-    "docId": "文档 ID"
-  },
-  "returns": {
-    "docMembers": "查看成员列表",
-    "coAuthList": "协作者列表",
-    "accessRule": "访问规则"
-  }
-}
-```
-
-### 2.2 诊断文档权限
-```json
-{
-  "name": "wecom_doc",
-  "action": "diagnose_auth",
-  "description": "诊断文档访问权限问题",
-  "parameters": {
-    "docId": "文档 ID"
-  },
-  "returns": {
-    "internalAccessEnabled": "企业内访问是否开启",
-    "externalAccessEnabled": "企业外访问是否开启",
-    "requesterRole": "请求人角色",
-    "findings": "诊断发现",
-    "recommendations": "建议"
-  }
-}
-```
-
-### 2.3 校验分享链接
-```json
-{
-  "name": "wecom_doc",
-  "action": "validate_share_link",
-  "description": "校验分享链接可用性",
-  "parameters": {
-    "shareUrl": "分享链接"
-  },
-  "returns": {
-    "httpStatus": "HTTP 状态码",
-    "userType": "访问身份",
-    "padType": "页面类型",
-    "findings": "诊断发现"
-  }
-}
-```
-
-### 2.4 设置加入规则
-```json
-{
-  "name": "wecom_doc",
-  "action": "set_join_rule",
-  "description": "设置文档加入规则",
-  "parameters": {
-    "docId": "文档 ID",
-    "request": {
-      "enable_corp_internal": "是否开启企业内访问",
-      "corp_internal_auth": "企业内权限：1 只读 2 编辑",
-      "enable_corp_external": "是否开启企业外访问",
-      "ban_share_external": "是否禁止外部分享"
-    }
-  }
-}
-```
-
-### 2.5 设置成员权限
-```json
-{
-  "name": "wecom_doc",
-  "action": "set_member_auth",
-  "description": "设置文档通知范围及成员权限",
-  "parameters": {
-    "docId": "文档 ID",
-    "request": {
-      "notified_scope_type": "通知范围类型",
-      "notified_member_list": "通知成员列表"
-    }
-  }
-}
-```
-
-### 2.6 授予/撤销访问权限
-```json
-{
-  "name": "wecom_doc",
-  "action": "grant_access",
-  "description": "批量授予或撤销文档访问权限",
-  "parameters": {
-    "docId": "文档 ID",
-    "viewers": "可选：查看成员列表",
-    "collaborators": "可选：协作者列表",
-    "removeViewers": "可选：移除查看成员",
-    "removeCollaborators": "可选：移除协作者",
-    "auth": "可选：权限级别"
-  }
-}
-```
-
-### 2.7 添加协作者
-```json
-{
-  "name": "wecom_doc",
-  "action": "add_collaborators",
-  "description": "添加文档协作者",
-  "parameters": {
-    "docId": "文档 ID",
-    "collaborators": "协作者列表",
-    "auth": "可选：权限级别"
-  }
-}
-```
-
-### 2.8 设置安全设置
-```json
-{
-  "name": "wecom_doc",
-  "action": "set_safety_setting",
-  "description": "设置文档安全设置（水印、复制等）",
-  "parameters": {
-    "docId": "文档 ID",
-    "request": {
-      "watermark": "水印设置",
-      "disable_copy": "禁止复制",
-      "disable_print": "禁止打印"
-    }
-  }
-}
-```
-
-### 2.9 获取安全设置
-```json
-{
-  "name": "wecom_doc",
-  "action": "get_doc_security_setting",
-  "description": "获取文档安全设置",
-  "parameters": {
-    "docId": "文档 ID"
-  }
-}
-```
-
----
-
-## 三、文档内容操作 (Doc Content Operations)
-
-### 3.1 获取文档内容
-```json
-{
-  "name": "wecom_doc",
-  "action": "get_content",
-  "description": "获取文档完整内容（包含版本号和文档树）",
-  "parameters": {
-    "docId": "文档 ID"
-  },
-  "returns": {
-    "version": "文档版本号",
-    "document": "文档内容树（Node 结构）"
-  }
-}
-```
-
-### 3.2 更新文档内容
-```json
-{
-  "name": "wecom_doc",
-  "action": "update_content",
-  "description": "批量更新文档内容（最多 30 个操作）",
-  "parameters": {
-    "docId": "文档 ID",
-    "requests": [
-      {
-        "replace_text": { "text": "替换文本", "ranges": [{"start_index": 0, "length": 5}] }
-      },
-      {
-        "insert_text": { "text": "插入文本", "location": { "index": 10 } }
-      },
-      {
-        "insert_image": { "image_id": "图片 URL", "location": { "index": 20 } }
-      },
-      {
-        "insert_table": { "rows": 3, "cols": 3, "location": { "index": 30 } }
-      },
-      {
-        "insert_paragraph": { "location": { "index": 40 } }
-      },
-      {
-        "update_text_property": { "text_property": { "bold": true }, "ranges": [...] }
-      }
-    ],
-    "version": "可选：文档版本号"
-  },
-  "returns": {
-    "batches": "分批数量（超过 30 个操作时自动分批）"
-  }
-}
-```
-
-### 3.3 上传图片到文档
-```json
-{
-  "name": "wecom_doc",
-  "action": "upload_doc_image",
-  "description": "上传图片到文档（获取 image_id）",
-  "parameters": {
-    "docId": "文档 ID",
-    "file_path": "本地图片路径"
-  },
-  "returns": {
-    "url": "图片 URL",
-    "width": "图片宽度",
-    "height": "图片高度",
-    "size": "文件大小"
-  }
-}
-```
-
----
-
-## 四、在线表格操作 (Spreadsheet Operations)
-
-### 4.1 获取表格属性
-```json
-{
-  "name": "wecom_doc",
-  "action": "get_sheet_properties",
-  "description": "获取在线表格所有工作表属性",
-  "parameters": {
-    "docId": "文档 ID"
-  },
-  "returns": {
-    "properties": [
-      {
-        "sheet_id": "工作表 ID",
-        "title": "工作表标题",
-        "row_count": "行数",
-        "column_count": "列数"
-      }
-    ]
-  }
-}
-```
-
-### 4.2 获取表格数据
-```json
-{
-  "name": "wecom_doc",
-  "action": "get_sheet_data",
-  "description": "获取指定范围内的单元格数据",
-  "parameters": {
-    "docId": "文档 ID",
-    "sheetId": "工作表 ID",
-    "range": "A1 表示法范围，如 A1:B5"
-  },
-  "returns": {
-    "data": {
-      "start_row": "起始行",
-      "start_column": "起始列",
-      "rows": [{ "values": [{ "cell_value": {...}, "cell_format": {...} }] }]"
-    }
-  }
-}
-```
-
-### 4.3 编辑表格数据
-```json
-{
-  "name": "wecom_doc",
-  "action": "edit_sheet_data",
-  "description": "编辑表格单元格数据（最多 5 个操作）",
-  "parameters": {
-    "docId": "文档 ID",
-    "sheetId": "工作表 ID",
-    "startRow": "可选：起始行（从 0 开始）",
-    "startColumn": "可选：起始列（从 0 开始）",
-    "gridData": {
-      "rows": [
-        { "values": [{ "cell_value": { "text": "内容" } }] }
-      ]
-    }
-  }
-}
-```
-
-### 4.4 修改表格属性
-```json
-{
-  "name": "wecom_doc",
-  "action": "modify_sheet_properties",
-  "description": "修改工作表属性（添加/删除/重命名）",
-  "parameters": {
-    "docId": "文档 ID",
-    "requests": [
-      {
-        "add_sheet_request": { "title": "新工作表", "row_count": 10, "column_count": 10 }
-      },
-      {
-        "delete_sheet_request": { "sheet_id": "要删除的工作表 ID" }
-      },
-      {
-        "update_range_request": { "sheet_id": "...", "grid_data": {...} }
-      },
-      {
-        "delete_dimension_request": { "sheet_id": "...", "dimension": "ROW|COLUMN", "start_index": 1, "end_index": 5 }
-      }
-    ]
-  }
-}
-```
-
----
-
-## 五、智能表格操作 (Smart Table Operations)
-
-### 5.1 查询子表
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_get_sheets",
-  "description": "查询智能表格所有子表信息",
-  "parameters": {
-    "docId": "文档 ID",
-    "sheet_id": "可选：指定子表 ID 查询",
-    "need_all_type_sheet": "可选：获取所有类型子表（包含仪表盘和说明页）"
-  },
-  "returns": {
-    "sheet_list": [
-      {
-        "sheet_id": "子表 ID",
-        "title": "子表名称",
-        "is_visible": "是否可见",
-        "type": "smartsheet|dashboard|external"
-      }
-    ]
-  }
-}
-```
-
-**⚠️ 智能表格自动初始化**:
-创建智能表格 (`docType=10` 或 `smart_table`) 时，系统会自动执行以下初始化操作：
-1. 获取默认子表（类型为 `smartsheet` 的第一个子表）
-2. 获取默认字段（通常有 5 个：文本、数字、日期、单选、人员）
-3. 删除 4 个默认字段，保留 1 个可作为主键的字段
-4. 获取默认记录（通常有 5 条空白记录）
-5. 删除所有默认空白记录
-
-这样可以确保新创建的智能表格是干净的，用户可以根据需求添加自定义字段和记录。
-
-### 5.2 添加子表
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_add_sheet",
-  "description": "添加智能表格子表",
-  "parameters": {
-    "docId": "文档 ID",
-    "title": "子表标题",
-    "index": "可选：子表下标"
-  },
-  "returns": {
-    "properties": {
-      "sheet_id": "生成的子表 ID",
-      "title": "子表标题",
-      "index": "子表下标"
-    }
-  }
-}
-```
-
-### 5.3 删除子表
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_del_sheet",
-  "description": "删除智能表格子表",
-  "parameters": {
-    "docId": "文档 ID",
-    "sheetId": "子表 ID"
-  }
-}
-```
-
-### 5.4 更新子表
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_update_sheet",
-  "description": "修改子表标题",
-  "parameters": {
-    "docId": "文档 ID",
-    "sheetId": "子表 ID",
-    "title": "新标题"
-  }
-}
-```
-
-### 5.5 添加视图
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_add_view",
-  "description": "在子表中添加新视图",
-  "parameters": {
-    "docId": "文档 ID",
-    "sheetId": "子表 ID",
-    "view_title": "视图标题",
-    "view_type": "VIEW_TYPE_GRID|VIEW_TYPE_KANBAN|VIEW_TYPE_GALLERY|VIEW_TYPE_GANTT|VIEW_TYPE_CALENDAR",
-    "property": "可选：视图属性（sort_spec, filter_spec, group_spec 等）"
-  },
-  "returns": {
-    "view": {
-      "view_id": "视图 ID",
-      "view_title": "视图标题",
-      "view_type": "视图类型"
-    }
-  }
-}
-```
-
-### 5.6 更新视图
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_update_view",
-  "description": "更新视图属性",
-  "parameters": {
-    "docId": "文档 ID",
-    "sheetId": "子表 ID",
-    "view_id": "视图 ID",
-    "view_title": "可选：新视图标题",
-    "property": "可选：视图属性（sort_spec, filter_spec, group_spec, color_config 等）"
-  }
-}
-```
-
-### 5.7 删除视图
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_del_view",
-  "description": "删除一个或多个视图",
-  "parameters": {
-    "docId": "文档 ID",
-    "sheetId": "子表 ID",
-    "view_ids": ["视图 ID 列表"]
-  }
-}
-```
-
-### 5.8 查询视图
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_get_views",
-  "description": "获取子表下所有视图信息",
-  "parameters": {
-    "docId": "文档 ID",
-    "sheetId": "子表 ID",
-    "view_ids": "可选：指定视图 ID 列表",
-    "offset": "可选：偏移量",
-    "limit": "可选：分页大小（最大 1000）"
-  },
-  "returns": {
-    "views": [...],
-    "total": "视图总数",
-    "has_more": "是否还有更多",
-    "next": "下次查询的偏移量"
-  }
-}
-```
-
-### 5.9 添加字段
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_add_fields",
-  "description": "在子表中添加一个或多个字段（单表最多 150 个字段）",
-  "parameters": {
-    "docId": "必填：string，文档的 docid",
-    "sheetId": "必填：string，表格 ID",
-    "fields": "必填：object[]，字段详情数组",
-    "fields[].field_title": "必填：string，字段标题",
-    "fields[].field_type": "必填：string，字段类型，见下方字段类型对照表",
-    "fields[].property_number": "可选：object，数字类型的字段属性，{decimal_places: 2, use_separate: true}",
-    "fields[].property_checkbox": "可选：object，复选框类型的字段属性，{checked: true}",
-    "fields[].property_date_time": "可选：object，日期类型的字段属性，{format: \"yyyy-mm-dd\", auto_fill: false}",
-    "fields[].property_attachment": "可选：object，文件类型的字段属性，{display_mode: \"DISPLAY_MODE_LIST\"}",
-    "fields[].property_user": "可选：object，人员类型的字段属性，{is_multiple: true, is_notified: true}",
-    "fields[].property_url": "可选：object，超链接类型的字段属性，{type: \"LINK_TYPE_PURE_TEXT\"}",
-    "fields[].property_select": "可选：object，多选类型的字段属性，{is_quick_add: true, options: [{id: \"1\", text: \"选项 1\", style: 1}]}",
-    "fields[].property_created_time": "可选：object，创建时间类型的字段属性，{format: \"yyyy-mm-dd\"}",
-    "fields[].property_modified_time": "可选：object，最后编辑时间类型的字段属性，{format: \"yyyy-mm-dd\"}",
-    "fields[].property_progress": "可选：object，进度类型的字段属性，{decimal_places: 2}",
-    "fields[].property_single_select": "可选：object，单选类型的字段属性，{is_quick_add: true, options: [...]}",
-    "fields[].property_reference": "可选：object，关联类型的字段属性，{sub_id: \"\", field_id: \"\", is_multiple: false, view_id: \"\"}",
-    "fields[].property_location": "可选：object，地理位置类型的字段属性，{input_type: \"LOCATION_INPUT_TYPE_MANUAL\"}",
-    "fields[].property_auto_number": "可选：object，自动编号类型的字段属性，{type: \"NUMBER_TYPE_INCR\", rules: [...], reformat_existing_record: false}",
-    "fields[].property_currency": "可选：object，货币类型的字段属性，{currency_type: \"CURRENCY_TYPE_CNY\", decimal_places: 2, use_separate: true}",
-    "fields[].property_ww_group": "可选：object，群类型的字段属性，{allow_multiple: true}",
-    "fields[].property_percentage": "可选：object，百分数类型的字段属性，{decimal_places: 2, use_separate: true}",
-    "fields[].property_barcode": "可选：object，条码类型的字段属性，{mobile_scan_only: false}",
-    "autoCleanupDefaultField": "可选：boolean，是否自动删除遗留的默认字段（默认 true）"
-  },
-  "returns": {
-    "errcode": "integer，错误码",
-    "errmsg": "string，错误码描述",
-    "fields": "object[]，字段详情数组",
-    "fields[].field_id": "string，生成的字段 ID",
-    "fields[].field_title": "string，字段标题",
-    "fields[].field_type": "string，字段类型"
-  }
-}
-```
-
-**使用示例** - 添加文本字段:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_add_fields",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "fields": [
-      {
-        "field_title": "姓名",
-        "field_type": "FIELD_TYPE_TEXT"
-      },
-      {
-        "field_title": "备注",
-        "field_type": "FIELD_TYPE_TEXT"
-      }
-    ]
-  }
-}
-```
-
-**使用示例** - 添加数字和日期字段:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_add_fields",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "fields": [
-      {
-        "field_title": "年龄",
-        "field_type": "FIELD_TYPE_NUMBER",
-        "property_number": {
-          "decimal_places": 0,
-          "use_separate": false
-        }
-      },
-      {
-        "field_title": "入职日期",
-        "field_type": "FIELD_TYPE_DATE_TIME",
-        "property_date_time": {
-          "format": "yyyy-mm-dd",
-          "auto_fill": false
-        }
-      }
-    ]
-  }
-}
-```
-
-**使用示例** - 添加多选字段:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_add_fields",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "fields": [
-      {
-        "field_title": "技能",
-        "field_type": "FIELD_TYPE_SELECT",
-        "property_select": {
-          "is_quick_add": true,
-          "options": [
-            {"text": "Java", "style": 1},
-            {"text": "Python", "style": 2},
-            {"text": "JavaScript", "style": 3}
-          ]
-        }
-      }
-    ]
-  }
-}
-```
-
-**⚠️ 重要注意事项**:
-1. **字段属性必须与字段类型匹配** - 一种字段类型对应一种字段属性
-2. **新增选项时不需要 id** - 只需填写 `text` 和 `style`，系统会自动生成 id
-3. **field_type 必须使用官方常量** - 如 `FIELD_TYPE_TEXT`、`FIELD_TYPE_NUMBER` 等
-4. **单表最多 150 个字段** - 超过限制会失败
-5. **默认字段清理** - 创建智能表格时会自动清理默认字段（保留 1 个）
-6. **自动删除遗留字段** - 第一次调用 `smartsheet_add_fields` 添加新字段后，会自动删除遗留的默认字段（可通过 `autoCleanupDefaultField: false` 禁用）
-
-**字段类型与属性对照表**:
-
-| 字段类型 | 字段属性 | 说明 |
-|----------|----------|------|
-| FIELD_TYPE_TEXT | 无 | 文本类型不需要属性 |
-| FIELD_TYPE_NUMBER | property_number | 数字类型，可设置小数位数和千位符 |
-| FIELD_TYPE_CHECKBOX | property_checkbox | 复选框类型，可设置默认是否勾选 |
-| FIELD_TYPE_DATE_TIME | property_date_time | 日期类型，可设置日期格式和自动填充 |
-| FIELD_TYPE_IMAGE | 无 | 图片类型不需要属性 |
-| FIELD_TYPE_ATTACHMENT | property_attachment | 文件类型，可设置展示样式（列表/宫格） |
-| FIELD_TYPE_USER | property_user | 人员类型，可设置是否多选和是否通知 |
-| FIELD_TYPE_URL | property_url | 超链接类型，可设置展示样式（文字/图标文字） |
-| FIELD_TYPE_SELECT | property_select | 多选类型，可设置选项和是否允许新增 |
-| FIELD_TYPE_SINGLE_SELECT | property_single_select | 单选类型，可设置选项和是否允许新增 |
-| FIELD_TYPE_CREATED_TIME | property_created_time | 创建时间类型，可设置日期格式 |
-| FIELD_TYPE_MODIFIED_TIME | property_modified_time | 最后编辑时间类型，可设置日期格式 |
-| FIELD_TYPE_PROGRESS | property_progress | 进度类型，可设置小数位数 |
-| FIELD_TYPE_PHONE_NUMBER | 无 | 电话类型不需要属性 |
-| FIELD_TYPE_EMAIL | 无 | 邮箱类型不需要属性 |
-| FIELD_TYPE_REFERENCE | property_reference | 关联类型，可设置关联子表和字段 |
-| FIELD_TYPE_LOCATION | property_location | 地理位置类型，可设置输入类型（手动/自动） |
-| FIELD_TYPE_CURRENCY | property_currency | 货币类型，可设置货币类型和小数位数 |
-| FIELD_TYPE_WWGROUP | property_ww_group | 群类型，可设置是否多选 |
-| FIELD_TYPE_AUTONUMBER | property_auto_number | 自动编号类型，可设置编号规则 |
-| FIELD_TYPE_PERCENTAGE | property_percentage | 百分数类型，可设置小数位数 |
-| FIELD_TYPE_BARCODE | property_barcode | 条码类型，可设置是否仅限手机扫描 |
-
-### 5.10 删除字段
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_del_fields",
-  "description": "删除一个或多个字段",
-  "parameters": {
-    "docId": "必填：string，文档的 docid",
-    "sheetId": "必填：string，表格 ID",
-    "field_ids": "必填：string[]，需要删除的字段 id 列表"
-  },
-  "returns": {
-    "errcode": "integer，错误码",
-    "errmsg": "string，错误码描述"
-  }
-}
-```
-
-**使用示例**:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_del_fields",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "field_ids": ["f1gHSR", "fabcde"]
-  }
-}
-```
-
----
-
-### 5.11 更新字段
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_update_fields",
-  "description": "更新字段的标题和字段属性（不能更新字段类型）",
-  "parameters": {
-    "docId": "必填：string，文档的 docid",
-    "sheetId": "必填：string，表格 ID",
-    "fields": "必填：object[]，字段详情数组",
-    "fields[].field_id": "必填：string，字段 ID（不能更新）",
-    "fields[].field_title": "可选：string，新字段标题（不能更新为原值）",
-    "fields[].field_type": "必填：string，字段类型（必须为原类型）",
-    "fields[].property_number": "可选：object，数字类型的字段属性",
-    "fields[].property_checkbox": "可选：object，复选框类型的字段属性",
-    "fields[].property_date_time": "可选：object，日期类型的字段属性",
-    "fields[].property_attachment": "可选：object，文件类型的字段属性",
-    "fields[].property_user": "可选：object，人员类型的字段属性",
-    "fields[].property_url": "可选：object，超链接类型的字段属性",
-    "fields[].property_select": "可选：object，多选类型的字段属性",
-    "fields[].property_created_time": "可选：object，创建时间类型的字段属性",
-    "fields[].property_modified_time": "可选：object，最后编辑时间类型的字段属性",
-    "fields[].property_progress": "可选：object，进度类型的字段属性",
-    "fields[].property_single_select": "可选：object，单选类型的字段属性",
-    "fields[].property_reference": "可选：object，关联类型的字段属性",
-    "fields[].property_location": "可选：object，地理位置类型的字段属性",
-    "fields[].property_auto_number": "可选：object，自动编号类型的字段属性",
-    "fields[].property_currency": "可选：object，货币类型的字段属性",
-    "fields[].property_ww_group": "可选：object，群类型的字段属性",
-    "fields[].property_percentage": "可选：object，百分数类型的字段属性",
-    "fields[].property_barcode": "可选：object，条码类型的字段属性"
-  },
-  "returns": {
-    "errcode": "integer，错误码",
-    "errmsg": "string，错误码描述",
-    "fields": "object[]，字段详情数组"
-  }
-}
-```
-
-**使用示例** - 更新字段标题:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_update_fields",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "fields": [
-      {
-        "field_id": "f1gHSR",
-        "field_title": "员工姓名",
-        "field_type": "FIELD_TYPE_TEXT"
-      }
-    ]
-  }
-}
-```
-
-**使用示例** - 更新字段属性:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_update_fields",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "fields": [
-      {
-        "field_id": "fabcde",
-        "field_type": "FIELD_TYPE_NUMBER",
-        "property_number": {
-          "decimal_places": 2,
-          "use_separate": true
-        }
-      }
-    ]
-  }
-}
-```
-
-**⚠️ 重要注意事项**:
-1. **不能更新字段类型** - 只能更新字段标题和字段属性
-2. **field_title 和 property 至少传一个** - 且 field_title 不能被更新为原值
-3. **field_id 不能更新** - 仅用于标识要更新的字段
-4. **字段属性必须与字段类型匹配** - 与添加字段时相同
-
----
-
-### 5.12 查询字段
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_get_fields",
-  "description": "获取子表下字段信息（支持分页、按字段 ID 或字段标题筛选）",
-  "parameters": {
-    "docId": "必填：string，文档的 docid",
-    "sheetId": "必填：string，表格 ID",
-    "view_id": "可选：string，视图 ID",
-    "field_ids": "可选：string[]，由字段 ID 组成的 JSON 数组",
-    "field_titles": "可选：string[]，由字段标题组成的 JSON 数组",
-    "offset": "可选：integer，偏移量，初始值为 0",
-    "limit": "可选：integer，分页大小，每页返回多少条数据；当不填写该参数或将该参数设置为 0 时，如果总数大于 1000，一次性返回 1000 个字段，当总数小于 1000 时，返回全部字段；limit 最大值为 1000"
-  },
-  "returns": {
-    "errcode": "integer，错误码",
-    "errmsg": "string，错误码描述",
-    "total": "integer，字段总数",
-    "fields": "object[]，字段详情数组",
-    "fields[].field_id": "string，字段 ID",
-    "fields[].field_title": "string，字段标题",
-    "fields[].field_type": "string，字段类型",
-    "fields[].property_*": "可选：object，对应字段类型的属性"
-  }
-}
-```
-
-**使用示例** - 获取全部字段:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_get_fields",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "offset": 0,
-    "limit": 100
-  }
-}
-```
-
-**使用示例** - 按字段 ID 查询:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_get_fields",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "field_ids": ["f1gHSR", "fabcde"]
-  }
-}
-```
-
-**使用示例** - 按字段标题查询:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_get_fields",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "field_titles": ["姓名", "年龄"]
-  }
-}
-```
-
-### 5.13 添加编组
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_add_group",
-  "description": "添加字段编组",
-  "parameters": {
-    "docId": "文档 ID",
-    "sheetId": "子表 ID",
-    "name": "编组名称",
-    "children": ["可选：字段 ID 列表"]
-  }
-}
-```
-
-### 5.14 删除编组
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_del_group",
-  "description": "删除编组",
-  "parameters": {
-    "docId": "文档 ID",
-    "sheetId": "子表 ID",
-    "field_group_id": "编组 ID"
-  }
-}
-```
-
-### 5.15 更新编组
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_update_group",
-  "description": "更新编组",
-  "parameters": {
-    "docId": "文档 ID",
-    "sheetId": "子表 ID",
-    "field_group_id": "编组 ID",
-    "name": "可选：新编组名称",
-    "children": ["可选：字段 ID 列表"]
-  }
-}
-```
-
-### 5.16 获取编组
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_get_groups",
-  "description": "获取编组列表",
-  "parameters": {
-    "docId": "文档 ID",
-    "sheetId": "子表 ID"
-  }
-}
-```
-
-### 5.17 添加记录
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_add_records",
-  "description": "添加一行或多行记录（单表最多 100000 行记录，1500000 个单元格，单次建议 500 行内）",
-  "parameters": {
-    "docId": "必填：string，文档的 docid",
-    "sheetId": "必填：string，Smartsheet 子表 ID",
-    "key_type": "可选：string，values 的 key 类型，CELL_VALUE_KEY_TYPE_FIELD_TITLE(默认，用字段标题)|CELL_VALUE_KEY_TYPE_FIELD_ID(用字段 ID)",
-    "records": "必填：object[]，需要添加的记录数组",
-    "records[].values": "必填：object，记录的具体内容，key 为字段标题或字段 ID",
-    "records[].values.文本字段 (FIELD_TYPE_TEXT)": "可选：object[]，[{\"type\": \"text\", \"text\": \"内容\"}] 或 [{\"type\": \"url\", \"text\": \"文本\", \"link\": \"URL\"}]",
-    "records[].values.数字字段 (FIELD_TYPE_NUMBER)": "可选：number，直接写数字如 25 或 15000.50（不需要数组）",
-    "records[].values.日期字段 (FIELD_TYPE_DATE_TIME)": "可选：string，毫秒时间戳字符串如 \"1704067200000\"（不需要数组）",
-    "records[].values.多选字段 (FIELD_TYPE_SELECT)": "可选：object[]，[{\"text\": \"选项文本\", \"style\": 1}] 新增选项，或 [{\"id\": \"已有选项 ID\"}] 使用已有选项",
-    "records[].values.单选字段 (FIELD_TYPE_SINGLE_SELECT)": "可选：object[]，[{\"text\": \"选项文本\", \"style\": 1}] 新增选项，或 [{\"id\": \"已有选项 ID\"}] 使用已有选项",
-    "records[].values.成员字段 (FIELD_TYPE_USER)": "可选：object[]，[{\"user_id\": \"成员 userid\"}]",
-    "records[].values.复选框字段 (FIELD_TYPE_CHECKBOX)": "可选：boolean[]，[true] 或 [false]",
-    "records[].values.进度字段 (FIELD_TYPE_PROGRESS)": "可选：number，直接写数字如 0.5 表示 50%（不需要数组）",
-    "records[].values.电话字段 (FIELD_TYPE_PHONE_NUMBER)": "可选：string[]，[\"13800138000\"]",
-    "records[].values.邮箱字段 (FIELD_TYPE_EMAIL)": "可选：string[] 或 object[]，[\"test@example.com\"] 或 [{\"type\": \"url\", \"text\": \"test@example.com\", \"link\": \"mailto:test@example.com\"}]",
-    "records[].values.链接字段 (FIELD_TYPE_URL)": "可选：object[]，[{\"type\": \"url\", \"text\": \"显示文本\", \"link\": \"跳转 URL\"}]",
-    "records[].values.地理位置字段 (FIELD_TYPE_LOCATION)": "可选：object[]，[{\"id\": \"地点 ID\", \"latitude\": \"纬度\", \"longitude\": \"经度\", \"title\": \"地点名称\", \"source_type\": 1}]",
-    "records[].values.货币字段 (FIELD_TYPE_CURRENCY)": "可选：number，直接写数字如 100.50（不需要数组）",
-    "records[].values.百分数字段 (FIELD_TYPE_PERCENTAGE)": "可选：number，直接写数字如 0.75 表示 75%（不需要数组）",
-    "records[].values.条码字段 (FIELD_TYPE_BARCODE)": "可选：string[]，[\"6901234567890\"]"
-  },
-  "returns": {
-    "errcode": "integer，错误码",
-    "errmsg": "string，错误码描述",
-    "records": "object[]，添加成功的记录数组"
-  }
-}
-```
-
-**使用示例** - 添加文本和数字记录:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_add_records",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "key_type": "CELL_VALUE_KEY_TYPE_FIELD_TITLE",
-    "records": [
-      {
-        "values": {
-          "姓名": [{"type": "text", "text": "张三"}],
-          "年龄": 25,
-          "部门": [{"type": "text", "text": "技术部"}],
-          "入职日期": "1704067200000",
-          "是否全职": [true],
-          "工资": 15000.50
-        }
-      }
-    ]
-  }
-}
-```
-
-**⚠️ 关键格式说明（根据实际 API 测试）**:
-
-1. **字段值格式因类型而异**:
-   - ✅ 数字类型 (NUMBER, PROGRESS, CURRENCY, PERCENTAGE): 直接写数字 `25`、`0.75`、`100.50`
-   - ✅ 日期类型 (DATE_TIME): 直接写毫秒时间戳字符串 `"1704067200000"`
-   - ✅ 文本类型 (TEXT, URL): 数组格式 `[{"type": "text", "text": "内容"}]`
-   - ✅ 成员类型 (USER): 数组格式 `[{"user_id": "zhangsan"}]`
-   - ✅ 选项类型 (SELECT, SINGLE_SELECT): 数组格式 `[{"text": "选项", "style": 1}]` 或 `[{"id": "opt1"}]`
-   - ✅ 复选框 (CHECKBOX): 数组格式 `[true]` 或 `[false]`
-   - ✅ 电话/邮箱/条码：数组格式 `["13800138000"]`
-
-2. **文本类型必须带 type 字段**
-   - 普通文本：`[{"type": "text", "text": "内容"}]`
-   - 链接文本：`[{"type": "url", "text": "显示文本", "link": "跳转 URL"}]`
-
-3. **日期类型是毫秒时间戳字符串**
-   - ✅ 正确：`"1704067200000"`
-   - ❌ 错误：`1704067200000`（数字）、`"2024-01-01"`（日期字符串）
-
-4. **单选/多选字段使用 Option 对象**
-   - 新增选项：`[{"text": "选项文本", "style": 1}]`（不需要 id）
-   - 使用已有选项：`[{"id": "已有选项 ID"}]`（优先匹配已有选项）
-
-5. **values 的 key 必须与字段标题或字段 ID 完全匹配**
-   - 如果 `key_type` 为 `CELL_VALUE_KEY_TYPE_FIELD_TITLE`，使用字段标题
-   - 如果 `key_type` 为 `CELL_VALUE_KEY_TYPE_FIELD_ID`，使用字段 ID
-
-6. **严格验证，不自动转换**:
-   - ❌ 不会将普通字符串自动转换为 `[{"type": "text", "text": "..."}]`
-   - ❌ 不会将 13 位数字字符串误判为时间戳（必须是字符串格式）
-   - ✅ 数字和日期类型保持原样
-   - ✅ 对象格式自动包裹为数组：`{user_id: "..."}` → `[{user_id: "..."}]`
-   - ⚠️ 模糊的原始值（如普通字符串 `"张三"`）会被拒绝，必须明确使用数组格式
-
-**使用示例** - 添加多选和成员记录:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_add_records",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "records": [
-      {
-        "values": {
-          "姓名": [{"type": "text", "text": "王五"}],
-          "技能": [
-            {"text": "Java", "style": 1},
-            {"text": "Python", "style": 2}
-          ],
-          "负责人": [{"user_id": "zhangsan"}],
-          "进度": [0.75],
-          "邮箱": [{"type": "url", "text": "wangwu@example.com", "link": "mailto:wangwu@example.com"}]
-        }
-      }
-    ]
-  }
-}
-```
-
-**⚠️ 单选/多选字段格式说明**:
-
-1. **新增选项**（选项中不存在该值）:
-   ```json
-   [{"text": "新选项", "style": 1}]
-   ```
-   - 不需要填写 `id`
-   - 必须填写 `text` 和 `style`（颜色 1-27）
-
-2. **使用已有选项**（选项中已存在）:
-   ```json
-   [{"id": "已有选项 ID"}]
-   ```
-   - 只需要填写 `id`
-   - 系统会优先匹配已有选项
-
-3. **混合使用**:
-   ```json
-   [
-     {"id": "已有选项 ID"},
-     {"text": "新选项", "style": 1}
-   ]
-   ```
-
-**⚠️ 重要注意事项**:
-1. **字段值格式因类型而异** - 数字/日期类型直接写值（`25`、`"1704067200000"`），文本/成员/选项类型用数组（`[{"type": "text", "text": "内容"}]`）
-2. **文本类型必须带 type** - `[{"type": "text", "text": "内容"}]` 或 `[{"type": "url", "text": "文本", "link": "URL"}]`
-3. **不能添加记录的字段类型** - 创建时间、最后编辑时间、创建人、最后编辑人这四种类型的字段不能通过接口添加值（系统自动填充）
-4. **key_type 决定 values 的 key** - 使用字段标题或字段 ID 作为 key，默认使用字段标题
-5. **单次添加建议 500 行内** - 避免超时或失败
-6. **插件严格验证** - 拒绝模糊的原始值，必须使用正确的格式
-
-**字段类型与值类型对照表**:
-
-| 字段类型 | 值类型 | 示例值 |
-|----------|--------|--------|
-| 文本 (FIELD_TYPE_TEXT) | object[] | `[{"type": "text", "text": "内容"}]` |
-| 数字 (FIELD_TYPE_NUMBER) | number | `25` 或 `15000.50` |
-| 复选框 (FIELD_TYPE_CHECKBOX) | boolean[] | `[true]` 或 `[false]` |
-| 日期 (FIELD_TYPE_DATE_TIME) | string | `"1704067200000"` (毫秒时间戳) |
-| 成员 (FIELD_TYPE_USER) | object[] | `[{"user_id": "zhangsan"}]` |
-| 多选 (FIELD_TYPE_SELECT) | object[] | `[{"id": "opt1", "text": "选项", "style": 1}]` |
-| 单选 (FIELD_TYPE_SINGLE_SELECT) | object[] | `[{"id": "opt1", "text": "选项", "style": 1}]` |
-| 进度 (FIELD_TYPE_PROGRESS) | number | `0.75` (0-1 之间) |
-| 电话 (FIELD_TYPE_PHONE_NUMBER) | string[] | `["13800138000"]` |
-| 邮箱 (FIELD_TYPE_EMAIL) | string[] 或 object[] | `["test@example.com"]` 或 `[{"type": "url", "text": "test@example.com", "link": "mailto:test@example.com"}]` |
-| 链接 (FIELD_TYPE_URL) | object[] | `[{"type": "url", "text": "显示文本", "link": "https://..."}]` |
-| 货币 (FIELD_TYPE_CURRENCY) | number | `100.50` |
-| 百分数 (FIELD_TYPE_PERCENTAGE) | number | `0.75` (表示 75%) |
-| 条码 (FIELD_TYPE_BARCODE) | string[] | `["6901234567890"]` |
-| 地理位置 (FIELD_TYPE_LOCATION) | object[] | `[{"id": "地点 ID", "latitude": "23.10647", "longitude": "113.32446", "title": "广州塔", "source_type": 1}]` |
-
-### 5.18 更新记录
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_update_records",
-  "description": "更新一行或多行记录（不能更新创建时间、最后编辑时间、创建人、最后编辑人字段）",
-  "parameters": {
-    "docId": "必填：string，文档的 docid",
-    "sheetId": "必填：string，Smartsheet 子表 ID",
-    "key_type": "可选：string，请求中 values 的 key 类型，使用字段标题（默认）或字段 ID",
-    "records": "必填：object[]，需要更新的记录数组",
-    "records[].record_id": "必填：string，记录 ID",
-    "records[].values": "必填：object，记录的具体内容，格式与添加记录相同",
-    "记录格式参考添加记录": "数字/日期类型直接写值，文本/成员/选项类型用数组"
-  },
-  "returns": {
-    "errcode": "integer，错误码",
-    "errmsg": "string，错误码描述",
-    "records": "object[]，更新成功的记录数组"
-  }
-}
-```
-
-**使用示例**:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_update_records",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "records": [
-      {
-        "record_id": "re9IqD",
-        "values": {
-          "姓名": [{"type": "text", "text": "张三丰"}],
-          "年龄": 26,
-          "部门": [{"type": "text", "text": "技术部"}],
-          "工资": 16000.00,
-          "是否全职": [true]
-        }
-      },
-      {
-        "record_id": "rpS0P9",
-        "values": {
-          "姓名": [{"type": "text", "text": "李四光"}],
-          "年龄": 29,
-          "部门": [{"type": "text", "text": "产品部"}],
-          "工资": 19000.00
-        }
-      }
-    ]
-  }
-}
-```
-
-**⚠️ 重要注意事项**:
-1. **必须指定 record_id** - 用于标识要更新的记录
-2. **字段值格式与添加记录相同** - 数字/日期类型直接写值，文本/成员/选项类型用数组
-3. **不能更新的字段类型** - 创建时间、最后编辑时间、创建人、最后编辑人（系统自动更新）
-4. **只更新指定的字段** - 未指定的字段保持不变
-5. **文本类型必须带 type** - `[{"type": "text", "text": "内容"}]`
-
-### 5.19 删除记录
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_del_records",
-  "description": "删除一行或多行记录（单表最多 100000 行记录，单次删除建议 500 行内）",
-  "parameters": {
-    "docId": "必填：string，文档的 docid",
-    "sheetId": "必填：string，Smartsheet 子表 ID",
-    "record_ids": "必填：string[]，要删除的记录 ID 列表"
-  },
-  "returns": {
-    "errcode": "integer，错误码",
-    "errmsg": "string，错误码描述"
-  }
-}
-```
-
-**使用示例**:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_del_records",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "record_ids": ["re9IqD", "rpS0P9"]
-  }
-}
-```
-
-### 5.20 查询记录
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_get_records",
-  "description": "获取记录列表（支持筛选、排序、分页、按字段过滤）",
-  "parameters": {
-    "docId": "必填：string，文档的 docid",
-    "sheetId": "必填：string，Smartsheet 子表 ID",
-    "view_id": "可选：string，视图 ID",
-    "record_ids": "可选：string[]，指定记录 ID 列表",
-    "key_type": "可选：string，返回记录中单元格的 key 类型，CELL_VALUE_KEY_TYPE_FIELD_TITLE(默认)|CELL_VALUE_KEY_TYPE_FIELD_ID",
-    "field_titles": "可选：string[]，返回指定列（字段标题数组）",
-    "field_ids": "可选：string[]，返回指定列（字段 ID 数组）",
-    "sort": "可选：object[]，排序设置，[{field_id: "字段 ID", desc: false}]",
-    "offset": "可选：integer，偏移量，初始值为 0",
-    "limit": "可选：integer，分页大小，最大 1000",
-    "ver": "可选：integer，版本号",
-    "filter_spec": "可选：object，过滤设置，{conjunction: "CONJUNCTION_AND", conditions: [...]}"
-  },
-  "returns": {
-    "errcode": "integer，错误码",
-    "errmsg": "string，错误码描述",
-    "records": "object[]，记录数组",
-    "records[].record_id": "string，记录 ID",
-    "records[].values": "object，记录的具体内容，key 为字段标题或字段 ID，value 为数组（根据字段类型不同而不同）",
-    "total": "integer，记录总数",
-    "has_more": "boolean，是否还有更多",
-    "next": "integer，下次查询的偏移量",
-    "ver": "integer，版本号"
-  }
-}
-```
-
-**使用示例** - 查询全部记录:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_get_records",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "offset": 0,
-    "limit": 100
-  }
-}
-```
-
-**使用示例** - 按字段标题返回:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_get_records",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "key_type": "CELL_VALUE_KEY_TYPE_FIELD_TITLE",
-    "field_titles": ["姓名", "年龄", "部门"],
-    "limit": 50
-  }
-}
-```
-
-**使用示例** - 排序查询:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_get_records",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "sort": [
-      {"field_id": "f1gHSR", "desc": false}
-    ],
-    "limit": 100
-  }
-}
-```
-
-**使用示例** - 过滤查询:
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_get_records",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "filter_spec": {
-      "conjunction": "CONJUNCTION_AND",
-      "conditions": [
-        {
-          "field_id": "f1gHSR",
-          "field_type": "FIELD_TYPE_TEXT",
-          "operator": "OPERATOR_CONTAINS",
-          "string_value": {
-            "value": ["张三"]
-          }
-        }
-      ]
-    }
-  }
-}
-```
-
-**返回示例**:
-```json
-{
-  "errcode": 0,
-  "errmsg": "ok",
-  "total": 10,
-  "has_more": false,
-  "next": 10,
-  "ver": 5,
-  "records": [
-    {
-      "record_id": "re9IqD",
-      "values": {
-        "姓名": [{"type": "text", "text": "张三"}],
-        "年龄": 25,
-        "部门": [{"type": "text", "text": "技术部"}],
-        "入职日期": "1704067200000",
-        "是否全职": [true]
-      }
-    },
-    {
-      "record_id": "rpS0P9",
-      "values": {
-        "姓名": [{"type": "text", "text": "李四"}],
-        "年龄": 28,
-        "部门": [{"type": "text", "text": "产品部"}],
-        "入职日期": "1704153600000",
-        "是否全职": [true]
-      }
-    }
-  ]
-}
-```
-
-**注意**: 实际 API 返回的数据格式可能因字段类型而异，插件会自动规范化处理。
-
-**⚠️ 重要注意事项**:
-1. **字段值格式因类型而异** - 数字/日期类型是直接值，文本/成员/选项类型是数组
-2. **文本类型带 type 字段** - `[{"type": "text", "text": "内容"}]`
-3. **数字类型直接是数字** - `25`、`15000.50`（不是数组）
-4. **日期类型是毫秒时间戳字符串** - `"1704067200000"`（不是数组）
-5. **选项类型需要 id** - `[{"id": "opt1", "text": "选项", "style": 1}]`
-6. **成员类型需要 user_id** - `[{"user_id": "zhangsan"}]`
-
-**过滤操作符 (Operator)**:
-
-| 操作符 | 说明 |
-|--------|------|
-| OPERATOR_IS | 等于 |
-| OPERATOR_IS_NOT | 不等于 |
-| OPERATOR_CONTAINS | 包含 |
-| OPERATOR_DOES_NOT_CONTAIN | 不包含 |
-| OPERATOR_IS_GREATER | 大于 |
-| OPERATOR_IS_GREATER_OR_EQUAL | 大于或等于 |
-| OPERATOR_IS_LESS | 小于 |
-| OPERATOR_IS_LESS_OR_EQUAL | 小于或等于 |
-| OPERATOR_IS_EMPTY | 为空 |
-| OPERATOR_IS_NOT_EMPTY | 不为空 |
-
-**过滤条件 conjunction**:
-- `CONJUNCTION_AND` - 多个条件之间以 and 连接
-- `CONJUNCTION_OR` - 多个条件之间以 or 连接
-
-### 5.21 获取子表权限
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_get_sheet_priv",
-  "description": "获取智能表格子表权限规则",
-  "parameters": {
-    "docId": "文档 ID",
-    "type": "1(全员权限)|2(额外权限)",
-    "rule_id_list": "可选：规则 ID 列表"
-  }
-}
-```
-
-### 5.22 更新子表权限
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_update_sheet_priv",
-  "description": "更新子表权限规则",
-  "parameters": {
-    "docId": "文档 ID",
-    "type": "1(全员权限)|2(额外权限)",
-    "rule_id": "可选：规则 ID",
-    "name": "可选：规则名称",
-    "priv_list": "权限列表"
-  }
-}
-```
-
-### 5.23 创建权限规则
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_create_rule",
-  "description": "创建成员额外权限规则",
-  "parameters": {
-    "docId": "文档 ID",
-    "name": "规则名称"
-  },
-  "returns": {
-    "rule_id": "生成的规则 ID"
-  }
-}
-```
-
-### 5.24 修改规则成员
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_mod_rule_member",
-  "description": "修改权限规则的成员范围",
-  "parameters": {
-    "docId": "文档 ID",
-    "rule_id": "规则 ID",
-    "add_member_range": "可选：添加成员范围",
-    "del_member_range": "可选：删除成员范围"
-  }
-}
-```
-
-### 5.25 删除规则
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_delete_rule",
-  "description": "删除权限规则",
-  "parameters": {
-    "docId": "文档 ID",
-    "rule_id_list": ["规则 ID 列表"]
-  }
-}
-```
-
----
-
-## 六、收集表操作 (Form/Collect Operations)
-
-### 6.1 创建收集表
-```json
-{
-  "name": "wecom_doc",
-  "action": "create_form",
-  "description": "创建收集表（表单）",
-  "parameters": {
-    "formInfo": {
-      "form_title": "收集表标题（必填）",
-      "form_desc": "可选：收集表描述",
-      "form_header": "可选：背景图链接",
-      "form_question": {
-        "items": [
-          {
-            "question_id": 1,
-            "title": "问题标题",
-            "pos": 1,
-            "status": 1,
-            "reply_type": 1,
-            "must_reply": true,
-            "option_item": [{"key": 1, "value": "选项", "status": 1}]
-          }
-        ]
-      },
-      "form_setting": {
-        "fill_out_auth": 0,
-        "allow_multi_fill": false,
-        "can_anonymous": false
-      }
-    },
-    "spaceId": "可选：空间 ID",
-    "fatherId": "可选：父目录 fileid"
-  },
-  "returns": {
-    "formId": "收集表 ID",
-    "title": "收集表标题"
-  }
-}
-```
-
-### 6.2 编辑收集表
-```json
-{
-  "name": "wecom_doc",
-  "action": "modify_form",
-  "description": "编辑收集表（全量修改问题或设置）",
-  "parameters": {
-    "oper": "1(全量修改问题)|2(全量修改设置)",
-    "formId": "收集表 ID",
-    "formInfo": {
-      "form_title": "可选：新标题",
-      "form_question": { "items": [...] },
-      "form_setting": {...}
-    }
-  }
-}
-```
-
-### 6.3 获取收集表信息
-```json
-{
-  "name": "wecom_doc",
-  "action": "get_form_info",
-  "description": "获取收集表详细信息",
-  "parameters": {
-    "formId": "收集表 ID"
-  },
-  "returns": {
-    "form_info": {
-      "formid": "收集表 ID",
-      "form_title": "标题",
-      "form_question": { "items": [...] },
-      "form_setting": {...},
-      "repeated_id": ["周期 ID 列表"]
-    }
-  }
-}
-```
-
-### 6.4 获取收集表答案
-```json
-{
-  "name": "wecom_doc",
-  "action": "get_form_answer",
-  "description": "获取收集表提交的答案（最多 100 个）",
-  "parameters": {
-    "repeatedId": "收集表周期 ID",
-    "answerIds": "可选：答案 ID 列表（最多 100 个）"
-  },
-  "returns": {
-    "answer_list": [
-      {
-        "answer_id": 15,
-        "user_name": "张三",
-        "reply": {
-          "items": [
-            { "question_id": 1, "text_reply": "答案" }
-          ]
-        }
-      }
-    ]
-  }
-}
-```
-
-### 6.5 获取收集表统计
-```json
-{
-  "name": "wecom_doc",
-  "action": "get_form_statistic",
-  "description": "获取收集表统计信息",
-  "parameters": {
-    "requests": [
-      {
-        "repeated_id": "周期 ID",
-        "req_type": 1,
-        "start_time": 1667395287,
-        "end_time": 1668418369,
-        "limit": 20,
-        "cursor": 1
-      }
-    ]
-  },
-  "returns": {
-    "fill_cnt": 10,
-    "fill_user_cnt": 8,
-    "unfill_user_cnt": 5,
-    "submit_users": [...],
-    "unfill_users": [...]
-  }
-}
-```
-
----
-
-## 七、高级账号管理 (Advanced Account Management)
-
-### 7.1 分配高级功能账号
-```json
-{
-  "name": "wecom_doc",
-  "action": "doc_assign_advanced_account",
-  "description": "分配文档高级功能账号",
-  "parameters": {
-    "userid_list": ["成员 ID 列表"]
-  },
-  "returns": {
-    "jobid": "任务 ID"
-  }
-}
-```
-
-### 7.2 取消高级功能账号
-```json
-{
-  "name": "wecom_doc",
-  "action": "doc_cancel_advanced_account",
-  "description": "取消文档高级功能账号",
-  "parameters": {
-    "userid_list": ["成员 ID 列表"]
-  },
-  "returns": {
-    "jobid": "任务 ID"
-  }
-}
-```
-
-### 7.3 获取高级账号列表
-```json
-{
-  "name": "wecom_doc",
-  "action": "doc_get_advanced_account_list",
-  "description": "获取高级功能账号列表",
-  "parameters": {
-    "cursor": "可选：分页游标",
-    "limit": "可选：每页数量"
-  },
-  "returns": {
-    "user_list": [...],
-    "has_more": "是否还有更多"
-  }
-}
-```
-
----
-
-## 八、字段类型对照表 (Field Type Reference)
-
-### 智能表格字段类型 (FieldType)
-
-| 类型值 | 说明 | 对应 property |
-|--------|------|--------------|
-| FIELD_TYPE_TEXT | 文本 | - |
-| FIELD_TYPE_NUMBER | 数字 | property_number |
-| FIELD_TYPE_CHECKBOX | 复选框 | property_checkbox |
-| FIELD_TYPE_DATE_TIME | 日期 | property_date_time |
-| FIELD_TYPE_IMAGE | 图片 | - |
-| FIELD_TYPE_ATTACHMENT | 文件 | property_attachment |
-| FIELD_TYPE_USER | 成员 | property_user |
-| FIELD_TYPE_URL | 超链接 | property_url |
-| FIELD_TYPE_SELECT | 多选 | property_select |
-| FIELD_TYPE_SINGLE_SELECT | 单选 | property_single_select |
-| FIELD_TYPE_CREATED_USER | 创建人 | - |
-| FIELD_TYPE_MODIFIED_USER | 最后编辑人 | - |
-| FIELD_TYPE_CREATED_TIME | 创建时间 | property_created_time |
-| FIELD_TYPE_MODIFIED_TIME | 最后编辑时间 | property_modified_time |
-| FIELD_TYPE_PROGRESS | 进度 | property_progress |
-| FIELD_TYPE_PHONE_NUMBER | 电话 | - |
-| FIELD_TYPE_EMAIL | 邮件 | - |
-| FIELD_TYPE_REFERENCE | 关联 | property_reference |
-| FIELD_TYPE_LOCATION | 地理位置 | property_location |
-| FIELD_TYPE_CURRENCY | 货币 | property_currency |
-| FIELD_TYPE_WWGROUP | 群 | property_ww_group |
-| FIELD_TYPE_AUTONUMBER | 自动编号 | property_auto_number |
-| FIELD_TYPE_PERCENTAGE | 百分数 | property_percentage |
-| FIELD_TYPE_BARCODE | 条码 | property_barcode |
-
-### 收集表问题类型 (reply_type)
-
-| 类型值 | 说明 |
-|--------|------|
-| 1 | 文本 |
-| 2 | 单选 |
-| 3 | 多选 |
-| 5 | 位置 |
-| 9 | 图片 |
-| 10 | 文件 |
-| 11 | 日期 |
-| 14 | 时间 |
-| 15 | 下拉列表 |
-| 16 | 体温 |
-| 17 | 签名 |
-| 18 | 部门 |
-| 19 | 成员 |
-| 22 | 时长 |
-
----
-
-## 九、使用示例 (Usage Examples)
-
-### 示例 1：创建文档并添加协作者
-```json
-{
-  "name": "wecom_doc",
-  "action": "create",
-  "parameters": {
-    "docName": "项目计划",
-    "docType": "doc",
-    "collaborators": [{"userid": "zhangsan"}, {"userid": "lisi"}],
-    "init_content": [
-      {"type": "text", "content": "项目计划文档"},
-      {"type": "text", "content": "一、项目目标"},
-      {"type": "text", "content": "二、项目进度"}
-    ]
-  }
-}
-```
-
-### 示例 2：批量更新文档内容
-```json
-{
-  "name": "wecom_doc",
-  "action": "update_content",
-  "parameters": {
-    "docId": "DOCID123",
-    "requests": [
-      {"replace_text": {"text": "新标题", "ranges": [{"start_index": 0, "length": 5}]}},
-      {"insert_text": {"text": "新增段落", "location": {"index": 10}}},
-      {"insert_image": {"image_id": "https://...", "location": {"index": 20}}}
-    ]
-  }
-}
-```
-
-### 示例 3：智能表格添加记录
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_add_records",
-  "parameters": {
-    "docId": "DOCID456",
-    "sheetId": "SHEET789",
-    "records": [
-      {
-        "values": {
-          "姓名": [{"type": "text", "text": "张三"}],
-          "年龄": 25,
-          "部门": [{"type": "text", "text": "技术部"}]
-        }
-      }
-    ]
-  }
-}
-```
-
-### 示例 4：创建收集表
-```json
-{
-  "name": "wecom_doc",
-  "action": "create_form",
-  "parameters": {
-    "formInfo": {
-      "form_title": "员工满意度调查",
-      "form_question": {
-        "items": [
-          {
-            "question_id": 1,
-            "title": "您的部门",
-            "pos": 1,
-            "reply_type": 15,
-            "must_reply": true,
-            "option_item": [
-              {"key": 1, "value": "技术部"},
-              {"key": 2, "value": "产品部"},
-              {"key": 3, "value": "市场部"}
-            ]
-          },
-          {
-            "question_id": 2,
-            "title": "满意度评分",
-            "pos": 2,
-            "reply_type": 2,
-            "must_reply": true,
-            "option_item": [
-              {"key": 1, "value": "非常满意"},
-              {"key": 2, "value": "满意"},
-              {"key": 3, "value": "一般"},
-              {"key": 4, "value": "不满意"}
-            ]
-          }
-        ]
-      }
-    }
-  }
-}
-```
-
----
-
-## 九、智能表格完整使用流程 (Smart Table Complete Workflow)
-
-### 步骤 1：创建智能表格
-
-```json
-{
-  "name": "wecom_doc",
-  "action": "create",
-  "parameters": {
-    "docName": "员工信息表",
-    "docType": "smart_table"
-  }
-}
-```
-
-**返回**:
-```json
-{
-  "docId": "DOCID123",
-  "url": "https://doc.weixin.qq.com/smart_table/DOCID123",
-  "title": "员工信息表",
-  "resourceType": "10"
-}
-```
-
----
-
-### 步骤 2：添加自定义字段
-
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_add_fields",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "fields": [
-      {
-        "field_title": "姓名",
-        "field_type": "FIELD_TYPE_TEXT"
-      },
-      {
-        "field_title": "年龄",
-        "field_type": "FIELD_TYPE_NUMBER",
-        "property_number": {
-          "decimal_places": 0,
-          "use_separate": false
-        }
-      },
-      {
-        "field_title": "部门",
-        "field_type": "FIELD_TYPE_SELECT",
-        "property_select": {
-          "is_quick_add": true,
-          "options": [
-            {"text": "技术部", "style": 1},
-            {"text": "产品部", "style": 2},
-            {"text": "市场部", "style": 3}
-          ]
-        }
-      },
-      {
-        "field_title": "入职日期",
-        "field_type": "FIELD_TYPE_DATE_TIME",
-        "property_date_time": {
-          "format": "yyyy-mm-dd",
-          "auto_fill": false
-        }
-      },
-      {
-        "field_title": "工资",
-        "field_type": "FIELD_TYPE_NUMBER",
-        "property_number": {
-          "decimal_places": 2,
-          "use_separate": true
-        }
-      },
-      {
-        "field_title": "是否全职",
-        "field_type": "FIELD_TYPE_CHECKBOX",
-        "property_checkbox": {
-          "checked": true
-        }
-      }
-    ]
-  }
-}
-```
-
----
-
-### 步骤 3：添加记录
-
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_add_records",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "key_type": "CELL_VALUE_KEY_TYPE_FIELD_TITLE",
-    "records": [
-      {
-        "values": {
-          "姓名": [{"type": "text", "text": "张三"}],
-          "年龄": 25,
-          "部门": [{"text": "技术部", "style": 1}],
-          "入职日期": "1704067200000",
-          "工资": 15000.50,
-          "是否全职": [true]
-        }
-      }
-    ]
-  }
-}
-```
-
-**⚠️ 关键格式说明**:
-1. **数字/日期类型直接写值** - `25`、`"1704067200000"`、`15000.50`
-2. **文本类型必须带 type** - `[{"type": "text", "text": "张三"}]`
-3. **选项类型（单选/多选）**：
-   - 新增选项：`[{"text": "技术部", "style": 1}]`（不需要 id）
-   - 使用已有选项：`[{"id": "选项 ID"}]`
-4. **日期类型是毫秒时间戳字符串** - `"1704067200000"`（不是数组）
-5. **values 的 key 必须与字段标题完全匹配**（如果 `key_type` 为 `CELL_VALUE_KEY_TYPE_FIELD_TITLE`）
-
----
-
-### 步骤 4：查询记录
-
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_get_records",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "offset": 0,
-    "limit": 100
-  }
-}
-```
-
-**返回**:
-```json
-{
-  "errcode": 0,
-  "errmsg": "ok",
-  "total": 2,
-  "has_more": false,
-  "records": [
-    {
-      "record_id": "re9IqD",
-      "values": {
-        "姓名": [{"type": "text", "text": "张三"}],
-        "年龄": 25,
-        "部门": [{"id": "opt1", "text": "技术部", "style": 1}],
-        "入职日期": "1704067200000",
-        "工资": 15000.50,
-        "是否全职": [true]
-      }
-    },
-    {
-      "record_id": "rpS0P9",
-      "values": {
-        "姓名": [{"type": "text", "text": "李四"}],
-        "年龄": 28,
-        "部门": [{"id": "opt2", "text": "产品部", "style": 2}],
-        "入职日期": "1704153600000",
-        "工资": 18000.00,
-        "是否全职": [true]
-      }
-    }
-  ]
-}
-```
-
----
-
-### 步骤 5：更新记录
-
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_update_records",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "records": [
-      {
-        "record_id": "re9IqD",
-        "values": {
-          "姓名": [{"type": "text", "text": "张三丰"}],
-          "工资": 16000.00
-        }
-      }
-    ]
-  }
-}
-```
-
----
-
-### 步骤 6：删除记录
-
-```json
-{
-  "name": "wecom_doc",
-  "action": "smartsheet_del_records",
-  "parameters": {
-    "docId": "DOCID123",
-    "sheetId": "SHEET456",
-    "record_ids": ["rpS0P9"]
-  }
-}
-```
-
----
-
-## 十、注意事项 (Important Notes)
-
-### 1. 批量操作限制
-- **文档批量更新**：最多 30 个操作
-- **表格批量更新**：最多 5 个操作
-- **收集表答案查询**：最多 100 个答案 ID
-- **智能表格字段操作**：单次可添加/更新/删除多个字段
-- **智能表格记录操作**：单次添加/删除建议在 500 行内
-
-### 2. 版本控制
-- **更新文档内容时**：version 与最新版差值不能超过 100
-- **建议**：每次更新前获取最新文档内容
-
-### 3. 权限说明
-- **自建应用**：需配置到"可调用应用"列表
-- **第三方应用**：需具有"文档"权限
-- **代开发自建应用**：需具有"文档"权限
-- **只能操作**：该应用创建的文档
-
-### 4. 智能表格字段类型匹配
-- **添加/更新字段时**：field_type 必须与 property_* 属性匹配
-- **更新字段时**：不能修改字段类型
-- **一种字段类型对应一种字段属性**
-
-### 5. 智能表格记录格式（⚠️ 重要）
-
-#### 5.1 字段值格式因类型而异
-不同字段类型的值格式不同：
-- **数字/日期/货币/进度/百分数类型**：直接写值，不需要数组
-  - ✅ 正确：`25`、`"1704067200000"`、`15000.50`、`0.75`
-  - ❌ 错误：`[25]`、`["1704067200000"]`、`[15000.50]`、`[0.75]`
-- **文本/成员/选项/复选框/电话/邮箱/链接/条码/地理位置类型**：必须用数组
-  - ✅ 正确：`[{"type": "text", "text": "内容"}]`、`[{"user_id": "zhangsan"}]`、`[true]`
-  - ❌ 错误：`{"type": "text", "text": "内容"}`、`{"user_id": "zhangsan"}`、`true`
-
-#### 5.2 各类型字段值格式详解
-
-| 字段类型 | 值格式 | 示例 |
-|----------|--------|------|
-| 文本 (FIELD_TYPE_TEXT) | object[] | `[{"type": "text", "text": "张三"}]` |
-| 数字 (FIELD_TYPE_NUMBER) | number | `25`、`15000.50` |
-| 日期 (FIELD_TYPE_DATE_TIME) | string | `"1704067200000"`（毫秒时间戳） |
-| 复选框 (FIELD_TYPE_CHECKBOX) | boolean[] | `[true]`、`[false]` |
-| 多选 (FIELD_TYPE_SELECT) | object[] | 新增：`[{"text": "选项", "style": 1}]`，已有：`[{"id": "选项 ID"}]` |
-| 单选 (FIELD_TYPE_SINGLE_SELECT) | object[] | 新增：`[{"text": "选项", "style": 1}]`，已有：`[{"id": "选项 ID"}]` |
-| 成员 (FIELD_TYPE_USER) | object[] | `[{"user_id": "zhangsan"}]` |
-| 进度 (FIELD_TYPE_PROGRESS) | number | `0.75`（0-1 之间） |
-| 电话 (FIELD_TYPE_PHONE_NUMBER) | string[] | `["13800138000"]` |
-| 邮箱 (FIELD_TYPE_EMAIL) | string[] 或 object[] | `["test@example.com"]` 或 `[{"type": "url", "text": "test@example.com", "link": "mailto:test@example.com"}]` |
-| 链接 (FIELD_TYPE_URL) | object[] | `[{"type": "url", "text": "显示文本", "link": "https://..."}]` |
-| 货币 (FIELD_TYPE_CURRENCY) | number | `100.50` |
-| 百分数 (FIELD_TYPE_PERCENTAGE) | number | `0.75`（表示 75%） |
-| 条码 (FIELD_TYPE_BARCODE) | string[] | `["6901234567890"]` |
-| 地理位置 (FIELD_TYPE_LOCATION) | object[] | `[{"id": "地点 ID", "latitude": "23.10647", "longitude": "113.32446", "title": "广州塔", "source_type": 1}]` |
-
-#### 5.3 文本类型值的 type 字段
-- `text` - 普通文本内容
-- `url` - 链接文本（需要同时提供 `link` 字段）
-
-#### 5.4 选项类型（单选/多选）的填写规则
-- **新增选项**：`{"text": "选项内容", "style": 颜色编号 (1-27)}`
-- **使用已有选项**：`{"id": "已有选项 ID"}`
-- **系统会优先匹配已有选项**，如果匹配不到则新增选项
-
-#### 5.5 不能添加/更新的字段类型
-以下字段类型由系统自动填充，不能通过接口添加或更新：
-- 创建时间 (FIELD_TYPE_CREATED_TIME)
-- 最后编辑时间 (FIELD_TYPE_MODIFIED_TIME)
-- 创建人 (FIELD_TYPE_CREATED_USER)
-- 最后编辑人 (FIELD_TYPE_MODIFIED_USER)
-
-### 6. 智能表格限制
-- **单表最多 100000 行记录**
-- **单表最多 1500000 个单元格**
-- **单表最多 150 个字段**
-- **单表最多 200 个视图**
-- **单次添加/更新/删除记录建议在 500 行内**
-
-### 7. key_type 参数
-- **CELL_VALUE_KEY_TYPE_FIELD_TITLE**（默认）- 使用字段标题作为 values 的 key
-- **CELL_VALUE_KEY_TYPE_FIELD_ID** - 使用字段 ID 作为 values 的 key
-- **添加记录和查询记录时都要注意保持一致**
-
-### 8. 常见错误排查
-
-| 问题 | 原因 | 解决方案 |
-|------|------|----------|
-| 数据都填充到一列 | values 的 key 不是字段标题或字段 ID | 检查 key_type 设置，确保 key 与字段标题或字段 ID 完全匹配（包括空格和大小写） |
-| 多余的行 | records 数组格式错误 | 确保 records 是数组，每个记录是独立对象 `[{values: {...}}, {values: {...}}]` |
-| 无法添加自定义字段 | field_type 或 property 不匹配 | 检查字段类型与属性的对应关系，见字段类型对照表 |
-| 无法修改默认字段 | 尝试修改系统字段 | 创建时间、最后编辑时间、创建人、最后编辑人不能通过接口修改 |
-| 添加记录失败 | 值格式错误 | 数字/日期类型直接写值，文本/成员等类型用数组，插件会自动规范化 |
-| 日期字段错误 | 使用了秒级时间戳或日期字符串 | 使用毫秒级时间戳字符串 `"1704067200000"` 而不是 `1704067200000` 或 `"2024-01-01"` |
-| 选项字段错误 | 格式错误或缺少必要字段 | 新增选项：`[{"text": "选项", "style": 1}]`，使用已有：`[{"id": "选项 ID"}]` |
-| 单选字段添加失败 | 使用了错误的格式 | 单选和多选格式相同，都是 Option 对象数组 |
-| 文本字段添加失败 | 缺少 type 字段 | 文本类型必须是 `[{"type": "text", "text": "内容"}]` 格式 |
-| 链接字段添加失败 | 格式错误 | 链接类型必须是 `[{"type": "url", "text": "文本", "link": "URL"}]` 格式 |
-
----
-
-**文档版本**: 2026-03-18 v2  
-**适用版本**: OpenClaw WeChat Plugin v2.3.16+  
-**官方文档**: 企业微信开放平台 - 文档 API
-
----
-
-## 修正记录 (Revision History)
-
-### 2026-03-18 v2 - 智能表格记录格式修正
-
-#### 修复的问题：
-
-1. **选项字段格式错误** ❌ → ✅
-   - **问题**：单选/多选字段使用了错误的格式 `[{"id": "opt1", "text": "选项", "style": 1}]`
-   - **原因**：混淆了新增选项和使用已有选项的格式
-   - **修正**：
-     - 新增选项：`[{"text": "选项内容", "style": 颜色编号}]`（不需要 id）
-     - 使用已有选项：`[{"id": "已有选项 ID"}]`（只需要 id）
-   - **官方文档依据**：doc2.txt 第 1747-1757 行 Option 说明
-
-2. **日期字段格式说明不清晰** ❌ → ✅
-   - **问题**：没有强调必须是毫秒时间戳字符串
-   - **修正**：明确指出使用 `"1704067200000"` 格式（字符串），不是数字 `1704067200000`
-   - **官方文档依据**：doc2.txt 第 1679 行
-
-3. **添加完整的值格式对照表** ❌ → ✅
-   - **问题**：缺少 15 种字段类型的完整值格式说明
-   - **修正**：添加详细的表格，包含每种类型的正确格式和示例
-
-4. **常见错误排查不完善** ❌ → ✅
-   - **问题**：缺少单选字段、文本字段、链接字段等错误排查
-   - **修正**：添加 10 种常见错误及解决方案
-
-5. **使用示例优化** ❌ → ✅
-   - **问题**：示例中的选项字段格式不正确
-   - **修正**：更新所有示例，使用正确的选项格式
-
-#### 新增内容：
-
-1. **15 种字段类型的值格式对照表** - 包含所有支持的字段的值格式
-2. **文本类型 type 字段说明** - text 和 url 的区别
-3. **选项类型填写规则** - 新增选项 vs 使用已有选项
-4. **10 种常见错误排查** - 覆盖所有常见问题
-5. **完整使用流程示例** - 6 步完整示例，格式完全正确
-
-#### 关键修正点：
-
-| 字段类型 | 原格式（错误） | 新格式（正确） |
-|----------|---------------|---------------|
-| 单选/多选（新增） | `[{"id": "opt1", "text": "选项", "style": 1}]` | `[{"text": "选项", "style": 1}]` |
-| 单选/多选（已有） | `[{"text": "选项"}]` | `[{"id": "选项 ID"}]` |
-| 日期 | `[1704067200000]` 或 `["2024-01-01"]` | `"1704067200000"` |
-| 文本 | `{"type": "text", "text": "内容"}` | `[{"type": "text", "text": "内容"}]` |
-
----
-
-### 2026-03-19 v2 - 智能表格记录格式修正
-
-#### 修复的问题：
-
-1. **数字/日期类型值格式错误** ❌ → ✅
-   - **问题**：文档示例中数字和日期类型使用了数组格式
-   - **原因**：实际 API 测试表明数字和日期类型应该直接写值
-   - **修正**：明确字段值格式因类型而异
-     - 数字/货币/进度/百分数：直接写值 `25`、`15000.50`、`0.75`
-     - 日期：直接写毫秒时间戳字符串 `"1704067200000"`
-     - 文本/成员/选项/复选框等：使用数组 `[{"type": "text", "text": "内容"}]`、`[{"user_id": "xxx"}]`
-   - **插件自动规范化**：如果传入格式不正确，插件会自动转换
-
----
-
-### 2026-03-18 v1 - 初始重大修正
-
-#### 修复的问题：
-
-1. **添加记录数据格式错误** ❌ → ✅
-   - **问题**：数据格式不正确，导致所有数据填充到一列
-   - **原因**：没有明确说明不同字段类型的值格式差异
-   - **修正**：明确字段值格式因类型而异
-     - 文本：`[{"type": "text", "text": "内容"}]`
-     - 数字：`25`（直接值，不是数组）
-     - 日期：`"1704067200000"`（毫秒时间戳字符串，不是数组）
-     - 选项：`[{"id": "opt1", "text": "选项", "style": 1}]`
-
-2. **缺少字段类型与值类型对照表** ❌ → ✅
-   - **问题**：没有明确说明每种字段类型对应的值格式
-   - **修正**：添加完整的字段类型与值类型对照表
-   - **包含**：文本、数字、日期、多选、单选、成员、复选框、进度、电话、邮箱、链接、货币、百分数、条码、地理位置
-
-3. **添加字段属性不完整** ❌ → ✅
-   - **问题**：缺少各种字段类型的属性说明
-   - **修正**：添加所有 22 种字段类型的属性说明
-   - **包含**：property_number、property_checkbox、property_date_time 等
-
-4. **更新记录说明不清晰** ❌ → ✅
-   - **问题**：没有明确说明不能更新的字段类型
-   - **修正**：明确指出创建时间、最后编辑时间、创建人、最后编辑人不能更新
-
-5. **查询记录返回格式不明确** ❌ → ✅
-   - **问题**：没有说明返回的 values 格式
-   - **修正**：添加完整的返回示例，展示正确的 values 格式
-
-6. **缺少完整使用流程** ❌ → ✅
-   - **问题**：没有从创建到使用的完整示例
-   - **修正**：添加 6 步完整使用流程（创建→添加字段→添加记录→查询→更新→删除）
-
-7. **常见错误排查缺失** ❌ → ✅
-   - **问题**：遇到问题时无法快速定位
-   - **修正**：添加常见错误排查表格，包含问题、原因、解决方案
-
-#### 新增内容：
-
-1. **智能表格完整使用流程** - 6 步完整示例
-2. **字段类型与值类型对照表** - 15 种字段类型的值格式
-3. **字段类型与属性对照表** - 22 种字段类型的属性说明
-4. **过滤操作符对照表** - 10 种操作符说明
-5. **常见错误排查表** - 7 种常见问题及解决方案
-6. **key_type 参数说明** - 明确两种 key 类型的区别
-
-#### 优化内容：
-
-1. **参数说明标准化** - 所有参数都标注了必填/可选、类型、说明
-2. **使用示例丰富化** - 每个接口都有多个使用示例
-3. **注意事项分类化** - 按主题分类，便于查找
-4. **返回值完整化** - 所有接口都有完整的返回值说明