ICD-10 & CPT 编码助手

一个医疗编码辅助工具，可解析临床记录并推荐合适的 ICD-10 诊断代码和 CPT 手术操作代码，附带置信度评分。

概述

该技能分析临床文档以提取相关医疗信息，并将其映射到标准化编码系统：

• ICD-10-CM：国际疾病分类第10版，临床修订版（诊断代码）
• CPT：现行操作术语（手术/服务代码）

技术难度：高 ⚠️

⚠️ 必须人工审核：医疗编码直接影响账单、报销和临床文档完整性。所有建议必须由持证医疗编码员或医务人员核实。

使用方法

python scripts/main.py --input "clinical_note.txt" [--format json|text]

或程序化调用：

from scripts.main import CodingAssistant

assistant = CodingAssistant()
result = assistant.analyze("患者主诉急性支气管炎...")
print(result.icd10_codes)
print(result.cpt_codes)

参数说明

输入格式

支持多种格式的临床记录：

• 自由文本叙述
• SOAP 记录（主观、客观、评估、计划）
• 出院小结
• 病程记录
• 手术报告

输出格式

ICD-10 推荐结果

{
  "icd10_codes": [
    {
      "code": "J20.9",
      "description": "未特指的急性支气管炎",
      "confidence": 0.92,
      "evidence": ["持续咳嗽5天", "查体发现喘息"],
      "alternatives": ["J20.0", "J44.9"]
    }
  ]
}

CPT 推荐结果

{
  "cpt_codes": [
    {
      "code": "99213",
      "description": "门诊就诊，已有患者，中等复杂程度",
      "confidence": 0.85,
      "evidence": ["详细病史采集", "低复杂度决策制定"],
      "time": "20分钟"
    }
  ]
}

置信度评分标准

• 0.90–1.00：高置信度 —— 文档清晰，映射明确无歧义
• 0.70–0.89：中等置信度 —— 文档良好，需一定解读
• 0.50–0.69：低置信度 —— 文档不完整，存在多种可能
• <0.50：极低置信度 —— 信息不足，必须人工复核

局限性

1. 不提供医疗建议：本工具不提供临床意见或诊断结论
2. 编码复杂性限制：无法处理所有编码细节（如合并症、编码顺序、附加码）
3. 地区差异：可能未考虑特定支付方的编码要求
4. 更新滞后：代码集可能未反映最新年度更新

参考资料

请参阅 references/ 文件夹中的内容：

• icd10_common_codes.json：各专科常用 ICD-10 代码
• cpt_common_codes.json：各专科常用 CPT 代码
• coding_guidelines.md：通用编码规范与惯例

安全与合规

• HIPAA 意识：处理前确保个人健康信息（PHI）已脱敏
• 审计追踪：保留自动化建议记录以满足合规要求
• 人工监督：所有编码必须经合格人员审核并批准

依赖项

• Python 3.8+
• 详见 requirements.txt 中的包依赖列表

风险评估

安全检查清单

• [ ] 无硬编码凭证或 API 密钥
• [ ] 无未经授权的文件系统访问（../）
• [ ] 输出不泄露敏感信息
• [ ] 已启用提示注入防护
• [ ] 输入文件路径已验证（防止 ../ 路径遍历）
• [ ] 输出目录限制在工作区范围内
• [ ] 脚本在沙箱环境中执行
• [ ] 错误信息已清洗（不暴露堆栈跟踪）
• [ ] 依赖项已完成审计

前置条件

# 安装 Python 依赖
pip install -r requirements.txt

评估标准

成功指标

• [ ] 主要功能正常运行
• [ ] 输出符合质量标准
• [ ] 能妥善处理边界情况
• [ ] 性能表现可接受

测试案例

1. 基础功能测试：标准输入 → 期望输出
2. 边界情况测试：无效输入 → 优雅错误处理
3. 性能测试：大数据集 → 可接受处理时间

生命周期状态

• 当前阶段：草稿
• 下次评审日期：2026-03-06
• 已知问题：无
• 计划改进：

- 性能优化

- 增加新功能支持