Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions docs/tasks/T-1200/T-1252-instabox-panel-polish/brief.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
## 运行环境(云沙箱,必读)
- 开工先在 worktree 根目录运行 依赖准备脚本(镜像自带,把预装依赖链进 node_modules),之后 `pnpm exec vitest` / `pnpm exec tsc` 才可用。
- 这里**没有** systemd、Docker,说明里出现的 `systemd-run --scope ... --` 前缀一律去掉直接运行;机器 8G/4 核,一次只跑一个测试文件。
- 若本轮沙箱已放开(能联网、能监听端口),交回前必须把改动相关的测试全部跑过,包括需要端口的 e2e;涉及的 e2e 连跑 3 次都要过。跑不了的写明原因。
- 报告只写三样:改了什么(文件列表与 git status 一致)、为什么、测试命令与结果摘要。不要写长篇分析;完整输出放 verification 文本文件即可。
- 不提交 git。

# T-1252 云电脑面板:两处显示问题

## 背景
T-1239⑤(T-1246)已把 云电脑接进服务端和电脑面板。用真实钥匙截图时发现两处显示问题,只修这两处,不做别的改动。

## 必改
1. 智能体后端选 、机器还没建时,电脑面板「工作位置」下方写「任务第一次需要时,{bot} 会获得自己的 Boat 云端桌面」(`place.view.ccNew.line` 一类文案)。按智能体实际选的云端提供方显示:Boat 写 Boat,自托管 VPS / 用对应名称或不带名称的通用说法(已有 `computer.cloud.new` 可参考)。zh、en 都改,只保留 zh/en。 <!-- public-scan: allow domain -->
2. 同样状态下(选了 、机器未建),磁盘快照区域直接显示红字「快照操作失败,请稍后重试」。机器不存在时列快照应显示「还没有快照」(或等机器建好后再拉),不能当作失败;真正的接口错误仍显示错误。查清是前端把哪种响应当失败、还是服务端在没有机器时返回了错误,在根上修。

## 测试
- 给两条各补一个进仓库的测试(组件或路由层,用现有假 夹具),覆盖:未建机时文案不含 Boat;未建机时快照区不报错显示空列表;接口真失败时仍报错。
- 改动相关测试逐文件跑过,含 `scripts/testing/file-size-ratchet.test.ts`;`pnpm exec tsc -p tsconfig.server.json` 和前端 tsc;改动文件 `oxlint --deny-warnings`。
- 公开仓库:不得出现内部域名、IP、邮箱、人名、真实钥匙、uuid。

## 报告
report.md 只写:改了哪些文件、为什么、测试命令和结果摘要。
41 changes: 41 additions & 0 deletions docs/tasks/T-1200/T-1252-instabox-panel-polish/r10.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
## 运行环境(云沙箱,必读)
- 开工先在 worktree 根目录运行 依赖准备脚本(镜像自带,把预装依赖链进 node_modules),之后 `pnpm exec vitest` / `pnpm exec tsc` 才可用。
- 这里**没有** systemd、Docker,说明里出现的 `systemd-run --scope ... --` 前缀一律去掉直接运行;机器 8G/4 核,一次只跑一个测试文件。
- 若本轮沙箱已放开(能联网、能监听端口),交回前必须把改动相关的测试全部跑过,包括需要端口的 e2e;涉及的 e2e 连跑 3 次都要过。跑不了的写明原因。
- 报告只写三样:改了什么(文件列表与 git status 一致)、为什么、测试命令与结果摘要。不要写长篇分析;完整输出放 verification 文本文件即可。
- 不提交 git。

# T-1252 第 10 轮:删除智能体时不能把「缺 密钥」当成「没有云机器」

原任务见本文件夹 brief.md 和 r2–r9.md。工作区已有改动全部保留(含第 9 轮修好的 19 个 CI 失败)。产品规则不变:没保存后端的智能体默认用 ;Boat 在界面上隐藏;provider lock 只拦 box。

