关于 feishu-wiki
feishu-wiki 是通过 Wiki v2 API 管理飞书知识空间和页面节点的技能。它支持创建和查询空间，以及创建、获取和移动关联文档等内容类型的节点。
主要功能
- 01创建和列出知识空间
- 02获取空间详情
- 03创建 Wiki 页面节点
- 04获取和移动节点
- 05将节点关联到现有文档
适用场景
- 01创建飞书知识空间
- 02创建关联文档的 Wiki 页面
- 03移动页面位置
- 04查看知识空间中的节点
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/feishu-wiki确认已加载。
详细介绍
飞书知识库
通过 Wiki v2 API 管理知识空间和页面节点。
Base URL：https://open.feishu.cn/open-apis/wiki/v2
认证与 Token 获取
从 feishu_skills 根目录执行共享脚本：
TOKEN="$(./scripts/get_feishu_token.sh)"
请求头统一使用 Authorization: Bearer ${TOKEN}。
如果业务接口返回 Token 无效、过期或 401，强制刷新后仅重试一次原请求：
TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"
环境变量：
FEISHU_APP_IDFEISHU_APP_SECRET
本地缓存：./.feishu_token_cache.json（未过期时直接复用，默认提前 5 分钟刷新）
知识空间
| API | 端点 | 说明 |
|---|---|---|
| 创建空间 | POST /spaces | {"name":"知识库名称"} |
| 获取列表 | GET /spaces | - |
| 获取详情 | GET /spaces/{space_id} | - |
⚠️ 权限穿透：空间创建后，机器人默认无权维护。建议：
- 创建包含机器人的群组
- 在知识库【设置】中将该群组添加为“管理员”
- 机器人通过群组身份获得操作权限
页面节点
| API | 端点 | 说明 |
|---|---|---|
| 创建节点 | POST /spaces/{space_id}/nodes | 创建 Wiki 页面 |
| 获取节点 | GET /spaces/{space_id}/nodes/{node_token} | - |
| 移动节点 | POST /spaces/{space_id}/nodes/{node_token}/move | - |
创建节点：
{
"obj_type": "docx",
"parent_node_token": "root",
"node_type": "origin",
"origin_node_token": "doxcnXXX",
"title": "页面标题"
}
obj_type：doc / sheet / mindnote / bitable / file / docx
最佳实践
- 群组授权法（解决权限问题）
- 先创建文档再关联（
origin_node_token） - 适用于知识沉淀场景
评论
支持 Markdown