飞书链接
ginit lark link 的预期行为与权限不足时的增量授权。
飞书链接（Lark Link）
ginit lark link 把你的个人飞书身份链接到 ginit。链接之后，agent 会话里可以直接以你的身份调 lark 工具（发消息、读文档、写多维表格），权限与你自己登录飞书完全一致。
ginit lark link 的行为
ginit lark link预期流程：
[ginit lark link] opening Feishu consent page:
https://open.feishu.cn/open-apis/authen/v1/index?app_id=...&state=...
[ginit lark link] waiting for browser consent (timeout=600s, server_expires_in=600s)…
[ginit lark link] linked ✓ (scopes granted: 17)- CLI 先向服务端申请一个授权 URL，自动打开浏览器（SSH 环境加
--no-browser只打印 URL 自己去开） - 你在飞书授权页点同意
- CLI 轮询状态直到链接完成；默认超时 10 分钟，超时重跑一次即可
配套命令：
ginit lark statusginit lark unlink权限不足时：增量授权
首次 link 默认只申请 17 个核心 scope（IM、联系人、妙记、多维表格、文档）。发现某项操作提示权限不足时，用 --scope 增量补授权：
ginit lark link --scope "wiki:wiki:readonly sheets:spreadsheet"飞书 OAuth 天生是增量式的：每次授权都累加到你的授权集合，多次小批量 link 最终累积成完整权限，不会覆盖已有授权。每次请求也建议 ≤17 个 scope（飞书授权 URL 有长度上限，超了会被拒绝）。
scope 必须在 App 允许清单内，拼错或未登记直接 400。可申请的完整清单按前缀分组：
| 前缀 | 数量 | 覆盖 |
|---|---|---|
base: | 45 | 多维表格全操作（app/record/field/table/dashboard/workflow…） |
docs: / docx: | 31 | 文档读写、评论、导入导出、权限成员管理 |
calendar: | 20 | 日历与日程 |
im: | 19 | 消息、群聊、表情 |
wiki: | 14 | 知识库节点 |
contact: | 13 | 通讯录（用户/部门，多为 readonly） |
drive: | 12 | 云空间文件 |
vc: | 11 | 视频会议（含妙记） |
minutes: | 10 | 妙记 |
spark: | 8 | 智能协作者 |
space: | 6 | 知识库空间 |
sheets: | 5 | 电子表格 |
slides: / board: / mindnote: | 4/4/2 | 幻灯片 / 白板 / 思维笔记 |
search: | 2 | 搜索 |
bitable: | 2 | 旧版多维表格 scope |
Agent 申请授权时按这张表核对拼写与可申请性；完整逐条清单（208 项）以飞书开发者后台 App 登记为准，也会随 App 权限变更同步更新。
评论
正在加载评论…