前言¶
做静息态 fMRI 预处理，常见路径是打开 DPABI/DPARSF，在 MATLAB 里手工点参数、盯日志、另开脚本看头动和 QC。若你已经在用 DeepSeek Harness（DSH）管理会话与工作区，更希望扫描数据、校验配置、后台跑 DPARSFA_run、看 Job 输出和人工 QC 都落在同一会话里，而不是在 Harness 与 MATLAB 之间反复切换窗口。
下面介绍社区插件 dsh-mri-workbench（维护者 Ezerruier，分类为客户端）：它在 Harness Web UI 增加「MRI 工作台」页面与 /mri 命令，并提供一组 mri_workbench_* Agent 工具；重计算仍在独立 MATLAB 进程中调用官方 DPARSF 引擎，插件侧只做编排与部分只读解析。
这是什么¶
dsh-mri-workbench 是 DSH 的 workspace bundle 插件（MIT 许可证，当前 package.json 版本 0.1.0）。仓库同时包含：
| 部分 | 说明 |
|---|---|
仓库根目录（index.mjs / client.js） |
DSH 插件：UI 页面、/mri、Agent 工具 |
matlab/MRI_Workbench/ |
可独立运行的 MATLAB GUI（StartWorkbench），插件通过 mrw.* 调用 |
一句话：在 Harness 里完成数据集索引、DPARSF 配置预检、后台预处理、人工 QC 与头动/scrubbing 分析，DPABI/DPARSF 仍是后端。
核心功能¶
Harness 会话内的「MRI 工作台」¶
安装并在工作区放好 MATLAB 工作台目录后，刷新会话视图会出现 「MRI 工作台」 标签页，大致对应五张卡片：
- 数据索引：指定数据根目录（支持手动输入或 浏览… 选文件夹），开始扫描；识别
FunRaw/<受试者>/或 BIDS 等布局。 - 预处理配置：预设与 参数设置… 弹窗（README 称约 98 个字段，中英文与悬停说明）；生成配置并校验 做运行前检查，未通过时无法 开始预处理。
- 运行：以 DSH 后台 Job 启动独立 MATLAB 进程跑
DPARSFA_run；日志在会话顶部「后台任务」流式显示，可刷新状态或取消。 - 人工 QC：打开 MATLAB 人工 QC（1–5 分，与 DPARSF 兼容）；读取 MATLAB QC 状态 配合 Agent 做实时指导。
- 头动结果解读与可视化：纯 Node 读取
RealignParameter/HeadMotion.tsv与逐帧 FD，表格与曲线解释指标；同卡可做坏帧 / Scrubbing 预览并写入参数覆盖。
新建会话的开始界面还可点 打开 MRI 工作台 直接进入；命令 /mri help 查看子命令（如 qc、results、censor）。
Agent 工具¶
README 列出的工具包括（节选）：mri_workbench_env、mri_workbench_scan、mri_workbench_prepare、mri_workbench_start、mri_workbench_status、mri_workbench_wait、mri_workbench_cancel、mri_workbench_open_gui、mri_workbench_qc、mri_workbench_qcstate、mri_workbench_results、mri_workbench_censor、mri_workbench_params、mri_workbench_overrides。Agent 可扫描目录、生成并校验配置、启动后台任务并用 job_output / mri_workbench_wait 跟进。
运行数据与边界¶
插件把扫描索引、配置、运行日志写在当前会话工作区的 .mri-workbench/；README 说明不会修改 DPABI 安装目录与用户原始研究数据（DPARSF 预处理输出目录除外）。编排与摘要解析在 Node；预处理与 MATLAB QC 界面在 MATLAB 侧完成。
安装与启用¶
前置条件（来自仓库 README）：
- Windows 10/11
- DeepSeek Harness Desktop（
dsh0.2.x profile） - MATLAB R2020b 及以上（可用环境变量
MATLAB_EXE指定可执行文件） - DPABI（README 示例默认路径可用
DPABI_ROOT覆盖）与 SPM12（SPM_ROOT）；MATLAB 路径中需已包含它们 - Node 引擎要求
>=22（见package.json）
推荐方式：作为 DSH 插件使用。
-
获取仓库源码（下载 ZIP 或按你方规范取得目录树），得到本地绝对路径
<repo>。 -
让 MATLAB 工作台能被插件找到，二选一：
- 将
matlab/MRI_Workbench放到 当前 DSH 会话工作区根目录 下的MRI_Workbench/（Windows 可用目录联接mklink /J）； - 或设置环境变量
MRI_WORKBENCH_ROOT=<repo>\matlab\MRI_Workbench。
- 在 DSH 中安装 bundle（命令须与 README 一致）：
plugin_manager install_bundle target = <repo 根目录绝对路径>
安装后刷新页面，确认 Agent 工具表与「MRI 工作台」页出现。
目录页：SkillHub 上的 dsh-mri-workbench 可作安装线索；具体步骤以 GitHub README 为准。
典型用法¶
在 Harness UI 中¶
- 打开「MRI 工作台」→ 填写或 浏览… 选择数据根目录 → 开始扫描。
- 选预设；需要时 参数设置… 调参，设置被试并行 worker 数，再 生成配置并校验。
- 开始预处理，在「后台任务」看日志；需要完整 MATLAB 参数界面时点 打开 MATLAB 桌面版。
- Realign 完成后在⑤卡查看头动表与 FD 曲线，按需预览 scrubbing 并 写入参数覆盖 或导出
ScrubbingPreview/。 - 预处理结束后在④卡 打开 MATLAB 人工 QC 评分，刷新 QC 评分 看汇总；做 Agent 协同时可用 读取 MATLAB QC 状态。
仅使用 MATLAB 工作台¶
不装 DSH 插件时，可在 MATLAB 中：
cd('<仓库>\matlab\MRI_Workbench')
StartWorkbench
详细步骤见仓库内 matlab/MRI_Workbench/README.md 与 matlab/MRI_Workbench/docs/使用手册.md。
对 Agent¶
README 给出典型对话起点，例如让 Agent 扫描某数据根目录、选用快速预设、生成配置并启动后台预处理，再用 mri_workbench_wait 汇报进度。具体措辞与字段以当前工具 schema 为准。
适用场景与注意¶
适合谁：在 Windows 上已配置 DPABI/SPM12 与 MATLAB，做静息态 fMRI 预处理，并希望 DSH 统一承载工作区、后台 Job、Agent 与 QC/头动解读流程的研究或工程同学。
平台：README 标明 Windows 10/11；其他系统未在资料中声明支持。
安全与信任：插件以当前 DSH 进程权限运行，会启动 MATLAB、读写工作区与预处理输出目录。安装 bundle 前应阅读源码与 MIT 许可证，确认路径与环境变量符合本机规范。社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，属「一切皆插件」生态中的第三方条目。
文档：仓库还提供 DSH 集成说明、人工 QC 说明、DPARSFA 引擎研究、插件验证记录 docs/VERIFICATION.md 等，排错时可按链路对照。
结尾¶
dsh-mri-workbench 把 DPABI/DPARSF 静息态流水线接到 Harness：索引与预检在 Web UI，预处理在后台 MATLAB Job，QC 与头动/scrubbing 在同一会话内收尾，Agent 可走同一套 mri_workbench_* 接口。需要功能细节与截图说明时，以 GitHub 仓库 README 为准；在 DSH 里检索或从 SkillHub 目录页 进入亦可。
