@fectivnfy112358/minimax-code-web 0.1.0-preview.0 → 0.1.0-preview.3

package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-set-visible-fields.md

@@ -0,0 +1,73 @@
+# base +view-set-visible-fields
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+更新视图可见字段列表（同时控制视图中的字段顺序）。
+
+## 推荐命令
+
+```bash
+lark-cli base +view-set-visible-fields \
+  --base-token XXXXXX \
+  --table-id tblXXX \
+  --view-id vewXXX \
+  --json '{"visible_fields":["标题","fldXXX"]}'
+```
+
+## JSON 结构
+
+```json
+{
+  "visible_fields": ["标题", "fldXXX"]
+}
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+| `--view-id <id_or_name>` | 是 | 视图 ID 或视图名 |
+| `--json <body>` | 是 | JSON 对象，且必须包含 `visible_fields` |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+PUT /open-apis/base/v3/bases/:base_token/tables/:table_id/views/:view_id/visible_fields
+```
+
+**接口 body 格式：**
+
+```json
+{
+  "visible_fields": ["标题", "fldXXX"]
+}
+```
+
+## 返回重点
+
+- 返回可见字段列表与顺序（`primaryField` 会被强制置顶）。
+
+## 结构规则
+
+- `visible_fields`：字符串数组，每项可传字段 id 或字段名
+- 数组顺序用于控制视图字段顺序；主字段 `primaryField` 必须存在且位于第一位，否则 API 会强制将其提升到第一位
+- `--json` 必须传对象：`{ "visible_fields": [...] }`
+
+## 工作流
+
+1. 用户要求“改字段顺序”或“设置可见字段”时，直接使用本命令。
+2. 建议优先使用字段 id，避免字段重名或后续改名带来的歧义。
+
+## 坑点
+
+- ⚠️ 这是写入操作，执行前必须确认。
+- ⚠️ 接口最终结果会受后端 `primaryField` 强制显示规则影响，返回顺序可能与传入数组不同。
+- ⚠️ 如果传字段名，必须与当前表真实字段名精确匹配。
+
+## 参考
+
+- [lark-base-view.md](lark-base-view.md) — view 索引页

package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view.md

@@ -0,0 +1,44 @@
+# base view shortcuts
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+view 相关命令索引。
+
+## 命令导航
+
+| 文档 | 命令 | 说明 |
+|------|------|------|
+| [lark-base-view-list.md](lark-base-view-list.md) | `+view-list` | 分页列视图 |
+| [lark-base-view-get.md](lark-base-view-get.md) | `+view-get` | 获取视图基本信息 |
+| [lark-base-view-create.md](lark-base-view-create.md) | `+view-create` | 创建视图 |
+| [lark-base-view-delete.md](lark-base-view-delete.md) | `+view-delete` | 删除视图 |
+| [lark-base-view-rename.md](lark-base-view-rename.md) | `+view-rename` | 重命名视图 |
+| [lark-base-view-get-filter.md](lark-base-view-get-filter.md) | `+view-get-filter` | 读取筛选配置 |
+| [lark-base-view-set-filter.md](lark-base-view-set-filter.md) | `+view-set-filter` | 更新筛选配置 |
+| [lark-base-view-get-visible-fields.md](lark-base-view-get-visible-fields.md) | `+view-get-visible-fields` | 读取可见字段列表 |
+| [lark-base-view-set-visible-fields.md](lark-base-view-set-visible-fields.md) | `+view-set-visible-fields` | 更新可见字段列表 |
+| [lark-base-view-get-group.md](lark-base-view-get-group.md) | `+view-get-group` | 读取分组配置 |
+| [lark-base-view-set-group.md](lark-base-view-set-group.md) | `+view-set-group` | 更新分组配置 |
+| [lark-base-view-get-sort.md](lark-base-view-get-sort.md) | `+view-get-sort` | 读取排序配置 |
+| [lark-base-view-set-sort.md](lark-base-view-set-sort.md) | `+view-set-sort` | 更新排序配置 |
+| [lark-base-view-get-timebar.md](lark-base-view-get-timebar.md) | `+view-get-timebar` | 读取时间轴配置 |
+| [lark-base-view-set-timebar.md](lark-base-view-set-timebar.md) | `+view-set-timebar` | 更新时间轴配置 |
+| [lark-base-view-get-card.md](lark-base-view-get-card.md) | `+view-get-card` | 读取卡片配置 |
+| [lark-base-view-set-card.md](lark-base-view-set-card.md) | `+view-set-card` | 更新卡片配置 |
+
+## AI 决策前置
+
+先判断视图类型，再选接口能力；不支持的能力直接不要调用。
+
+| 视图类型 | 可用能力 |
+|------|------|
+| `grid` | `group` `sort` `filter` |
+| `kanban` | `group` `sort` `filter` `card` |
+| `gallery` | `sort` `filter` `card` |
+| `calendar` | `filter` `timebar` |
+| `gantt` | `group` `sort` `filter` `timebar` |
+
+## 说明
+
+- 聚合页只保留目录职责；每个命令的详细说明请进入对应单命令文档。
+- 所有 `+xxx-list` 调用都必须串行执行；若要批量跑多个 list 请求，只能串行执行。

