Mework 文档

Mework 是一款面向 Windows 的本地优先智能体工作台。你自带模型提供商和 API 密钥；应用运行工具、在宿主端维护每一道安全边界，并将一切数据存储在你的计算机上。本网站说明如何在日常工作中使用它、如何通过工具描述文件（提示词档案）塑造告知模型的内容，以及如何通过技能、MCP 服务器和生命周期钩子扩展它。

源码、发行版和问题跟踪器位于 github.com/catblob-hash/Mework。本网站由该仓库的 website/content 目录构建；欢迎通过拉取请求提交修正。

Mework 是什么

• 一款带有 React 界面和 Rust 宿主的桌面应用（Tauri 2、WebView2）。宿主负责持久化、工具执行、批准和浏览器；界面仅显示状态并发送意图。
• 一个自带提供商客户端。OpenAI Responses 和 Chat Completions、Anthropic Messages、Google、Azure OpenAI、Amazon Bedrock、Google Vertex、xAI 以及通用 OpenAI 兼容端点，全部通过一个嵌入式 AI SDK 侧车程序接入。没有内置的供应商账户。
• 一个带有 26 个内置工具的智能体运行时：文件系统、shell、联网搜索和抓取、真正的内置浏览器、子代理、脚本化工作流、待办列表、向你提问的方式，以及两层纯 Markdown 的长期记忆。
• **在安全方面具有确定性。**每次工具调用均由宿主依据对话的安全层级进行分类；批准会在执行前被消费；文件访问被限制在工作区内；浏览器档案为单次使用且相互隔离。

安装

从 Releases 页面下载任一版本：

“便携”意为没有安装程序，并不表示没有状态。两种版本均写入相同的位置：

首次运行

1. 打开设置 → 提供商 → 模型提供商，添加一个提供商并粘贴其 API 密钥（Codex 与 Claude Agent 两家是登录式）。点击拉取模型打开发现页并添加所需模型，或手动添加模型 ID；出现在列表里的模型即可使用。将其中一个选作该提供商的当前模型。
2. 回到工作区视图，创建一个指向文件夹的工作区（工作区行上的 +），或者从临时工作区开始。
3. 在输入框下方选择模型，输入任务并发送。首次需要权限的工具调用会显示一张批准卡，其中包含完整命令或路径；可以批准一次，或在该对话中对此工具选择“总是允许”。

默认对话会在请求批准安全层级下运行，并启用文件工具、适用于你平台的 shell 工具和 web_search，使用内置英文提示词档案。以上全部都是你可以更改的对话设置，也可以保存并复用为一个预设。

一个回合如何运作

理解这个循环会让其余设置一目了然：

1. 你发送一条消息。宿主会从已持久化的对话重建请求——渲染器无法注入宿主未存储的工具、提示词或历史记录。
2. 系统提示词被组装：你的对话提示词（为空时使用档案默认值）、已选择的技能、已选择的 MCP 服务器和钩子、可选的应用数据目录，以及——启用 web_search 时——网络证据安全边界。
3. 模型以文本和／或工具调用作答。每次调用都会被分类（读取／写入／无边界、在工作区内或外、是否必须确认），依次经过 PreToolUse / PermissionRequest 钩子、按需获得批准、执行，并经过 PostToolUse。结果会在下一轮返回给模型。
4. 后台工作——子代理、工作流运行、后台 shell 命令——会在回合结束后继续运行。它们的结果会在下一轮边界以 <task-notification> 形式交付，或在模型调用 task_wait 时交付。
5. 当模型停止调用工具、Stop 钩子使其停止、模型通过 ask_user 向你提问，或你将其停止时，该回合结束。

宿主在第 2–4 步添加的每个固定句子均在提示词档案中声明，因此你可以准确查看模型被告知了什么——参见提示词档案。

下一步去哪里

• 使用 Mework——工作区、对话、预设、工具和批准、运行环境、子代理和工作流、联网搜索、浏览器、记忆、图像和数据位置。
• 提示词档案——工具描述文件格式、每个注入点、占位符、回退规则和示例。
• 技能——SKILL.md 文件夹：安装、选择、按需加载。
• MCP 服务器——stdio 和 Streamable HTTP 服务器、按对话选择、批准。
• 钩子——hooks.json、七个生命周期事件、stdin/stdout 协议、示例。

从源码构建

前提条件：Node.js ≥ 22.12、稳定版 Rust、带 WebView2 的 Windows、Visual Studio Build Tools（MSVC），以及供编译 C 源码的 crate 使用的 MSYS2 mingw64 工具链（gcc、make、perl）。

npm install
npm --prefix aisdk-service install
npm run tauri:build

tauri:build 会构建前端，将侧车程序编译为单个可执行文件，并在 src-tauri/target/release/bundle/nsis/ 下生成安装程序。npm run package:portable 会根据该输出打包便携版为 zip。仓库 README 包含完整的开发命令列表。