@wagemule/daemon 0.1.0 → 0.1.3

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

@@ -0,0 +1,46 @@
+# base +table-get
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+获取一张表的聚合信息：表基础信息、全部字段、全部视图。
+
+## 推荐命令
+
+```bash
+lark-cli base +table-get \
+  --base-token app_xxx \
+  --table-id tbl_xxx
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID（`id` 必须以 `tbl` 开头）或表名 |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+GET /open-apis/base/v3/bases/:base_token/tables/:table_id
+```
+
+- CLI 内部还会继续查询 `/fields` 和 `/views`，并聚合输出。
+
+## 返回重点
+
+- 返回 `table`、`fields`、`views` 三段数据。
+- 适合先摸清表结构，再继续字段或视图操作。
+
+## 坑点
+
+- ⚠️ 如果 `--table-id` 传的是 `id`，必须是 `tbl` 开头；不是的话先询问用户具体是哪张表，或先用 `+table-list` 查表列表再确认。
+- ⚠️ `--table-id` 支持传表名，但重名场景下建议优先传 `tbl_xxx`。
+
+## 参考
+
+- [lark-base-table.md](lark-base-table.md) — table 索引页
+- [lark-base-field-list.md](lark-base-field-list.md) — 列字段
+- [lark-base-view-list.md](lark-base-view-list.md) — 列视图

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

