Alberssssss/dsh-pharma-product-facts-plugin

dsh-pharma-product-facts

独立 DSH 组合包，在同一个 Cordis 配置行中提供 pharma-product-facts skill、窄范围 agent/pre-step router，以及两个 DSH 原生证据工具。安装、停用、重载和卸载会原子地作用于全部四项贡献。

业务流程已改为 DSH 内部自包含：使用随 DSH 提供的 web_search 发现 URL，由包内受限工具读取 CDE/NMPA HTML 或 PDF，再由包内确定性 finalizer 生成答案。运行时不执行外部医学 skill、本地 Python 脚本或用户主目录资源。

安装

在 DSH Web UI 的插件输入框中只粘贴：

github:Alberssssss/dsh-pharma-product-facts-plugin

终端安装命令：

dsh plugin --profile web add github:Alberssssss/dsh-pharma-product-facts-plugin

安装后重启 web profile Host 并新建会话。旧会话会保留其创建时的组成和 skill 正文。

仓库提交了经过验证的预构建 lib/，且不声明安装期脚本，因此全新 DSH profile 可以安装该 Git 包，无需为 pnpm 增加 allowBuilds 例外。源码 checkout 仍可通过 pnpm run build 独立构建。适合生产使用时可固定已评审 commit：

github:Alberssssss/dsh-pharma-product-facts-plugin#

DSH 可能提示 profile 目录中缺少 peer 软件包，这是因为 Host 通过安装侧 module fallback 提供共享核心包。不要仅为消除警告而安装第二份 Cordis 或 DSH 核心。可用以下命令核对最终配置行：

dsh --profile web --dump-config

模型可见性

使用挂载 @deepseek-ai/dsh-tool-skill 的 preset，例如 standard 或 code。共享 skill 工具通过 skill({ name: "pharma-product-facts" }) 加载本包；不会出现以 GitHub 仓库名命名的工具。

插件同时注册两个模型可见工具：

- pharma_product_facts_fetch_source：只接受 CDE/NMPA 主机上的 HTTPS URL；只跟随同源跳转；限制响应时间和大小；抽取 HTML、文本或 PDF；并要求正文出现用户所问的确切产品名。
- pharma_product_facts_finalize：接收精确原文和当前会话的 evidence id，拒绝跨会话或被改写的证据，自动派生来源 URL，并渲染唯一公开答案。

Skill 只用 DSH web_search 发现候选官方 URL；搜索摘要不能作为说明书证据。标准 DSH 基础 profile 已提供 web_search，实时发现仍要求其已配置的搜索 provider 可用。

包内流程将每轮上限设为 3 次 web_search 和 4 个官方候选来源，超时与 rejected 都计数；用户给出更低上限时从低。搜索一旦返回官方候选 URL，skill 会先验证该候选，不继续消耗搜索次数预判内容。

hcp_focus_card 的规范输入只使用 clinical_focus。为避免模型冗余字段触发长时间重试，finalizer 还会容忍一种 listed label_boundary：其 evidence id 和精确范围原文必须与某条关注点完全重复。该重复对象会被校验但不会渲染；not_listed、无关边界及其他混合模式输入仍会失败。模式字段纠正只复用现有 evidence，不会重新搜索或抓取来源。

在非边界模式中，只有 questioned_use、scope_quote 与 evidence_id 全为空的工具 schema 占位对象才会被视为未提供；部分填写的对象仍会 fail closed。PDF 匹配只忽略中文排版软换行，保留英文词间及数字与单位间空白。Canonical answer 不带末尾换行，因此 Web 对话可以逐字复现。

可选的 OpenAI 搜索配套插件

本 bundle 不打包也不选择网页搜索后端。它消费稳定的 DSH web_search 工具，可以搭配任何已正确配置且可用的 provider。若要让该工具通过 OpenAI Responses 原生 Web Search 搜索，请安装配套 bundle：

dsh plugin --profile web add github:Alberssssss/dsh-web-search-openai

配套插件只改变来源发现。当前 pharma bundle 仍会自行抓取所引用的 CDE/NMPA 页面或 PDF，核对用户所问产品身份和逐字引文，并负责生成最终答案。安装任一 bundle 都不会强制对话模型调用 skill 或 web_search。

运行时安全

- 证据按 DSH agent/session 隔离，并只保存在有界内存中。
- 来源工具不发送 cookie 或凭据；会拒绝非监管域名、HTTP、URL 内凭据、非默认端口、跨域跳转、不支持的媒体、超大响应和产品身份不匹配。
- PDF 通过维护中的 unpdf 依赖在包内解析，不需要外部文档服务。
- Finalizer 会把每段公开引用重新与已取正文匹配，并禁止用截断文档证明某用途“不存在”。
- 公开答案会拒绝本地路径、疑似凭据、工具名及执行过程叙述。

本包不能保证网络或监管网站始终可用。没有取得完整且产品匹配的官方来源时，skill 会返回有限的“未核实”答案，不用模型记忆补全标签事实。

配置

所有随部署变化的资源限制都属于同一插件配置行。按 id 覆盖 bundle 行时需要重述其名称：

- id: pharma-product-facts
name: dsh-pharma-product-facts
config:
fetchTimeoutMs: 30000
sourceToolTimeoutMs: 35000
maxResponseBytes: 12000000
maxSourceChars: 180000

其余默认值为 maxUrlChars: 4096、maxRedirects: 3、maxEvidenceScopes: 64 和 maxEvidenceRecordsPerScope: 24。需要公开标识运营方时也可配置 userAgent。非法数值、短于抓取超时的工具超时，以及不安全的 User-Agent 文本会在插件加载时直接报错。HTTPS 要求和 CDE/NMPA 主机白名单属于固定安全规则，不能通过配置放宽。

路由边界

Router 会为产品身份、静态说明书事实、标签安全字段、获批用途边界和非个体化 HCP 关注卡推荐本 skill。患者个体剂量或给药、eGFR/肾功能剂量决策、不良事件处置、联用、竞品比较、商业推广、注册文件下载和证据综述不进入该路由。Skill catalog 描述也明确列出这些排除项，以降低模型仅因出现药名而主动加载的概率。Router 提示不等于实际使用；应在会话日志中继续检查后续 skill 调用和证据工具调用。

生命周期

一次停用全部贡献：

- id: pharma-product-facts
disabled: true

卸载组合包：

dsh plugin --profile web remove dsh-pharma-product-facts

开发与验证

该 Git 仓库完全独立：所有软件包版本都是普通 registry 范围，没有 workspace: 依赖，pnpm run build 可以只基于本 checkout 构建。Git 安装直接使用已提交的 lib/，不会执行依赖生命周期脚本。

pnpm install
pnpm run typecheck
pnpm run test:coverage
pnpm run build
pnpm run pack:check

本包仍是外部插件，不属于 DeepSeek Harness 官方发布组件。医学正确性仍取决于实际选择和引用的公开来源；确定性校验可以减少来源替换与执行痕迹泄漏，但不能替代临床或法规审核。