# Feishu Cli Platform

> 飞书 CLI 平台基础能力，不是飞书请求的通用兜底：配置与多 Profile、Device Flow 登录、Token 与 scope 预检、应用侧 scope 开通诊断、doctor、技能安装…

飞书 CLI 平台基础能力，不是飞书请求的通用兜底：配置与多 Profile、Device Flow 登录、Token 与 scope 预检、应用侧 scope 开通诊断、doctor、技能安装与 CLI 升级、OpenAPI schema 查询与 api 透传、全局搜索（文档含文件夹/知识库/创建者筛选、消息、应用），按邮箱或手机号查用户、部门与机器人。用户提到登录飞书、Token 过期、99991672/99991679、切换 profile、技能与 CLI 版本漂移、调用未封装接口、跨飞书搜文档或消息、查 open_id 时使用；查 schema 或发 raw API 时即使端点属于审批或会议也用本 Skill。不用于文档、云盘与权限、消息、表格、可视化、日历/任务/审批/OKR、邮件和会议等业务操作，分别使用 feishu-cli-docs/storage/messaging/data/visual/work/mail/meetings。

- Page: https://ss33.ai/skills/riba2534/feishu-cli-platform-63457374899
- Publisher: riba2534
- Category: [AI & Agents](https://ss33.ai/skills/category/ai-and-agents-y6jz7i) › [Tool & MCP integration](https://ss33.ai/skills/category/ai-and-agents-y6jz7i/tool-and-mcp-integration-fgfs8e)
- License: MIT
- Source: https://github.com/riba2534/feishu-cli/blob/a7bb5c905064062576080382e0bc4cc339871c53/skills/feishu-cli-platform/SKILL.md

## Skill

SKILL.md: https://ss33.ai/api/v1/ss33/download/riba2534/feishu-cli-platform-63457374899

# 飞书平台能力

先判断意图，再读取对应工作流。不要一次加载全部 reference。
加载后，将工作流中的 `references/`、`scripts/`、`templates/`、`examples/` 相对路径按该
`workflow.md` 所在目录解析；执行脚本时使用解析后的实际路径，不要依赖当前 shell 目录。

## 路由

| 意图 | 读取文件 |
|---|---|
| 登录、登出、scope 预检、应用已开通 scope 诊断（`auth scopes`）、Token、profile、config、doctor、技能安装/漂移（`skills`）、CLI 升级（`update`） | `references/workflows/auth/workflow.md` |
| 调任意 OpenAPI、`--as`、分页和 dry-run | `references/workflows/api/workflow.md` |
| 查询本地 OpenAPI path、参数和 scope | `references/workflows/schema/workflow.md` |
| 全局搜索文档（含 `drive search` 按文件夹/知识库/创建者精筛）、消息或应用 | `references/workflows/search/workflow.md` |
| 查询用户、邮箱、手机号、部门，搜索机器人（`user search-bot`） | `references/workflows/directory/workflow.md` |

涉及身份选择，或遇到 Token、身份、scope 报错（如 99991663/99991668/99991672/99991679）时读取 `references/workflows/auth/references/identity.md`，排错表见 `references/workflows/auth/workflow.md`；`auth check` 不是 Bot 权限检查。
判断命令成败、编写脚本或遇到退出码 10（需确认）时读取 `references/workflows/auth/references/agent-contract.md`。

Schema 只负责发现接口；API 负责执行请求。通常先查 schema，再调用 api。

## 执行规则

1. 仓库开发优先使用刚编译的 `bin/feishu-cli`（`make build`）或 `./feishu-cli`；安装环境使用 PATH 中的 `feishu-cli`。技能与 CLI 版本不一致时（命令或 flag 对不上），以 `--help` 为准，并用 `feishu-cli skills read <技能> <相对路径>` 读取与当前二进制配套的文档；每个命令 `--help` 末尾会列出相关技能与工作流。
2. 先确定执行身份。`auth check --scope` 只检查当前 profile 的本地 User Token，不能验证 Bot 权限或显式 Token；应用侧是否开通（区分 99991672 应用未开通与 99991679 用户未授权）用 `auth scopes --scope`，Bot 能否访问具体资源以实际接口结果为准。不要回显真实 Token。
3. 多 Bot / 不确定当前应用时先 `profile list --json`；单次用 `--profile <name>`，不改默认指针。环境变量覆盖了目标 App 时，沿用已有授权在本次进程移除对应覆盖，或用 `--bot-app-id/--bot-app-secret` 指定正确凭证，不修改用户全局环境。
4. `api` 的所有写请求均可先用 CLI 本地 `--dry-run` 预览；预览不代表服务端接受。其他命令按各自帮助选择验证方式。
5. 搜索与通讯录结果默认只读取；用户要求后续写操作时再切换到对应领域 Skill。
6. 退出码、确认门禁（退出码 10 须经用户同意才追加 `--yes`）、stdout/stderr 约定与目标实体解析见 `references/workflows/auth/references/agent-contract.md`。

## 领域边界

- 文档读写与导入导出：`feishu-cli-docs`
- 云盘、知识库、评论和权限：`feishu-cli-storage`
- 消息、群聊、卡片和事件：`feishu-cli-messaging`
- Sheet/Bitable：`feishu-cli-data`
- 画板、Slides、HTMLBox 与妙搭应用：`feishu-cli-visual`
- 日历、任务、审批、考勤和 OKR：`feishu-cli-work`
- 飞书邮箱：`feishu-cli-mail`
- 视频会议与妙记：`feishu-cli-meetings`

查 schema 或用 `api` 透传未封装端点时即使端点属于上述业务域也留在本 Skill；业务命令本身交给对应领域 Skill。