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

# T-1253 共用电脑:未分配屏幕时可一键分配

## 背景
共用电脑(服务器上的 Local VM,多屏模式)最多 4 块虚拟屏。屏幕只在智能体开始跑任务时由 `server/local-vm-screens.ts` 的 `LocalVmScreenPool.request()` / `waitFor()` 分配,闲置后收回。用户在桌面面板打开一个当前没跑任务的智能体,会看到 `vm.screens.unassignedBot` 提示「这个智能体目前没有分配屏幕,下次运行时会自动分配。」,只能等着,什么也做不了。出现这条提示的地方:`src/components/remote-desktop-panel.tsx` 约 212、241 行;`src/lib/local-vm-screen-state.ts` 约 65 行;`server/routes/computers.ts` 约 384、456、480 行的 409 `screen_not_assigned`。

## 要做
1. 服务端新增一个接口(放在现有 local-computer 路由旁边,权限和现有查看/加入接口一致):替当前智能体申请一块屏幕。
- 有空屏,或能收回别人的闲置屏,就立即分配,返回屏幕号。
- 4 块都忙,就进入现有排队(复用 pool 的排队机制,不另造),返回排队位置。
- 用户主动申请的屏幕同样按现有闲置规则到时收回。不能抢正在跑任务的屏幕,也不能改变已有智能体的分配。
2. 前端:所有显示「未分配屏幕」的地方,在提示下面加一个按钮「现在分配屏幕」(英文 Assign a screen now)。
- 点了以后调用上面的接口。
- 拿到屏幕就接着走原来的打开桌面流程。
- 在排队时显示现有的排队文案 `vm.screens.queued`(第几位),并轮询状态,轮到后自动打开。
- 提示文案改为「这个智能体目前没有分配屏幕。」,后半句去掉,改由按钮说明。
- zh/en 都要改,不出现 Boat 字样。
3. 单屏模式或没开多屏时,行为和现在完全一致。

## 不要动
`server/instabox/`、`server/cloud-backend.ts`、`CloudBackendPicker.tsx`、`AccessSection.tsx`、快照相关文件(这些另一个分支正在改)。改动尽量集中在屏幕池、computers 路由、remote-desktop-panel 和 local-vm-screen-state 这几处。

## 验收
- 补隔离测试,覆盖以下情况:
- 有空屏时立即分配;
- 屏满时进入排队并返回位置;
- 不抢正在跑任务的屏幕;
- 非多屏模式下行为不变;
- 前端按钮点击后的流程(组件测试)。
- 改动涉及的测试文件逐个跑过,包括 `server/local-vm-screens*.test.ts`、`server/routes/computers.test.ts`、相关前端测试,以及 `scripts/testing/file-size-ratchet.test.ts`。
- `pnpm exec tsc -p tsconfig.server.json` 和前端 tsc 都要通过;改动过的文件跑 `oxlint --deny-warnings`。
- 写 report.md(短)和 verification.txt。verification.txt 里不写 IP、地址、域名、uuid。
25 changes: 25 additions & 0 deletions docs/tasks/T-1200/T-1253-screen-assign-now/r2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
## 运行环境(云沙箱,必读)
- 开工先在 worktree 根目录运行 依赖准备脚本(镜像自带,把预装依赖链进 node_modules),之后 `pnpm exec vitest` / `pnpm exec tsc` 才可用。
- 这里**没有** systemd、Docker,说明里出现的 `systemd-run --scope ... --` 前缀一律去掉直接运行;机器 8G/4 核,一次只跑一个测试文件。
- 若本轮沙箱已放开(能联网、能监听端口),交回前必须把改动相关的测试全部跑过,包括需要端口的 e2e;涉及的 e2e 连跑 3 次都要过。跑不了的写明原因。
- 报告只写三样:改了什么(文件列表与 git status 一致)、为什么、测试命令与结果摘要。不要写长篇分析;完整输出放 verification 文本文件即可。
- 不提交 git。

