核心用法
Clarity Clinical Skill 是面向基因组学与临床遗传学的专业查询工具，通过 Clarity Protocol 协议整合 ClinVar 与 gnomAD 两大权威数据库。用户可按基因符号（如 MAPT）检索变异列表，或通过 HGVS 标准命名法（如 NM_005910.6:c.926C>T）获取特定变异的详细注释。支持原始 JSON 与可读摘要两种输出格式，便于科研分析与临床报告生成。
显著优点
双权威数据源整合：同时覆盖 ClinVar 的临床致病性分级（Pathogenic/Benign/Uncertain 等）与 gnomAD 的全球人群等位基因频率，实现从"是否致病"到"有多常见"的完整评估链条。
标准化变异表示：强制采用 HGVS 命名规范，确保查询结果的可复现性与国际互认性，避免基因组坐标系统混乱导致的误判。
临床分级透明度高：不仅返回最终分类，还附带 ClinVar 的评审状态星级（review status）与最后评估日期，帮助用户判断证据强度与时效性。
频率分层解读：内置 gnomAD 频率阈值解释（<0.01% 极罕见至 ≥1% 常见），降低人群遗传学数据误读风险。
潜在缺点与局限性
速率限制约束：匿名用户仅 10 次/分钟，虽有 API Key 可提升至 100 次/分钟，但大规模队列筛查仍可能受限；且文档未披露 API Key 获取成本与商用条款。
数据时效依赖上游：ClinVar 与 gnomAD 的更新周期独立于本工具，若源数据库收录滞后或存在争议性重新分级，本地查询结果可能未能反映最新共识。
功能边界有限：专注单基因/单变异查询，缺乏连锁不平衡分析、多基因风险评分（PRS）或表型-基因型关联挖掘等进阶功能。
错误处理粒度粗：500 服务器错误仅建议"稍后重试"，未提供详细状态码诊断或本地缓存降级方案。
适合人群
- 临床遗传咨询师与分子诊断实验室技术人员
- 肿瘤精准医疗研究员（评估体细胞突变 germline 背景频率）
- 生物信息学工程师构建变异注释流水线
- 医学遗传学研究生与继续教育学员
常规风险
数据误读风险：ClinVar 的"Conflicting interpretations"与"Uncertain significance"占相当比例，需结合家系共分离、功能实验等证据综合判断，切勿将单条数据库记录直接用于临床决策。
频率-致病性混淆：gnomAD 中的高频变异若出现于晚发疾病基因，可能反映疾病外显率不足而非良性本质，需区分"常见"与"无害"。
隐私合规：查询罕见病致病变异可能间接暴露患者表型，建议在脱敏环境或获得知情同意的框架下使用。
服务可用性：依赖 clarityprotocol.io 的在线服务，离线环境或网络受限场景下无法使用，关键分析应预留本地备份数据库（如 VEP + 下载版 ClinVar VCF）作为冗余。