dsh-crwu-workbench 0.0.10

package/skills/dws/dingtalk-misc/references/sheet/sheet-comment.md

@@ -0,0 +1,166 @@
+# sheet comment（表格单元格评论：list / create / reply / update / delete）
+
+> **前置条件（MUST READ）：** 执行本命令前，必须先用 Read 工具读取以下文件：
+> 1. [`../sheet.md`](../sheet.md) — 命令路由 + 场景索引 + 意图判断 + 全局约束
+>
+> **同任务常配合**：`dws aisearch person`（查 `--mention` 用 userId）/ [`sheet-workbook.md`](sheet-workbook.md)（未知工作表名称时先 `list` 确认真实名称）
+
+---
+
+## 适用范围
+
+- 仅支持钉钉在线电子表格（`extension=axls`）。`xlsx` / `xls` / `csv` 等本地表格不支持评论。
+- 评论锚定在**单元格位置**：`create` / `list` 通过 `--sheet-id`（工作表 ID 或名称）+ `--range`（单元格坐标）定位；`reply` / `update` / `delete` 通过 `--comment-key` 操作，不依赖单元格位置。
+- `create` / `list` 通过单元格位置定位；`reply` / `update` / `delete` 通过前一步返回的 `commentKey` 定位评论线程，不需要重新传单元格位置。
+- Agent 只使用命令返回的 `commentKey` 继续回复、更新或删除，不自行构造评论标识。
+
+---
+
+## sheet comment list（查询表格评论列表）
+
+```
+Usage:
+  dws sheet comment list [flags]
+Example:
+  dws sheet comment list --node <SHEET_ID>
+  dws sheet comment list --node <SHEET_ID> --sheet-id Sheet1 --range A2
+  dws sheet comment list --node <SHEET_ID> --resolve-status unresolved
+  dws sheet comment list --node <SHEET_ID> --cursor <TOKEN>
+Flags:
+      --node string            目标表格的标识，支持传入 URL 或 ID (必填)
+      --limit int              每页返回的评论数量，默认 50，最大 50
+      --cursor string          分页游标，从上一次请求的返回结果中获取 (首次请求不传)
+      --resolve-status string  按解决状态过滤: resolved (已解决) / unresolved (未解决)
+      --sheet-id string        工作表 ID 或名称，如 Sheet1（与 --range 一起指定时按单元格过滤）
+      --range string           单元格位置，A1 表示法，如 A2、B5:C10（与 --sheet-id 一起指定时按单元格过滤）
+```
+
+- 同时传入 `--sheet-id` 和 `--range` 时，仅返回该单元格的评论（服务端按单元格精确过滤）；不传则返回表格全部单元格评论。
+
+---
+
+## sheet comment create（创建单元格评论）
+
+```
+Usage:
+  dws sheet comment create [flags]
+Example:
+  dws sheet comment create --node <SHEET_ID> --sheet-id Sheet1 --range A2 --content "这个数字有问题"
+  dws sheet comment create --node <SHEET_ID> --sheet-id Sheet1 --range A2 --content "请核实" --mention uid1,uid2
+Flags:
+      --node string      目标表格的标识，支持传入 URL 或 ID (必填)
+      --sheet-id string  工作表 ID 或名称，如 Sheet1 (必填)
+      --range string     单元格位置，A1 表示法，仅支持单个单元格，如 A2 (必填)
+      --content string   评论的文字内容，纯文本 (必填)
+      --mention string   被 @ 的用户 uid 列表，逗号分隔
+```
+
+- 未知工作表名称时，先 `dws sheet list --node <SHEET_ID> --format json` 确认真实名称，禁止臆测 `Sheet1` / `0` / `default`。
+
+---
+
+## sheet comment reply（回复评论）
+
+```
+Usage:
+  dws sheet comment reply [flags]
+Example:
+  dws sheet comment reply --node <SHEET_ID> --comment-key <COMMENT_KEY> --content "已核实"
+  dws sheet comment reply --node <SHEET_ID> --comment-key <COMMENT_KEY> --content "比心" --emoji
+  dws sheet comment reply --node <SHEET_ID> --comment-key <COMMENT_KEY> --content "请确认" --mention uid1,uid2
+Flags:
+      --node string         目标表格的标识，支持传入 URL 或 ID (必填)
+      --content string      回复的文字内容，表情回复时填写表情名称 (必填)
+      --comment-key string  被回复评论的 commentKey，格式: {13位毫秒时间戳}{32位UUID}，可从 list/create 结果获取 (必填)
+      --emoji               设为 true 时作为表情贴图回复 (默认 false)
+      --mention string      被 @ 的用户 uid 列表，逗号分隔
+```
+
+- 回复自动归属到被回复评论所在的单元格线程，无需再传 `--sheet-id` / `--range`。
+
+---
+
+## sheet comment update（更新评论）
+
+```
+Usage:
+  dws sheet comment update [flags]
+Example:
+  dws sheet comment update --node <SHEET_ID> --comment-key <COMMENT_KEY> --content "已按最新数据修正"
+Flags:
+      --node string         目标表格的标识，支持传入 URL 或 ID (必填)
+      --comment-key string  待更新评论的 commentKey，格式: {13位毫秒时间戳}{32位UUID}，可从 list/create 结果获取 (必填)
+      --content string      更新后的评论文字内容，纯文本 (必填)
+```
+
+---
+
+## sheet comment delete（删除评论）
+
+> [强制] 危险操作：删除不可恢复。必须先向用户展示操作摘要并获得明确同意，用户同意后才加 `--yes` 执行。
+
+```
+Usage:
+  dws sheet comment delete [flags]
+Example:
+  dws sheet comment delete --node <SHEET_ID> --comment-key <COMMENT_KEY> --yes
+Flags:
+      --node string         目标表格的标识，支持传入 URL 或 ID (必填)
+      --comment-key string  待删除评论的 commentKey，格式: {13位毫秒时间戳}{32位UUID}，可从 list/create 结果获取 (必填)
+```
+
+## 关键说明
+
+- `--mention` 接受 `userId` 列表（逗号分隔），需要先用 `dws aisearch person --query "<姓名>" --dimension name` 拿到 userId。
+- `--comment-key` 是 13 位毫秒时间戳 + 32 位 UUID 的拼接字符串，从 `list` / `create` 返回中提取，用于 `reply` / `update` / `delete`。
+- `create` / `list`（按单元格过滤）的 `--sheet-id` 是工作表 ID 或名称；未知时先 `dws sheet list` 确认，禁止臆测。
+- `reply` 加 `--emoji` 时 `--content` 填表情名称（如 `比心`、`赞`），不是文字内容。
+- `delete` 是不可逆操作；AI Agent 必须先向用户展示操作摘要并获得明确同意，同意后才追加 `--yes`。
+
+## 上下文传递
+
+| 从返回中提取 | 用于 |
+|-------------|------|
+| `commentList[].commentKey` | `comment reply/update/delete` 的 `--comment-key` |
+| `comment create` 的 `commentKey` | `comment reply/update/delete` 的 `--comment-key` |
+| [`sheet-workbook.md`](sheet-workbook.md) `sheet list` 的工作表名称 | `comment create/list` 的 `--sheet-id` |
+| `dws aisearch person` 的 `userId` | `comment create/reply` 的 `--mention` |
+
+## 常用模板
+
+```bash
+# 查看表格全部单元格评论
+dws sheet comment list --node <SHEET_ID> --format json
+
+# 仅看某个单元格的评论
+dws sheet comment list --node <SHEET_ID> --sheet-id Sheet1 --range A2 --format json
+
+# 仅看未解决的评论
+dws sheet comment list --node <SHEET_ID> --resolve-status unresolved --format json
+
+# 在单元格上创建评论（未知工作表名先 sheet list 确认）
+dws sheet list --node <SHEET_ID> --format json
+dws sheet comment create --node <SHEET_ID> --sheet-id Sheet1 --range A2 --content "这个数字有问题" --format json
+
+# 创建评论 + @人（先 aisearch person 拿 userId）
+dws aisearch person --query "张三" --dimension name --format json
+dws sheet comment create --node <SHEET_ID> --sheet-id Sheet1 --range A2 --content "请确认" --mention <uid1>,<uid2> --format json
+
+# 文字回复
+dws sheet comment reply --node <SHEET_ID> --comment-key <COMMENT_KEY> --content "已核实" --format json
+
+# 表情回复（--content 填表情名称）
+dws sheet comment reply --node <SHEET_ID> --comment-key <COMMENT_KEY> --content "比心" --emoji --format json
+
+# 更新评论
+dws sheet comment update --node <SHEET_ID> --comment-key <COMMENT_KEY> --content "已按最新数据修正" --format json
+
+# 删除评论（不可逆；必须用户确认后再加 --yes）
+dws sheet comment delete --node <SHEET_ID> --comment-key <COMMENT_KEY> --yes --format json
+```
+
+## 参考
+
+- [`../sheet.md`](../sheet.md)（如何路由到本命令族）
+- [`./sheet-workbook.md`](sheet-workbook.md)（取工作表名称）
+- `dws aisearch person`（取 mention 用的 userId，跨产品命令）

