@wagemule/daemon 0.1.2 → 0.1.4

package/dist/skills/larksuite/lark-sheets/references/lark-sheets-row-column-management.md

@@ -0,0 +1,151 @@
+# Sheets Row and Column Management
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+这份 reference 汇总行列结构操作：
+
+- `+add-dimension`
+- `+insert-dimension`
+- `+update-dimension`
+- `+move-dimension`
+- `+delete-dimension`
+
+<a id="add-dimension"></a>
+## `+add-dimension`
+
+对应命令：`lark-cli sheets +add-dimension`
+
+在工作表末尾追加空行或空列，不影响已有数据。
+
+```bash
+lark-cli sheets +add-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS --length 10
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--dimension` | 是 | `ROWS` 或 `COLUMNS` |
+| `--length` | 是 | 追加数量（1-5000） |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：`addCount`、`majorDimension`
+
+<a id="insert-dimension"></a>
+## `+insert-dimension`
+
+对应命令：`lark-cli sheets +insert-dimension`
+
+在指定位置插入空行或空列，已有数据向下或向右移动。
+
+```bash
+lark-cli sheets +insert-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS --start-index 3 --end-index 7
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--dimension` | 是 | `ROWS` 或 `COLUMNS` |
+| `--start-index` | 是 | 起始位置（0-indexed） |
+| `--end-index` | 是 | 结束位置（0-indexed，不含） |
+| `--inherit-style` | 否 | `BEFORE` 或 `AFTER` |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：成功时 `data` 为空对象 `{}`
+
+<a id="update-dimension"></a>
+## `+update-dimension`
+
+对应命令：`lark-cli sheets +update-dimension`
+
+更新指定范围行/列的显隐状态和行高/列宽。
+
+```bash
+lark-cli sheets +update-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS --start-index 1 --end-index 3 \
+  --visible=false
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--dimension` | 是 | `ROWS` 或 `COLUMNS` |
+| `--start-index` | 是 | 起始位置（**1-indexed**，含） |
+| `--end-index` | 是 | 结束位置（**1-indexed**，含） |
+| `--visible` | 否 | `--visible=true` 或 `--visible=false` |
+| `--fixed-size` | 否 | 行高或列宽（像素） |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：成功时 `data` 为空对象 `{}`
+
+<a id="move-dimension"></a>
+## `+move-dimension`
+
+对应命令：`lark-cli sheets +move-dimension`
+
+将指定范围的行/列移动到目标位置。
+
+```bash
+lark-cli sheets +move-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS \
+  --start-index 0 --end-index 1 --destination-index 4
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--dimension` | 是 | `ROWS` 或 `COLUMNS` |
+| `--start-index` | 是 | 源起始位置（0-indexed） |
+| `--end-index` | 是 | 源结束位置（0-indexed，含） |
+| `--destination-index` | 是 | 目标位置（0-indexed） |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：成功时 `data` 为空对象 `{}`
+
+<a id="delete-dimension"></a>
+## `+delete-dimension`
+
+对应命令：`lark-cli sheets +delete-dimension`
+
+删除指定范围的行或列。
+
+```bash
+lark-cli sheets +delete-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS --start-index 3 --end-index 7
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--dimension` | 是 | `ROWS` 或 `COLUMNS` |
+| `--start-index` | 是 | 起始位置（**1-indexed**，含） |
+| `--end-index` | 是 | 结束位置（**1-indexed**，含） |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：`delCount`、`majorDimension`
+
+## 参考
+
+- [spreadsheet-management](lark-sheets-spreadsheet-management.md#info) — 查看当前工作表信息
+- [cell-style-and-merge](lark-sheets-cell-style-and-merge.md) — 调整样式或合并单元格

package/dist/skills/larksuite/lark-sheets/references/lark-sheets-sheet-management.md

@@ -0,0 +1,164 @@
+# Sheets Sheet Management
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+这份 reference 汇总工作表级操作：
+
+- `+create-sheet`
+- `+copy-sheet`
+- `+delete-sheet`
+- `+update-sheet`
+
+其中 `+create-sheet` / `+copy-sheet` / `+delete-sheet` 底层封装官方“操作工作表（operate-sheets）”接口；`+update-sheet` 封装“更新工作表属性”接口。
+
+<a id="create-sheet"></a>
+## `+create-sheet`
+
+对应命令：`lark-cli sheets +create-sheet`
+
+```bash
+# 在表格末尾或服务端默认位置创建工作表
+lark-cli sheets +create-sheet --spreadsheet-token "shtxxxxxxxx" \
+  --title "明细"
+
+# 指定插入位置（0-based）
+lark-cli sheets +create-sheet --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --title "汇总" --index 0
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--title` | 否 | 工作表标题，最长 100 字符，不能包含 `/ \ ? * [ ] :` |
+| `--index` | 否 | 工作表位置（从 0 开始） |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：
+
+- `spreadsheet_token`
+- `sheet.sheet_id`
+- `sheet.title`
+- `sheet.index`
+
+<a id="copy-sheet"></a>
+## `+copy-sheet`
+
+对应命令：`lark-cli sheets +copy-sheet`
+
+```bash
+# 按默认位置复制
+lark-cli sheets +copy-sheet --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>"
+
+# 指定副本名称和位置
+lark-cli sheets +copy-sheet --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --title "销售副本" --index 2
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 源工作表 ID |
+| `--title` | 否 | 新工作表标题，最长 100 字符，不能包含 `/ \ ? * [ ] :` |
+| `--index` | 否 | 新工作表位置（从 0 开始） |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+说明：
+
+- 传 `--index` 时，CLI 会先复制，再追加一次位置更新，把副本移动到目标索引
+
+输出：
+
+- `spreadsheet_token`
+- `sheet.sheet_id`
+- `sheet.title`
+- `sheet.index`
+
+<a id="delete-sheet"></a>
+## `+delete-sheet`
+
+对应命令：`lark-cli sheets +delete-sheet`
+
+> [!CAUTION]
+> 这是**高风险删除操作**。CLI 会要求显式确认；可以先用 `--dry-run` 预览。
+
+```bash
+lark-cli sheets +delete-sheet --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>"
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 要删除的工作表 ID |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：
+
+- `deleted`
+- `spreadsheet_token`
+- `sheet_id`
+
+<a id="update-sheet"></a>
+## `+update-sheet`
+
+对应命令：`lark-cli sheets +update-sheet`
+
+用于更新工作表标题、位置、隐藏状态、冻结行列和保护设置。
+
+```bash
+# 改名 + 调整冻结
+lark-cli sheets +update-sheet --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --title "汇总表" --frozen-row-count 2 --frozen-col-count 1
+
+# 隐藏工作表
+lark-cli sheets +update-sheet --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --hidden=true
+
+# 开启保护并授权额外编辑人
+lark-cli sheets +update-sheet --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --lock LOCK --lock-info "仅财务维护" \
+  --user-id-type open_id --user-ids '["ou_xxx","ou_yyy"]'
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 要更新的工作表 ID |
+| `--title` | 否 | 新标题，最长 100 字符，不能包含 `/ \ ? * [ ] :` |
+| `--index` | 否 | 新位置（从 0 开始） |
+| `--hidden` | 否 | `--hidden=true` 隐藏，`--hidden=false` 取消隐藏 |
+| `--frozen-row-count` | 否 | 冻结行数，`0` 表示取消冻结 |
+| `--frozen-col-count` | 否 | 冻结列数，`0` 表示取消冻结 |
+| `--lock` | 否 | 保护模式：`LOCK` / `UNLOCK` |
+| `--lock-info` | 否 | 保护备注；要求 `--lock LOCK` |
+| `--user-id-type` | 否 | `--user-ids` 的 ID 类型：`open_id` / `union_id` / `lark_id` / `user_id` |
+| `--user-ids` | 否 | 额外可编辑用户 ID 的 JSON 数组；要求 `--lock LOCK` |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：
+
+- `spreadsheet_token`
+- `sheet.sheet_id`
+- `sheet.title`
+- `sheet.hidden`
+- `sheet.grid_properties.frozen_row_count`
+- `sheet.grid_properties.frozen_column_count`
+- `sheet.protect`
+
+## 参考
+
+- [spreadsheet-management](lark-sheets-spreadsheet-management.md#info) — 先获取 `sheet_id`
+- [row-column-management](lark-sheets-row-column-management.md) — 需要改行列结构时用这组命令

package/dist/skills/larksuite/lark-sheets/references/lark-sheets-spreadsheet-management.md

@@ -0,0 +1,134 @@
+# Sheets Spreadsheet Management
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+这份 reference 汇总电子表格对象级操作：
+
+- `+create`：创建电子表格
+- `+info`：查看电子表格和工作表信息
+- `+export`：导出电子表格
+
+<a id="create"></a>
+## `+create`
+
+对应命令：`lark-cli sheets +create`
+
+特性：
+
+- 一步创建表格并返回 URL
+- 可选 `--headers/--data` 在创建后自动写入第一个工作表的 A1 开始
+- `--as bot` 创建成功后，CLI 会尝试为当前 CLI 用户自动授予 `full_access`
+
+```bash
+# 只创建表格
+lark-cli sheets +create --title "仓库管理营收报表"
+
+# 创建并写入表头 + 初始数据
+lark-cli sheets +create --title "仓库管理营收报表" \
+  --headers '["仓库","统计月份","入库金额","出库金额","销售收入","毛利率"]' \
+  --data '[["华东一仓","2026-03",125000,98000,168000,"41.7%"]]'
+
+# 创建到指定文件夹
+lark-cli sheets +create --title "测试表" --folder-token "fldbc_xxx"
+
+# 仅预览请求
+lark-cli sheets +create --title "测试表" --dry-run
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--title` | 是 | 表格标题 |
+| `--folder-token` | 否 | 创建到指定文件夹 |
+| `--headers` | 否 | 一维数组 JSON，作为表头写入 |
+| `--data` | 否 | 二维数组 JSON，作为初始数据写入 |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：
+
+- `spreadsheet_token`
+- `title`
+- `url`
+- `permission_grant`（仅 `--as bot` 时返回）
+
+<a id="info"></a>
+## `+info`
+
+对应命令：`lark-cli sheets +info`
+
+用于：
+
+- 从表格 URL / token 获取 `spreadsheet_token`
+- 列出工作表的 `sheet_id`、标题、行列数、冻结状态等信息
+
+```bash
+# 传 URL（支持 wiki URL）
+lark-cli sheets +info --url "https://example.larksuite.com/sheets/shtxxxxxxxx"
+
+# 传 spreadsheet_token
+lark-cli sheets +info --spreadsheet-token "shtxxxxxxxx"
+
+# 仅预览请求
+lark-cli sheets +info --url "https://..." --dry-run
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一；支持 wiki URL） |
+| `--spreadsheet-token` | 否 | 电子表格 token |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：
+
+- `spreadsheet.spreadsheet.token`
+- `spreadsheet.spreadsheet.url`
+- `sheets.sheets[]`
+
+<a id="export"></a>
+## `+export`
+
+对应命令：`lark-cli sheets +export`
+
+特性：
+
+- 创建导出任务并轮询完成
+- 支持导出 `xlsx` 或 `csv`
+- 提供 `--output-path` 时自动下载，否则只返回 `file_token`
+
+```bash
+# 导出 xlsx 并保存到本地
+lark-cli sheets +export --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --file-extension xlsx --output-path "./report.xlsx"
+
+# 导出 csv（必须指定 sheet-id）
+lark-cli sheets +export --spreadsheet-token "shtxxxxxxxx" \
+  --file-extension csv --sheet-id "<sheetId>" --output-path "./report.csv"
+
+# 只返回导出文件 token
+lark-cli sheets +export --spreadsheet-token "shtxxxxxxxx" --file-extension xlsx
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 电子表格 token |
+| `--file-extension` | 是 | `xlsx` 或 `csv` |
+| `--sheet-id` | 否 | 导出 `csv` 时必填 |
+| `--output-path` | 否 | 保存到本地的路径 |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：
+
+- 提供 `--output-path`：`saved_path`、`file_name`、`file_size`
+- 不提供 `--output-path`：`file_token`、`file_name`、`file_size`
+
+## 参考
+
+- [sheet-management](lark-sheets-sheet-management.md) — 管理工作表
+- [cell-data](lark-sheets-cell-data.md) — 读写单元格数据
+- [float-images](lark-sheets-float-images.md) — 上传和管理浮动图片

package/dist/skills/larksuite/lark-skill-maker/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: lark-skill-maker
+version: 1.0.0
+description: "创建 lark-cli 的自定义 Skill。当用户需要把飞书 API 操作封装成可复用的 Skill（包装原子 API 或编排多步流程）时使用。"
+metadata:
+  requires:
+    bins: ["lark-cli"]
+---
+
+# Skill Maker
+
+基于 lark-cli 创建新 Skill。Skill = 一份 `SKILL.md`，教 AI 用 CLI 命令完成任务。
+
+## CLI 核心能力
+
+```bash
+lark-cli <service> <resource> <method>          # 已注册 API
+lark-cli <service> +<verb>                      # Shortcut（高级封装）
+lark-cli api <METHOD> <path> [--data/--params]  # 任意飞书 OpenAPI
+lark-cli schema <service.resource.method>       # 查参数定义
+```
+
+优先级：Shortcut > 已注册 API > `api` 裸调。
+
+## 调研 API
+
+```bash
+# 1. 查看已有的 API 资源和 Shortcut
+lark-cli <service> --help
+
+# 2. 查参数定义
+lark-cli schema <service.resource.method>
+
+# 3. 未注册的 API，用 api 直接调用
+lark-cli api GET /open-apis/vc/v1/rooms --params '{"page_size":"50"}'
+lark-cli api POST /open-apis/vc/v1/rooms/search --data '{"query":"5F"}'
+```
+
+如果以上命令无法覆盖需求（CLI 没有对应的已注册 API 或 Shortcut），使用 [lark-openapi-explorer](../lark-openapi-explorer/SKILL.md) 从飞书官方文档库逐层挖掘原生 OpenAPI 接口，获取完整的方法、路径、参数和权限信息，再通过 `lark-cli api` 裸调完成任务。
+
+通过以上流程确定需要哪些 API、参数和 scope。
+
+## SKILL.md 模板
+
+文件放在 `skills/lark-<name>/SKILL.md`：
+
+```markdown
+---
+name: lark-<name>
+version: 1.0.0
+description: "<功能描述>。当用户需要<触发场景>时使用。"
+metadata:
+  requires:
+    bins: ["lark-cli"]
+---
+
+
+# <标题>
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)。
+
+## 命令
+
+\```bash
+# 单步操作
+lark-cli api POST /open-apis/xxx --data '{...}'
+
+# 多步编排：说明步骤间数据传递
+# Step 1: ...（记录返回的 xxx_id）
+# Step 2: 使用 Step 1 的 xxx_id
+\```
+
+## 权限
+
+| 操作 | 所需 scope |
+|------|-----------|
+| xxx | `scope:name` |
+```
+
+## 关键原则
+
+- **description 决定触发** — 包含功能关键词 + "当用户需要...时使用"
+- **认证** — 说明所需 scope，登录用 `lark-cli auth login --domain <name>`
+- **安全** — 写入操作前确认用户意图，建议 `--dry-run` 预览
+- **编排** — 说明数据传递、失败回滚、可并行步骤