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
51 changes: 51 additions & 0 deletions docs/tasks/T-1200/T-1248-multiscreen-ui-fixes/brief.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
## 运行环境(InstaBox 云沙箱,必读)
- 开工先在 worktree 根目录运行 `crybot-link-deps`(镜像自带,把预装依赖链进 node_modules),之后 `pnpm exec vitest` / `pnpm exec tsc` 才可用。
- 这里**没有** systemd、Docker,说明里出现的 `systemd-run --scope ... --` 前缀一律去掉直接运行;机器 8G/4 核,一次只跑一个测试文件。
- 若本轮沙箱已放开(能联网、能监听端口),交回前必须把改动相关的测试全部跑过。跑不了的写明原因。
- 报告只写三样:改了什么(文件列表与 git status 一致)、为什么、测试命令与结果摘要。不要写长篇分析;完整输出放 verification 文本文件即可。
- 不提交 git。
- 本仓库是**公开仓库**:代码、测试、文档、报告里不得出现内部域名、IP、邮箱、人名、真实钥匙、沙箱主目录绝对路径。

# T-1248:多屏界面 4 处小问题

## 背景
「一个容器多块虚拟屏」(T-1228)已上线,预览截图里发现 4 处界面问题。下面是已查实的根因和位置(行号以当前 main 为准,可能略有偏移,按内容找)。只修这 4 处,不顺手改别的;「私有桌面」这个产品名本身(相关文案 80 多处)不改。

## 要改的

### 1. 排队等屏的智能体,侧栏显示「正在操作屏幕」
根因:等屏时服务端往对话追加一条进行中的 activity 行,tool 的 name 字段 是英文句子 `Waiting for its turn on this computer — 1st in queue — …`,没有 nameCode(`server/turn-computer-wait.ts` 约 47 行,文案来自 `server/computer-wait.ts` 的 `computerWaitingText`,多屏排队也走这里 `server/local-vm-screen-runtime.ts`)。前端 `src/lib/live-activity.ts` 的 `toolActivityPhrases` 把整句当工具名,用 FALLBACK 正则(约 18 行,含 `computer`)去猜,命中后映射成 「正在操作屏幕」文案。
改法:
- (a) 服务端:等屏行改用 `noticeTool(...)`(`server/chat-notices.ts`)带 nameCode,新增 `chat.notice.waitingForScreen`,英文保持现有句子,参数带 `{position}`(无位置时省略)。
- (b) 前端:`toolActivityPhrases` 识别该 nameCode 时,返回现成的 `vm.screens.queued`(「正在排队,第 {position} 位」/「Queued · Position {position}」),无位置时用 `vm.screens.queue`。`ActivityTool` 类型补 `nameCode` / `nameParams`(如还没有)。
- (c) 兜底:FALLBACK 正则只对不含空格的真工具名生效,带空格的整句不去猜。这样 `chat.notice.wakingComputer`(「Waking the computer…」)也不会再被判成「正在操作屏幕」。
- `src/locales/server-lines.test.ts` 的 PENDING 名单里如有这两句英文,改完后从名单删掉。
测试:`src/lib/live-activity.test.ts`(照内存等待用例加等屏、唤醒两例,以及「带空格句子不走正则」)、`src/components/SidebarWorkingStep.test.ts`、`server/computer-wait.test.ts`、`server/chat-notices.test.ts`、`server/local-vm-screen-runtime.test.ts`(按实际改动挑)。

### 2. 共享多屏模式下屏被标成「私有桌面」「隔离的本地桌面」
根因:标签是静态键,不区分隔离方式和屏数:`src/components/ComputerPanel.tsx`(约 1285 行 `t("vm.dest.vm")` 角标)、`src/components/remote-desktop-panel.tsx`(约 230 行副标题)、`src/components/WorksOnGrid.tsx`(约 16 行,`vm.dest.vm` + `computer.dest.vmDesc`)、`src/components/PlaceChip.tsx`(约 96-97 行)。`/api/config` 已下发 `localVm.screens`(server/index.ts),但前端类型 `src/state/config-status.ts` 没声明该字段。
改法:
- 屏幕面板角标和远程桌面副标题:有屏号(`vmStatus.screen?.screen` 或等价字段)时显示现成的 `vm.screens.number`(「第 {screen} 块屏」/「Screen {screen}」),没有屏号再回退 `vm.dest.vm`。
- `config-status.ts` 类型补 `screens?: number`;隔离方式为 shared 且屏数 > 1 时,WorksOnGrid / PlaceChip 的描述改用新键 `computer.dest.vmScreenDesc`:zh「共享容器里的一块虚拟屏」,en「A screen in a shared container」。单屏或按智能体隔离时保持原样。
测试:`src/components/ComputerPanel.test.ts`(及同前缀测试)、`src/components/remote-desktop-panel.test.ts`、`src/components/PlaceChip.test.ts`、`src/components/PlaceChip.dom.test.ts`、`src/locales/screen-words.test.ts`(按实际改动挑),覆盖多屏和单屏两种情况。

