dsh-plugin-medhub

医知荟 MedHub 的 DeepSeek Harness 插件：医疗与生物科研领域的能力全家桶——可追溯文献、统计分析、 生信分析、网络药理、证据台账、交付级成稿，通过 MedHub 网关执行。

工具（18 个）

家族	工具
文献	medhub_pubmed_search · medhub_pubmed_verify（PMID 核验）· medhub_journal_tier（SCI/北大核心/CSSCI/统计源）· medhub_wangfang_query · medhub_wangfang_parse
证据	medhub_evidence_search（30+ 只读数据源）· medhub_evidence_ledger（结论⇄已验证来源台账）
统计/生信	medhub_stats_analyze · medhub_bioinfo_deg · medhub_bioinfo_enrich · medhub_bioinfo_immune · medhub_bioinfo_ppi · medhub_bioinfo_netpharm · medhub_quality_audit
项目/交付	medhub_project · medhub_export（docx/PDF）· medhub_delegate（整体委托出成品）· medhub_job（异步轮询）

异步工具返回 jobId，用 medhub_job（action: "wait"）轮询到终态。完整目录与 JSON Schema： docs/contracts/catalog.md · docs/contracts/openapi.json。

技能（10 个壳）

medhub-lit-review · medhub-evidence · medhub-stats · medhub-bioinfo · medhub-netpharm · medhub-grant · medhub-thesis · medhub-qc · medhub-delegate · medhub-medical-writing。

技能壳负责把会话路由到 MedHub 工具，并强制执行下方科研诚信契约。

安装

前置：dsh CLI 与 pnpm（dsh plugin 命令会转发到 profile 目录内的 pnpm）。

# 从 npm 安装（推荐：预构建 lib/、无安装期脚本、无需构建白名单授权）：
dsh plugin --profile web add dsh-plugin-medhub

# 从 tarball 离线安装：
dsh plugin --profile web add ./dsh-plugin-medhub-0.2.0.tgz

# 从 git 安装（拉取的是源码：需要本包 prepare 构建脚本，且 pnpm≥10 要求用户在
# profile 的 pnpm-workspace.yaml 里加 allowBuilds 白名单——那是对"安装期执行代码"的授权，
# 建议优先走 npm；走 git 请 pin 到具体 commit）：
dsh plugin --profile web add github:<org>/dsh-plugin-medhub
dsh web

dsh plugin 会自动激活本插件：包声明了官方 dsh.bundle.patch 清单， profile 的 dsh.profile.bundles 会自动追加 dsh-plugin-medhub，无需手工改任何配置。

headless profile（dsh --profile headless "..."）同样可用；仅可选的 /medhub/panel Web 路由被跳过。

产物预览（Web profile）

Web profile 自带预览面板 /medhub/panel：粘贴异步任务的 jobId，即可在线查看图件（SVG/PNG）与 PDF/文本类产物，其余文件（如 DOCX 导出）一键下载。所有请求走本机同源通道，API Key 不出宿主进程。

配置

组合包补丁自带环境变量驱动的默认值（见 cordis.patch.yml）；可在 profile 的 cordis.patch.yml 或 Web 设置页的 medhub 命名空间逐项覆盖：

字段	默认值	说明
gatewayUrl	MEDHUB_GATEWAY_URL ?? http://127.0.0.1:15722	网关地址（本机或 https://jl-medhub.com）
portalUrl	MEDHUB_PORTAL_URL ?? ''	可选：medhub_delegate 专用的云端网关；留空则委托与本机工具同网关
apiKeyEnv	MEDHUB_API_KEY_ENV ?? MEDHUB_API_KEY	存放网关 API Key 的环境变量名（配置里永不落明文密钥）
apiKey	—	可选直填覆盖，走设置系统 secret 角色安全存储
timeoutMs	90000	单次请求预算
pollIntervalMs / pollTimeoutMs	3000 / 1800000	异步任务轮询间隔/总预算

export MEDHUB_API_KEY=mh_...   # 在网关签发：POST /api/v1/keys

科研诚信契约（工具描述 + 技能壳双重强制）

1. 数字、统计量、文献只能来自工具返回值；未核验一律标「待核实」，绝不编造。
2. 引用先过 medhub_pubmed_verify 再入 medhub_evidence_ledger；正文引用必须是台账子集。
3. 异步任务必须轮询到终态才可引用其结果。
4. 分析交付前跑 medhub_quality_audit；未通过的检查项必须修复或如实披露。
5. 检索结果只是证据，不构成诊疗意见。

开发

npm install
npm run check        # tsc --noEmit
npm test             # vitest（单元 + 模拟网关线协议契约测试）
npm run build        # tsc → lib/
npm run gen-contracts  # docs/contracts/*（JSON Schema + OpenAPI 3.1）

许可

Apache-2.0。"医知荟 / MedHub"品牌与网关不属于本包；连接 MedHub 网关需遵守 MedHub 服务条款。

相关链接

• 快速上手 · 插件开发基础 · 发布
• MedHub 网关契约