## 必改(第 6 轮审核)
server/index.ts 的 deleteBotWithLifecycle(约 9133 行)。第 9 轮把
「云后端是 instabox 就 requireInstabox(...).remove,否则 instabox?.remove」
改成了一律 `instabox?.remove(bot.id)`。没配密钥时 instabox 为 null,删除直接跳过云端清理。

触发场景:智能体已经在 上建过机器 → 清空配置里的密钥,或去掉环境密钥后重启 → 删除智能体。结果是本地智能体被删、接口返回成功,云上机器和数据留着,可能继续计费,应用里也没有入口再清理。

## 改法
1. 区分两种情况:
- 从来没建过机器:可以直接删,不需要密钥。第 9 轮要修的那批测试属于这种,必须继续通过。
- 建过机器,但现在缺密钥:保留智能体,返回 503,并提示先恢复 密钥再删除。
2. 判断依据是持久化的「这个智能体在 上有机器」的记录,不能只看内存,也不能只看默认后端,因为重启后内存会清空。先查现有代码有没有可用的持久记录(机器表、状态文件、bot 字段等):
- 有:复用它。
- 没有:用最小改动补一个,建机成功时写入,删机成功时清掉。
- 缺密钥时 wiring 层不要把这条记录清掉。
3. 补隔离回归测试:建机 → 去掉密钥 → 模拟重启 → 删除,预期返回 503,智能体还在,提示要求恢复密钥。同时保留「从未建机、没有密钥也能删除成功」的覆盖。
4. 第 9 轮把删除前的忙碌检查从 `cloudKindOf(bot) === "instabox"` 改成了 `instaboxConfigured(cfg)`。请确认这在「建过机、缺密钥」场景下仍然正确。

## 顺带(建议,小改)
report.md 本轮的文件清单要分开列:
- 当前改动:包括 r9.md 和本轮的 r10.md。
- 临时文件清理记录:已删除的 ci-fails.txt 单独写在这里,不要列成仓库改动。

## 验收
- 新回归测试通过。第 9 轮的 19 个文件、`server/instabox/` 下全部测试、删除相关测试全部通过,命令和结果追加到 verification.txt。
- 服务端和前端 tsc 通过;改动过的文件跑 `oxlint --deny-warnings`。
- 测试的临时目录用 os.tmpdir() 下新建的目录,避免 ENOENT。
- report.md 和 verification.txt 留在本任务文件夹里。不写 IP、地址、域名、uuid。文件名不要用反引号单独包住带 md 后缀的文件名。

本轮实现:新增独立持久机器记录,缺密钥时保留记录和智能体,删除返回 503 并要求恢复密钥;未建机智能体仍可删除。配置密钥、环境密钥及切换后端后的重启场景均由隔离回归覆盖。验证命令和结果见同目录 verification.txt,当前文件清单见 report.md。
39 changes: 39 additions & 0 deletions docs/tasks/T-1200/T-1252-instabox-panel-polish/r11.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
## 运行环境(云沙箱,必读)
- 开工先在 worktree 根目录运行 依赖准备脚本(镜像自带,把预装依赖链进 node_modules),之后 `pnpm exec vitest` / `pnpm exec tsc` 才可用。
- 这里**没有** systemd、Docker,说明里出现的 `systemd-run --scope ... --` 前缀一律去掉直接运行;机器 8G/4 核,一次只跑一个测试文件。
- 若本轮沙箱已放开(能联网、能监听端口),交回前必须把改动相关的测试全部跑过,包括需要端口的 e2e;涉及的 e2e 连跑 3 次都要过。跑不了的写明原因。
- 报告只写三样:改了什么(文件列表与 git status 一致)、为什么、测试命令与结果摘要。不要写长篇分析;完整输出放 verification 文本文件即可。
- 不提交 git。

# T-1252 第 11 轮:删除时,记录在案的 机器没核实清理前,不清记录、不删智能体

原任务见本文件夹 brief.md 和 r2–r10.md。工作区已有改动全部保留,包括第 9 轮修好的 19 个 CI 失败和第 10 轮的持久记录 machine-records。产品规则不变。这是第 3 轮以后的返工:只修下面这一个必改项,不扩大范围。

