Developer guide

📄️ 在隔离 Wework 实例中开发 Core DSH 插件

Wework 内置的“Wework 插件开发”是一个 Wework 插件。它可以携带一个符合 Codex

📄️ Wework 聊天状态信源

本文记录 Wework 聊天链路的状态信源和维护规则。目标是让 UI 只读取明确的单一派生状态，避免发送按钮、消息流、队列和 runtime 任务状态互相覆盖。

📄️ Wework 后台终端

Codex 命令可以在 AI 轮次结束后继续运行。会话的环境摘要在“后台进程”中显示这些命令及数量；点击命令会打开右侧只读终端标签，持续显示该命令的输出。暂无输出时显示占位文字。进程退出后从运行列表移除，已打开的日志标签仍可查看和关闭。

📄️ 项目执行状态真实性重构

实现状态：状态真实性主链与并发扩展已完成；Backend、Wework、Executor 全量回归、MySQL 迁移升降级及真实 Electron 桌面验收均已通过。

📄️ Wework 插件市场 V2 技术设计

面向插件开发、开源迁移和本地联调，请先阅读插件市场开发指南。本文定义 Wework 插件分享、企业全员发布、GitLab 审核和市场 Release 的实现与验收合同。

📄️ 云端 Git Worktree 目标模式与并行开发计划

1. 文档状态

📄️ Feature：Wework 插件分享与企业全员发布交互设计

0. 文档状态与设计依据

📄️ Wework 插件市场开发指南

面向需要开发、迁移或发布 Wework 插件的同学。架构细节见插件市场 V2；本机 Codex 运行时细节见 Codex 插件运行时；亮色/暗色图标见插件图标指南。

📄️ 本地数据目录

Wework 的本地运行时数据统一存放在用户主目录下的 ~/.wework，不再使用

📄️ Wework 插件图标指南（wework-plugins）

面向 wework-plugins（及企业内部插件仓）维护者：如何在插件包里提供 logo / logoDark，保证亮色与暗色 UI 都可读。

📄️ Codex 左侧栏状态一致性

Wework 桌面端复用 Codex App 的侧栏状态语义。项目和实时任务内容由 Codex app-server 提供，侧栏元数据由设备对应 CODEX_HOME 下的 .codex-global-state.json 提供。远程设备在线时，Wework 还会在本机保存任务列表摘要，用于设备离线后的启动恢复。

📄️ Wework Windows 开发与构建

Wework Windows 桌面版使用 Electron，并与 macOS、Linux 共用同一套 renderer、

📄️ 插件安装的定向同步与缓存复用

普通安装、重装、更新、启停和组件设置变更只同步受影响的插件；卸载按插件发送删除意图。手动刷新和设备重新连接仍使用完整清单对账。账户安装记录是期望状态，设备回执是本地物化状态，两者分别保存。

📄️ Wework 设备诊断接口

Wework 为核心 DSH 和独立 Smart App 提供只读能力 deviceDiagnostics.microphone。

📄️ 本地优先云端连接

Wework 默认就是一个完整的本地应用。本机 Codex、本地模型配置、本地 executor、本地工作区和本地会话不依赖 Backend 登录或云端设备。云端连接是一个可选能力层：用户在侧栏输入 Backend 地址并完成 WeWork 登录后，服务端模型、云设备和云端 Codex 认证同步会加入同一个工作台。

📄️ Codex 插件运行时

Wework 的插件能力兼容 Codex plugin、skill 和 app 机制。插件页负责发现、安装、创建和管理插件；对话运行时负责把用户选中的 skill/app 以结构化 mention 传给 Codex app-server，而不是把展示用文本当成普通 prompt。

📄️ 性能诊断

Wework 内置一个默认关闭的前端性能诊断开关，用于定位 release 包中“运行一段时间后变卡”的问题。诊断代码只在显式开启后运行；关闭时不会安装 React Profiler，也不会采集定时样本。

Core DSH 和新建智能应用默认使用 0.2.0-rc.2；已有应用可继续按 manifest 选择 0.1.0-rc.8。新版客户端 slot 服务由 @deepseek-ai/dsh-client-ui-renderer 提供，不再依赖 dsh-client-runtime。新版 DSH 的原生模块加载器要求匹配的 Electron 运行时指纹，Wework 固定使用其支持的 Electron 44.7.0。

📄️ E2E 自动化

桌面 E2E 共享 fixture 使用 GPT 5.6 Luna。真实运行时目录同时存在 GPT-5.6 Luna 和 GPT 5.6 Luna 两种显示名称，默认模型选择断言接受这两种名称，同时继续核对模型 ID 和供应商。任务恢复断言继续核对 fixture 原有的显示名称。

📄️ 工作区文件预览

Wework 文件面板使用 Markdown 渲染器预览 Markdown 文档，将其他代码和文本文件交给 Pierre CodeView，并将二进制文件交给 Flyfish Viewer 的浏览器端渲染器。预览数据只从已授权的本地工作区读取，不会上传到第三方服务。

📄️ MCP 应用

Wework 可以在 Codex 任务的工具结果旁运行 MCP 应用。应用由 MCP 服务提供 HTML，通过标准 MCP Apps 协议与宿主交互。

📄️ 调试实例标识

Wework 支持从一个正在运行的 Wework 内置 Terminal 中启动另一个调试版 Wework。为了在多个 worktree、多个 dev app 同时打开时分清窗口来源，Wework 会把父窗口上下文传给 Terminal，再由 wework/scripts/dev-mac-app.sh 传给新启动的调试实例。