用途:帮助用户完成 Terse 的初始设置。可选参数 $ARGUMENTS 为项目目录名。资料强调两种设置方式需先判别用户意图:表示“设置 Terse”“快速开始”“脚手架项目”“想构建任务”时运行 terse init,生成指向 Terse Cloud(托管)的新 SDK 项目;表示“自托管 Terse”“本地运行 Terse”“自己运行控制平面”“安装平台”时运行 npx create-terse,在本机生成基于 Docker 的 Terse 控制平面部署。意图不明确时默认走 terse init(托管),并告知用户如何切换到自托管。
参考文档:索引 https://docs.useterse.ai/llms.txt;CLI 参考 https://docs.useterse.ai/reference/cli(terse init、terse auth login、terse integrate 等的权威来源);托管概览 https://docs.useterse.ai/hosting(控制平面与数据平面及三种部署方式);自托管控制平面 https://docs.useterse.ai/self-hosting-control-plane(对应 npx create-terse);自托管数据平面(Hybrid) https://docs.useterse.ai/self-hosting(对应针对自有运行时的 terse attach)。
路径 A(terse init):默认路径。不要预检,不要先跑 find、ls、terse --version、terse integrate list,直接运行 terse init 并对其输出做出反应。用法:terse init <project-name> 脚手架到新子目录;terse init 脚手架到当前目录(要求不含 npm 文件)。有 $ARGUMENTS 时使用该名称,否则用当前目录。Bash 超时设为 600000(10 分钟)。terse init 自行处理认证:未登录时打开浏览器到 WorkOS 并等待授权,可提示用户可能弹出浏览器标签页。该命令会脚手架文件、安装依赖、按需登录、创建远程 Terse 项目、写入 terse.config.json 并运行 terse generate。
错误处理:command not found: terse 时安装 CLI(npm i -g terse-cli,或 pnpm add -g terse-cli / yarn global add terse-cli),再重试。检测到已有 npm 项目:若同时有 terse.config.json 或 src/terse.generated.ts 说明已设置,应停止、不要重新初始化,可建议用 /terse:create 添加任务;若是其他 npm 项目,建议 terse attach 或带项目名重跑以脚手架到相邻目录。目录已存在:换名或进入该目录评估。ACTION REQUIRED: Not authenticated 仅在非交互/CI 模式无有效凭据时出现,用 10 分钟超时运行 terse auth login 后重试。Failed to create Terse project:API 密钥有效但远程创建失败,本地脚手架仍在,向用户暴露错误并建议修复网络后重试,或在仪表盘创建项目后手动写 terse.config.json。
交接:成功后会打印 Next steps,不要逐字重复,仅按可能性提醒:terse integrate connect <type> 连接更多集成;用 /terse:create <description> 脚手架第一个任务;任务写好后运行 terse deploy。
路径 B(npx create-terse):仅在用户明确要自行运行 Terse 平台时使用。启动 Docker 内完整的本地控制平面副本(后端、前端、Postgres),与脚手架任务不同。需阅读 reference/self-hosting.md 并完整执行,其中包含完整 npx create-terse 流程:前置检查、交互与非交互运行、错误恢复、引导后的集成设置(OAuth 环境变量表),以及实例离开 localhost 前的生产暴露注意事项。限制:资料未提供具体收费、价格或系统要求等信息。