@lark-apaas/coding-miaoda-sandbox-skills 0.1.0-dev.ec88bb5 → 0.1.0-dev.f3f0e48
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.
- package/miaoda/ai-data-processing/SKILL.md +4 -1
- package/miaoda/animation-skill/SKILL.md +348 -0
- package/miaoda/authz-cli/SKILL.md +1 -0
- package/miaoda/charts-skill/SKILL.md +264 -0
- package/miaoda/creative-to-fullstack/SKILL.md +64 -0
- package/miaoda/data-analysis/SKILL.md +151 -0
- package/miaoda/data-analysis/references/json-output-specification.md +277 -0
- package/miaoda/data-analysis/references/post-analysis-guide.md +77 -0
- package/miaoda/data-analysis/references/python-analysis-reference.md +272 -0
- package/miaoda/data-analysis/references/tmp-file-management-guide.md +100 -0
- package/miaoda/debug-investigation/SKILL.md +35 -23
- package/miaoda/extract-json-schema/SKILL.md +147 -0
- package/miaoda/feishu/SKILL.md +4 -4
- package/miaoda/forms-skill/SKILL.md +46 -4
- package/miaoda/lark-apps/SKILL.md +37 -0
- package/miaoda/lark-apps/references/openapi-key.md +80 -0
- package/miaoda/lark-apps-authz/SKILL.md +292 -0
- package/miaoda/lark-apps-authz/references/permission-points.md +39 -0
- package/miaoda/lark-apps-authz/references/role.md +122 -0
- package/miaoda/lark-apps-db/SKILL.md +227 -0
- package/miaoda/lark-apps-db/references/full-reference.md +424 -0
- package/miaoda/lark-apps-file/SKILL.md +216 -0
- package/miaoda/lark-apps-ops/SKILL.md +67 -0
- package/miaoda/lark-apps-ops/references/lark-apps-access-scope-get.md +30 -0
- package/miaoda/lark-apps-ops/references/lark-apps-access-scope-set.md +40 -0
- package/miaoda/lark-apps-ops/references/lark-apps-cache.md +62 -0
- package/miaoda/lark-apps-ops/references/lark-apps-env.md +46 -0
- package/miaoda/lark-apps-ops/references/lark-apps-export.md +46 -0
- package/miaoda/lark-apps-ops/references/lark-apps-local-dev.md +26 -0
- package/miaoda/lark-apps-ops/references/lark-apps-mcp.md +25 -0
- package/miaoda/lark-apps-ops/references/lark-apps-member.md +93 -0
- package/miaoda/lark-apps-ops/references/lark-apps-observability.md +46 -0
- package/miaoda/lark-apps-ops/references/lark-apps-plugin-install.md +36 -0
- package/miaoda/lark-apps-ops/references/lark-apps-plugin-list.md +23 -0
- package/miaoda/lark-apps-ops/references/lark-apps-plugin-uninstall.md +25 -0
- package/miaoda/lark-apps-ops/references/lark-apps-release-create.md +37 -0
- package/miaoda/lark-apps-ops/references/lark-apps-release-get.md +59 -0
- package/miaoda/lark-apps-ops/references/lark-apps-release-list.md +31 -0
- package/miaoda/lark-apps-ops/references/lark-apps-update.md +30 -0
- package/miaoda/lark-apps-ops/references/lark-apps-user-id-convert.md +63 -0
- package/miaoda/lark-apps-ops/references/openapi-key.md +80 -0
- package/miaoda/lark-design-prototype/DESIGN.md +603 -0
- package/miaoda/lark-design-prototype/SKILL.md +85 -0
- package/miaoda/lark-design-prototype/references/assets/card-illustration-library.md +113 -0
- package/miaoda/lark-design-prototype/references/case-matching.md +53 -0
- package/miaoda/lark-design-prototype/references/cases/conversational-ai-home.md +27 -0
- package/miaoda/lark-design-prototype/references/cases/data-table.md +30 -0
- package/miaoda/lark-design-prototype/references/cases/official-home.md +26 -0
- package/miaoda/lark-design-prototype/references/cases/workspace-home.md +34 -0
- package/miaoda/lark-design-prototype/references/color-roles.md +163 -0
- package/miaoda/lark-design-prototype/references/component-selection.md +134 -0
- package/miaoda/lark-design-prototype/references/design-quality-checklist.md +156 -0
- package/miaoda/lark-design-prototype/references/form-shell-patterns.md +77 -0
- package/miaoda/lark-design-prototype/references/icon-semantics.md +237 -0
- package/miaoda/lark-design-prototype/references/layout-interaction.md +164 -0
- package/miaoda/lark-design-prototype/references/page-contract.md +281 -0
- package/miaoda/lark-design-prototype/references/product-patterns.md +93 -0
- package/miaoda/lark-design-prototype/references/prompt-expansion.md +107 -0
- package/miaoda/lark-design-prototype/references/restoration-traps.md +113 -0
- package/miaoda/lark-design-prototype/references/token-semantics.md +112 -0
- package/miaoda/lark-design-prototype/references/visual-brief.md +125 -0
- package/miaoda/lark-design-prototype/references/visual-style-prompts.md +61 -0
- package/miaoda/lark-design-prototype/scripts/icon-query.mjs +272 -0
- package/miaoda/lark-design-prototype/scripts/token-query.mjs +76 -0
- package/miaoda/lark-design-prototype/scripts/verify-static-html.mjs +117 -0
- package/miaoda/miaoda-file/SKILL.md +1 -0
- package/miaoda/miaoda-sql/SKILL.md +21 -2
- package/miaoda/performance-review/SKILL.md +144 -0
- package/miaoda/performance-review/references/business-analyzer.md +139 -0
- package/miaoda/performance-review/references/examples.md +107 -0
- package/miaoda/semantic-search/SKILL.md +6 -4
- package/miaoda/table-skill/SKILL.md +2 -0
- package/{shared → miaoda}/testing-guide/SKILL.md +119 -13
- package/miaoda-design/lark-apps-comment/SKILL.md +119 -0
- package/miaoda-design/lark-apps-ops/SKILL.md +47 -0
- package/miaoda-design/lark-apps-ops/references/lark-apps-release-create.md +52 -0
- package/miaoda-design/lark-apps-ops/references/lark-apps-release-get.md +59 -0
- package/miaoda-design/lark-apps-ops/references/lark-apps-release-list.md +31 -0
- package/miaoda-design/lark-apps-ops/references/lark-apps-update.md +33 -0
- package/{shared → miaoda-modern}/charts-skill/SKILL.md +1 -1
- package/miaoda-modern/debug-investigation/SKILL.md +1 -1
- package/miaoda-modern/forms-skill/SKILL.md +70 -7
- package/{shared → miaoda-modern}/lark-apps/SKILL.md +5 -5
- package/miaoda-modern/lark-apps/references/openapi-key.md +80 -0
- package/miaoda-modern/lark-apps-ops/SKILL.md +67 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-access-scope-get.md +30 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-access-scope-set.md +40 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-cache.md +62 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-env.md +46 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-export.md +46 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-local-dev.md +26 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-mcp.md +25 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-member.md +93 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-observability.md +46 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-plugin-install.md +36 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-plugin-list.md +23 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-plugin-uninstall.md +25 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-release-create.md +37 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-release-get.md +59 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-release-list.md +31 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-update.md +30 -0
- package/miaoda-modern/lark-apps-ops/references/lark-apps-user-id-convert.md +63 -0
- package/{shared/lark-apps → miaoda-modern/lark-apps-ops}/references/openapi-key.md +3 -3
- package/miaoda-modern/lark-design-prototype/DESIGN.md +603 -0
- package/miaoda-modern/lark-design-prototype/SKILL.md +85 -0
- package/miaoda-modern/lark-design-prototype/references/assets/card-illustration-library.md +113 -0
- package/miaoda-modern/lark-design-prototype/references/case-matching.md +53 -0
- package/miaoda-modern/lark-design-prototype/references/cases/conversational-ai-home.md +27 -0
- package/miaoda-modern/lark-design-prototype/references/cases/data-table.md +30 -0
- package/miaoda-modern/lark-design-prototype/references/cases/official-home.md +26 -0
- package/miaoda-modern/lark-design-prototype/references/cases/workspace-home.md +34 -0
- package/miaoda-modern/lark-design-prototype/references/color-roles.md +163 -0
- package/miaoda-modern/lark-design-prototype/references/component-selection.md +134 -0
- package/miaoda-modern/lark-design-prototype/references/design-quality-checklist.md +156 -0
- package/miaoda-modern/lark-design-prototype/references/form-shell-patterns.md +77 -0
- package/miaoda-modern/lark-design-prototype/references/icon-semantics.md +237 -0
- package/miaoda-modern/lark-design-prototype/references/layout-interaction.md +164 -0
- package/miaoda-modern/lark-design-prototype/references/page-contract.md +281 -0
- package/miaoda-modern/lark-design-prototype/references/product-patterns.md +93 -0
- package/miaoda-modern/lark-design-prototype/references/prompt-expansion.md +107 -0
- package/miaoda-modern/lark-design-prototype/references/restoration-traps.md +113 -0
- package/miaoda-modern/lark-design-prototype/references/token-semantics.md +112 -0
- package/miaoda-modern/lark-design-prototype/references/visual-brief.md +125 -0
- package/miaoda-modern/lark-design-prototype/references/visual-style-prompts.md +61 -0
- package/miaoda-modern/lark-design-prototype/scripts/icon-query.mjs +272 -0
- package/miaoda-modern/lark-design-prototype/scripts/token-query.mjs +76 -0
- package/miaoda-modern/lark-design-prototype/scripts/verify-static-html.mjs +117 -0
- package/miaoda-modern/memory/SKILL.md +86 -0
- package/{shared → miaoda-modern}/performance-review/SKILL.md +3 -3
- package/miaoda-modern/reviewer-usage/SKILL.md +113 -0
- package/package.json +1 -1
- package/shared/attachment/SKILL.md +5 -1
- package/shared/lark-cli/SKILL.md +221 -0
- package/shared/lark-cli/lark-base/README.md +61 -0
- package/shared/lark-cli/lark-base/references/lark-base-commands.md +123 -0
- package/shared/lark-cli/lark-calendar/README.md +158 -0
- package/shared/lark-cli/lark-calendar/references/lark-calendar-meeting.md +30 -0
- package/shared/lark-cli/lark-calendar/references/lark-calendar-room-find.md +108 -0
- package/shared/lark-cli/lark-calendar/references/lark-calendar-suggestion.md +120 -0
- package/shared/lark-cli/lark-contact/README.md +35 -0
- package/shared/lark-cli/lark-contact/references/lark-contact-get-user.md +13 -0
- package/shared/lark-cli/lark-contact/references/lark-contact-search-user.md +121 -0
- package/shared/lark-cli/lark-doc/README.md +68 -0
- package/shared/lark-cli/lark-doc/references/lark-doc-fetch.md +138 -0
- package/shared/lark-cli/lark-doc/references/lark-doc-history.md +61 -0
- package/shared/lark-cli/lark-drive/README.md +158 -0
- package/shared/lark-cli/lark-drive/references/lark-drive-batch-query-comments.md +44 -0
- package/shared/lark-cli/lark-drive/references/lark-drive-files-list.md +183 -0
- package/shared/lark-cli/lark-drive/references/lark-drive-list-replies.md +49 -0
- package/shared/lark-cli/lark-im/README.md +70 -0
- package/shared/lark-cli/lark-im/references/lark-im-chat-list.md +140 -0
- package/shared/lark-cli/lark-im/references/lark-im-chat-members-list.md +84 -0
- package/shared/lark-cli/lark-im/references/lark-im-chat-search.md +135 -0
- package/shared/lark-cli/lark-im/references/lark-im-reactions.md +232 -0
- package/shared/lark-cli/lark-minutes/README.md +51 -0
- package/shared/lark-cli/lark-minutes/references/lark-minutes-download.md +130 -0
- package/shared/lark-cli/lark-sheets/README.md +174 -0
- package/shared/lark-cli/lark-sheets/references/lark-sheets-changeset.md +105 -0
- package/shared/lark-cli/lark-sheets/references/lark-sheets-chart.md +46 -0
- package/shared/lark-cli/lark-sheets/references/lark-sheets-conditional-format.md +42 -0
- package/shared/lark-cli/lark-sheets/references/lark-sheets-filter-view.md +51 -0
- package/shared/lark-cli/lark-sheets/references/lark-sheets-filter.md +42 -0
- package/shared/lark-cli/lark-sheets/references/lark-sheets-float-image.md +43 -0
- package/shared/lark-cli/lark-sheets/references/lark-sheets-formula-verify.md +64 -0
- package/shared/lark-cli/lark-sheets/references/lark-sheets-history.md +70 -0
- package/shared/lark-cli/lark-sheets/references/lark-sheets-pivot-table.md +44 -0
- package/shared/lark-cli/lark-sheets/references/lark-sheets-read-data.md +287 -0
- package/shared/lark-cli/lark-sheets/references/lark-sheets-search-replace.md +67 -0
- package/shared/lark-cli/lark-sheets/references/lark-sheets-sheet-structure.md +52 -0
- package/shared/lark-cli/lark-sheets/references/lark-sheets-sparkline.md +47 -0
- package/shared/lark-cli/lark-sheets/references/lark-sheets-workbook.md +69 -0
- package/shared/lark-cli/lark-sheets/scripts/lark_detect_subtables.py +596 -0
- package/shared/lark-cli/lark-sheets/scripts/lark_inspect_workbook.py +193 -0
- package/shared/lark-cli/lark-sheets/scripts/lark_profile_table.py +616 -0
- package/shared/lark-cli/lark-sheets/scripts/lark_sheet_range.py +176 -0
- package/shared/lark-cli/lark-sheets/scripts/lark_sheet_read_cli.py +221 -0
- package/shared/lark-cli/lark-sheets/scripts/sheets_df.py +50 -0
- package/shared/lark-cli/lark-slides/README.md +87 -0
- package/shared/lark-cli/lark-slides/references/lark-slides-history.md +117 -0
- package/shared/lark-cli/lark-slides/references/lark-slides-xml-presentation-slide-get.md +108 -0
- package/shared/lark-cli/lark-slides/references/lark-slides-xml-presentations-get.md +77 -0
- package/shared/lark-cli/lark-task/README.md +93 -0
- package/shared/lark-cli/lark-task/references/lark-task-get-my-tasks.md +57 -0
- package/shared/lark-cli/lark-task/references/lark-task-get-related-tasks.md +49 -0
- package/shared/lark-cli/lark-task/references/lark-task-search.md +36 -0
- package/shared/lark-cli/lark-task/references/lark-task-tasklist-search.md +35 -0
- package/shared/lark-cli/lark-vc/README.md +40 -0
- package/shared/lark-cli/lark-vc/references/lark-vc-recording.md +31 -0
- package/shared/lark-cli/lark-whiteboard/README.md +34 -0
- package/shared/lark-cli/lark-whiteboard/references/lark-whiteboard-export.md +59 -0
- package/shared/lark-cli/lark-wiki/README.md +50 -0
- package/shared/lark-cli/lark-wiki/references/lark-wiki-node-get.md +70 -0
- package/shared/lark-cli/lark-wiki/references/lark-wiki-node-list.md +95 -0
- package/shared/lark-cli/lark-wiki/references/lark-wiki-space-list.md +68 -0
- package/miaoda-design/attachment/SKILL.md +0 -58
- package/shared/dev-channel-probe/SKILL.md +0 -40
- /package/{shared → miaoda}/memory/SKILL.md +0 -0
- /package/{shared → miaoda}/reviewer-usage/SKILL.md +0 -0
- /package/{shared → miaoda-modern}/animation-skill/SKILL.md +0 -0
- /package/{shared → miaoda-modern}/data-analysis/SKILL.md +0 -0
- /package/{shared → miaoda-modern}/data-analysis/references/json-output-specification.md +0 -0
- /package/{shared → miaoda-modern}/data-analysis/references/post-analysis-guide.md +0 -0
- /package/{shared → miaoda-modern}/data-analysis/references/python-analysis-reference.md +0 -0
- /package/{shared → miaoda-modern}/data-analysis/references/tmp-file-management-guide.md +0 -0
- /package/{shared → miaoda-modern}/extract-json-schema/SKILL.md +0 -0
- /package/{shared → miaoda-modern}/performance-review/references/business-analyzer.md +0 -0
- /package/{shared → miaoda-modern}/performance-review/references/examples.md +0 -0
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# minutes (v1)
|
|
2
|
+
|
|
3
|
+
## 身份
|
|
4
|
+
|
|
5
|
+
所有 minutes 命令默认使用 `--as user`。
|
|
6
|
+
|
|
7
|
+
## Shortcuts
|
|
8
|
+
|
|
9
|
+
| Shortcut | 说明 |
|
|
10
|
+
|----------|------|
|
|
11
|
+
| [`+download`](references/lark-minutes-download.md) | 下载妙记音视频媒体文件 |
|
|
12
|
+
|
|
13
|
+
- 使用 Shortcut 前,必须先读其对应 reference 文档。
|
|
14
|
+
|
|
15
|
+
## 意图路由
|
|
16
|
+
|
|
17
|
+
| 用户意图 | 命令 |
|
|
18
|
+
|---------|------|
|
|
19
|
+
| 下载妙记音视频文件、获取媒体下载链接 | `+download` |
|
|
20
|
+
| 妙记基础信息:标题 / 时长 / 封面 / 链接 / 所有者 | `minutes minutes get` |
|
|
21
|
+
|
|
22
|
+
## 核心概念
|
|
23
|
+
|
|
24
|
+
- **妙记(Minutes)**:来源于飞书视频会议的录制产物或用户上传的音视频文件,通过 `minute_token` 标识。
|
|
25
|
+
- **妙记 Token(minute_token)**:妙记的唯一标识符,可从妙记 URL 末尾提取(如 `https://*.feishu.cn/minutes/obcnxxx` 中的 `obcnxxx`)。如果 URL 中包含额外参数(如 `?xxx`),截取路径最后一段。
|
|
26
|
+
|
|
27
|
+
## 核心场景
|
|
28
|
+
|
|
29
|
+
### 查看妙记基础信息
|
|
30
|
+
|
|
31
|
+
1. 当用户只需要确认某条妙记的标题、封面、时长、所有者、URL 等基础信息时,使用 `minutes minutes get`。
|
|
32
|
+
2. 从妙记 URL 末尾提取 `minute_token`,再调用 `minutes minutes get`。
|
|
33
|
+
3. 用户意图不明确时,默认先给基础元信息,帮助确认是否命中目标妙记。
|
|
34
|
+
|
|
35
|
+
### 下载妙记音视频文件
|
|
36
|
+
|
|
37
|
+
下载妙记的录音 / 录像媒体文件,或获取有效期 1 天的下载链接(只读操作)。使用前必须先阅读 [references/lark-minutes-download.md](references/lark-minutes-download.md)。
|
|
38
|
+
|
|
39
|
+
## API Resources
|
|
40
|
+
|
|
41
|
+
沙箱内本域仅以下原生 API 可用:
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
lark-cli minutes <resource> <method> [flags]
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### minutes
|
|
48
|
+
|
|
49
|
+
- `get` — 获取妙记信息
|
|
50
|
+
|
|
51
|
+
> **权限错误**:如果返回 `[2091005] permission deny`,表示用户没有对应妙记文件的阅读权限,需提示用户联系妙记 owner 申请权限。
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
|
|
2
|
+
# minutes +download
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
下载妙记的音视频媒体文件到本地,或获取有效期 1 天的下载链接。只读操作。
|
|
6
|
+
|
|
7
|
+
本 skill 对应 shortcut:`lark-cli minutes +download`。
|
|
8
|
+
|
|
9
|
+
## 命令
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
# 下载妙记(默认布局,落到 ./minutes/{minute_token}/<server-filename>)
|
|
13
|
+
lark-cli minutes +download --minute-tokens obcnxxxxxxxxxxxxxxxxxxxx
|
|
14
|
+
|
|
15
|
+
# 指定输出文件(单 token,文件路径)
|
|
16
|
+
lark-cli minutes +download --minute-tokens obcnxxxxxxxxxxxxxxxxxxxx --output ./meeting.mp4
|
|
17
|
+
|
|
18
|
+
# 指定输出目录(单/批量均可,目录路径)
|
|
19
|
+
lark-cli minutes +download --minute-tokens obcnxxxxxxxxxxxxxxxxxxxx --output-dir ./downloads
|
|
20
|
+
|
|
21
|
+
# 仅获取下载链接(有效期 1 天),不下载文件
|
|
22
|
+
lark-cli minutes +download --minute-tokens obcnxxxxxxxxxxxxxxxxxxxx --url-only
|
|
23
|
+
|
|
24
|
+
# 批量下载多个妙记(默认布局,逐个落到 ./minutes/{minute_token}/)
|
|
25
|
+
lark-cli minutes +download --minute-tokens obcnxxxxxxxxxxxxxxxxxxxx,obcnyyyyyyyyyyyyyyyyyyyy
|
|
26
|
+
|
|
27
|
+
# 批量下载到同一指定目录
|
|
28
|
+
lark-cli minutes +download --minute-tokens obcnxxxxxxxxxxxxxxxxxxxx,obcnyyyyyyyyyyyyyyyyyyyy --output-dir ./downloads
|
|
29
|
+
|
|
30
|
+
# 预览 API 调用
|
|
31
|
+
lark-cli minutes +download --minute-tokens obcnxxxxxxxxxxxxxxxxxxxx --dry-run
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## 参数
|
|
35
|
+
|
|
36
|
+
| 参数 | 必填 | 说明 |
|
|
37
|
+
|------|------|------|
|
|
38
|
+
| `--minute-tokens <tokens>` | 是 | 妙记 Token,逗号分隔支持批量(最多 50 个) |
|
|
39
|
+
| `--output <path>` | 否 | 输出文件路径(单 token)。若传入的是已存在目录,等价于 `--output-dir`。与 `--output-dir` 互斥 |
|
|
40
|
+
| `--output-dir <dir>` | 否 | 输出目录(单/批量均可)。与 `--output` 互斥 |
|
|
41
|
+
| `--overwrite` | 否 | 覆盖已存在的输出文件 |
|
|
42
|
+
| `--url-only` | 否 | 仅返回下载链接,不下载文件 |
|
|
43
|
+
| `--dry-run` | 否 | 预览 API 调用,不执行 |
|
|
44
|
+
|
|
45
|
+
> **默认落点**:未指定 `--output` / `--output-dir` 时,文件落到 `./minutes/{minute_token}/<server-filename>`。文件名沿用服务端 Content-Disposition / Content-Type 推断,Agent 可从 `saved_path` 字段读取实际路径。
|
|
46
|
+
|
|
47
|
+
## 核心约束
|
|
48
|
+
|
|
49
|
+
### 1. 妙记必须已完成转写
|
|
50
|
+
|
|
51
|
+
音视频文件仅在妙记转写完成后可下载。如果妙记尚未准备好,API 会返回 `2091003` 错误。
|
|
52
|
+
|
|
53
|
+
### 2. 下载链接有效期 1 天
|
|
54
|
+
|
|
55
|
+
`--url-only` 返回的链接有效期为 1 天,过期后需重新获取。
|
|
56
|
+
|
|
57
|
+
### 3. 频率限制
|
|
58
|
+
|
|
59
|
+
API 限流 5 次/秒,批量下载时需注意控制频率。
|
|
60
|
+
|
|
61
|
+
### 4. 所需权限
|
|
62
|
+
|
|
63
|
+
| 身份 | 所需权限 |
|
|
64
|
+
|------|---------|
|
|
65
|
+
| user | `minutes:minutes.media:export` |
|
|
66
|
+
|
|
67
|
+
## 输出结果
|
|
68
|
+
|
|
69
|
+
### 下载模式(默认)
|
|
70
|
+
|
|
71
|
+
单 token:
|
|
72
|
+
|
|
73
|
+
```json
|
|
74
|
+
{
|
|
75
|
+
"minute_token": "obcnxxxxxxxxxxxxxxxxxxxx",
|
|
76
|
+
"artifact_type": "recording",
|
|
77
|
+
"saved_path": "/path/to/minutes/obcnxxxxxxxxxxxxxxxxxxxx/访谈一则.m4a",
|
|
78
|
+
"size_bytes": 52428800
|
|
79
|
+
}
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
批量:`downloads` 数组,每条与上面结构一致,失败项带 `error` 字段。
|
|
83
|
+
|
|
84
|
+
| 字段 | 说明 |
|
|
85
|
+
|------|------|
|
|
86
|
+
| `minute_token` | 妙记 Token(用于 Agent 索引) |
|
|
87
|
+
| `artifact_type` | 固定为 `"recording"` |
|
|
88
|
+
| `saved_path` | 文件保存的本地路径(绝对路径) |
|
|
89
|
+
| `size_bytes` | 文件大小(字节) |
|
|
90
|
+
|
|
91
|
+
### URL 模式(--url-only)
|
|
92
|
+
|
|
93
|
+
```json
|
|
94
|
+
{
|
|
95
|
+
"minute_token": "obcnxxxxxxxxxxxxxxxxxxxx",
|
|
96
|
+
"download_url": "https://..."
|
|
97
|
+
}
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
| 字段 | 说明 |
|
|
101
|
+
|------|------|
|
|
102
|
+
| `minute_token` | 妙记 Token |
|
|
103
|
+
| `download_url` | 媒体文件下载链接(有效期 1 天) |
|
|
104
|
+
|
|
105
|
+
## 如何获取 minute_token
|
|
106
|
+
|
|
107
|
+
| 来源 | 获取方式 |
|
|
108
|
+
|------|---------|
|
|
109
|
+
| 妙记 URL | 从 URL 末尾提取,如 `https://sample.feishu.cn/minutes/obcnxxxxxxxxxxxxxxxxxxxx` → `obcnxxxxxxxxxxxxxxxxxxxx` |
|
|
110
|
+
| 妙记元信息查询 | `lark-cli minutes minutes get --params '{"minute_token": "obcn..."}'` |
|
|
111
|
+
|
|
112
|
+
## 常见错误与排查
|
|
113
|
+
|
|
114
|
+
| 错误现象 | 错误码 | 根本原因 | 解决方案 |
|
|
115
|
+
|---------|--------|---------|---------|
|
|
116
|
+
| 参数无效 | 2091001 | minute_token 格式不正确 | 检查 token 是否完整(24 位) |
|
|
117
|
+
| 资源不存在 | 2091002 | token 不存在 | 确认 minute_token 正确 |
|
|
118
|
+
| 妙记尚未准备好 | 2091003 | 转写未完成 | 等待转写完成后重试 |
|
|
119
|
+
| 资源已删除 | 2091004 | 妙记已被删除 | 确认妙记文件仍然存在 |
|
|
120
|
+
| 权限不足 | 2091005 | 无阅读权限 | 检查是否有该妙记的访问权限 |
|
|
121
|
+
|
|
122
|
+
## 提示
|
|
123
|
+
|
|
124
|
+
- 音视频文件可能较大,下载无固定超时限制(由用户 Ctrl+C 控制取消)。
|
|
125
|
+
- 单 token 模式下 `--output` 若传入已存在目录(如 `--output ./existing-dir`),等价于 `--output-dir`,文件落入该目录(cp 语义)。
|
|
126
|
+
- 批量模式下 `--output` 不接受已存在的文件路径(会报错),应改用 `--output-dir`。
|
|
127
|
+
|
|
128
|
+
## 参考
|
|
129
|
+
|
|
130
|
+
- [lark-minutes](../README.md) — 妙记全部命令
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
# sheets
|
|
2
|
+
|
|
3
|
+
## 术语约定
|
|
4
|
+
|
|
5
|
+
下列词在本 skill 各文档中可能交替出现,但**指同一对象**;解析用户口语时按此映射,不要当成不同概念:
|
|
6
|
+
|
|
7
|
+
| 标准用语 | 同义 / 口语(均指同一对象) | 说明 |
|
|
8
|
+
| --- | --- | --- |
|
|
9
|
+
| 工作表(sheet) | 子表、tab、标签页 | spreadsheet 内的单张表;`sheet_id` 是其稳定标识 |
|
|
10
|
+
| 电子表格(spreadsheet) | 工作簿、表格 | 顶层容器;由 `--url` 或 `--spreadsheet-token` 定位 |
|
|
11
|
+
| reference_id | id | **表内对象**的稳定标识,即各对象主键 flag 接受的值(见下表) |
|
|
12
|
+
|
|
13
|
+
各类只读对象命令用各自的主键 flag 过滤定位(命名不统一,按此表对照,不要凭直觉拼):
|
|
14
|
+
|
|
15
|
+
| 对象 | 主键 flag | 对象 | 主键 flag |
|
|
16
|
+
| --- | --- | --- | --- |
|
|
17
|
+
| 工作表 sheet | `--sheet-id` | 条件格式规则 | `--rule-id` |
|
|
18
|
+
| 图表 chart | `--chart-id` | 筛选视图 | `--view-id` |
|
|
19
|
+
| 透视表 pivot | `--pivot-table-id` | 迷你图(按组) | `--group-id` |
|
|
20
|
+
| 浮动图片 | `--float-image-id` | | |
|
|
21
|
+
|
|
22
|
+
## 场景 → 命令速查(拿不准命令名先查这里,别按直觉拼)
|
|
23
|
+
|
|
24
|
+
把高频**只读**意图映射到**真实存在**的 shortcut。agent 常从 Excel / Google Sheets / 飞书 OpenAPI 误迁移命令名或 flag,先对照本表,避免一次必然失败的试错。完整 shortcut 见各工具参考。**选定命令后先读"参考"列指向的 reference**:命令名对得上不代表用法对,读取分页 / 定位尤其容易漏掉 reference 里的防错规则。
|
|
25
|
+
|
|
26
|
+
| 你要做的事 | ✅ 正确写法 | 参考 |
|
|
27
|
+
| --- | --- | --- |
|
|
28
|
+
| 读数据(纯值 / CSV) | `+csv-get`(`--range` 可省略 = 读整个子表,无需先探行列;限定范围才传)<br>**默认读全量**,不必分页;结果过大时自动落盘,按回执的 `output_path` 读文件 | `lark-sheets-read-data` |
|
|
29
|
+
| 按列类型结构化读出(喂 DataFrame / round-trip) | `+table-get` | `lark-sheets-read-data` |
|
|
30
|
+
| 读值 + 公式 / 样式 / 批注 / 数据验证 | `+cells-get --include value,formula,style,comment,data_validation` | `lark-sheets-read-data` |
|
|
31
|
+
| 看某区域下拉框(数据验证)的选项 | `+dropdown-get`(范围用 `--range`) | `lark-sheets-read-data` |
|
|
32
|
+
| 查找 / 定位文本 | `+cells-search`(关键字用 `--find`) | `lark-sheets-search-replace` |
|
|
33
|
+
| 看子表结构(合并 / 行高列宽 / 冻结 / 隐藏 / 分组) | `+sheet-info` | `lark-sheets-sheet-structure` |
|
|
34
|
+
| 看工作簿 / 子表清单 | `+workbook-info` | `lark-sheets-workbook` |
|
|
35
|
+
| 取当前文档 revision(版本号) | `+revision-get` | `lark-sheets-workbook` |
|
|
36
|
+
| 复核某次(AI)编辑改了什么 / 取两个版本间的变更 | `+changeset-get --start-revision <编辑前版本>`(省略 `--end-revision` 取到最新;版本差 ≤ 20) | `lark-sheets-changeset` |
|
|
37
|
+
| 看历史版本列表 | `+history-list` | `lark-sheets-history` |
|
|
38
|
+
| 查回滚任务的当前状态 | `+history-revert-status --transaction-id <id>` | `lark-sheets-history` |
|
|
39
|
+
| 公式健康自检(扫全表 / 子表的公式错误) | `+formula-verify` | `lark-sheets-formula-verify` |
|
|
40
|
+
| 看已有图表配置 | `+chart-list` | `lark-sheets-chart` |
|
|
41
|
+
| 看条件格式规则 | `+cond-format-list` | `lark-sheets-conditional-format` |
|
|
42
|
+
| 看筛选器配置 | `+filter-list` | `lark-sheets-filter` |
|
|
43
|
+
| 看筛选视图 | `+filter-view-list` | `lark-sheets-filter-view` |
|
|
44
|
+
| 看透视表配置 | `+pivot-list` | `lark-sheets-pivot-table` |
|
|
45
|
+
| 看迷你图 | `+sparkline-list` | `lark-sheets-sparkline` |
|
|
46
|
+
| 看浮动图片 | `+float-image-list` | `lark-sheets-float-image` |
|
|
47
|
+
|
|
48
|
+
> ⚠️ **定位 flag**:`+cells-get` / `+csv-get` / `+dropdown-get` 用 `--range`;**读取附加信息**一律走 `+cells-get --include …`,**没有** `--with-styles` 这类 flag;**看合并单元格**用 `+sheet-info` 的 `merged_cells`,不要在 `+cells-get` 里找 merge flag。
|
|
49
|
+
> ⚠️ **要按名称 / 关键词在云空间里找某个表格文件**(不是读某张已知表的内容):当前沙箱不可用(lark-drive 域仅开放只读查询,不含按名称搜索能力);需用户直接提供表格的 URL / token,再回本 skill 读内容。
|
|
50
|
+
|
|
51
|
+
## 执行要点(读取 / 陷阱)
|
|
52
|
+
|
|
53
|
+
端到端只读工作流:了解结构(`scripts/lark_inspect_workbook.py` / `+workbook-info`)→ 读数据 → 理解语义 → 按需读对象配置 / 自检公式。
|
|
54
|
+
|
|
55
|
+
### 读取:按需求选路径(细则见 `lark-sheets-read-data`)
|
|
56
|
+
|
|
57
|
+
| 用户需求 | 读取路径 |
|
|
58
|
+
|---|---|
|
|
59
|
+
| "查一下 / 看看 / 统计 / 汇总"等只读 | 小表 `+csv-get` 读到上下文;大表先 `+workbook-info` + 小窗口 `+csv-get` 定边界,再对未截断窗口跑 `scripts/lark_detect_subtables.py` / `scripts/lark_profile_table.py` |
|
|
60
|
+
| 需要按列类型结构化读出(喂 DataFrame) | `+table-get` |
|
|
61
|
+
| 需要公式 / 样式 / 批注 / 数据验证 | `+cells-get --include …` |
|
|
62
|
+
| 需要看某区域下拉选项 | `+dropdown-get` |
|
|
63
|
+
|
|
64
|
+
> 读大表先按 `lark-sheets-read-data` 确认真实数据末行;默认读全量,结果超出 stdout 阈值时自动落盘、路径写在回执里,不要一口气拉全表撑爆上下文。
|
|
65
|
+
|
|
66
|
+
### 用脚本配合 CLI 时
|
|
67
|
+
|
|
68
|
+
- **只读 stdout**:CLI 数据走 stdout、诊断走 stderr;解析 JSON 别 `2>&1`(警告混入会解析失败),用管道或单独重定向 stdout。
|
|
69
|
+
- **读表理解优先用 `scripts/lark_*.py`**:`lark_inspect_workbook.py` / `lark_detect_subtables.py` / `lark_profile_table.py` 是随本 skill 分发的只读脚本,用来把在线表格整理成结构摘要(底层只调 `+workbook-info` / `+sheet-info` / `+csv-get`)。可选增强,不是必经步骤——脚本不可用时直接用 CLI 等价路径(对照表见 `lark-sheets-read-data`:`+workbook-info` / `+sheet-info` / 小窗口 `+csv-get`);需要公式 / 样式 / 批注 / 精确原始值时仍直接用 `+cells-get` / `+table-get`。
|
|
70
|
+
- **喂 CLI 的 CSV / JSON 用 UTF-8 无 BOM**;临时文件放系统临时目录、勿落项目目录。
|
|
71
|
+
- **命令失败先读 stderr 再调整**,别原样重发。
|
|
72
|
+
|
|
73
|
+
### 易漏陷阱
|
|
74
|
+
|
|
75
|
+
- **隐藏行列**:`+csv-get` 默认含隐藏行列;`--skip-hidden=true` 只看可见,真实行号会跳空——禁止按返回数组下标推导行号,用 `row_indices`(或加 `--include-row-prefix` 后读 `[row=N]`)。
|
|
76
|
+
- **跨 sheet 对象**:图表 / 条件格式 / 透视表 / 浮动图片可能分布在多个子表,读取前先 `+workbook-info` 掌握全局。
|
|
77
|
+
- **大数字精度**:15 位以上的身份证 / 参考号做去重 / 比较时禁止用 `+csv-get` 的显示值(会显示成科学计数、误判重复),改用 `+cells-get` 取原始精确值(见 `lark-sheets-read-data`)。
|
|
78
|
+
|
|
79
|
+
## References
|
|
80
|
+
|
|
81
|
+
先按操作对象进入对应工具参考查具体 shortcut 与调用细节。所有参考仅覆盖只读命令。
|
|
82
|
+
|
|
83
|
+
| Reference | 描述 |
|
|
84
|
+
| --- | --- |
|
|
85
|
+
| [Lark Sheet Read Data](references/lark-sheets-read-data.md) | 读取飞书表格中的单元格数据(`+csv-get` / `+cells-get` / `+table-get` / `+dropdown-get`)。当用户需要"看看数据"、"分析数据"、"统计/汇总",或需要查看公式、样式、批注、数据验证下拉选项时使用。 |
|
|
86
|
+
| [Lark Sheet Search](references/lark-sheets-search-replace.md) | 在飞书表格中搜索 / 定位文本(`+cells-search`),支持限定范围、大小写匹配、精确匹配、正则表达式。当用户需要"查找"、"搜索"、"定位"某个值时使用。不要用于理解表格结构(应读取数据)、不要把操作动作关键词(如"汇总金额")当作搜索词。 |
|
|
87
|
+
| [Lark Sheet Sheet Structure](references/lark-sheets-sheet-structure.md) | 查看飞书表格的子表结构与布局(`+sheet-info`):行高、列宽、隐藏行列、合并单元格、行列分组、冻结等布局信息。 |
|
|
88
|
+
| [Lark Sheet Workbook](references/lark-sheets-workbook.md) | 查看飞书表格的工作簿结构(`+workbook-info` 子表列表及元数据)与当前 revision(`+revision-get`)。当用户提到"看看这个表格有什么"、"表格结构"、"有哪些 sheet"、"当前版本号"时使用。 |
|
|
89
|
+
| [Lark Sheet Changeset](references/lark-sheets-changeset.md) | 读取两个版本(CS revision)之间的 changeset(原始变更操作清单,`+changeset-get`),用于复核某次编辑——尤其是 AI 编辑——是否真实满足用户诉求。当用户需要"看看这次改了什么"、"核对 AI 改动"、"对比两个版本的变更"时使用。 |
|
|
90
|
+
| [Lark Sheet History](references/lark-sheets-history.md) | 查询飞书表格的历史版本列表(`+history-list`)与回滚任务的异步状态(`+history-revert-status`)。当用户需要查看一张表的编辑历史版本列表、或查询某次回滚的进行中/成功/失败状态时使用。 |
|
|
91
|
+
| [Lark Sheet Formula Verify](references/lark-sheets-formula-verify.md) | 公式健康自检入口(`+formula-verify`)。对指定子表(或整本工作簿)扫描公式与单元格值,聚合所有 Excel 错误(#REF! / #DIV/0! / #VALUE! / #NAME? / #NULL! / #NUM! / #N/A)与编译失败清单,输出统一 JSON。需要核对一张表里公式是否零错误时使用。 |
|
|
92
|
+
| [Lark Sheet Chart](references/lark-sheets-chart.md) | 查看飞书表格中已有图表的配置(`+chart-list`):类型、数据源、样式。 |
|
|
93
|
+
| [Lark Sheet Pivot Table](references/lark-sheets-pivot-table.md) | 查看飞书表格中已有数据透视表的配置(`+pivot-list`):结构、数据源、展开后的占用区域与状态。 |
|
|
94
|
+
| [Lark Sheet Conditional Format](references/lark-sheets-conditional-format.md) | 查看飞书表格中已有条件格式规则的配置(`+cond-format-list`):规则类型、范围、样式。 |
|
|
95
|
+
| [Lark Sheet Filter](references/lark-sheets-filter.md) | 查看飞书表格中已有筛选器(filter)的配置(`+filter-list`):范围、规则、条件。 |
|
|
96
|
+
| [Lark Sheet Filter View](references/lark-sheets-filter-view.md) | 查看飞书表格中已有筛选视图(filter view)的配置(`+filter-view-list`):视图名、范围、规则。 |
|
|
97
|
+
| [Lark Sheet Sparkline](references/lark-sheets-sparkline.md) | 查看飞书表格中已有迷你图组的配置(`+sparkline-list`):类型、数据源、样式。 |
|
|
98
|
+
| [Lark Sheet Float Image](references/lark-sheets-float-image.md) | 查看飞书表格中已有浮动图片的配置(`+float-image-list`):位置、大小、层级。 |
|
|
99
|
+
|
|
100
|
+
## 公共 flag 速查
|
|
101
|
+
|
|
102
|
+
各 reference 的每个 shortcut 标题下用一行徽章标注该 shortcut 支持的公共 / 系统 flag,例如:
|
|
103
|
+
|
|
104
|
+
- `_公共四件套 · 系统:--dry-run_` — URL/token + sheet 定位(两组各**必给一个**,详见下方「公共 flag」),加 `--dry-run`
|
|
105
|
+
- `_公共:URL/token(无 sheet 定位) · 系统:--dry-run_` — 只接 URL/token,常见于 `+workbook-info` / `+revision-get` / `+changeset-get` / `+history-list` 等不强制 sheet 定位的 shortcut
|
|
106
|
+
|
|
107
|
+
徽章里只列名字。type / 必填 / 描述都在本段统一声明:
|
|
108
|
+
|
|
109
|
+
### 公共 flag(定位资源)
|
|
110
|
+
|
|
111
|
+
**公共四件套** = `--url` / `--spreadsheet-token` / `--sheet-id` / `--sheet-name`,分成两组 XOR,**每组都必须给且只能给一个**(XOR = 二选一必填,不是"可选"):
|
|
112
|
+
|
|
113
|
+
1. **spreadsheet 定位(必填)**:`--url` 与 `--spreadsheet-token` 二选一,**必须给其中之一**。两个都不给 → 校验报错 `specify at least one of --url or --spreadsheet-token`;两个都给 → 互斥冲突。
|
|
114
|
+
- **`--url` 解析 `/sheets/`、`/spreadsheets/` 与 `/wiki/` 三种链接**(从路径里抽出 token;也可以直接把裸 token 传给 `--spreadsheet-token`)。其它形态的链接不会被解析成表格 token。
|
|
115
|
+
- **`/wiki/` 知识库链接可直接传 `--url`**:会自动定位到链接背后的电子表格;若该链接背后不是电子表格(而是文档 / 多维表格等),则报错。
|
|
116
|
+
2. **sheet 定位(公共四件套 shortcut 必填)**:`--sheet-id` 与 `--sheet-name` 二选一,**必须给其中之一**。两个都不给 → 校验报错 `specify at least one of --sheet-id or --sheet-name`。
|
|
117
|
+
- ⚠️ **不确定 sheet 名时禁止直接猜 `Sheet1`**:除非用户对话明确说出 sheet 名 / id,或上下文(之前的工具调用 / URL 锚点 `?sheet=xxx`)已经出现过具体值,否则**第一步先调 `+workbook-info --url "..."`**(或 `--spreadsheet-token`)拿 `sheets[].sheet_id` / `sheets[].title` 列表再选。中文环境下子表常叫"数据" / "Sheet"(无数字)/ "工作表 1" / 业务名,猜 `Sheet1` 大概率撞 `sheet not found`。
|
|
118
|
+
- ⚠️ **`--range` 里的 `Sheet1!` 前缀不能替代 sheet 定位**:即使写了 `--range 'Sheet1!A1:B2'`,仍**必须**额外传 `--sheet-id` 或 `--sheet-name`,否则照样报上面的错。
|
|
119
|
+
- ⚠️ **A1 reference 含 `!`**(`--range`)**:整段用单引号包裹**,如 `--range 'Sheet1!A1:B2'`——单引号能挡住 bash 的 history expansion(`!` 被拦成 `event not found`;双引号挡不住;别改用 `set +H`)。sheet 名含特殊字符(`-` / 空格 / 非 ASCII)需在内部按 A1 标准再包一层单引号时,用 `'\''` 转义保持外层单引号。
|
|
120
|
+
- **例外**:徽章标为 `_公共:URL/token(无 sheet 定位)…_` 的 shortcut(如 `+workbook-info` / `+revision-get` / `+changeset-get` / `+history-list` / `+history-revert-status`)**不接受也不需要** sheet 定位,只给一组 spreadsheet 定位即可。`+table-get` 的 `--sheet-id` / `--sheet-name` 可选(省略读全部子表)。
|
|
121
|
+
|
|
122
|
+
| Flag | Type | 必填 | 说明 |
|
|
123
|
+
| --- | --- | --- | --- |
|
|
124
|
+
| `--url` | string | 二选一必填(与 `--spreadsheet-token`) | spreadsheet 或 wiki URL |
|
|
125
|
+
| `--spreadsheet-token` | string | 二选一必填(与 `--url`) | spreadsheet token |
|
|
126
|
+
| `--sheet-id` | string | 二选一必填(与 `--sheet-name`;仅公共四件套 shortcut) | 工作表 reference_id |
|
|
127
|
+
| `--sheet-name` | string | 二选一必填(与 `--sheet-id`;仅公共四件套 shortcut) | 工作表名称 |
|
|
128
|
+
|
|
129
|
+
**统一调用范式**(公共四件套 shortcut 的所有示例都遵循此形状,两组定位缺一不可):
|
|
130
|
+
|
|
131
|
+
```bash
|
|
132
|
+
lark-cli sheets <shortcut> <workbook 定位> <sheet 定位> <其它 flag>
|
|
133
|
+
# workbook 定位:--url "..." 或 --spreadsheet-token "..." (二选一,必给)
|
|
134
|
+
# sheet 定位: --sheet-id "$SID" 或 --sheet-name "<真实表名>" (二选一,必给;占位符不要原样填)
|
|
135
|
+
# 例:lark-cli sheets +csv-get --url "https://.../sheets/shtXXX" --sheet-name "<真实表名>" --range "A1:F30"
|
|
136
|
+
# 注意:真实表名不要直接填 "Sheet1"——大多数表的子表不叫这个;先 +workbook-info 拿 sheets[].title 再代入。
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### 系统 flag
|
|
140
|
+
|
|
141
|
+
| Flag | Type | 必填 | 说明 |
|
|
142
|
+
| --- | --- | --- | --- |
|
|
143
|
+
| `--dry-run` | bool | 否 | 零副作用:仅打印请求路径与参数模板,不发起调用 |
|
|
144
|
+
| `--yes` | bool | 是(仅 `high-risk-write`) | 二次确认;不带时退出码 10,需重新带 `--yes` 确认高风险写操作 |
|
|
145
|
+
|
|
146
|
+
- **envelope**:所有 shortcut 返回统一外层结构 `{ok, identity, data, ...}`。正文里 `envelope.data` 指业务数据层(如 `+csv-get` 的 `annotated_csv`)。
|
|
147
|
+
|
|
148
|
+
## API(沙箱内仅以下原生 API 调用可用)
|
|
149
|
+
|
|
150
|
+
绝大多数只读需求都被上面的 shortcut 覆盖;shortcut 没覆盖到时,**仅**以下原生 `<service> <resource> <method>` 组合在本沙箱内可用,不要再自行拼其它 service/api 组合去试:
|
|
151
|
+
|
|
152
|
+
### spreadsheets
|
|
153
|
+
|
|
154
|
+
- `get` — 读取电子表格的元数据(等价于 `+workbook-info` 的底层调用)
|
|
155
|
+
|
|
156
|
+
```bash
|
|
157
|
+
lark-cli sheets spreadsheets get
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
### spreadsheet.sheets
|
|
161
|
+
|
|
162
|
+
- `find` — 在电子表格里查找单元格(等价于 `+cells-search` 的底层调用)
|
|
163
|
+
|
|
164
|
+
```bash
|
|
165
|
+
lark-cli sheets spreadsheet.sheets find
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
### spreadsheet.sheet.filters
|
|
169
|
+
|
|
170
|
+
- `get` — 读取某个子表的筛选器信息(等价于 `+filter-list` 的底层调用)
|
|
171
|
+
|
|
172
|
+
```bash
|
|
173
|
+
lark-cli sheets spreadsheet.sheet.filters get
|
|
174
|
+
```
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
# Lark Sheet Changeset
|
|
2
|
+
|
|
3
|
+
## 使用场景
|
|
4
|
+
|
|
5
|
+
读取两个版本之间的 **changeset(变更操作清单)**,用于**复核某次编辑(尤其是 AI 编辑)是否真实满足用户诉求**。
|
|
6
|
+
|
|
7
|
+
典型场景:AI agent 对表格做了一批编辑后,想确认它"说做的"和"真正落到表格上的"是否一致——拉取编辑前版本到编辑后版本之间的 changeset,逐条核对 action 是否覆盖了用户要求的修改、有没有多改 / 漏改。
|
|
8
|
+
|
|
9
|
+
## 版本(revision)语义
|
|
10
|
+
|
|
11
|
+
- 这里的"版本"指表格的 **CS revision**(每次提交单调递增的修订号),不是文档历史里的命名版本。
|
|
12
|
+
- `--start-revision` 是复核基线,即你认定的"编辑前"版本。
|
|
13
|
+
- `--end-revision` 是"编辑后"版本;**省略时默认取最新 revision**,返回从 start 到最新的全部 changeset。
|
|
14
|
+
- **版本差上限 20**:`end - start + 1 ≤ 20`,超出会被拒绝(服务端同样以 20 兜底)。复核大跨度变更时请分段拉取。
|
|
15
|
+
|
|
16
|
+
## Shortcuts
|
|
17
|
+
|
|
18
|
+
| Shortcut | Risk | 分组 |
|
|
19
|
+
| --- | --- | --- |
|
|
20
|
+
| `+changeset-get` | read | 变更记录 |
|
|
21
|
+
|
|
22
|
+
## Flags
|
|
23
|
+
|
|
24
|
+
### `+changeset-get`
|
|
25
|
+
|
|
26
|
+
_公共:URL/token(无 sheet 定位)_
|
|
27
|
+
|
|
28
|
+
| Flag | Type | 必填 | 说明 |
|
|
29
|
+
| --- | --- | --- | --- |
|
|
30
|
+
| `--start-revision` | int | required | 起始版本(编辑前基线,>= 1) |
|
|
31
|
+
| `--end-revision` | int | optional | 结束版本(省略取最新) |
|
|
32
|
+
|
|
33
|
+
## 返回结构
|
|
34
|
+
|
|
35
|
+
返回一个 JSON 对象,`changesets` 数组按版本顺序排列,每个元素是一次提交的**原始 action 列表**与元信息:
|
|
36
|
+
|
|
37
|
+
```json
|
|
38
|
+
{
|
|
39
|
+
"spreadsheet_token": "shtcnXXXX",
|
|
40
|
+
"latest_revision": 142,
|
|
41
|
+
"start_revision": 120,
|
|
42
|
+
"end_revision": 135,
|
|
43
|
+
"changesets": [
|
|
44
|
+
{
|
|
45
|
+
"revision": 121,
|
|
46
|
+
"create_time": "2026-06-12T10:00:00Z",
|
|
47
|
+
"actions": [
|
|
48
|
+
{ "action": "setCellRange", "sheetId": "...", "value": { /* ... */ } }
|
|
49
|
+
],
|
|
50
|
+
"is_self_edit": false,
|
|
51
|
+
"is_ai_edit": true
|
|
52
|
+
}
|
|
53
|
+
]
|
|
54
|
+
}
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
- 最外层 `latest_revision` 是**当前表格的最新版本号**(与查询区间无关),便于判断表格当前停在哪个版本、`--start-revision` 该取多少。
|
|
58
|
+
- `actions` 是**未经语义渲染的原始操作对象**,按提交内的执行顺序排列。复核时逐条比对:每个 action 改了哪个 sheet、哪个区域、改成什么,是否对应用户的诉求。
|
|
59
|
+
- `revision` / `create_time` 用于判断"这次改动属于哪个版本、什么时候做的"。
|
|
60
|
+
- `is_self_edit` 表示该 changeset 是否由当前请求用户提交(committer 与请求用户相同),即"是不是我自己提交的编辑"。
|
|
61
|
+
- `is_ai_edit` 表示该 changeset 是否由 AI 客户端提交(`member_id` 为 10 / 11)。复核时 `is_ai_edit=true` 即为 AI 写入的编辑(而非用户手动编辑),是核对 AI 是否完成诉求的主要对象。
|
|
62
|
+
|
|
63
|
+
## 复核工作流(判断 AI 是否真实完成诉求)
|
|
64
|
+
|
|
65
|
+
1. 记下 AI 开始编辑前的 revision(编辑前 `+workbook-info` 或上一次工具返回的 revision 即可作为 `--start-revision`)。
|
|
66
|
+
2. AI 编辑完成后,跑 `+changeset-get --url <表格> --start-revision <编辑前版本>`(不传 end → 取到最新)。
|
|
67
|
+
3. 遍历 `changesets[].actions`,核对:
|
|
68
|
+
- 用户要求的每一处修改是否都有对应 action;
|
|
69
|
+
- 有没有越权 / 多余的修改(动了用户没让动的 sheet / 区域);
|
|
70
|
+
- action 的目标区域、值是否与诉求一致。
|
|
71
|
+
4. 若版本跨度可能 > 20,分段拉取(如 `start..start+19`、`start+20..` …)。
|
|
72
|
+
|
|
73
|
+
## 注意
|
|
74
|
+
|
|
75
|
+
- `+changeset-get` 是**只读**操作,不改动表格。
|
|
76
|
+
- 大跨度 / 大批量编辑的 changeset 可能体积较大;输出在传输层已 gzip。必要时缩小版本区间。
|
|
77
|
+
- 该工具走只读 scope `sheets:spreadsheet:read`,需要对表格有查看权限。
|
|
78
|
+
|
|
79
|
+
## Examples
|
|
80
|
+
|
|
81
|
+
### `+changeset-get`
|
|
82
|
+
|
|
83
|
+
公共:`--url` / `--spreadsheet-token`(二选一,无 sheet 定位)。changeset 是工作簿级历史,不接受 sheet 定位 flag。
|
|
84
|
+
|
|
85
|
+
示例:
|
|
86
|
+
|
|
87
|
+
```bash
|
|
88
|
+
# 只传起始版本 → 返回从该版本到最新的全部 changeset(最常用:复核 AI 编辑前后的差异)
|
|
89
|
+
lark-cli sheets +changeset-get --url "https://example.feishu.cn/sheets/shtXXX" --start-revision 120
|
|
90
|
+
|
|
91
|
+
# 传起始 + 结束版本(版本差 end-start+1 ≤ 20)
|
|
92
|
+
lark-cli sheets +changeset-get --spreadsheet-token shtXXX --start-revision 120 --end-revision 135
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
输出契约(envelope.data):
|
|
96
|
+
|
|
97
|
+
- `latest_revision` — 当前表格最新版本号(与查询区间无关)
|
|
98
|
+
- `start_revision` / `end_revision` — 实际查询区间(省略 `--end-revision` 时 `end_revision` = 最新版本)
|
|
99
|
+
- `changesets[]` — 按版本顺序排列;每项含 `revision` / `create_time` / `actions`(原始操作列表)/ `is_self_edit` / `is_ai_edit`
|
|
100
|
+
|
|
101
|
+
### Validate / DryRun / Execute 约束
|
|
102
|
+
|
|
103
|
+
- `Validate` 阶段只做 XOR 检查(`--url` / `--spreadsheet-token` 二选一)与版本上限校验(`--start-revision ≥ 1`,传了 `--end-revision` 时 `end ≥ start` 且 `end - start + 1 ≤ 20`);**禁止**联网。
|
|
104
|
+
- `DryRun` 输出请求模板,不实际拉取 changeset。
|
|
105
|
+
- `Execute` 阶段才发起 changeset 查询;省略 `--end-revision` 时由服务端解析为最新 revision。
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# Lark Sheet Chart
|
|
2
|
+
|
|
3
|
+
## 使用场景
|
|
4
|
+
|
|
5
|
+
查看飞书表格中已有图表对象的配置。本 reference 覆盖 1 个只读 shortcut:
|
|
6
|
+
|
|
7
|
+
| 操作需求 | 使用工具 | 说明 |
|
|
8
|
+
|---------|---------|------|
|
|
9
|
+
| 查看已有图表 | `+chart-list` | 获取图表的类型、数据源和样式配置;传 `--only-thumbnail` 获取渲染缩略图 |
|
|
10
|
+
|
|
11
|
+
> **跨 sheet 提示**:图表可能分布在多个子表;先 `+workbook-info` 掌握全局,再按子表 `+chart-list`。
|
|
12
|
+
|
|
13
|
+
## Shortcuts
|
|
14
|
+
|
|
15
|
+
| Shortcut | Risk | 分组 |
|
|
16
|
+
| --- | --- | --- |
|
|
17
|
+
| `+chart-list` | read | 对象 |
|
|
18
|
+
|
|
19
|
+
## Flags
|
|
20
|
+
|
|
21
|
+
### `+chart-list`
|
|
22
|
+
|
|
23
|
+
_公共四件套 · 系统:`--dry-run`_
|
|
24
|
+
|
|
25
|
+
| Flag | Type | 必填 | 说明 |
|
|
26
|
+
| --- | --- | --- | --- |
|
|
27
|
+
| `--chart-id` | string | optional | 指定单个图表 reference_id 过滤 |
|
|
28
|
+
| `--only-thumbnail` | bool | optional | 仅返回图表渲染缩略图,不返回 snapshot 配置;图片字节位于 details.thumbnail.base64(不含 data: 前缀) |
|
|
29
|
+
|
|
30
|
+
## Examples
|
|
31
|
+
|
|
32
|
+
公共四件套:`--url` / `--spreadsheet-token` / `--sheet-id` / `--sheet-name`(前两者 XOR,后两者 XOR)。
|
|
33
|
+
|
|
34
|
+
### `+chart-list`
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
lark-cli sheets +chart-list --url "https://example.feishu.cn/sheets/shtXXX" --sheet-id "$SID"
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
输出契约:默认返回按工作表分组的图表列表,每个图表含 `chart_id` / `position` / `details.snapshot` 等;传 `--only-thumbnail` 时返回渲染缩略图。
|
|
41
|
+
|
|
42
|
+
### Validate / DryRun / Execute 约束
|
|
43
|
+
|
|
44
|
+
- `Validate`:XOR 公共四件套。
|
|
45
|
+
- `DryRun`:输出请求模板,零网络副作用。
|
|
46
|
+
- `Execute`:发起图表列表查询。
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# Lark Sheet Conditional Format
|
|
2
|
+
|
|
3
|
+
## 使用场景
|
|
4
|
+
|
|
5
|
+
查看飞书表格中已有条件格式规则的配置。本 reference 覆盖 1 个只读 shortcut:
|
|
6
|
+
|
|
7
|
+
| 操作需求 | 使用工具 | 说明 |
|
|
8
|
+
|---------|---------|------|
|
|
9
|
+
| 查看已有条件格式 | `+cond-format-list` | 获取规则类型、范围和样式配置 |
|
|
10
|
+
|
|
11
|
+
## Shortcuts
|
|
12
|
+
|
|
13
|
+
| Shortcut | Risk | 分组 |
|
|
14
|
+
| --- | --- | --- |
|
|
15
|
+
| `+cond-format-list` | read | 对象 |
|
|
16
|
+
|
|
17
|
+
## Flags
|
|
18
|
+
|
|
19
|
+
### `+cond-format-list`
|
|
20
|
+
|
|
21
|
+
_公共四件套 · 系统:`--dry-run`_
|
|
22
|
+
|
|
23
|
+
| Flag | Type | 必填 | 说明 |
|
|
24
|
+
| --- | --- | --- | --- |
|
|
25
|
+
| `--rule-id` | string | optional | 按规则 id 过滤 |
|
|
26
|
+
|
|
27
|
+
## Examples
|
|
28
|
+
|
|
29
|
+
公共四件套:所有 shortcut 顶部排列 `--url` / `--spreadsheet-token` / `--sheet-id` / `--sheet-name`(XOR)。
|
|
30
|
+
|
|
31
|
+
### `+cond-format-list`
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
# 列出当前 sheet 全部条件格式规则(含 rule_id、rule_type、范围与样式)
|
|
35
|
+
lark-cli sheets +cond-format-list --url "..." --sheet-id "$SID"
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
### Validate / DryRun / Execute 约束
|
|
39
|
+
|
|
40
|
+
- `Validate`:XOR 公共四件套。
|
|
41
|
+
- `DryRun`:输出请求模板,零网络副作用。
|
|
42
|
+
- `Execute`:发起条件格式列表查询。
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# Lark Sheet Filter View
|
|
2
|
+
|
|
3
|
+
## 概念回顾
|
|
4
|
+
|
|
5
|
+
筛选视图是 sheet 内的多份独立筛选配置,每个视图持有自己的 `range` 和 `rules`,由独立 `view_id`(10 位随机字符串)标识。一个 sheet 可有多个视图,视图的隐藏行仅在用户进入该视图时本地生效,不影响其他协作者,也不与该 sheet 上可能并存的筛选器(filter)互相影响。
|
|
6
|
+
|
|
7
|
+
## 使用场景
|
|
8
|
+
|
|
9
|
+
查看飞书表格中已有筛选视图对象的配置。本 reference 覆盖 1 个只读 shortcut:
|
|
10
|
+
|
|
11
|
+
| 操作需求 | 使用工具 | 说明 |
|
|
12
|
+
|---------|---------|------|
|
|
13
|
+
| 查看已有筛选视图 | `+filter-view-list` | 获取 sheet 上所有视图(视图名、范围、规则) |
|
|
14
|
+
|
|
15
|
+
## Shortcuts
|
|
16
|
+
|
|
17
|
+
| Shortcut | Risk | 分组 |
|
|
18
|
+
| --- | --- | --- |
|
|
19
|
+
| `+filter-view-list` | read | 对象 |
|
|
20
|
+
|
|
21
|
+
## Flags
|
|
22
|
+
|
|
23
|
+
### `+filter-view-list`
|
|
24
|
+
|
|
25
|
+
_公共四件套 · 系统:`--dry-run`_
|
|
26
|
+
|
|
27
|
+
| Flag | Type | 必填 | 说明 |
|
|
28
|
+
| --- | --- | --- | --- |
|
|
29
|
+
| `--view-id` | string | optional | 按筛选视图 reference_id 过滤(命中即只返回单个视图) |
|
|
30
|
+
|
|
31
|
+
## Examples
|
|
32
|
+
|
|
33
|
+
公共四件套:所有 shortcut 顶部排列 `--url` / `--spreadsheet-token` / `--sheet-id` / `--sheet-name`(XOR)。`view_id` 是 10 位随机字符串,每个 sheet 可有多个视图。
|
|
34
|
+
|
|
35
|
+
### `+filter-view-list`
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
# 列出某个 sheet 的全部筛选视图
|
|
39
|
+
lark-cli sheets +filter-view-list --url "..." --sheet-id "$SID"
|
|
40
|
+
|
|
41
|
+
# 按 view_id 精确定位
|
|
42
|
+
lark-cli sheets +filter-view-list --url "..." --sheet-id "$SID" --view-id vAbcde1234
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### Validate / DryRun / Execute 约束
|
|
46
|
+
|
|
47
|
+
- `Validate`:XOR 公共四件套。
|
|
48
|
+
- `DryRun`:输出请求模板,零网络副作用;`--sheet-name` 在 dry-run 输出里生成为 `<resolve:Sheet1>` 占位符。
|
|
49
|
+
- `Execute`:发起筛选视图查询(返回各视图的 range + rules)。
|
|
50
|
+
|
|
51
|
+
> ⚠️ **"不等于"在筛选视图里存不住**:`text.notEquals` / `multiValue.notEqual` 会被服务端归一成 multiValue 值集合,被排除的值没有换算成要保留的值集合,最终存下来是空值集合,视图不筛任何行。回读也不能作为验收依据:`+filter-view-list` 会把请求里的条件原样回显一段时间(之后翻成 `compare_type: equal, values: []`)。其余 compare_type(`doesNotContain` / `doesNotBeginWith` / `doesNotEndWith` / `number.notEqual` / `equals` 等)都能正常持久化。
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# Lark Sheet Filter
|
|
2
|
+
|
|
3
|
+
## 使用场景
|
|
4
|
+
|
|
5
|
+
查看飞书表格中已有筛选器(filter)对象的配置。本 reference 覆盖 1 个只读 shortcut:
|
|
6
|
+
|
|
7
|
+
| 操作需求 | 使用工具 | 说明 |
|
|
8
|
+
|---------|---------|------|
|
|
9
|
+
| 查看已有筛选器 | `+filter-list` | 获取筛选器的范围、规则和条件配置 |
|
|
10
|
+
|
|
11
|
+
> 每个工作表至多一个筛选器,`filter_id` 等于该工作表的 `sheet_id`。
|
|
12
|
+
|
|
13
|
+
## Shortcuts
|
|
14
|
+
|
|
15
|
+
| Shortcut | Risk | 分组 |
|
|
16
|
+
| --- | --- | --- |
|
|
17
|
+
| `+filter-list` | read | 对象 |
|
|
18
|
+
|
|
19
|
+
## Flags
|
|
20
|
+
|
|
21
|
+
### `+filter-list`
|
|
22
|
+
|
|
23
|
+
_公共四件套 · 系统:`--dry-run`_
|
|
24
|
+
|
|
25
|
+
_仅含公共 / 系统 flag。_
|
|
26
|
+
|
|
27
|
+
## Examples
|
|
28
|
+
|
|
29
|
+
公共四件套:所有 shortcut 顶部排列 `--url` / `--spreadsheet-token` / `--sheet-id` / `--sheet-name`(XOR)。`filter_id` 等同于 `sheet_id`(每个工作表至多一个筛选器)。
|
|
30
|
+
|
|
31
|
+
### `+filter-list`
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
# 查看当前 sheet 的筛选器配置(filter_id 等于 sheet_id)
|
|
35
|
+
lark-cli sheets +filter-list --url "..." --sheet-id "$SID"
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
### Validate / DryRun / Execute 约束
|
|
39
|
+
|
|
40
|
+
- `Validate`:XOR 公共四件套。
|
|
41
|
+
- `DryRun`:输出请求模板,零网络副作用。
|
|
42
|
+
- `Execute`:发起筛选器查询(返回当前筛选条件 + 已过滤行数)。
|