故障排查

点击应用图标后没有窗口

再次点击 Dock 图标应显示已有的主窗口或启动恢复窗口，包括此前隐藏或最小化的窗口。 主页面加载完成即可显示；渲染器的健康确认用于升级事务，不再作为显示窗口的前提。 日志清理、托盘、附属窗口恢复、命令行工具安装和本地模型同步失败不应阻止打开桌面。

在 macOS 上，没有进行中的升级或回滚事务时，普通启动以实际打开的安装包为准。 手动替换应用后，旧版本选择、恢复桥或暂存目录不能把启动重新导向旧应用。 历史升级记录损坏时会记录警告，继续启动当前安装包；不要为解决启动问题删除任务目录。

如果仍无法打开，检查桌面日志目录中的 wework-main.log、runtime-launch.log 和 dsh-core-runtime.log，区分真实运行时故障与后台维护警告。数据迁移失败、缺少运行文件 或存储权限错误仍需要处理，不能通过清空用户数据来掩盖。启动动画、截图和窗口尺寸 异常只影响展示效果，不应阻止已加载的主窗口显示。

会话导出停留在打包中

查看桌面日志目录中的 dsh-core-runtime.log，按 [wework-conversation-export] 和导出任务 ID 查找最终写入阶段。日志分别记录文档同步、附件同步、打包和替换目标文件的开始、完成或失败事件，以及阶段耗时和附件数量，不记录文件路径或内容。若某个阶段只有开始事件，可据此继续定位对应的文件操作；不要仅因界面仍显示打包就判断导出已经失败。

页面出现错误或白屏

前端组件发生渲染异常时，Wework 会显示“Wework 页面出现错误”。点击 刷新页面 重新加载界面；尚未保存的内容可能会丢失。启动初始化失败时，也可以在错误页刷新重试。

如果刷新后仍出现错误，请打开调试面板查看日志，并附上复现步骤反馈问题。 如果渲染进程或整个应用退出后未能恢复，请重新打开 Wework。

模型不可用

• 在 设置 → 模型 检查 Codex 登录状态或本地模型地址。
• 确认选择的模型可以在当前设备运行。
• 使用代理时，保存设置后按提示重启 Codex。
• 本机官方 ChatGPT 模型因网络不可达而持续重连满 10 秒时，对话会显示当前模型和网络状态。 短暂中断在 10 秒内恢复时不显示提示。点击 设置代理 可直接打开 设置 → 代理， 保存本机代理后按提示重启 Codex。

模型容量已满

Selected model is at capacity. Please try a different model. 表示当前模型服务 过载，不代表任务代码执行失败。Codex 直连任务遇到结构化过载错误时，会保留 原会话和原模型，依次等待 5、10、20、40、60 秒自动恢复，最多 5 次；期间 可以停止任务。恢复不会重发原任务，也不会新增用户消息。

如果过载中断了正在进行的目标，自动恢复会继续原目标，保留目标内容、预算和 累计用量，并在当前轮结束后继续推进。等待恢复时暂停、删除或修改目标，会取消 这次目标恢复；不会重新创建目标或覆盖你的修改。 新建目标在首轮立即遇到过载时，也会显示阻塞状态，恢复后再更新为运行中。

若自动恢复后仍显示失败，可稍后点击 重试，或点击 切换模型并重试。 认证失败、额度不足和上下文超限不会按过载策略自动恢复。

后台终端历史

恢复会话后，后台终端保留已收集的输出，可使用 Shift + PageUp 和 Shift + PageDown 翻页。终端的屏幕阅读器行号和字符对齐信息随输出更新，持续输出和历史翻页不应阻塞其他界面操作。

无法连接模型服务

当本地模型代理未能向模型服务发出请求时，对话会显示 无法连接模型服务，并在错误卡片中直接列出连接失败的完整目标地址。发送请求失败 表示客户端没有收到可用的 HTTP 响应，通常应检查当前网络、VPN、代理或 DNS；如果地址属于公司内网，还应确认设备已连接内网或 VPN。

展开 错误详情 可以查看服务返回的原始错误。只有包含连接失败信息的 502 错误会显示为模型服务连接错误；服务已经返回但响应超时的普通 502 仍显示为请求超时。

项目无法打开

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

Git 克隆失败

提示	检查内容
Authentication failed	Git 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 凭据；日志也不会记录反馈正文、任务上下文和附件内容。