npm - @wagemule/daemon - Versions diffs - 0.1.0 → 0.1.3 - Mend

@wagemule/daemon 0.1.0 → 0.1.3

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 (341) hide show

package/dist/skills/larksuite/lark-base/references/lark-base-field-list.md ADDED Viewed

@@ -0,0 +1,44 @@
+# base +field-list
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+分页列出一张表下的字段。
+## 推荐命令
+```bash
+lark-cli base +field-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/fields
+```
+## 返回重点
+- 返回字段列表及 `offset / limit / count / total`。
+## 坑点
+- ⚠️ `+field-list` 禁止并发调用；批量列多个表字段时只能串行。
+## 参考
+- [lark-base-field.md](lark-base-field.md) — field 索引页

package/dist/skills/larksuite/lark-base/references/lark-base-field-search-options.md ADDED Viewed

@@ -0,0 +1,48 @@
+# base +field-search-options
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+搜索单选 / 多选字段的候选项。
+## 推荐命令
+```bash
+lark-cli base +field-search-options \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --field-id fld_status \
+  --keyword 已完成 \
+  --offset 0 \
+  --limit 30
+```
+## 参数
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+| `--field-id <id_or_name>` | 是 | 字段 ID 或字段名 |
+| `--keyword <text>` | 否 | 查询关键字；会映射到 API 的 `query` |
+| `--offset <n>` | 否 | 分页偏移，默认 `0` |
+| `--limit <n>` | 否 | 分页大小，默认 `30` |
+## API 入参详情
+**HTTP 方法和路径：**
+```
+GET /open-apis/base/v3/bases/:base_token/tables/:table_id/fields/:field_id/options
+```
+## 返回重点
+- 返回 `options`、`total`、以及回显的 `field_id / field_name / keyword`。
+## 坑点
+- ⚠️ 只适用于带选项集的字段；普通文本 / 数字字段没有可搜索选项。
+## 参考
+- [lark-base-field.md](lark-base-field.md) — field 索引页

package/dist/skills/larksuite/lark-base/references/lark-base-field-update.md ADDED Viewed

