用途:管理企业微信智能表格的结构与数据,所有操作通过 wecom_mcp 工具调用,品类名为 doc,调用形式为 wecom_mcp call doc <tool_name> '<json_params>'。首次调用前必须按 wecom-preflight 技能完成前置条件检查,确保工具已加入白名单。文档定位支持 docid 或 url 二选一。
主要能力: 结构管理:smartsheet_get_sheet 查询所有子表;smartsheet_add_sheet 添加空子表(新建文档默认已含一个子表);smartsheet_update_sheet 修改子表标题;smartsheet_delete_sheet 永久删除子表;smartsheet_get_fields 查询字段;smartsheet_add_fields 添加字段(单表最多 150 个);smartsheet_update_fields 仅可改字段标题,field_type 须传原始类型;smartsheet_delete_fields 删除列,不可逆。 数据管理:smartsheet_get_records 查询记录;smartsheet_add_records 添加记录(单次建议 500 行内);smartsheet_update_records 更新记录,需 record_id,可用 key_type 指定 values 的 key 为字段标题或字段 ID,创建时间、最后编辑时间、创建人、最后编辑人字段不可更新;smartsheet_delete_records 删除记录(单次 500 行内,不可逆)。
返回值:JSON 对象含 errcode 与 errmsg,errcode 为 0 表示成功;失败可重试 1 次,仍失败则将 errcode 和 errmsg 展示给用户。
限制与注意:写入或更新前须先用 smartsheet_get_fields 了解字段类型并参考单元格值格式。成员(USER)字段需填 user_id,不能直接用姓名,须先经 wecom-contact 的 get_userlist 按姓名查 userid。图片/文件字段必须且只能直接在 cell value 中传本地路径(image_path / file_path),严禁调用任何上传接口或 base64 编码;若报错则直接告知用户错误码与信息。若返回 errcode 851003 或 errmsg 含 no authority(通常是企业可见范围超过 10 人的规模限制),切换 Webhook 兜底方案,详见 webhook-fallback.md;Webhook 只能更新通过 Webhook 写入的记录。具体字段类型、单元格值格式与 API 详情参见对应参考文档。