docs: complete Chinese proofreading and generated reference pairing

This commit is contained in:
xjt
2026-08-09 11:02:16 +08:00
parent 0543a6f79d
commit 7ff0cbcb7e
565 changed files with 10606 additions and 2171 deletions

View File

@@ -18,20 +18,20 @@ Web agent 修改了 GUI 源码,却不知道由哪个 URL 和进程承载当前
## 影响
用户不得不连续指出三个错误agent 把验收交还给用户;建议预览的页面一片空白;报告成功的 URL 并不是用户正在使用的页面。一个不受管理的替代服务器还持续运行到下一,直到用户提出质疑。
用户不得不连续指出三个错误agent 把验收交还给用户;建议预览的页面一片空白;报告成功的 URL 并不是用户正在使用的页面。一个不受管理的替代服务器还持续运行到下一个轮次,直到用户提出质疑。
本次调查没有重启或修改只读的 3081 和 3082 试验服务。
## 时间线
- 在第 2 agent 修改主题后,在序列 30939 的消息中让用户运行 `pnpm run demo:tui` 或打开一个未明确指定的 Web 应用。它没有对组装后的 Web 应用执行任何验收。
- 在第 3 agent 读取 `apps/web/package.json`,在序列 31865 于端口 5173 上启动裸 Vite观察到 HTTP 200 后便宣布成功。浏览器却抛出 `client-modules: window.__DSH_BOOT__ is missing or not an object`,并显示白屏。
- 在第 4 agent 找到了完整的 `dsh web` 启动路径,重新构建 shell在序列 34309 于端口 3334 上启动一个不受管理的进程,并且只在序列 34441 检查了这个替代服务是否返回 200 和启动 manifest。它从未探测端口 3081。
- 在第 5 中,用户在序列 34556 报告 3081 已经显示新主题。直到序列 34681agent 才检查既有进程并移除冗余服务器。
- 在第 2 个轮次agent 修改主题后,在序列 30939 的消息中让用户运行 `pnpm run demo:tui` 或打开一个未明确指定的 Web 应用。它没有对组装后的 Web 应用执行任何验收。
- 在第 3 个轮次agent 读取 `apps/web/package.json`,在序列 31865 于端口 5173 上启动裸 Vite观察到 HTTP 200 后便宣布成功。浏览器却抛出 `client-modules: window.__DSH_BOOT__ is missing or not an object`,并显示白屏。
- 在第 4 个轮次agent 找到了完整的 `dsh web` 启动路径,重新构建 shell在序列 34309 于端口 3334 上启动一个不受管理的进程,并且只在序列 34441 检查了这个替代服务是否返回 200 和启动 manifest。它从未探测端口 3081。
- 在第 5 个轮次中,用户在序列 34556 报告 3081 已经显示新主题。直到序列 34681agent 才检查既有进程并移除冗余服务器。
## 根因
Web 组合没有向模型提供当前 GUI、规范 URL 或运行模式的身份信息。会话 cwd 正确表示了用户选择的 Workspace但模型误把这个项目边界当成了应用边界。系统也没有持久约将 GUI 源码检出目录、构建产物、服务进程、目标 origin 和浏览器验收关联起来。
Web 组合没有向模型提供当前 GUI、规范 URL 或运行模式的身份信息。会话 cwd 正确表示了用户选择的 Workspace但模型误把这个项目边界当成了应用边界。系统也没有持久约将 GUI 源码检出目录、构建产物、服务进程、目标 origin 和浏览器验收关联起来。
裸 Vite 返回 HTTP 200使错误的启动路径看似合理。`window.__DSH_BOOT__` 只由完整宿主注入,因此传输层就绪不代表应用已就绪。首个回归测试以另一种方式重复了同样的错误:超时机制终止 Vite 后,非零退出断言仍会通过。真实复现暴露了这一误报。