@wagemule/daemon 0.1.2 → 0.1.4

package/dist/skills/larksuite/lark-base/references/lark-base-dashboard-block-delete.md

@@ -0,0 +1,46 @@
+# base +dashboard-block-delete
+
+> **前置条件：** 先阅读 [lark-base-dashboard.md](lark-base-dashboard.md) 了解整体工作流。
+
+删除仪表盘中的一个组件（Block），不可恢复。
+
+## 推荐命令
+
+```bash
+lark-cli base +dashboard-block-delete \
+  --base-token bascn***************CtadY \
+  --dashboard-id blkxxx \
+  --block-id chtxxxxxxxx
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--dashboard-id <id>` | 是 | 仪表盘 ID |
+| `--block-id <id>` | 是 | Block ID |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+## 返回示例
+
+```json
+{
+  "block_id": "chtxxxxxxxx",
+  "deleted": true
+}
+```
+
+## 返回重点
+
+| 字段 | 说明 |
+|------|------|
+| `block_id` | 被删除的组件 ID |
+| `deleted` | 是否删除成功 |
+
+> [!CAUTION]
+> 这是**写入操作**且**不可逆** — 执行前必须向用户确认。
+
+## 参考
+
+- [lark-base-dashboard.md](lark-base-dashboard.md) — dashboard 模块指引

package/dist/skills/larksuite/lark-base/references/lark-base-dashboard-block-get.md

@@ -0,0 +1,57 @@
+# base +dashboard-block-get
+
+> **前置条件：** 先阅读 [lark-base-dashboard.md](lark-base-dashboard.md) 了解整体工作流。
+
+获取仪表盘中单个组件的详情（包含 data_config 完整配置）。常用于：1) 查看组件的完整配置；2) 编辑组件前了解当前配置。
+
+## 推荐命令
+
+```bash
+lark-cli base +dashboard-block-get \
+  --base-token bascn***************CtadY \
+  --dashboard-id blkxxx \
+  --block-id chtxxxxxxxx
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--dashboard-id <id>` | 是 | 仪表盘 ID |
+| `--block-id <id>` | 是 | Block ID |
+| `--user-id-type <type>` | 否 | 用户 ID 类型：open_id / union_id / user_id |
+| `--format <fmt>` | 否 | 输出格式 |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+## 返回示例
+
+```json
+{
+  "block": {
+    "block_id": "chtxxxxxxxx",
+    "name": "柱状图",
+    "type": "column",
+    "data_config": {
+      "table_name": "电商交易明细",
+      "series": [{"field_name": "营销费用", "rollup": "SUM"}],
+      "group_by": [{"field_name": "品类", "mode": "integrated"}]
+    },
+    "layout": {"x": 0, "y": 0, "w": 6, "h": 4}
+  }
+}
+```
+
+## 返回重点
+
+| 字段 | 说明                            |
+|------|-------------------------------|
+| `block.block_id` | 组件 ID                         |
+| `block.name` | 组件名称                          |
+| `block.type` | 组件类型（如 `column`/`line`/`pie`） |
+| `block.data_config` | 数据配置（新建/编辑组件时可基于此字段修改）        |
+| `block.layout` | 布局信息（只读，x/y/w/h 坐标和尺寸）        |
+
+## 参考
+
+- [lark-base-dashboard.md](lark-base-dashboard.md) — dashboard 模块指引

package/dist/skills/larksuite/lark-base/references/lark-base-dashboard-block-list.md

@@ -0,0 +1,53 @@
+# base +dashboard-block-list
+
+> **前置条件：** 先阅读 [lark-base-dashboard.md](lark-base-dashboard.md) 了解整体工作流。
+
+分页列出仪表盘中的所有组件（Block）。常用于：1) 查看仪表盘有哪些组件；2) 获取组件 ID 和类型用于后续编辑/删除。
+
+## 推荐命令
+
+```bash
+lark-cli base +dashboard-block-list \
+  --base-token bascn***************CtadY \
+  --dashboard-id blkxxx
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--dashboard-id <id>` | 是 | 仪表盘 ID |
+| `--page-size <n>` | 否 | 每页数量，默认 20，最大 100 |
+| `--page-token <token>` | 否 | 分页标记 |
+| `--format <fmt>` | 否 | 输出格式：json / pretty / table / csv / ndjson |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+## 返回示例
+
+```json
+{
+  "items": [
+    {"block_id": "chtxxxxxxxx", "name": "图表", "type": "column"},
+    {"block_id": "chtxxxxxxxx", "name": "总利润", "type": "statistics"}
+  ],
+  "total": 4,
+  "has_more": false
+}
+```
+
+## 返回重点
+
+| 字段 | 说明 |
+|------|------|
+| `items` | 组件列表，每项包含 `block_id`（ID）、`name`（名称）、`type`（类型）|
+| `total` | 组件总数 |
+| `has_more` | 是否有更多组件（为 `true` 时需用 `page_token` 继续获取）|
+
+## 坑点
+
+- `+dashboard-block-list` 禁止并发调用；批量执行时只能串行。
+
+## 参考
+
+- [lark-base-dashboard.md](lark-base-dashboard.md) — dashboard 模块指引

