它是什么 · 功能特性 · 任务流程 · 界面截图 · 架构 · 快速开始 · 安全与边界 · 开发 · 贡献与反馈 · Star 历史

--- > 项目处于持续开源迭代状态。本文档描述当前公开的 `v0.0.7` 发行基线，功能、依赖、平台支持和界面会随后续版本变化。 ## 它是什么 MastraWork 是一个开源的桌面 AI 工作台，底层是 [Mastra](https://mastra.ai) 框架和 Electron。它想解决的事情很具体。现在多数 AI 工具给你一段回答，事情就停在那儿。代码改到一半让它继续，它常常重新读一遍文件，从接不上的地方往下编。MastraWork 把一次 Agent 运行组织成一个任务。任务落在具体的工作区里，长在线程上，每一步都留下痕迹。它能暂停，能回头检查，也能交给团队里的其他成员接着看。这东西做给软件工程和知识工作用。Agent、团队、工作区、终端、浏览器、MCP、技能和资料库收在同一个应用里，围着同一个任务转。你在主窗口和一个主 Agent 对话，也可以拉一支专家团队，把读代码、查资料、跑命令、写文档这类活分出去，每一步都留在现场。模型推理走哪个服务由你自己配置。「本地优先」说的是桌面宿主、默认工作区和本地数据边界优先留在本机，不表示所有推理都在本地完成。 ## 功能特性下面这些能力在 `v0.0.7` 里都能直接用到。

🧭 工程任务

读取代码、全局搜索、编辑与 AST 修改、运行命令、查看差异、调用 LSP。读、写、执行分开授权，每一步都有记录。

🛡️ 受控执行

计划、构建、复查三种模式，切的是 Agent 能碰什么。人工询问和批准留在流程里，不靠自觉。

👥 Agent 团队

主 Agent 带专家成员，支持委派、交接、并行、分支、循环和审批工作流，复杂任务拆给合适的人。

🧩 开放扩展

模型 Provider、MCP Server、技能与插件、浏览器、资料库、记忆和网页检索，按需接入，不绑定一家。

🖥️ 桌面集成

Electron 主进程、原生浏览器视图、PTY 终端、系统通知、凭据保险库，Windows、macOS、Linux 三个平台都有安装包。

📚 记忆与资料库

记忆跨会话保留，资料库统一收文档、表格和网页。用量、费用和历史数据随时可查。

## 一个任务是怎么走完的

一个任务从开工到验收，Agent 手里的权限是变的。计划、构建、复查三种模式，对读、编辑、执行和外部工具各有一套策略。人工询问和批准留在流程里，高风险的动作等人确认了再动。计划阶段先把事情想清楚，读代码、查资料、出方案。方案定了再切到构建，改代码、跑命令、推进任务，每一步都留下记录，随时可以停下来回头看。复查阶段对照差异和工作记录验收，高风险的操作在这里需要人批准。图里画的是主干流程，每个模式具体放开了哪些工具，以应用内的实际设置和服务端检查为准。 ## 界面截图

工作台与对话

主窗口的默认样子，右侧文件面板、命令搜索和工具入口都在这一组。

_空态首页	_{完整工作界面}	_{对话与常规}
_{文件与执行}	_{搜索与工具}	_命令搜索

模型与连接

登录之后先配模型。Provider、密钥和连接状态，都在这几页里。

_登录

_{模型选择器}

_{模型与连接}

Agent 与自动化

团队怎么建、专家怎么配、任务怎么委派，浏览器和电脑控制的入口也在这组。

_{智能体团队创建}	_专家成员	_{团队与目标模式}
_{主代理委派子代理}	_{主动 Ask 工具}	_{已安排任务}
_{浏览器自动化}	_{浏览器执行}	_电脑控制

浏览器自动化和电脑控制的截图放在最后。这些能力都要单独配置凭据，配好之后才会在任务里出现。

知识与个性化

资料库、技能套件、记忆、用量费用和外观主题，日常设置都收在这里。

_资料库	_技能套件	_{记忆与个性化}
_{数据与历史}	_{用量与费用}	_外观主题
_{快捷键指南}	_{安全与合规}	_附件菜单

最后一张是关于与版本页面，应用版本、构建编号和系统信息都在这里。碰到问题提 Issue 的时候，把这一页的信息捎上，排查会快很多。

_{关于与版本}

资料库和技能套件的截图在这组。记忆与个性化的选项比较多，刚上手建议先看外观主题和快捷键指南。

