SLX Studio

面向 MATLAB .m 与 Simulink .slx 的轻量编辑 / 运行工作台

写脚本、改模型、保存、运行；AI 和 Git 是辅助能力，不是主界面。

English · 安装 · 5 分钟工作流 · CLI · m-文件编辑器 · slx-图形编辑器 · 桌面版 · AI

状态：2.0.0 正式版。 SLX Studio 是轻量的 Model + Code + Simulation-first IDE：提供 Electron/TypeScript/Monaco 编辑、静态 .slx 检查、持久 MATLAB Command Window 与脚本 Job、增量输出、诊断、Figure、Workspace 状态、受校验的模型编辑、隔离仿真和可信首方扩展主机。执行 .m、创建/修改/仿真真实 .slx 仍需要本机 MATLAB/Simulink。

分支与版本关系

• main 是当前默认、稳定的 2.0.0 主线；评审和新开发都应从这里开始。
• v2.0.0 Release 是对应的正式发布版本，包含 Windows、Python wheel 和源码资产。
• v1.0.0-beta.2 / v1.0.0-beta.3 是保留的历史版本 tag，用于复现旧版行为，不代表当前默认分支。
• codex/slx-studio-2-foundation 是已经完成合并的 2.0 集成分支；其功能通过 PR #21 进入 main，不应被误认为尚未发布的替代主线。CLI patch 校验修复已通过 PR #9 合并。

迁移要点： 更新到 main 或下载 v2.0.0；原有 slx-diff CLI 和 slx-studio / slx-diff studio 旧版 Workbench 入口继续保留。新 Electron 桌面从 Windows 发布包或 npm run desktop -- <workspace> 启动，执行与仿真仍需本机 MATLAB/Simulink。完整步骤和边界见中英文迁移说明。

产品定位

2.0 产品方向： 将 SLX Studio 定位为面向 MATLAB / Simulink / 控制工程的 Model + Code + Simulation-first IDE。采用 Electron + TypeScript + Monaco 工作台， 保留轻量 Python 工程核心与扩展机制；不承诺兼容 VS Code 插件，也不复制完整 MATLAB Desktop。 具体范围见 2.0 项目目标 与 迁移顺序、资源预算和验收标准。 独立的 2.0 桌面 已具备经过真实 Electron 本地验收的 Monaco 编辑闭环，包含静态模型视口、持久 MATLAB 运行、模型编辑/仿真和首方扩展。

SLX Studio 不试图复制完整 MATLAB Desktop。它专门解决更轻量、频繁的工程循环：

工程文件夹
├── controller.m   → 编辑 → 保存 → 运行 → Console + 变量
└── controller.slx → 图形编辑 → 保存 → 仿真

同一个工作区在代码与框图之间切换，AI / Git 工具保留，但不抢占主流程。

安装

环境要求

• Python 3.10 或更高版本。
• 没有 MATLAB 也可以进行静态 .slx 查看、Diff 和 Review。
• 运行 .m、创建/编辑真实 .slx 以及仿真需要本机 MATLAB + Simulink。2.0.0 主要用 MATLAB R2026a 验证。
• Windows 用户可以直接使用打包后的 EXE，不需要另装 Python；运行脚本和写入真实模型仍需要 MATLAB/Simulink。

从源码安装

在仓库根目录执行：

python -m pip install --upgrade pip
pip install -e .

需要桌面 WebView 时，再安装可选依赖：

python -m pip install -e ".[desktop]"

参与开发或运行测试时安装开发依赖：

python -m pip install -e ".[dev]"

配置 MATLAB（可选）

MATLAB 的查找顺序是：命令行 --matlab、环境变量 SLX_DIFF_MATLAB、系统 PATH 中的 matlab。

$env:SLX_DIFF_MATLAB = 'C:\Program Files\MATLAB\R2026a\bin\matlab.exe'
slx-diff matlab-status

也可以只对本次启动指定路径：

slx-studio . --matlab 'C:\Program Files\MATLAB\R2026a\bin\matlab.exe'

没有 MATLAB 时，inspect、diff、review、context、view 和 html 仍可用，因为它们只使用不执行代码的静态解析器。

5 分钟工作流

1. 打开工程目录：slx-studio .（或 slx-diff studio .）。
2. 打开 .m 标签页，按 Ctrl/Cmd+S 保存，再按 F5 通过 MATLAB 运行。
3. 用 Ctrl/Cmd+Enter 运行当前 %% Section 或选中代码，在 Console、Workspace Variables 和 Plots 中检查结果。
4. 打开 .slx，拖动 Block、修改公开参数，或从输出端口拖到输入端口创建连接。点击 Apply in MATLAB 才会写入真实模型。
5. 运行仿真或打开 Sweep；使用 Shift+F5 停止运行中的脚本、仿真或扫描。

