名称： feishu-doc
描述： 从飞书（Lark）知识库、文档、表格及多维表格中获取内容。自动将知识库链接解析为实际实体，并将内容转换为 Markdown 格式。
标签： [feishu, lark, wiki, doc, sheet, document, reader, writer]

Feishu Doc 技能

从飞书（Lark）知识库、文档、表格及多维表格中获取内容，并可创建与更新文档。

前提条件

• 请先安装 feishu-common。
• 本技能依赖 ../feishu-common/index.js 来获取令牌和进行 API 鉴权。

功能

• 读取：从文档、表格、多维表格及知识库中获取内容。
• 创建：创建新的空白文档。
• 写入：使用 Markdown 内容覆盖文档。
• 追加：在文档末尾追加 Markdown 内容。
• 块操作：列出、获取、更新和删除特定的内容块。

长文档处理（无长度限制）

如需生成长文档（超过 LLM 约 2000-4000 个令牌的输出限制），请按以下步骤操作：
1. 创建文档，获取 doc_token。
2. 拆分内容为逻辑部分（例如：引言、第一章、第二章）。
3. 使用 feishu_doc_append 顺序追加每个内容块。
4. 如果文档非常长，请不要尝试在单个 feishu_doc_write 调用中写入全部内容，应使用追加循环模式。

使用示例

# 读取
node index.js --action read --token <doc_token>

# 创建
node index.js --action create --title "我的文档"

# 写入（覆盖）
node index.js --action write --token <doc_token> --content "# 标题\n你好，世界"

# 追加
node index.js --action append --token <doc_token> --content "## 第二部分\n更多内容"

配置

在技能根目录创建 config.json 文件或设置环境变量：

{
  "app_id": "你的应用ID",
  "app_secret": "你的应用密钥"
}

环境变量：
- FEISHU_APP_ID
- FEISHU_APP_SECRET