## 它是怎么搭起来的

整个应用分四层。最外面是桌面集成层，Electron 主进程在这儿管窗口、原生浏览器视图、PTY 终端、系统通知和凭据保险库。往下是工作流层，Mastra 撑起的 Agent 运行时在这层，主 Agent 和专家团队的委派、交接、并行都发生在这里，三种执行模式也在这层落地。再往下是框架层，Mastra 的记忆、RAG、MCP 和可观测性模块，加上编辑器 AST 修改和沙箱执行，都归这层。最底下是扩展层，模型 Provider、MCP Server、技能、资料库和网页检索从这儿接进来。一个任务的走向是这样的。你在桌面层发起任务，工作流层组织 Agent 和模式，框架层提供记忆和工具，扩展层补上模型和外部服务。数据默认留在本机，Mastra 服务跑在本机 `4111` 端口。主要选型列在下面。 | 部分 | 选型 | | --- | --- | | 桌面外壳 | Electron 44、electron-vite、electron-builder | | 界面 | React 19、TypeScript、Tailwind CSS 4、CodeMirror 6、xterm | | Agent 框架 | Mastra 1.77（core、memory、rag、mcp、observability） | | 数据与检索 | libsql、DuckDB、fastembed 本地向量 | | 代码与文档 | Shiki 高亮、Mermaid、KaTeX、PDF 与 Office 解析 | | 工具链 | Biome、Knip、pnpm workspace |

## 快速开始 ### 直接下载 | 平台 | 安装包 | | --- | --- | | Windows | `MastraWork-0.0.7-setup.exe` | | macOS | `MastraWork-0.0.7.dmg` | | Linux | `MastraWork-0.0.7.AppImage`、`MastraWork-0.0.7.deb`、`MastraWork-0.0.7.snap` | ### 从源码运行需要 Windows、macOS 或 Linux，Node.js `>=22.19.0 <23`，pnpm `12.11.2`。推荐用 Corepack 把 pnpm 版本钉死，免得升级后对不上。 ```sh corepack enable corepack prepare pnpm@12.11.2 --activate pnpm install --frozen-lockfile pnpm dev ``` 打包三个平台的安装包。 ```sh pnpm build pnpm build:win pnpm build:mac pnpm build:linux ``` ### 首次配置 1. 启动后打开模型或连接设置，配一个可用的模型 Provider。 2. 选一个工作区目录。Agent 的读写和命令工具，以当前工作区与会话策略为边界。 3. 需要网页检索、浏览器、MCP 或技能时，再按实际服务分别配置凭据和授权。 4. 模型服务会收到你发过去的提示词和选定的上下文。用之前请读一遍对应模型或 API 的服务条款和数据处理政策。默认本地数据目录是 `~/.mastrawork`。Mastra 服务默认监听本机 `4111` 端口，存储服务可以经 `MASTRA_STORAGE_URL` 调整。具体配置以当前版本的设置页面和源码为准。 ## 安全与边界 - 计划、构建和复查模式对读、编辑、执行和外部工具采用不同策略。截图展示的是入口，实际安全性以服务端权限检查和测试记录为准。 - API Key、OAuth token 和 Cookie 由桌面主进程的凭据保险库保管，公开材料里不含任何真实凭据。 - 工作区、用户、线程、资料对象和扩展配置按资源 ID 关联。高风险代码、生产数据、个人信息，以及法律、医疗、金融领域的决策，仍要人来审。 - 公开网页上的内容，不自动等于可以复制、训练、改编或再分发。MCP Server、模型、字体、图标、网页内容和用户资料，各适用自己的许可或服务条款。 ## 开发先把 Node 和 pnpm 装好，版本见上文，然后执行下面的命令。 ```sh pnpm install --frozen-lockfile pnpm format pnpm lint pnpm typecheck ``` ## 贡献与反馈问题请走 [GitHub Issues](https://github.com/movclantian/mastra-desktop/issues)。可复现的问题最受欢迎，附上版本、系统、步骤、预期行为和实际行为，日志记得脱敏。项目按公开仓库的节奏持续迭代，不同发行版之间的行为和兼容性可能有变化，升级前请看 Release 说明。 ## 许可证项目自有代码、文档和配置以 [Apache-2.0](LICENSE) 发布。第三方组件和资源遵循各自的许可。

## Star 历史

感谢读到这里。项目还在早期，用着顺手或者踩到坑，都欢迎来 Issues 说一声。