设置与数据
常用设置
- 通用：界面语言、启动时是否显示窗口、关闭窗口后是否后台运行，以及从 Codex 或 Claude Code 导入内容。
- 外观：主题和工作台背景。背景图片及显示参数保存在当前设备。
- 模型：本机 Codex 登录、本地兼容模型，以及由 Wegent 云端配置并同步到 Wework 的模型。
- 代理：分别配置本机和云端设备的模型访问代理。
- 上下文：管理任务上下文偏好、Codex 个性，以及开启实验性功能后可用的默认分身监督原则。
- 快捷短语：保存经常使用的任务说明。
- 键盘快捷键：查看、修改或清除本机快捷键。
- 工作树：设置 Worktree 根目录、自动清理和保留数量。
- 已归档会话：搜索、恢复或删除历史会话。
查看应用信息
点击 Wework 左下角的账户菜单，选择 关于，即可查看当前应用名称、版本号、更新渠道和项目链接。 关于页面的版本号从运行中的 Tauri 应用包元数据读取，因此会与 macOS 系统菜单 关于 Wework 显示相同的版本。发布构建通过 Tauri 配置注入版本时，两处都会使用该值。 从同一菜单下载更新时，下载进度会直接显示在“检查更新”下方，不会与“关于”混在一起。
默认快捷键
| 功能 | macOS 默认快捷键 |
|---|---|
| 打开设置 | Command+, |
| 切换左侧边栏 | Command+B |
| 切换右侧工作区 | Option+Command+B |
| 切换底部面板 | Command+J |
| 返回 / 前进 | Command+[ / Command+] |
| 选择模型 | Control+Shift+M |
| 应用快照 | Command+Shift+2 |
Windows 和 Linux 使用界面中显示的对应组合键。
模型可用状态
“我的 CodeX”只展示当前设备已经通过 auth.json 配置的官方 Codex 模型。缺少
auth.json 时，该分组不会出现在模型选择器中；Provider 模型、本地自定义模型和云端模型
仍按各自配置展示。如果所有来源都没有可用模型，选择器直接显示“暂无可用模型”。
使用友好标题
在 设置 → 通用 → 任务运行 中打开 使用友好标题，并选择一个可用模型后，Wework 会在新建任务 时异步生成简洁的中文标题。创建不会等待标题模型返回：任务先使用用户输入的原始标题创建， 标题生成完成后才替换显示名称并出现短暂扫光效果。
标题生成使用独立的轻量模型调用，不会向任务会话写入消息，也不会改变主任务的运行、完成或 失败状态。手动重命名的任务不会被之后的自动标题覆盖。生成失败时，原始标题会保留，任务仍可 正常创建和运行。
普通新建任务默认是独立会话，不会因为之前打开过项目任务而自动加入远程项目或看板。只有在 发送前明确选择项目空间，或为任务显式关联项目空间时，Wework 才会同步该任务；已关联的任务 在友好标题生成后会将更新后的标题同步到对应的本地或云端看板。
自定义 Codex 模型
在“设置 → 模型”中点击“添加模型”后，先选择提供商。Wework 内置 Kimi Coding、Kimi 开放平台、DeepSeek 和 GLM profile；填写对应平台的 API Key 后，可以从提供商的 /models 接口读取可用模型。连接地址、接口协议、工具模式和已知模型的上下文长度由 profile 自动填写，其中 Kimi 开放平台使用中国区 api.moonshot.cn 端点。Kimi Coding 的 K3 会自动使用内置的 Codex Catalog profile，包括 256K 上下文和默认 low 推理等级。
DeepSeek profile 使用原生 Responses API，展示当前可用于 Codex 的 deepseek-v4-flash 和 deepseek-v4-pro。两者均使用 1,048,576 tokens 上下文、默认 high 推理等级、实时 Web Search 和 freeform apply_patch；连接测试也会要求模型真实返回 apply_patch custom tool call。旧版由 Wework 管理的 DeepSeek Chat Completions 配置会自动迁移到 Responses API。当前模型目录声明文本输入且关闭图片生成，因此图片生成和图片理解不会在该 profile 下显示为可用能力。
文本模型可以引用另一个明确声明图片输入能力的模型作为“视觉代理模型”。本地模型的引用在 Wework 本地模型设置中维护；云端模型的引用必须在 Wegent Web 管理端配置，Wework 只读取 Backend 下发的 visionSidecarModel 引用，不提供云端模型编辑入口。执行时，Wework 在请求主模型前调用视觉模型描述每张图片，再用描述文本替换 input_image。任何配置视觉代理的文本模型都会使用内部通用的 wework-vision-sidecar 能力目录项，使 Codex 可以接收图片，同时原始图片只发送给视觉模型，不发送给文本主模型。视觉代理支持 OpenAI Responses、OpenAI Chat Completions 和 Anthropic Messages 接口；单轮最多处理 8 个不同图片描述，单张图片最大 20 MB，描述失败时会插入明确的错误文本。远程视觉接口必须使用 HTTPS；仅 localhost 和回环 IP 可使用 HTTP，且视觉请求不会跟随重定向，避免凭证被发送到未授权的后续地址。
每个自定义模型都可以设置可选的“分组”，模型选择器会使用该名称组织模型。Kimi Coding 默认填写“Kimi”，用户可以修改或清空；未设置分组的模型统一显示在“自定义模型”下。
选择“完全自定义”可以配置兼容 OpenAI Responses、Chat Completions 或 Anthropic Messages 的接口。模型能力使用结构化表单维护，不需要编辑 Catalog JSON：
- 最大上下文同时用于运行时和 Catalog，不需要重复填写。
- 推理等级、输入类型和布尔能力通过预设选项或复选框配置。
- 基础提示词默认参考 Codex 的 GPT profile，并可单独展开编辑。
- 不常用字段在“高级模型能力”对话框中按“响应与工具”“Catalog 元数据”“提示词模板”分类配置。
自定义 Catalog 由当前设备上的同一个 Codex app-server 读取。保存模型时，如果没有任务执行，Wework 会静默重启 Codex app-server；如果有任务正在执行，则询问是否立即重启。选择稍后重启时，模型显示“等待重启执行器”，并且在重启完成前不会出现在模型选择器中。
数据位置与同步
本地项目文件保存在原项目目录。应用偏好、本地模型和本地会话保存在当前设备。只有在连接 Wegent 并主动使用云端能力时，相关任务请求和配置才会发送到对应服务。
Codex 认证内容只会在你明确上传或导入到云端后参与同步。远程设备命令、Git Token 和模型 API Key 应作为凭证管理。
自动存储清理
Wework 会在后台维护自己创建的可再生成数据，不需要用户手动点击清理：
- 托管工作树默认位于 Executor Home 的
workspace/worktrees。启用“自动删除旧工作树”后，系统保留设置中的最新数量，只选择已经归档任务关联的旧工作树；删除前先创建 Git 快照，因此之后仍可恢复。 - 任务运行不会暂停全局清理。系统一次只处理一个工作树，每批间隔 30 秒，并避开正在运行任务使用的工作树、最近更新的工作树以及与运行任务属于同一 Git 仓库的工作树。
- 反馈暂存文件和内置浏览器截图超过 24 小时后可被清理；Wework 日志超过 14 天后可被清理。桌面端启动 5 分钟后开始检查，此后每 30 分钟检查一次，每个目录每轮最多删除 20 个文件。
- 开发版隔离运行目录超过 14 天后可被清理。每个运行中的实例通过文件锁保护自己的目录；维护任务只删除已经停止的实例，每轮最多删除两个实例目录。
临时文件和日志清理只处理 Wework 已知目录的直属普通文件。隔离运行目录清理只处理 app-runtime 下名称合法、已经停止的直属实例目录。删除目标必须是已经展开的绝对路径；包含环境变量占位符、以 ~ 开头、包含父目录跳转或符号链接的路径会被拒绝，当前进程日志和所有活跃实例也不会被删除。单个目标校验或删除失败时会被跳过，不会阻塞任务或其他清理目录。