package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-workflow-create.md

@@ -0,0 +1,180 @@
+# base +workflow-create
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+在 Base 中创建一个新的自动化工作流。新建后状态为 `disabled`，需调用 `+workflow-enable` 才能启用。
+
+## ⚠️ 执行前必读
+
+创建工作流前请按顺序完成：
+
+1. **先读本文档**，了解 `--json` 参数格式和 `client_token` 的必填要求
+2. **阅读 [workflow-guide.md](lark-base-workflow-guide.md)**，获取 Loop、IfElseBranch、SwitchBranch 等**完整示例**
+3. **参考 [workflow-schema.md](lark-base-workflow-schema.md)**，查询具体字段定义
+4. **不需要先调用 `+workflow-list`**，创建操作不依赖现有工作流列表
+5. **按需调用 `+table-list` 和 `+field-list`** 获取表名和字段名（只在需要时调用）
+6. **若遇到单多选字段，可调用`+field-get`命令**来获取选项详情
+7. **调用命令时，请将 body 数据直接通过 --json 传入，禁止创建任何的临时文件，即禁止使用 --json @filename**
+
+**常见错误**:
+- ❌ 缺少 `client_token` → 报错: `client token is empty`
+- ❌ 猜测 StepType → 报错: `unknown step type 'CreateTrigger'`（应该是 `AddRecordTrigger`）
+- ❌ 字段引用路径错误 → 报错: `prompt references an unknown reference`
+
+> 💡 **提示**: 复杂场景（循环、分支、多步骤组合）的完整示例请直接阅读 [workflow-guide.md](lark-base-workflow-guide.md)，本文档只包含基础用法。
+
+## 推荐命令
+
+```bash
+lark-cli base +workflow-create \
+  --base-token BascXxxxxx \
+  --json '{"client_token":"1704067200","title":"新订单自动通知","steps":[{"id":"trigger_1","type":"AddRecordTrigger","title":"监控新订单","next":"action_1","data":{"table_name":"订单表","watched_field_name":"订单号"}},{"id":"action_1","type":"LarkMessageAction","title":"发送通知","next":null,"data":{"receiver":[{"value_type":"user","value":{"id":"ou_xxxx"}}],"send_to_everyone":false,"title":[{"value_type":"text","value":"新订单提醒"}],"content":[{"value_type":"text","value":"收到新订单"}],"btn_list":[]}}]}'
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | 多维表格 Base Token（`Basc` 开头） |
+| `--json <body>` | 是 | 工作流 body JSON，包含 `title` 和 `steps` |
+
+## 如何从链接中提取参数
+
+用户通常会提供如下 URL：
+
+```
+https://example.feishu.cn/base/<base_token>
+```
+
+- `--base-token`：取 `/base/` 后面的字符串（`Basc` 开头）
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+POST /open-apis/base/v3/bases/:base_token/workflows
+```
+
+**Path 参数：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `base_token` | 是 | 多维表格 Base Token |
+
+**Request Body（JSON）：**
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `client_token` | string | **是** | 幂等键，每次创建必须传一个唯一随机值（如时间戳 `"1704067200"`），防重复提交，缺失会报错 |
+| `title` | string | 否 | 工作流标题 |
+| `steps` | WorkflowStep[] | 否 | 步骤列表 |
+| `user_id_type` | string | 否 | 用户 ID 类型：`open_id` / `union_id` / `user_id`，默认 `open_id` |
+
+> **步骤数据结构非常复杂，详见 [lark-base-workflow-schema.md](lark-base-workflow-schema.md)**
+
+**Request Body 示例：**
+```json
+{
+  "client_token": "124131231421312312",
+  "title": "新订单自动通知",
+  "steps": [
+    {
+      "id": "trigger_1",
+      "type": "AddRecordTrigger",
+      "title": "监控新订单",
+      "next": "action_1",
+      "data": {
+        "table_name": "订单表",
+        "watched_field_name": "订单号"
+      }
+    },
+    {
+      "id": "action_1",
+      "type": "LarkMessageAction",
+      "title": "发送通知",
+      "next": null,
+      "data": {
+        "receiver": [{ "value_type": "user", "value": {"id": "ou_xxxx"} }],
+        "send_to_everyone": false,
+        "title": [{ "value_type": "text", "value": "新订单提醒" }],
+        "content": [
+          { "value_type": "text", "value": "收到新订单，客户：" },
+          { "value_type": "ref", "value": "$.trigger_1.fldCustomerName" }
+        ],
+        "btn_list": []
+      }
+    }
+  ]
+}
+```
+
+## API 出参详情
+
+**Response `data` 字段：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `workflow_id` | string | 新建工作流的唯一 ID（`wkf` 开头） |
+| `title` | string | 工作流标题 |
+| `status` | string | 工作流状态，新建固定为 `disabled` |
+| `steps` | WorkflowStep[] | 完整步骤列表 |
+| `creator_id` | string | 创建人 OpenID |
+| `updater_id` | string | 最后修改人 OpenID |
+| `create_time` | number | 创建时间（Unix 秒级时间戳） |
+| `update_time` | number | 更新时间（Unix 秒级时间戳） |
+
+## 返回值
+
+```json
+{
+  "ok": true,
+  "data": {
+    "workflow_id": "wkfosaYTS1V6rhjF",
+    "title": "新订单自动通知",
+    "status": "disabled",
+    "steps": [...],
+    "creator_id": "ou_xxxx",
+    "updater_id": "ou_xxxx",
+    "create_time": 1704067200,
+    "update_time": 1704067200
+  }
+}
+```
+
+## 工作流
+
+> [!CAUTION]
+> 这是**写入操作** — 执行前必须向用户确认。
+
+1. 与用户确认 `--base-token` 和工作流定义（`--json` 内容）
+2. 执行命令，报告返回的 `workflow_id`（`wkf` 开头）
+3. 提示用户：新建工作流初始状态为 `disabled`，需调用 `+workflow-enable --workflow-id <返回的 workflow_id>` 才会生效
+
+## 坑点
+
+> ⚠️ **【重要】client_token 必传**：缺失会返回 `[code=800004006] client token is empty`，这**不是权限问题**，是 **JSON body 缺字段**。每次请求传唯一值即可（如 `"$(date +%s)"` 或 `"1743078000"`）
+
+- ⚠️ **新建后默认禁用**：`status` 固定返回 `disabled`，需要额外调用 `+workflow-enable` 才能让工作流生效；不要误报"创建成功即启用"
+- ⚠️ **steps 中 id 字段必须唯一**：每个步骤的 `id` 由调用方指定，且在工作流内必须唯一；`next` 和 `children.links[].to` 引用的 ID 必须在同一 steps 数组中存在，否则服务端返回 `[2200] Internal Error`
+- ⚠️ **字段类型校验**：设置字段值时，`value_type` 必须与字段实际类型匹配：
+   - **select 类型字段**（单选/多选/流程）：必须用 `option`，不能用 `text`
+     ```json
+     // ✅ 正确
+     { "field_name": "大区", "value": [{"value_type": "option", "value": {"name": "华东"}}] }
+     // ❌ 错误 - 会报错 valueType 'text' not allowed for fieldType '3'
+     { "field_name": "大区", "value": [{"value_type": "text", "value": "华东"}] }
+     ```
+   - **SetRecordTrigger 的 field_watch_info** 同样受此限制，select 类型字段的 value 必须用 `option`
+     常见 action 输出：`FindRecordAction` → `$.step_id.recordNum`（记录数）、`$.step_id.fieldRecords`（查找到的记录列表）；`AddRecordAction` → `$.step_id.recordId`
+- ⚠️ **权限不足**：如遇 `permission denied`，先确认当前身份（bot 或 user）是否对该 Base 有编辑权限，再检查 scope 是否已开通。参考 [lark-shared](../../lark-shared/SKILL.md) 中的权限不足处理流程
+- ⚠️ **user_id_type**：涉及用户的 `value_type: "user"` 的 value 字段传 OpenID，服务端会根据 `user_id_type`（默认 `open_id`）解析；如需传 `user_id` 格式需在 body 里显式声明 `"user_id_type": "user_id"`
+
+## 参考
+
+- [lark-base-workflow-schema.md](lark-base-workflow-schema.md) — 完整 Workflow 数据结构
+- [lark-base-workflow-update](lark-base-workflow-update.md) — 全量更新工作流
+- [lark-base-workflow-enable](lark-base-workflow-enable.md) — 启用工作流
+- [lark-base-workflow-list](lark-base-workflow-list.md) — 列出全部工作流
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-workflow-disable.md

