DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

owenxyzhang-seseTJ /

owenxyzhang-seseTJ/Convolvex-MS

Topic repository only

Auditable MS/DEMS inversion backend, web workbench and DeepSeek Harness plugin (dsh-convolvex-ms-workbench)

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@ed81d6f5

Convolvex-MS

面向质谱 / DEMS 的可审计数值后端,提供 Python API、MCP stdio/HTTP 和 Web 工作台。MIT 许可。

此仓库保留两个版本:v1.1.0 是用户提供的原始源码快照;v1.1.0-deploy.2 是在 macOS、WSL2 与原生 Windows 部署、调试后的修复版,并加入 DEMS/LSV Web 工作台和 DSH 插件。数值包版本保持 1.1.0,deploy.2 表示部署修订。Release 提供通用源码包及三个平台的源码部署包;运行仍需安装对应 Python 依赖。

已完成的本地验证

平台 Python 实测回归 能力
macOS ARM64 / Apple M5 3.13.13 151 passed,1 skipped CPU FFT、C++;网页 DEMS 操作通过
WSL2 x86_64 / i7-12700H 3.12.3 153 passed,0 skipped CPU FFT、C++、RTX 3070 Ti CUDA 一致性
Windows 11 x86_64 3.13.5 147 passed,6 skipped CPU FFT、官方 MCP SDK、stdio 与 HTTP

macOS 与跨平台测试记录包含不同阶段的用例数量。Windows 的 6 个跳过项为 4 个缺少原生 DLL 的测试、1 个未安装 CuPy 的 GPU 测试,以及 1 个账户无符号链接创建权限的测试。原始记录见 reports,方法与边界见 实测报告。

三端合成联合反演 RMSE 均约 0.010632,质量线形恢复 RMSE 约 0.003221。WSL GPU 小负载计时在现有 GRASPA 任务约占用 97% GPU 时执行;65536 点 / 257 核点的卷积含传输约加速 1.18×,4096 点短信号则较慢。MS 联合反演和背景消元仍使用 CPU。合成数据测试不代表真实实验定量精度。

安装和使用

macOS / Linux CPU(Python 3.12 或 3.13;原生构建需 C++17 编译器):

python3 -m venv .venv
.venv/bin/python scripts/build_native.py
.venv/bin/python -m pip install -c requirements-tested.txt '.[test]' 'mcp==1.26.0'
.venv/bin/python scripts/local_services.py start

WSL CUDA:先选择项目本机端口,再安装。该方式只安装项目虚拟环境的用户态 CUDA 库,不替换驱动。

mkdir -p runtime
printf '{"web":8865,"mcp":8866}\n' > runtime/ports.json
bash scripts/deploy_wsl.sh --cuda

Windows 原生(PowerShell):

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/deploy_windows.ps1

脚本将 Python/uv 与依赖放在项目目录中。受限网络的官方安装包中转方法见 部署指南。后续双击 start_windows.cmd / stop_windows.cmd。Windows 尚未部署 C++ DLL 或 CuPy;有 MinGW 编译器时可自行构建 DLL。

配置 Web MCP HTTP
macOS / 通用 Unix 默认 http://127.0.0.1:8765 http://127.0.0.1:8766/mcp
WSL CUDA 部署包 http://127.0.0.1:8865 http://127.0.0.1:8866/mcp
Windows 原生默认 http://127.0.0.1:8875 http://127.0.0.1:8876/mcp

服务只绑定本机回环地址;HTTP MCP 使用 runtime/mcp-token.txt 中生成的令牌。stdio MCP 用法及协议说明见 原版技术说明。源码仓库不包含运行令牌、用户工作区、个人绝对路径配置或预装虚拟环境。

DeepSeek Harness 集成见 dsh-integration/README.md:

  • dsh-integration/convolvex-ms-workbench 是左侧栏可视化工作台插件,npm 包名为 dsh-convolvex-ms-workbench,直接复用本项目的原 Web 前端,并按 DSH 工作区隔离 .convolvex-ms 数据;
  • dsh-integration/convolvex-ms-mcp 是配置型 DSH bundle,以 stdio 方式启动本项目的 MCP 服务,把 15 个 ms_* 工具注册为 mcp__convolvex-ms__*,使用独立工作区 runtime/ms-stdio。

在 DeepSeek Harness (DSH) 中部署

要求 DSH >=0.2.2-rc.2(插件包 engines.dsh 声明)。

1. 先部署 Python 后端

按上面的平台步骤创建 .venv 并安装依赖。工作台插件会按需启动后端的 Web 服务,不需要先运行 scripts/local_services.py start。

2. 安装左侧栏插件

方式 A:从本仓库本地 bundle 安装(推荐,和本仓库源码一致)

打开 DSH 设置 → 插件 → 添加插件,选择本仓库的 dsh-integration/convolvex-ms-workbench 目录。也可以在终端执行:

