DeepSeek Harness 插件

dsh-matlab

DeepSeek Harness plugin: matlab.run tool — run MATLAB code via matlab -batch and return output plus saved figures.(英文原文)

跳到安装方式

来源信息

GitHub 仓库
weijianguizhou/dsh-matlab
最近更新
2026年8月20日
分类
工具与能力
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/weijianguizhou/dsh-matlab
插件名:dsh-matlab
作者:weijianguizhou

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-matlab

DSH(DeepSeek Harness)插件:给 Agent 提供 matlab.run 工具——直接跑 MATLAB 代码并返回输出和图片。

特性

  • matlab.run 工具:传 MATLAB 代码 → 写入临时 .m 脚本 → matlab -batch 执行 → 返回 stdout/stderr。
  • 自动存图:代码产生的所有 figure 自动保存为 PNG,返回文件路径(存于工作区 .dsh-matlab/figures/)。
  • 安全审批:MATLAB 可执行任意代码,默认每次调用前请求用户批准(可关闭)。
  • 本地执行:跑在你本机的 MATLAB 上(路径可在插件配置里改)。
  • 零侵入:纯 host 工具插件,不修改任何官方代码。

安装

在目标 profile 中作为 link 依赖安装并加入 bundle 层:

dsh plugin --profile desktop add link:/path/to/dsh-matlab

或在 profiles/<name>/package.json 手动加入依赖,并确保它出现在 dsh.profile.bundles 列表中。装完重启 DSH Desktop 即生效。

配置

插件行可带 config(示例,加在你的 profile 的组合配置里):

- id: matlab
  name: dsh-matlab
  config:
    matlabPath: "D:\\Program Files\\MATLAB 2025\\bin\\matlab.exe"   # MATLAB 可执行文件
    timeoutMs: 120000
    requireApproval: true

不配置则用默认值(检测到的本机 MATLAB 路径)。

开发构建

npm install   # 安装运行时依赖
npm run check # 语法检查

工作原理

1. matlab.run 接收 code(MATLAB 代码)和可选 workdir。 2. 把代码写到工作区 .dsh-matlab/run-*.m,末尾追加存图代码段。 3. 通过 host 子进程通道执行 matlab -batch "run('...')",捕获 stdout/stderr。 4. 把 .dsh-matlab/figures/ 下的 PNG 列进结果返回给模型。 5. 退出码非 0 时以 MATLAB_RUN_FAILED 报错,错误信息含 MATLAB stderr,模型可据此改代码重试。

目录结构

src/host/index.js  工具定义(defineTool)与审批钩子
cordis.patch.yml   bundle 补丁:插入插件行

License

MIT