---
name: feishu-to-inbox
description: Use when 把飞书文档拉到 inbox、从飞书拉会议记录、飞书文档进 inbox、Feishu doc to inbox、Lark doc to inbox. 通过飞书 MCP 拉取文档正文并写入项目 inbox 目录，便于后续走 inbox 分析。
---

# 飞书文档拉取到 Inbox

当用户希望把飞书（Feishu/Lark）上的文档（如会议记录、Wiki 页面）拉取到本项目的 `inbox/` 目录时，按以下步骤执行。

## 触发表述

- 「把飞书文档拉到 inbox」「从飞书拉会议记录到 inbox」「飞书文档进 inbox」
- 提供**飞书文档链接**或**文档标题/关键词**（用 MCP 搜索后选一个）

## 步骤

### 1. 确定要拉取的文档

- 若用户给了**完整链接**：
  - **Docx 链接**：`https://xxx.feishu.cn/docx/XXXX` → `document_id` = `XXXX`（即 `docx/` 后那一段）
  - **Wiki 链接**：`https://xxx.feishu.cn/wiki/YYYY` → 节点 token = `YYYY`；Wiki 节点可能关联底层 docx，需先查节点信息得到实际文档 token 再取正文
- 若用户只给了**标题或关键词**：调用 **user-lark-mcp** 的 `docx_builtin_search`（`search_key` 为关键词），在结果中让用户确认要拉取哪一篇，或取第一篇，得到对应 `document_id`

### 2. 拉取正文

- **Docx**：调用 **user-lark-mcp** 的 `docx_v1_document_rawContent`，传入 `path.document_id`，**useUAT: true**（用户身份才能读个人/协作文档）
- **Wiki 节点**：若链接是 wiki：
  - 先调用 `wiki_v2_space_getNode`，`params.token` = 链接中 `wiki/` 后的 token，`params.obj_type` = `wiki`
  - 若返回中有关联的 docx 文档 id，用该 id 调 `docx_v1_document_rawContent`；若节点即 docx 类型，按文档 token 取正文

### 3. 写入 inbox

- 文件名：优先用文档标题（去掉非法文件名字符），或 `会议记录-{日期}` / `飞书文档-{日期}.md`，避免与已有 inbox 重名
- 保存路径：`inbox/{文件名}.md`（项目根下的 `inbox/`，不是 `kb/inbox/`）
- 内容格式：
  - 文首可加一行来源说明，例如：`> 来源：飞书 Docx` 或 `> 来源：飞书 Wiki · docx`，若有链接可写 `> 链接：{用户提供的链接}`
  - 接着写 MCP 返回的正文（已是纯文本，可保留换行）

### 4. 建议下一步

- 告知用户已写入 `inbox/{文件名}.md`
- 提示可对 AI 说：**「对 inbox 的 {文件名} 跑 inbox 分析」** 或 **「处理 inbox」**，按 `inbox-process` 流程做分析与归档

## 注意

- 未归档的 inbox 文件不要写入 `archived` frontmatter；归档由 inbox 分析流程在确认执行后完成
- 若 MCP 返回错误（如无权限、文档不存在），如实报错并提示检查链接或飞书应用权限
