DSH Plugins Marketplace

DSH Plugins

Plugins

/

outbreak-report-writing

o

outbreak-report-writing

Manifest valid★ 1

Infectious Disease Field Epidemiology Investigation Report (Epi Report) Writing Skills + DeepSeek Harness Plugin: Draft with Limited Information, Tiered Missing Items, Automatic Image Generation, Direct Output to Word/PDF/Markdown

hasBundlePatch

传染病流调报告撰写技能(outbreak-report-writing)

English · 简体中文 · 繁體中文(台灣) · Deutsch · 日本語

能将**仅有的、**不完整的现场信息,变成一份当下就能上报的流调报告:正文按疾控体例写, 暂缺的,未获得的流调信息部分会按照紧迫程度在报告最后罗列,相关流行病可视化配图按病种自动配齐,Word/PDF/Markdown 随时导出,会生成原版和脱敏版。

这套东西不是简单的流调报告“模板”。它从 1300 余份真实流调文稿的结案报告里反向提炼:章节骨架来自 477 份报告的实测顺序,文风参数来自 16815 句的统计, 病种判据来自原文写明的观察期与处置口径。

一句话:给它事件信息加个案表,直接出 Word、PDF 和四张图;缺什么数据它会按「阻断传播、影响研判、完善叙述」三级排序列出来,告诉你 24 小时内还差什么。Mac 下载解压即用,Windows 跑一次 install.ps1。

解决什么问题

老问题这里的做法
数据没齐,报告写不下去,指挥层需要看到一手资料缺的字段变成正文里的红色〔待补P0-2〕,先出一版能看的,附录 A 告诉你还差什么、多急
每次都要重新想章节顺序、抄上回的报告六种体裁固定骨架,选 stage 直接出
流行曲线画成折线、间隔随便定按潜伏期自动定分箱(诺如 4–8 小时、水痘 5–7 天),标注首末例与干预时点
大疫情网导出的个案表一个班拆成四行单位 字段自动归一(18 组用例覆盖,含校名错字)
写完不知道还需流调哪些重要信息附录 A 的 P0 就是核心信息,自检 12 问逐条过
结案报告缺成本效益分析第九节按国家标准科目分项,直接给表格

⚠️ 从 GitHub clone 的版本不含 vendor/。 vendor/(约 150 MB,含 spec、report_engine、flowfig、report_export 与 venv)被 .gitignore 排除,需另行取得并放回技能根目录。缺它时全量引擎 scripts/flowreport.py 不可用(报「vendor 目录不完整」),而下面的轻量模板引擎 scripts/build_report.py 自包含、开箱即用。

安装(两条路,选一条)

A. 轻量版 —— clone 就能用

git clone --depth 1 https://github.com/naliehu/outbreak-report-writing.git
mkdir -p ~/.dsh/skills
rsync -a --exclude=.git outbreak-report-writing/ ~/.dsh/skills/outbreak-report-writing/
python3 -m pip install --user jinja2 matplotlib python-docx

装完是什么样:目录里没有 vendor/,能用的只有 scripts/build_report.py 一条路。

能干:事件 YAML(五个字段起)+ 个案 CSV → 六种体裁正文 + 4 张图 + md/docx/pdf(附脱敏版)+ 附录 A 缺项分级(P0 24 小时 / P1 48 小时 / P2 结案前)。

干不了:没有 93 字段模型校验,没有 L1/L2/L3 定稿阻断判定,没有「数据不全改图注」的降级矩阵,没有阶段快照与三格式一致性核对。此时 scripts/flowreport.py doctor 会红:

✗ 规格包 vendor/spec   vendor 目录不完整,找不到 report_engine:No module named 'report_engine'

B. 全量版 —— 把 vendor/ 一起带上

# 从一台已有 vendor 的机器整体同步(含 venv),不要用 git clone 拿这一份
rsync -a --exclude=.git --exclude=__pycache__ \
  /path/to/已有完整副本/ ~/.dsh/skills/outbreak-report-writing/

