驭智工坊 (Master AI) 怎么玩
驭智工坊 (Master AI) 是一款深植于您本地计算机的高性能个人 AI 工作站。它不仅仅是一个能够为您解答疑惑的聊天框，而是直接将 多智能体异步协同（Team Studio）、本地实战工坊（Practice） 与您的 本地项目文件（Project Chat） 打通的超级工作台。
告别多开窗口频繁复制代码、人工在编辑器间搬运数据的低效模式。在 Master AI 中，学习的现场就是生产的现场，您摸索出的每一个 Prompt 与工作流都能固化为可随时调用的“技能卡”，组建属于您的虚拟数字专家团队。
核心理念： 绑定本地项目（零复制），唤醒多智能体协同（高效率），固化工作流为技能（沉淀资产）。
1. 下载与极速安装
Master AI 原生支持 Windows 和 macOS 平台，提供独立的 Electron 桌面壳包，安装非常简单。
获取安装包
在官网控制台“下载中心”下载最新版本的安装包。Windows 用户获取 .zip 便携包或 Inno Setup 安装包，macOS 用户下载 .dmg 挂载卷。
完成安装
双击解压缩或打开挂载卷。Mac 用户只需将 Master AI 图标拖入 Applications（应用程序）文件夹中即可；Windows 用户双击运行主程序。
启动后，软件界面支持 深色（Dark Mode）与浅色（Light Mode） 根据系统主题自动切换，带来更舒适的长时间阅读和开发体验。
2. 首次运行向导与对接
首次运行 Master AI 时，系统会自动启动“三步配置向导”：
- 第一步：LLM 模型对接
支持各大云端大模型 Endpoint（OpenAI、Anthropic、Google、DeepSeek 等），您只需填入您的 API Key 及自定义端口即可。如果您在意数据隐私或在离线状态下工作，还可以一键直连本地跑的 Ollama 引擎。 - 第二步：AI 导师人设初始化
自定义全局 AI 导师性格。系统预置了高水准的“学用一体苏格拉底教学人设”，直接保存即生成您的全局提示词。 - 第三步：系统环境检测
检测并自动安装后台智能体所需的 Python 运行时及环境依赖，检测通过后即刻解锁全部功能。
3. 核心引擎：本地实战工坊 (Practice)
在左侧边栏点开“实战工坊”，它是您动手开发的核心场所：
- 文件系统联动：当 AI 帮您生成代码或方案时，它不仅会将代码显示在屏幕上，还会在右侧的 本地文件夹面板 中直接生成真正的物理文件。
- 安全与沙箱：所有生成的代码均保存在您指定的本地 Workspace 目录中，无需任何跨网页复制，您可以在本地随意运行、修改或删除。
- 一键热导出：编写完成的项目文档或交互方案，支持在工作区内一键导出为带批注的 Markdown、精美排版的 PDF 或 PPT 报告，极大简化您的交付流程。
4. 核心引擎：动态研习导师 (Study)
研习模块是您私人的专属“苏格拉底式数字导师”，能够动态跟踪您的知识地图：
- 秒级规划大纲：输入任何您想学的内容，如“基于 React 部署高阶动效”，AI 导师会在右侧大纲栏为您一键生成系统课程大纲。
- 互动追问教学：导师不会一次性抛出长篇大论，而是逐步讲解知识点，并通过互动性追问和随堂测试确认您确实掌握了这一章节。
- 进度挂载：学习过程中产生的所有实践代码会自动留存在关联的实战工坊中，进度无缝保存，方便您随时回顾。
5. 核心引擎：团队协作工坊 (Team Studio) [全新]
对于高复杂、长链路的软件开发或分析项目，单次的单人对话远远不够。为此，Master AI 推出了 团队协作工坊 (Team Studio)：
- 目标清晰度评分：输入您的任务目标后，协作工坊会对该目标进行深度分析，指出模糊描述，并为您提供“补全目标”方案和分值建议，直到您的目标达到最佳执行标准。
- 拉人群聊与专家推荐：根据任务的特征，系统会自动推荐最适合该任务的虚拟专家搭档组合（如 `@preset-coder` 全栈交付工程师、`@preset-product` 需求分析师等），一秒建立虚拟联合工作组。
- 异步执行与实时日志追踪：团队智能体在后台以流水线（Pipeline）形式进行链式工作。配合前台的可视化执行日志面板，您可以实时监控每个 Agent 的思考过程与交付产出。
6. 核心引擎：技能资产中心 (Skills Center) [全新]
拒绝低效的文本复制与备忘录维护。我们在右侧面板新增了 技能资产中心，将您的 Prompt 工程升级为数字化可共享资产：
- 可视化零代码表单：只需几步，即可将您编写的精巧 Prompt 打包为“技能卡”。你可以将复杂变量设置为表单输入框，下次调用只需填几个参数点击执行即可。
- 热加载与类别分类：所有技能卡在侧边栏分类展示，可以快速在不同的对话会话中作为“快捷插件”唤醒并加载运行。
- 团队导入与分享：支持将成熟技能一键打包为 JSON 格式导出，发给同事一键导入，带起全队 AI 生产力。
7. 核心引擎：全维度成长画布与 LaTeX 渲染
陪伴您的能力跨越。成长看板用于量化记录您的所有活跃度：
- 多维度能力雷达图：记录您在各技术栈（沟通能力、编程深度、逻辑推理、调试改错）上的互动数据，绘制直观的“六芒星”能力图谱。
- 活跃热力图：类似于 GitHub 的绿色贡献墙，每一次您在实战工坊中生成文件、固化技能、在研习中通过测试，都会积累成长热值。
- 高精度 LaTeX 渲染：看板与实战面板全面集成 KaTeX 数学公式渲染引擎，能完美还原高水平的统计学图表与深度计算公式。
8. 深度研发：项目上下文对话 (Project Chat) [全新]
Project Chat 是 Master AI 专门针对开发工程师设计的深度上下文功能：
- 项目上下文绑定：您可以在会话设置中将当前的对话绑定到本地任意的项目目录（如
~/workspace/project-a）。 - Suppressed Shortcuts（屏蔽干扰快捷键）：进入项目对话后，底层的全局快捷键将自动降级，避免与正在编辑的文件快捷键产生冲突。
- 上下文自动抓取：AI 能够直接识别该项目下的文件目录拓扑与特定文件（支持代码文件和 Markdown 文档），您无需手动拖拽上传代码文件，直接在会话中
@file_name即可引用上下文。
9. 主页视频对应的快速路线
官网首页的视频预览按实际工作流组织：先建立项目上下文，再召集团队智能体，最后把稳定流程封装为技能。您可以按下面的顺序在客户端中复现：
- 进入 Project Chat：绑定本地项目目录，让 AI 直接理解代码结构、文档和当前任务背景。
- 切换 Team Studio：输入目标后查看清晰度评分，选择系统推荐的专家搭档组合，并让任务在后台推进。
- 沉淀为 Skills：把反复使用的提示词、交付流程或检查清单保存为技能卡，下一次通过参数化表单一键复用。
- 回到成长看板：查看研习、实战、协作和技能沉淀带来的长期能力记录。
10. 自定义 AI 行为准则 (SOUL.md)
在系统的“设置”面板中，您所有的偏好都会被持久化写入系统级配置文件 SOUL.md。它充当了大模型的系统提示词底层基石：
# 核心原则
- 你是用户最信任的AI导师和高级工程搭档。
- 永远以解决实际问题为导向，不讲空话。
# 沟通风格
- 简洁明了，直接给出可执行的代码或具体方案。
- 在指出错误时，请保持专业和建设性。
安全提示： SOUL.md 在新对话中会全局生效。如果您在高级编程中发现 AI 反复拒绝写危险命令或格式冲突，请检查该人设文件是否包含不合理的系统限制条件。
11. 系统级高级环境配置 (.env)
Master AI 后端服务具有极高的自定义性。用户可以通过在安装根目录下复制并编辑 .env 文件来实现：
MAI_WEBUI_PORT=8787：修改本地 Web 服务监听端口（如防止端口冲突）。MAI_WEBUI_DEFAULT_WORKSPACE=~/workspace：修改默认本地物理工作区的路径。MAI_CLOUD_AUTH_ENABLED=1：启用云端中央账号验证，配合MAI_CLOUD_AUTH_URL使用。MAI_WEBUI_PRUNE_EXTRA_SKILLS=0：启动时是否保留用户本地自定义创建的额外技能（设置为 1 时在启动时会自动清空并只保留 bundled Built-in 技能，适合系统恢复还原）。
12. 常见问题 (FAQ)
Q: 本地 Ollama 引擎连不上该怎么解决？
请确保您本地正在运行 Ollama 后台服务（可在终端测试 ollama list）。默认的本地 Endpoint 监听端口为 http://127.0.0.1:11434。如果您在 Electron 中连接，需确保大模型已被拉取到本地，或者可以在“设置”面板中将 Ollama Endpoint 的 host 改为您局域网内的某台推理机。
Q: 提示写入本地工作区失败，AI 生成不了文件？
请确保设置中的物理工作区文件夹存在，且当前系统用户对该文件夹具备 读取和写入权限。如果是 Windows 用户，注意不要将工作区设置在受系统账户访问控制（UAC）保护的 C 盘根目录下，推荐设置在 D 盘或用户个人文档目录下。
Q: 云端同步和邀请码有什么用？
如果您的团队开启了 MAI_CLOUD_AUTH_ENABLED，则用户登录需走中央服务。在云端数据库注册时，若管理员配置了 MAI_INVITE_CODE，新注册用户需要向管理员获取正确邀请码才可以完成注册。若本地单机使用，默认云端状态为关闭。