package/skills/dws/dingtalk-misc/references/sheet/sheet-conditional-format.md

@@ -0,0 +1,59 @@
+# Sheet 条件格式
+
+## 边界
+
+条件格式是随单元格值变化的规则对象，不是一次性静态样式。只要求固定外观时进入 sheet-style-format。ruleId 必须来自本任务 create/list；所有操作使用真实 nodeId、sheetId。
+
+若用户明确要求新增“判断结果/是或否”辅助列，必须先写可见辅助列，再基于辅助列创建规则；不能用一步 formulaCondition 隐藏掉用户要求的数据产物。
+
+## 创建前
+
+- 读取最小数据范围，确认首行、空值和数据类型。
+- ranges 是 JSON 数组，使用精确 A1 范围，不扩大到无界整列。
+- 日期或公式条件要处理空单元格，避免空值被当作 0/日期触发。日期到期示例使用 `=AND(E1<>"",E1<=TODAY())`；相对引用随行变化，只有明确固定比较一个格时才用绝对引用。
+- 每条规则的 condition 只能选一种结构。常用精确形态：
+  - numberCondition：operator=equal/not-equal/greater/greater-equal/less/less-equal/between/not-between；value1 必填，between/not-between 还需 value2。
+  - textCondition：operator=contains/not-contains/starts-with/ends-with，value 为文本。
+  - emptyCondition/errorCondition/duplicateCondition：operator 分别取 is-empty/is-not-empty、error/no-error、duplicate/unique。
+  - formulaCondition：`{"formula":"=A1>100"}`。
+  - rankCondition：value、isPercent、isBottom；averageCondition：isAbove、andEqual；stdevCondition：value、isAbove、andEqual。
+  - dataBarCondition：minPoint/maxPoint，各点 type 取 auto/maxmin/number/percent/percentile/formula，可带 value；样式单独用 data-bar-style。
+  - iconSetCondition：iconSet 数组项包含 criteria `{type,value,gtOrEqual}` 和 icon `{type:"id",value:...}`，可带 showIconOnly。
+  - colorScaleCondition：criterias 为 2 或 3 项，每项 `{type,value?,color}`。
+- cell-style 只使用 backgroundColor、fontColor、bold、italic、strikethrough。“标红/高亮/染色”默认 backgroundColor，只有明确“字体红”才用 fontColor。不确定扩展字段时读 create 的 compact Schema。
+
+## 创建
+
+数值阈值示例：
+
+    dws sheet cond-format create       --node <NODE_ID> --sheet-id <SHEET_ID>       --ranges '["A2:A100"]'       --condition '{"numberCondition":{"operator":"greater","value1":"80"}}'       --cell-style '{"backgroundColor":"#FFCDD2","fontColor":"#B71C1C","bold":true}'       --format json
+
+辅助列示例，分两个阶段：
+
+    dws sheet range update       --node <NODE_ID> --sheet-id <SHEET_ID> --range "H2:H4"       --values '[[{"type":"text","text":"=IF(A2>B2,\"是\",\"否\")"}],[{"type":"text","text":"=IF(A3>B3,\"是\",\"否\")"}],[{"type":"text","text":"=IF(A4>B4,\"是\",\"否\")"}]]'       --format json
+
+    dws sheet cond-format create       --node <NODE_ID> --sheet-id <SHEET_ID>       --ranges '["A2:H4"]'       --condition '{"formulaCondition":{"formula":"=$H2=\"是\""}}'       --cell-style '{"backgroundColor":"#FFECEC"}'       --format json
+
+先回读 H2:H4 的公式和值，再创建规则。不要把公式条件视觉正确等同于辅助列已经存在。
+
+数据条样式示例：
+
+    --condition '{"dataBarCondition":{"minPoint":{"type":"auto"},"maxPoint":{"type":"auto"}}}' --data-bar-style '{"fill":["#4CAF50","#F44336"],"isGradient":true}'
+
+三色色阶示例：
+
+    --condition '{"colorScaleCondition":{"criterias":[{"type":"maxmin","color":"#F44336"},{"type":"percentile","value":"50","color":"#FFEB3B"},{"type":"maxmin","color":"#4CAF50"}]}}'
+
+## 查询、更新、删除
+
+    dws sheet cond-format list       --node <NODE_ID> --sheet-id <SHEET_ID>       --rule-id <RULE_ID> --format json
+
+update 是部分更新：至少传 ranges、condition、cell-style、data-bar-style 之一，未传字段保持不变；传 condition 会替换原条件类型。先 list 单个对象确认当前类型与范围，再只提交用户要求的字段，完成后重新 list。
+
+    dws sheet cond-format update       --node <NODE_ID> --sheet-id <SHEET_ID>       --rule-id <RULE_ID>       --condition '{"numberCondition":{"operator":"greater","value1":"90"}}'       --format json
+
+删除规则不删除原始数据，但会永久移除视觉规则；规则已不存在时按幂等成功处理。展示 ruleId、范围和条件，得到明确同意后：
+
+    dws sheet cond-format delete       --node <NODE_ID> --sheet-id <SHEET_ID>       --rule-id <RULE_ID> --yes --format json
+
+create/update 后 list 验证 ID、ranges、condition 和样式；delete 后验证规则消失。命令失败、JSON 损坏或列表缺字段不能解释为空规则。

