梳理链路时发现的几个较小问题,合并在一起记录。 ## 1. backups 字段传到前端但从不显示 `internal/app/status.go:185` 的 `Backups map[string]bool` 一路传到 `frontend/src/types/api.ts:61`,但 grep `frontend/src` 里除类型定义外没有任何消费方。用户看不到备份存在,也没有恢复入口。而 `ReviewPage.tsx:58` 又向用户承诺「覆盖前会自动创建时间戳备份」——承诺了一个不可见、不可用的东西。 ## 2. 已安装的 Agent 走安装流程时静默 no-op `internal/install/install.go:128-135`:命令能解析且(`version == ""` 或 `current == version`)时提前返回,`result.Installed` 保持 false。下游 `internal/app/install.go:427-432` 仍把状态置为 `configured`、消息为 `Configured`,界面显示 `t("已完成")`。 结果是对的,但选了一个已安装 Agent 期待升级的用户得不到任何「本次没有安装动作」的信号。Review 页其实区分了这一点(`t("检测并配置")` vs `t("安装并配置")`,`ReviewPage.tsx:63,68`),激活页没有把这个区分传递下去。 ## 3. 「已安装但未配置」在选择页无法区分 `AgentStatus.Configured` 存在且由 `fileExists(configPath)` 计算(`internal/app/status.go:335`),但 `AgentRow.tsx:21-22` 只读 `status?.installed`,徽标只有「已安装」/「仅引导」/「待安装」。`Configured` 从未被读取,所以装了但没配的 Agent 和完全配好的看起来一样。 补充:`Configured` 本身也是弱信号——`fileExists` 对任何工具写的配置文件都为 true,不一定是 OneAgent 写的。 ## 4. status 里的 LockedVersion 恒为 nil `internal/app/status.go:214` 声明了 `LockedVersion`,`:336` 无条件设为 `nil`。运行时那边是有值的(`bootstrap.go:121`,`RuntimeSection.tsx:109-110` 正常显示),Agent 这边 `AgentRow.tsx:40` 读的是 catalog 而不是 status。任何试图从 `AgentStatus` 比较「已装版本 vs 锁定版本」的 UI 都会拿到空值。 ## 5. 空任务页是死路 `InstallTaskPage.tsx:16-18`:找不到匹配任务时只显示 `t("暂无任务")` 和一个「进入总览」。刷新 `/tasks/install/<id>` 或跟随一个已被清除的任务链接就会到这里,页面不说明任务发生了什么。`ActivationPage.tsx:267-288` 对同类情况有专门的恢复路径(`restoredTask`),两个页面处理方式不一致。 ## 6. 取消安装后不说明是否已写入任何东西 `t("已取消")`(`ActivationPage.tsx:298,299,326`、`InstallTaskPage.tsx:23`)。取消检查点分布在多处(`internal/app/install.go` 的步骤循环、`bootstrap.go:288,302,323`),所以取消可能落在运行时目录已发布但 Agent 包未安装之后,或配置已写入之后。运行时解压本身是 staging+rename 原子的(`bootstrap.go:292-331`),但整个运行不是事务性的。 取消行被合成为 `status: "skipped"` 且 `retryable: false`(`ActivationPage.tsx:325-327`),所以没有重试按钮也没有续跑。用户无法判断重新运行是否安全。 ## 7. 并发任务冲突的提示无法定位 `t("任务正在运行")`(`ActivationPage.tsx:84` 和 `:173`)。`:84` 这一处更糟:循环中途冲突会把**已经启动的任务回滚标记为 failure**,用同一句文案,所以一个无关的 Agent 会显示「任务正在运行」作为它的失败原因。两处都不指向那个正在运行的任务,也不说明是哪个 Agent 占着。 ## 8. 连接测试被界面称为可选,文档称为必需 `ProviderKeyPage.tsx:187` 显示「连接测试是可选的,可以直接继续选择模型」,配合 `:34` 的 `canContinue`,用户可以带着一个从未验证的 Key 走完向导,到激活阶段才发现问题。而 `docs/ai-agent-kit/zh/02-api-key.md:19` 把「点击测试连接」列为第 5 步的必需动作。 ## 9. RuntimePrompt 的失败样式与别处不一致 `RuntimePrompt.tsx:105` 用的是 `<span className="runtime-prompt-error">`,而 `RuntimeSection.tsx:92` 对同类失败用的是 `notice notice-error` 区块。同一类错误两种呈现。 ## 参考 见各条内联的 `file:line`。
Activity
yujiezhang-ops commentedon Aug 8, 2026
对这 9 条做了一轮核实,结论分三类。
第 1 条(备份不可见):我原来的描述是错的,需要更正
我当时写「
ReviewPage.tsx:58承诺了一个不可见、不可用的东西」。核实后:备份确实会创建。securefs.AtomicWrite每次写入前都调Backup(internal/securefs/securefs.go:137),而 Agent 配置写入走的就是AtomicWrite(internal/config/write.go:296)。所以安装流程里那句承诺是成立的。backups字段也确实有真实含义——backupState(internal/app/status.go:672)用 glob 检查磁盘上是否真有.backup-*文件。剩下的问题只是没有恢复入口,用户看不到备份存在、也无法从界面回滚。这是个功能缺口,不是「承诺造假」,优先级比我原先标的低。
唯一真的缺备份的是导入路径,已单独记在 #111。
第 5、6、7 条:确认存在,值得修
InstallTaskPage.tsx:16-18),且ActivationPage对同类情况有恢复路径,两边不一致retryable: false导致没有重试ActivationPage.tsx:84)第 9 条:撤回
.runtime-prompt-error是有样式的(app.css:2123),只是和notice notice-error呈现不同。纯观感差异,不构成缺陷。第 2、3、4、8 条:保留但不急
已安装 Agent 的 no-op 无信号、
Configured未被读取、LockedVersion恒为 nil、连接测试「可选/必需」表述矛盾。都是真的,但都不会让用户卡住或误判关键信息。建议把这个 issue 拆成两个:5/6/7 是一组可以动手的任务状态问题;2/3/4/8 归入界面一致性清理。要拆的话我可以另开。
fix: show each protocol's probe result and repair three task dead ends (
yujiezhang-ops commentedon Aug 8, 2026
第 5、6、7 条已在 #129 修复:
ACTIVATION_FAILED只往activationLog追加,而日志在折叠区里,所以被阻塞的运行在屏幕上什么都不显示——没有行、没有消息。现在会显示一条 notice,并且回滚时点名真正持有锁的那个 Agent,而不是把无关 Agent 标成「任务正在运行」第 1 条已在 #111 更正并关闭:备份确实存在(实测
AtomicWrite每次写入前都调Backup),我原来的判断是错的。第 9 条已撤回并在 #128 顺带统一了呈现方式。
这个 issue 剩下的范围
第 2、3、4、8 条:已安装 Agent 的 no-op 无信号、
Configured未被读取、LockedVersion恒为 nil、连接测试「可选/必需」表述矛盾。加上从 #111 转过来的一条:备份没有恢复入口——
backups字段后端算好也传到前端了(types/api.ts:61),但界面没有任何消费方,用户看不到备份存在也无法回滚。这五条都是真的,但都不会让用户卡住、丢数据或误判关键信息。建议保持打开但降低优先级,等有界面一致性清理的批次时一起做。