feishu-cli
统一的飞书 CLI skill。通过一个运行时处理：
help 渐进式帮助（适配 LLM 自发现）auth 授权与 token 管理tool 业务动作（calendar/contact/doc/wiki/drive/sheets/mail/meeting/okr/bitable）api 原始 Open API 调用
渐进式 help（推荐顺序）
# 1) 顶层命令总览
python3 skills/feishu-cli/run.py '{"action":"help"}'
# 2) 认证帮助
python3 skills/feishu-cli/run.py '{"action":"help","topic":"auth"}'
# 3) 查看全部模块
python3 skills/feishu-cli/run.py '{"action":"help","topic":"modules"}'
# 4) 查看某模块动作
python3 skills/feishu-cli/run.py '{"action":"help","topic":"module","module":"calendar"}'
# 5) 查看某动作参数与示例
python3 skills/feishu-cli/run.py '{"action":"help","topic":"action","module":"calendar","action_name":"create"}'
auth 示例
# 查看授权状态
python3 skills/feishu-cli/run.py '{"action":"auth","subcommand":"status"}'
# 获取租户 token（复用现有 lark_auth）
python3 skills/feishu-cli/run.py '{"action":"auth","subcommand":"tenant_token"}'
# 生成 OAuth URL（先做 redirect allowlist 预检）
python3 skills/feishu-cli/run.py '{"action":"auth","subcommand":"oauth_url","redirect_uri":"https://example.com/callback","scopes":["contact:user.base:readonly"]}'
tool 示例
# 创建日程
python3 skills/feishu-cli/run.py '{"action":"tool","module":"calendar","tool_action":"create","title":"周会","start":"2026-03-06 10:00","duration":"60m"}'
# 读取文档
python3 skills/feishu-cli/run.py '{"action":"tool","module":"doc","tool_action":"read","document_id":"doccnxxxx"}'
# 查询通讯录用户
python3 skills/feishu-cli/run.py '{"action":"tool","module":"contact","tool_action":"get_user","user_id":"ou_xxx"}'
api 示例
# 原始 Open API 调用（tenant）
python3 skills/feishu-cli/run.py '{"action":"api","method":"GET","path":"/contact/v3/scopes"}'
各模块动作速查
| module |
支持的 tool_action |
| calendar |
create, query, update, delete, list_calendars, freebusy |
| contact |
get_user, search_user, list_departments |
| doc |
create, read, read_content, write_markdown, list_blocks, update_block_text |
| wiki |
list_spaces, list_nodes, create_node, get_node |
| drive |
list_files, upload, download |
| sheets |
create, get, list_sheets |
| mail |
list_mailgroups, list_members |
| meeting |
create, list, get, update, delete |
| okr |
list_periods, batch_get, list_user_okrs |
| bitable |
list_tables, list_fields, list_records, create_record, update_record, delete_record |
| message |
send_message, history, upload_file |
| task |
list, create, update, delete, complete, uncomplete, list_subtasks, create_subtask |
别名兼容：旧名 create_spreadsheet→create，get_spreadsheet→get，list_okr_periods→list_periods，batch_get_okrs→batch_get 均已配置别名，可正常调用但文档以新名为准。
统一环境变量（建议）
LARK_APP_IDLARK_APP_SECRETLARK_TENANT_TOKEN（可选，优先直用）LARK_OPEN_BASE_URL（可选）LARK_OAUTH_REDIRECT_URI（OAuth）LARK_OAUTH_REDIRECT_ALLOWLIST（OAuth 预检）LARK_OAUTH_SCOPES（OAuth 默认 scope）
1---2name: feishu-cli3description: When the agent needs to call 飞书/Lark APIs locally → unified CLI (auth/tool/api/help) with progressive disclosure.4---5
6# feishu-cli
7
8统一的飞书 CLI skill。通过一个运行时处理：
9- `help` 渐进式帮助（适配 LLM 自发现）
10- `auth` 授权与 token 管理
11- `tool` 业务动作（calendar/contact/doc/wiki/drive/sheets/mail/meeting/okr/bitable）
12- `api` 原始 Open API 调用
13
14## 渐进式 help（推荐顺序）
15
16```bash
17# 1) 顶层命令总览
18python3 skills/feishu-cli/run.py '{"action":"help"}'
19
20# 2) 认证帮助
21python3 skills/feishu-cli/run.py '{"action":"help","topic":"auth"}'
22
23# 3) 查看全部模块
24python3 skills/feishu-cli/run.py '{"action":"help","topic":"modules"}'
25
26# 4) 查看某模块动作
27python3 skills/feishu-cli/run.py '{"action":"help","topic":"module","module":"calendar"}'
28
29# 5) 查看某动作参数与示例
30python3 skills/feishu-cli/run.py '{"action":"help","topic":"action","module":"calendar","action_name":"create"}'
31```
32
33## auth 示例
34
35```bash
36# 查看授权状态
37python3 skills/feishu-cli/run.py '{"action":"auth","subcommand":"status"}'
38
39# 获取租户 token（复用现有 lark_auth）
40python3 skills/feishu-cli/run.py '{"action":"auth","subcommand":"tenant_token"}'
41
42# 生成 OAuth URL（先做 redirect allowlist 预检）
43python3 skills/feishu-cli/run.py '{"action":"auth","subcommand":"oauth_url","redirect_uri":"https://example.com/callback","scopes":["contact:user.base:readonly"]}'
44```
45
46## tool 示例
47
48```bash
49# 创建日程
50python3 skills/feishu-cli/run.py '{"action":"tool","module":"calendar","tool_action":"create","title":"周会","start":"2026-03-06 10:00","duration":"60m"}'
51
52# 读取文档
53python3 skills/feishu-cli/run.py '{"action":"tool","module":"doc","tool_action":"read","document_id":"doccnxxxx"}'
54
55# 查询通讯录用户
56python3 skills/feishu-cli/run.py '{"action":"tool","module":"contact","tool_action":"get_user","user_id":"ou_xxx"}'
57```
58
59## api 示例
60
61```bash
62# 原始 Open API 调用（tenant）
63python3 skills/feishu-cli/run.py '{"action":"api","method":"GET","path":"/contact/v3/scopes"}'
64```
65
66## 各模块动作速查
67
68| module | 支持的 tool_action |
69|--------|-------------------|
70| calendar | create, query, update, delete, list_calendars, freebusy |
71| contact | get_user, search_user, list_departments |
72| doc | create, read, read_content, write_markdown, list_blocks, update_block_text |
73| wiki | list_spaces, list_nodes, create_node, get_node |
74| drive | list_files, upload, download |
75| **sheets** | **create, get, list_sheets** |
76| mail | list_mailgroups, list_members |
77| meeting | create, list, get, update, delete |
78| **okr** | **list_periods, batch_get, list_user_okrs** |
79| bitable | list_tables, list_fields, list_records, create_record, update_record, delete_record |
80| message | send_message, history, upload_file |
81| task | list, create, update, delete, complete, uncomplete, list_subtasks, create_subtask |
82
83> **别名兼容**：旧名 `create_spreadsheet`→`create`，`get_spreadsheet`→`get`，`list_okr_periods`→`list_periods`，`batch_get_okrs`→`batch_get` 均已配置别名，可正常调用但文档以新名为准。
84
85## 统一环境变量（建议）
86
87- `LARK_APP_ID`
88- `LARK_APP_SECRET`
89- `LARK_TENANT_TOKEN`（可选，优先直用）
90- `LARK_OPEN_BASE_URL`（可选）
91- `LARK_OAUTH_REDIRECT_URI`（OAuth）
92- `LARK_OAUTH_REDIRECT_ALLOWLIST`（OAuth 预检）
93- `LARK_OAUTH_SCOPES`（OAuth 默认 scope）
cklxx