## 必改(第 7 轮审核)
server/instabox/machines.ts 的 remove(约 103–109 行)。现在的流程是 find(botId) 按名字查,查不到就直接 `records.forget(botId)`,删除随即成功返回。

问题场景:建过机器的智能体,后来密钥被换成另一个 账号的有效密钥。比如环境密钥去掉后,回退到另一账号的配置密钥。新账号下查不到原机器,结果本地记录和智能体都删了,原机器还在原账号里继续计费,DELETE 一次都没调用。

## 改法(按这个设计做)
1. machine-records 每条记录除了 botId → machineId,再存一个当前密钥的指纹。
- 指纹用 sha256 的前 16 位十六进制,绝不存明文密钥。
- remember 时把指纹一起写入。
- 这个文件只在本分支引入、尚未上线,不需要兼容旧格式。但读到旧的两元组时不要崩溃,按「指纹未知」处理。
2. remove 的规则:
- 先 find:找到了就照原来的方式 DELETE,成功后 forget。
- find 没找到,并且没有记录:直接成功,等于从未建过机器。
- find 没找到,但有记录:用记录里的机器 ID 调 GET 单台机器接口核实。
- 当前密钥指纹和记录一致,并且返回 404 或状态为 deleted:才 forget 并成功。
- 指纹不一致、指纹未知,或者核实失败、返回其他状态:保留记录,抛错,返回 503。错误信息写明:这个智能体的云电脑是用另一把 密钥创建的(或无法确认已删除),请恢复原密钥后再删除。
- deleteBotWithLifecycle 收到这个错误时保留智能体,沿用第 10 轮已有的 503 路径。
3. 回归测试,用隔离的假请求:
- 记录在 A 账号,当前密钥是 B 账号,list 返回空 → 删除返回 503,记录还在,智能体还在,DELETE 调用 0 次。
- 同一把密钥,list 返回空、GET 单台返回 404 → 删除成功,记录清掉。
- 第 10 轮已有的「建机 → 去掉密钥 → 重启 → 删除返回 503」「从未建机删除成功」两个测试继续通过。
4. report.md 顺带修正:第 10、11 轮的「当前改动」清单按 `git diff HEAD --stat` 加未跟踪文件如实列出,verification.txt 末尾的文件数同步改对。

## 验收
- 新回归测试通过。server/instabox 下全部测试、server/bot-delete 及删除相关测试、第 9 轮的 19 个文件全部通过。命令和结果追加到 verification.txt。
- 服务端 tsc 和前端 tsc 通过;改动过的文件跑 oxlint --deny-warnings。
- 测试临时目录用 os.tmpdir() 下新建的目录。
- report.md 和 verification.txt 留在本任务文件夹里,不写 IP、地址、域名、uuid,也不写任何密钥或密钥片段。文件名不要用反引号单独包住带 md 后缀的写法。
37 changes: 37 additions & 0 deletions docs/tasks/T-1200/T-1252-instabox-panel-polish/r12.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
## 运行环境(云沙箱,必读)
- 开工先在 worktree 根目录运行 依赖准备脚本(镜像自带,把预装依赖链进 node_modules),之后 `pnpm exec vitest` / `pnpm exec tsc` 才可用。
- 这里**没有** systemd、Docker,说明里出现的 `systemd-run --scope ... --` 前缀一律去掉直接运行;机器 8G/4 核,一次只跑一个测试文件。
- 若本轮沙箱已放开(能联网、能监听端口),交回前必须把改动相关的测试全部跑过,包括需要端口的 e2e;涉及的 e2e 连跑 3 次都要过。跑不了的写明原因。
- 报告只写三样:改了什么(文件列表与 git status 一致)、为什么、测试命令与结果摘要。不要写长篇分析;完整输出放 verification 文本文件即可。
- 不提交 git。

# T-1252 第 12 轮:解决和 main(T-1266)的合并冲突

