Skip to content

[Feature]: 新手首次任务垂直切面(计划跟踪,待讨论,暂不实现) #258

Open

Description

@Elysiasd

状态

这是一份规划/跟踪 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(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 是更广的 UX 里程碑(Profile 快切等);#91 是向导无法采纳已检测配置;#85 是启动 CLI 时选择工作目录;#60 是已装 Agent 仍走完整安装向导。当前仓库 没有未关闭的重复 Issue。

请不要在评论或附件中粘贴 API Key 或其他密钥。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions