跳到主要内容

故障排查

模型不可用​

  • 在 设置 → 模型 检查 Codex 登录状态或本地模型地址。
  • 确认选择的模型可以在当前设备运行。
  • 使用代理时，保存设置后按提示重启 Codex。

项目无法打开​

  • 确认目录仍然存在且当前用户有读写权限。
  • 远程项目应确认设备在线，并重新选择该设备上的目录。
  • Git 项目目标目录已存在时，使用现有目录方式添加，或选择新的目标目录。

Git 克隆失败​

提示检查内容
Authentication failedGit Token 是否有效、是否有仓库权限
Repository not found仓库地址和当前账号权限
Remote branch not found默认分支是否存在
Could not resolve host / timeout执行设备的网络和代理

任务或终端无法运行​

  • 查看当前设备状态；离线设备恢复连接后再试。
  • 设备提示升级时，先完成升级。
  • 切换任务后，确认终端对应的是当前项目或 Worktree。
  • 重新打开应用后仍失败，可完全退出 Wework 再启动。

新任务未出现在侧边栏​

开发调试时，可在 Wework Web Inspector 的控制台执行以下命令后复现：

localStorage.setItem("wework:debug-runtime", "1");

前端日志中的 [Wework] Runtime sidebar state 会依次记录 executor 列表结果、状态合并结果，以及侧边栏排序和截断后的任务 ID。当前选中的任务存在于项目任务列表但未进入可见区域时，还会记录 [Wework] Runtime sidebar selected task is hidden。诊断完成后执行 localStorage.removeItem('wework:debug-runtime') 关闭详细日志。

无法审核或撤销变更​

审核和撤销需要原执行设备在线，并保留该轮任务的变更记录。后续修改与原变更冲突时，先手动处理当前工作区，再决定是否回退。

内置浏览器异常​

  • 确认地址包含 http:// 或 https://。
  • 本地服务应确认进程和端口正在监听。
  • 登录状态异常时，可以在 设置 → 浏览器 清理数据后重新登录。

云端连接失效​

点击侧边栏的云端状态重新授权。确认 Backend 地址来自团队管理员，并且浏览器能够访问登录页面。

如果网络正常但云端状态偶尔显示不可用，先查看 Wework 前端日志中的以下记录：

  • [Wework] HTTP ... is still pending after 5000ms.：请求超过 5 秒仍未收到响应，说明问题发生在等待响应阶段。
  • [Wework] HTTP ... completed slowly ...：请求最终返回，记录总耗时、HTTP 状态码和传输方式。
  • [Wework] HTTP ... failed.：请求没有收到 HTTP 响应，查看 phase: "transport" 下的错误。
  • [Wework] HTTP ... returned ...：服务端已返回 HTTP 错误，查看 phase: "http_error" 下的状态码和错误信息。

每条请求都有 requestId。在桌面客户端中，该值会通过 X-Request-ID 传给 Backend；只有慢响应或 HTTP 错误诊断事件包含后端返回的请求 ID 时，日志才会记录 backendRequestId。用这两个 ID 可以把客户端日志与 Backend 日志关联起来。日志不会记录 Authorization、token 或请求正文。

获取帮助​

在发生问题的任务右上角（或新对话状态的工具栏）点击 反馈问题。先填写问题描述（必填），可以在输入框中直接粘贴截图或文件，也可以点击 添加附件 通过文件选择器上传。确认问题描述后点击 预览问题，检查将要提交或导出的内容。

补充信息的默认行为如下：

  • 诊断信息（默认勾选）：Wework 和本地执行服务的运行日志、Wework 版本和系统信息。不含对话内容，隐私风险低；如果不需要，可以手动取消。
  • 任务上下文（默认不勾选）：完整对话记录原文和当前窗口截图。可能包含业务讨论、代码或屏幕上显示的任何内容，确认后再提供。
  • 用户附件：仅包含你主动粘贴或选择的文件，可能包含隐私内容。

如果勾选的某项内容不存在（例如新对话没有任务数据），导出时会自动跳过该项，并在预览中提示。

预览时可以展开任意条目查看内容。配置了反馈服务时，点击 提交反馈 提交问题；未配置反馈服务时，点击 确认导出，Wework 会把诊断包保存到系统下载目录。诊断包只在本机生成，不会自动上传。日志中的常见凭证和用户目录会被脱敏，但自由文本（如对话记录）无法完全脱敏，发送前应确认包内没有不希望共享的信息。

反馈提交失败​

提交反馈时，原生日志会按问题编号记录以下事件：

  • Feedback submission started：提交已开始，包含问题编号、脱敏后的目标端点和诊断包大小。
  • Feedback submission failed：提交失败，包含失败阶段、耗时、错误类别；收到服务端响应时还会包含 HTTP 状态码。
  • Feedback submission completed：提交成功，包含反馈单编号、反馈项 ID、是否为重复提交和耗时。

使用界面显示的问题编号搜索这些日志，例如 report_id=WF-...。日志中的端点只保留协议、域名、端口和路径，不包含查询参数或 URL 凭据；日志也不会记录反馈正文、任务上下文和附件内容。