feishu-wiki

飞书知识库

你是飞书知识库管理专家，负责通过 Wiki v2 API 实现知识空间和页面节点的创建与管理。

一、API 基础信息

https://open.feishu.cn/open-apis/wiki/v2

Authorization: Bearer {tenant_access_token}

application/json

二、知识空间

1. 创建知识空间

POST /open-apis/wiki/v2/spaces

{ "name": "知识库名称" }

实测心法 (重要)：

1. 权限穿透：空间创建后机器人默认无权维护。强烈建议使用“群组授权法”：
   • 创建一个包含机器人的群组。
   • 在知识库【设置】-【成员设置】中，添加该群组为“管理员”。
   • 这样机器人即可通过群组身份获得该空间内所有页面的操作权。
2. 场景建议：适合为新业务线建立知识中台。

2. 获取知识空间列表

GET /open-apis/wiki/v2/spaces

三、页面节点

3. 创建 Wiki 页面节点

POST /open-apis/wiki/v2/spaces/{space_id}/nodes

{
  "obj_type": "docx",
  "title": "页面标题",
  "parent_node_token": "wikcnXXX"
}

实测心法：

• Wiki 节点实质上是 Docx 文件的挂载

• obj_type

  可选

  docx

  （文档）、

  sheet

  （表格）、

  bitable

  （多维表格）等
• 创建后可通过

  feishu-doc-writer

  Skill 向文档写入内容

• parent_node_token

  为空则创建在根目录

4. 获取节点信息

GET /open-apis/wiki/v2/spaces/{space_id}/nodes/{node_token}

5. 移动节点

POST /open-apis/wiki/v2/spaces/{space_id}/nodes/{node_token}/move

四、最佳实践

1. 结构先行：先规划知识库的目录结构，再批量创建节点
2. 文档挂载：Wiki 节点本质是文档的挂载点，内容写入用

   feishu-doc-writer

3. 权限管理：空间创建后及时配置访问权限
4. SOP 沉淀：将稳定的操作流程沉淀为 Wiki 页面，形成团队知识资产

feishu-wiki 技能总结 (教程脱敏版)

一、 核心功能清单

二、 典型业务场景

企业级 SOP 自动化沉淀中心：

• 场景：当项目组完成一项复杂任务的复盘讨论后，AI 自动提炼核心步骤，将其转化为标准的 SOP 文档，并精准挂载到公司 Wiki 的「标准化流程」分类下。
• 价值：将碎片化经验瞬间固化为组织资产，解决“人走政息、经验流失”的难题。

项目全生命周期建档：

• 场景：新项目立项时，AI 自动在团队 Wiki 中创建以项目命名的父节点，并预设「PRD」、「需求池」、「会议纪要」等标准化二级子节点。
• 价值：实现项目文档的“入场即标准化”，确保团队成员在项目第一天就能在预设框架内协作。

智能资产整理与迁移：

• 场景：公司进行知识库重构时，AI 自动扫描存量的孤立文档，识别其业务标签，并根据分类逻辑将其自动移动/挂载到对应的 Wiki 目录树中。
• 价值：极大地降低了人工维护巨量知识库的行政成本，实现知识体系的动态演进。

三、 实测注意事项（教程必写 · 尽量详细）

空间授权的“群组法”穿透 (Critical)：

• 风险：由于飞书租户安全策略，机器人通过 API 直接创建“顶级知识空间”往往会报权限错误 (403)。此外，即便有了空间，机器人默认对空间内的节点也可能无操作权。
• 对策：教程必须强调 “群组授权最佳实践”：
  1. 手动创建一个包含机器人的【群组】。
  2. 在 Wiki 空间设置中，将该群组添加为【管理员】。
  3. 这样机器人即可通过群组身份获得空间内所有页面的创建、移动和编辑权限。

Node Token 与 Obj Token 的本质区别：

• 坑点：这是最容易混淆的技术点。

  node_token

  代表 Wiki 目录上的一个“位置节点”；而

  obj_token

  才是背后真实的文档文件。
• 建议：在执行“内容写入”操作前，务必通过

  get_node

  接口获取

  obj_token

  ，否则无法调用文档写入接口。

节点创建的“node_type”强制性：

• 注意：在调用 Wiki 创建节点接口时，

  node_type

  字段通常是必传项。在自动化挂载场景下，一般固定设置为

  origin

  即可。

跨空间移动的参数补全：

• 技巧：在执行

  move_node

  （移动节点）时，飞书 API 要求同时提供

  target_parent_token

  （目标目录）和

  target_space_id

  （目标空间），即便是在同一个空间内移动，这两个参数也建议显式补全，否则极易触发 400 校验错误。

注：以上内容已进行脱敏处理，所有私有项目信息已替换为通用互联网公司业务描述。已保存至：

opensource/feishu-skills/feishu-wiki/SUMMARY.md