一、用途 Durable Actors Quickstart 用于指导在本地从零搭建一个最小化的 Terse Durable Actors 项目。它面向希望基于用户想法快速起一个 Durable Actors / Terse actors 应用的场景，流程覆盖脚手架、本地开发与部署（部署为可选后续步骤）。
二、主要能力与流程
- 确认依赖已安装（bun）。默认使用托管的 terse CLI，除非用户明确要求使用 durable-actors CLI、已安装开源 CLI，或明确要求开源版本。
- 运行 terse init，若用户未指定项目名则给出合适名称，并安装项目依赖。
- 在构建模板之外的功能前，先给出简短计划并请求确认。
- 启动 actor 开发服务器。
- 按用户想法构建功能。
- 生成供后端/前端使用的类型化 SDK。
- 验证解决方案，包括类型检查，并至少完整跑通一次端到端测试。
- 完成后可提议打开可观测性 UI；若为托管版，可提议将项目部署到云端。部署后需针对已部署的 actors 重新生成客户端，并对云端重跑端到端测试。
三、使用方式与约定
- 前后端 Web 应用：后端通过 RPC 调用 actor 方法并签发 WebSocket 授权；前端不使用 RPC，而是直接通过 WebSocket 连接 actor。
- CLI 使用可借助 --help 了解用法。
- 阅读 durable-actors 中的类型定义。
- 不清楚时可参考 docs.useterse.ai。
- 想先看模板样式可访问 https://github.com/TerseAI/Terse-Examples。
- 持久化字段用 @Persisted 标记，未标记内容在重启后丢失；@Persisted 在赋值时保存，因此数组和对象应重新赋值（如 this.list = [...this.list, x]），不要原地修改。
- 不要手动编辑 generated/ 目录。
- init 成功后不要重复运行。
- 不要把 TERSE_API_KEY 放入浏览器或用户电脑上安装的 CLI 等客户端代码中。
- 不要让用户在聊天中粘贴 API key，也不要打印或读取 .env；由用户自行把密钥写入被 gitignore 的 .env。
- actor 类上的每个方法都是 actor 方法且必须为 async，包括 TypeScript 私有方法；辅助方法使用 #private。
四、适用场景 适合需要快速启动 Durable Actors 应用、体验本地开发流程、生成类型化 SDK 并进行端到端验证的开发者。
五、限制 该快速入门按设计保持最小化，仅本地搭建，暂不包含发布步骤；部署、可观测性 UI 等为完成后可选提议的操作。其他具体功能、收费与价格信息暂未提供。