Workbench 默认使用项目目录之外的临时 MATLAB Workspace checkpoint，关闭后清理。也可通过 --matlab-session persistent 启用常驻共享会话，详见配置与限制。

CLI 命令速查

完整参数请运行 slx-diff --help 或 slx-diff COMMAND --help。

最简单的启动方式仍然是：

slx-studio .

也可以直接打开已知文件：

slx-studio controller.m
slx-studio controller.slx

原工程 CLI 继续保留：

slx-diff --version
slx-diff diff before.slx after.slx

.m 文件编辑器

.m 编辑器已经形成“编辑 → 运行 → 检查 → 再迭代”闭环：

• 多文件标签页与未保存状态提示；
• 行号与轻量 MATLAB 语法高亮；
• Ctrl/Cmd+S 保存、Ctrl/Cmd+Shift+S 另存为、F5 运行整个文件；
• Ctrl/Cmd+Enter 运行当前 %% Section 或选中代码，报错行仍映射回原脚本；
• .m 使用真实后台 MATLAB Job，可通过 Stop 终止；
• 编辑器 Undo / Redo 与 MATLAB 报错行自动定位；
• stdout / stderr Console 与 Workspace Variables；
• MATLAB 风格 Command Window (>>)，支持默认 checkpoint 模式和可选常驻 MATLAB worker；
• Workspace 变量可双击，用明确 MATLAB 表达式修改；
• 未保存 .m 会自动写入项目外的恢复草稿，异常退出后可恢复；
• MATLAB Figure 运行后直接回传并显示在 Plots 面板；
• Ctrl/Cmd+P Quick Open，以及 Ctrl/Cmd+Shift+F 同时搜索 .m 文本和静态 .slx Block/参数/信号。

controller.m *        analysis.m
────────────────────────────────────
  1  clear; clc
  2  Kp = 2.5;
  3  t = 0:0.01:5;
  4  y = 1-exp(-Kp*t);

Console                       Workspace Variables
MATLAB run complete           Kp  2.5   double 1x1
                              t   …     double 1x501
                              y   …     double 1x501

运行 .m 始终是用户主动操作。接入 DeepSeek/Kimi/OpenAI 等 API，不会自动把任意 MATLAB 代码执行权交给 AI。

.slx 图形编辑器

没有 MATLAB 时可以轻量解析/查看 .slx；检测到本机 MATLAB/Simulink 后，同一画布进入真实编辑模式。

传统 Workbench 图形交互

• 点击 Block，在 Inspector 修改参数；
• 直接拖动 Block，保存后真实 Simulink Position 同步变化；
• 拖动 Block 时信号线实时跟随；
• 根据已有连接显示明确的多输入/多输出端口，并支持从指定输出端口拖到指定输入端口创建 Connection；
• 可搜索 Block Palette；
• 新增、重命名、删除 Block；
• 删除信号连接；
• Save Model / Run Simulation；
• 结构修改和参数修改进入同一套 SLX Undo / Redo。

新增 概览 面板：选中模块前即可看到静态模型清单，包括文件/压缩包大小、系统数、模块数、连接数、暴露参数数、模块类型统计、SHA-256 和解析提示。实时 Workbench 会在当前会话复用未变化模型的解析结果；对于特别大的子系统，画布会透明地限制首屏渲染数量以保持流畅，可用系统选择器或模块搜索查看完整图结构。

SLX 历史记录使用临时模型快照 + SHA-256 冲突检查。如果模型被外部 MATLAB 或其他程序改过，旧 Undo 会拒绝覆盖，而不是强行回滚外部修改。

为什么不直接改 SLX 内部 XML

真实写入仍交给 MATLAB/Simulink 标准程序化接口：

set_param     add_block      delete_block
add_line      delete_line    save_system
sim

SLX Studio 负责轻量 UI、编辑意图和冲突保护；MATLAB 负责真实 .slx 序列化与执行。这样比浏览器自己伪造 SLX ZIP/XML 更可靠。

当前 Block Palette

首批安全目录包含 Inport、Outport、Step、Constant、Gain、Sum、Saturation、Integrator、Discrete-Time Integrator、Transfer Function、Unit Delay、Mux、Scope、To Workspace 等常用模块。后续通过 catalog 扩展，而不是把所有逻辑写死在前端。

运行、图形、扫参与工程导航