@@ -0,0 +1,94 @@
+# base +workflow-disable
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+禁用 Base 中的一个自动化工作流。
+
+## 推荐命令
+
+```bash
+lark-cli base +workflow-disable \
+  --base-token BascXxxxxx \
+  --workflow-id wkfxxxxxx
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | 多维表格 Base Token（`Basc` 开头） |
+| `--workflow-id <id>` | 是 | 工作流 ID（`wkf` 开头） |
+
+## 如何从链接中提取参数
+
+用户通常会提供如下 URL：
+
+```
+https://example.feishu.cn/base/<base_token>?table=<table_or_workflow_id>
+```
+
+- `--base-token`：取 `/base/` 后面的字符串（`Basc` 开头）
+- `--workflow-id`：取 `?table=` 后面的值，当其以 `wkf` 开头时即为 workflow_id
+
+> ⚠️ **注意区分 ID 前缀**：table_id 以 `tbl` 开头，workflow_id 以 `wkf` 开头，两者在 URL 的 `?table=` 参数里都会出现，需要根据前缀判断。
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+PATCH /open-apis/base/v3/bases/:base_token/workflows/:workflow_id/disable
+```
+
+**Path 参数：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `base_token` | 是 | 多维表格 Base Token |
+| `workflow_id` | 是 | 工作流唯一标识 |
+
+**Request Body：** 无
+
+## API 出参详情
+
+**Response `data` 字段：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `workflow_id` | string | 工作流唯一标识符 |
+| `status` | string | 操作后的最新状态，固定为 `disabled` |
+
+## 返回值
+
+```json
+{
+  "ok": true,
+  "data": {
+    "workflow_id": "wkfxxxxxx",
+    "status": "disabled"
+  }
+}
+```
+
+## 工作流
+
+> [!CAUTION]
+> 这是**写入操作** — 执行前必须向用户确认。
+
+1. 向用户确认 `--base-token` 和 `--workflow-id`
+2. 执行命令
+3. 报告返回的 `status` 字段，确认值为 `disabled`
+
+## 坑点
+
+- ⚠️ **workflow_id 来源**：workflow_id 以 `wkf` 开头，从 URL 的 `?table=wkf...` 参数提取，不是表格的 table_id（`tbl` 开头），混淆会导致 `[2200] Internal Error`
+- ⚠️ **API 路径末尾动词**：`/disable` 是路径的最后一段，不是 body 字段；漏掉这个后缀会命中错误接口
+- ⚠️ **PATCH body 不能为 nil**：接口虽无请求体，仍需传 `{}` 空对象，否则服务端可能返回 `server time out error`
+- ⚠️ **scope 待确认**：内部文档未列出权限名称，代码中使用 `base:workflow:update`，如遇 `[230013] permission denied` 需核对实际 scope
+
+## 参考
+
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-base-workflow-enable](lark-base-workflow-enable.md) — 启用工作流
+- [lark-base-workflow-list](lark-base-workflow-list.md) — 列出全部工作流
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-workflow-enable.md