@@ -0,0 +1,43 @@
+# base +table-list
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+分页列出一个 Base 下的数据表。
+
+## 推荐命令
+
+```bash
+lark-cli base +table-list \
+  --base-token app_xxx \
+  --offset 0 \
+  --limit 50
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--offset <n>` | 否 | 分页偏移，默认 `0` |
+| `--limit <n>` | 否 | 分页大小，默认 `50`，范围 `1-100` |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+GET /open-apis/base/v3/bases/:base_token/tables
+```
+
+## 返回重点
+
+- 返回 `items / offset / limit / count / total`。
+- `items` 会被简化为 `table_id` 和 `table_name`。
+
+## 坑点
+
+- ⚠️ `+table-list` 禁止并发调用；批量列多个 Base 时必须串行。
+
+## 参考
+
+- [lark-base-table.md](lark-base-table.md) — table 索引页

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

@@ -0,0 +1,49 @@
+# base +table-update
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+重命名一张表。
+
+## 推荐命令
+
+```bash
+lark-cli base +table-update \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --name "重点客户名单"
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+| `--name <name>` | 是 | 新表名 |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+PATCH /open-apis/base/v3/bases/:base_token/tables/:table_id
+```
+
+## 返回重点
+
+- 返回 `table` 和 `updated: true`。
+- 当前只支持更新名称。
+
+## 工作流
+
+
+1. 建议先用 `+table-get` 确认目标表。
+
+## 坑点
+
+- ⚠️ 这是写入操作，执行前必须确认。
+
+## 参考
+
+- [lark-base-table.md](lark-base-table.md) — table 索引页
+- [lark-base-table-get.md](lark-base-table-get.md) — 查表详情

package/dist/skills/larksuite/lark-base/references/lark-base-table.md

@@ -0,0 +1,20 @@
+# base table shortcuts
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+table 相关命令索引。
+
+## 命令导航
+
+| 文档 | 命令 | 说明 |
+|------|------|------|
+| [lark-base-table-list.md](lark-base-table-list.md) | `+table-list` | 分页列出数据表 |
+| [lark-base-table-get.md](lark-base-table-get.md) | `+table-get` | 获取单表概要、字段和视图 |
+| [lark-base-table-create.md](lark-base-table-create.md) | `+table-create` | 创建数据表，可附带字段 / 视图 |
+| [lark-base-table-update.md](lark-base-table-update.md) | `+table-update` | 重命名数据表 |
+| [lark-base-table-delete.md](lark-base-table-delete.md) | `+table-delete` | 删除数据表 |
+
+## 说明
+
+- 聚合页只保留目录职责；调用任一 table 命令前，务必先阅读对应单命令文档（本页不提供调用细节）。
+- 所有 `+xxx-list` 调用都必须串行执行；若要批量跑多个 list 请求，只能串行执行。

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

@@ -0,0 +1,50 @@
+# base +view-create
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+创建一个视图。
+
+## 1. 顶层规则
+
+- --json 结构是 `{name, type?}`。
+- `name` 必填；同表内应唯一。
+- `type` 可省略；省略时默认 `grid`。
+- 视图类型取值范围：`grid`、`kanban`、`gallery`、`calendar`、`gantt`。
+- `+view-create` 不负责排序、分组、筛选、时间轴、卡片封面、可见字段顺序；这些配置需要创建后再调用对应命令。
+- 表单视图不走 `+view-create`；使用表单相关命令。
+
+## 2. 推荐命令
+
+```bash
+lark-cli base +view-create \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --json '{"name":"进行中","type":"grid"}'
+```
+
+## 3. JSON 写法
+
+```json
+{ "name": "进行中", "type": "grid" }
+```
+
+最小写法：
+
+```json
+{ "name": "默认视图" }
+```
+
+## 4. 使用建议
+
+- 需要设置可见字段顺序时，创建后继续调用 [lark-base-view-set-visible-fields.md](lark-base-view-set-visible-fields.md)。
+- 需要设置筛选、分组、排序、时间轴、卡片封面时，创建后继续调用对应 `+view-set-*` 命令。
+
+## 5. 易错点
+
+- 不要把 `form` 当成 `type` 传进来。
+- 不要指望 `+view-create` 一次完成视图布局与属性配置。
+
+## 6. 参考
+
+- [lark-base-view.md](lark-base-view.md)
+- [lark-base-view-set-visible-fields.md](lark-base-view-set-visible-fields.md)

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

@@ -0,0 +1,48 @@
+# base +view-delete
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+删除一个视图。
+
+## 推荐命令
+
+```bash
+lark-cli base +view-delete \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --view-id viw_xxx
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+| `--view-id <id_or_name>` | 是 | 视图 ID 或视图名 |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+DELETE /open-apis/base/v3/bases/:base_token/tables/:table_id/views/:view_id
+```
+
+## 返回重点
+
+- 返回删除成功状态和目标视图标识。
+
+## 工作流
+
+
+1. 建议先用 `+view-get` 确认目标视图。
+2. 删除前必须让用户确认。
+
+## 坑点
+
+- ⚠️ 高风险写操作，删除后不可恢复。
+
+## 参考
+
+- [lark-base-view.md](lark-base-view.md) — view 索引页

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

@@ -0,0 +1,38 @@
+# base +view-get-card
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+获取卡片配置。
+
+## 推荐命令
+
+```bash
+lark-cli base +view-get-card \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --view-id viw_xxx
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+| `--view-id <id_or_name>` | 是 | 视图 ID 或视图名 |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+GET /open-apis/base/v3/bases/:base_token/tables/:table_id/views/:view_id/card
+```
+
+## 返回重点
+
+- 返回原始卡片配置。
+
+## 参考
+
+- [lark-base-view.md](lark-base-view.md) — view 索引页

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

@@ -0,0 +1,38 @@
+# base +view-get-filter
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+获取筛选配置。
+
+## 推荐命令
+
+```bash
+lark-cli base +view-get-filter \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --view-id viw_xxx
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+| `--view-id <id_or_name>` | 是 | 视图 ID 或视图名 |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+GET /open-apis/base/v3/bases/:base_token/tables/:table_id/views/:view_id/filter
+```
+
+## 返回重点
+
+- 返回原始筛选配置。
+
+## 参考
+
+- [lark-base-view.md](lark-base-view.md) — view 索引页

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

@@ -0,0 +1,38 @@
+# base +view-get-group
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+获取分组配置。
+
+## 推荐命令
+
+```bash
+lark-cli base +view-get-group \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --view-id viw_xxx
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+| `--view-id <id_or_name>` | 是 | 视图 ID 或视图名 |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+GET /open-apis/base/v3/bases/:base_token/tables/:table_id/views/:view_id/group
+```
+
+## 返回重点
+
+- 返回原始分组配置。
+
+## 参考
+
+- [lark-base-view.md](lark-base-view.md) — view 索引页

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

@@ -0,0 +1,38 @@
+# base +view-get-sort
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+获取排序配置。
+
+## 推荐命令
+
+```bash
+lark-cli base +view-get-sort \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --view-id viw_xxx
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+| `--view-id <id_or_name>` | 是 | 视图 ID 或视图名 |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+GET /open-apis/base/v3/bases/:base_token/tables/:table_id/views/:view_id/sort
+```
+
+## 返回重点
+
+- 返回原始排序配置。
+
+## 参考
+
+- [lark-base-view.md](lark-base-view.md) — view 索引页

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

@@ -0,0 +1,38 @@
+# base +view-get-timebar
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+获取时间轴配置。
+
+## 推荐命令
+
+```bash
+lark-cli base +view-get-timebar \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --view-id viw_xxx
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+| `--view-id <id_or_name>` | 是 | 视图 ID 或视图名 |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+GET /open-apis/base/v3/bases/:base_token/tables/:table_id/views/:view_id/timebar
+```
+
+## 返回重点
+
+- 返回原始时间轴配置。
+
+## 参考
+
+- [lark-base-view.md](lark-base-view.md) — view 索引页

package/dist/skills/larksuite/lark-base/references/lark-base-view-get-visible-fields.md

@@ -0,0 +1,28 @@
+# base +view-get-visible-fields
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+获取可见字段配置。
+
+## 1. 顶层规则
+
+- 读取当前视图的可见字段列表与顺序。
+- 仅 `grid` / `kanban` / `gallery` / `calendar` / `gantt` 视图支持。
+
+## 2. 推荐命令
+
+```bash
+lark-cli base +view-get-visible-fields \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --view-id <view_id>
+```
+
+## 3. 返回重点
+
+- 返回当前视图可见字段列表。
+- 返回结果中的主字段会位于第一位。
+
+## 参考
+
+- [lark-base-view.md](lark-base-view.md) — view 索引页

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

@@ -0,0 +1,38 @@
+# base +view-get
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+获取一个视图的基本信息。
+
+## 推荐命令
+
+```bash
+lark-cli base +view-get \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --view-id viw_xxx
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+| `--view-id <id_or_name>` | 是 | 视图 ID 或视图名 |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+GET /open-apis/base/v3/bases/:base_token/tables/:table_id/views/:view_id
+```
+
+## 返回重点
+
+- 返回视图的基础配置。
+
+## 参考
+
+- [lark-base-view.md](lark-base-view.md) — view 索引页

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

@@ -0,0 +1,44 @@
+# base +view-list
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+分页列出一张表下的视图。
+
+## 推荐命令
+
+```bash
+lark-cli base +view-list \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --offset 0 \
+  --limit 100
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+| `--offset <n>` | 否 | 分页偏移，默认 `0` |
+| `--limit <n>` | 否 | 分页大小，默认 `100`，范围 `1-200` |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+GET /open-apis/base/v3/bases/:base_token/tables/:table_id/views
+```
+
+## 返回重点
+
+- 返回 `views` 和 `total`。
+
+## 坑点
+
+- ⚠️ `+view-list` 禁止并发调用；批量列多个表视图时只能串行。
+
+## 参考
+
+- [lark-base-view.md](lark-base-view.md) — view 索引页

package/dist/skills/larksuite/lark-base/references/lark-base-view-rename.md

@@ -0,0 +1,44 @@
+# base +view-rename
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+重命名一个视图。
+
+## 推荐命令
+
+```bash
+lark-cli base +view-rename \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --view-id viw_xxx \
+  --name "进行中客户"
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+| `--view-id <id_or_name>` | 是 | 视图 ID 或视图名 |
+| `--name <name>` | 是 | 新视图名 |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+PATCH /open-apis/base/v3/bases/:base_token/tables/:table_id/views/:view_id
+```
+
+## 返回重点
+
+- 返回更新后的 `view` 数据。
+
+## 坑点
+
+- ⚠️ 这是写入操作，执行前必须确认。
+
+## 参考
+
+- [lark-base-view.md](lark-base-view.md) — view 索引页

package/dist/skills/larksuite/lark-base/references/lark-base-view-set-card.md

@@ -0,0 +1,55 @@
+# base +view-set-card
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+更新卡片封面配置。
+
+## 1. 顶层规则
+
+- `--json` 必须是 JSON 对象。
+- 仅 `gallery` / `kanban` 视图支持。
+- `cover_field` 必填；可传 `attachment` 类型的字段 id、字段名，或 `null`。
+
+## 2. 推荐命令
+
+设置封面：
+
+```bash
+lark-cli base +view-set-card \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --view-id <view_id> \
+  --json '{"cover_field":"fld_cover"}'
+```
+
+
+## 3. JSON 写法
+
+```json
+{
+  "cover_field": "fld_cover"
+}
+```
+
+```json
+{
+  "cover_field": null
+}
+```
+
+## 4. 使用建议
+
+- 建议先用 [lark-base-view-get-card.md](lark-base-view-get-card.md) 读取现状，再改。
+- 优先传字段 id，不要依赖字段名。
+- 普通文本、数字、选择字段不能作为封面字段。
+
+## 5. 易错点
+
+- 不要传空字符串；清空时传 `null`。
+- 不要在 `grid` / `calendar` / `gantt` 视图上调用。
+- 不要假设任意字段都能做封面；稳定做法是先找 `attachment` 字段。
+
+## 6. 参考
+
+- [lark-base-view.md](lark-base-view.md)
+- [lark-base-view-get-card.md](lark-base-view-get-card.md)