Mework 文档

Mework 是 macOS 与 Windows 上的桌面编码智能体，模型看到什么、做什么都由你掌控：上下文、工具，以及 Mework 添加的每一段提示词。你使用自己的提供商密钥或订阅；不需要 Mework 账号，除了 隐私政策 列出的请求，没有任何内容离开你的电脑。

安装

链接指向 Mework 的下载镜像 dl.mework.dev。同样的文件也在 GitHub 发布页上。

macOS

打开 .dmg，把 Mework 拖进 应用程序。应用使用 Apple Developer ID 签名，并经过 Apple 公证。

Mework 第一次需要用到它的钥匙串条目时（例如你保存 API Key），macOS 会询问是否允许使用 Mework Safe Storage。选 始终允许，这个版本的 Mework 就不会再被询问。

Windows 安装版

运行 Mework_1.1.0_x64-setup.exe。它为所有用户安装 Mework，所以 Windows 会请求管理员批准。缺少 WebView2 时安装程序会下载它，这一步需要联网。

Windows 便携版

把 Mework_1.1.0_x64_portable.zip 解压到一个单独的文件夹，运行 mework.exe。压缩包里的文件要放在一起：缺少 mework-aisdk.exe，所有模型请求都会失败；缺少 claude.exe，Claude Agent 提供商无法使用；缺少 remote-agents 文件夹，SSH 机器、WSL 和沙箱都无法使用。

便携指的是不用安装，而不是不留数据：便携版写入的数据文件夹和 Windows 凭据管理器条目与安装版相同。WebView2 必须事先装好。

MSIX 安装包

.msix 用 Mework 自己的证书签名，所以要先信任一次这个证书，Windows 才会接受它：

1. 从上面的表格下载 Mework_msix_signing.cer。

2. 把它导入 本地计算机 → 受信任人：双击文件，选 安装证书…，选 本地计算机，再选 将所有的证书都放入下列存储 和 受信任人。也可以在以管理员身份运行的 PowerShell 里执行：

   Import-Certificate -FilePath .\Mework_msix_signing.cer -CertStoreLocation Cert:\LocalMachine\TrustedPeople

3. 打开 Mework_1.1.0_x64.msix 并安装。

MSIX 版从不自己下载更新。从发布页安装的，它的 版本更新 页会引导你回到发布页获取下一个 .msix；从 Microsoft Store 安装的，由 Store 保持更新。

注意 安装版、便携版和 MSIX 版共用同一个数据文件夹，所以同一时间只能运行其中一个。

校验下载

SHA256SUMS 列出了发布中每个文件的 SHA-256 值。把它下载到与安装文件相同的位置。

macOS 上：

cd ~/Downloads
shasum -a 256 -c SHA256SUMS --ignore-missing

你下载了的每个文件都会显示 OK。

Windows 上，在 PowerShell 里：

Get-FileHash .\Mework_1.1.0_x64-setup.exe -Algorithm SHA256
Select-String Mework_1.1.0_x64-setup.exe .\SHA256SUMS

两个值必须一致；Get-FileHash 输出的是大写字母。

第一步

全新安装的 Mework 打开时是一个尚未选择项目的新任务。内置两个提供商：Claude Agent 运行随 Mework 附带的 Claude Code，默认开启；OpenAI Codex 在你用 ChatGPT 登录之前保持关闭。

1. 准备模型。 如果你已经在用 Claude Code 并且已登录，Mework 首次启动时会发现这一点，因为两者共用同一份登录：它会在 Claude Agent 下列出 Fable、Opus、Sonnet、Haiku 各自最新的模型并选中 Opus，你可以直接跳到第 3 步。否则打开 设置 → 提供商 → 模型提供商，任选其一：

   • Claude Agent：选 打开终端登录，在终端里完成登录，再选 重新检查。你不需要自己安装 Claude Code。
   • OpenAI Codex：选 登录 ChatGPT，在浏览器里授权。然后选 拉取模型，点击要添加的模型；不拉取的话 Codex 下没有任何模型。
   • 其他服务：选 添加提供商，填写名称、选择 对话协议，再选 添加。把密钥粘贴到 API Key（输入框失去焦点时自动保存），确认 API 地址，然后 拉取模型，点击要添加的模型。

   各协议与模型设置见 模型与提供商。

2. 选择模型：在输入框下方的模型菜单里选。这个选择对所有对话的下一次请求生效。

3. 添加项目。 在侧栏 项目 旁选 新建项目，点 选择目录… 选中你的文件夹，再选 创建项目。Mework 会在其中打开一个新任务。如果跳过这一步，任务会进入 临时项目，它为任务提供一个空的临时文件夹，任务删除时一并删除。详见 工作区与机器。

4. 确认安全层级。 新任务从 手动 开始：模型读取项目里的文件不用问你，每次写文件、执行 shell 命令、联网搜索都要等你在审批卡片上批准。详见 安全层级。

5. 发送。 输入你的请求，按 Enter 发送；ShiftEnter 换行。这两个键可以在 应用设置 里互换。

窗口

侧栏在左边，时间线在中间，下方是输入框；安全层级、计划、模型、思考程度和上下文圆环都在输入框下方。侧面板在时间线旁打开，入口是顶栏的按钮和它的 更多选项 菜单。