## 状态 这是一份**规划/跟踪 Issue,仅供讨论,现在不开始实现**,也不在本 Issue 里提交代码或拆出实现 PR。仓库当前没有未关闭的同类跟踪项。 ## Problem to solve 新手要把 BootAgent 从「打开应用」走到「用真实模型跑完一个有界小任务」,路径仍然偏长、指引不够完整。现有六步激活向导(`/#/setup/agents` → 配置模版 → 模型服务 → 模型 → 确认 → 安装)已经可用,缺少的是在这条路上把环境检查、默认推荐、Key 说明、隔离小任务和失败后续串成一条可完成的最短路径。高级 Profile / 自定义端点应折叠但仍可进入,而不是再做一套并列向导。 ## Desired outcome 新手在单次会话内可以:看到环境/runtime 缺口并安装;默认选中一个经实证的可装 CLI Agent(可改选);理解 API Key 是什么、从官方入口获取,并完成真实模型连通测试(**不代承诺费用**);安装失败可重试且不重复安装已成功项;激活成功后在**临时隔离目录**跑预置安全小任务(例如生成介绍页),并看到产物路径、执行记录和失败后一步。日志与状态中的密钥必须脱敏。 ## Proposed approach 复用现有向导与能力,不重新设计产品。已核实:`LandingRoute` 在 `firstRun` 时进入 `/#/setup/agents`;无 Profile 时跳过模版步;`RuntimePrompt` 可先装 Node/uv;`ProviderKeyPage` 已有「获取 API Key」与「测试连接」;`/#/providers` 预设 JieKou.AI、PPIO、Novita、DeepSeek、Moonshot;`ActivationPage` / 任务中心已有重试、任务卡恢复、运行中阻止重复安装;语言已按 `bootagent.locale` 或系统语言(非 zh 起始则为 en)。i18n 与安装器本身不重写。 建议工作包(无工期、无负责人): - **P0-A** 调查设置页「无法读取备份设置」:`GetSettings` 在读出 settings 后还会调用 `Autostart.IsEnabled`,Wails server/e2e 下可能整体失败。e2e 已观察到该文案,**原生桌面未验证,不得预先定为产品 bug**。仅对已复现类别修复,并把备份错误与自启动探针解耦。 - **P0-B** 在现有 Agent 步叠加环境摘要,并默认选中一个已声明的 CLI Agent(可改选)。默认值**待原生系统实证**,倾向共享 Node(npm)的 CLI(目录中有 Codex、Claude Code、OpenCode、Kilo CLI、OpenClaw、Pi、DeepSeek Harness 等),**不作兼容保证**;Aider 依赖 uv,实证前不作为默认。 - **P0-C** 补充 Key 说明,只链向官方申请入口;真实 Key 下连通可过、无效 Key 下失败可读。`127.0.0.1:34124` 的固定 pong **不能作为验收**。 - **P0-D** 激活成功后增加隔离小任务、产物回显与失败下一步。可借鉴 `marketplace_recommend.go` 的 ephemeral sandbox,但它不是现成首次任务。真实模型未接通前不能结案。 - **P1-E** 打磨重启续跑与首屏语言选择可见性(核心 i18n 已存在)。 - **P1-F** 首次任务 UI 稳定后,重拍 BootAgent 品牌的中英文 README 截图并同步 `README.md` / `README_ZH.md`。 建议 PR 顺序与上述包对应:PR1=A,PR2=B,PR3=C,PR4=D,PR5=E(若需要),PR6=F。本 Issue **不创建这些 PR**。 验收还需覆盖:干净 HOME、安装失败可重试、无效 Key、模型不匹配、断网恢复、重启续跑、原生桌面 vs 浏览器 e2e(e2e 会假装 Node/macOS,不能替代原生验证结论)、密钥脱敏、任务只写临时目录且不发布外网。现有前端 594 项与 Go 测试应保持通过。 ## Alternatives considered 另起一套与 `/#/setup/*` 并列的向导:拒绝,成本高且与已验证流程重复。把 [README 截图 PR](https://github.com/MaimoryLab/BootAgent/pull/256)(README 加入 overview 截图)当作本切面的功能实现:拒绝;该 PR 只是文档背景,截图仍是旧品牌 OneAgent、中文界面,且 `README_ZH.md` 未同步,品牌更新放到 P1-F,不要与功能 PR 混在一起。 ## Additional context 观察基于提交 `7998ac238d14958c98816db93d7e33ca3ed72a10`,以及 Wails `-tags wails,server,e2e`(非 GTK 原生窗)。该环境下新 HOME 为 Agent 总数 0、缺 1 个 runtime(与 e2e 侧写「假装已有 Node、不提供 uv」相符),任务中心为空是预期;真实 Provider 尚未在本机验证。设置页备份报错需在原生与 e2e 分别复现后再分类。隔离小任务的产物格式与目录生命周期实施时再定稿。 相关但非重复(均已关闭):[#203](https://github.com/MaimoryLab/BootAgent/issues/203) 是更广的 UX 里程碑(Profile 快切等);[#91](https://github.com/MaimoryLab/BootAgent/issues/91) 是向导无法采纳已检测配置;[#85](https://github.com/MaimoryLab/BootAgent/issues/85) 是启动 CLI 时选择工作目录;[#60](https://github.com/MaimoryLab/BootAgent/issues/60) 是已装 Agent 仍走完整安装向导。当前仓库 **没有未关闭的重复 Issue**。 请不要在评论或附件中粘贴 API Key 或其他密钥。
Activity
fix: load settings when the autostart probe fails (#259)
feat: explain what an API key is on the Provider step (#263)
feat: show the machine and pre-select an Agent on a first run (#262)
feat: first-run setup, first task and receipts for operation results (#…