# T-1253 第 2 轮:按第 1 轮审核修 2 项必改

原任务见本文件夹 brief.md,工作区已有改动全部保留,只修下面两项。

## 必改
1. **起屏期间申请流程被提前隐藏,失败后看不到重试入口。** 涉及 `src/components/AssignLocalVmScreen.tsx` 约 53 行、`src/components/ComputerPanel.tsx` 约 1300 行、`src/components/remote-desktop-panel.tsx` 约 97 行。
- 问题:排队结束后,服务端可能返回 `screen` 非空、`ready:false`、`desktopReady:true`。这时主面板进入 `vm-unavailable`,远程面板清空 `screenWait`,两处都把申请组件隐藏了。之后如果起屏失败,子组件里记了错误、停了轮询,但错误和重试按钮都看不到;父面板这时也已经停止状态轮询。
- 要求:申请流程从点击开始一直显示,直到成功打开桌面或明确失败为止。失败时显示错误和「重试」按钮。父面板在这期间继续轮询状态。
- 补组件测试,覆盖三种情况:排队后屏幕在启动中、启动失败、重试成功。
2. **verification.txt 脱敏有遗漏。**
- 第 314、320 行及之后重复出现的错误文本里有 IPv6 地址,结构化的 `address` 字段里也有,都要脱敏。
- 第 10 行等处,测试文件名被误替换成 `[redacted-host].ts`,要恢复成仓库内的相对文件名,只脱敏真实地址。

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

# T-1253 第 3 轮:修第 2 轮审核的 1 项必改

原任务见本文件夹 brief.md 和 r2.md。工作区里已有的改动全部保留。这一轮只修下面一项,再处理一条整理,不做别的改动。

## 必改
在 `src/components/ComputerPanel.tsx` 约 456 行,已经拿到屏幕之后,如果状态轮询收到 `screen_not_assigned`,这个分支会直接 return,没有 reject `openAssignedScreen` 的 Promise。结果 `AssignLocalVmScreen.tsx` 约 37 行一直卡在 `await assigned.current()`:
- 按钮一直停在「进行中」;
- 用户看不到错误,也没有重试入口。

改法:在这个分支里,先取出 `openAssignedScreen.current` 并把它清空,再调用 `reject(e)`。然后检查同一个 Promise 的其他退出路径,确认每条都会 resolve 或 reject,包括组件卸载和切换智能体。

补回归测试:拿到屏幕后,轮询返回 `screen_not_assigned`,断言按钮回到可点状态,并显示错误和「重试」。

## 整理
把 `verification.txt` 里已经修正过的早期失败测试记录删掉,只保留最终有效的记录。

## 验收
- 改动涉及的测试文件逐个跑过,包括 `AssignLocalVmScreen`、`ComputerPanel` 和 `remote-desktop-panel` 的相关测试。
- 前端 tsc 通过。改动过的文件跑 `oxlint --deny-warnings`。
- report.md 追加一节「第 3 轮」,写短。verification.txt 里不写 IP、地址、域名、uuid。
53 changes: 53 additions & 0 deletions docs/tasks/T-1200/T-1253-screen-assign-now/report.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
改了什么:新增申请屏幕接口,复用原队列与闲置回收;两个桌面入口增加中英文按钮,排队后自动打开。文件清单:

- `docs/tasks/T-1200/T-1253-screen-assign-now/report.md`
- `docs/tasks/T-1200/T-1253-screen-assign-now/verification.txt`
- `server/index.ts`
- `server/local-vm-screen-runtime.test.ts`
- `server/local-vm-screen-runtime.ts`
- `server/local-vm-screens.e2e.test.ts`
- `server/local-vm-screens.test.ts`
- `server/local-vm-screens.ts`
- `server/routes/computers.test.ts`
- `server/routes/computers.ts`
- `src/components/AssignLocalVmScreen.tsx`
- `src/components/ComputerPanel.takeover.test.ts`
- `src/components/ComputerPanel.tsx`
- `src/components/remote-desktop-panel.open.test.ts`
- `src/components/remote-desktop-panel.screen.test.ts`
- `src/components/remote-desktop-panel.tsx`
- `src/locales/en.json`
- `src/locales/zh.json`