@@ -0,0 +1,94 @@
+# base +workflow-enable
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+启用 Base 中的一个自动化工作流。
+
+## 推荐命令
+
+```bash
+lark-cli base +workflow-enable \
+  --base-token BascXxxxxx \
+  --workflow-id wkfxxxxxx
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | 多维表格 Base Token（`Basc` 开头） |
+| `--workflow-id <id>` | 是 | 工作流 ID（`wkf` 开头） |
+
+## 如何从链接中提取参数
+
+用户通常会提供如下 URL：
+
+```
+https://example.feishu.cn/base/<base_token>?table=<table_or_workflow_id>
+```
+
+- `--base-token`：取 `/base/` 后面的字符串（`Basc` 开头）
+- `--workflow-id`：取 `?table=` 后面的值，当其以 `wkf` 开头时即为 workflow_id
+
+> ⚠️ **注意区分 ID 前缀**：table_id 以 `tbl` 开头，workflow_id 以 `wkf` 开头，两者在 URL 的 `?table=` 参数里都会出现，需要根据前缀判断。
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+PATCH /open-apis/base/v3/bases/:base_token/workflows/:workflow_id/enable
+```
+
+**Path 参数：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `base_token` | 是 | 多维表格 Base Token |
+| `workflow_id` | 是 | 工作流唯一标识 |
+
+**Request Body：** 无
+
+## API 出参详情
+
+**Response `data` 字段：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `workflow_id` | string | 工作流唯一标识符 |
+| `status` | string | 操作后的最新状态，固定为 `enabled` |
+
+## 返回值
+
+```json
+{
+  "ok": true,
+  "data": {
+    "workflow_id": "wkfxxxxxx",
+    "status": "enabled"
+  }
+}
+```
+
+## 工作流
+
+> [!CAUTION]
+> 这是**写入操作** — 执行前必须向用户确认。
+
+1. 向用户确认 `--base-token` 和 `--workflow-id`
+2. 执行命令
+3. 报告返回的 `status` 字段，确认值为 `enabled`
+
+## 坑点
+
+- ⚠️ **workflow_id 来源**：workflow_id 以 `wkf` 开头，从 URL 的 `?table=wkf...` 参数提取，不是表格的 table_id（`tbl` 开头），混淆会导致 `[2200] Internal Error`
+- ⚠️ **API 路径末尾动词**：`/enable` 是路径的最后一段，不是 body 字段；漏掉这个后缀会命中错误接口
+- ⚠️ **PATCH body 不能为 nil**：接口虽无请求体，仍需传 `{}` 空对象，否则服务端可能返回 `server time out error`
+- ⚠️ **scope 待确认**：内部文档未列出权限名称，代码中使用 `base:workflow:update`，如遇 `[230013] permission denied` 需核对实际 scope
+
+## 参考
+
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-base-workflow-disable](lark-base-workflow-disable.md) — 禁用工作流
+- [lark-base-workflow-list](lark-base-workflow-list.md) — 列出全部工作流
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-workflow-get.md

