dsh-matlab
IdentifiedAdds the MathWorks MATLAB Agentic Toolkit skills and the MATLAB MCP Server tools to DeepSeek Harness. Needs a local MATLAB R2021a or later. By default (autoProvision) it downloads the MathWorks MCP Se
dsh-plugin-matlab
把 MathWorks 官方的 MATLAB 能力接进 DeepSeek Harness 与 DSH Desktop:
- MATLAB MCP Server 工具 —
evaluate_matlab_code、run_matlab_file、run_matlab_test_file、check_matlab_code、detect_matlab_toolboxes,以及两个guidelines://资源; - MATLAB Agentic Toolkit 技能 — 24 个技能组、158 个
SKILL.md(按组按需加载); - 若本机同时装了 Simulink Agentic Toolkit,其技能组与
--extension-file工具扩展也会一并接入。
插件本身不实现任何 MATLAB 能力。它只做三件连接性的事:找到 MathWorks 的二进制与技能目录,校验它能跑通(一次 MCP 握手),挂载 DSH 自带的两个传输层(MCP 桥、技能目录提供方)。工具与技能内容全部是 MathWorks 原件,不复制、不改写、不重新打包。
前置与默认行为(与 DSH 商店条目一致):需要本机 MATLAB R2021a 或更新;默认
autoProvision: true,首次使用时下载 MathWorks MCP Server 并安装 Agentic Toolkit 的最新 Release(不 clone 仓库,也不需要本机有git);MathWorks 遥测默认关闭(只有把disableTelemetry设为false才开启)。
设计与取舍见 DESIGN.md。命令与字段速查见下文。商店提交材料(条目 YAML、PR 文案)见 docs/STORE.md。

