SuperAPI AI 工具集

feishu-wiki

通用与其它

查看项目

更新于 10-15 19:54

技能介绍

用途:通过飞书 Wiki v2 API 管理知识空间和页面节点,适合知识沉淀场景。

主要能力:知识空间方面支持创建空间(POST /spaces,参数如 {"name":"知识库名称"})、获取空间列表(GET /spaces)、获取空间详情(GET /spaces/{space_id})。页面节点方面支持创建节点(POST /spaces/{space_id}/nodes,用于创建 Wiki 页面)、获取节点(GET /spaces/{space_id}/nodes/{node_token})、移动节点(POST /spaces/{space_id}/nodes/{node_token}/move)。创建节点时可指定 obj_type(doc / sheet / mindnote / bitable / file / docx)、parent_node_token、node_type、origin_node_token、title。

使用方式:Base URL 为 https://open.feishu.cn/open-apis/wiki/v2。认证需从 feishu_skills 根目录执行共享脚本获取 Token:TOKEN="$(./scripts/get_feishu_token.sh)",请求头统一使用 Authorization: Bearer ${TOKEN}。若接口返回 token 无效、过期或 401,强制刷新后仅重试一次原请求:TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"。需配置环境变量 FEISHU_APP_ID、FEISHU_APP_SECRET;本地缓存为 ./.feishu_token_cache.json,未过期直接复用,默认提前 5 分钟刷新。

限制与注意事项:存在权限穿透问题,空间创建后机器人默认无权维护。建议创建包含机器人的群组,并在知识库【设置】中把该群组添加为“管理员”,机器人通过群组身份获得操作权。最佳实践为先创建文档再通过 origin_node_token 关联。其他细节暂未提供。