wecom-smartsheet-datalisted

# 企业微信智能表格数据管理 > `wecom_mcp` 是一个 MCP tool，所有操作通过调用该 tool 完成。 > ⚠️ **前置条件**：首次调用 `wecom_mcp` 前，必须按 `wecom-preflight` 技能执行前置条件检查，确保工具已加入白名单。 管理智能表格中的记录（行数据）。所有接口支持通过 `docid` 或 `url` 二选一定位文档。 ## CLI 调用方式 通过 `wecom_mcp` tool 调用，品类为 `doc`： 使用 `wecom_mcp` tool 调用 `wecom_mcp call doc <tool_name> '<json_params>'` 调用指定技能 ## 返回格式��明 所有接口返回 JSON 对象，包含以下公共字段： | 字段 | 类型 | 说明 | |------|------|------| | `errcode` | integer | 返回码，`0` 表示成功，非 `0` 表示失败 | | `errmsg` | string | 错误信息，成功时为 `"ok"` | 当 `errcode` 不为 `0` 时，说明接口调用失败，可重试 1 次；若仍失败，将 `errcode` 和 `errmsg` 展示给用户。 ### smartsheet_get_records 查询子表全部记录。 - 使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartsheet_get_records '{"docid": "DOCID", "sheet_id": "SHEETID"}'` - 或通过 URL：使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartsheet_get_records '{"url": "https://doc.weixin.qq.com/smartsheet/xxx", "sheet_id": "SHEETID"}'` 参见 [API 详情](references/api-get-records.md)。 ### smartsheet_add_records 添加一行或多行记录，单次建议 500 行内。 **调用前**必须先了解目标表的字段类型（通过 `smartsheet_get_fields`）。 使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartsheet_add_records '{"docid": "DOCID", "sheet_id": "SHEETID", "records": [{"values": {"任务名称": [{"type": "text", "text": "完成需求文档"}], "优先级": [{"text": "高"}]}}]}'` 各字段类型的值格式参见 [单元格值格式参考](references/cell-value-formats.md)。 ### smartsheet_update_records 更新一行或多行记录，单次必须在 500 行内。需提供 record_id（通过 `smartsheet_get_records` 获取）。 使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartsheet_update_records '{"docid": "DOCID", "sheet_id": "SHEETID"