# 自检:八项全绿再往下走
python3 ~/.dsh/skills/outbreak-report-writing/scripts/flowreport.py doctor

装完是什么样:多出 vendor/(约 150 MB),doctor 打印 ✓ 规格包 vendor/spec 93 字段 / 11 章 / schema …。

能干:report.json(93 字段)→ 11 章 / 17 表 / 4 图 / 16 页 PDF;缺项在正文就地高亮并按 L1/L2/L3 判定是否阻断定稿;封面给 Top3 必补项;第十章给逐条补采途径与时限;存阶段快照;核对 md=docx=pdf 三格式一致。

注意:vendor/venv 里的 Python 按打包机器的架构编译,换平台会失效——脚本与插件会自动回退到系统 python3,装齐 requirements.txt 里的依赖即可;也可跑 bash install.sh(macOS/Linux)或 powershell -ExecutionPolicy Bypass -File install.ps1(Windows)现场重建 venv。

平台包(Releases)

平台文件装完即得的形态
macOS(Apple Silicon)outbreak-report-writing-<ver>-macos-arm64.tar.gz含 vendor/venv(arm64,自带独立解释器),解压改路径即用,无需 pip、不依赖本机 Python
macOS(Intel)outbreak-report-writing-<ver>-macos-x86_64.tar.gz含 vendor/venv(x86_64,自带独立解释器),Intel 机型解压即用,无需 pip
Windows(x64)outbreak-report-writing-<ver>-windows-x64.zip含 vendor/ 代码但不含 venv,先跑一次 install.ps1 建环境(需 Python 3.10+)
任意平台git clone轻量版直接可用;要全量得自备 vendor/

PDF 有两条路:装了 LibreOffice(macOS:brew install --cask libreoffice;Windows:装 LibreOffice 后默认在 Program Files 下,也可用 SOFFICE_BIN 指定)就走 docx→pdf,版式与 Word 完全一致;没装也不必折腾,程序会自动用内置的 PyMuPDF 排版引擎出 PDF(内容、图表、分页齐全,版式是独立一套,与 docx 版略有差别)。md/docx 不依赖任何外部程序。

快速上手

cd ~/.hermes/skills/outbreak-report-writing
# 全量装法用 venv 解释器;轻量装法把这行换成 PY="python3"
PY="env -u PYTHONPATH -u VIRTUAL_ENV vendor/venv/bin/python"

# 只有五个字段也能出稿
$PY scripts/build_report.py --event 事件.yaml \
    --stage initial --out ./我的输出 --formats md,docx,pdf

# 真实个案 CSV 驱动(自动出四张图)
$PY scripts/build_report.py --event 事件.yaml \
    --stage initial --line-list 个案.csv \
    --out ./我的输出 --formats md,docx,pdf

事件 YAML 与个案 CSV 自己提供,字段清单见 references/intake-playbook.md。

--stage:initial 初次/progress 进程/final 结案/closure 结案申请单/case 单例病例。

输出:同时给你两版

成稿默认出两份,-脱敏 那一份可以直接发出去:

项目未脱敏版(内部)脱敏版(外发)
姓名张一张某(同姓不同人自动加序号)
身份证 / 手机 / 固话 / 邮箱原样(略)
出生日期1995年7月30日(略),年龄保留
住址Dieburger Str. 78 Darmstadt, 64287(略)
机构 / 行政区 / 日期 / 病例数 / 罹患率保留保留

开关:--privacy both(默认)/raw 只出内部版/redacted 只出外发版。 插件里对应参数 privacy。人名清单自动从事件字段和个案 CSV 里取,正则可兜住手工写进正文的证件号。

两条路径

  • 轻量模板(scripts/build_report.py):事件 YAML 或大疫情网 CSV → 六种体裁直出。单例、临时、只有一份导出表时用这个。
  • 全量引擎(scripts/flowreport.py):report.json(93 字段/11 章)→ 四图 + 三格式 + 快照 + 签发门禁。要连出十几期进程报告、进审签流程时用这个。

