📄️ Wework 聊天状态信源
本文记录 Wework 聊天链路的状态信源和维护规则。目标是让 UI 只读取明确的单一派生状态，避免发送按钮、消息流、队列和 runtime 任务状态互相覆盖。
📄️ Wework 插件市场 V2 技术设计
面向插件开发、开源迁移和本地联调，请先阅读 插件市场开发指南。本文侧重控制面架构、数据模型和运维约束。
📄️ Wework 插件市场开发指南
面向需要开发、迁移或发布 Wework 插件的同学。架构细节见 插件市场 V2；本机 Codex 运行时细节见 Codex 插件运行时。
📄️ 本地数据目录
Wework 的本地运行时数据统一存放在用户主目录下的 ~/.wework，不再使用
📄️ Codex 左侧栏状态一致性
Wework 桌面端复用 Codex App 的侧栏状态语义。项目和实时任务内容由 Codex app-server 提供，侧栏元数据由设备对应 CODEX_HOME 下的 .codex-global-state.json 提供。远程设备在线时，Wework 还会在本机保存任务列表摘要，用于设备离线后的启动恢复。
📄️ Wework macOS 发布
English | 简体中文
📄️ 本地优先云端连接
Wework 默认就是一个完整的本地应用。本机 Codex、本地模型配置、本地 executor、本地工作区和本地会话不依赖 Backend 登录或云端设备。云端连接是一个可选能力层：用户在侧栏输入 Backend 地址并完成 WeWork 登录后，服务端模型、云设备和云端 Codex 认证同步会加入同一个工作台。
📄️ Codex 插件运行时
Wework 的插件能力兼容 Codex plugin、skill 和 app 机制。插件页负责发现、安装、创建和管理插件；对话运行时负责把用户选中的 skill/app 以结构化 mention 传给 Codex app-server，而不是把展示用文本当成普通 prompt。
📄️ 性能诊断
Wework 内置一个默认关闭的前端性能诊断开关，用于定位 release 包中“运行一段时间后变卡”的问题。诊断代码只在显式开启后运行；关闭时不会安装 React Profiler，也不会采集定时样本。
📄️ E2E 自动化
Wework 提供独立的 Playwright E2E 入口和测试专用前端自动化接口，用于在 CI 中稳定操作 Wework 的 Vite/React 前端。默认入口运行在浏览器模式，适合覆盖大多数前端交互；原生窗口与任务执行链路由下文的桌面端全链路 E2E 覆盖。
📄️ 工作区文件预览
Wework 文件面板使用 Markdown 渲染器预览 Markdown 文档，将其他代码和文本文件交给 Pierre CodeView，并将二进制文件交给 Flyfish Viewer 的浏览器端渲染器。预览数据只从已授权的本地工作区读取，不会上传到第三方服务。
📄️ 调试实例标识
Wework 支持从一个正在运行的 Wework 内置 Terminal 中启动另一个调试版 Wework。为了在多个 worktree、多个 dev app 同时打开时分清窗口来源，Wework 会把父窗口上下文传给 Terminal，再由 wework/scripts/dev-mac-app.sh 传给新启动的调试实例。
📄️ 插件交互式表单
Wework 支持插件在对话运行中向用户发起交互式表单，让用户在聊天界面中选择或输入答案并提交。插件开发者应通过 MCP elicitation 发起表单请求；requestuserinput 是 Wework 和 executor 内部使用的渲染协议，不应由插件直接构造。
📄️ 内置浏览器
Wework 的内置浏览器用于在桌面工作台右侧面板中展示可交互网页，并让本地运行时通过 WKWebView bridge 控制同一个页面。它不是截图预览，也不会新开外部 Chrome 窗口。
📄️ AI 自验证会话
Wework 支持启动隔离的开发验证会话，让 AI 在真实 Tauri 应用中完成 UI 操作和断言。该机制复用桌面端 E2E 的 WebView 控制通道，不会操作外部 Chrome，也不会连接开发者日常使用的 Wework 窗口。
📄️ 浏览器批注可靠性
背景
📄️ Wework 云端模型代理网关
Wework 桌面端与 Wegent 后端可能运行在不同机器上。当桌面端使用配置了真实云端 provider 凭证的 Model CRD 时，必须避免把 provider api_key 明文下发到本地，同时保证 Codex 能够正常调用云端模型。
📄️ Wework Windows 桌面端构建指南
本文档介绍如何在 Windows 上构建和运行 Wework 桌面端（wework），以及如何从 macOS 交叉编译 Windows 安装包。