化学结构课件助手

为什么需要这个技能

教学课件里的化学结构图，很容易被“AI 直接画”毁掉。图像生成工具画出来的分子，键长、环系、手性标记全凭运气，布洛芬、萘普生这类带手性中心的药物更是重灾区——画出来可能带着 this enantiomer、unknown chirality 的噪声文字，或者干脆把结构画错。结构一旦错了，整份教学材料的权威性就没了。

这个技能要解决的是两件具体的事：生成教学材料（网页或 PPT）时，每个化学结构都走确定性管线；或者拿到一份结构画错的 HTML，需要只换结构图、其余内容零改动地修正。

核心能力：确定性管线，AI 只做调度

核心铁律是：化学结构绝不交给 AI 图像生成直接画。所有结构统一走这条管线：

需求 → 识别化合物 → 取权威 SMILES（查素材库 / PubChem）→ 确定性渲染（OpenChemLib）→ 嵌入文档 → 校验

AI 只负责理解需求、规划排版、写文案、调度渲染器，结构正确性由确定性引擎保证。

渲染器选用 OpenChemLib（早期方案 SmilesDrawer 已弃用，其 2.1.6 对 Kekulé 形式 SMILES 兼容性差，会导致整页渲染失败）。网页端从 CDN 引入，一行代码出矢量 SVG：

OCL.Molecule.fromSmiles(smi).toSVG(400, 300, 'svgId', opts)

关键细节是必须关闭手性 / ESR 文字标注——toSVG 的第 4 参传入 {suppressChiralText:true, suppressCIPParity:true, suppressESR:true, noStereoProblem:true}，否则结构图会出现干扰文字。注意第 3 参是 svg id（字符串），options 是第 4 参，放错位置不生效。

技能自带 31 个常教化合物的权威 SMILES / CAS / CID 素材库，均已通过 PubChem 校验。库中没有的化合物，用 scripts/build_library.py 以英文名回查 PubChem 重建（手写 SMILES 易错，禁用）。生成后再过 scripts/validate_smiles.py 做 CID / InChIKey 对照，FAIL 即退回重取，绝不让错误结构进文档。

校验重点：五大教学陷阱

1. 手性：@ 丢失会导致 CID 漂移（布洛芬 114864→3672），CID 对照必抓
2. 盐型 / 混合物：SMILES 含 . 即多组分，需确认是否为临床盐型
3. 互变异构：PubChem 只返回一种形式，教学前定标准存库
4. 质子化 / 芳香性：非自动可判，靠教学标准
5. CID 多登记：地高辛按 name 查询会返回错误的 CID，需用权威 CAS 锚定

适用边界

• 渲染依赖联网（OpenChemLib CDN），离线环境需预先用 Node 端批量导出 SVG 素材
• PPT 场景中结构先单独渲染成 SVG/EMF 矢量素材再嵌入，严禁让 AI 在 PPT 内自画
• 修正已有 HTML 时，替换脚本会自动校验“去掉 src 后两文件逐字节一致”，确保零改动
• 需要登录态才能抓取的链接，需用户先下载文件再本地处理