npm - @amaster.ai/pi-lark - Versions diffs - 0.1.2-beta.73 → 0.1.2-beta.75 - Mend

@amaster.ai/pi-lark 0.1.2-beta.73 → 0.1.2-beta.75

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (139) hide show

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

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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/references/lark-wiki-delete-space.md CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 统一封装了两类流程：

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

@@ -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`。

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

@@ -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)。