### 3. 侧栏两处英文没翻译
- 「Problems to look at」:服务端写死的对话标题 `server/incidents.ts` 的 `INCIDENTS_THREAD_TITLE`(旧名 `Team incidents`)。侧栏标题走 `src/lib/task-title.ts` 的 `localizedTaskTitle`,只认 `SHARED_CHAT_TITLE` 和 `New thread`。
改法:把这两个常量挪到 `shared/wire.ts`(和 `SHARED_CHAT_TITLE` 放一起),服务端改为引入;`localizedTaskTitle` 遇到这两个标题返回 `t("task.incidents")`。新键 en `"task.incidents": "Problems to look at"`,zh `"task.incidents": "待处理的问题"`。
- 「no activity for 20 minutes — …」:这一行带 nameCode `chat.notice.stalled`,en 有键,zh.json 缺。补 zh `"chat.notice.stalled": "已有 {minutes} 分钟没有活动,回合已停止"`(另一分支 T-1238 也会加完全相同的这一行,合并时以相同内容去重即可,不要改成别的译文)。
- 只动 en.json 和 zh.json,其余语言文件不碰(项目正在精简为只留 zh/en)。
测试:`src/components/SidebarThreadRow.shared-chat.test.ts`(加 incidents 标题用例,zh 下显示中文)、`src/lib/failed-turn.test.ts`、`server/incidents.test.ts`,以及 `src/locales/words.test.ts`、`src/locales/server-lines.test.ts`。

### 4. 打开设置页时控制台有一条 403
根因:设置「概览」页渲染 `ServerUpdateRow`(`src/components/settings/pages/PlacePages.tsx` 约 82 行),挂载时先请求 `GET /api/updates/check`,install 不是 desktop/managed 就接着请求 `GET /api/updates/server`(`src/components/ServerUpdateRow.tsx`)。服务端 `server/routes/update-check.ts` 的 `mayUpdateServer` 要求 `auth.kind === "session"` 且有 admin——这是有意的安全设计(回环地址可能是机器人的 shell),**服务端不要改**。本机浏览器走 loopback 认证,因此返回 403 `admin_only`。前端 `src/lib/admin-scope.ts` 的 `unlessRefused`/`lacksAdminScope` 只认含 "lacks the admin scope" 的 403,不认 `admin_only`,每次打开设置都会再请求。
改法:
- (a) `useServerUpdate`(或 ServerUpdateRow 内)先读当前会话(`src/lib/session.ts`),只有 `kind === "session"` 且 scopes 含 admin 时才请求 `/api/updates/server`。
- (b) `lacksAdminScope` 同时识别 body `code === "admin_only"`,作为兜底记住拒绝结果。
测试:`src/lib/admin-scope.test.ts`、`src/components/SidebarProfileMenu.server-update.test.ts`、`src/lib/server-update.test.ts`(按实际改动挑),覆盖 loopback 不请求、session+admin 请求、收到 admin_only 后不再请求。

## 验收
1. 上面每条相关的测试文件逐个跑过并贴结果摘要;新增用例覆盖各条的修复点。
2. `pnpm exec tsc -b` 和 `pnpm exec tsc -p tsconfig.server.json` 通过。
3. 对改动文件跑 `pnpm exec oxlint --deny-warnings <改动文件>` 零告警。
4. `node scripts/public-scan/scan.mjs` 对本轮全部改动(含未跟踪文件)零命中。
5. report.md 只列实际改过的文件,和 git status 一致。
20 changes: 20 additions & 0 deletions docs/tasks/T-1200/T-1248-multiscreen-ui-fixes/r2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
## 运行环境(InstaBox 云沙箱,必读)
- 开工先在 worktree 根目录运行 `crybot-link-deps`(镜像自带,把预装依赖链进 node_modules),之后 `pnpm exec vitest` / `pnpm exec tsc` 才可用。
- 这里**没有** systemd、Docker,说明里出现的 `systemd-run --scope ... --` 前缀一律去掉直接运行;机器 8G/4 核,一次只跑一个测试文件。
- 若本轮沙箱已放开(能联网、能监听端口),交回前必须把改动相关的测试全部跑过,包括需要端口的 e2e;涉及的 e2e 连跑 3 次都要过。跑不了的写明原因。
- 报告只写三样:改了什么(文件列表与 git status 一致)、为什么、测试命令与结果摘要。不要写长篇分析;完整输出放 verification 文本文件即可。
- 不提交 git。

# T-1248 第 2 轮:只修复审必改项

原任务见本文件夹 brief.md,工作区里上一轮改动保留。第 1 轮审核:需要返工。本轮只做下面几条,别的不动。

