lark-wiki：让飞书知识库接入 AI 编程助手
lark-wiki：让飞书知识库接入 AI 编程助手


如果你日常用飞书知识库（Lark Wiki）管理团队文档，同时又依赖 AI 编程助手写代码、做自动化，一定经历过这样的尴尬：AI 助手能帮你写一整套微服务架构，却没法在你的知识库里新建一页文档；能生成几千行测试用例，却找不到你上周存在知识库里的那份技术方案。

lark-wiki 就是为了填补这个空白而出现的。它是飞书官方 CLI 工具 lark-cli 的 AI Agent Skill 套件之一，由 larksuite 团队维护。截至 2026 年 8 月，这套 Skill 体系已覆盖 17 个业务领域、200 多条命令和 24 个 AI Agent Skill。lark-wiki 的安装量已超过 5.5 万次，在各个技能分享平台上的下载总量已突破 10 万次。

这个技能能做什么

lark-wiki 的核心价值很简单：让 AI 编程助手直接操作飞书知识库——查空间、建页面、管成员、挪节点，全部通过自然语言完成。

具体来说，它覆盖了以下几个关键环节。

知识空间管理：创建新的知识空间、查询现有空间信息、获取空间列表。当你需要新建一个团队知识库或查看已有空间的结构时，直接告诉 AI 助手即可完成。

节点层级操作：在知识库中创建、查询、复制、移动、删除文档节点。节点是飞书知识库的基本组织单位——一篇文档、一个表格、一个文件夹都是一个节点。lark-wiki 能帮你把文档挂到指定父页面下、把散落各处的文档整理到统一的目录树里。

空间成员管理：查看知识空间成员列表、添加或移除成员。给新同事开知识库权限、调整团队成员的访问级别，这些操作都可以通过 AI 对话完成。

URL 和 Token 解析：当你给 AI 助手一个飞书知识库的链接（如 https://feishu.cn/wiki/wikcn_xxx）时，lark-wiki 能自动识别并解析出对应的节点信息。值得一提的是，即使链接来自 doubao.com 域名，只要 URL 路径包含 /wiki/ 模式，技能也会直接处理，而不会错误地回退到 WebFetch。

身份与权限智能处理：飞书知识库支持“用户视角”和“应用（Bot）视角”两种身份。lark-wiki 会优先使用用户身份操作——因为知识空间和节点本质上是用户的个人资源。只有当用户明确要求“以应用视角运行”时，才会切换到 Bot 身份。这种设计避免了“用 Bot 身份列出应用所属空间而不是用户空间”的常见问题。

与其他 Skill 的协同：lark-wiki 不是孤立工作的。上传文件到知识库节点下由 lark-drive 负责，编辑文档内容由 lark-doc、lark-sheets、lark-base 分别负责。当用户需要按主题搜索资料并收集到知识库时，lark-wiki 会联动 lark-drive 的搜索能力，而不是只靠 Wiki 节点列表做局部遍历。

安装方法

lark-wiki 支持 Claude Code、Cursor、Cline、Windsurf、Codex、Goose 等多种 AI 编程助手。安装方式取决于你使用的工具。

通过 npx skills 安装（推荐） ：

在项目根目录打开终端，执行以下命令：

bash
npx skills add https://github.com/larksuite/cli --skill lark-wiki

执行后 CLI 会列出可用的 AI 编程助手列表，用箭头键和空格选择你使用的工具（如 Cursor、Claude Code 等），技能会自动配置到对应环境中。

全局安装（适用于所有项目） ：

bash
npx skills add larksuite/cli --skill lark-wiki -g -y

通过 bzskills 安装：

bash
npx bzskills add larksuite/cli --skill lark-wiki

前置条件：

  • Node.js 16+ 且已安装 npm

  • 已安装 lark-cli 命令行工具

  • 一个已配置好的飞书应用（用于认证和权限）

安装完成后，技能文件会存放在 .cursor/skills/lark-wiki/ 或 .claude/skills/ 等目录下。重启 AI 编程助手即可生效，之后可以通过 /lark-wiki 命令或在对话中自然调用。