@@ -0,0 +1,166 @@
+# base +field-update
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+更新一个已有字段。
+## 推荐命令
+```bash
+lark-cli base +field-update \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --field-id <field_id> \
+  --json '{"name":"状态","type":"select","multiple":false,"options":[{"name":"Todo","hue":"Blue","lightness":"Lighter"},{"name":"Doing","hue":"Orange","lightness":"Light"},{"name":"Done","hue":"Green","lightness":"Light"}]}'
+lark-cli base +field-update \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --field-id <field_id> \
+  --json '{"name":"负责人","type":"user","multiple":false,"description":"用于标记记录的直接负责人"}'
+```
+## 参数
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+| `--field-id <id_or_name>` | 是 | 字段 ID 或字段名 |
+| `--json <body>` | 是 | 字段属性 JSON 对象 |
+## API 入参详情
+**HTTP 方法和路径：**
+```
+PUT /open-apis/base/v3/bases/:base_token/tables/:table_id/fields/:field_id
+```
+## JSON 值规范
+- `--json` 必须是 **JSON 对象**，顶层直接传字段定义。
+- 更新语义是 `PUT`（全量字段配置更新），不要只传零散片段；至少显式包含 `name`、`type`，并补齐该类型所需关键配置。
+- 所有字段类型都支持可选 `description`；支持纯文本，也支持 Markdown 链接。
+- `select` 更新时：`options` 仍按对象数组传，避免混入无效字段。
+- `link` 更新限制：
+  - 不能把非 `link` 字段改成 `link`，也不能把 `link` 改成非 `link`。
+  - 现有 `link` 字段的 `bidirectional` 不能改。
+**推荐更新示例**
+```json
+{
+  "name": "状态",
+  "type": "select",
+  "multiple": false,
+  "options": [
+    { "name": "Todo", "hue": "Blue", "lightness": "Lighter" },
+    { "name": "Doing", "hue": "Orange", "lightness": "Light" },
+    { "name": "Done", "hue": "Green", "lightness": "Light" }
+  ]
+}
+```
+**字段说明示例**
+```json
+{
+  "name": "负责人",
+  "type": "user",
+  "multiple": false,
+  "description": "用于标记记录的直接负责人"
+}
+```
+## 返回重点
+- 返回 `field` 和 `updated: true`。
+## 工作流
+1. 建议先用 `+field-get` 拉现状，再做最小化修改。
+2. `formula/lookup` 类型更新前先阅读对应指南。
+3. 如果这次更新会改变字段 `type` 先按下方“字段类型变更规则”判断能否执行。如果不修改 `type`，大多数场景都相对安全。
+## 字段类型变更规则
+字段类型变更采用白名单机制：**只允许白名单转换**；未命中白名单时，**不建议用 CLI 转换字段类型** 除非用户明确知道风险并同意。
+### 允许直接转换 type
+先 `+field-get` / `+field-list` 看结构，再抽样读值；只有命中以下规则时，转换才是比较安全的。
+#### 相对安全
+| 目标类型 | 允许的源类型 | 说明 |
+|------|------|------|
+| `text` | `number`、`select`、`datetime`、`created_at`、`updated_at`、`location`、`auto_number`、`checkbox` | 保留字符串表示；丢失原类型语义和结构化能力 |
+| `number` | `text`、`number`、`datetime`、`created_at`、`updated_at`、`checkbox` | 保留可解析的数字值；无法解析的值会变空，原文本格式会丢失 |
+| `datetime` | `text`、`number`、`datetime`、`created_at`、`updated_at` | 保留可解析的时间字符串和时间戳；无法解析的值会变空，原文本格式会丢失 |
+| `select` | `text -> select`、`number -> select`、`single select -> multi select` | 只有完全匹配目标选项名的值会转成对应选项；没匹配上的值会被丢弃 |
+#### 可执行但会截断 / 重算
+- `select(multi) -> select(single)`: 只保留第一个值，其余值会被丢弃。
+- `user(multi) -> user(single)`: 只保留第一个人员，其余值会被丢弃。
+- `group_chat(multi) -> group_chat(single)`: 只保留第一个群，其余值会被丢弃。
+#### 无状态字段可直接转换
+- `created_at`、`created_by`、`updated_at`、`updated_by`、`formula`、`lookup`: 这类字段值由系统或计算逻辑生成，不承载独立存储数据；可以执行类型转换，不必担心破坏原始记录值，但仍要做下游读回验证。
+### 一律不要用 CLI 转换
+以下场景全部视为黑名单；默认要求用户改到 Web 页面手动完成，或改走“新建字段 + 数据迁移”。
+- `any -> checkbox`
+- `any -> user`
+- `any -> group_chat`
+- `any -> attachment`
+- `any -> location`
+- `link` 类型变更
+- 任意涉及动态 / 静态选项来源切换的 `select` 类型变更
+### 可例外继续执行的场景
+只有在**整列数据丢失可接受**时，才允许对黑名单场景例外执行。
+- `EmptyColumn`: 该列为空
+- `FreshTableInit`: 新建空表初始化
+- `PrimaryFieldBootstrap`: 主列不能删，只能更新完成初始化
+- `ExplicitLossAccepted`: 用户明确接受整列数据丢失
+不满足以上条件时，不要转换。
+### 非白名单场景如何处理
+- 命中白名单时：建议直接原地转换，再做读回验证。
+- 未命中白名单时：先询问用户是否仍要执行转换，并明确说明风险：
+  - 无状态字段除外；这类字段可以直接转换
+  - 可能整列变空
+  - 可能只保留第一个值
+  - 可能只保留字符串表示，丢失原类型语义和结构化能力
+  - 可能影响视图 / 筛选 / 排序 / 公式 / lookup / 写入引用
+- 如果用户不接受风险：不要执行转换。
+### 完成态验证
+- `FieldReadback`: 读回字段结构，确认 `type` / `multiple` / `style` / `options`
+- `ValueReadback`: 抽样读回转换后的单元格值
+- `DownstreamReadback`: 若涉及看板 / 分组 / 排序 / lookup / 公式，继续读回结果
+- `CompletionRule`: 结构、值、下游能力都正确，才能回复“已完成”
+## 坑点
+- ⚠️ 这是全量字段属性更新语义，不是 patch。
+- ⚠️ 这是写入操作，执行前必须确认。
+- ⚠️ 当 `type` 是 `formula` 或 `lookup` 时，先阅读对应指南再执行。
+## 参考
+- [lark-base-field.md](lark-base-field.md) — field 索引页
+- [lark-base-field-get.md](lark-base-field-get.md) — 查字段
+- [lark-base-shortcut-field-properties.md](lark-base-shortcut-field-properties.md) — shortcut 字段 JSON 规范（推荐）
+- [formula-field-guide.md](formula-field-guide.md) — formula 指南（更新公式前必读）
+- [lookup-field-guide.md](lookup-field-guide.md) — lookup 指南（更新查找引用前必读）

