@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-shortcut-record-value.md

@@ -0,0 +1,200 @@
+# base shortcut record JSON 规范（lark-base-shortcut-record-value）
+
+> 适用命令：`lark-cli base +record-upsert`
+
+本文件定义 **shortcut 写记录** 时 `--json` 的推荐格式，目标是让 AI 一次写对。
+
+## 1. 顶层规则（必须遵守）
+
+- `--json` 必须是 JSON 对象。
+- 顶层直接传字段映射：`{"字段名或字段ID": 值}`。
+- 一次 payload 里同一字段只用一种 key（字段名或字段 ID），不要重复。
+- 写入前先 `+field-list` 获取字段 `type/style/multiple`，再构造值。
+
+## 2. 各类型值格式与示例
+
+### 2.1 text / phone / url
+
+**推荐值**：字符串。
+
+```json
+{
+    "标题": "Hello",
+    "联系电话": "1380000000000",
+    "官网": "https://example.com"
+}
+```
+
+**Schema**
+
+```json
+{ "type": "string", "description": "text field cell, example: \"one string and [one url](https://foo.bar)\"" }
+```
+
+### 2.2 number
+
+**推荐值**：数字。
+
+```json
+{
+    "工时": 12.5,
+    "预算": 3000
+}
+```
+
+**Schema**
+
+```json
+{ "type": "number", "description": "number field cell, can be any float64 value" }
+```
+
+### 2.3 select（单选/多选/阶段）
+
+**推荐值**：
+- 单选：字符串
+- 多选：字符串数组
+
+```json
+{
+    "状态": "Todo",
+    "标签": ["后端", "高优"]
+}
+```
+
+**Schema**
+
+```json
+{ "type": "array", "items": { "type": "string", "description": "option name" }, "description": "select field cell, example: [\"option_1\", \"option_2\"]" }
+```
+
+### 2.4 datetime
+
+**推荐值**：`YYYY-MM-DD HH:mm:ss` 字符串（稳妥写法）。
+
+```json
+{
+    "截止时间": "2026-03-24 10:00:00"
+}
+```
+
+**Schema**
+
+```json
+{ "type": "string", "description": "datetime field cell. accepts common datetime strings and timestamp-like values. Prefer \"YYYY-MM-DD HH:mm:ss\" in requests because it is the most stable format and matches the API output. Example: \"2026-01-01 19:30:00\"" }
+```
+
+### 2.5 checkbox
+
+**推荐值**：布尔值。
+
+```json
+{
+    "已完成": true
+}
+```
+
+**Schema**
+
+```json
+{ "type": "boolean", "description": "checkbox field cell" }
+```
+
+### 2.6 user
+
+**推荐值**：对象数组，元素至少有 `id`。
+
+```json
+{
+    "负责人": [
+      { "id": "ou_xxx" }
+    ]
+}
+```
+
+**Schema**
+
+```json
+{ "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "user id" } }, "required": ["id"], "additionalProperties": false }, "description": "user field cell, example: [{\"id\": \"ou_123\"}]" }
+```
+
+### 2.7 link
+
+**推荐值**：对象数组，元素至少有 `id`。
+
+```json
+{
+    "关联任务": [
+      { "id": "rec_xxx" }
+    ]
+}
+```
+
+**Schema**
+
+```json
+{ "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "record id" } }, "required": ["id"], "additionalProperties": false }, "description": "link field cell, example: [{\"id\": \"rec_123\"}]" }
+```
+
+### 2.8 location
+
+**推荐值**：对象 `{lng, lat}`。
+
+```json
+{
+    "坐标": {
+      "lng": 116.397428,
+      "lat": 39.90923
+    }
+}
+```
+
+**Schema**
+
+```json
+{
+  "type": "object",
+  "properties": { "lng": { "type": "number", "description": "Longitude" }, "lat": { "type": "number", "description": "Latitude" } },
+  "required": ["lng", "lat"],
+  "additionalProperties": false,
+  "description": "location field cell, example: {\"lng\": 113.94765, \"lat\": 22.528533}"
+}
+```
+
+### 2.9 attachment
+
+对 agent 而言，附件上传是**特殊链路**：如果用户要把本地文件加到记录里，必须使用 `lark-cli base +record-upload-attachment` 上传到已有记录。
+
+**Schema - attachment**
+
+```json
+{
+  "type": "array",
+  "items": { "type": "object", "properties": { "file_token": { "type": "string", "minLength": 0, "maxLength": 50 }, "name": { "type": "string", "minLength": 1, "maxLength": 255 } }, "required": ["file_token", "name"], "additionalProperties": false },
+  "description": "attachment field cell. For agent, do not synthesize this payload via +record-upsert; must use +record-upload-attachment to upload files."
+}
+```
+
+## 3. 只读字段（不要写）
+
+以下字段在写记录时应视为只读：
+- `auto_number`
+- `lookup`
+- `formula`
+- `created_time` / `modified_time`
+- `created_by` / `modified_by`
+
+## 4. 快速可用完整示例
+
+```json
+{
+    "标题": "Created from shortcut",
+    "状态": "Todo",
+    "标签": ["高优", "外部依赖"],
+    "工时": 8,
+    "截止时间": "2026-03-24 10:00:00",
+    "已完成": false,
+    "负责人": [{ "id": "ou_123" }],
+    "关联任务": [{ "id": "rec_456" }],
+    "坐标": { "lng": 116.397428, "lat": 39.90923 }
+}
+```

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

@@ -0,0 +1,62 @@
+# base +table-create
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+创建数据表；可选地继续创建字段和视图。
+
+## 推荐命令
+
+```bash
+lark-cli base +table-create \
+  --base-token app_xxx \
+  --name "客户名单"
+
+lark-cli base +table-create \
+  --base-token app_xxx \
+  --name "项目管理" \
+  --fields '[{"name":"项目名称","type":"text"}]' \
+  --view '[{"name":"默认表格","type":"grid"}]' 
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--name <name>` | 是 | 新表名称 |
+| `--fields <json>` | 否 | 字段 JSON 数组 |
+| `--view <json>` | 否 | 视图 JSON 对象或数组 |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+POST /open-apis/base/v3/bases/:base_token/tables
+```
+
+- 如果传了 `--fields`，CLI 会继续调用字段接口。
+- 如果传了 `--view`，CLI 会继续调用视图接口。
+
+## 返回重点
+
+- 至少返回 `table`。
+- 传了 `--fields` / `--view` 时，还会附带 `fields` / `views`。
+
+## 工作流
+
+
+1. 先只传 `--name` 建空表。
+2. 字段或视图参数较复杂时，先精简到最小必需字段，再以内联 JSON 传参。
+
+## 坑点
+
+- ⚠️ 这是写入操作，执行前必须确认。
+- ⚠️ CLI 会用 `--fields` 的第一个元素更新系统默认首列，后续元素才是新增字段。
+- ⚠️ 不要并行改同一张表，避免状态竞争。
+
+## 参考
+
+- [lark-base-table.md](lark-base-table.md) — table 索引页
+- [lark-base-field-create.md](lark-base-field-create.md) — 建字段
+- [lark-base-view-create.md](lark-base-view-create.md) — 建视图

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

@@ -0,0 +1,51 @@
+# base +table-delete
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+删除一张表。
+
+## 推荐命令
+
+```bash
+lark-cli base +table-delete \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --yes
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+DELETE /open-apis/base/v3/bases/:base_token/tables/:table_id
+```
+
+## 返回重点
+
+- 返回 `deleted: true` 以及删除目标的 `table_id / table_name`。
+
+## 工作流
+
+> 这是**高风险写入操作**。CLI 层要求显式传 `--yes`；如果用户已经明确要求删除且目标明确，直接执行并带上 `--yes`，不要再补一次确认。
+
+1. 建议先用 `+table-list` 或 `+table-get` 确认目标。
+2. 只有当目标表仍不明确时，才继续追问；如果删除意图和目标都明确，直接执行。
+
+## 坑点
+
+- ⚠️ 高风险不可逆操作。
+- ⚠️ 删除场景强烈建议传 `tbl_xxx`，不要传表名。
+- ⚠️ 忘记带 `--yes` 会被 CLI 拦截。
+
+## 参考
+
+- [lark-base-table.md](lark-base-table.md) — table 索引页
+- [lark-base-table-list.md](lark-base-table-list.md) — 列表

package/server/assets/skills/lark-tools/cli-skills/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/server/assets/skills/lark-tools/cli-skills/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/server/assets/skills/lark-tools/cli-skills/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/server/assets/skills/lark-tools/cli-skills/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/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-create.md

@@ -0,0 +1,83 @@
+# base +view-create
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+创建一个或多个视图。
+
+## 推荐命令
+
+```bash
+lark-cli base +view-create \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --json '{"name":"进行中","type":"grid"}' 
+
+lark-cli base +view-create \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --json '[{"name":"进行中","type":"grid"},{"name":"日历","type":"calendar"}]'
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+| `--json <body>` | 是 | 视图 JSON 对象或数组 |
+
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+POST /open-apis/base/v3/bases/:base_token/tables/:table_id/views
+```
+
+## 返回重点
+
+- 总是返回 `views` 数组；即使只创建了一个视图也一样。
+
+## 关键规则
+
+- `type` 仅支持 `grid` `kanban` `gallery` `calendar` `gantt`。
+- `/views` 不接受 `type=form`；表单创建走 `/forms`。
+- `name` 必填，长度 `1..100`，且同表内必须唯一。
+
+## JSON 结构（`--json`）
+
+支持单对象或对象数组：
+
+```json
+{ "name": "进行中", "type": "grid" }
+```
+
+```json
+[
+  { "name": "进行中", "type": "grid" },
+  { "name": "日历", "type": "calendar" }
+]
+```
+
+
+## JSON Schema（原文）
+
+```json
+{"type":"object","properties":{"type":{"type":"string","enum":["grid","kanban","gallery","gantt","calendar"],"default":"grid","description":"view type"},"name":{"type":"string","minLength":1,"maxLength":100,"description":"View name"}},"required":["name"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}
+
+```
+
+## 工作流
+
+
+1. 多视图批量创建时，优先用数组一次提交，减少重复调用。
+2. 如果用户要“查看视图字段顺序”或“查看可见字段”，使用 `+view-get-visible-fields` 读取当前 `visible_fields`。
+3. 如果用户同时要求“视图字段顺序”或“可见字段”，创建完成后必须继续调用 `+view-set-visible-fields` 设置 `visible_fields`；`+view-create` 本身不负责字段顺序/可见性配置。
+
+## 坑点
+
+- ⚠️ 这是写入操作，执行前必须确认。
+
+## 参考
+
+- [lark-base-view.md](lark-base-view.md) — view 索引页

package/server/assets/skills/lark-tools/cli-skills/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/server/assets/skills/lark-tools/cli-skills/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/server/assets/skills/lark-tools/cli-skills/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 索引页