القائمة
钉钉电子表格。Use when 用户说 电子表格/导入Excel为在线表格/工作表/单元格读写/单元格追加/查找/公式/超链接/插入图片/浮动图片/sheet。Distinct from dingtalk-aitable(AI表格/多维表/字段类型)、dingtalk-doc(普通文档)。命令前缀：dws sheet。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | dingtalk-sheet |
| description | 钉钉电子表格。Use when 用户说 电子表格/导入Excel为在线表格/工作表/单元格读写/单元格追加/查找/公式/超链接/插入图片/浮动图片/sheet。Distinct from dingtalk-aitable(AI表格/多维表/字段类型)、dingtalk-doc(普通文档)。命令前缀：dws sheet。 |
| cli_version | >=0.2.14 |
| metadata | {"category":"product","stability":"experimental","requires":{"bins":["dws"]}} |
🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准。全部 dingtalk-* skill 已通过 dispatch verifier，但接口、命名、跨 skill 引用后续可能调整；生产 / 共享环境请优先使用 mono 模式（
dws skill setup --mode mono）。问题请提 issue 反馈。
PREREQUISITE: Read the
dws-sharedskill first for auth, global flags, product routing, URL preflight, error codes, and safety rules. Thedwsbinary must be on PATH.
⚠️ 命令可用性以当前 dws 二进制为准。服务发现已下线，本文档随内置 skill 发布；如果
dws <cmd> --help不存在，说明当前版本未暴露该命令。若命令存在但调用失败，请按错误中的 endpoint 或 tool 提示确认静态端点目录和后端工具注册。实际调用前可用dws <cmd> --help或--dry-run验证。
命令参考：sheet.md；URL 识别与类型探测：url-patterns.md。
输入含 alidocs.dingtalk.com URL 时，该域名下存在多种路径格式：/i/p/...（分享短链）、/i/nodes/...（节点链接，类型需探测）、/spreadsheetv2/...（电子表格直链，直接路由到 sheet）、/document/edit|preview?dentryKey=...（文档链接，路由到 dingtalk-doc）等。必须先读 url-patterns.md 中的「alidocs URL 分流决策」，按规则识别 URL 类型；仅当确认是在线电子表格（/spreadsheetv2/... 或 i/nodes/ 且 probe 出 contentType=ALIDOC + extension=axls）时，才继续走本 skill 的命令。
以下 shortcut 来自独立于 Runtime Schema 的公开 catalog。先按本 skill 的意图表、脚本和 recipe 路由：存在精确覆盖该场景的专用脚本/recipe 时按其执行；否则用户意图命中时，shortcut 优先于手写原子命令。用 dws shortcut list --service sheet --format json 读取参数、约束、风险和示例，并以 dws sheet <shortcut> --help 核对当前 Cobra flags；不要对 + 路径调用 dws schema。
| Shortcut | 风险 | 适用场景 |
|---|---|---|
dws sheet +list-sheets | read | 获取表格文档中全部工作表列表 |
dws sheet +read | read | 读取工作表指定范围的结构化单元格数据 |
| 用户说 | 命令 |
|---|---|
| "创建电子表格" | dws sheet create --name "<标题>" |
| "导入本地 Excel 为在线表格" | dws sheet import create --file <xlsx或xls> --folder-token <ID> 或 --workspace <ID> |
| "新建工作表" | dws sheet new --node <nodeId或URL> --name "<sheet名>" |
| "读取单元格" | dws sheet range read --node <nodeId或URL> --sheet-id <sheetId> --range A1:B2 |
| "写入单元格" | dws sheet range update --node <nodeId或URL> --sheet-id <sheetId> --range A1:B2 --values '[[..]]' |
| "结构化读取 / DataFrame 读取" | dws sheet table-get --node <nodeId或URL> [--sheet-id <sheetId>] |
| "结构化写入 / DataFrame 写入" | dws sheet table-put --node <nodeId或URL> --sheets '<JSON>' |
| "创建透视表 / 数据透视" | dws sheet pivot-table create --node <nodeId或URL> --source "'Sheet1'!A1:D100" --properties '<JSON>' |
| "查看透视表" | dws sheet pivot-table list --node <nodeId或URL> --sheet-id <sheetId> |
| "显示 / 隐藏网格线" | `dws sheet show-gridline |
| "追加一行" | dws sheet append --node <nodeId或URL> --sheet-id <sheetId> --values '[[..]]' |
| "查找 / 替换" | dws sheet find --node <nodeId或URL> --sheet-id <sheetId> --find "<关键词>" / dws sheet replace --node <nodeId或URL> --sheet-id <sheetId> --find "<旧值>" --replacement "<新值>" |
| "插入图片到单元格" | dws sheet write-image --node <nodeId或URL> --sheet-id <sheetId> --range A1:A1 --file <本地图片路径>（CLI 自动上传本地图片并写入单元格；没有 --resource-id/--resource-url 这两个 flag） |
alidocs.dingtalk.com URL 时，先执行 dws doc info --node "<URL>" --format json 探测；只有 contentType=ALIDOC 且 extension=axls 才继续走 sheet。spreadsheetv2 链接不要截取短 path segment，必须把完整 URL 原样传给 --node。dws sheet list --node <nodeId或URL> --format json 取得真实 sheetId；不要猜 Sheet1、sheet1、0。--node 参数；不要写 --node-id、--file-id 或把 JSON 字段名 id 当成节点值传入。sheet create 后必须从返回结果提取真实 nodeId 或文档 URL，后续 range update/read 原样传给 --node；如果返回里同时有 nodeId 和 url，优先用 nodeId。sheet list --node <nodeId> --format json 获取真实 sheetId；写入后立即 range read 同一区域验证。range update 的 --values 必须是二维 JSON，行列数量与 --range 完全一致；批量样式用 range batch-set-style --batch <json文件>。nodeId 格式不合法，回到 doc info --node <URL> 或 sheet create 返回重新取 ID，不要无意义重试。dingtalk-aitabledingtalk-doc管理钉钉产品能力(AI表格/AI搜问/日历/通讯录/群聊与机器人/待办/审批/考勤/日志/DING消息/开放平台文档/钉钉文档/钉钉云盘/AI听记/邮箱/在线电子表格/知识库等)。当用户需要操作表格数据、管理日程会议、模糊找人/查谁负责某事项、查询通讯录、管理群聊、机器人发消息、创建待办、提交审批、查看考勤、提交日报周报（钉钉日志模版）、读写钉钉文档、上传下载云盘文件、查询听记纪要、收发邮件、读写在线电子表格(axls)、管理钉钉知识库时使用。
钉钉个人 IM 事件长连接监听、订阅与消费，覆盖消息接收、指定发送人、已读、撤回和表情回应，输出 NDJSON 到 stdout。Use when 用户提到 监听个人消息事件、被@消息、监听单聊或群消息、监听某人发送的消息、监听消息已读、监听消息撤回、监听消息贴表情或表情回应、实时接收钉钉事件、用事件驱动 Agent。命令前缀：dws event。
钉钉多组织 / profile 管理与跨组织取数。Use when 用户说 切换组织/换组织/跨组织/另一个钉钉/别的公司/多组织/看登录了哪些组织/profile，或在当前组织找不到群/人/数据需要去其他组织找。命令前缀：dws profile / dws auth / 全局 --profile。
dws 多 skill 模式的公共参考——认证、全局参数、Schema 命令发现、多组织 / --profile 规则、安全底线。所有 dingtalk-* 子 skill 执行前先读本 skill。命令前缀：dws。
钉钉通讯录查询与组织管理（用户、部门、角色、花名册、离职员工、创建企业、企业账号、邀请员工）。Use when 用户说 查部门/我的信息/按 userId 查/离职员工/创建企业/企业账号/邀请员工。Distinct from dingtalk-aisearch(模糊搜人首选：找同事/查上下级/谁负责)。命令前缀：dws contact。
钉钉开放平台企业内部应用管理：应用查询/创建/修改/删除/停启、凭证、权限点、成员、安全配置、网页应用、机器人、版本发布。Use when 用户说 开发者后台应用/开放平台应用/企业内部应用/agentId/clientId/appKey/appSecret/customKey/应用权限/权限点/scopeValue/创建机器人/智能体机器人/机器人配置/机器人回调/IP白名单/登录重定向/端内免登/应用版本/版本发布/发布审核/选审批人/把机器人接到本地调试/connect。