为什么:闲置智能体无需运行任务即可打开桌面;保留已有分配、忙屏保护和单屏行为。

测试:23 个文件、283 个测试逐个通过(`pnpm exec vitest run <文件> --maxWorkers=1`);屏幕 e2e 最终连续三轮均为 16/16 通过。`pnpm exec tsc -p tsconfig.server.json`、`pnpm exec tsc -p tsconfig.json`、`pnpm exec oxlint --deny-warnings <全部改动代码文件>`、`git diff --check` 均通过;完整命令与脱敏输出见 verification.txt。验证说明文档在工作树缺失,使用现有隔离 fixture 完成验证。

## 第 2 轮

改了什么:保留排队、起屏、打开桌面期间的申请状态;失败显示错误和「重试」,父面板持续轮询未就绪的屏幕。补齐两个入口的起屏、失败重试及打开失败测试;恢复验证记录中的测试路径,补齐 IPv6 脱敏。本轮文件(与 git status 一致):

- `src/components/AssignLocalVmScreen.tsx`
- `src/components/ComputerPanel.tsx`
- `src/components/ComputerPanel.takeover.test.ts`
- `src/components/remote-desktop-panel.tsx`
- `src/components/remote-desktop-panel.screen.test.ts`
- `docs/tasks/T-1200/T-1253-screen-assign-now/verification.txt`
- `docs/tasks/T-1200/T-1253-screen-assign-now/report.md`

为什么:拿到屏幕号不代表桌面就绪,不能因此隐藏申请和重试入口;日志只脱敏真实地址,不破坏测试文件名。

测试:`pnpm exec vitest run <文件> --maxWorkers=1` 逐文件通过:23 个文件、289 项;其中屏幕 e2e 连续 3 轮各 16/16。`pnpm exec tsc -p tsconfig.json`、`pnpm exec tsc -p tsconfig.server.json`、`pnpm exec oxlint --deny-warnings <上述 5 个代码文件>`、`git diff --check` 通过;`grep -niP` 检查 IPv4、IPv6、域名、UUID 无匹配,并额外核验公共域名后缀及仓库文件路径。完整命令与脱敏输出见 verification.txt。仓库缺少验证 README,e2e 使用独立临时数据目录和模拟运行时;未提交 git。

## 第 3 轮

改了什么:统一先清空申请引用再 reject,覆盖 `screen_not_assigned`、其他终止错误、卸载及切换智能体/会话/面板;取得控制权期间仍保留可取消的 Promise。补 10 项回归,验证错误、可点击的「重试」、重试成功及取消。验证记录仅保留最终有效输出。本轮文件(与 git status 一致):

- `src/components/ComputerPanel.tsx`
- `src/components/ComputerPanel.takeover.test.ts`
- `docs/tasks/T-1200/T-1253-screen-assign-now/report.md`
- `docs/tasks/T-1200/T-1253-screen-assign-now/verification.txt`

为什么:避免拿到屏幕后 Promise 悬空、按钮卡在「进行中」,确保失败可以重试,离开当前面板时结束等待。

测试:`pnpm exec vitest run <文件> --maxWorkers=1` 逐文件通过 23 个文件、299 项;AssignLocalVmScreen 由两个面板的真实组件集成测试覆盖,屏幕 e2e 使用隔离 fixture 连续 3 轮各 16/16。`pnpm exec tsc -p tsconfig.json`、`pnpm exec tsc -p tsconfig.server.json`、`pnpm exec oxlint --deny-warnings src/components/ComputerPanel.tsx src/components/ComputerPanel.takeover.test.ts`、`git diff --check` 均通过。`grep -niP` 脱敏检查无匹配;live 测试通过但有已有连接拒绝诊断,完整脱敏输出见 verification.txt。未提交 git。
Loading
Loading