这是钉钉工作区 CLI 的电子表格 Skill,属于试验版(EXPERIMENTAL / Preview),multi 模式尚未达到 stable 标准,生产或共享环境建议优先使用 mono 模式(dws skill setup --mode mono)。使用前须先阅读 dws-shared skill 了解认证、全局参数、产品路由、URL 预检、错误码与安全规则,并确保 dws 二进制在 PATH 中。
用途与能力:用于操作钉钉在线电子表格,支持创建电子表格、导入本地 Excel(xlsx/xls)为在线表格、新建工作表、读取与写入单元格、追加行、查找与替换、创建和查看透视表、显示/隐藏网格线、插入图片到单元格,以及结构化读写(table-get / table-put)。命令前缀为 dws sheet,常用 shortcut 有 dws sheet +list-sheets、dws sheet +read。
使用要点:含 alidocs.dingtalk.com URL 时须先读 url-patterns.md 做分流,仅当确认为在线电子表格(/spreadsheetv2/... 或 probe 出 contentType=ALIDOC + extension=axls)才走本 skill;spreadsheetv2 链接须原样完整传给 --node。写入前先用 dws sheet list --node <nodeId或URL> --format json 取得真实 sheetId,不要猜测 Sheet1 或 0;写入后立即读同一区域验证。range update 的 --values 必须是二维 JSON,行列数量与 --range 完全一致。可用 dws sheet <shortcut> --help 或 --dry-run 核对当前版本参数。
限制:命令可用性以当前 dws 二进制为准,服务发现已下线;若 dws <cmd> --help 不存在说明该版本未暴露该命令。调试时同一参数错误最多纠正 2 次,若 nodeId 格式持续不合法,应回到 doc info --node <URL> 或 create 返回重新获取。多维表/字段类型场景应切换到 dingtalk-aitable,把表数据写进文档应切换到 dingtalk-doc。