package/dist/skills/larksuite/lark-base/references/lark-base-field.md ADDED Viewed

@@ -0,0 +1,23 @@
+# base field shortcuts
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+field 相关命令索引。
+## 命令导航
+| 文档 | 命令 | 说明 |
+|------|------|------|
+| [lark-base-field-list.md](lark-base-field-list.md) | `+field-list` | 分页列字段 |
+| [lark-base-field-get.md](lark-base-field-get.md) | `+field-get` | 获取单字段配置 |
+| [lark-base-field-create.md](lark-base-field-create.md) | `+field-create` | 创建字段 |
+| [lark-base-field-update.md](lark-base-field-update.md) | `+field-update` | 更新字段 |
+| [lark-base-field-search-options.md](lark-base-field-search-options.md) | `+field-search-options` | 搜索选项字段候选值 |
+| [lark-base-field-delete.md](lark-base-field-delete.md) | `+field-delete` | 删除字段 |
+## 说明
+- 聚合页只保留目录职责；每个命令的详细说明请进入对应单命令文档。
+- 所有 `+xxx-list` 调用都必须串行执行；若要批量跑多个 list 请求，只能串行执行。
+- 写字段 JSON 前优先阅读 [lark-base-shortcut-field-properties.md](lark-base-shortcut-field-properties.md)。
+- 涉及字段类型转换时，直接阅读 [lark-base-field-update.md](lark-base-field-update.md) 中的“字段类型变更规则”。

package/dist/skills/larksuite/lark-base/references/lark-base-form-create.md ADDED Viewed

@@ -0,0 +1,87 @@
+# base +form-create
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+在多维表格数据表中创建新表单。
+## ⚠️ 注意事项
+- **表格选择**：创建问卷前先考虑：这是新的业务领域吗？如果是，建议先用 `+table-create` 创建新表格
+- **命名一致性**：问卷名称应与表格用途相关，避免在通用表格（如"收集表"）中创建不相关的问卷
+## 命令
+```bash
+# 创建表单（仅必填参数）
+lark-cli base +form-create \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --name "用户调研问卷"
+# 创建时附带描述（纯文本）
+lark-cli base +form-create \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --name "用户调研问卷" \
+  --description "2024年度用户满意度调研"
+# 创建时附带描述（含链接）
+lark-cli base +form-create \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --name "用户调研问卷" \
+  --description "2024年度调研，[详情请查看](https://example.com)"
+# 使用应用身份（bot）
+lark-cli base +form-create \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --name "用户调研问卷" \
+  --as bot
+```
+## 参数
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token（base_token） |
+| `--table-id <id>` | 是 | 数据表 ID |
+| `--name <name>` | 是 | 表单名称 |
+| `--description <string>` | 否 | 表单描述（纯文本或 Markdown 链接，如 `[文本](https://example.com)`） |
+| `--format` | 否 | 输出格式：json（默认）\| pretty \| table \| ndjson \| csv |
+| `--as` | 否 | 身份：user（默认）\| bot |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+## 输出格式
+| 字段 | 说明 |
+|------|------|
+| `id` | 新创建的表单 ID |
+| `name` | 表单名称 |
+| `description` | 表单描述 |
+```json
+{
+  "ok": true,
+  "data": {
+    "id": "vewX58te9D",
+    "name": "用户调研问卷",
+    "description": "2024年度用户满意度调研"
+  }
+}
+```
+## 工作流
+> [!CAUTION]
+> 这是**写入操作** — 执行前必须向用户确认。
+1. 确认目标 `base_token` 和 `table_id`
+2. 确认表单名称和描述
+3. 执行命令
+4. 报告返回的 `form_id`，后续可用于添加问题（`+form-questions-create`）
+## 参考
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/dist/skills/larksuite/lark-base/references/lark-base-form-delete.md ADDED Viewed

