@lark-apaas/coding-steering 0.1.6-alpha.8 → 0.1.6-beta.0

package/steering/design-stack/skills/feishu/references/calendar.md

@@ -1,190 +0,0 @@
-# 日历与会议室 (Calendar)
-
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/server-docs/calendar-v4/overview.md
-
-使用 `@larksuiteoapi/node-sdk` 在 NestJS 中管理日程、预约会议室和查询忙闲状态。
-
-## 所需权限
-
-| 权限标识 | 说明 |
-|----------|------|
-| `calendar:calendar` | 读写日历及日程信息 |
-| `vc:room:readonly` | 查询/搜索会议室 |
-| `contact:user.employee_id:readonly` | 获取用户 ID（可选） |
-
-## 创建日程
-
-```typescript
-const res = await client.calendar.calendarEvent.create({
-  path: { calendar_id: 'primary' }, // 'primary' 表示主日历
-  data: {
-    summary: '产品评审会议',
-    description: 'Q1 产品路线图评审',
-    start_time: {
-      timestamp: String(Math.floor(new Date('2026-02-13T14:00:00+08:00').getTime() / 1000)),
-    },
-    end_time: {
-      timestamp: String(Math.floor(new Date('2026-02-13T15:00:00+08:00').getTime() / 1000)),
-    },
-    attendee_ability: 'can_invite_others',
-  },
-});
-const eventId = res.data?.event?.event_id;
-```
-
-## 更新日程
-
-```typescript
-await client.calendar.calendarEvent.patch({
-  path: { calendar_id: 'primary', event_id: eventId },
-  data: {
-    summary: '产品评审会议（更新）',
-    end_time: {
-      timestamp: String(Math.floor(new Date('2026-02-13T15:30:00+08:00').getTime() / 1000)),
-    },
-  },
-});
-```
-
-## 获取日程详情
-
-```typescript
-const detail = await client.calendar.calendarEvent.get({
-  path: { calendar_id: 'primary', event_id: eventId },
-});
-```
-
-## 获取日程列表
-
-```typescript
-const events = await client.calendar.calendarEvent.list({
-  path: { calendar_id: 'primary' },
-  params: {
-    start_time: String(Math.floor(new Date('2026-02-13T00:00:00+08:00').getTime() / 1000)),
-    end_time: String(Math.floor(new Date('2026-02-14T00:00:00+08:00').getTime() / 1000)),
-    page_size: 50,
-  },
-});
-```
-
-## 删除日程
-
-```typescript
-await client.calendar.calendarEvent.delete({
-  path: { calendar_id: 'primary', event_id: eventId },
-});
-```
-
-## 添加参与人
-
-```typescript
-await client.calendar.calendarEventAttendee.create({
-  path: { calendar_id: 'primary', event_id: eventId },
-  data: {
-    attendees: [
-      { type: 'user', user_id: 'ou_xxx1' },
-      { type: 'user', user_id: 'ou_xxx2' },
-      { type: 'resource', room_id: 'omm_xxx' }, // 预约会议室
-    ],
-    need_notification: true,
-  },
-  params: { user_id_type: 'open_id' },
-});
-```
-
-> **会议室预约是异步的**：添加会议室参与人成功不代表预约成功。需后续通过日程参与人列表中会议室的 `rsvp_status` 确认预约状态。
-
-## 获取参与人列表
-
-```typescript
-const attendees = await client.calendar.calendarEventAttendee.list({
-  path: { calendar_id: 'primary', event_id: eventId },
-  params: { user_id_type: 'open_id', page_size: 50 },
-});
-```
-
-## 删除参与人
-
-```typescript
-await client.calendar.calendarEventAttendee.batchDelete({
-  path: { calendar_id: 'primary', event_id: eventId },
-  data: {
-    attendee_ids: ['user_xxx'],
-  },
-});
-```
-
-## 忙闲查询
-
-```typescript
-// 注意：方法名是 batch，不是 list
-const freebusy = await client.calendar.freebusy.batch({
-  data: {
-    time_min: String(Math.floor(new Date('2026-02-13T09:00:00+08:00').getTime() / 1000)),
-    time_max: String(Math.floor(new Date('2026-02-13T18:00:00+08:00').getTime() / 1000)),
-    user_id: { user_id: 'ou_xxx', id_type: 'open_id' },
-  },
-});
-// 返回 freebusy.data?.freebusy_list — 忙碌时间段数组
-```
-
-查询会议室忙闲时，使用 `room_id` 代替 `user_id`：
-
-```typescript
-const roomFreebusy = await client.calendar.freebusy.batch({
-  data: {
-    time_min: '...',
-    time_max: '...',
-    room_id: 'omm_xxx',
-  },
-});
-```
-
-## 会议室列表
-
-```typescript
-const rooms = await client.vc.room.list({
-  params: {
-    page_size: 20,
-    // room_level_id: 'xxx', // 可选：指定层级
-  },
-});
-```
-
-## 搜索会议室
-
-```typescript
-const searchResult = await client.vc.room.search({
-  data: {
-    query: '大会议室',
-  },
-  params: { page_size: 10 },
-});
-```
-
-## 典型工作流
-
-### 预约会议室
-
-1. **搜索会议室** → `client.vc.room.search({ data: { query: '关键词' } })`
-2. **查询忙闲** → `client.calendar.freebusy.batch({ data: { room_id, time_min, time_max } })`
-3. **创建日程** → `client.calendar.calendarEvent.create({ ... })`
-4. **添加会议室** → `client.calendar.calendarEventAttendee.create({ data: { attendees: [{ type: 'resource', room_id }] } })`
-5. **确认状态** → 查看参与人列表中会议室的 `rsvp_status`
-
-### 安排团队会议
-
-1. 分别查询每位成员忙闲 → `client.calendar.freebusy.batch()`
-2. 找到共同空闲时间段
-3. 搜索可用会议室
-4. 创建日程并添加参与人和会议室
-
-## Common Mistakes
-
-| 错误 | 正确做法 |
-|------|----------|
-| 时间传 ISO 字符串 | SDK 需要 Unix 秒时间戳字符串 |
-| 忙闲查询用 `freebusy.list` | 正确方法名是 `freebusy.batch` |
-| 会议室查询用 `calendar.*` | 会议室在 `vc.room.*` 域下 |
-| 以为添加会议室立即生效 | 会议室预约是异步的，需查询 `rsvp_status` |
-| 忘记传 `calendar_id` | path 中必须传 `calendar_id`，主日历用 `'primary'` |