package/dist/skills/larksuite/lark-base/references/lark-base-dashboard-block-update.md

@@ -0,0 +1,84 @@
+# base +dashboard-block-update
+
+> **前置条件：** 先阅读 [lark-base-dashboard.md](lark-base-dashboard.md) 了解整体工作流
+> **关键：** 更新前必须阅读 [dashboard-block-data-config.md](dashboard-block-data-config.md) 了解 data_config 结构和更新规则
+
+更新仪表盘中组件的名称或数据配置。
+
+## 关键约束
+
+- **不可修改 `type` 和 `layout`** — 只能更新 `name` 和 `data_config`。
+- **`data_config` 顶层按 key merge** — 只需传入要修改的顶层字段，未传的字段保留原值；但每个字段内部是全量替换（如传新 `filter` 会完整覆盖旧 `filter`）。
+- **`series` 与 `count_all` 二选一** — 且至少提供其一。
+- **表名用 name，不是 ID** — `table_name` 对应的是表名称（如「订单表」），不是 `table_id`。
+- **`user_id_type`** 仅在 filter 涉及人员字段时有意义。
+
+> [!TIP]
+> CLI 默认会对 `data_config` 做轻量校验与规范化；如需兼容特殊场景，可加 `--no-validate` 跳过。
+
+## 推荐命令
+
+```bash
+# 示例 1：更新组件名称
+lark-cli base +dashboard-block-update \
+  --base-token xxx \
+  --dashboard-id blk_xxx \
+  --block-id chtxxxxxxxx \
+  --name "新名称"
+
+# 示例 2：更新数据配置（只传要改的字段，未传字段保留原值）
+lark-cli base +dashboard-block-update \
+  --base-token xxx \
+  --dashboard-id blk_xxx \
+  --block-id chtxxxxxxxx \
+  --data-config '{"filter":{"conjunction":"and","conditions":[{"field_name":"状态","operator":"is","value":"已完成"}]}}'
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--dashboard-id <id>` | 是 | 仪表盘 ID |
+| `--block-id <id>` | 是 | Block ID |
+| `--name <name>` | 否 | 新名称 |
+| `--data-config <json>` | 否 | 数据配置 JSON。**结构随 block 的 `type` 变化**。**⚠️ 必须阅读 [dashboard-block-data-config.md](dashboard-block-data-config.md) 了解如何构造** |
+| `--user-id-type <type>` | 否 | 用户 ID 类型，filter 涉及人员字段时使用 |
+| `--no-validate` | 否 | 跳过 data_config 本地校验（用于兼容特殊场景） |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+## 返回示例
+
+```json
+{
+  "block": {
+    "block_id": "chtxxxxxxxx",
+    "name": "新名称",
+    "type": "column",
+    "data_config": {
+      "table_name": "订单表",
+      "series": [{"field_name": "金额", "rollup": "SUM"}],
+      "group_by": [{"field_name": "类别", "mode": "integrated"}]
+    }
+  },
+  "updated": true
+}
+```
+
+## 返回重点
+
+| 字段 | 说明 |
+|------|------|
+| `block.block_id` | 组件 ID |
+| `block.name` | 更新后的名称 |
+| `block.type` | 组件类型（不可修改）|
+| `block.data_config` | 更新后的数据配置 |
+| `updated` | 是否更新成功 |
+
+> [!CAUTION]
+> 这是**写入操作** — 执行前必须向用户确认。
+
+## 参考
+
+- [lark-base-dashboard.md](lark-base-dashboard.md) — dashboard 模块指引
+- [dashboard-block-data-config.md](dashboard-block-data-config.md) — data_config 结构、图表类型、filter 规则

package/dist/skills/larksuite/lark-base/references/lark-base-dashboard-create.md

