测试 T3 的 Web 与桌面端
使用 T3 内置的浏览器面板进行验证。在认定它不可用之前,先按下面的恢复步骤 操作。不要安装或改用另一套 自动化系统。原生移动端测试请使用 test-t3-mobile。
启动应用
复用本任务中健康的开发服务器。否则从 仓库根目录运行 vp run dev,并保留它的终端会话。使用该工作树(worktree)中被忽略的 .t3 状态,并从开发运行器的输出里读取实际端口和配对 URL。 绝不要对着 ~/.t3/userdata 运行,也不要设置 VITE_HTTP_URL 或 VITE_WS_URL。
使用有实际内容的项目(project)和对话线程(thread)数据进行测试。只有在 检查或灌入 SQLite 时才阅读 references/sqlite-fixtures.md。直接写入夹具之前,先停止测试服务器。
免费驱动智能体回合(turn)
不要为了看一个回合如何渲染而去花费付费模型。vp run dev 会注册 Replay (dev) 提供方(provider),它经由真实的适配器(adapter)和编排,以模拟流式输出 重放已记录的回合。它的模型就是各个场景: showcase 覆盖思考、一份计划、工具调用、一次批准以及 Markdown。 按 Ctrl+Alt+Shift+R 打开选择器(GNOME 会把该键用于屏幕 录制),调用 window.t3dev.replay("showcase") 并传入 preview_evaluate,或者运行 node apps/server/src/bin.ts thread start --base-dir .t3 --provider devReplay --model showcase <project> "go"。 当测试需要真实的提供方行为时,使用该提供方最便宜的 模型,例如 Claude 用 Haiku,Codex 用 Luna。
使用浏览器面板
调用 preview_status。如果没有可自动化的标签页,就调用 preview_open,包括 状态报告为 available: false 或 tabId: null 的情况。状态可能只是因为还没有标签页就报告 不可用;打开标签页不需要用户操作。 只有在这些工具不存在,或 preview_open 报告不可用或调用失败时,才停止验证并说明阻塞原因。
用 preview_navigate 打开一次完整的启动配对 URL,然后使用 preview_snapshot 和 T3 的交互工具。 如果令牌已被用掉或过期,运行 node apps/server/src/bin.ts pair 以获取一个新的。继续使用同一个标签页。
验证并保留
走通受影响的流程,并捕获能证明它可用的状态。在用户检查或继续迭代期间,保持 服务器、状态和面板可用。 助手回合(turn)结束并不等于拆除。只停止你自己启动的进程, 通过保留的终端会话或已记录的 PID 来停止。
当对方要求分享时,从 vp run dev --share 开始,并交给用户 一条你还没有用过的、全新的完整配对 URL。截图、提交和回复中不要包含其他凭据。