DSH Plugins Marketplace

DSH Plugins

Plugins

/

Tools & Capabilities

/

dsh-matlab

d

dsh-matlab

Identified

Adds 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。

设置 → MATLAB 整页长截图:带插件版本号的状态卡、“依赖”卡片(本地/最新 Tag 与检查更新、下载最新依赖、清空本地依赖三个按键)、24 个技能组开关、启动参数、MCP Server、依赖下载,以及固定在底部的保存条


它怎么工作

                  ┌──────────────────────── 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 Serverv0.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
字段默认作用
serverNamematlab工具前缀,最终形如 mcp__matlab__evaluate_matlab_code
toolCallTimeoutMs600000单次 MATLAB 调用上限;仿真/测试套件很慢,故默认 10 分钟
failOnStartupErrorfalse为 true 时连接失败会让插件激活失败,而不是仅告警
matlabRoot自动传给 --matlab-root;留空则按 环境变量 → PATH → 注册表 → 安装目录 顺序发现
sessionModeautoauto 优先接管已 shareMATLABSession() 的会话,否则新开;new 总是新开;existing 只接管
displayModedesktopnodesktop 表示不弹 MATLAB 桌面
initialWorkingFolderDSH 工作目录MATLAB 启动目录
useWorkspaceFolderfalse勾选后忽略 initialWorkingFolder:每次调用 evaluate_matlab_code 时用该对话的工作区(项目)目录作为 MATLAB 当前文件夹(设置页“起始目录”上方开关)
initializeMatlabOnStartupfalse为 true 时 MCP 服务一启动就拉起 MATLAB
disableTelemetrytrue透传 --disable-telemetry=true;默认关闭遥测
mcpServerPath自动指定 matlab-mcp-server 可执行文件;留空则发现或下载
autoProvisiontrue缺失时下载二进制、安装 MATLAB 工具包的最新 Release
githubProxy空(沿用 DSH)GitHub 加速前缀,例如 https://gh-proxy.com;留空则沿用 DSH 已配置的加速(DSHM_GITHUB_PROXY,或 DSH 市场“GitHub 加速”里的自定义前缀)
downloadRegionautoauto 跟随 DSH 市场选定的区域;china 强制中国区线路;global 直连。见下文“首次下载”
provisionTimeoutMs300000单次首次准备(下载二进制或安装工具包)的总预算;它只约束后台任务,不占用启动
provisionWaitMs0激活最多等首次准备多久(毫秒)。0 表示完全不阻塞启动,准备完成后自动挂载
agentNameDeepSeekMATLAB 命令窗口里显示的 Agent 名(单行、≤ 80 字符)
toolkitRoots[]额外/替代的工具包目录;给定时优先。指向你自己的副本时,插件不会把它当成可更新/可替换的安装
skillGroups[](全部)要加载的技能组;留空或 ['*'] 加载全部组(MATLAB 工具包为 24 组 / 158 个技能),列出组名则只加载这些组
extensionFiles[]额外 MCP 工具定义文件(Simulink 工具包的 tools/tools.json 会自动带上)
watchSkillstrue工具包变更时热更新技能目录
probe / probeTimeoutMstrue / 20000连接前做一次 MCP 握手探测
statusRoutetrue提供 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。

三个按钮:

  1. 检查更新(只读两次很小的探测,不下载):两者都看 GitHub 的 releases/latest;某条线路拒绝或限流 API 时,退到发布页本身(页面 og:url 里的 tag 就是 releases/latest 指向的那个)。两条探测都走最先可用的加速线路。
  2. 下载最新依赖:只有在“本地缺失(任一产物没装)”或“检查后发现官方 Tag 与本地不同”时才可点击。点击后先停掉正在运行的 MCP 桥与技能目录(Windows 不允许替换正在运行的 exe,技能监视器也不该看着目录被重写),清空插件自己的那两份产物,再重新下载并挂载最新 Release;进度对话框照常显示。工具包先解压到 *.incoming,完整解压成功才就位,二进制是“临时文件 + 原子改名”,且下载过程中边写边算 SHA-256,与 GitHub 公布的 Release 资产摘要不一致就拒绝安装(见下文“下载的文件经过校验”)。
  3. 清空本地依赖:删除插件自己安装的 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 已经选好的线路:

  1. githubProxy(本插件的配置,最具体);
  2. DSHM_GITHUB_PROXY(运维在环境里设置的覆盖值);
  3. 当前 profile 的 .dsh-market/state.json——DSH 市场“GitHub 加速”保存的自定义前缀与下载区域;
  4. 区域: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"。

