xiaoran8210/case-report-ppt 是一个面向医疗病例汇报的 Codex skill，用来把混合病例文件夹整理成结构化外科病例 web deck。它的默认输出是单文件 HTML 横向演示，而不是 .pptx：核心文件是 ppt/index.html，图片和素材放在 ppt/images/。

这个仓库适合处理真实工作中常见的混合材料：入院记录、病程摘要、PDF 报告、病理、内镜截图、CT/MRI 图像、随访资料、文献笔记和粗糙 PPT。现有 PPT 会被当作内容来源，不会继承它的视觉模板。

安装和最小调用

仓库默认分支是 main，根目录包含 SKILL.md、README.md、assets/、references/、examples/ 和 agents/。安装到 Codex 本地 skills 目录时，目录名建议保持为 case-report-ppt：

mkdir -p ~/.codex/skills
git clone https://github.com/xiaoran8210/case-report-ppt.git ~/.codex/skills/case-report-ppt

调用时给出病例资料文件夹路径，并明确要构建病例汇报 deck：

Use $case-report-ppt to build a surgical case report deck from this case folder.

这个 skill 没有要求本地构建步骤。最终 ppt/index.html 可直接在浏览器打开，横向导航支持键盘、鼠标滚轮、触摸滑动、底部 dots 和 ESC 索引。

先准备中性病例文件夹

仓库不包含真实病例，examples/case-folder-spec.md 给了一个中性测试结构。资料最好按类型和日期拆开：

sample-case/
  notes/
  reports/
  imaging/
  rough-deck/
  literature/

命名建议使用 YYYY-MM-DD 日期，把同一次检查的影像放在同一组文件夹里，内镜和病理材料尽量分开。粗糙 PPT 只有在能保留原始临床逻辑时才需要放入。

最低信息包括一般状态和主诉、关键诊断检查、或疾病评估、治疗序列、核心教学点。缺失或冲突的字段不能硬写进最终 deck，应先进入 missing-information checklist。

为什么它不是普通病例 PPT 压缩器

SKILL.md 强调医学逻辑优先。deck 应按疾病演变和治疗进展组织，而不是按“材料出现顺序”或普通汇报模板塞页。每页只回答一个临床问题或一个证据块。

例如，一般状态不要和发病线索合并，初始诊断不要和第一个 MDT 问题合并，手术叙述和术后病理在病理重要时也要拆开。内镜、病理、关键影像如果各自提供不同结论，就应分成独立页面。

这条规则对病例汇报很重要。页数少不等于清楚，尤其在肿瘤、复发、多阶段治疗或诊断冲突场景里，压缩过度会损害病程理解。

guizang 引擎提供什么

最终演示使用仓库内置的 guizang web-PPT 模板：assets/guizang-template.html。它锁定了三层字体体系：大标题和引用用 serif，正文解释用 sans-serif，日期、标签和导航元数据用 monospace。

主题有五个预设：Ink Classic、Indigo Porcelain、Forest Ink、Kraft Paper、Dune。布局族有十类，包括 hero cover、act pider、big-number spread、left-text right-image、image grid、pipeline、suspense question、big quote、before/after comparison、lead-image mixed editorial layout。

医疗内容使用时，主题应服务于清晰度。影像、病理和信息不能被视觉效果盖住，正文页的 WebGL 或 dispersion 背景要比封面更克制。

输出文件和检查重点

一次病例 deck 预期包含 ppt/index.html、ppt/images/、病例摘要、缺失信息清单、全病程时间线或时间线章节，以及一段假设说明。时间线不是装饰，而是核心产物。

复杂肿瘤或复发病例建议使用 multi-track timeline，把检查/影像、诊断/、治疗、疗效或复发并行放出来。时间轴要显式呈现会影响教学点的诊断不确定性。

正式检查时重点看：时间顺序、和病理措辞、内镜/影像图与结论是否对应、图片标签是否有日期和模态、核心教学点是否放在病程事实之后、页面是否溢出、浏览器导航是否可用。

隐私和公开仓库边界

README 明确说明仓库已经做公开发布清理：不包含真实患者病例文件夹，不包含真实生成 deck，不包含患者姓名或标识，也不包含作者、医院或科室名称。自己使用时也应先完成病例材料脱敏，再交给 skill 处理。

xiaoran8210/case-report-ppt 的优势是把病例资料整理、医学叙事、guizang 视觉引擎和输出检查放在同一条路径里。它不追求把病例压成最少页数，而是让每个关键证据和教学问题在 HTML deck 中有清楚的位置。