Workbench 加入了一组更像工程 IDE 的高频操作：

Ctrl+Enter       运行当前 %% Section / 选中代码
F5               运行当前 .m
Shift+F5         停止当前 .m / SLX / Sweep MATLAB Job
Ctrl+Shift+P     Command Palette
Ctrl+P           Quick Open
Ctrl+Shift+F     搜索 .m 文本 + .slx Block/参数/信号
Ctrl+Shift+S     另存为

.m 执行结束后会捕获 MATLAB Figure 并显示在 Workbench。.slx 仿真则会从支持的数值 timeseries / Simulink.SimulationData.Dataset 中提取有界曲线数据，在本地 Plots 面板绘制。

项目树使用会话级后台索引，只收集可见的 .m / .slx 文件。首次打开时索引在后台建立，文件写入后自动失效并重建，工具栏的刷新按钮可以强制重建。项目搜索复用同一索引，并按需缓存可搜索的模型元数据，重复查询不会反复解析未变化的 .slx 文件。该功能不引入数据库或额外运行时依赖。

Command Window 与共享 Workspace

默认 batch 模式下，脚本、Section、Command Window 命令和变量编辑共享临时 Workspace checkpoint。使用 slx-studio . --matlab-session persistent 后，它们改为复用同一个独立 MATLAB worker，无需每次保存/恢复 MAT 文件。停止或超时会丢失内存状态；图形化 SLX 仿真和扫描仍是独立 batch 操作。这是可选的轻量运行模式，不增加运行时依赖；详见配置、验证与限制。

运行 controller.m       → Kp = 2.5
Command: Kp = 3         → Kp = 3
双击变量把 Kp 改成 4    → Kp = 4
再运行下一节             → 能看到 Kp = 4

Parameter Sweep 参数扫描

在 SLX 中选中模块后打开 Sweep，可以输入 1:0.5:5、3:1 或逗号列表。Studio 会后台执行多次仿真，结束后恢复原参数，不把扫描值偷偷保存到模型，并返回多曲线叠加和轻量指标。

Controller/Kp · Gain
1 : 0.5 : 5
      ↓
9 次仿真
      ↓
多条响应曲线 + final / max / RMS / settling estimate

这些 Sweep 指标用于快速工程迭代，不等同于正式稳定性或安全验证。

新建文件

Workbench 顶部可以：

新建 .m    → 新建并编辑 MATLAB 脚本
新建 .slx  → 调本机 MATLAB 创建真实空白 Simulink 模型

空白 .slx 可以手工搭建，也可以让可选 AI 先生成经过校验的 Blueprint，再由用户决定是否真正构建。

桌面版与 EXE

安装桌面依赖：

pip install -e ".[desktop]"
slx-studio

有 pywebview 时优先打开桌面 WebView，没有时可回退到浏览器。

仓库中的 .github/workflows/build-windows.yml 已配置为在版本 tag 上通过 windows-latest 同时构建便携版和安装版：

SLXStudio.exe
SLX-Studio-Setup-x64.exe

安装器是当前用户级安装，并把桌面快捷方式、.m / .slx 文件关联设计成用户主动勾选，不会静默抢占文件关联。两种 Windows 构建都不要求用户另装 Python；真实 .m 运行、.slx 写入和仿真仍需要 MATLAB/Simulink。

可选 AI 助手

AI 是助手层，不是工作台本身。当前内置 BYOK Provider 包括 OpenAI、DeepSeek、Kimi/月之暗面、MiniMax、GLM/智谱、Qwen/阿里云百炼，以及自定义 OpenAI-compatible endpoint。

对 SLX，Agent 使用结构化模型工具和校验后的 Blueprint，而不是默认获得任意 MATLAB Shell。外部程序可以使用 docs/agent-api.md 中的本地 REST API。

可选 Git / Review 工具

原来的 slx-diff 能力继续保留：

slx-diff diff before.slx after.slx
slx-diff review before.slx after.slx
slx-diff context before.slx after.slx
slx-diff git-diff --base main --head HEAD

这些能力可以在不启动 MATLAB 的情况下给出 Block / Parameter / Connection 语义差异、静态影响路径和紧凑 AI Context。

架构

┌────────────────────────────────────────────┐
│              SLX Studio Workbench          │
│                                            │
│ 项目树       .m 多标签        .slx 画布     │
│              编辑器           Inspector     │
│              Console          Block Palette │
│              Variables        Undo / Redo   │
└────────────────┬──────────────────┬────────┘
                 │                  │
              文本保存/运行       结构化编辑
                 │                  │
                 └────────┬─────────┘