开始之前
LoneAct 的工作以 项目文件夹 为单位。它是一个被明确授权的项目目录；Agent 的文件、终端与浏览器工具只在这个边界内工作。
- 需要云端、远程授权或套餐能力时，一个可用的 LoneAct 账号与当前套餐。
- 一个准备交给 Agent 的项目目录，或一个可远程访问的已授权项目。
- 如果要使用文件、终端或浏览器工具，需要选择支持这些能力的运行端。
第一次使用建议从本地 Web 开始
本地 Web 最容易确认项目路径、工具权限和执行结果；熟悉后再切换到 IDE 或云端入口。
四步完成第一次运行
01
选择入口并准备模型
打开本地 Web，或在 VS Code / JetBrains 中打开 LoneAct 插件；需要 Cloud 或远程授权时再登录。云端工作台需要已授权的运行端。
02
打开 项目文件夹
选择项目目录并确认它可以被当前运行端访问。项目名、路径和执行边界会固定在这个 Location 上。
03
选择模型，写下目标
使用工作区默认模型，或从 Composer 的模型选择器切换。目标要写结果、约束与验收标准，而不是只写操作步骤。
04
审批并验证结果
需要写文件、运行终端或控制浏览器时，按界面提示审批。执行结束后检查 diff、测试与 Reviewer 的结论。
写一个好的第一个任务
修复问题
“修复登录接口在 token 过期时返回 401 的问题，补一个失败分支测试，并运行 pnpm test auth。”
交付功能
“为设置页增加导出配置功能；保持现有 API 兼容，补测试并在完成后说明变更文件。”
理解项目
“阅读这个仓库的支付链路，列出入口、数据流、外部依赖和三个最高风险的改动点。”
交给团队
“把这个目标拆给项目 Agent Team；Planner 先给计划，Executor 执行，Reviewer 复核后再交付。”
第一次运行检查清单
确认这些事实后再扩大任务范围
- 项目路径与运行端正确，且没有暴露不相关目录。
- 当前模型与套餐可用，模型名称符合预期。
- 文件和终端操作在审批后执行，结果能在对话里看到。
- 变更、测试和未完成项都已写回对话或任务记录。