它怎么工作
┌──────────────────────── DSH 侧(已有) ───────────────────────┐
MathWorks 侧 │ │
┌───────────────┐ │ @deepseek-ai/dsh-mcp-client → mcp__matlab__<tool> │
│ matlab-mcp- │──┼─▶ stdio 子进程,原样透传 MATLAB CLI 参数 │
│ server(.exe) │ │ │
└───────────────┘ │ @deepseek-ai/dsh-skill-filesystem → 会话技能目录 │
┌───────────────┐ │ customSkillDirs = <toolkit>/skills-catalog/<group> │
│ <toolkit>/ │──┘ │
│ skills-catalog│ │
└───────────────┘ 本插件只负责:发现 → 探测 → 组装这两份配置并挂载 │
这一点和 MathWorks 自己给 Amp 的接法完全一致(amp.skills.path 指向 skills-catalog/<group>),也就是同一个“原生指向”:技能组目录就是根,二进制就是二进制。
环境要求
| 依赖 | 说明 |
|---|---|
| MATLAB R2021a 或更新 | 需已在系统上安装;插件按 环境变量 → PATH → 注册表 → 安装目录 自动找 |
| MATLAB MCP Server | v0.16.0 起验证;二进制与工具包都由插件装在 $DSH_HOME/matlab,缺失时自动下载;下载的二进制按 GitHub 公布的 sha256 校验,不一致拒绝安装 |
| MATLAB Agentic Toolkit | 由插件把最新 Release 的源码包解压到 $DSH_HOME/matlab/toolkits(不读取 ~/.matlab/agentic-toolkits,不 clone 仓库) |
| DSH | 需要 profile 中已组合 @deepseek-ai/dsh-mcp-client 与 @deepseek-ai/dsh-skill-filesystem(base bundle 自带) |
依赖只属于插件自己:$DSH_HOME/matlab 是唯一的存放位置。机器上 ~/.matlab/agentic-toolkits 里的副本(MathWorks 安装器装的)不会被读取或复用,所以同一个 MATLAB 不会在 DSH 里出现两份版本不一致的二进制或技能。
唯一值得在 MATLAB 里做的一步是可选的共享会话:
shareMATLABSession() % 让 DSH 接管你正在用的 MATLAB 会话
安装
装完请重启 DSH。 插件代码只在 DSH Host 启动时载入,
pnpm add只把包装进 profile;不重启的话,设置页里的 MATLAB 一页、进度对话框和mcp__matlab__*工具都要等到下一次启动才出现。重启之后首次激活会在后台准备依赖(见“首次下载”)。
本包目前未发布到 npm,因此按本地 checkout 安装。DSH Desktop 与 dsh 都支持从本地路径安装插件。
方式一:装进当前 profile(推荐)
git clone git@gitee.com:xuyuntao/dsh-matlab.git
cd <profile 目录> # 例如 ~/.dsh/profiles/desktop
pnpm add file:/path/to/dsh-matlab
然后在 profile 的 cordis.patch.yml 里加入(cordis.patch.yml 也可作为 bundle 层自动插入,见方式二):
- insert:
- id: matlab-agentic
name: 'dsh-plugin-matlab'
重启 Host,或让 loader 重载该条目。桌面端也可以在“插件”页确认 matlab-agentic 已启用。
方式二:作为 bundle 层
package.json 已声明 dsh.bundle.patch,cordis.patch.yml 会插入 matlab-agentic 这一行。把本包加入 profile 的 dsh.profile.bundles 后,在桌面端“插件”页开关它即可;发布到 npm 之后 dsh plugin --profile desktop add dsh-plugin-matlab 也能直接生效。
另一种:直接改 profile 的依赖
# profile 的 package.json
"dependencies": { "dsh-plugin-matlab": "file:../../path/to/dsh-matlab" }
再 pnpm install,效果同上。
配置
全部字段都可在 profile 的 cordis.patch.yml 中覆盖;带 volatile 的字段同时出现在设置 → MATLAB 页面里,保存后立即生效(见下节)。
- id: matlab-agentic
config:
matlabRoot: 'C:\Program Files\MATLAB\R2025b'
skillGroups: [matlab-core, signal-processing]
sessionMode: auto
| 字段 | 默认 | 作用 |
|---|---|---|
serverName | matlab | 工具前缀,最终形如 mcp__matlab__evaluate_matlab_code |
toolCallTimeoutMs | 600000 | 单次 MATLAB 调用上限;仿真/测试套件很慢,故默认 10 分钟 |
failOnStartupError | false | 为 true 时连接失败会让插件激活失败,而不是仅告警 |
matlabRoot | 自动 | 传给 --matlab-root;留空则按 环境变量 → PATH → 注册表 → 安装目录 顺序发现 |
sessionMode | auto | auto 优先接管已 shareMATLABSession() 的会话,否则新开;new 总是新开;existing 只接管 |
displayMode | desktop | nodesktop 表示不弹 MATLAB 桌面 |
initialWorkingFolder | DSH 工作目录 | MATLAB 启动目录 |
useWorkspaceFolder | false | 勾选后忽略 initialWorkingFolder:每次调用 evaluate_matlab_code 时用该对话的工作区(项目)目录作为 MATLAB 当前文件夹(设置页“起始目录”上方开关) |
initializeMatlabOnStartup | false | 为 true 时 MCP 服务一启动就拉起 MATLAB |
disableTelemetry | true | 透传 --disable-telemetry=true;默认关闭遥测 |
mcpServerPath | 自动 | 指定 matlab-mcp-server 可执行文件;留空则发现或下载 |
autoProvision | true | 缺失时下载二进制、安装 MATLAB 工具包的最新 Release |
githubProxy | 空(沿用 DSH) | GitHub 加速前缀,例如 https://gh-proxy.com;留空则沿用 DSH 已配置的加速(DSHM_GITHUB_PROXY,或 DSH 市场“GitHub 加速”里的自定义前缀) |
downloadRegion | auto | auto 跟随 DSH 市场选定的区域;china 强制中国区线路;global 直连。见下文“首次下载” |
provisionTimeoutMs | 300000 | 单次首次准备(下载二进制或安装工具包)的总预算;它只约束后台任务,不占用启动 |
provisionWaitMs | 0 | 激活最多等首次准备多久(毫秒)。0 表示完全不阻塞启动,准备完成后自动挂载 |
agentName | DeepSeek | MATLAB 命令窗口里显示的 Agent 名(单行、≤ 80 字符) |
toolkitRoots | [] | 额外/替代的工具包目录;给定时优先。指向你自己的副本时,插件不会把它当成可更新/可替换的安装 |
skillGroups | [](全部) | 要加载的技能组;留空或 ['*'] 加载全部组(MATLAB 工具包为 24 组 / 158 个技能),列出组名则只加载这些组 |
extensionFiles | [] | 额外 MCP 工具定义文件(Simulink 工具包的 tools/tools.json 会自动带上) |
watchSkills | true | 工具包变更时热更新技能目录 |
probe / probeTimeoutMs | true / 20000 | 连接前做一次 MCP 握手探测 |
statusRoute | true | 提供 GET /plugin/matlab/status |
设置页与依赖进度对话框
插件自带 Web 界面(纯 ESM 客户端模块,无构建步骤):
- 设置 → MATLAB(侧栏设置面板里的一页):连接状态(阶段、插件版本、MATLAB 根、MCP Server 路径、实际线路、探测到的工具数);依赖(一张三列表:模块 / 本地 Tag / 最新 Tag,加三个按钮:检查更新、下载最新依赖、清空本地依赖);技能组开关(可上下滚动的两列列表:组名 + 技能数;默认全选,全部勾选时保存为“全部”,将来新增的组自动纳入;标“必需”的组锁定为已选,不能关闭);MATLAB 启动参数(根目录、启动方式与会话模式为单行单选、“使用当前对话的工作区目录作为起始目录”开关、起始目录(开关勾选时禁用)、启动即拉起、遥测默认关闭);MCP Server(可执行文件路径、命名空间、调用超时);依赖下载(加速前缀、下载区域为单行单选、预算、启动等待、监视工具包)。保存 / 放弃修改固定在页面底部,滚动到任何位置都能看到。
- 右下角进度对话框:首次准备、或缺口被补齐时出现,显示“正在下载工具包发布包 / 正在下载二进制”、字节进度(镜像声明长度时是确定进度,否则流动条)、当前线路;可以关掉(后台继续),失败可重试。它只是提示,不挡住应用。
设置保存后立即生效:页面通过 DSH 的 settings 服务写入 profile 补丁,DSH 把 volatile 变更提交给运行中的插件,插件收到 loader/volatile-update 后重新挂载受影响的部分(技能目录、MCP 桥)。直接在 cordis.patch.yml 里改这些字段效果相同。
页面读取的是已保存的配置,不是“上一次挂载时的快照”。DSH 提交 volatile 字段后,重新挂载在 120 ms 后才发生;如果保存后立刻重读旧快照,控件会弹回修改前的值(例如关掉的技能组又被勾上),而下次进入页面才显示真实配置。1.1.9 起状态路由直接读 DSH 就地更新的配置引用,所以保存返回时控件就显示真实配置,全部字段(技能组、开关、下拉框、文本框)一起生效。
页面只是同一份配置的另一种写法:schema 仍是校验者,非 volatile 字段不能在页面保存(返回 400),revision 冲突(另一个窗口先改过)返回 409,页面随后重新载入。
为什么没有“安装完成时”就下载
DSH 在插件第一次被加载之前不会运行它的任何代码,所以“安装完成钩子”在这个框架里不存在:pnpm add 只是把包装进 profile,进程里还没有这个插件可以监听事件。最早能检查依赖的时机是首次激活——安装后的第一次启动;那一刻插件已经在后台开始获取并弹出进度对话框,启动本身不被阻塞。
依赖:检查、下载、清空
设置页里只有一张“依赖”卡片(原来的“更新依赖”和“维护”已合并)。它是一张三列表:模块 / 本地 Tag / 最新 Tag。本地列在进入页面时就有——MCP Server 用 --version 里的 Tag,工具包用安装目录里 .dsh-matlab-release.json 记录的 Release Tag(只显示 Tag 本身,不带仓库前缀);缺失写“未安装”,无法判断写“未知”。最新列在检查之前写“未检查”,检查之后无论与本地是否相同都给出官方最新 Tag。
三个按钮:
- 检查更新(只读两次很小的探测,不下载):两者都看 GitHub 的
releases/latest;某条线路拒绝或限流 API 时,退到发布页本身(页面og:url里的 tag 就是releases/latest指向的那个)。两条探测都走最先可用的加速线路。 - 下载最新依赖:只有在“本地缺失(任一产物没装)”或“检查后发现官方 Tag 与本地不同”时才可点击。点击后先停掉正在运行的 MCP 桥与技能目录(Windows 不允许替换正在运行的 exe,技能监视器也不该看着目录被重写),清空插件自己的那两份产物,再重新下载并挂载最新 Release;进度对话框照常显示。工具包先解压到
*.incoming,完整解压成功才就位,二进制是“临时文件 + 原子改名”,且下载过程中边写边算 SHA-256,与 GitHub 公布的 Release 资产摘要不一致就拒绝安装(见下文“下载的文件经过校验”)。 - 清空本地依赖:删除插件自己安装的 MCP Server 与 Agentic Toolkit(
$DSH_HOME/matlab下的副本),点击后弹出二次确认,确认才真正删除。删除只动插件自己的文件:你的 MATLAB 安装、mcpServerPath、toolkitRoots指向的目录都不会被碰。删除后 MATLAB 工具与技能不可用,需要重新下载。
工具包的版本就是它自己的 Release Tag(MATK-2026.11.a),记录在安装目录里的 .dsh-matlab-release.json,所以“有更新”是 Tag 不相等,而不是“远端 HEAD 变了”。用 toolkitRoots 指向的工具包不会被比较、也不会被替换或删除:那是用户的目录,不是插件的安装。MCP Server 是 semver 比较(v0.16.0 < v0.17.0),不会因为镜像晚同步而“降级”。
首次下载:沿用 DSH 的 GitHub 加速
首次启动(本机还没有二进制与工具包)时,插件要从 GitHub 取两样东西:MATLAB MCP Server 的 Release 资产(v0.16.0 为 19.9 MB)与 Agentic Toolkit 最新 Release 的源码包(MATK-2026.11.a 为 3.4 MB,1433 个文件)。这两样在中国大陆直连都很慢——2026-11-10 本机实测 7 KB/s,同一时刻经公共前缀是 250 KB/s(约 36 倍),直连下载会让 DSH 启动阶段停留几十分钟,表现为“启动保护/恢复助手”而不是可用界面。
插件因此不自带代理,也不钉死某个镜像,而是沿用 DSH 已经选好的线路:
githubProxy(本插件的配置,最具体);DSHM_GITHUB_PROXY(运维在环境里设置的覆盖值);- 当前 profile 的
.dsh-market/state.json——DSH 市场“GitHub 加速”保存的自定义前缀与下载区域; - 区域:
downloadRegion→ 市场记录的region→global。中国区线路表是gh-proxy.com→ghfast.top→ 直连。
比“快”更硬的要求是不能占用启动:DSH Desktop 在宿主机 60 秒内没启动完成时会直接判失败——2026-11-10 本机日志里就是 Host startup exceeded 60 seconds,而那一刻插件正卡在首次下载上;即便走加速线路,首次准备也可能要 1~2 分钟,仍然超预算。所以首次获取被放到后台:激活只发现本地已有产物(毫秒级返回),缺失的部分在后台下载,完成后自动挂载技能与 MCP 桥,启动不再等网络。
matlab-agentic: github: gh-proxy.com -> ghfast.top -> direct (region china from market)
matlab-agentic: no MATLAB Agentic Toolkit found; downloading the newest release in the background so the fetch cannot hold up startup
matlab-agentic: the MATLAB MCP Server binary is missing; downloading it in the background so the fetch cannot hold up startup
此时 status.phase 是 provisioning;后台完成后变成 ready,日志接着出现 extracted … from matlab/matlab-agentic-toolkit MATK-2026.11.a via gh-proxy.com、installed …、connected; tools appear as mcp__matlab__<tool>。想“启动即等到准备好”就调 provisionWaitMs,但请留在 60 秒以内:
- id: matlab-agentic
config:
provisionWaitMs: 30000 # 最多等 30 秒;没完成的部分继续在后台跑
前缀的用法与公共反代一致:把完整目标 URL 放进路径(https://gh-proxy.com/https://github.com/...)。工具包的 archive/refs/tags/<tag>.tar.gz 与二进制的 releases/latest/download/... 走同一串线路(DSH 市场的 git 线路把直连放首位,因为它只读 ref 广告;这里搬的是几 MB 的包体,所以把加速线路放前面)。每条线路都以直连收尾:镜像挂了应该退化成“慢”,而不是“启动不了”。
实际走了哪条线路,日志与状态路由都会写明:
matlab-agentic: downloading https://gh-proxy.com/https://github.com/matlab/matlab-agentic-toolkit/archive/refs/tags/MATK-2026.11.a.tar.gz
matlab-agentic: extracting 1433 file(s) from matlab/matlab-agentic-toolkit MATK-2026.11.a
matlab-agentic: downloading https://gh-proxy.com/https://github.com/matlab/matlab-mcp-server/releases/download/v0.16.0/matlab-mcp-server-windows-x64.exe
matlab-agentic: installed …\.dsh\matlab\bin\matlab-mcp-server.exe (19905376 bytes via gh-proxy.com; sha256 7c70fdc6…d1883ea)
"github": { "region": "china", "regionSource": "market", "proxy": null, "proxySource": "none",
"routes": ["gh-proxy.com", "ghfast.top", "direct"] },
"server": { "path": "…\\matlab-mcp-server.exe", "source": "download", "downloaded": true,
"route": "gh-proxy.com", "tag": "v0.16.0", "verified": true }
显式指定线路(profile 的 cordis.patch.yml):
- id: matlab-agentic
config:
githubProxy: https://gh-proxy.com # 自定义或固定一条前缀
# downloadRegion: china # 没有 DSH 市场(例如纯 CLI profile)时可强制区域
# provisionTimeoutMs: 600000 # 线路较慢时放宽单次首次准备的预算
预算是硬边界:单次首次准备默认 300 秒,每条线路另有“无数据 30 秒即放弃”的看门狗;解压本身就发生在同一次预算里。一条坏线路最多浪费几十秒,不会把启动拖成“打不开”。
前缀只接受 https://、不含凭据与查询串——下载的是随后要执行的程序,明文或可改写的线路等于允许中间人替换它。环境变量里的值不合法时只在日志告警并忽略(那是运维的设置,不是本插件的配置);githubProxy 配置不合法会直接激活失败,并给出可用的写法。前缀只影响“从哪里搬字节”,不决定“字节是否可信”:可信性由下一节的摘要校验兜底。
下载的文件经过校验
下载来的二进制会被执行,所以它不能只靠“看起来像程序”:
- Release 资产摘要:GitHub 的 Release API 为每个资产公布
sha256:<hex>。插件在下载前读取摘要,下载过程中边写临时文件边算 SHA-256,不一致就删掉临时文件、拒绝安装,并换下一条线路;全部线路都对不上才报错。摘要优先直连api.github.com读取(不经加速前缀)——镜像可以送包体,但不该同时是“证明包体没被换过”的唯一来源;直连 API 不可达时才退回加速线路读取,并在日志里注明摘要来自镜像(仍能发现截断与损坏,但弱于直连)。 - 完整性:Release 公布的字节数与实际收到的字节数不一致(截断)同样拒绝;没有摘要可查时,响应声明的
content-length也会核对。 - 工具包压缩包:GitHub 对按 tag 动态生成的源码包不提供
digest,所以校验的是“这份包完整且结构正确”:content-length与实际字节数一致、gzip CRC、tar 头校验和、拒绝绝对路径 /../ 越界符号链接;解压只写空的*.incoming,完整成功后才替换旧目录。 - 摘要不可得时:如果连 API 都读不到(例如网络只放行下载、封了 API),安装仍会继续,并在日志里写明“本次未校验”;不会因为校验服务不可达而让用户失去 MATLAB 工具。
实测(v0.16.0,经 gh-proxy.com,2026-11-11):19905376 bytes ... sha256 7c70fdc6…d1883ea,与 GitHub Release API 公布的值一致;改掉其中任意一个字节后安装被拒绝。
MATLAB 里显示的 Agent 名
MATLAB 通过 MCP 连接时会在命令窗口打印一句话(桌面标题另加一个固定后缀 | Agent Connected,不含这个名字):
DeepSeek is connected to MATLAB via the MATLAB MCP server.
Now you can use DeepSeek to work with MATLAB.
这个名字来自 MCP initialize 请求里的 clientInfo:MATLAB MCP Server 优先用 clientInfo.title,没有标题才退回 clientInfo.name(见 MathWorks 源码 connectionindicator.clientName)。DSH 的 @deepseek-ai/dsh-mcp-client 把 name 写死成 dsh-mcp-client 且不发标题,也没有对应配置项,所以插件在 stdio 之间放了一个只改这一条消息的小桥:
lib/mcp-bridge.js启动真正的matlab-mcp-server,把服务端输出原样转发,只在客户端发来的initialize里补上params.clientInfo.title = agentName;其他任何帧都逐字节透传。- 启动探测(
probe.js)也走同一个桥,所以无论“先探测还是先连接”触发了 MATLAB 的欢迎语,显示的都是同一个名字。 - 桥由
process.execPath(宿主是 Electron 时加ELECTRON_RUN_AS_NODE=1)运行,因此不依赖 PATH 上有 node。
默认 agentName: DeepSeek;在 设置 → MATLAB → MCP Server → MATLAB 中显示的 Agent 名 里改,保存后立即重挂 MCP 桥,下一次连接(或下一个 MATLAB 会话)生效。填单行、80 字符以内;含控制字符会被拒绝,因为那会破坏 MATLAB 的显示。
实测(真实二进制 + 真实桥):服务端自己的日志记录 "msg":"New client session","client-name":"dsh-plugin-matlab","client-title":"DeepSeek"。
验证
-
重启后在对话里问:
本机 MATLAB 是什么版本?装了哪些 toolbox?模型应调用
mcp__matlab__detect_matlab_toolboxes。 -
看技能目录:默认全量(MATLAB 工具包 24 组 / 158 个技能),至少应能看到
matlab-core组里的 6 个(如matlab-create-live-script)。 -
直接读连接状态:
curl http://127.0.0.1:<port>/plugin/matlab/status{ "plugin": "dsh-plugin-matlab", "version": "1.0.1", "phase": "ready", "installer": { "configFound": true, "matlabRoot": "C:\\Program Files\\MATLAB\\R2023b" }, "server": { "path": "...\\bin\\matlab-mcp-server.exe", "version": "github.com/matlab/matlab-mcp-server v0.16.0" }, "probe": { "ok": true, "tools": ["check_matlab_code", "..."], "resources": ["guidelines://coding"] }, "skills": [{ "name": "matlab-core", "skills": 6 }] } -
打开 设置 → MATLAB:应能看到阶段、MATLAB 根、MCP Server 版本、实际线路、24 个技能组开关;改几个再保存,日志应出现
settings applied,技能目录随之变化(不需要重启)。 -
若启用了插件但本机还没有二进制/工具包:右下角会出现进度对话框,
status.phase为provisioning;准备完成后对话框提示就绪,工具与技能自动出现。 -
在 设置 → MATLAB → 依赖 点“检查更新”:三列表应给出本地 Tag 与官方最新 Tag(MCP Server 是
v0.16.0,工具包是MATK-2026.11.a;两者相同时最新列也会写出同一个 Tag)。“下载最新依赖”在本地完整且无更新时保持禁用;“清空本地依赖”会先弹确认,确认后两个产物都被删除,再点“下载最新依赖”应能把它们重新装回。
技能组:默认全部,可按需收窄
技能的选择单位是“组”(MathWorks 的 skills-catalog/<group>),不是单个文件——这与 MathWorks 给 Amp 的 amp.skills.path 完全一致。组名来自工具包的 manifest.yaml,也就是 skills-catalog/ 下的目录名。默认加载全部组;想省上下文再按组收窄。
最省事的是 设置 → MATLAB → 技能组:一个可上下滚动的两列列表,左列是组名、右列是技能数;点开关后保存即生效,不用重启。标“必需”的组(MATLAB 工具包的 matlab-core)勾选框已锁定为选中且禁用,点“全不选”也会保留它——厂商声明每个用户都需要它,页面与 Host 都不允许关闭。想写进配置就用下面三种写法(都在 profile 的 cordis.patch.yml 里覆盖 matlab-agentic 这一行):
# 1) 默认:加载全部组(MATLAB 工具包 24 组 / 158 个技能)
- id: matlab-agentic
# 2) 收窄:只加载列出的组
- id: matlab-agentic
config:
skillGroups: [matlab-core, signal-processing, wireless-communications]
# 3) 等价的显式全量写法
- id: matlab-agentic
config:
skillGroups: ['*']
全量的代价:技能目录常驻约 8,000 tokens(158 条 name + 描述,按 DSH 的 500 字符截断实测);只留 [matlab-core, signal-processing] 时约 1.6k tokens。技能越多,模型挑错技能的概率也越高,所以按领域收窄是省 token 的做法。
写错组名会直接激活失败,并在报错里列出所有可用组名(避免“静默少装”)。skillGroups 里即使漏写必需组,插件也会把它补回来:必需组是厂商的运行时前提,不是可选项。改完需要在插件页把该插件关掉再打开(或重启 DSH Desktop)。
各组一览(MATLAB 工具包,2026.11.a)
默认全部加载;下表用于收窄时挑选。(必需) 表示 MathWorks 在 manifest.yaml 里标记的 required 组。
| 组名 | 技能数 | 典型内容 |
|---|---|---|
matlab-core(必需) | 6 | 写/调试/审阅代码、Live Script、查文档、装产品 |
rf-and-mixed-signal | 21 | 天线、PCB、RF/AMS/SerDes 建模 |
automotive | 13 | RoadRunner 场景、驾驶数据、SUMO 协同仿真 |
test-and-measurement | 13 | DAQ、相机、Arduino、OPC UA、车载网络 |
signal-processing | 12 | 滤波器设计、频谱/时频分析、音频 |
matlab-software-development | 11 | 测试、性能与内存优化、打包 toolbox |
wireless-communications | 11 | 5G/WLAN/BLE/GNSS 波形、USRP |
ai-and-statistics | 10 | 训练网络、曲线拟合、可解释性、嵌入式 AI |
image-processing-and-computer-vision | 10 | 图像/体数据/点云、OCR、视觉检测 |
robotics-and-autonomous-systems | 6 | 运动规划、MAVLink、惯导融合、GNSS |
code-generation | 5 | 生成 C/GPU 代码、定点、部署 |
parallel-computing | 5 | parfor 诊断、集群、GPU、线程池 |
computational-finance | 4 | 组合优化、定价、Datafeed、Excel 链接 |
matlab-data-import-and-analysis | 4 | 导入导出、表格分析、大数据选型 |
radar | 4 | 雷达设计、波形、检测仿真 |
reporting-and-database-access | 4 | 报告生成、Database/DuckDB/Databricks |
computational-biology | 3 | SimBiology 建模/拟合/仿真 |
control-systems | 3 | 系统辨识、旋转机械/电池特征 |
math-and-optimization | 3 | 优化、PDE、符号计算 |
matlab-app-building | 3 | App、图表、主题 |
matlab-external-language-interfaces | 3 | 调 Python/Java、MEX 互操作复数 API |
aerospace | 2 | 坐标转换、大气/环境计算 |
cloud-solutions | 1 | MATLAB Drive 共享 |
matlab-programming | 1 | 函数参数校验 |
Simulink 工具包安装后会出现它自己的组(model-based-design-core 等 12 组),同样可以按名字挑选。
如果确实要“按单个技能”挑
DSH 的 filesystem provider 以目录为根(<root>/<name>/SKILL.md),所以单技能选择的做法是自建一个裁剪目录:里面用软链/目录联接指向想要的技能,再让插件把它当作工具包根。
# 例:只要 Live Script 和优化这两个技能
$src = "$env:USERPROFILE\.dsh\matlab\toolkits\matlab-agentic-toolkit\skills-catalog"
mkdir C:\matlab-skills\skills-catalog
New-Item -ItemType Junction -Path C:\matlab-skills\skills-catalog\matlab-create-live-script -Target "$src\matlab-core\matlab-create-live-script"
New-Item -ItemType Junction -Path C:\matlab-skills\skills-catalog\matlab-solve-optimization -Target "$src\math-and-optimization\matlab-solve-optimization"
- id: matlab-agentic
config:
toolkitRoots: ['C:\matlab-skills']
skillGroups: [matlab-create-live-script, matlab-solve-optimization]
此时“组名”就是技能名;由于默认就是“加载全部条目”,skillGroups 可以留空——裁剪目录本身就是你的选择清单。链接会被正常跟随(已覆盖测试)。
确认到底加载了什么
curl http://127.0.0.1:<port>/plugin/matlab/status
skills 数组会逐个列出 { name, path, skills },例如 {"name":"matlab-core","skills":6};全量选择时应为 24 项、合计 158。
依赖从哪来:只认 DSH 自己的目录
插件的依赖只有一处来源:$DSH_HOME/matlab(默认 ~/.dsh/matlab)。
| 路径 | 内容 |
|---|---|
$DSH_HOME/matlab/bin/matlab-mcp-server.exe | 从 GitHub Release 下载的 MCP Server |
$DSH_HOME/matlab/toolkits/matlab-agentic-toolkit/ | 从最新 Release 源码包解压的工具包,.dsh-matlab-release.json 记着它来自哪个 Tag |
$DSH_HOME/matlab/logs/ | MCP Server 与 MATLAB 的日志(--log-folder) |
这里没有的,就是没有:不存在“再看看 ~/.matlab/agentic-toolkits”这一步。这条规则让 DSH 里的版本与机器上别处的副本互不干扰,也让“缺了就下载、要更新就更新”有唯一答案。唯一例外是显式设置的 mcpServerPath(你明确指定的可执行文件)与 toolkitRoots(你明确指定的目录)——那是用户的选择,不是自动发现。
实测(全新 DSH_HOME、DSH 市场为中国区):激活 0.1 秒返回并把首次准备放到后台,后台经 gh-proxy.com 下载 19.9 MB 二进制 52 秒;工具包走同一个前缀下载 3.36 MB 源码包并解压 1433 个文件只用了 2.4 秒(单次 HTTP 响应,没有 git 往返);同一时刻直连 GitHub 只有约 7 KB/s,需要几十分钟。第二次启动不再联网,也不再有后台任务。逐项拆分如下:
| 能力 | 本插件 | 需要额外一步 |
|---|---|---|
| MATLAB MCP Server 二进制 | ✅ 自动下载官方 Release(19.9 MB,实测 v0.16.0,经加速线路 52 秒) | 离线/内网:手动下载后设 mcpServerPath |
5 个 MCP 工具 + 2 个 guidelines:// 资源 | ✅ 探测即通过 | — |
| 技能文件落地 | ✅ 自动安装官方工具包的最新 Release 源码包(24 组 / 158 个技能,实测 MATK-2026.11.a) | 离线/内网:手动解压后设 toolkitRoots |
| 技能挂载数量 | ✅ 默认全量:24 组 / 158 个(实测) | 想省 token 就在设置页收窄,或写 skillGroups |
复用你正在用的 MATLAB 会话(sessionMode: existing) | ❌ 需要 MATLAB 侧装 add-on | 跑一次 <DSH_HOME>/matlab/bin/matlab-mcp-server.exe --setup-matlab --matlab-root=<MATLAB根>,再在 MATLAB 里 shareMATLABSession() |
Simulink 技能与 tools/tools.json 工具扩展 | ❌ 不会自动安装 Simulink 工具包 | 自行解压后设 toolkitRoots(插件只从自己的目录读,不碰安装器那份) |
| 记住你在安装器里选的 MATLAB 版本 | ⚠️ 不读安装器记录,按 环境变量 → PATH → 注册表 → 最新安装目录 发现 | 多版本共存时显式设 matlabRoot |
| 遥测默认关闭 | ✅ 默认关闭(disableTelemetry: true) | 需要时在设置页取消勾选,或设 disableTelemetry: false |
| 依赖管理 | ✅ 设置页一张卡片:检查更新 / 下载最新依赖 / 清空本地依赖(按 Release Tag 比较,两侧都显示 Tag) | — |
| 二次启动 | ✅ 复用已下载的二进制与工具包,不再联网(实测 0 次下载) | — |
结论:MCP 与技能都能完全靠插件跑通,技能默认全量挂载(24 组 / 158 个);而“接管当前 MATLAB 会话”和“Simulink”这两条,仍然需要额外一步手动操作。
排错
| 现象 | 原因与处理 |
|---|---|
phase: "tools" 且日志 probe failed | 二进制能启动但握手失败:看 status.probe.stderr,多为 MATLAB 许可或 --matlab-root 指错 |
日志 matlabRoot does not exist | matlabRoot 指向已卸载版本;清空该字段让其重新发现 |
没有 mcp__matlab__* 工具 | profile 未组合 dsh-mcp-client,或 serverName 与他人冲突(同名实例互斥) |
| 技能目录里没有 MATLAB 技能 | 未找到工具包;在 设置 → MATLAB 的“依赖”卡片点“下载最新依赖”,或设 toolkitRoots |
首次启动没有 mcp__matlab__* 工具、status.phase 是 provisioning | 首次准备在后台进行中,约 1~2 分钟后自动挂载;看日志里 downloading … / extracted … 的进度。想启动即等到完成可设 provisionWaitMs(≤60 秒) |
| 设置页“依赖”里本地 Tag 显示“未知” | 该工具包不是本插件装的(旧版本 git clone 的副本,或 toolkitRoots 指向的目录),没有记录 Release Tag;前者点一次“下载最新依赖”就会换成带 Tag 的官方发布包 |
| 误点了“清空本地依赖” | 删除前必须再确认一次;确认后两个产物从 $DSH_HOME/matlab 移除,点“下载最新依赖”即可重新装回(mcpServerPath / toolkitRoots 指向的目录从未被删除) |
| Windows 下 MATLAB 起不来且无日志 | MATLAB 需要 WINDIR;插件已显式透传,若仍失败请检查启动器环境 |
| 首次启动卡在下载、最后进了恢复助手 | 直连 GitHub 在国内约 7 KB/s;先看日志里 github: … 一行用了哪条线路。把 DSH 市场的下载区域设为“中国区”,或设 githubProxy / DSHM_GITHUB_PROXY(见“首次下载”一节) |
| 下载失败(企业代理) | DSH 启动器会把 HTTPS_PROXY 应用到 fetch;纯 Node 环境下需 NODE_USE_ENV_PROXY=1。也可手动下载二进制后设 mcpServerPath |
日志出现 checksum mismatch 或 incomplete download | 加速线路返回的字节与 GitHub 公布的 sha256 / 字节数不一致(镜像缓存截断,或被替换)。插件已删掉临时文件、拒绝安装,并尝试下一条线路;换一条前缀重试,持续出现说明该镜像不可信。直连 api.github.com 读不到摘要时日志会写明“本次未校验” |
设置页保存报 not volatile / 400 | 只有 .volatile() 字段能从页面保存;其余字段请写进 cordis.patch.yml 后重启 |
设置页保存 / 检查更新 / 安装依赖报 HTTP 405 | 宿主进程还在运行升级前的 Host 代码(插件只在激活时载入)。重启 DSH 或重新加载插件即可;1.0.1 起写操作改走 carrier 的 handler,不再被框架的 GET/HEAD 规则拦下 |
| 设置页保存报 409 | 另一个窗口先改过同一份配置:页面会自动重新载入,确认后重试 |
| 设置页显示“没有 settings 服务” | 该 profile 未组合 DSH 的 settings(例如极简 CLI 组合);改 cordis.patch.yml 或在插件页用自动生成的表单 |
| 改了设置但技能没变 | 看日志有没有 settings applied;若仍在 provisioning,等后台准备完成后会自动重挂 |
安装时 pnpm 提示缺少 peer @deepseek-ai/* | 预期行为:这些包由 DSH 运行时的安装范围提供,不需要装进 profile |
开发
pnpm install # 只为开发:装 @deepseek-ai/cordis,用于激活契约测试
node --test # 170 个用例;插件本身无构建步骤、无运行时依赖
- 纯 ESM,
lib/即运行时,无需编译; - 四个
@deepseek-ai/*依赖都声明为 optional peer:它们由 DSH 安装本身提供,若声明成必需依赖,包管理器会去公共 registry 取(@deepseek-ai/schemastery在 npm 上会连带拉取未发布的 DSH 包而安装失败); - 与 MATLAB 有关的用例是真机集成:设置了
MATLAB_MCP_SERVER,或$DSH_HOME/matlab/bin/存在时,真的会拉起 MathWorks 服务做一次 MCP 握手,并逐个校验 158 个SKILL.md是否符合 DSH 的技能 frontmatter 规则;否则自动跳过; test/cordis-contract.integration.test.js用真实 Cordis 激活插件(只替换传输层),因为插件apply的返回值会被 Cordis 当作 effect 校验——这条契约出错时线上表现是TypeError: Invalid effect;- 客户端是手写的 ESM 模块(
client/client.js,调window.__ModuleLoader__.load),没有打包步骤:dsh.client只声明平台与激活顺序,React 由页面模块表提供,样式只用--dsw-alias-*主题变量;manifest见package.json的dsh.client; - 目录说明:
lib/activate.js— 绑定逻辑(发现 → 探测 → 挂载两个传输层;后台准备与按设置重挂)lib/api.js— 设置页与进度对话框用的 JSON 路由(/plugin/matlab/{state,progress,config,provision})client/client.js— 设置页(settings.section)与进度对话框(shell.overlay)lib/toolkit.js+lib/yaml-mini.js— 读 MathWorksmanifest.yaml(技能组、mcp-server-extensions)lib/matlab-root.js/lib/mcp-binary.js/lib/release.js— 发现与获取lib/integrity.js— 下载校验:Release 资产的 SHA-256、声明字节数与响应长度lib/github.js— 沿用 DSH 的 GitHub 加速(区域、前缀、回退链,以及 profile 市场状态的读取)lib/args.js— 把设置翻译成 MATLAB MCP Server 官方参数(含existing模式的互斥规则)lib/probe.js— 一次性 stdio MCP 握手lib/version.js— 插件自身版本与包名的唯一来源(读package.json)
许可
插件代码 MIT,作者 小涛29(xuyuntao@189.cn)。icon.svg 与设置页里的图标是 The MathWorks, Inc. 的 MATLAB 标志:矢量取自本机 MATLAB R2023b 自带的图形资源,仅用于标识本插件接入的是 MATLAB。该标志是 MathWorks 的商标,不在 MIT 许可范围内,也不表示 MathWorks 对本插件的认可。MATLAB、Simulink 及相关工具包名称同样是 The MathWorks, Inc. 的商标;除该标志外,插件不包含也不重新分发 MathWorks 的内容,只调用其公开发布的产物。技能与工具的使用受 MathWorks 许可条款约束。
Comments
Loading…
Similar plugins
by AdenXie
Connects DeepSeek Harness to the official Vercel MCP server over OAuth, with per-Agent on-demand tool loading, slimmed tool schemas, paged long results and 34 bundled Vercel skills.
★ 0
MIT
JavaScript
Oct 19, 2026
dsh plugin --profile web add @adenxie/dsh-vercelby bauerelizabeth07139
DeepSeek Harness plugin: auditable mathematical proving — a local stdio MCP server with 23 tools, a bundled workflow skill and two slash commands. proven / refuted / inconclusive are never conflated.
★ 0
MIT
Python
Oct 10, 2026
dsh plugin --profile web add dsh-math-rigorby labmimors
Search 1,000 MCP tools through two interfaces in DeepSeek Harness. Load exact schemas on demand and keep structured results usable across tool calls.
★ 12
↓ 294/wk
MIT
TypeScript
Sep 11, 2026
dsh plugin --profile web add dsh-mcp-lensby KouzakiUmi
DeepSeek Harness 插件:按 Agent preset 限制每个 Agent 可见的工具,保留全局 provider 挂载;基于 agent/created 与 ctx.tools.restrict()。
★ 0
MIT
JavaScript
Oct 19, 2026
dsh plugin --profile web add dsh-preset-tool-guardby fashionmascherine-svg
DeepSeek Harness plugin (dsh-plugin): complete Polymarket superpowers — 31 verified tools across Gamma/CLOB/Data-API/Perps/RFQ/Bridge, embedded knowhow skill, live WebSocket stream. Read-only by defau
★ 3
JavaScript
Oct 7, 2026
dsh plugin --profile web add dsh-polymarket-knowhowby MikotoMyWife
Lazy-loading MCP tools for DeepSeek Harness (DSH): one loader tool per multi-tool MCP server, per-agent tool masking, description presets
★ 0
MIT
TypeScript
Oct 8, 2026
dsh plugin --profile web add dsh-mcp-loader