package/skills/dws/dingtalk-misc/references/sheet/sheet-dimension-operations.md

@@ -0,0 +1,60 @@
+# Sheet 行列操作
+
+## 适用命令
+
+| 目标 | 命令 |
+|---|---|
+| 在位置前插入 | insert-dimension |
+| 删除连续行/列 | delete-dimension |
+| 隐藏、显示、调整尺寸 | update-dimension |
+| 移动连续行/列 | move-dimension |
+| 末尾追加空行/列 | add-dimension |
+| 创建/取消分组 | group-dimension / ungroup-dimension |
+
+所有命令前缀均为 dws sheet，并要求当前任务真实 nodeId、sheetId。
+
+## 坐标规则
+
+- dimension 只取 ROWS 或 COLUMNS。
+- ROWS 的 position/start-index/end-index/destination-index 使用 1 起始行号字符串，如 "3"。
+- COLUMNS 使用列字母，如 "A"、"AB"。
+- 这些参数不是 A1 矩形范围，不要传 A1:C5。
+- 分组范围必须是整行 "3:7" 或整列 "C:F"；普通矩形无效。
+- insert/delete/update/add-dimension 的 length 都是正整数，单次最多 5000。
+- position/start-index/range 带工作表前缀时，以前缀解析出的工作表为准并忽略 sheet-id；只在确有跨表坐标需求时使用，避免名称歧义。
+
+## 操作前检查
+
+插入、删除、移动之前先执行：
+
+    dws sheet info --node <NODE_ID> --sheet-id <SHEET_ID> --format json
+
+检查 mergedRanges、冻结、隐藏和现有 groups。若合并区域跨过操作位置，先说明影响；必要时明确取消合并，完成结构操作后按原意恢复。删除、移动会改变公式引用、命名范围和后续坐标，下一阶段必须使用更新后的范围。
+
+move-dimension 的 start/end 为包含端点的连续源区间；destination-index 不能落在源区间内。向下/向右移动时目标应大于 end，向上/向左时目标应小于 start。涉及合并单元格的移动可能失败；不得改用“读出、删除、写回”模拟移动，先记录 mergedRanges，必要时取消合并并在操作后恢复。
+
+删除行列属于不可逆结构修改。展示维度、起点、长度及可能影响，获得明确同意后才执行需要的确认参数。
+
+## 精确示例
+
+    dws sheet insert-dimension       --node <NODE_ID> --sheet-id <SHEET_ID>       --dimension ROWS --position "3" --length 2 --format json
+
+    dws sheet update-dimension       --node <NODE_ID> --sheet-id <SHEET_ID>       --dimension COLUMNS --start-index "C" --length 1       --pixel-size 200 --hidden --format json
+
+    dws sheet move-dimension       --node <NODE_ID> --sheet-id <SHEET_ID>       --dimension ROWS --start-index "2" --end-index "4"       --destination-index "1" --format json
+
+update-dimension 的尺寸模式：pixel 必须配合非负 `--pixel-size`；standard 恢复默认尺寸且不能同时传 pixel-size；auto 按内容自适应且只支持 ROWS，也不能同时传 pixel-size。只改 hidden 时省略 size-type/pixel-size；只改尺寸时不要顺带提交 hidden。
+
+## 分组
+
+    dws sheet group-dimension       --node <NODE_ID> --sheet-id <SHEET_ID>       --range "3:7" --group-state fold --format json
+
+    dws sheet info       --node <NODE_ID> --sheet-id <SHEET_ID>       --include groups --format json
+
+分组后在 rowGroups/columnGroups 中按 range 验证；collapsed=true 表示折叠。group/ungroup 可进入 batch-update，但 batch 内只使用默认展开；要求创建后立即折叠时单独调用 group-dimension --group-state fold。
+
+group-state 只决定新建分组的初始 expand/fold 状态。当前没有“只修改已有分组 collapsed 状态”的独立命令；不要通过再次 group 猜测为状态更新，也不要从 groups 的 level/depth 推导可写参数。
+
+## 完成条件
+
+结构写响应后必须重新 info；验证行列数量、隐藏/尺寸、mergedRanges 和 groups 与预期一致。若坐标变化，向后续阶段传播新范围，不能继续使用修改前的 A1 地址。