两条路径的缺项分级是同一套判据的两种叫法:L1 阻断传播 = P0,L2 影响研判 = P1,L3 完善叙述 = P2。

隐私

原始流调卷宗不在本仓库内,也未随技能分发。

DSH 插件(DeepSeek Harness)

除了当技能用,本仓库本身就是一个 DSH 插件包:装进去之后,代理多出一个 epi_report 工具, 一句话就能出稿,不用记命令。

dsh plugin --profile web add github:naliehu/outbreak-report-writing
dsh --profile web          # 重启后生效,直接说「用 epi_report 出一份初次报告」

工具参数:action(build/check)、event_path(事件 YAML/JSON,必填)、stage (initial/progress/final/closure/case)、line_list(个案 CSV)、out_dir、formats、docx_profile。

插件做的事很少,也很明确:找技能目录 → 挑 Python 解释器 → 传参 → 回收产物路径。 报告怎么写、画什么图、缺项怎么分级,全在 scripts/ 里,改一次两边同时生效。

依赖按需降级:

装了能出
python3 + pyyaml + jinja2Markdown 正文(图与 Word 自动省略,并注明原因)
再加 matplotlib加四张叙事图与三间分布图
再加 python-docx加 Word;系统有 LibreOffice 则连 PDF 一起出

一次性装齐:python3 -m pip install pyyaml jinja2 matplotlib python-docx

配置(写在 profile 的 cordis.patch.yml 里,可全部省略):

- insert:
    - id: epi-report
      name: 'outbreak-report-writing'
      config:
        skillDir: ~/path/to/outbreak-report-writing   # 默认自动查找
        python: /usr/bin/python3                      # 默认优先用 vendor/venv/bin/python
        outDir: ~/流调输出                             # 默认 <事件文件同级>/流调输出

目录

SKILL.md                  技能主体(判据、流程、文风要点、常见坑)
references/               深度材料
  01 报告类型与骨架 → report-types.md(六体裁逐节写法)
  02 分病种要点.md        12 病种的笔墨重点与易混边界
  03 可视化作图规范.md     决策表 + 七条硬规范 + 图注
  06 文风与句式库.md       477 份报告的量化文风、七种功能句定式、数字六条、禁止清单
  intake-playbook.md      现场怎么问、问不到怎么办
  toolchain.md            模块契约、中文出图、排障
templates/                五套 .j2 体裁模板 + disease_profiles.yaml(可自行加病种)
scripts/                  epi_core / epi_viz / build_report / md2docx / flowreport
plugin/                   Hermes 插件源码(暴露成 epi_report 工具)
tests/                    单测

推广

  1. 整体拷走:outbreak-report-writing/ 整个目录(含 vendor/venv,约 150 MB)给同事,python3 scripts/build_report.py 就能跑,不需要联网、不需要 pip。
  2. 只要模板:把 templates/*.j2 + references/06-文风与句式库.md 拷走,手工填也是一份合规报告——技能的价值有一半在这个文档里。
  3. 装成插件:把 plugin/ 拷到 ~/.hermes/plugins/epi-report/,Hermes 里就有 epi_report 工具,一句话生成。
  4. 加病种:只改 templates/disease_profiles.yaml,不动代码。

已知限制

  • 没有合法行政区底图,地理分布只能做场所卡片/经纬度气泡示意图,不能当 GIS 专题图对外。
  • 伤寒、登革热、发热伴、食源性、基孔肯雅的潜伏期取自指南,YAML 里标了 verify: true,用前查当期方案。
  • 代际由发病时间推算(0.6×常见潜伏期阈值),不是拓扑推导;有确切接触关系时以传播链为准。
  • Word 版式的字体(仿宋_GB2312)需系统已安装,否则回退到宋体,不报错。

Comments

Loading…