验证

  1. 重启后在对话里问:

    本机 MATLAB 是什么版本?装了哪些 toolbox?
    

    模型应调用 mcp__matlab__detect_matlab_toolboxes。

  2. 看技能目录:默认全量(MATLAB 工具包 24 组 / 158 个技能),至少应能看到 matlab-core 组里的 6 个(如 matlab-create-live-script)。

  3. 直接读连接状态:

    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 }]
    }
    
  4. 打开 设置 → MATLAB:应能看到阶段、MATLAB 根、MCP Server 版本、实际线路、24 个技能组开关;改几个再保存,日志应出现 settings applied,技能目录随之变化(不需要重启)。

  5. 若启用了插件但本机还没有二进制/工具包:右下角会出现进度对话框,status.phase 为 provisioning;准备完成后对话框提示就绪,工具与技能自动出现。

  6. 在 设置 → 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-signal21天线、PCB、RF/AMS/SerDes 建模
automotive13RoadRunner 场景、驾驶数据、SUMO 协同仿真
test-and-measurement13DAQ、相机、Arduino、OPC UA、车载网络
signal-processing12滤波器设计、频谱/时频分析、音频
matlab-software-development11测试、性能与内存优化、打包 toolbox
wireless-communications115G/WLAN/BLE/GNSS 波形、USRP
ai-and-statistics10训练网络、曲线拟合、可解释性、嵌入式 AI
image-processing-and-computer-vision10图像/体数据/点云、OCR、视觉检测
robotics-and-autonomous-systems6运动规划、MAVLink、惯导融合、GNSS
code-generation5生成 C/GPU 代码、定点、部署
parallel-computing5parfor 诊断、集群、GPU、线程池
computational-finance4组合优化、定价、Datafeed、Excel 链接
matlab-data-import-and-analysis4导入导出、表格分析、大数据选型
radar4雷达设计、波形、检测仿真
reporting-and-database-access4报告生成、Database/DuckDB/Databricks
computational-biology3SimBiology 建模/拟合/仿真
control-systems3系统辨识、旋转机械/电池特征
math-and-optimization3优化、PDE、符号计算
matlab-app-building3App、图表、主题
matlab-external-language-interfaces3调 Python/Java、MEX 互操作复数 API
aerospace2坐标转换、大气/环境计算
cloud-solutions1MATLAB Drive 共享
matlab-programming1函数参数校验

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 existmatlabRoot 指向已卸载版本;清空该字段让其重新发现
没有 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 — 读 MathWorks manifest.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

dsh-vercel

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.

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 19, 2026

dsh plugin --profile web add @adenxie/dsh-vercel

by 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.

Manifest valid

★ 0

MIT

Python

Oct 10, 2026

dsh plugin --profile web add dsh-math-rigor

by 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.

Tools & CapabilitiesManifest valid

★ 12

↓ 294/wk

MIT

TypeScript

Sep 11, 2026

dsh plugin --profile web add dsh-mcp-lens

by KouzakiUmi

DeepSeek Harness 插件:按 Agent preset 限制每个 Agent 可见的工具,保留全局 provider 挂载;基于 agent/created 与 ctx.tools.restrict()。

Manifest valid

★ 0

MIT

JavaScript

Oct 19, 2026

dsh plugin --profile web add dsh-preset-tool-guard

by 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

Tools & CapabilitiesManifest valid

★ 3

JavaScript

Oct 7, 2026

dsh plugin --profile web add dsh-polymarket-knowhow

by MikotoMyWife

Lazy-loading MCP tools for DeepSeek Harness (DSH): one loader tool per multi-tool MCP server, per-agent tool masking, description presets

Manifest valid

★ 0

MIT

TypeScript

Oct 8, 2026

dsh plugin --profile web add dsh-mcp-loader