# 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 自带版本),并已配置相关模型;
  • 已经完成一次同元账号登录。

完成准备后,按以下步骤切换为本地客户端。

  1. 进入全局配置路径 C:\Users\用户名\.config\opencode

  2. 找到 opencode-mworks.json 文件,并将其重命名为 opencode-mworks.json.bak

    opencode-mworks.json是 MWORKS AI 默认添加的配置文件。opencode 启动时会优先读取该文件中的配置,将文件名增加 .bak 后,系统将不再识别它为有效配置文件,从而回退到 opencode 的默认配置,并切换为本地 opencode 客户端。

  3. 重启 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 的页面与系统浏览器打开的页面表现不一致

嵌入模式通常由宿主自动注入连接信息。独立浏览器模式若未完成额外配置,出现无法连接或安全策略限制属于预期差异。

# 附件无法上传或提示不支持

请检查文件大小、类型是否在允许范围内;部分模型或智能体组合也可能不支持某些附件类型。