package/steering/design-stack/skills/feishu/references/contacts.md

@@ -1,160 +0,0 @@
-# 通讯录 (Contacts)
-
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/server-docs/contact-v3/resources.md
-
-使用 `@larksuiteoapi/node-sdk` 在 NestJS 中查询飞书通讯录用户和部门信息。
-
-## 所需权限
-
-| 权限标识 | 说明 |
-|----------|------|
-| `contact:contact.base:readonly` | 读取通讯录基本信息 |
-| `contact:user.base:readonly` | 获取用户基础信息 |
-| `contact:department.base:readonly` | 获取部门基础信息 |
-| `contact:user.employee_id:readonly` | 获取用户 employee_id（可选） |
-
-> **通讯录权限范围**：必须在安全设置中配置，否则 API 只能查到权限范围内的用户/部门。建议设为「全部成员」。
-
-## 获取用户信息
-
-```typescript
-const user = await client.contact.user.get({
-  path: { user_id: 'ou_xxx' },
-  params: { user_id_type: 'open_id' },
-});
-// user.data?.user — { name, en_name, email, mobile, department_ids, status, ... }
-```
-
-### 用户 ID 类型说明
-
-| user_id_type | 说明 | 示例 |
-|--------------|------|------|
-| `open_id` | 应用级唯一标识 | `ou_xxx`（默认） |
-| `union_id` | 跨应用统一标识 | `on_xxx` |
-| `user_id` | 企业内用户 ID | 无固定前缀 |
-
-## 列出部门下的用户
-
-```typescript
-const users = await client.contact.user.findByDepartment({
-  params: {
-    department_id: 'od_xxx',
-    page_size: 50,
-    department_id_type: 'open_department_id',
-    user_id_type: 'open_id',
-  },
-});
-// users.data?.items — [{user_id, name, email, ...}, ...]
-// users.data?.has_more, users.data?.page_token — 用于分页
-```
-
-### 分页遍历所有成员
-
-```typescript
-for await (const items of client.contact.user.listWithIterator({
-  params: {
-    department_id: 'od_xxx',
-    page_size: 50,
-    department_id_type: 'open_department_id',
-    user_id_type: 'open_id',
-  },
-})) {
-  for (const user of items?.items || []) {
-    console.log(user.name, user.open_id);
-  }
-}
-```
-
-## 搜索用户
-
-```typescript
-const searchResult = await client.contact.user.search({
-  data: { query: '张三' },
-  params: {
-    user_id_type: 'open_id',
-    page_size: 20,
-  },
-});
-// searchResult.data?.items — 匹配的用户列表
-```
-
-> 搜索用户需要 `user_access_token`（用户授权），不支持 `tenant_access_token`。如果只有应用凭证，使用 `findByDepartment` 遍历 + 本地过滤替代。
-
-## 获取部门信息
-
-```typescript
-const dept = await client.contact.department.get({
-  path: { department_id: 'od_xxx' },
-  params: { department_id_type: 'open_department_id' },
-});
-// dept.data?.department — { name, parent_department_id, leader_user_id, member_count, ... }
-```
-
-## 列出子部门
-
-```typescript
-const children = await client.contact.department.children({
-  path: { department_id: 'od_xxx' },
-  params: {
-    department_id_type: 'open_department_id',
-    page_size: 50,
-  },
-});
-// children.data?.items — [{department_id, name, member_count, ...}, ...]
-```
-
-## 搜索部门
-
-```typescript
-const deptSearch = await client.contact.department.search({
-  data: { query: '产品' },
-  params: {
-    department_id_type: 'open_department_id',
-    page_size: 20,
-  },
-});
-```
-
-> 搜索部门同样需要 `user_access_token`。应用凭证可用 `department.children()` 遍历代替。
-
-## 列出所有部门（从根开始）
-
-```typescript
-const rootDepts = await client.contact.department.list({
-  params: {
-    parent_department_id: '0', // 0 表示根部门
-    page_size: 50,
-    department_id_type: 'open_department_id',
-  },
-});
-```
-
-## 典型工作流
-
-### 查找某部门所有成员
-
-1. **搜索部门** → `client.contact.department.search({ data: { query: '市场部' } })`
-   - 或遍历子部门 → `client.contact.department.children()`
-2. **获取部门成员** → `client.contact.user.findByDepartment({ params: { department_id } })`
-
-### 查找用户所在部门
-
-1. **获取用户信息** → `client.contact.user.get({ path: { user_id } })`
-2. 从返回的 `department_ids` 获取部门 ID
-3. **获取部门详情** → `client.contact.department.get({ path: { department_id } })`
-
-### 遍历整个组织架构
-
-1. 从根部门开始 → `client.contact.department.list({ params: { parent_department_id: '0' } })`
-2. 递归获取子部门 → `client.contact.department.children()`
-3. 获取每个部门成员 → `client.contact.user.findByDepartment()`
-
-## Common Mistakes
-
-| 错误 | 正确做法 |
-|------|----------|
-| 未配置通讯录权限范围 | 安全设置 → 通讯录权限范围 → 全部成员 |
-| 用 `tenant_access_token` 搜索用户 | `user.search()` 需 `user_access_token`，否则用 `findByDepartment` |
-| 部门 ID 类型不匹配 | `od_` 开头用 `open_department_id`，纯数字用 `department_id` |
-| 忘记传 `user_id_type` 参数 | 不传默认 `open_id`，注意和实际传入的 ID 类型一致 |
-| 分页获取不完整 | 检查 `has_more`，使用 `listWithIterator` 自动分页 |