package/skills/dws/dingtalk-misc/references/sheet/sheet-dropdown.md

@@ -0,0 +1,103 @@
+# 下拉列表 (dropdown)
+
+## 使用场景
+
+### 下拉列表
+
+用户说"设置下拉列表/下拉选项/下拉菜单/添加下拉/配置下拉":
+- 设置下拉列表 → `set-dropdown`
+- 设置多选下拉 → `set-dropdown --multi-select`
+- 引用单元格区域作为候选项 → `set-dropdown --source-sheet-id ... --source-range ...`
+
+用户说"查看下拉列表/获取下拉配置/下拉列表有哪些选项":
+- 获取下拉列表配置 → `get-dropdown`
+
+用户说"删除下拉列表/移除下拉/取消下拉/清除下拉":
+- 删除下拉列表 → `delete-dropdown`
+
+## 命令详细参考
+
+### 设置下拉列表
+```
+Usage:
+  dws sheet set-dropdown [flags]
+Example:
+  # 设置单选下拉列表
+  dws sheet set-dropdown --node <NODE_ID> --sheet-id <SHEET_ID> --range "A2:A100" \
+    --options '[{"value":"选项1"},{"value":"选项2"},{"value":"选项3"}]'
+
+  # 设置带颜色的多选下拉列表
+  dws sheet set-dropdown --node <NODE_ID> --sheet-id <SHEET_ID> --range "B2:B50" \
+    --options '[{"value":"高","color":"#ff0000"},{"value":"中","color":"#ffaa00"},{"value":"低","color":"#00ff00"}]' \
+    --multi-select
+
+  # 引用同一工作簿内另一工作表的区域作为候选项来源
+  dws sheet set-dropdown --node <NODE_ID> --sheet-id <TARGET_SHEET_ID> --range "C2:C100" \
+    --source-sheet-id <SOURCE_SHEET_ID> --source-range "T1:T3"
+Flags:
+      --node string              表格文档 ID 或 URL (必填)
+      --sheet-id string          工作表 ID 或名称 (必填)
+      --range string             目标单元格范围，A1 表示法，如 A2:A100 (必填)
+      --options string           Inline 下拉选项 JSON 数组，与 --source-range 二选一
+      --source-sheet-id string   SourceRange 来源工作表 ID，与 --source-range 同时指定
+      --source-range string      SourceRange 来源区域，与 --options 二选一；不带工作表前缀
+      --multi-select             是否允许多选（默认单选）
+```
+
+在指定单元格范围内设置下拉列表。Inline 模式直接存储选项；SourceRange 模式引用同一工作簿内的来源区域，可跨工作表，并支持普通区域、整行和整列。
+- **用途**：为单元格配置静态选项或区域来源下拉，两种模式都支持多选；颜色仅 Inline 支持。
+- **场景**：规范数据输入，如状态选择（完成/进行中/待处理）、优先级（高/中/低）等。
+- **注意**：`--options` 与 `--source-range` 必须且只能指定一个。`--source-range` 只写 `T1:T3`、`T:T`、`1:3` 这类 A1 区域，来源工作表通过 `--source-sheet-id` 单独指定；不接受工作表前缀、公式或多区域。SourceRange 颜色写入暂不支持。
+- **结构操作行为**：已验证的工作表重命名、在引用前插入行/列、删除引用前的行会自动调整引用并保持 `valid`；已验证的 `move-dimension` 场景会使其变为 `invalid`。列删除、删除整个来源区域或来源工作表等场景未覆盖，不能预设结果；结构操作后先回读 `sourceRangeStatus`，仅在 `invalid` 时重新选择来源并写入。
+
+### 获取下拉列表配置
+```
+Usage:
+  dws sheet get-dropdown [flags]
+Example:
+  dws sheet get-dropdown --node <NODE_ID> --sheet-id <SHEET_ID> --range "A2:A100"
+  dws sheet get-dropdown --node <NODE_ID> --sheet-id <SHEET_ID> --range "A1"
+Flags:
+      --node string       表格文档 ID 或 URL (必填)
+      --sheet-id string   工作表 ID 或名称 (必填)
+      --range string      查询范围，A1 表示法，如 A1:A100 (必填)
+```
+
+查询指定范围内的下拉列表配置信息。
+- **用途**：查看单元格已设置的下拉列表选项和配置。
+- **场景**：在修改下拉列表前先查询现有配置；确认下拉列表是否设置成功。
+- **返回**：`dataValidations` 按相同配置分组。Inline 组返回 `sourceType:"inline"`、`conditionValues`、`ranges` 和 `options`；SourceRange 组始终返回 `sourceType:"sourceRange"`、`sourceRangeStatus:"valid"/"invalid"`、`enableMultiSelect` 和 `ranges`，仅在 `sourceRangeStatus:"valid"` 时返回 `sourceRange:{sheetId,a1Notation}`。`invalid` 时仍保留配置组，但省略 `sourceRange`，不得依赖旧坐标修复。SourceRange 不会展开候选值，因此不返回 `conditionValues`、`options` 或颜色。范围内无下拉列表时 `hasDropdown` 为 false。
+
+### 删除下拉列表
+```
+Usage:
+  dws sheet delete-dropdown [flags]
+Example:
+  dws sheet delete-dropdown --node <NODE_ID> --sheet-id <SHEET_ID> --range "A2:A100"
+  dws sheet delete-dropdown --node <NODE_ID> --sheet-id <SHEET_ID> --range "B1:D10"
+Flags:
+      --node string       表格文档 ID 或 URL (必填)
+      --sheet-id string   工作表 ID 或名称 (必填)
+      --range string      要删除下拉列表的范围，A1 表示法 (必填)
+```
+
+删除指定范围内的下拉列表配置，单元格恢复为普通文本格式。
+- **用途**：移除不再需要的下拉列表约束。
+- **注意**：已填写的单元格值不会被清除；目标范围不存在下拉列表时操作仍返回成功。
+
+## 上下文传递
+
+| 操作 | 从返回中提取 | 用于 |
+|------|-------------|------|
+| `set-dropdown` | `range` 实际设置范围、`enableMultiSelect` 是否多选；仅 Inline 模式返回 `optionCount` | 确认下拉列表设置成功 |
+| `get-dropdown` | `hasDropdown`、`dataValidations`；按 `sourceType` 区分 Inline 与 SourceRange | 查看已有下拉配置 |
+| `delete-dropdown` | `range` 实际删除范围 | 确认下拉列表删除完成 |
+| `list` | 工作表的 `sheetId` | info / range read / range update / find 的 --sheet-id |
+
+## 注意事项
+
+- ★ **`--sheet-id` 获取规范（强制）**：`sheetId` 未知时必须先通过 `dws sheet list --node <NODE_ID> --format json` 查询，禁止凭空编造（如臆测为 `Sheet1`、`sheet1`、`0`、`default` 等）
+- `set-dropdown` 的 Inline 模式使用 `--options`，每个元素包含 `value`（必填）和 `color`（可选，`#RRGGBB`）；SourceRange 模式使用 `--source-sheet-id` + `--source-range`。两种模式均可用 `--multi-select`，并会覆盖目标范围已有下拉
+- SourceRange 在已验证的重命名、引用前插入行/列、删除引用前行的场景会自动调整；已验证的 `move-dimension` 会使其变为 `invalid`。其他未覆盖删除/移动场景后先回读，仅 `invalid` 时重新选源写入；颜色写入暂不支持
+- `get-dropdown` 查询指定范围内的下拉配置，并按相同配置分组。SourceRange 即使无效也保留一组并以 `sourceRangeStatus:"invalid"` 表示，但省略 `sourceRange`，不回退展开候选值
+- `delete-dropdown` 删除指定范围内的下拉列表配置，单元格恢复为普通文本格式。已填写的值不会被清除。目标范围不存在下拉列表时操作仍返回成功

package/skills/dws/dingtalk-misc/references/sheet/sheet-export.md

@@ -0,0 +1,135 @@
+# 导出 (export)
+
+## 使用场景
+
+### 导出
+
+用户说"导出/下载xlsx/存为Excel/存成表格文件/把表格变成xlsx/导出表格/下载表格/导出为 excel":
+- 导出表格 → `export`（单命令会自动等待完成，并可选下载）
+- 仅需传 `--node`，可选 `--output` 指定本地文件/目录（不传则返回 downloadUrl）
+- 需要落盘到本地 → `dws sheet export --node <NODE_ID> --output <path>`，命令自动下载 xlsx
+- 禁止用 `range read` 全量读取后自行拼接 xlsx 来模拟导出；必须使用 `export`，才能保留格式、合并和公式等属性
+- 禁止在 AI Agent 侧实现轮询或重试；命令会自动等待结果，最长约 5 分钟
+
+用户说"导出 CSV/存成 csv/导出这个工作表为 csv":
+- 导出单个工作表为纯 CSV → `export-csv`（**同步**，不走异步任务；与 `export` 是两条独立命令）
+- 用 `--sheet-id` 指定工作表（不传取第一个）、`--range` 限定范围、`--value-render-option` 选取值模式
+- 不传 `--output` 时 CSV 正文打印到 stdout，可直接管道处理
+
+## 命令详细参考
+
+### 导出表格为 xlsx（异步任务一站式）
+```
+Usage:
+  dws sheet export [flags]    # 一站式：提交 → 轮询 → 可选下载
+Example:
+  # 仅导出，返回 downloadUrl（链接有时效性，请尽快下载）
+  dws sheet export --node <NODE_ID>
+  dws sheet export --node "https://alidocs.dingtalk.com/i/nodes/<DOC_UUID>"
+
+  # 导出并自动下载为本地文件
+  dws sheet export --node <NODE_ID> --output ./report.xlsx
+
+  # --output 为目录时，自动按下载链接中的文件名保存
+  dws sheet export --node <NODE_ID> --output ./
+
+Flags:
+      --node string     表格文档 ID 或 URL (必填)
+      --output string   本地保存路径（可选，支持文件路径或目录）
+```
+
+将钉钉在线电子表格导出为 Office xlsx 格式。**单命令一站式**：命令会自动等待导出完成，并在指定 `--output` 时保存到本地。AI Agent 无需拆分步骤或自行轮询；最长等待约 5 分钟，超时后按命令错误处理。
+
+**命令返回**：
+- `--output` 未指定：进度日志 + 末尾输出 `jobId` 和 `downloadUrl`（链接有时效性，请尽快下载）
+- `--output` 指定为文件路径：下载到该路径并输出 `导出完成: <path>`
+- `--output` 指定为已存在目录：自动从 `downloadUrl` 推断文件名并保存到该目录下
+
+**失败处理**：
+- 导出任务返回 `FAILED`：命令立即返回错误并附带失败原因，**禁止自动重试 `dws sheet export`**，告知用户稍后再试
+- 轮询 30 次仍 `PROCESSING`：命令返回超时错误，告知用户稍后再试
+
+**限制**：仅支持钉钉在线电子表格（axls）→ xlsx。导出钉钉文字文档请使用 `doc` 产品对应的导出工具。
+
+### 导出单个工作表为纯 CSV（同步）
+```
+Usage:
+  dws sheet export-csv [flags]
+Example:
+  dws sheet export-csv --node <NODE_ID>
+  dws sheet export-csv --node <NODE_ID> --sheet-id <SHEET_ID> --output ./data.csv
+  dws sheet export-csv --node <NODE_ID> --range A1:Z1000 --value-render-option raw_value
+
+Flags:
+      --node string                  表格文档 ID 或 URL (必填)
+      --sheet-id string              工作表 ID 或名称（不传则第一个工作表）
+      --range string                 导出范围，A1 表示法（不传则整表；大表可用此分块导出）
+      --value-render-option string   取值模式: formatted_value(默认) / raw_value / formula
+      --output string                本地保存路径（可选，支持文件路径或目录）；不传则输出到 stdout
+      --allow-truncated              允许数据被截断时仍然导出。默认截断即报错且不写文件
+```
+
+同步读取**单个**工作表并输出 RFC4180 CSV，不走异步导出任务。与 `export` 是两条独立命令：`export` 导整篇工作簿的 xlsx（异步提交+轮询），`export-csv` 只导一个工作表的纯值（一次请求即返回）。不传 `--output` 时 CSV 正文打印到 stdout，可直接管道处理。
+
+**`--output` 落盘是原子替换**：CSV 先写同目录临时文件、成功后再替换目标，写入失败时已有文件保持原样（父目录不存在仍按错误处理，不会自动创建）。`--output` 指向已存在目录时保存为该目录下的 `sheet-export.csv`。
+
+**超大表默认 fail-closed**：数据超出单次读取上限（服务端返回 `hasMore`）时，命令**直接报错并以非 0 退出，既不打印 CSV 也不写文件**（已存在的目标文件不会被截断数据覆盖）。处理方式：
+- 用 `--range` 分块导出（如 `--range A1:Z1000`、`A1001:Z2000` …）
+- 改用 `dws sheet export` 导出完整表格的 xlsx
+- 确认可以接受不完整数据时，显式加 `--allow-truncated`；此时才会照常输出/落盘，并在 stderr 给出「已被截断」警告，成功提示也会写明"数据已截断，不是完整表格"
+
+```bash
+# 落盘到本地
+dws sheet export-csv --node <NODE_ID> --sheet-id <SHEET_ID> --output ./data.csv
+
+# 输出到 stdout 便于管道处理
+dws sheet export-csv --node <NODE_ID> --sheet-id <SHEET_ID>
+
+# 大表分块导出（避免截断；不分块时默认会因截断而报错）
+dws sheet export-csv --node <NODE_ID> --sheet-id <SHEET_ID> --range "A1:Z1000" --output ./part1.csv
+
+# 明确接受不完整数据（否则截断即失败）
+dws sheet export-csv --node <NODE_ID> --sheet-id <SHEET_ID> --allow-truncated --output ./partial.csv
+```
+
+注意：CSV 只写纯值，不保留样式/合并/公式；需要完整属性请用 `dws sheet export` 导 xlsx。只是让 Agent 读取内容（带 `[row=N]` 行号前缀）请用 `dws sheet csv-get`。
+
+## 核心工作流
+
+```bash
+# ── 工作流 12: 导出表格为 xlsx（单命令一站式）──
+
+# 场景 A：仅获取下载链接（命令自动等待完成并返回 downloadUrl）
+dws sheet export --node <NODE_ID> --format json
+# 传入 URL 也可：
+# dws sheet export --node "https://alidocs.dingtalk.com/i/nodes/<DOC_UUID>" --format json
+
+# 场景 B：导出并自动下载为本地文件
+dws sheet export --node <NODE_ID> --output ./report.xlsx
+
+# 场景 C：下载到目录，自动按链接推断文件名
+dws sheet export --node <NODE_ID> --output ./
+
+# 禁止在 Agent 侧实现任何轮询或重试；命令会自动等待结果。
+# 若命令返回失败或超时，直接告知用户稍后再试，不要自动重调 dws sheet export。
+```
+
+## 上下文传递
+
+| 操作 | 从返回中提取 | 用于 |
+|------|-------------|------|
+| `export` | `downloadUrl`（未指定 --output）/ `outputPath`（指定 --output） | 直接下发给用户或告知文件已保存到本地；不要再调用其他 export 相关命令 |
+| `export` 超时中断 | 错误信息 | 直接报告失败或超时；当前没有独立续查命令，不自动重新提交导出 |
+| `export-csv` | CSV 正文（未指定 --output，走 stdout）/ `导出完成: <path>`（指定 --output） | 直接把 CSV 交给下游处理，或告知文件已保存到本地。命令是同步的，无任务/轮询概念 |
+
+## 注意事项
+
+- ★ `export` 仅支持钉钉在线电子表格（axls）→ xlsx；传入钉钉文字文档会报 `invalidRequest.document.typeIllegal`
+- ★ `export` 为单命令一站式，会自动等待结果并可选下载；**Agent 不得自行轮询或重试**，命令返回成功后不再调用其他 export 相关命令
+- `export` 内置轮询策略：1~5 次间隔 2s、6~10 次间隔 5s、11~20 次间隔 10s、21~30 次间隔 15s，硬上限 30 次（约 5 分钟）；超时后命令返回错误，告知用户稍后再试即可
+- ★ `export` 命令返回失败或超时时，**禁止自动重调 `dws sheet export`**；直接告知用户导出失败并建议稍后再试
+- `export` 未指定 `--output` 时，返回的 `downloadUrl` 具有时效性，获取后请尽快下载；若用户需要本地文件，优先直接传 `--output` 让 CLI 代为下载
+- `export` 的 `--output` 可为文件路径或已存在目录；为目录时自动从 `downloadUrl` 推断文件名，为文件路径时直接按该路径保存
+- 用户要求"导出表格/下载 xlsx"时，必须使用 `export` 单命令，禁止用 `range read` 读全量数据后自行拼 xlsx 模拟导出；`export` 会保留格式、合并、公式等属性
+- `export-csv` 与 `export` 是两条独立命令：`export-csv` 同步导出**单个**工作表的纯值 CSV，不保留样式/合并/公式；要整篇工作簿或完整属性一律用 `export`
+- ★ `export-csv` 遇到数据超出单次读取上限时默认报错、既不输出也不写文件；优先用 `--range` 分块导出，只有用户明确接受不完整数据时才加 `--allow-truncated`

package/skills/dws/dingtalk-misc/references/sheet/sheet-filter-view.md

@@ -0,0 +1,51 @@
+# Sheet 筛选视图
+
+## 边界与上下文
+
+筛选视图是命名的个人视角，不改变原始数据，也不影响其他协作者；用户只说“筛选”且要求所有人看到时，默认进入全局 `sheet filter`，明确说“筛选视图/个人视图”才进入本阶段。所有命令要求当前任务真实 nodeId、sheetId；filterViewId 必须来自本次 list/create 返回。未知 sheetId 时只调用一次 +list-sheets 并向后复用。
+
+column 是相对筛选视图 range 首列的 0 起始偏移，不是工作表绝对列号。例如视图从 C 列开始，column=0 指 C 列。视图 range 应包含表头行，否则筛选显示和列语义容易错位。
+
+## 命令闭环
+
+列出或查看：
+
+    dws sheet filter-view list       --node <NODE_ID> --sheet-id <SHEET_ID> --format json
+
+    dws sheet filter-view info       --node <NODE_ID> --sheet-id <SHEET_ID>       --filter-view-id <FILTER_VIEW_ID> --format json
+
+创建带条件的视图：
+
+    dws sheet filter-view create       --node <NODE_ID> --sheet-id <SHEET_ID>       --name "高销售额视图" --range "A1:E100"       --criteria '[{"column":0,"filterType":"values","visibleValues":["销售部"]},{"column":2,"filterType":"condition","conditions":[{"operator":"greater","value":"50000"}]}]'       --format json
+
+criteria 是数组，支持三类：
+
+- values：visibleValues 指定可见值。
+- condition：conditions 最多 2 项，比较值用字符串；conditionOperator 取 and（默认）或 or。operator 必须使用 kebab-case：equal、not-equal、contains、not-contains、starts-with、not-starts-with、ends-with、not-ends-with、greater、greater-equal、less、less-equal。
+- color：backgroundColor 与 fontColor 二选一；“标红/高亮”默认指背景色，只有明确说字体颜色时才用 fontColor。
+
+不在上述枚举中的 operator 不得猜测；确有其他需求时只读取 filter-view create/update-criteria 的 compact Schema。
+
+更新单列条件：
+
+    dws sheet filter-view update-criteria       --node <NODE_ID> --sheet-id <SHEET_ID>       --filter-view-id <FILTER_VIEW_ID> --column 2       --filter-criteria '{"filterType":"condition","conditions":[{"operator":"greater","value":"100"}]}'       --format json
+
+查看或删除条件：
+
+    dws sheet filter-view list-criteria       --node <NODE_ID> --sheet-id <SHEET_ID>       --filter-view-id <FILTER_VIEW_ID> --format json
+
+    dws sheet filter-view get-criteria       --node <NODE_ID> --sheet-id <SHEET_ID>       --filter-view-id <FILTER_VIEW_ID> --column 2 --format json
+
+    dws sheet filter-view delete-criteria       --node <NODE_ID> --sheet-id <SHEET_ID>       --filter-view-id <FILTER_VIEW_ID> --column 2 --format json
+
+delete-criteria 只清除一列条件并保留视图；对不存在的条件是幂等成功，但仍按删除类操作先确认。get-criteria 查询未设置条件的列会报错；list-criteria 在没有条件时返回空对象，两者不能互换。
+
+update 至少传 name/range/criteria 之一。criteria 只替换数组中明确指定列的条件，未指定列保持不变；update-criteria 精确替换一列。先 info/list-criteria 读取当前状态，只提交用户要求的变化，不能用空 criteria 猜测“清空全部”。
+
+## 删除与验证
+
+delete 会永久删除整个筛选视图及其条件。先展示名称、filterViewId、range，得到明确同意后才加 --yes：
+
+    dws sheet filter-view delete       --node <NODE_ID> --sheet-id <SHEET_ID>       --filter-view-id <FILTER_VIEW_ID> --yes --format json
+
+create/update/update-criteria/delete-criteria 后用 info 或 list-criteria 验证；delete 后用 list 验证对象消失。空列表只有在命令明确成功且 envelope 完整时才是真空结果；非零、坏 JSON 或缺字段必须报错。