原任务见本文件夹 brief.md 和 r2–r11.md。第 11 轮已审核通过。工作区现在正处在 `git merge origin/main` 的中途,main 新合入了 T-1266,内容是屏幕面板这几处修整:
- 未分配提示重复出现。
- 按钮和预览框之间没有间距。
- 共用模式下,工作位置仍显示「私有桌面」。

这一轮只解决冲突,不做别的改动。不要执行 git 命令去提交、中止或重置合并,由协调者提交。

## 冲突文件
- shared/place-view.ts(2 处)
- src/components/ComputerPanel.tsx
- src/components/WorksOnGrid.tsx
- src/components/bot-panel/ComputerTab.tsx
- src/locales/source-hashes.json

## 原则
- 两边的意图都要保留:
- T-1252:Boat 在界面上隐藏;云端桌面只显示 VPS 和 ,默认 ;provider lock 只拦 box;快照与删除保护。
- T-1266:未分配提示只出现一次;按钮和预览框之间有间距;共用模式下工作位置显示为共用电脑的说法。
- 两边改了同一段时,按「两个改动叠加后的正确行为」合成,不要简单地二选一。
- source-hashes.json 只合并两边的键,同一个键以英文源当前值对应的哈希为准。不要跑 `generate-locale.mjs --accept` 整体重写。合并完用 `PATH=/opt/node24/bin:$PATH node scripts/generate-locale.mjs zh --check` 确认通过。
- 解决后所有文件不能残留冲突标记。

## 验收
- `grep -rn '^<<<<<<<\|^>>>>>>>' shared src server` 无输出。
- 服务端 tsc 和前端 tsc 通过;冲突文件跑 `oxlint --deny-warnings`。
- 跑 T-1266 在 main 上新增或改动的测试:place.test.ts、RoomHeader.test.ts、ToolActivity.place.test.ts、remote-desktop-panel.screen.test.ts,以及 ComputerPanel、WorksOnGrid、ComputerTab、place-view 相关测试;再跑 server/instabox 下全部测试。全部通过,结果追加到 verification.txt。
- report.md 追加第 12 轮小节:每个冲突怎么合的。不写 IP、地址、域名、uuid;文件名不要用反引号单独包住带 md 后缀的写法。
- verification.txt 只写命令和汇总结果,例如通过数、失败数,不要贴原始测试输出。
46 changes: 46 additions & 0 deletions docs/tasks/T-1200/T-1252-instabox-panel-polish/r13.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
## 运行环境(云沙箱,必读)
- 开工先在 worktree 根目录运行 依赖准备脚本(镜像自带,把预装依赖链进 node_modules),之后 `pnpm exec vitest` / `pnpm exec tsc` 才可用。
- 这里**没有** systemd、Docker,说明里出现的 `systemd-run --scope ... --` 前缀一律去掉直接运行;机器 8G/4 核,一次只跑一个测试文件。
- 若本轮沙箱已放开(能联网、能监听端口),交回前必须把改动相关的测试全部跑过,包括需要端口的 e2e;涉及的 e2e 连跑 3 次都要过。跑不了的写明原因。
- 报告只写三样:改了什么(文件列表与 git status 一致)、为什么、测试命令与结果摘要。不要写长篇分析;完整输出放 verification 文本文件即可。
- 不提交 git。

# T-1252 第 13 轮:合入 main(T-1266)后又有 6 个分支独有的 CI 失败

原任务见本文件夹 brief.md 和 r2–r12.md。分支已提交并合入最新 main。工作区已有改动全部保留。产品规则不变:
- 没保存后端的智能体默认用 。
- Boat 在界面上隐藏。
- provider lock 只拦 box。
- 删除保护按 r10、r11 的做法。

这一轮只修 CI 失败。

## 失败文件(main 上都通过,只在本分支失败)
```
server/cloud-computer-auto-sleep.e2e.test.ts
server/cloud-computer-slow-start.e2e.test.ts
server/cloud-home-server.test.ts
server/cloud-lent-screen.e2e.test.ts
server/computer-engine-removal.e2e.test.ts
server/computer-take-control.e2e.test.ts
```
CI 失败摘录在本文件夹的 ci-fails.txt 里。典型报错:
- 「Add an API key to use this computer」(keyMissing)
- 「expected undefined to be 'cloud'」
- 「Fixture wait expired」
- 「Cannot read properties of undefined (reading 'env')」