package/steering/design-stack/skills/feishu/references/doc.md

@@ -1,256 +0,0 @@
-# 云文档 (Document)
-
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/server-docs/docs/docs-overview
-
-使用 `@larksuiteoapi/node-sdk` 在 NestJS 中操作飞书云文档。
-
-## 所需权限
-
-| 权限标识 | 说明 |
-|----------|------|
-| `docx:document` | 读写新版文档 |
-| `docx:document:readonly` | 只读新版文档 |
-| `docx:document.block:convert` | Markdown 转 Block（写入/追加需要） |
-| `drive:drive` | 访问云空间（创建文档到指定文件夹时需要） |
-
-> 对于已有的文档，需确保应用已被添加为协作者：文档右上角「...」→「更多」→「添加文档应用」。
-
-## 从 URL 提取 Token
-
-URL 格式：`https://xxx.feishu.cn/docx/{doc_token}`
-
-```typescript
-const url = 'https://xxx.feishu.cn/docx/ABC123def';
-const docToken = new URL(url).pathname.split('/docx/')[1]; // 'ABC123def'
-```
-
-## 创建文档
-
-```typescript
-const res = await client.docx.document.create({
-  data: {
-    title: '新文档',
-    // folder_token: 'fldcnXXX', // 可选：目标文件夹
-  },
-});
-const docId = res.data?.document?.document_id;
-const docUrl = `https://feishu.cn/docx/${docId}`;
-```
-
-## 读取文档
-
-### 读取工作流
-
-1. **先获取纯文本** — 快速了解文档内容
-2. **检查 hint** — 如果返回中包含 `hint` 字段，说明文档含有表格、图片等结构化内容
-3. **获取 Block 列表** — 需要结构化内容时使用 `documentBlock.list()`
-
-### 读取纯文本
-
-```typescript
-const [contentRes, infoRes] = await Promise.all([
-  client.docx.document.rawContent({ path: { document_id: docToken } }),
-  client.docx.document.get({ path: { document_id: docToken } }),
-]);
-const title = infoRes.data?.document?.title;
-const content = contentRes.data?.content;
-```
-
-### 读取 Block 列表（结构化内容）
-
-```typescript
-const blocksRes = await client.docx.documentBlock.list({
-  path: { document_id: docToken },
-});
-const blocks = blocksRes.data?.items ?? [];
-```
-
-## 写入文档（替换全部内容）
-
-工作流：清空现有内容 → 转换 Markdown → 插入新 Block
-
-```typescript
-// 1. 清空文档内容（保留 Page block）
-const existing = await client.docx.documentBlock.list({
-  path: { document_id: docToken },
-});
-const childIds = existing.data?.items
-  ?.filter(b => b.parent_id === docToken && b.block_type !== 1)
-  .map(b => b.block_id) ?? [];
-
-if (childIds.length > 0) {
-  await client.docx.documentBlockChildren.batchDelete({
-    path: { document_id: docToken, block_id: docToken },
-    data: { start_index: 0, end_index: childIds.length },
-  });
-}
-
-// 2. 转换 Markdown 为 Block
-const convertRes = await client.docx.document.convert({
-  data: { content_type: 'markdown', content: markdownContent },
-});
-const blocks = convertRes.data?.blocks ?? [];
-
-// 3. 插入 Block
-await client.docx.documentBlockChildren.create({
-  path: { document_id: docToken, block_id: docToken },
-  data: { children: blocks },
-});
-```
-
-## 追加内容
-
-与写入相同，但跳过清空步骤：
-
-```typescript
-// 转换 + 插入（不清空）
-const convertRes = await client.docx.document.convert({
-  data: { content_type: 'markdown', content: markdownContent },
-});
-await client.docx.documentBlockChildren.create({
-  path: { document_id: docToken, block_id: docToken },
-  data: { children: convertRes.data?.blocks ?? [] },
-});
-```
-
-## Block 操作
-
-### 获取单个 Block
-
-```typescript
-const res = await client.docx.documentBlock.get({
-  path: { document_id: docToken, block_id: blockId },
-});
-```
-
-### 更新 Block 文本
-
-```typescript
-await client.docx.documentBlock.patch({
-  path: { document_id: docToken, block_id: blockId },
-  data: {
-    update_text_elements: {
-      elements: [{ text_run: { content: '新文本内容' } }],
-    },
-  },
-});
-```
-
-### 删除 Block
-
-```typescript
-// 需要知道 block 在父容器中的 index
-const children = await client.docx.documentBlockChildren.get({
-  path: { document_id: docToken, block_id: parentId },
-});
-const index = children.data?.items?.findIndex(item => item.block_id === blockId);
-
-await client.docx.documentBlockChildren.batchDelete({
-  path: { document_id: docToken, block_id: parentId },
-  data: { start_index: index, end_index: index + 1 },
-});
-```
-
-## 图片上传
-
-```typescript
-import { Readable } from 'stream';
-
-// 1. 上传图片到文档
-const uploadRes = await client.drive.media.uploadAll({
-  data: {
-    file_name: 'image.png',
-    parent_type: 'docx_image',
-    parent_node: blockId, // 图片 Block 的 block_id
-    size: imageBuffer.length,
-    file: Readable.from(imageBuffer) as any,
-  },
-});
-if (uploadRes.code !== 0) {
-  throw new Error(`Image upload failed [${uploadRes.code}]: ${uploadRes.msg}`);
-}
-const fileToken = uploadRes.data?.file_token;
-
-// 2. 替换图片 Block 的内容
-await client.docx.documentBlock.patch({
-  path: { document_id: docToken, block_id: blockId },
-  data: {
-    replace_image: { token: fileToken },
-  },
-});
-```
-
-## Block 类型参考
-
-| block_type | 名称 | 说明 | 可编辑 |
-|------------|------|------|--------|
-| 1 | Page | 文档根节点（包含标题） | 否 |
-| 2 | Text | 纯文本段落 | 是 |
-| 3 | Heading1 | 一级标题 | 是 |
-| 4 | Heading2 | 二级标题 | 是 |
-| 5 | Heading3 | 三级标题 | 是 |
-| 6 | Heading4 | 四级标题 | 是 |
-| 7 | Heading5 | 五级标题 | 是 |
-| 8 | Heading6 | 六级标题 | 是 |
-| 9 | Heading7 | 七级标题 | 是 |
-| 10 | Heading8 | 八级标题 | 是 |
-| 11 | Heading9 | 九级标题 | 是 |
-| 12 | Bullet | 无序列表项 | 是 |
-| 13 | Ordered | 有序列表项 | 是 |
-| 14 | Code | 代码块 | 是 |
-| 15 | Quote | 引用块 | 是 |
-| 16 | Equation | LaTeX 公式 | 部分 |
-| 17 | Todo | 任务/复选框 | 是 |
-| 18 | Bitable | 多维表格嵌入 | 否 |
-| 19 | Callout | 高亮块 | 是 |
-| 20 | ChatCard | 会话卡片嵌入 | 否 |
-| 21 | Diagram | 绘图嵌入 | 否 |
-| 22 | Divider | 分割线 | 否 |
-| 23 | File | 文件附件 | 否 |
-| 24 | Grid | 分栏布局容器 | 否 |
-| 25 | GridColumn | 分栏列 | 否 |
-| 26 | Iframe | 内嵌网页 | 否 |
-| 27 | Image | 图片 | 部分（replace_image） |
-| 28 | ISV | 第三方小组件 | 否 |
-| 29 | MindnoteBlock | 思维导图嵌入 | 否 |
-| 30 | Sheet | 电子表格嵌入 | 否 |
-| 31 | Table | 表格 | 部分（仅读取，无法通过 API 创建） |
-| 32 | TableCell | 表格单元格 | 是 |
-| 33 | View | 视图嵌入 | 否 |
-| 34 | Undefined | 未知类型 | 否 |
-| 35 | QuoteContainer | 引用容器 | 否 |
-| 36 | Task | 飞书任务集成 | 否 |
-| 37 | OKR | OKR 集成 | 否 |
-| 38 | OKRObjective | OKR 目标 | 否 |
-| 39 | OKRKeyResult | OKR 关键结果 | 否 |
-| 40 | OKRProgress | OKR 进展 | 否 |
-| 41 | AddOns | 扩展块 | 否 |
-| 42 | JiraIssue | Jira Issue 嵌入 | 否 |
-| 43 | WikiCatalog | 知识库目录 | 否 |
-| 44 | Board | 画板嵌入 | 否 |
-| 45 | Agenda | 议程块 | 否 |
-| 46 | AgendaItem | 议程项 | 否 |
-| 47 | AgendaItemTitle | 议程项标题 | 否 |
-| 48 | SyncedBlock | 同步块引用 | 否 |
-
-> 可编辑的文本类 block（2-17, 19）通过 `documentBlock.patch()` 的 `update_text_elements` 更新；容器类 block（24, 25, 35）需编辑其子 block。
-
-## Markdown 写入限制
-
-- **表格不支持**：Markdown 中的表格无法通过 `document.convert()` → `documentBlockChildren.create()` 创建（error 1770029）
-- 支持的 Markdown 元素：标题、列表、代码块、引用、链接、图片（`![](url)` 自动上传）、加粗/斜体/删除线
-
-## Common Mistakes
-
-| 错误 | 正确做法 |
-|------|----------|
-| 直接用 wiki token 调用 docx API | Wiki 页面需先通过 `wiki.space.getNode()` 获取 `obj_token`，再用 `obj_token` 作为 `doc_token` |
-| 写入时未清空旧内容导致重复 | 写入前先调用 `documentBlockChildren.batchDelete()` 清空 |
-| 删除 Block 传 block_id 而非 index | `batchDelete` 使用 `start_index` 和 `end_index`，非 block_id |
-| 尝试通过 API 创建表格 Block | Table block 无法通过 `documentBlockChildren.create()` 创建 |
-| `document.convert()` 缺少权限 | 需要 `docx:document.block:convert` 权限 |
-| 图片上传 parent_type 填错 | 文档图片必须用 `docx_image`，不是 `doc_image` |
-| 更新文本时覆盖了富文本样式 | `update_text_elements` 会替换整个文本内容，包括样式 |
-| 并发写入同一文档 | 飞书文档不支持并发写入，需串行操作 |
-| 忘记检查 `res.code !== 0` | 所有 API 调用都需检查返回码 |
-| 清空文档时删除了 Page block | `block_type !== 1` 的才能删除，Page block 是根节点 |

package/steering/design-stack/skills/feishu/references/drive.md

@@ -1,103 +0,0 @@
-# 云空间 (Drive)
-
-> 开放平台文档（Markdown 版）：https://open.larkoffice.com/document/server-docs/docs/drive-v1/introduction
-
-使用 `@larksuiteoapi/node-sdk` 在 NestJS 中管理飞书云空间文件和文件夹。
-
-## 所需权限
-
-| 权限标识 | 说明 |
-|----------|------|
-| `drive:drive` | 读写云空间（创建、移动、删除） |
-| `drive:drive:readonly` | 只读云空间（列出、查看） |
-
-## 从 URL 提取 Token
-
-文件夹 URL 格式：`https://xxx.feishu.cn/drive/folder/{folder_token}`
-
-```typescript
-const url = 'https://xxx.feishu.cn/drive/folder/ABC123';
-const folderToken = new URL(url).pathname.split('/drive/folder/')[1]; // 'ABC123'
-```
-
-## 列出文件夹内容
-
-```typescript
-// 列出指定文件夹
-const res = await client.drive.file.list({
-  params: { folder_token: 'fldcnXXX' },
-});
-const files = res.data?.files ?? [];
-// files: [{token, name, type, url, created_time, modified_time, owner_id}, ...]
-
-// 列出根目录（不传 folder_token）
-const rootRes = await client.drive.file.list({
-  params: {},
-});
-```
-
-## 创建文件夹
-
-```typescript
-const res = await client.drive.file.createFolder({
-  data: {
-    name: '新文件夹',
-    folder_token: 'fldcnXXX', // 父文件夹 token
-  },
-});
-const folderToken = res.data?.token;
-const folderUrl = res.data?.url;
-```
-
-## 移动文件
-
-```typescript
-const res = await client.drive.file.move({
-  path: { file_token: 'ABC123' },
-  data: {
-    type: 'docx', // 文件类型
-    folder_token: 'fldcnXXX', // 目标文件夹
-  },
-});
-```
-
-## 删除文件
-
-```typescript
-const res = await client.drive.file.delete({
-  path: { file_token: 'ABC123' },
-  params: {
-    type: 'docx', // 文件类型
-  },
-});
-```
-
-## 文件类型参考
-
-| 类型 | 说明 |
-|------|------|
-| `doc` | 旧版文档 |
-| `docx` | 新版文档 |
-| `sheet` | 电子表格 |
-| `bitable` | 多维表格 |
-| `folder` | 文件夹 |
-| `file` | 上传的文件 |
-| `mindnote` | 思维导图 |
-| `shortcut` | 快捷方式 |
-
-## 机器人根文件夹限制
-
-飞书机器人使用 `tenant_access_token`，没有自己的「我的空间」根文件夹。这意味着：
-
-- 不指定 `folder_token` 创建文件夹会失败（400 错误）
-- 机器人只能访问**已共享给它**的文件和文件夹
-- **解决方案**：用户先手动创建一个文件夹并共享给机器人，机器人就可以在其中创建子文件夹和文件
-
-## Common Mistakes
-
-| 错误 | 正确做法 |
-|------|----------|
-| 机器人不指定 folder_token 创建文件夹 | 必须指定一个已共享给机器人的 folder_token |
-| move/delete 时 type 参数搞错 | type 必须与文件实际类型一致 |
-| 用 folder_token 当 file_token | `folder_token` 用于列出目录，`file_token` 用于移动/删除 |
-| 文件不在机器人可访问范围内 | 需先将文件/文件夹共享给机器人应用 |