用途：在 FlowUs 中通过 flowus CLI 上传本地文件或向块追加文件块，适合智能体代为处理文件上传与块追加的场景。
主要能力与用法：所有命令需加 --json。仅上传：flowus --json file upload <local_file> --parent-page <page_id>。追加已有文件对象：flowus --json block append-file <block_id> --oss-name <oss_name>。追加外部文件：flowus --json block append-file <block_id> --external-url <url>。
认证：不清楚认证状态时用 flowus --json doctor 检查，交互登录用 flowus login。凭证优先级为 --token、FLOWUS_TOKEN、flowus login 保存的 token。不要用 curl 调用 FlowUs V2 API，也不要打印或保存 bearer token。
规则与限制：上传文件会创建文件对象，追加到块需使用返回的 OSS name；oss_name 与 external-url 互斥且追加文件块时必须提供一个。上传后 FlowUs 托管文件应使用 oss_name，不要把返回的 file_url 当作外部 URL。外部 URL 仅适用于文件继续托管在 FlowUs 存储之外的场景。操作前需确认 parent page ID、本地文件路径、block ID、OSS name、外部 URL 均来自用户授权输入。进程输出可解析为 JSON 但 ok 为 false 时，应视为操作失败。