## 改法
和第 9 轮一样逐个复现,然后按下面分类处理:
- **测试本意是 Boat 或托管云电脑**:夹具里显式写 cloudBackend: "box",不改断言意图。
- **测试与云后端无关**,只是被默认 卡住:修产品代码,让行为和 main 一致。
- **真正的回归**:修产品代码,比如 r10、r11 的删除保护或者 r12 的合并带来的问题。

report.md 追加第 13 轮小节,每个文件一行,写清原因属于哪一类、改了什么。

## 验收
- 上面 6 个文件逐个跑通过。第 9 轮的 19 个文件、server/instabox 下全部测试、T-1266 相关测试也都要再跑一遍并通过。
- verification.txt 只追加命令和汇总结果(通过数、失败数),不贴原始测试输出。
- 服务端 tsc 和前端 tsc 都通过;改动过的文件跑 oxlint --deny-warnings。
- 不写 IP、地址、域名、uuid;文件名不要用反引号单独包住带 md 后缀的写法。
- 修完删掉本文件夹里的 ci-fails.txt。
23 changes: 23 additions & 0 deletions docs/tasks/T-1200/T-1252-instabox-panel-polish/r2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
## 运行环境(云沙箱,必读)
- 开工先在 worktree 根目录运行 依赖准备脚本(镜像自带,把预装依赖链进 node_modules),之后 `pnpm exec vitest` / `pnpm exec tsc` 才可用。
- 这里**没有** systemd、Docker,说明里出现的 `systemd-run --scope ... --` 前缀一律去掉直接运行;机器 8G/4 核,一次只跑一个测试文件。
- 若本轮沙箱已放开(能联网、能监听端口),交回前必须把改动相关的测试全部跑过,包括需要端口的 e2e;涉及的 e2e 连跑 3 次都要过。跑不了的写明原因。
- 报告只写三样:改了什么(文件列表与 git status 一致)、为什么、测试命令与结果摘要。不要写长篇分析;完整输出放 verification 文本文件即可。
- 不提交 git。

# T-1252 云电脑面板:两处显示问题

## 背景
T-1239⑤(T-1246)已把 云电脑接进服务端和电脑面板。用真实钥匙截图时发现两处显示问题,只修这两处,不做别的改动。

## 必改
1. 智能体后端选 、机器还没建时,电脑面板「工作位置」下方写「任务第一次需要时,{bot} 会获得自己的 Boat 云端桌面」(`place.view.ccNew.line` 一类文案)。按智能体实际选的云端提供方显示:Boat 写 Boat,自托管 VPS / 用对应名称或不带名称的通用说法(已有 `computer.cloud.new` 可参考)。zh、en 都改,只保留 zh/en。 <!-- public-scan: allow domain -->
2. 同样状态下(选了 、机器未建),磁盘快照区域直接显示红字「快照操作失败,请稍后重试」。机器不存在时列快照应显示「还没有快照」(或等机器建好后再拉),不能当作失败;真正的接口错误仍显示错误。查清是前端把哪种响应当失败、还是服务端在没有机器时返回了错误,在根上修。

## 测试
- 给两条各补一个进仓库的测试(组件或路由层,用现有假 夹具),覆盖:未建机时文案不含 Boat;未建机时快照区不报错显示空列表;接口真失败时仍报错。
- 改动相关测试逐文件跑过,含 `scripts/testing/file-size-ratchet.test.ts`;`pnpm exec tsc -p tsconfig.server.json` 和前端 tsc;改动文件 `oxlint --deny-warnings`。
- 公开仓库:不得出现内部域名、IP、邮箱、人名、真实钥匙、uuid。

## 报告
report.md 只写:改了哪些文件、为什么、测试命令和结果摘要。
Loading
Loading