@@ -0,0 +1,147 @@
+# base +workflow-get
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+> 💡 **按需查阅：** 如需深入理解返回的 `steps` 节点结构，可参考 [workflow-schema.md](lark-base-workflow-schema.md)。简单统计（如节点数量）无需阅读 schema。
+
+获取一个 workflow 的完整定义，包括标题、状态、所有步骤（steps）及其配置。
+
+## 推荐命令
+
+```bash
+# 基本用法
+lark-cli base +workflow-get \
+  --base-token BascXxxxxx \
+  --workflow-id wkfxxxxxx
+
+# 指定用户 ID 类型（creator_id / updater_id 字段的格式）
+lark-cli base +workflow-get \
+  --base-token BascXxxxxx \
+  --workflow-id wkfxxxxxx \
+  --user-id-type open_id
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | 多维表格 Base Token，以 `Basc` 开头 |
+| `--workflow-id <id>` | 是 | Workflow ID，以 `wkf` 开头 |
+| `--user-id-type <type>` | 否 | 控制 `creator_id` / `updater_id` 字段返回的用户 ID 格式；枚举值：`open_id`（默认）、`union_id`、`user_id` |
+
+## 如何从链接中提取参数
+
+用户通常会提供如下 URL（在 Base 的自动化管理页面复制）：
+
+```
+https://xxx.feishu.cn/base/<base_token>?table=<table_id>&view=<view_id>
+```
+
+- `--base-token`：取 `/base/` 后面的字符串（`Basc` 开头）
+- `--workflow-id`：以 `wkf` 开头，可从 `+workflow-list` 的输出中获取，URL 上通常不直接暴露
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+GET /open-apis/base/v3/bases/:base_token/workflows/:workflow_id
+```
+
+**Path 参数：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `base_token` | 是 | 多维表格 Base Token |
+| `workflow_id` | 是 | Workflow ID（`wkf` 开头） |
+
+**Query 参数：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `user_id_type` | 否 | 用户 ID 类型：`open_id` / `union_id` / `user_id` |
+
+**Request Body：** 无
+
+## API 出参详情
+
+**Response `data` 字段：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `workflow_id` | string | Workflow 唯一标识，`wkf` 开头 |
+| `title` | string | Workflow 标题 |
+| `status` | string | 状态：`enabled`（已启用）/ `disabled`（已停用） |
+| `creator_id` | string | 创建人 ID（格式受 `user_id_type` 控制） |
+| `updater_id` | string | 最后修改人 ID |
+| `create_time` | string | 创建时间（Unix 时间戳，秒） |
+| `update_time` | string | 最后更新时间（Unix 时间戳，秒） |
+| `steps` | []step | 步骤列表，见下方 |
+
+**steps 元素字段：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `id` | string | 步骤唯一 ID |
+| `type` | string | 步骤类型，见 [workflow-schema.md](lark-base-workflow-schema.md) |
+| `title` | string | 步骤标题 |
+| `children` | object | 子关系边，`children.links[]` 承担分支/循环/slot 连线，结构见 schema |
+| `children.links[].kind` | string | 关系类型：`if_true` / `if_false` / `case` / `loop_start` / `slot` |
+| `children.links[].to` | string | 目标节点 ID |
+| `children.links[].label` | string | 可选标签（如 `branch_1`、`tool`） |
+| `children.links[].desc` | string | 可选语义说明 |
+| `next` | string \| null | 线性后继节点 ID；`null` 表示流程结束 |
+| `data` | object | 步骤详细配置，结构随 `type` 变化，见 [workflow-schema.md](lark-base-workflow-schema.md) |
+| `meta` | object | 扩展元信息，仅 `APIHubAction` / `AIAgentLLMAction` / `AIAgentMCPAction` 等子节点有值 |
+
+> 步骤类型（`type`）的完整枚举和每种类型的 `data` 字段结构，参见 [lark-base-workflow-schema.md](lark-base-workflow-schema.md)。
+
+## 返回值
+
+命令成功后输出 JSON：
+
+```json
+{
+  "ok": true,
+  "data": {
+    "workflow_id": "wkfxxxxxx",
+    "title": "新订单自动通知",
+    "status": "enabled",
+    "creator_id": "ou_xxxx",
+    "updater_id": "ou_xxxx",
+    "create_time": "1704067200",
+    "update_time": "1704153600",
+    "steps": [
+      {
+        "id": "trigger_1",
+        "type": "AddRecordTrigger",
+        "title": "监控新订单",
+        "next": "action_1",
+        "data": { "table_name": "订单表", "watched_field_name": "订单号" }
+      },
+      {
+        "id": "action_1",
+        "type": "LarkMessageAction",
+        "title": "发送通知",
+        "next": null,
+        "data": { "..." : "..." }
+      }
+    ]
+  }
+}
+```
+
+## 坑点
+
+- ⚠️ **workflow_id 来源**：`workflow_id` 以 `wkf` 开头，从 `+workflow-list` 命令输出中获取；URL 上通常拿不到，不要把 `table_id`（`tbl` 开头）误当成 `workflow_id`
+- ⚠️ **steps 可能为空**：未配置任何步骤的 workflow 返回的 `steps` 为空数组，不代表接口异常
+- ⚠️ **文档中 `title` 字段类型标注为 int**：这是文档笔误，实际为 string
+- ⚠️ **API 路径版本**：本接口使用 `base/v3`，路径必须从原始文档提取，禁止用 WebSearch 补全，否则会拿到错误路径导致 `[2200] Internal Error`
+- ⚠️ **只读接口，GET 请求 body 传 nil**：`baseV3Call` 的 body 参数传 `nil` 是正确的，不同于 PATCH/POST 写接口
+
+## 参考
+
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-base-workflow-schema.md](lark-base-workflow-schema.md) — Workflow 步骤数据结构完整参考
+- [lark-base-workflow-list.md](lark-base-workflow-list.md) — 列出所有 workflow（可用来获取 workflow_id）
+- [lark-base-workflow-create.md](lark-base-workflow-create.md) — 创建 workflow
+- [lark-base-workflow-update.md](lark-base-workflow-update.md) — 更新 workflow