# MWORKS AI
MWORKS AI 是 Sysplorer 内置的 AI 助手,提供自然语言驱动的建模与仿真体验。支持从需求理解到模型验证的全程辅助,涵盖产品导览、操作指引、智能问答、代码生成等功能,帮助用户快速掌握 Sysplorer 并高效完成仿真任务。
# 产品简介
MWORKS AI 是面向建模与工程场景的一套智能助手能力。
它与 Sysplorer 的关系可以概括为:
- Sysplorer 负责工程建模、检查、翻译、仿真和结果分析等主流程;
- MWORKS AI 作为配套的智能对话窗口,与 Sysplorer 同机协同工作;
- MWORKS AI 不替代 Sysplorer 的核心建模内核,而是将自然语言需求转化为查询、脚本调用、工具使用建议或具体操作步骤。
# 快速入门
本节介绍首次使用 MWORKS AI 的基本配置流程,包括运行环境确认、功能入口打开、账号登录、在线模型选择以及本地模型切换。完成配置后,即可在 Sysplorer 中使用 MWORKS AI 进行智能问答、建模辅助和仿真任务处理。
# 前置条件
使用 MWORKS AI 前,请确认当前环境满足以下要求。
- 当前系统为 Windows 10/11 64 位或 Linux(Ubuntu 20.04+、CentOS 8+);
- 已安装 Sysplorer 2026a V26.3 及以上版本;
- 当前网络可以正常访问同元官网。
# 启动 MWORKS AI
在 Sysplorer 中打开 MWORKS AI 功能入口。
首次启动 MWORKS AI 时,将进入登录界面。
# 登录或注册账号
MWORKS AI 需要使用苏州同元软控技术股份有限公司 (opens new window)(以下简称同元)账号登录后才能调用可用模型。如果尚未注册账号,请先完成注册,再登录使用。
账号注册入口如下:
# 配置在线模型
完成注册并登录账号后,可在模型配置界面选择在线模型。登录账号后,系统会提供一定的免费额度,可用于调用 deepseek 的相关模型进行建模使用。
| 模型名 | 模型功能 | 额度耗费对比 |
|---|---|---|
| tongyuan/deepseek-v4-flash | DeepSeek-V4-Flash 模型,支持思考与非思考模式,具备长上下文、JSON 输出、工具调用等能力,适用于常规问答、代码生成和建模辅助场景 | 基础计费倍率,免费额度消耗较慢,可支持更多轮次对话 |
| tongyuan/deepseek-v4-pro | DeepSeek-V4-Pro 模型,支持思考与非思考模式,具备长上下文、JSON 输出、工具调用等能力,适用于复杂推理、长文本分析和高难度建模优化场景 | 计费倍率较高,免费额度消耗更快,相同使用量下可用轮次较少 |
# 自定义模型配置
MWORKS AI 需依赖本机存在可用的智能体程序。在 Sysplorer 2026a V26.3 及以上版本中,软件安装时会自动安装特定 opencode 版本。该版本仅在 Sysplorer 中调用,不影响全局配置。
如需使用本地模型,目前支持切换为本地 opencode 设置。切换前,请确认已完成以下准备:
- 本地已经安装 opencode 客户端或 cli 终端(非 Sysplorer 自带版本),并已配置相关模型;
- 已经完成一次同元账号登录。
完成准备后,按以下步骤切换为本地客户端。
进入全局配置路径
C:\Users\用户名\.config\opencode。找到
opencode-mworks.json文件,并将其重命名为opencode-mworks.json.bak。opencode-mworks.json是 MWORKS AI 默认添加的配置文件。opencode 启动时会优先读取该文件中的配置,将文件名增加.bak后,系统将不再识别它为有效配置文件,从而回退到 opencode 的默认配置,并切换为本地 opencode 客户端。
重启 opencode 和 Sysplorer。