@@ -0,0 +1,64 @@
+# base +form-delete
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+删除多维表格数据表中的指定表单。**不可逆操作**，执行前务必确认。
+## 命令
+```bash
+# 删除表单
+lark-cli base +form-delete \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id>
+# 预览（不实际执行）
+lark-cli base +form-delete \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --dry-run
+```
+## 参数
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token（base_token） |
+| `--table-id <id>` | 是 | 数据表 ID |
+| `--form-id <id>` | 是 | 要删除的表单 ID |
+| `--as` | 否 | 身份：user（默认）\| bot |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+## 输出格式
+```json
+{
+  "ok": true,
+  "data": {
+    "deleted": true,
+    "form_id": "vewX58te9D"
+  }
+}
+```
+## 工作流
+> [!CAUTION]
+> 这是**高风险写入操作（删除）** — 执行前必须明确向用户确认，告知此操作不可逆。
+1. 先用 `+form-list` 或 `+form-get` 确认目标表单存在
+2. 向用户展示将要删除的表单名称和 ID，等待明确确认
+3. 执行删除
+4. 报告删除结果
+## 提示
+- 删除前建议先用 `+form-questions-list` 了解表单内容，避免误删
+- `form_id` 可通过 `+form-list` 查询
+## 参考
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/dist/skills/larksuite/lark-base/references/lark-base-form-get.md ADDED Viewed

@@ -0,0 +1,68 @@
+# base +form-get
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+获取多维表格数据表中指定表单的详情。只读操作，不修改任何数据。
+## 命令
+```bash
+# 获取表单详情
+lark-cli base +form-get \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id>
+# 以 pretty 格式展示
+lark-cli base +form-get \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --format pretty
+# 使用应用身份（bot）
+lark-cli base +form-get \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --as bot
+```
+## 参数
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token（base_token） |
+| `--table-id <id>` | 是 | 数据表 ID |
+| `--form-id <id>` | 是 | 表单 ID |
+| `--format` | 否 | 输出格式：json（默认）\| pretty \| table \| ndjson \| csv |
+| `--as` | 否 | 身份：user（默认）\| bot |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+## 输出格式
+| 字段 | 说明 |
+|------|------|
+| `id` | 表单 ID |
+| `name` | 表单名称 |
+| `description` | 表单描述 |
+```json
+{
+  "ok": true,
+  "data": {
+    "id": "vewX58te9D",
+    "name": "用户调研问卷",
+    "description": "2024年度用户满意度调研"
+  }
+}
+```
+## 提示
+- `form_id` 可通过 `lark-cli base +form-list --base-token <token> --table-id <id>` 获取
+## 参考
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/dist/skills/larksuite/lark-base/references/lark-base-form-list.md ADDED Viewed

@@ -0,0 +1,73 @@
+# base +form-list
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+列出多维表格数据表中的所有表单。自动翻页，一次性返回全量结果。只读操作，不修改任何数据。
+## 命令
+```bash
+# 列出指定数据表的所有表单
+lark-cli base +form-list \
+  --base-token <base_token> \
+  --table-id <table_id>
+# 以表格形式展示
+lark-cli base +form-list \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --format table
+# 使用应用身份（bot）
+lark-cli base +form-list \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --as bot
+```
+## 参数
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token（base_token） |
+| `--table-id <id>` | 是 | 数据表 ID |
+| `--page-size <n>` | 否 | 每次请求的分页大小，默认 100，最大 100 |
+| `--format` | 否 | 输出格式：json（默认）\| pretty \| table \| ndjson \| csv |
+| `--as` | 否 | 身份：user（默认）\| bot |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+## 输出格式
+每条表单包含以下字段：
+| 字段 | 说明 |
+|------|------|
+| `id` | 表单 ID（如 `vewX58te9D`） |
+| `name` | 表单名称 |
+| `description` | 表单描述 |
+JSON 输出示例（`--format json`，默认）：
+```json
+{
+  "ok": true,
+  "data": {
+    "forms": [
+      {"id": "vewX58te9D", "name": "用户调研问卷", "description": "..."},
+      {"id": "form_yyyy",  "name": "产品反馈表",   "description": "..."}
+    ],
+    "total": 2
+  }
+}
+```
+## 提示
+- `base_token` 在多维表格 URL 中可找到（形如 `bascnXXXX`）
+- `table_id` 可通过 `lark-cli base +table-list --base-token <base_token>` 获取
+- 如无表单，输出 `forms: []`
+## 参考
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数