应用设置
设置窗口存放作用于整个 Mework、而不是某一个对话的选项：外观、本地小模型、快捷键、用量统计、命令行工具和版本更新。你的数据放在几个文件夹里，可以备份，也可以彻底移除。
打开设置
点侧栏底部的 设置，或按 ⌘,（Windows 上是 Ctrl,）。全局设置 窗口先打开 模型提供商 页（见 模型与提供商）；搜索提供商 见 联网搜索与抓取。所有改动即改即生效；只有模型编辑器有 保存 按钮。
技能、MCP 服务器、钩子和代理角色不在这里：它们在 对话设置 里按对话选择。
外观
设置 → 偏好 → 外观 决定 Mework 的样子，以及用哪个键发送消息。
| 设置 | 作用 | 默认 |
|---|---|---|
| 主题 | 浅色、深色 或 跟随系统。 | 跟随系统 |
| 液态玻璃 | 侧栏和侧面板变成半透明玻璃，透出窗口背景。 | 关 |
| 自定义背景 | 选择背景… 可选纯色、内置图片，或在 我的图片 里添加你自己的图片。纯色随主题切换，图片保持不变。 | 主题自带的颜色 |
| 应用语言 | 自动 在系统语言是任何一种中文时用简体中文，其他情况用英语。macOS 菜单栏和托盘菜单的语言也随之改变。 | 自动 |
| 界面字体、等宽字体 | 自定义… 可以填一个字体族，或用逗号分隔的字体列表。只有已安装的字体才有效。 | 默认 |
| 发送快捷键、换行快捷键 | Enter、ShiftEnter、⌘Enter 或 ⌥Enter（Windows 上是 CtrlEnter 或 AltEnter）。 | Enter 发送，ShiftEnter 换行 |
| 删除消息前确认 | 在时间线上删除一张卡片或框选的多张卡片时，先请你确认。 | 关 |
| 启用 $...$ 行内公式 | 把 $…$ 渲染成公式。消息里常有金额时建议关闭；关闭后 $$…$$ 照常渲染。 |
开 |
| 自定义 CSS | 你自己的样式表，边输入边生效。其中只能加载已安装的字体和 data: 图片。 |
空 |
用拼音等输入法输入时，用来确认候选词的 Enter 不会发送消息。页面缩放（50%–200%）就是缩放快捷键改的那个值。
本地小模型
本地小模型是一个在你电脑上运行的小型语言模型（Qwen3.5-0.8B），不调用任何提供商。它的开关在 设置 → 偏好 → 外观 的 本地小模型 下，默认全部关闭。
| 开关 | 作用 |
|---|---|
| 自动生成会话标题 | 根据第一条消息（包括附带的文件和图片）为对话命名，也为任务面板里每个子代理那一行写副标题。你自己起的名字会保留。 |
| 解释 Shell 命令 | 用一句话说明每条 shell 命令，作为命令卡片的标题。 |
| 解释错误 | 工具调用或命令失败时，用几个词说明原因，代替错误原文作为卡片标题。 |
| 也用于子代理 | 把上面几项扩展到子代理和工作流步骤，并为每个工作流步骤命名。 |
尚未安装模型时，打开前三项中的任意一项，Mework 会提出下载一个 1.6–1.7 GB 的版本；最适合这台电脑的标着 推荐。
- 神经网络引擎版（Core ML）：带神经网络引擎的 Apple 芯片 Mac，macOS 15 及以上。省电。第一次加载，以及每次应用更新后的第一次加载，约需两分钟。
- GPU 版（MLX）：Apple 芯片，macOS 14 及以上。
- llama.cpp 版：Windows，通过 Vulkan 在显卡上运行，或用 CPU。
模型文件从 Hugging Face 下载；系统设为中国大陆中文时，Mework 会提出使用国内镜像，你同意后改从 hf-mirror.com 下载。在 Windows 上，llama.cpp 运行库还会从 GitHub 和 LunarG 下载。Intel Mac 无法运行本地小模型。
模型与提示词 → 管理… 可以切换、删除各个版本，并编辑模型使用的提示词。模型文件存放在 数据文件夹 的 local-model/ 里。
快捷键
设置 → 效率 → 快捷键 列出应用的全部快捷键。在 macOS 上，按键以 Mac 符号显示（⌘ ⌥ ⌃ ⇧）。
| 命令 | macOS | Windows |
|---|---|---|
| 打开设置 | ⌘, | Ctrl, |
| 打开本对话设置 | ⇧⌘, | CtrlShift, |
| 放大、缩小、重置缩放 | ⌘=、⌘-、⌘0 | Ctrl=、Ctrl-、Ctrl0 |
| 新建对话 | ⌘N | CtrlN |
| 下一个对话 | ⌃Tab | CtrlTab |
| 上一个对话 | ⌃⇧Tab | CtrlShiftTab |
| 复制最后一条消息 | ⇧⌘C | CtrlShiftC |
| 编辑最后一条用户消息 | ⇧⌘E | CtrlShiftE |
| 打开或关闭内置浏览器 | ⌘B | CtrlB |
| 关闭侧边面板 | ⇧⌘W | CtrlShiftW |
复制最后一条消息、编辑最后一条用户消息 和 关闭侧边面板 要你自己启用；停止当前运行 在你设置按键之前没有快捷键。
要修改快捷键，点它的按键，再按下新的组合；Esc 取消。按键按物理位置记录，与键盘布局无关。缩放快捷键可以停用，但不能修改。更多快捷键操作 → 重置为默认值 把全部快捷键恢复原样。发送键和换行键在 外观 里设置。
用量统计
设置 → 效率 → 用量统计 显示 全部、30 天 或 7 天 内的会话数、消息数、token 数和活跃天数，模型 页显示每个模型的 token 用量。
token 数包含你发出的每一次模型请求，子代理和原生联网搜索也算在内。删除对话会让 会话数 和 消息数 下降，但它用掉的 token 仍计入总数。没有重置功能。
环境依赖
设置 → 系统 → 环境依赖 检查 Git、Node.js、Python、uv 等常用命令行工具是否在 PATH 上，说明每个工具的用途，并显示检测到的版本。它从不安装任何东西；添加工具 可以加入你自己想检查的工具。
Git 用于 Git 相关标签和审阅面板；Node.js、Python、uv 或 Bun 用于通过 npx、uvx 或 bunx 启动的 MCP 服务器。ripgrep 是供你或代理在 shell 里使用的搜索命令；有没有它，Mework 自己的搜索工具都一样工作。
Mework 只在启动时读取一次 PATH（在 macOS 上从你的登录 shell 获取）。安装了新工具后，要退出 Mework 再重新打开，只关闭窗口不够。
版本更新
设置 → 系统 → 版本更新 显示你的版本，以及 Windows 上的版本类型。Mework 只在这一页打开时检查新版本，从不在后台检查。
| 版本类型 | 会发生什么 |
|---|---|
| Windows 安装版 | 选 下载更新，再选 安装并重启。设置和数据都会保留；Windows 会请求管理员批准。 |
| Windows 便携版 | 下载更新 把新的 zip 存到你的「下载」文件夹。退出 Mework，把压缩包解压覆盖到旧文件夹，再重新打开。 |
| MSIX | 从不自己下载更新。从 Microsoft Store 安装的，由 Store 保持更新；从发布页安装的，版本更新页会引导你去发布页获取下一个 .msix。 |
| macOS | 页面说明 Mework 会检查新版本，但不下载。前往发布页 打开发布页面，在那里下载新的 .dmg。 |
安装更新会退出 Mework，正在进行的后台工作随之停止。
关闭与退出
关闭窗口只是把它隐藏：Mework 继续在 Windows 通知区域或 macOS 菜单栏里运行，子代理、工作流、shell 命令和模型运行都不会中断。在 macOS 上，窗口回来之前 Mework 也会从程序坞中消失。没有设置可以改变这一点。
- 找回窗口：点托盘或菜单栏图标，或再次启动 Mework。
- 退出：在托盘或菜单栏菜单里选 关闭 Mework（Windows）或 退出 Mework（macOS），macOS 上也可以按 ⌘Q。退出前会先保存所有内容，并停止全部后台工作。保存失败时 Mework 保持打开，请你解决存储问题后再次退出。
你的数据
存放位置
| 内容 | macOS | Windows |
|---|---|---|
| 设置、对话、附件、用量统计 | ~/Library/Application Support/com.mework.app |
%APPDATA%\com.mework.app |
| 本地小模型、内置浏览器配置、下载的更新 | 同一个文件夹 | %LOCALAPPDATA%\com.mework.app |
| 缓存 | ~/Library/Caches/com.mework.app 和 ~/Library/WebKit/com.mework.app |
%LOCALAPPDATA%\com.mework.app |
| API Key | ~/.mework/credential-vault/，由登录钥匙串条目 Mework Safe Storage 加密保护 |
Windows 凭据管理器中名称以 com.mework.api 结尾的条目 |
| 你的配置、全局记忆、OpenAI Codex 登录 | ~/.mework/ |
%USERPROFILE%\.mework\ |
| 项目的配置和记忆 | 项目里的 .mework/ |
项目里的 .mework\ |
Claude Agent 的登录由 Claude Code 自己保管，不归 Mework。表格第一行的文件夹里，document.v1.json 存放你的设置，conversations.v1.sqlite3 存放对话，temporary-workspaces/ 存放临时项目里各个任务的文件夹，随任务一起删除。
备份
- 退出 Mework。只关闭窗口时，它的文件仍处于打开状态。
- 复制表格第一行的文件夹和
~/.mework。在 macOS 上可以跳过体积较大的local-model/和browser-tab-profiles/；在 Windows 上可以跳过%LOCALAPPDATA%\com.mework.app。Mework 会重新生成它们。 - 密钥不会随副本带走。换到另一台电脑后，需要重新输入 API Key 并重新登录。
设置文件损坏
如果 document.v1.json 无法读取，Mework 不会改动它，而是在旁边保存一份名为 document.v1.corrupt-<时间>.json 的副本，并告诉你原因，例如它是由更新版本的 Mework 写入的。如果想从头开始，按这个界面上的重置按钮：按钮会写明它将删除所有对话、附件和临时项目的文件夹，并且 Mework 会先请你确认。
彻底移除
- Windows 安装版：在 Windows 设置 → 应用 中卸载 Mework，并勾选 Delete the application data，即可删除两个 AppData 文件夹。
- Windows 便携版 和 MSIX：移除应用，再自己删除两个 AppData 文件夹。
- macOS：把 Mework 移到废纸篓，再删除三个
com.mework.app文件夹，并在「钥匙串访问」里删除 Mework Safe Storage 条目。
最后删除 ~/.mework（你的配置、全局记忆、技能和登录信息），在 Windows 上还要删除凭据管理器里名称以 com.mework.api 或 com.mework.app.project-import-trust.v1 结尾的条目。