heart-health-dsh-suite
适配心脏健康场景的 DeepSeek Harness 插件套件：在「心衰辅助诊断算法服务（heart-algo MCP）」之上，
为 DSH 会话提供一组受控的领域包装工具、驻留临床指导与原始工具隐藏策略。
它是三个插件包协作链路的最后一环：
heart-algo-mcp(算法服务) ──> heart-algo-dsh-plugin(MCP 桥) ──> heart-health-dsh-suite(本包)
能力总览
| 层 | 内容 | 说明 |
|---|
| 包装工具 | heart_submit_diagnosis / heart_get_diagnosis_result / heart_list_supported_views | 只接受已登记标识符；嵌套读取底层 MCP 的 structuredContent，投影为稳定 canonical JSON；不解析渲染文本 |
| 驻留指导 | 系统提示词 心脏健康分析工作方式（order 150） | 调用状态机、三态解读边界、安全红线；随 preset 常驻，每轮生效 |
| 策略 | 对继承工具面按前缀隐藏 mcp__<server>__* 并安装单调 guard | 直接调用被拒绝并给出可操作原因；策略只收紧自身会话视图，不影响其它 preset 与全局层 |
| 数据最小化 | canonical value 构造时就地 scrubValue | 丢弃 path/token 类键、脱敏泄露签名、patient_info 仅保留 age/sex（可整体关闭） |
三态契约与上游 mcp_server.py 一致：processing / completed / failed 判别式负载，
逐资产 error/skip_reason，inputs SHA-256 追溯，review_status/requires_clinician_review 复核状态。
安装
# 在 profile（web）全局层登记本包；裸行 heart-health-dsh-suite/tools 由宿主基座解析
dsh plugin --profile web add ./heart-health-dsh-suite
# 安装驻留 preset（把 presets/heart-health/ 两个 yaml 写入 <DSH_HOME>/.agent-presets/）
dsh bundle apply --profile web cordis.patch.yml
卸载：
dsh plugin --profile web remove heart-health-dsh-suite
卸载说明：dsh plugin remove 会同时删除已复制到用户根目录的 preset 目录，
但已经启动的会话进程仍持有旧能力直到重启。tools/change 之后新会话即恢复干净工具面。
配置旋钮（环境变量）
| 变量 | 默认值 | 说明 |
|---|
HEART_HEALTH_MCP_SERVER_NAME | heart-algo | 底层 MCP server 名（决定被隐藏的原始工具前缀） |
HEART_HEALTH_RAW_TOOL_SUBMIT | diagnose_heart_failure | 提交任务的原始工具名 |
HEART_HEALTH_RAW_TOOL_RESULT | get_diagnosis_result | 查询结果的原始工具名 |
HEART_HEALTH_RAW_TOOL_VIEWS | list_supported_views | 支持切面目录的原始工具名 |
HEART_HEALTH_KEEP_PATIENT_INFO | true(1) | 设为 false/0 时结果完全不含 patient_info |
HEART_HEALTH_MAX_VISIBLE_ECG_PREDICTIONS | 8 | 文本投影展示 Top-K 条 ECG 预测；canonical value 保持全量 |
HEART_HEALTH_REVIEW_REMINDER | true(1) | 设为 false/0 时关闭 completed 结果尾部的复核提示文案 |
变量必须在启动 dsh 的进程内存在；也可以直接改写 <DSH_HOME>/.agent-presets/heart-health/agent.cordis.yml 的字面量。
开发与验证
$env:DSH_CHECKOUT = 'D:\project\dsh\deepseek-harness' # 指向 Harness checkout
npm run build # tsc 编译到 lib/（零依赖安装，从 checkout 解析 peer 类型与 typescript）
npm run check # 发布物清单 / exports 一致性 / 秘密卫生 / 旋钮拼写
npm test # 33 个 vitest 用例（真实 Loader + 真 Includer + 假 heart MCP）
测试要点（对应 PRD 验收）：
- 真实加载器组合：AgentPresets 挂载真实解析 preset；原始 MCP 工具对会话不可见、guard 可拒绝；
- 三态契约：canonical 判别式投影快照、Top-K 截断、未知状态拒绝、AbortSignal 传播；
- 数据最小化：跨 content/meta/value 三面断言泄漏注入全部清除；
- 输入校验：URL/路径/多余字段一律拒绝并指引病例门户上传；
- 生命周期：并发/顺序多会话挂载干净无重复注册。
已知残留风险
- 嵌套调用省略了
agent 参数（包装器内部委托底层 MCP 属同一受控插件域），因此agent 作用域的监听器与审批门禁不会作用于这次委托——这是执行机制的有意豁免；策略层 guard 仍覆盖模型直接发起的任何原始工具调用。
- preset 组合行以裸包名解析运行时（与
@deepseek-ai/dsh-persona 同机制）：若部署宿主的组合基座与 profile node_modules 不一致，挂载会在健康检查中响亮失败（不会静默降级）。
- Windows 下
file:///D:/pkg/... 形态已验证；POSIX 盘符缺失的 URL 形态不在支持范围。
