[Bug] dev:web 默认 --poll 在本地磁盘上空转 ~13 个核，同一个包重建从 354ms 退化到 44s

[150149]

摘要

package.json 的 dev:web 脚本固定写成 tsx scripts/dev-web.ts --poll，而 scripts/dev-web.ts:26-29 明确说明该开关只为无 inotify 事件的网络挂载（weka）准备。.agents/notes/implemented/architecture/2026-07-23-client-plugin-loading-model.md:83 也把这套轮询记录为刻意的设计。

但在普通本地磁盘上它带来三个后果：

1. 空闲时 tsdown 监听进程常驻占用约 13 个 CPU 核，整机卡顿（浏览器输入延迟明显）；
2. 同一个包重建从 354ms 退化到 44s，部分包最慢到 73s，热更新基本不可用；
3. 因为 --poll 写在 npm 脚本里，开发者无法从命令行关闭，只能绕过脚本直接调用 tsx scripts/dev-web.ts。

复现

pnpm run dev:web --no-open
# 等到 dsh web: http://127.0.0.1:3080/?token=...
# 静置 60s，采样 node 进程 CPU 时间

然后改动任一 packages/client/*/src/*.ts，观察 tsdown 打印的 Rebuilt in ...。

对照组（去掉 --poll）：

pnpm exec tsx scripts/dev-web.ts --skip-build --no-open

实测结果

同一台机器、同一份已构建产物，服务就绪后静置 60 秒的 CPU 累计（占单个核的百分比）：

进程	--poll（pnpm run dev:web）	原生监听
tsdown 监听	1331%	0%
tsc -b tsconfig.client.json --watch	18.8%	0%
vite build --watch	0.1%	0%
dsh web	1.1%	0.5%
合计	≈1350%（约 13 核）	1.7%

各列按进程拆分；合计数另含 pnpm/tsx 包装进程（原生监听下 0.69s ≈ 1.2%），故原生列各行之和 0.5% 小于合计 1.7%。

单包重建延迟：

• 同一个包（改 @deepseek-ai/dsh-client-ui-chat 的源文件）：--poll 下 Rebuilt in 44492ms，原生监听下 Rebuilt in 354ms
• 同一次 --poll 采样里其它包：api-session-controller 37546ms、ui-schedule 37640ms、ui-conversation 43349ms、ui-sidebar-documentpreview 73221ms（跨包约 35~73s）

两种配置下 dsh web 的 HTTP 响应都是 ~9ms，服务端不是瓶颈；差异全部来自文件监听方式。

建议

本地磁盘是绝大多数贡献者的场景，网络挂载是少数。所以：

1. dev:web 默认用原生监听，轮询改为显式选项（保留 --poll，另加 dev:web:poll 脚本）；或
2. 至少让 --poll 可关闭（--no-poll），否则必须绕过 npm 脚本才能拿到可用的重建速度。

两种方案都能让本地开发静置 CPU 接近 0、单包重建保持亚秒级，同时不改变 weka 用户的行为。

环境

• deepseek-harness 0.2.2-alpha.2，commit ce7073d512
• package.json:216 → "dev:web": "tsx scripts/dev-web.ts --poll"；DEFAULT_POLL_INTERVAL = 500（scripts/dev-web.ts:94）
• Windows 11，本地 NTFS（D:\...，非网络挂载），24 逻辑核
• Node v24.22.2，pnpm 11.28.5，产物由 pnpm run build:artifacts 生成
• 多次运行结果一致

相关

• dev:web watch loop: ~7G memory baseline, unbounded growth to 12.5G over 22h, and V8-OOM crash loop under memory pressure (no start limit, no memory cap) #10285 同一条 dev:web watch 循环的内存/OOM 问题，其中也提到 --poll 空闲约占 35% 单核；那篇聚焦内存有界，本篇聚焦轮询默认值与重建延迟，不重复。
• pnpm dev:web bug #11623 pnpm dev:web 在 Node 24.9.0 上崩溃（ERR_INVALID_RETURN_PROPERTY_VALUE）；我这边在 24.22.2 上不复现，与本篇的 CPU 问题相互独立。