@@ -0,0 +1,73 @@
+# base +dashboard-create
+
+> **前置条件：** 先阅读 [lark-base-dashboard.md](lark-base-dashboard.md) 了解整体工作流。
+
+创建空白仪表盘。创建成功后务必记录返回的 `dashboard_id`，后续添加组件和管理仪表盘都需要用到。
+
+## 关键约束
+
+- **dashboard_id** 在 create 返回中取得，后续 get/update/delete 使用。
+
+## 推荐命令
+
+```bash
+# 创建仪表盘
+lark-cli base +dashboard-create \
+  --base-token VwGhb**************fMnod \
+  --name "销售报表"
+
+# 创建仪表盘（指定主题）
+lark-cli base +dashboard-create \
+  --base-token VwGhb**************fMnod \
+  --name "销售报表" \
+  --theme-style default
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--name <name>` | 是 | 仪表盘名称 |
+| `--theme-style <style>` | 否 | 主题风格（见下方枚举） |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+### theme-style 枚举
+
+| 值 | 说明 |
+|------|------|
+| `default` | 默认主题 |
+| `SimpleBlue` | 简约蓝 |
+| `DarkGreen` | 深绿 |
+| `summerBreeze` | 夏日微风 |
+| `simplistic` | 简洁 |
+| `energetic` | 活力 |
+| `deepDark` | 深色 |
+| `futuristic` | 未来感 |
+
+## 返回示例
+
+```json
+{
+  "dashboard_id": "blkxxxxxxxxxxxx",
+  "name": "数据分析仪表盘",
+  "theme": {
+    "theme_style": "default"
+  }
+}
+```
+
+## 返回重点
+
+| 字段 | 说明 |
+|------|------|
+| `dashboard_id` | 仪表盘 ID（如 `blkxxxxxxxxxxxx`），后续操作都需要用到，务必记录 |
+| `name` | 仪表盘名称 |
+| `theme.theme_style` | 主题风格 |
+
+> [!CAUTION]
+> 这是**写入操作** — 执行前必须向用户确认。
+
+## 参考
+
+- [lark-base-dashboard.md](lark-base-dashboard.md) — dashboard 模块指引

package/dist/skills/larksuite/lark-base/references/lark-base-dashboard-delete.md

@@ -0,0 +1,44 @@
+# base +dashboard-delete
+
+> **前置条件：** 先阅读 [lark-base-dashboard.md](lark-base-dashboard.md) 了解整体工作流。
+
+删除仪表盘（会同时删除其下所有组件，不可恢复）。
+
+## 推荐命令
+
+```bash
+lark-cli base +dashboard-delete \
+  --base-token VwGhb**************fMnod \
+  --dashboard-id blkxxxxxxx
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--dashboard-id <id>` | 是 | 仪表盘 ID |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+## 返回示例
+
+```json
+{
+  "dashboard_id": "blkxxxxxxxxxxxx",
+  "deleted": true
+}
+```
+
+## 返回重点
+
+| 字段 | 说明 |
+|------|------|
+| `dashboard_id` | 被删除的仪表盘 ID |
+| `deleted` | 是否删除成功 |
+
+> [!CAUTION]
+> 这是**写入操作**且**不可逆** — 执行前必须向用户确认。删除仪表盘会同时删除其下所有组件，不可恢复。
+
+## 参考
+
+- [lark-base-dashboard.md](lark-base-dashboard.md) — dashboard 模块指引

package/dist/skills/larksuite/lark-base/references/lark-base-dashboard-get.md

@@ -0,0 +1,59 @@
+# base +dashboard-get
+
+> **前置条件：** 先阅读 [lark-base-dashboard.md](lark-base-dashboard.md) 了解整体工作流。
+
+获取仪表盘详情（名称、主题配置、包含的所有组件列表）。常用于：1) 查看仪表盘有哪些组件；2) 获取组件 ID 用于后续编辑/删除。
+
+## 推荐命令
+
+```bash
+lark-cli base +dashboard-get \
+  --base-token VwGhb**************fMnod \
+  --dashboard-id blkxxxxxxx
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--dashboard-id <id>` | 是 | 仪表盘 ID |
+| `--format <fmt>` | 否 | 输出格式 |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+## 返回示例
+
+```json
+{
+  "dashboard_id": "blkxxxxxxxxxxxx",
+  "name": "数据分析仪表盘",
+  "theme": {
+    "theme_style": "default"
+  },
+  "blocks": [
+    {
+      "block_id": "chtxxxxxxxx",
+      "block_name": "总净利润",
+      "block_type": "statistics"
+    },
+    {
+      "block_id": "chtxxxxxxxx",
+      "block_name": "品类占比",
+      "block_type": "pie"
+    }
+  ]
+}
+```
+
+## 返回重点
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `dashboard_id` | string | 仪表盘 ID（如 `blkxxxxxxxxxxxx`）|
+| `name` | string | 仪表盘名称 |
+| `theme.theme_style` | string | 主题风格：`default` / `SimpleBlue` / `DarkGreen` / `summerBreeze` / `simplistic` / `energetic` / `deepDark` / `futuristic` |
+| `blocks` | []object | 组件列表，每项包含 `block_id`（组件ID）、`block_name`（名称）、`block_type`（类型，如 `column`/`line`/`pie`）|
+
+## 参考
+
+- [lark-base-dashboard.md](lark-base-dashboard.md) — dashboard 模块指引