dsh plugin --profile desktop add "/absolute/path/to/Convolvex-MS/dsh-integration/convolvex-ms-workbench"

方式 B:从 npm 安装发布版

dsh plugin --profile desktop add dsh-convolvex-ms-workbench

npm 发布版的版本可能落后于本仓库源码;需要使用最新动效和跨平台 appRoot 解析时,优先使用方式 A。

3. 配置 appRoot

插件默认从自身目录上两级寻找 pyproject.toml 和 src/convolvex。如果插件安装目录不在本仓库的 dsh-integration 下,在 DSH 的插件行配置(或 profile 的 cordis.patch.yml)中设置:

- id: convolvex-ms-workbench
  name: dsh-convolvex-ms-workbench
  config:
    appRoot: /absolute/path/to/Convolvex-MS

Windows 原生后端:

- id: convolvex-ms-workbench
  name: dsh-convolvex-ms-workbench
  config:
    appRoot: C:\path\to\Convolvex-MS
    python: C:\path\to\Convolvex-MS\.venv\Scripts\python.exe

WSL/Linux 后端:

- id: convolvex-ms-workbench
  name: dsh-convolvex-ms-workbench
  config:
    appRoot: /path/to/Convolvex-MS
    python: /path/to/Convolvex-MS/.venv/bin/python

python 可省略:Windows 默认 .venv\Scripts\python.exe,WSL/Linux 默认 .venv/bin/python。也可以用环境变量 CONVOLVEX_MS_ROOT 指向仓库根目录。

4. 打开工作台

重启或刷新 DSH 后,点击左侧栏 Convolvex-MS 质谱工作台,在顶部选择 DSH 工作区。插件会在该工作区下创建 .convolvex-ms/ 并自动启动 Python 服务。

5. Windows / WSL 要点

  • Windows 原生 DSH:先执行 powershell -NoProfile -ExecutionPolicy Bypass -File scripts/deploy_windows.ps1,再安装插件;插件默认使用 .venv\Scripts\python.exe。
  • WSL2 中的 DSH:先执行 bash scripts/deploy_wsl.sh --cuda(无 CUDA 可省略 --cuda),再安装插件;插件默认使用 .venv/bin/python。
  • 两套环境都不要把后端端口暴露到公网;插件只通过 DSH Host 的本地 RPC 访问 Python 服务。

6. 可选:MCP 工具连接

dsh-integration/convolvex-ms-mcp 是独立的 MCP bundle,不是工作台必需项。它按 cordis.patch.yml 中的绝对路径启动 convolvex.mcp_server;Windows 使用 .venv\Scripts\python.exe,WSL 使用 .venv/bin/python,并保持 runtime/ms-stdio 工作区独立。

Web 工作台现可直接导入 DEMS CSV / Excel / JSON,按候选响应做谱分离或谱–时间联合反演,并从标准图谱库按需调取 NIST WebBook 的公开 EI 谱。图谱库分为 CO₂RR、NORR、碳氮耦合、同位素示踪和常见催化,覆盖尿素、酰胺、胺类、乙腈等耦合产物;不公开的同位素谱不会用母体平移谱替代,可另行导入本地参考谱。

右侧「DEMS 快速处理」支持按时间、电位、电化学电流查询质谱信号,查看重叠组分贡献、信号时间斜率、Tafel 拟合和时间区间积分。输入适用的本机灵敏度与反应电子数后,可计算物质转化电荷和条件性 FE。未标定时保留相对信号积分与原始 EC 电荷。导入格式、公式、标定与时间对齐约定见 Web 工作台说明。

联合 LSV 流程支持原始 E–I–t 数据,或依据用户给出的恒定扫描速率重建严格单向 LSV 的时间;可在解混前按空白窗口逐通道扣背景,并分别处理时钟偏移与传输延迟。分析区并列展示 LSV、具名组分极化曲线和质谱伏安曲线。标准谱中的物质名、CAS 与来源贯穿候选列表和导出;默认合成示例使用真实 NIST H₂、CO、CO₂ 响应谱,候选不再显示 ABC。

复现

# 当前环境的回归、CPU 基准、合成精度、MCP/HTTP 分析:依次执行
.venv/bin/python scripts/validate_deployment.py --output-dir validation_local
# WSL 上的小负载 GPU 卷积(保留并发负载快照)
OPENBLAS_NUM_THREADS=1 OMP_NUM_THREADS=1 .venv/bin/python benchmarks/gpu_small_benchmark.py --output validation_local/gpu_small_benchmark.json

修复清单 · 详细成绩 · 版本记录 · 标定合同。benchmarks/ms_results.json 和 LaTeX 报告保留原包 Linux 参考记录,未改为本次跨平台成绩。GitHub Actions 验证另有运行记录,不把本地通过等同于 CI 已通过。

—/ 5

No ratings yet

Manifest verification required

Commit ed81d6f5cfdf

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout