@amaster.ai/pi-lark 0.1.14 → 0.1.16

package/skills/lark-task/references/lark-task-assign.md

@@ -1,6 +1,6 @@
 # task +assign
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 
 Assign or remove members (assignees) from a task.
 

package/skills/lark-task/references/lark-task-comment.md

@@ -1,6 +1,6 @@
 # task +comment
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 
 Add a comment to an existing task.
 

package/skills/lark-task/references/lark-task-complete.md

@@ -1,6 +1,6 @@
 # task +complete
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 
 Mark a task as completed.
 

package/skills/lark-task/references/lark-task-create.md

@@ -1,6 +1,6 @@
 # task +create
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 
 Create a new task in Lark.
 

package/skills/lark-task/references/lark-task-followers.md

@@ -1,6 +1,6 @@
 # task +followers
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 
 Manage task followers. Add or remove followers from an existing task.
 

package/skills/lark-task/references/lark-task-get-my-tasks.md

@@ -2,7 +2,7 @@
 
 If the user query only specifies a task name (e.g., "Complete task Lobster No. 1"), use this command to list and search for the task by its summary.
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 > 
 > **⚠️ Note:** This API must be called with a user identity. **Do NOT use an app identity, otherwise the call will fail.**
 >

package/skills/lark-task/references/lark-task-get-related-tasks.md

@@ -1,6 +1,6 @@
 # task +get-related-tasks
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 >
 > **⚠️ Note:** This API must be called with a user identity. **Do NOT use an app identity, otherwise the call will fail.**
 >

package/skills/lark-task/references/lark-task-reminder.md

@@ -1,6 +1,6 @@
 # task +reminder
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 > **Priority:** For creating or modifying task reminder times, prioritize using this `+reminder` shortcut over other task update methods. It provides a more reliable and direct way to manage reminders.
 
 Manage task reminders. Set new reminders or remove existing ones. Note that setting a task reminder requires a due date.

package/skills/lark-task/references/lark-task-reopen.md

@@ -1,6 +1,6 @@
 # task +reopen
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 
 Reopen a previously completed task.
 

package/skills/lark-task/references/lark-task-search.md

@@ -1,6 +1,6 @@
 # task +search
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 >
 > **⚠️ Note:** This API must be called with a user identity. **Do NOT use an app identity, otherwise the call will fail.**
 

package/skills/lark-task/references/lark-task-set-ancestor.md

@@ -1,6 +1,6 @@
 # task +set-ancestor
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 
 Set a parent task for a task, or clear the parent to make it independent.
 

package/skills/lark-task/references/lark-task-tasklist-create.md

@@ -1,6 +1,6 @@
 # task +tasklist-create
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 
 Create a new tasklist, and optionally batch create tasks within it.
 

package/skills/lark-task/references/lark-task-tasklist-members.md

@@ -1,6 +1,6 @@
 # task +tasklist-members
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 
 Manage tasklist members (editors/owners).
 

package/skills/lark-task/references/lark-task-tasklist-search.md

@@ -1,6 +1,6 @@
 # task +tasklist-search
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 >
 > **⚠️ Note:** This shortcut uses tasklist search followed by tasklist detail queries to render the final output.
 

package/skills/lark-task/references/lark-task-tasklist-task-add.md

@@ -1,6 +1,6 @@
 # task +tasklist-task-add
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 
 Add existing tasks to a tasklist.
 

package/skills/lark-task/references/lark-task-update.md

@@ -1,6 +1,6 @@
 # task +update
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 
 Update an existing task in Lark.
 

package/skills/lark-task/references/lark-task-upload-attachment.md

@@ -1,6 +1,6 @@
 # task +upload-attachment
 
-> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> **Prerequisites:** Please read `../../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
 
 Upload a single local file as an attachment to a task (or any resource type accepted by the Task attachment endpoint). Max file size per upload is **50 MB**. For task agents, use `--resource-type=task_delivery`.
 

package/skills/lark-wiki/SKILL.md

@@ -49,7 +49,7 @@ metadata:
 
 Shortcut 是对常用操作的高级封装（`lark-cli wiki +<verb> [flags]`）。有 Shortcut 的操作优先使用。
 
-获取或解析 Wiki 节点统一优先使用 `wiki +node-get`，包括只为获取 `space_id`、`node_token`、`obj_token` 或 `obj_type` 的中间步骤。只有当前 CLI 不提供该 shortcut，或任务明确需要 shortcut 未输出的原始响应字段时，才回退到 `wiki spaces get_node`；回退前先运行 `lark-cli schema wiki.spaces.get_node`。
+获取或解析 Wiki 节点统一使用 `wiki +node-get`，包括只为获取 `space_id`、`node_token`、`obj_token` 或 `obj_type` 的中间步骤。
 
 | Shortcut | 说明 |
 |----------|------|
@@ -95,7 +95,6 @@ lark-cli wiki <resource> <method> [flags]  # 调用 API
 
 - `create` — 创建知识空间
 - `get` — 获取知识空间信息
-- `get_node` — 获取知识空间节点信息
 - `list` — 获取知识空间列表
 
 ### members

package/skills/lark-wiki/references/lark-wiki-delete-space.md

@@ -1,6 +1,6 @@
 # wiki +delete-space
 
-> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+> **前置条件：** 先阅读 [`../../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
 
 删除一个飞书知识空间（知识库）。OpenAPI 对应 `DELETE /open-apis/wiki/v2/spaces/:space_id`。
 

package/skills/lark-wiki/references/lark-wiki-move-to-drive.md

@@ -1,6 +1,6 @@
 # wiki +move-to-drive
 
-> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+> **前置条件：** 先阅读 [`../../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
 
 将已有 Wiki 节点移出知识库，并放到指定 Drive 文件夹；省略目标文件夹时放到当前调用身份的“我的空间”根目录。该操作始终创建异步任务，shortcut 会自动有限轮询。
 

package/skills/lark-wiki/references/lark-wiki-move.md

@@ -1,6 +1,6 @@
 # wiki +move
 
-> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+> **前置条件：** 先阅读 [`../../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
 
 在飞书知识库中移动已有 Wiki 节点，或将 Drive 文档迁入 Wiki。这个 shortcut 统一封装了两类流程：
 
@@ -66,7 +66,7 @@ lark-cli wiki +move \
 
 | 参数 | 必填 | 说明 |
 |------|------|------|
-| `--node-token` | 条件必填 | 要移动的 Wiki 节点 token。传入后命令进入 `node` 模式 |
+| `--node-token` | 条件必填 | 要移动的 Wiki 节点 token 或文档 obj_token。传入后命令进入 `node` 模式 |
 | `--source-space-id` | 否 | 源知识空间 ID，仅 `node` 模式可用；不传时会根据 `--node-token` 自动解析 |
 | `--target-space-id` | 条件必填 | 目标知识空间 ID。`docs_to_wiki` 模式必填；`node` 模式下如果不传，则必须传 `--target-parent-token` |
 | `--target-parent-token` | 否 | 目标父节点 token。`docs_to_wiki` 不传时表示迁入目标知识空间根目录 |
@@ -87,8 +87,9 @@ lark-cli wiki +move \
 
 ### `node` 模式
 
-- **源空间解析**：如果未传 `--source-space-id`，shortcut 会先调用 `GET /open-apis/wiki/v2/spaces/get_node` 查询 `--node-token`，再读取其 `space_id`
+- **源空间解析**：先调用 `GET /open-apis/wiki/v2/spaces/node_by_token` 解析源节点；未传 `--source-space-id` 时使用查询结果，传入时校验两者一致。
 - **目标父节点解析**：如果传了 `--target-parent-token`，shortcut 会先解析该父节点所属的 `space_id`
+- **节点类型**：源节点和目标父节点接受 Wiki `node_token` 或文档 `obj_token`，实际移动使用查询返回的 `node_token`。
 - **一致性校验**：如果同时传了 `--target-space-id` 和 `--target-parent-token`，shortcut 会校验两者是否属于同一个知识空间；不一致时直接返回验证错误
 - **移动到空间根目录**：如果只传 `--target-space-id`，则表示移动到该知识空间根目录
 

package/skills/lark-wiki/references/lark-wiki-node-create.md

@@ -1,6 +1,6 @@
 # wiki +node-create
 
-> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+> **前置条件：** 先阅读 [`../../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
 
 在飞书知识库中创建一个新节点，并自动解析目标知识空间。该 shortcut 对原生 `wiki.nodes.create` 做了一层更适合日常使用的封装：可以直接指定 `space_id`，也可以从父节点自动反查所属空间；在 `user` 身份下，如果同时省略 `--space-id` 和 `--parent-node-token`，还会自动回退到个人知识库 `my_library`。
 
@@ -75,7 +75,7 @@ lark-cli wiki +node-create \
 | 参数 | 必填 | 说明 |
 |------|------|------|
 | `--space-id` | 否 | 目标知识空间 ID；`user` 身份可传特殊值 `my_library` 表示个人知识库，`bot` 身份不支持该值 |
-| `--parent-node-token` | 否 | 父知识库节点 token；传入后会在该节点下创建新节点 |
+| `--parent-node-token` | 否 | 父知识库节点 token 或文档 obj_token；在解析出的 Wiki 节点下创建新节点 |
 | `--title` | 否 | 节点标题 |
 | `--node-type` | 否 | 节点类型，默认 `origin`；可选值：`origin`、`shortcut` |
 | `--obj-type` | 否 | 节点对应对象类型，默认 `docx`；可选值：`sheet`、`mindnote`、`bitable`、`file`、`docx`、`slides`。`file` 仅支持 `shortcut` 节点 |
@@ -85,7 +85,8 @@ lark-cli wiki +node-create \
 
 - **优先级**：`--space-id` > `--parent-node-token` > `my_library`
 - **显式 space**：传了 `--space-id` 时，shortcut 会直接使用该空间；如果该值是 `my_library`，则仅 `user` 身份可用，并会先调用 `GET /open-apis/wiki/v2/spaces/my_library` 解析成真实 `space_id`
-- **父节点推断**：未传 `--space-id` 但传了 `--parent-node-token` 时，会先调用 `GET /open-apis/wiki/v2/spaces/get_node` 获取父节点，再读取其 `space_id`
+- **父节点推断**：未传 `--space-id` 但传了 `--parent-node-token` 时，会先调用 `GET /open-apis/wiki/v2/spaces/node_by_token` 获取父节点，再读取其 `space_id`
+- **父节点类型**：`--parent-node-token` 接受 Wiki `node_token` 或已挂载到 Wiki 的文档 `obj_token`，创建时使用查询返回的 `node_token`；显式传空间时也会查询并校验父节点空间。
 - **个人知识库回退**：`user` 身份下，如果 `--space-id` 和 `--parent-node-token` 都没传，会自动解析 `my_library`
 - **bot 身份限制**：`bot` 身份既没有“个人知识库”回退语义，也不支持显式传 `--space-id my_library`；请改用真实 `space_id` 或 `--parent-node-token`
 

package/skills/lark-wiki/references/lark-wiki-node-delete.md

@@ -27,12 +27,16 @@ lark-cli wiki +node-delete --node-token <token> --obj-type wiki --dry-run
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
 | `--node-token` | string | **Yes** | — | `node_token`, cloud-doc `obj_token`, or a Lark URL embedding one; URL paths also imply `--obj-type` |
-| `--obj-type` | enum | Conditional | — | Required for a raw token (URL inputs auto-infer). `wiki` = the token is a `node_token`; otherwise the cloud-doc type |
-| `--space-id` | string | No | — | Auto-resolved via `get_node` when omitted (extra lookup; pass it to skip) |
+| `--obj-type` | enum | Conditional | — | Required for a raw token (URL inputs auto-infer). `wiki` uses the resolved `node_token`; other types use the resolved `obj_token` and must match its document type |
+| `--space-id` | string | No | — | Assert the resolved node belongs to this space; inferred when omitted |
 | `--include-children` | bool | No | `true` | Cascade-delete the subtree (default). `--include-children=false` lifts direct children up to the parent |
 | `--yes` | bool | Yes (real delete) | — | Confirm the high-risk operation. Without it the CLI returns `confirmation_required` |
 | `--as` | enum | No | `auto` | Identity `user`/`bot`; wiki is user-centric → pass `--as user` |
 
+The lookup sends only `token`, including when `--space-id` is provided. Deletion uses the resolved token matching `--obj-type`; a document-type mismatch is rejected before deletion.
+
+For a Wiki shortcut, use `--obj-type wiki` to delete the shortcut itself. Other types are rejected because the shortcut's `obj_token` identifies its origin document.
+
 ## Output
 
 ```json
@@ -57,6 +61,6 @@ Async/timeout adds `task_id`, `timed_out`, and `next_command`.
   - `131011` → the node has delete-approval enabled; apply via the Wiki UI (CLI cannot bypass approval).
   - `131003` → subtree too large to cascade-delete; use `--include-children=false` or delete sub-trees first.
 
-## Required Scope
+## Required Scopes
 
-`wiki:node:create` (the delete endpoint declares this scope). Auto-resolving `space_id` additionally needs `wiki:node:retrieve`; pass `--space-id` to avoid that lookup.
+Both `wiki:node:create` (deletion) and `wiki:node:retrieve` (target lookup) are required, including when `--space-id` is provided. The server also checks access to the target node.

package/skills/lark-wiki/references/lark-wiki-node-get.md

@@ -7,7 +7,6 @@ Get a wiki node's details by `node_token`, `obj_token`, or a Lark URL. Use this
 ```bash
 lark-cli wiki +node-get \
   --node-token <node_token | obj_token | Lark URL> \
-  [--obj-type <doc|docx|sheet|bitable|mindnote|slides|file>] \
   [--space-id <space_id>] \
   [--format json|pretty|table|csv|ndjson] \
   [--as user|bot]
@@ -19,7 +18,6 @@ lark-cli wiki +node-get \
 |------|------|----------|---------|-------------|
 | `--node-token` | string | **Yes** | — | `node_token`, cloud-doc `obj_token`, or a Lark URL embedding one (e.g. `https://feishu.cn/wiki/<token>` or `https://feishu.cn/docx/<token>`). Matches the `--node-token` naming used by sibling `+node-delete` / `+node-copy` / `+move`. |
 | `--token` | string | — (deprecated) | — | Deprecated original name; still accepted for backward compatibility but emits a `Flag --token has been deprecated, use --node-token instead` warning on stderr. New scripts should use `--node-token`. |
-| `--obj-type` | enum | No | — | Needed when `--node-token` is a raw `obj_token`; auto-inferred from typed Lark URLs. If omitted for a raw token, the shortcut treats it as a wiki `node_token`. |
 | `--space-id` | string | No | — | Optional cross-check: fail if the resolved node does not live in this space |
 | `--format` | enum | No | `json` | `json` / `pretty` / `table` / `csv` / `ndjson` |
 | `--as` | enum | No | `auto` | Identity `user`/`bot`; wiki is user-centric → pass `--as user` |
@@ -48,9 +46,10 @@ lark-cli wiki +node-get \
 
 ## Notes
 
-- The underlying API is `GET /open-apis/wiki/v2/spaces/get_node`. For a `node_token` no `obj_type` is sent; for an `obj_token` the `obj_type` (explicit or URL-inferred) is required.
+- The underlying API is `GET /open-apis/wiki/v2/spaces/node_by_token`. Only `token` is sent; the server detects whether it is a Wiki or document token and validates its length. The CLI still requires a nonempty token and validates URL syntax.
+- `--obj-type` is deprecated and hidden. Legacy scripts may still pass it; its value is ignored without a warning or any extra stdout/stderr output. URL paths are used only to extract tokens, not to assert the returned object type. `--space-id` remains a response cross-check.
 - `creator` falls back to `creator` when `node_creator` is absent. `updated_at` is `obj_edit_time` formatted as RFC3339.
-- No `url` is returned: `get_node` does not provide one and a synthesized `www.feishu.cn/wiki/<node_token>` link is non-canonical/misleading for a read command. Use `node_token` / `obj_token` as the identifiers.
+- The shortcut preserves its existing output fields and does not emit or synthesize a `url`. Use `node_token` / `obj_token` as the identifiers.
 
 ## Terminal business errors
 
@@ -58,10 +57,14 @@ These HTTP 200 responses carry a non-zero business code and are not retryable wi
 
 | Code | Meaning | Required action |
 |------|---------|-----------------|
+| `131005` | The Wiki node does not exist | Check the token or obtain a current Wiki link |
 | `131006` | The current user or app/bot identity lacks access to the Wiki node or space | This is resource access, not app scope authorization. Do not retry the same request, reauthorize, or switch identity as trial and error; ask the node owner or wiki administrator to grant read access, or use an accessible resource |
 | `131012` | The Wiki node has been deleted | Do not retry the same node token; rediscover the node or ask for a current Wiki link |
 | `131013` | The resource token is invalid | Do not switch identity or reauthorize; correct the URL/token |
 | `131014` | The document is not mounted in Wiki | Stop Wiki resolution; use the corresponding docs/sheets/base/drive command, or provide a Wiki URL/node_token |
+| `131016` | The token is too short | Provide the complete token or document URL; do not retry the same input |
+
+HTTP 200 alone does not mean success: non-zero business codes still produce a CLI failure. `131001` (invalid request) and gateway errors may still return HTTP 4xx/5xx.
 
 ## Rate limiting
 

package/skills/lark-sheets/references/lark-sheets-legacy-command-migration.md

@@ -1,152 +0,0 @@
-# Lark Sheet 旧命令迁移指南
-
-## 适用场景
-
-调用 `sheets` 旧命令（`+create`、`+read`、`+write`、`+create-sheet`、`+media-upload` 等 42 个）时收到
-`unknown subcommand`，或手上的脚本 / skill 早于表格命令重构。本文给出全部旧命令的替代命令，以及
-**不只是改名**的那些差异（flag 名、单元格 payload 写法、响应字段路径）。
-
-这些旧命令在重构后曾以别名形式保留了一段时间，线上使用量降到 5% 以下后整体删除。它们不再存在，
-也没有 deprecation 提示——直接报 `unknown subcommand`。
-
-## 一、命令名对照表
-
-### 工作簿
-
-| 旧命令 | 替代 |
-| --- | --- |
-| `+create` | `+workbook-create` |
-| `+info` | `+workbook-info` |
-| `+export` | `+workbook-export` |
-
-### 子表
-
-| 旧命令 | 替代 |
-| --- | --- |
-| `+create-sheet` | `+sheet-create` |
-| `+copy-sheet` | `+sheet-copy` |
-| `+delete-sheet` | `+sheet-delete` |
-| `+update-sheet` | 按意图拆开：`+sheet-rename` / `+sheet-move` / `+sheet-hide` / `+sheet-unhide` / `+dim-freeze` |
-
-### 单元格数据
-
-| 旧命令 | 替代 |
-| --- | --- |
-| `+read` | `+cells-get`（只要纯值 / CSV 用 `+csv-get`，整表用 `+table-get`） |
-| `+write` | `+cells-set` |
-| `+append` | `+table-put --sheets '{"sheets":[{…,"mode":"append"}]}'`（追加到已有数据下方；顶层必须是 `{"sheets":[…]}` 信封，裸数组会被拒绝）；若已知目标行号，`+cells-set` 写该区域即可 |
-| `+find` | `+cells-search` |
-| `+replace` | `+cells-replace` |
-
-### 样式 / 合并 / 单元格图片
-
-| 旧命令 | 替代 |
-| --- | --- |
-| `+set-style` | `+cells-set-style` |
-| `+batch-set-style` | `+cells-batch-set-style` |
-| `+merge-cells` | `+cells-merge` |
-| `+unmerge-cells` | `+cells-unmerge` |
-| `+write-image` | `+cells-set-image` |
-
-### 行列
-
-| 旧命令 | 替代 |
-| --- | --- |
-| `+add-dimension` | `+dim-insert` |
-| `+insert-dimension` | `+dim-insert` |
-| `+move-dimension` | `+dim-move` |
-| `+delete-dimension` | `+dim-delete` |
-| `+update-dimension` | 按意图拆开：`+rows-resize` / `+cols-resize` / `+dim-hide` / `+dim-unhide` / `+dim-group` / `+dim-ungroup` / `+dim-freeze` |
-
-### 筛选视图
-
-条件（condition）不再是独立对象，已折叠进视图自身的 flag。
-
-| 旧命令 | 替代 |
-| --- | --- |
-| `+create-filter-view` | `+filter-view-create` |
-| `+update-filter-view` | `+filter-view-update` |
-| `+list-filter-views` | `+filter-view-list` |
-| `+get-filter-view` | `+filter-view-list` |
-| `+delete-filter-view` | `+filter-view-delete` |
-| `+create-filter-view-condition` | `+filter-view-update` |
-| `+update-filter-view-condition` | `+filter-view-update` |
-| `+delete-filter-view-condition` | `+filter-view-update` |
-| `+list-filter-view-conditions` | `+filter-view-list` |
-| `+get-filter-view-condition` | `+filter-view-list` |
-
-### 下拉列表
-
-| 旧命令 | 替代 |
-| --- | --- |
-| `+set-dropdown` | `+dropdown-set` |
-| `+update-dropdown` | `+dropdown-update` |
-| `+get-dropdown` | `+dropdown-get` |
-| `+delete-dropdown` | `+dropdown-delete` |
-
-### 浮动图片
-
-单独的上传步骤已折叠进创建命令：`+float-image-create` 直接收本地 `--image` 路径。
-
-| 旧命令 | 替代 |
-| --- | --- |
-| `+media-upload` | `+float-image-create`（嵌入单元格内的图片用 `+cells-set-image`） |
-| `+create-float-image` | `+float-image-create` |
-| `+update-float-image` | `+float-image-update` |
-| `+delete-float-image` | `+float-image-delete` |
-| `+get-float-image` | `+float-image-list` |
-| `+list-float-images` | `+float-image-list` |
-
-## 二、只改命令名会踩的坑
-
-### 1. 单元格 payload 词汇变了
-
-旧命令的 `--values` 里，公式写成 `{"type":"formula","text":"=SUM(C2:C5)"}`。这类带 `type` / `text`
-的写法会被 `+cells-set` **直接拒绝**：
-
-```text
---cells[0][0].type is not a cell field — the value type is inferred from the JSON value;
-control display format via cell_styles.number_format
-```
-
-新写法把字段直接放在 cell 对象上（`{"formula":"=SUM(C2:C5)"}`）：
-
-```bash
-lark-cli sheets +cells-set --range C6 --cells '[[{"formula":"=SUM(C2:C5)"}]]'
-```
-
-内容字段只能选一个：`value` / `formula` / `rich_text` / `multiple_values`；`cell_styles`、`border_styles`、
-`note`、`data_validation` 可与内容字段自由叠加。纯标量（`"文本"`、`123`）也可直接放在格位上。
-完整字段用 `+cells-set --print-schema --flag-name cells` 查看。
-
-`--values` 在 `+cells-set` 上仍作为 `--cells` 的别名被接受，所以**只有携带旧对象写法的调用才会失败**。
-
-### 2. 响应字段路径变了
-
-| 命令 | 取值路径 |
-| --- | --- |
-| `+workbook-create` | spreadsheet token 在 `data.spreadsheet.spreadsheet_token` |
-| `+workbook-info` | 子表列表在 `data.sheets[]`（旧 `+info` 是 `data.sheets.sheets[]`）；**不再回显** spreadsheet token |
-| `+cells-get` | 值在 `data.ranges[].cells[][].value` |
-| `+cells-search` | `data.total_matches`、`data.matches[].address` |
-| `+sheet-create` / `+sheet-copy` | 新子表 id 在 `data.sheet_id` |
-| `+sheet-rename` / `+sheet-hide` | **只返回 `data.revision`**，要确认结果需回读 `+workbook-info`（`sheet_name`、`is_hidden`） |
-| `+dim-freeze` | `data.frozen_rows`、`data.frozen_columns` |
-
-### 3. `+update-sheet` 的一次调用要拆成多次
-
-旧命令在一次调用里同时设置标题、隐藏态和冻结行列；新命令按意图拆开，需要分别调用
-`+sheet-rename`、`+sheet-hide` / `+sheet-unhide`、`+dim-freeze`。
-
-注意 `+dim-freeze` 是**整份冻结状态覆盖**：`--rows` 与 `--cols` 一起表达完整状态，没写的那个轴会变成未冻结。
-
-### 4. 底层接口换了
-
-子表增删改查从 `sheets/v2/spreadsheets/{token}/sheets_batch_update` 换成了
-`sheet_ai/v2/spreadsheets/{token}/tools/invoke_write`（`modify_workbook_structure`）。
-只有直接断言过 HTTP 请求体的调用方需要关心这条。
-
-## 三、找不到对应命令时
-
-`lark-cli sheets --help` 列出全部当前命令；单个命令的 flag 与示例用 `lark-cli sheets <命令> --help`。
-按任务选命令的决策表见 [SKILL.md](../SKILL.md)。