Feishu Doc Skill
快速索引
文档操作
| 用户意图 |
module |
tool_action |
必填参数 |
| 创建文档 |
doc |
create |
可空（建议 title） |
| 读取文档 |
doc |
read |
document_id |
| 读取文档内容 |
doc |
read_content |
document_id |
| 写入 Markdown |
doc |
write_markdown |
document_id, content（或 markdown） |
| 列出文档块 |
doc |
list_blocks |
document_id |
| 更新文本块 |
doc |
update_block_text |
document_id, block_id, content |
Wiki 操作
| 用户意图 |
module |
tool_action |
必填参数 |
| 列出知识空间 |
wiki |
list_spaces |
- |
| 列出节点 |
wiki |
list_nodes |
space_id |
| 创建节点 |
wiki |
create_node |
space_id, title |
| 获取节点 |
wiki |
get_node |
space_id, node_token |
调用示例
创建文档
python3 skills/feishu-cli/run.py '{
"action": "tool",
"module": "doc",
"tool_action": "create",
"title": "Q1 工作总结",
"folder_token": "fldcnXXXX"
}'
读取文档内容
python3 skills/feishu-cli/run.py '{
"action": "tool",
"module": "doc",
"tool_action": "read_content",
"document_id": "doccnXXXX"
}'
写入 Markdown 内容
python3 skills/feishu-cli/run.py '{
"action": "tool",
"module": "doc",
"tool_action": "write_markdown",
"document_id": "doccnXXXX",
"content": "## 概述\n\n本季度完成了以下关键目标：\n\n1. 项目 A 上线\n2. 性能优化 30%"
}'
Wiki 操作
# 列出知识空间
python3 skills/feishu-cli/run.py '{"action":"tool","module":"wiki","tool_action":"list_spaces"}'
# 列出节点
python3 skills/feishu-cli/run.py '{"action":"tool","module":"wiki","tool_action":"list_nodes","space_id":"7xxx"}'
核心约束
文档 ID 来源
- URL 中提取：
https://xxx.feishu.cn/docx/doccnXXXX → document_id = "doccnXXXX"
- Wiki URL：先用
wiki get_node 获取 obj_token，再作为 document_id 使用
- API 返回：创建文档后返回
Lark Markdown 与标准 Markdown 差异
飞书文档支持的 Markdown 是 Lark 风味，与标准 GFM 有一些差异：
- 标题: 支持
# 到 ######
- 代码块: 支持
```language 语法
- 表格: 使用
| col1 | col2 | 标准表格语法
- 任务列表: 使用
- [ ] 和 - [x]
- 引用: 使用
> 前缀
- 特殊块: 支持
callout、grid、mermaid、plantuml 等
权限与默认行为
- 读取需要
docx:document:readonly scope
- 写入需要
docx:document scope
- Wiki 操作需要
wiki:wiki 相关 scope
- 通过 CLI 创建文档时，会自动返回
url 与 applink_url
- 创建文档后，CLI 会尝试默认给当前用户开启 管理权限（full_access），无需额外参数；若当前调用身份无法修改协作者权限，则会在返回中给出
manage_permission_warning
cklxx