@yanhaidao/wecom 2.3.160 → 2.3.180

package/SKILLS_DOC.md

@@ -0,0 +1,2136 @@
+# 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",
+    "viewers": "可选：查看成员列表",
+    "collaborators": "可选：协作者列表",
+    "init_content": "可选：初始内容数组"
+  },
+  "returns": {
+    "docId": "文档 ID",
+    "url": "文档链接",
+    "title": "文档标题",
+    "resourceType": "资源类型"
+  }
+}
+```
+
+### 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"
+      }
+    ]
+  }
+}
+```
+
+### 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}"
+  },
+  "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 个字段** - 超过限制会失败
+
+**字段类型与属性对照表**:
+
+| 字段类型 | 字段属性 | 说明 |
+|----------|----------|------|
+| 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，返回记录中单元格的 key 类型，CELL_VALUE_KEY_TYPE_FIELD_TITLE(默认，用字段标题)|CELL_VALUE_KEY_TYPE_FIELD_ID(用字段 ID)",
+    "records": "必填：object[]，需要添加的记录数组，每个记录包含 values 对象",
+    "records[].values": "必填：object，记录的具体内容，key 为字段标题或字段 ID，value 为数组（根据字段类型不同而不同）",
+    "records[].values.文本字段": "可选：object[]，文本类型字段值，[{\"type\": \"text\", \"text\": \"内容\"}] 或 [{\"type\": \"url\", \"text\": \"显示文本\", \"link\": \"跳转 URL\"}]",
+    "records[].values.数字字段": "可选：number[]，数字类型字段值，如 [25]",
+    "records[].values.日期字段": "可选：string[]，日期类型字段值，毫秒级 Unix 时间戳字符串，如 [\"1747152000000\"]",
+    "records[].values.多选字段": "可选：object[]，多选类型字段值，[{\"id\": \"选项 ID\", \"text\": \"选项文本\", \"style\": 1}]",
+    "records[].values.单选字段": "可选：object[]，单选类型字段值，[{\"id\": \"选项 ID\", \"text\": \"选项文本\", \"style\": 1}]",
+    "records[].values.成员字段": "可选：object[]，成员类型字段值，[{\"user_id\": \"成员 userid\"}]",
+    "records[].values.复选框字段": "可选：boolean[]，复选框类型字段值，[true] 或 [false]",
+    "records[].values.进度字段": "可选：number[]，进度类型字段值，[0.5] 表示 50%",
+    "records[].values.电话字段": "可选：string[]，电话类型字段值，[\"13800138000\"]",
+    "records[].values.邮箱字段": "可选：string[]，邮箱类型字段值，[\"test@example.com\"]",
+    "records[].values.链接字段": "可选：object[]，链接类型字段值，[{\"type\": \"url\", \"text\": \"显示文本\", \"link\": \"跳转 URL\"}]",
+    "records[].values.地理位置字段": "可选：object[]，地理位置字段值，[{\"id\": \"地点 ID\", \"latitude\": \"纬度\", \"longitude\": \"经度\", \"title\": \"地点名称\", \"source_type\": 1}]",
+    "records[].values.货币字段": "可选：number[]，货币类型字段值，[100.50]",
+    "records[].values.百分数字段": "可选：number[]，百分数类型字段值，[0.75] 表示 75%",
+    "records[].values.条码字段": "可选：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]
+        }
+      },
+      {
+        "values": {
+          "姓名": [{"type": "text", "text": "李四"}],
+          "年龄": [28],
+          "部门": [{"type": "text", "text": "产品部"}],
+          "入职日期": ["1704153600000"],
+          "是否全职": [true],
+          "工资": [18000.00]
+        }
+      }
+    ]
+  }
+}
+```
+
+**使用示例** - 添加多选和成员记录:
+```json
+{
+  "name": "wecom_doc",
+  "action": "smartsheet_add_records",
+  "parameters": {
+    "docId": "DOCID123",
+    "sheetId": "SHEET456",
+    "records": [
+      {
+        "values": {
+          "姓名": [{"type": "text", "text": "王五"}],
+          "技能": [
+            {"id": "opt1", "text": "Java", "style": 1},
+            {"id": "opt2", "text": "Python", "style": 2}
+          ],
+          "负责人": [{"user_id": "zhangsan"}],
+          "进度": [0.75],
+          "邮箱": [{"type": "url", "text": "wangwu@example.com", "link": "mailto:wangwu@example.com"}]
+        }
+      }
+    ]
+  }
+}
+```
+
+**⚠️ 重要注意事项**:
+1. **所有字段值都必须是数组** - 即使是单个值也要用数组包裹，如 `[25]` 而不是 `25`
+2. **文本类型必须带 type** - `{"type": "text", "text": "内容"}` 或直接文本 `{"text": "内容"}`
+3. **不能添加记录的字段类型** - 创建时间、最后编辑时间、创建人、最后编辑人这四种类型的字段不能通过接口添加值（系统自动填充）
+4. **key_type 决定 values 的 key** - 使用字段标题或字段 ID 作为 key，默认使用字段标题
+5. **单次添加建议 500 行内** - 避免超时或失败
+
+**字段类型与值类型对照表**:
+
+| 字段类型 | 值类型 | 示例值 |
+|----------|--------|--------|
+| 文本 (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，返回记录中单元格的 key 类型，CELL_VALUE_KEY_TYPE_FIELD_TITLE(默认)|CELL_VALUE_KEY_TYPE_FIELD_ID",
+    "records": "必填：object[]，需要更新的记录数组",
+    "records[].record_id": "必填：string，记录 ID",
+    "records[].values": "必填：object，记录的具体内容，key 为字段标题或字段 ID，value 为数组（根据字段类型不同而不同）",
+    "records[].values.文本字段": "可选：object[]，文本类型字段值，[{\"type\": \"text\", \"text\": \"新内容\"}]",
+    "records[].values.数字字段": "可选：number[]，数字类型字段值，如 [26]",
+    "records[].values.日期字段": "可选：string[]，日期类型字段值，毫秒级 Unix 时间戳字符串",
+    "records[].values.多选字段": "可选：object[]，多选类型字段值",
+    "records[].values.单选字段": "可选：object[]，单选类型字段值",
+    "records[].values.成员字段": "可选：object[]，成员类型字段值",
+    "records[].values.复选框字段": "可选：boolean[]，复选框类型字段值",
+    "records[].values.进度字段": "可选：number[]，进度类型字段值",
+    "records[].values.电话字段": "可选：string[]",
+    "records[].values.邮箱字段": "可选：string[]",
+    "records[].values.链接字段": "可选：object[]",
+    "records[].values.地理位置字段": "可选：object[]",
+    "records[].values.货币字段": "可选：number[]",
+    "records[].values.百分数字段": "可选：number[]",
+    "records[].values.条码字段": "可选：string[]"
+  },
+  "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]
+      }
+    }
+  ]
+}
+```
+
+**⚠️ 重要注意事项**:
+1. **values 中的值都是数组** - 所有字段类型的值都是数组格式
+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",
+    "records": [
+      {
+        "values": {
+          "姓名": [{"type": "text", "text": "张三"}],
+          "年龄": [25],
+          "部门": [{"id": "opt1", "text": "技术部", "style": 1}],
+          "入职日期": ["1704067200000"],
+          "工资": [15000.50],
+          "是否全职": [true]
+        }
+      },
+      {
+        "values": {
+          "姓名": [{"type": "text", "text": "李四"}],
+          "年龄": [28],
+          "部门": [{"id": "opt2", "text": "产品部", "style": 2}],
+          "入职日期": ["1704153600000"],
+          "工资": [18000.00],
+          "是否全职": [true]
+        }
+      }
+    ]
+  }
+}
+```
+
+**⚠️ 关键格式说明**:
+- **所有字段值都是数组** - `[25]` 而不是 `25`
+- **文本类型必须带 type** - `[{"type": "text", "text": "张三"}]`
+- **选项类型需要 id** - `[{"id": "opt1", "text": "技术部", "style": 1}]`
+- **日期类型是毫秒时间戳** - `["1704067200000"]`
+
+---
+
+### 步骤 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. 智能表格记录格式（⚠️ 重要）
+- **所有字段值都必须是数组** - 即使是单个值也要用数组包裹
+  - ✅ 正确：`[25]`、`[{"type": "text", "text": "内容"}]`
+  - ❌ 错误：`25`、`{"type": "text", "text": "内容"}`
+- **文本类型必须带 type 字段** - `{"type": "text", "text": "内容"}` 或 `{"type": "url", "text": "文本", "link": "URL"}`
+- **数字类型直接是数字** - `[25]`、`[15000.50]`
+- **日期类型是毫秒时间戳字符串** - `["1704067200000"]`
+- **选项类型需要 id** - `[{"id": "opt1", "text": "选项", "style": 1}]`
+- **成员类型需要 user_id** - `[{"user_id": "zhangsan"}]`
+- **不能添加/更新的字段类型**：创建时间、最后编辑时间、创建人、最后编辑人（系统自动填充）
+
+### 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 是数组，每个记录是独立对象 |
+| 无法添加自定义字段 | field_type 或 property 不匹配 | 检查字段类型与属性的对应关系 |
+| 无法修改默认字段 | 尝试修改系统字段 | 创建时间、最后编辑时间、创建人、最后编辑人不能修改 |
+| 添加记录失败 | 值格式不是数组 | 确保所有字段值都是数组格式 |
+| 日期字段错误 | 使用了秒级时间戳 | 使用毫秒级时间戳字符串，如 "1704067200000" |
+| 选项字段错误 | 缺少 id 或格式错误 | 使用 `[{"id": "选项 ID", "text": "选项文本", "style": 1}]` 格式 |
+
+---
+
+**文档版本**: 2026-03-18  
+**适用版本**: OpenClaw WeChat Plugin v2.3.16+  
+**官方文档**: 企业微信开放平台 - 文档 API
+
+---
+
+## 修正记录 (Revision History)
+
+### 2026-03-18 重大修正
+
+#### 修复的问题：
+
+1. **添加记录数据格式错误** ❌ → ✅
+   - **问题**：数据格式不正确，导致所有数据填充到一列
+   - **原因**：values 的值应该是数组，但可能使用了直接值
+   - **修正**：明确所有字段值都必须是数组格式
+     - 文本：`[{"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. **返回值完整化** - 所有接口都有完整的返回值说明