personal-genomics

Personal Genomics Skill 是一款专为 AI 代理设计的综合性本地基因分析工具，支持解析 23andMe、AncestryDNA、MyHeritage 等主流消费级基因检测数据，以及 VCF 格式的全基因组/外显子组数据。

核心用法：用户通过命令行运行 Python 脚本，指定 DNA 文件路径，工具即在本地完成分析。系统内置 1600+ 遗传标记数据库，覆盖 30 个分析类别，输出包括 AI 优化的 agent_summary.json、完整的 full_analysis.json、人类可读的 report.txt 以及专业级 PDF 报告。支持药物相互作用检查、睡眠优化建议、运动表现分析等模块化功能。

显著优点：首先，隐私保护极致，所有分析在本地运行，零网络请求，杜绝基因数据泄露风险。其次，分析维度全面，涵盖药物基因组学（159 个标记）、多基因风险评分（277 个）、携带者状态（181 个）、祖源组成、单倍群追踪以及遗传性癌症筛查（BRCA、Lynch 综合征等）。第三，输出专业，可生成医师可分享的 PDF 报告，并支持遗传咨询师导出格式。第四，集成临床级数据库，如 CPIC 药物指南和 ACMG 变异分类标准。

潜在局限：作为 T3 级社区开源项目，虽代码透明可审计，但缺乏官方医疗机构背书。技术层面，消费者芯片仅覆盖约 0.1% 基因组，无法检测罕见变异；单倍群分析在没有全基因组测序时分辨率有限。此外，结果为概率性预测而非确定性诊断，大多数疾病受非遗传因素影响占比 50-80%。

适合人群：消费级基因检测用户（23andMe/AncestryDNA 等）、健康数据研究者、祖源探索爱好者、药物基因组学关注者，以及需要本地隐私保护环境下处理敏感基因数据的用户。

使用风险：主要风险在于敏感数据管理，输出的报告包含个人健康信息，需加密存储以防泄露。用户可能误将筛查结果当作医学诊断，忽视"仅供参考"的免责声明。此外，阴性癌症筛查结果不能完全排除综合征风险，可能导致虚假安全感。建议高发现象（如 BRCA 致病突变、APOE ε4/ε4 基因型）用户寻求专业遗传咨询。

核心用法

Personal Genomics Skill 是一款面向 AI agent 的本地 DNA 分析引擎，支持 23andMe、AncestryDNA、MyHeritage 等主流消费级基因检测数据，以及 VCF 格式的全基因组/外显子组数据。用户通过 Python 命令行或 API 调用启动分析，输出包含 JSON 结构化数据、人类可读文本及专业 PDF 报告。

核心分析模块涵盖 21 个类别：药物基因组学（159 个标记）、多基因风险评分（277 个）、携带者状态（181 个）、健康风险（233 个）、祖源成分与单倍群、遗传癌症 panel（BRCA/Lynch 综合征）、自身免疫 HLA、疼痛敏感性、睡眠优化、运动表现、营养代谢等。特别值得关注的是 Pharmacogenomics 模块，可检测 DPYD、CYP2D6、HLA-B*5701 等关键变异，预警 5-FU 致命毒性、卡马西平 Stevens-Johnson 综合征等严重药物不良反应。

v4.1 新增的药物相互作用检查器整合 CPIC 临床指南与 PubMed 文献，支持输入药品商品名或通用名返回分级警示（critical/serious/moderate）及替代方案建议。PDF 报告采用 ACMG 风格分类，可直接分享给医生或遗传咨询师。

显著优点

1. Privacy-by-Design 架构：纯本地运行，零网络请求，符合 GDPR Article 25/32 要求，从源头杜绝基因数据泄露风险
2. 临床级功能覆盖：BRCA1/2 综合检测、Lynch 综合征、Li-Fraumeni 综合征等遗传癌症 panel；ACMG 风格致病性分类
3. 药物安全导向：整合 FDA 警告标志与 CPIC 指南，对 DPYD 缺陷、HLA-B*1502 等位点触发强制 alerts
4. 多模态输出：AI 优化的 agent_summary.json（优先级排序）、完整 full_analysis.json、人类可读 report.txt、医生级 PDF
5. 扩展生态：支持导出至 Apple Health、遗传咨询师临床格式、API-ready JSON

潜在局限

• 检测范围限制：消费级芯片仅覆盖 ~0.1% 基因组，无法检测罕见变异；WGS 数据虽支持但单倍群分辨率仍受限
• 概率性解读：结果为风险估计而非确定性诊断，大多数疾病遗传贡献度仅 20-50%
• 假阴性风险：阴性癌症筛查结果不能排除遗传综合征，需结合家族史判断
• 人群偏倚：PRS 模型基于欧洲队列，对其他祖源群体预测效力可能下降
• 心理影响：APOE ε4/ε4（阿尔茨海默 ~12x 风险）等发现可能引发用户焦虑，需主动建议遗传咨询

适合人群

• 已有 DTC 基因数据希望深度解读的健康管理者
• 关注药物基因组学的长期用药患者（华法林、氯吡格雷等窄治疗指数药物）
• 有癌症家族史需初步筛查遗传风险的个体（需后续确认性临床检测）
• 生物黑客与量化自我爱好者优化睡眠、运动、营养策略
• 备孕夫妇评估携带者状态

常规风险

• 临床误诊风险：用户可能将筛查结果误认为诊断，忽视环境/生活方式因素
• 药物自行调整：基于 PGx 结果擅自停药或换药，缺乏医生监督
• 保险/就业歧视：尽管 GINA 提供部分保护，但人寿保险等领域仍存在基因信息滥用可能
• 心理负担：高疾病风险评分可能导致健康焦虑或抑郁
• 数据残留：报告文件默认保存于 ~/dna-analysis/reports/，建议用户配置加密存储