feishu-cli-platform

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

先判断意图，再读取对应工作流。不要一次加载全部 reference。加载后，将工作流中的

references/

、

scripts/

、

templates/

、

examples/

相对路径按该

workflow.md

所在目录解析；执行脚本时使用解析后的实际路径，不要依赖当前 shell 目录。

First determine the intent, then read the corresponding workflow. Do not load all references at once. After loading, resolve the relative paths

references/

scripts/

templates/

examples/

in the workflow according to the directory where the

workflow.md

is located; use the resolved actual path when executing scripts, do not rely on the current shell directory.

意图	读取文件
登录、登出、scope 预检、Token、profile、config、doctor	`references/workflows/auth/workflow.md`
调任意 OpenAPI、 `--as` 、分页和 dry-run	`references/workflows/api/workflow.md`
查询本地 OpenAPI path、参数和 scope	`references/workflows/schema/workflow.md`
搜索文档、消息或应用	`references/workflows/search/workflow.md`
查询用户、邮箱、手机号、部门	`references/workflows/directory/workflow.md`

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

Intent	File to Read
Login, logout, scope pre-check, Token, profile, config, doctor	`references/workflows/auth/workflow.md`
Call any OpenAPI, `--as` , pagination and dry-run	`references/workflows/api/workflow.md`
Query local OpenAPI path, parameters and scope	`references/workflows/schema/workflow.md`
Search documents, messages or apps	`references/workflows/search/workflow.md`
Query users, emails, phone numbers, departments	`references/workflows/directory/workflow.md`

Schema is only responsible for discovering interfaces; API is responsible for executing requests. Usually, check the schema first, then call the api.

Prioritize running the current compiled product
```
./feishu-cli
```
in the repository; use
```
feishu-cli
```
in PATH only for environment installation.
Execute
```
auth check --scope
```
first for User Token operations. Do not expose real Tokens in output, files or command history.
When there are multiple Bots / unsure which application is currently in use, run
```
profile list --json
```
first; use
```
--profile <name>
```
for single directory/Token selection, do not use
```
profile use
```
for a single command. If
```
env_overrides.app_id/app_secret=true
```
, environment variables still override App credentials, you need to prompt the user to unset the corresponding variables first.
Use
```
--dry-run
```
first for write requests; for endpoints that do not support dry-run, clearly inform users of side effects.
Search and address book results are read-only by default; switch to the corresponding domain Skill only when the user requests subsequent write operations.

Document read/write and import/export:
```
feishu-cli-docs
```
Cloud disk, knowledge base, comments and permissions:
```
feishu-cli-storage
```
Messages, group chats, cards and events:
```
feishu-cli-messaging
```
Sheet/Bitable:
```
feishu-cli-data
```