SuperAPI AI 工具集

lark-wiki

通用与其它

查看项目

更新于 10-16 09:28

技能介绍

用途:管理飞书知识库(wiki v2),包括知识空间的创建与查询、文档节点的层级结构维护,以及在知识库中组织文档和快捷方式。适用于需要在知识库中查找或创建文档、浏览知识空间结构、移动或复制节点等场景。

使用前注意:开始前必须先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证与权限处理说明。

主要方式:优先使用 Shortcut 高级封装,命令形如 lark-cli wiki +<verb> [flags]。其中 +node-create 可在自动解析知识空间的情况下创建 wiki 节点。也可使用 API 方式:先用 lark-cli schema wiki.<resource>.<method> 查看参数结构,再以 lark-cli wiki <resource> <method> [flags] 调用;使用原生 API 时必须先运行 schema 查看 --data / --params 结构,不要猜测字段格式。

资源与方法:spaces 提供 get(获取知识空间信息)、get_node(获取知识空间节点信息)、list(获取知识空间列表);nodes 提供 copy(创建节点副本)、create(创建节点)、list(获取子节点列表)。权限方面,spaces.get 需 wiki:space:read,spaces.get_node 与 nodes.list 需 wiki:node:read / wiki:node:retrieve,spaces.list 需 wiki:space:retrieve,nodes.copy 需 wiki:node:copy,nodes.create 需 wiki:node:create。

已知限制:向知识空间添加外部用户时,使用外部租户用户邮箱调用 spaces members create 会返回 131005: identity not found,Lark API 无法按邮箱查找或添加外部组织用户。变通方式包括:通过 Lark 管理控制台(admin.larksuite.com)→ 外部协作者 → 邀请;邀请后使用 member_type: openid 及管理端邀请后签发的 open_id 添加成员;如需公开读取,可设置 open_sharing: anyone_readable,无需 Lark 账号。相关命令示例可参考成员创建与空间设置调用的写法。其他功能、收费或平台支持等资料暂未提供。