Feishu Wiki

飞书知识库结构管理

Standalone Wrapper

• 共享环境变量：FEISHU_APP_ID、FEISHU_APP_SECRET，可选 FEISHU_BASE_URL、FEISHU_OAUTH_STORE_DIR
• feishu_wiki_space -> node scripts/wiki.js space '<json>'
• feishu_wiki_space_node -> node scripts/wiki.js node '<json>'

执行前必读

• 本 skill 管的是“知识库层级结构”，不是底层文档正文内容
• space_id、node_token、obj_token 是三种不同层级的标识，不要混用
• get 是最重要的“解析动作”：可以把 wiki 节点解析成真实文档对象
• move / copy 改的是知识库树结构，不是原文内容

快速索引：意图 → 工具 → 必填参数

核心约束（Schema 未透露的知识）

1. space_id、node_token、obj_token 不是一个东西

用户给你 wiki URL 时，常见拿到的是 node_token，不是底层文档 token。

2. get 可以把 wiki 节点解析成底层对象

• 默认 obj_type 用 wiki
• 对 wiki 节点执行 get 后，返回里通常能看到 obj_token 和 obj_type
• 这一步经常是连接 feishu-wiki 和 feishu-fetch-doc / feishu-sheet / feishu-doc-comments 的桥梁

3. 节点创建既可以建原生节点，也可以建快捷方式

如果用户只说“把这篇文档挂到知识库”，需要先判断是新建文档节点，还是挂一个 shortcut。

4. 这个 skill 不修改正文

它只负责知识库结构、归档位置、节点复制移动。正文内容更新要转给文档类或表格类 skill。

使用场景示例

场景 1：列出知识空间

{
  "action": "list",
  "page_size": 20
}

场景 2：解析 wiki 节点，拿到底层对象

{
  "action": "get",
  "token": "wik_xxx",
  "obj_type": "wiki"
}

场景 3：在知识空间里创建一个 docx 节点

{
  "action": "create",
  "space_id": "123",
  "obj_type": "docx",
  "parent_node_token": "wik_parent_xxx",
  "title": "项目周报"
}

场景 4：把节点移动到另一个父目录下

{
  "action": "move",
  "space_id": "123",
  "node_token": "wik_xxx",
  "target_parent_token": "wik_target_xxx"
}

常见错误与排查

官方文档参考

• 知识库概述: https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview
• 获取知识空间列表: https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/list
• 获取知识空间节点信息: https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get_node
• 创建知识空间节点: https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/create
• 移动知识空间节点: https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/move