package/dist/skills/larksuite/lark-base/references/lark-base-dashboard-list.md

@@ -0,0 +1,52 @@
+# base +dashboard-list
+
+> **前置条件：** 先阅读 [lark-base-dashboard.md](lark-base-dashboard.md) 了解整体工作流。
+
+分页列出一个 Base 下的所有仪表盘。常用于：1) 查看当前有哪些仪表盘；2) 获取 dashboard_id 用于后续操作（如添加组件、查看详情）。
+
+## 关键约束
+
+- `+dashboard-list` 禁止并发调用；批量列多个 Base 时必须串行。
+
+## 推荐命令
+
+```bash
+lark-cli base +dashboard-list \
+  --base-token VwGhb**************fMnod
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--page-size <n>` | 否 | 每页数量 |
+| `--page-token <token>` | 否 | 分页标记 |
+| `--format <fmt>` | 否 | 输出格式：json / pretty / table / csv / ndjson |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+## 返回示例
+
+```json
+{
+  "items": [
+    {"dashboard_id": "blkxxxxxxxxxxxx", "name": "商品总览仪表盘"},
+    {"dashboard_id": "blkxxxxxxxxxxxx", "name": "订单总览仪表盘"},
+    {"dashboard_id": "blkxxxxxxxxxxxx", "name": "销售数据分析仪表盘"}
+  ],
+  "total": 3,
+  "has_more": false
+}
+```
+
+## 返回重点
+
+| 字段 | 说明 |
+|------|------|
+| `items` | 仪表盘列表，每项包含 `dashboard_id`（ID）和 `name`（名称）|
+| `total` | 总数 |
+| `has_more` | 是否有下一页（为 `true` 时需用 `page_token` 继续获取）|
+
+## 参考
+
+- [lark-base-dashboard.md](lark-base-dashboard.md) — dashboard 模块指引

package/dist/skills/larksuite/lark-base/references/lark-base-dashboard-update.md

@@ -0,0 +1,69 @@
+# base +dashboard-update
+
+> **前置条件：** 先阅读 [lark-base-dashboard.md](lark-base-dashboard.md) 了解整体工作流。
+
+更新仪表盘名称或主题。
+
+## 推荐命令
+
+```bash
+lark-cli base +dashboard-update \
+  --base-token VwGhb**************fMnod \
+  --dashboard-id blkxxxxxxx \
+  --name "新名称" \
+  --theme-style default
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--dashboard-id <id>` | 是 | 仪表盘 ID |
+| `--name <name>` | 否 | 新名称 |
+| `--theme-style <style>` | 否 | 主题风格（见下方枚举） |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+### theme-style 枚举
+
+| 值 | 说明 |
+|------|------|
+| `default` | 默认主题 |
+| `SimpleBlue` | 简约蓝 |
+| `DarkGreen` | 深绿 |
+| `summerBreeze` | 夏日微风 |
+| `simplistic` | 简洁 |
+| `energetic` | 活力 |
+| `deepDark` | 深色 |
+| `futuristic` | 未来感 |
+
+## 返回示例
+
+```json
+{
+  "dashboard": {
+    "dashboard_id": "blkxxxxxxxxxxxx",
+    "name": "新名称",
+    "theme": {
+      "theme_style": "default"
+    }
+  },
+  "updated": true
+}
+```
+
+## 返回重点
+
+| 字段 | 说明 |
+|------|------|
+| `dashboard` | 更新后的仪表盘对象 |
+| `dashboard.name` | 新名称（如果更新了）|
+| `dashboard.theme.theme_style` | 新主题（如果更新了）|
+| `updated` | 是否更新成功 |
+
+> [!CAUTION]
+> 这是**写入操作** — 执行前必须向用户确认。
+
+## 参考
+
+- [lark-base-dashboard.md](lark-base-dashboard.md) — dashboard 模块指引