## 必改
1. src/components/remote-desktop-panel.tsx 约 :84:取屏号的 effect 只依赖 bot 的 id / localVm / bot 的 busy 字段。排队期间打开面板、随后分到屏时 `busy` 一直是 true,副标题会一直停在「私有桌面」,直到重开面板。改为能跟上屏幕分配变化(订阅现有的状态推送,或面板打开且尚无屏号时按现有状态接口低频轮询,例如 3~5 秒一次、拿到屏号或关面板即停)。补回归测试:busy 始终为 true,屏号从「未分配」变为第 2 块屏后,副标题变成「第 2 块屏」。
2. 公开扫描必须零命中:brief.md 第 17 行附近「私有桌面」那句里括号中的 i18n 键名(vm 下 main 的 title 键)被 scanDiff 误判成域名。把那句括号改成不带点分键名的说法(例如「(相关文案 80 多处)」),然后对**全部改动加全部未跟踪文件**(含 brief.md、r2.md、report.md、verification.txt、新测试文件)重新跑 scanDiff,确认零命中。

## 顺手改
3. report.md 文件清单补上未跟踪的 brief.md、r2.md,与 `git status` 一致;verification.txt 里「3 个未跟踪文件、零命中」的旧结果按本轮实际重写。

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

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

# T-1248 第 3 轮:只修 1 个必改项

原任务见本文件夹 brief.md,工作区里前两轮改动保留。第 2 轮审核:需要返工,只有下面这条拦合并,别的不动。

## 必改
1. src/components/remote-desktop-panel.tsx 约 :84–100:第 2 轮加的取屏号轮询有两个问题:
- 重试请求没带 `background: true`,页面隐藏时也照样每 4 秒打一次。按 src/state/api.ts:20–35 和 server/cloud-power.ts 约 :87 的约定,非后台请求会被当成用户活动,阻止云端空闲休眠,甚至把已休眠的实例唤醒。
- 只要响应里没有屏号就继续轮询。单屏模式(未开多屏)下 `GET /api/bots/:id/local-computer` 正常返回 200 且不含屏号,会无限轮询。
改法:
- 面板打开(以及 bot.id / localVm / busy 变化)时的第一次请求保持现状;之后的自动重试一律带 `background: true`(页面隐藏时 api() 会自己等页面再显示,不用另写可见性判断)。
- 只有服务端返回 409 且 `error === "screen_not_assigned"`(见 server/routes/computers.ts:384)时才继续 4 秒重试;返回 200(不论有没有屏号)就停;其他错误按现有行为处理,但不要无限重试(例如最多重试几次或直接停)。
- 回归测试:①排队夹具改成真实协议:先返回 409 screen_not_assigned,再返回第 2 块屏,busy 始终为 true,副标题变成「第 2 块屏」,且重试请求带 background;②单屏模式返回 200 无屏号时只请求一次、不再轮询。

## 不用改
report.md / verification.txt 的文件清单措辞不拦合并,本轮不用改;report.md 只追加「第 3 轮」一小节:改了哪些文件、为什么、测试结果。

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

# T-1248 第 4 轮:只修 GitHub Actions 的 2 个机械失败

原任务见本文件夹 brief.md,前三轮改动已提交(050daae3),并已合入最新 main(769d9015)。第 3 轮审核和安全审查都已通过,功能不要再动。PR #62 的 Actions 有两处失败,只修这两处:

## 必改
1. **iOS 字符串检查失败**(iOS Linux 工作流 `node mobile/ios/scripts/gen-strings.mjs --check`):`mobile/ios/CryBot/Strings/ServerText.xcstrings` 过期。运行 `node mobile/ios/scripts/gen-strings.mjs` 重新生成,只提交生成结果,不要手改。生成后 `--check` 必须零输出通过。
2. **文件大小棘轮失败**(`scripts/testing/file-size-ratchet.test.ts`:`shared/wire.ts is 1002 lines: a new file over 1000 lines needs a line here...`):本任务在 `shared/wire.ts` 新加了 `INCIDENTS_THREAD_TITLE` / `OLD_INCIDENTS_THREAD_TITLE` 两行,使文件从 1000 行变 1002 行。不要把 wire.ts 加进棘轮清单,改为让它回到 ≤1000 行:把这两个常量挪到更合适的小文件(例如它们实际使用处附近的 shared 模块或新建小文件),并更新所有引用;或者其他不增加 wire.ts 行数的等价办法。不要靠删注释、挤行凑数。

## 验收
- `node mobile/ios/scripts/gen-strings.mjs --check` 通过;
- `pnpm exec vitest run scripts/testing/file-size-ratchet.test.ts` 通过;
- `pnpm exec tsc -b`(或仓库现有类型检查命令)通过;
- 引用挪动常量的相关测试文件跑过并通过。

## 报告
report.md 只追加「第 4 轮」一小节:改了哪些文件、为什么、测试结果。
Loading
Loading