用途：Buildin CLI（命令为 buildin）用于通过 Buildin V2 API 处理页面、区块、数据库、搜索、Markdown 内容和文件等任务。执行前需完成预检，CLI 帮助、端点文档和离线规划不需要认证。
主要能力：页面读取与创建更新、Markdown 获取与替换、区块读取、子区块追加与更新、数据库查询与创建更新、页面属性读取、文本与语义搜索、文件上传与追加文件区块，以及底层 api call 回退调用。CLI 自带文档，优先使用 buildin --help、buildin help <command...>、buildin api ls 与 buildin api --docs <PATH> -X <METHOD> 等命令。
使用方式：先用 buildin version 检查是否存在，未安装时需用户明确同意后再使用官方安装源 https://cdn.buildin.ai/buildin-cli/install（Windows 为 install.ps1）。认证状态用 buildin --json doctor 与 buildin --json whoami 检查；未认证时提供浏览器登录 buildin login --browser、无头环境手动登录 buildin --json login --manual 或经批准的秘密渠道配置 BUILDIN_TOKEN，且必须等待用户选择。JSON 请求体放本地文件用 --body <file>，Markdown 替换内容用 --file <file>。读取页面可用 buildin --json page get <page_id> 或 buildin markdown get <page_id>。
适用场景：需要以脚本或智能体方式操作 Buildin 协作空间中的内容、数据库与文件时。
限制：CLI 有意拒绝 DELETE API 调用。所有远程写入前需核对目标、操作与影响，并优先读取当前目标；不要用 curl 调用 Buildin V2 API；不要输出或粘贴凭证；不要运行会阻塞的 buildin login；安装、更新或登录均须用户明确批准。其他收费、价格、平台支持等细节暂未提供。