提示
产品支持在多种模型间进行切换,不同模型的部分能力可能存在差异,属于正常现象。
# 核心功能
# 会话与工具管理
MWORKS AI 提供完整的会话管理与工具控制能力,帮助用户高效组织对话流程。
- 新建会话:创建新的 Sysplorer AI 会话,上下文独立;
- 历史会话:查看和继续之前的聊天记录;
- 会话设置:包括通用偏好设置、MCP 服务管理、运行时终端等。
# MCP 服务集成
MCP 通常指 Model Context Protocol,即模型上下文协议。MCP 是一种开放协议,用于标准化应用向大语言模型提供上下文信息与工具能力的方式。
MWORKS AI 支持的能力如下:
- 内置集成 Sysplorer MCP Server;
- 与 Sysplorer 本地服务连接,获取当前环境信息;
- 调用本地服务进行代码执行、函数查询和帮助搜索;
- 在设置中管理已配置的服务入口;
- 支持自动 MCP 服务发现和配置。
# 智能体、模式与模型
智能体、模式与模型,三者的关系如下:
- 智能体:带目标、会调用工具去做事的执行体;
- 模式:工作方式,可在 Build(直接生成)与 Plan(规划)模式之间切换;
- Build:默认开发模式,规划、搜索、开发等一站式完成任务,工作目录内操作无需用户确认(推荐);
- Plan:规划分析模式,为完成任务制定详细的执行方案,仅生成步骤与建议,不执行任何实际操作。
- 模型:执行理解、推理与生成任务的底层智能能力实体,即大脑。如国内大模型 Minimax M2.5、GLM 5 、deepseek-v4 等。
# 工作区、命令和文件输入
工作区、命令与文件输入是智能体执行任务的重要上下文资源:
- 工作区:智能体操作的目录范围,限定文件读写和代码修改的作用域,确保操作安全可控;
- 命令:智能体可调用的终端指令,用于执行编译、运行、查询等系统级操作,加速任务落地;
- 文件输入:用户可上传文件、图片或指定文件路径,作为智能体分析和处理的参考依据。文件与图片的支持情况取决于所选模型的能力。
# 典型案例
# 示例 1:构建单相输电系统
输入提示词:
严格按已配置 skill 执行,在 Sysplorer 中搭建单相输电系统暂态模型:
1. 电源(230 kV/√3,60 Hz)串联 Rs、Ls(2000 MVA,X/R=10,R=2.645 Ω,L=0.0702 H),经 150 km π 型线路(R=5.2 Ω,L=138 mH,C1=C2=0.967 μF)连接断路器与并联 RLC 负载(75 MW,20 Mvar),
2. 负载接地并配置 I_load、V_line 测量;仿真中断路器初始闭合,
3. 在 t=2 周期开断、t=8 周期重合,采用连续仿真并自动配置求解器,
4. 输出 I_load、V_line 波形及简要说明。
系统模型:
仿真结果曲线:
# 示例 2:生成电气模型库
输入提示词:
请严格按照已配置的 skill 执行,创建一个电气模型库,包含电压源、电流源、电阻、电容等电气组件。库应支持灵活的电气回路建模,允许用户根据需要自定义组件参数,并进行仿真分析。
系统模型:
# 常见问题
# 页面已打开,但一直连不上助手
请先确认本机助手进程是否已由 Sysplorer 或启动脚本拉起;若启用了连接令牌,还需确认页面侧配置与启动参数一致,同时检查端口占用与防火墙设置。
# 工具列表为空或长期处于断开状态
一般说明本机 MCP 配置未就绪,或相关服务未启动,可联系实施同事检查工具配置与健康检测策略。
# 嵌入 Sysplorer 的页面与系统浏览器打开的页面表现不一致
嵌入模式通常由宿主自动注入连接信息。独立浏览器模式若未完成额外配置,出现无法连接或安全策略限制属于预期差异。
# 附件无法上传或提示不支持
请检查文件大小、类型是否在允许范围内;部分模型或智能体组合也可能不支持某些附件类型。