什么时候该用它

lark-wiki 的使用边界非常清晰。

应该使用的情况：

  • 需要在飞书知识库中查找或创建文档

  • 需要浏览知识空间的结构

  • 需要查看或管理知识空间的成员

  • 需要在知识库中移动或复制文档节点

  • 需要整理、盘点、归类或重构知识库的目录结构

  • 给 AI 助手提供了一个知识库的 URL 或 token，需要获取对应的资源信息

不应该使用的情况：

  • 上传文件到知识库节点下——这应该用 lark-drive

  • 编辑文档、表格或 Base 的具体内容——这些应该分别用 lark-doc、lark-sheets、lark-base

  • 思维笔记（MindNote）的移动、删除、快捷方式等操作——这些走 lark-drive

使用案例

案例一：在知识库里新建一篇技术方案文档

你的团队用飞书知识库管理技术文档，现在要写一份新的系统设计文档，需要挂在“后端架构”目录下。

你只需要对 AI 助手说：“在我的知识库里新建一篇页面，标题是‘订单服务重构方案’，挂在‘后端架构’目录下。”

lark-wiki 会自动定位到“后端架构”这个父节点，执行 lark-cli wiki +node-create --title "订单服务重构方案" --parent-node-token <token>，新页面随即出现在知识库的对应位置。

案例二：把散落的文档迁移到知识库

你的本地 docs/ 文件夹里堆积了几十份 Markdown 格式的技术文档，一直没有整理到飞书知识库里。你想把这些文档批量迁入知识库，挂到“技术文档”父页面下。

对 AI 助手说：“把 docs/ 文件夹里的文档都迁入我的知识库，挂在‘技术文档’页面下。”

lark-wiki 会识别出这是一个“迁入 Wiki”的操作，逐篇创建对应的知识库节点，并把文档内容同步进去。

案例三：给新同事开通知识库权限

团队来了新成员，需要给他开通某个知识空间的查看权限。

对 AI 助手说：“给 zhangsan@company.com 添加‘项目A知识库’的成员权限。”

lark-wiki 会先通过 lark-cli contact +search-user 查找用户信息，然后执行 lark-cli wiki +member-add --space-id <空间ID> --member-type user --member-id <用户ID>，新成员随即获得知识库的访问权限。

案例四：整理一团乱麻的知识库

某个知识库已经半年没整理了，页面散落在各处，目录结构混乱，想找个文档得靠搜索。

对 AI 助手说：“帮我分析一下这个知识库的结构有什么问题，然后给一个整理方案。”

lark-wiki 会联动 lark-drive 的 knowledge_organize 工作流，先盘点所有节点和目录结构，生成一份整理方案（包含目标目录树和移动计划），然后按计划执行节点移动。

几个值得注意的细节

开始前必须先读共享配置：lark-wiki 的 SKILL.md 明确要求——执行任何操作前，必须先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证和权限处理的关键信息。跳过这一步会导致各种权限和身份问题。

URL 解析不依赖域名：技能的路由依据是 URL 路径模式和 token，而不是域名。即使链接来自 doubao.com，只要包含 /wiki/ 路径，也会被正确解析。

节点 Token 和对象 Token 是两回事：Wiki URL 中的 /wiki/<token> 是节点 token，不一定是底层文档、表格或文件的对象 token。知识库节点层级操作走 lark-wiki，不要把底层对象 token 当节点 token 用。

成员管理的硬限制：以 Bot 身份运行且目标是“部门”时，无法添加知识空间成员。遇到这种情况，技能会直接说明路径不可行，而不是静默切换身份或试错。

身份默认用 user，不是 bot：CLI 的 --as 默认值为 auto，不带 --as 时常被解析成 bot。但 lark-wiki 的策略是优先使用 --as user——因为知识空间和节点本质上是用户的个人资源。仅当用户明确要求“应用/Bot 视角”时才用 --as bot。