用途：FlowUs CLI（flowus）用于通过命令行调用 FlowUs V2 API，覆盖页面（pages）、块（blocks）、数据库（databases）、搜索、Markdown 内容与文件等操作，适合让智能体在用户授权后完成实际的 FlowUs 读写任务。
主要能力：页面发现与读取（page list/get、fetch）、Markdown 读写（markdown get/put）、页面创建更新与编辑复制（page create/update/edit/duplicate）、块操作（block get/children/append/update）、数据库查询与变更（database get/query/mutate、view 相关）、属性读取（page property get）、搜索（search text/semantic）、文件上传与文件块追加（file upload、block append-file）。CLI 自带文档：flowus --help、flowus help <command...>、flowus api ls、flowus api --docs/--spec。
使用方式：安装器位于 https://cdn2.flowus.cn/flowus-cli/install（Windows 为 install.ps1），需用户明确批准后才可下载或更新。远程调用前须先做预检：command -v flowus 检查是否安装、flowus version 查版本、flowus --json doctor 与 flowus --json whoami 检查认证与身份。凭据优先级为 --token <token>、FLOWUS_TOKEN、已保存登录凭据；不应在智能体会话、日志或共享 shell 中传 --token，也不要把令牌粘贴到聊天。登录方式需用户明确选择：浏览器登录 flowus login --browser，或无头环境手动设置 flowus --json login --manual。不要运行会在交互提示阻塞的裸 flowus login。
写入安全：任何远程创建、更新、追加、上传、替换或原始 API 写入前，须核对目标、操作与影响范围，尽量先读当前目标，Markdown 替换前比对现有内容，CLI 提供版本或 ETag 时使用 --if-match。JSON 请求体放本地文件并以 --body <file> 传入，Markdown 内容用 --file <file>。CLI 有意拒绝 DELETE API 调用，应改用需二次确认的专门删除流程。
限制与说明：CLI 源码仓库可能私有，不要要求用户克隆源码。凭据存储可能出现沙箱权限拒绝（credential_store_permission_denied）或 OAuth 刷新失败（oauth_refresh_failed），需按文档规则处理，不可一律要求重新登录。older 版本可能只报 Operation not permitted 或 OS error 1，应先检查路径与沙箱。不要用 curl 直接调用 FlowUs V2 API，应使用 CLI 以保持认证、默认值、重试与错误格式一致。更多收费、价格与平台细节暂未提供。