ChemVision Agent Skill

July 3, 2026 · View on GitHub

PilotDeck 生态共创挑战赛 参赛作品 | AI PC Agent Skills 征文活动参赛作品

用 ≤35B 本地小模型驱动化学工具调用，通过 PubChem 真实数据库消除 LLM 化学幻觉 | 已上线 ClawHub，支持 PilotDeck / QwenPaw 一键导入

🔗 PilotDeck 官方 GitHub → OpenBMB/PilotDeck — 以 WorkSpace 为核心的开源智能体操作系统

项目简介

ChemVision Skill 是一个本地运行的化学数据查询服务，供 Agent（PilotDeck / QwenPaw / Trae）调用。核心创新：

LLM 不再"凭记忆"生成化学数据，而是通过调用 PubChem / OPSIN 真实化学数据库来验证事实，大幅减少化学幻觉。

架构

用户: "苯甲酸的分子结构是什么？"
    ↓
PilotDeck / QwenPaw + Qwen3.6-35B-A3B（本地 ≤35B 模型）
    ↓ 读取 SKILL.md，识别为化学问题
    ↓ 将中文翻译为英文（Agent 自行完成）
    ↓ 调用 POST /api/tools/call
┌───────────────────────────────────────┐
│  name_to_structure → PubChem + OPSIN  │  化学数据查询服务
│  inspect_smiles    → PubChem          │  （纯数据，零 LLM 依赖）
│  safety_info       → PubChem Safety   │  （递归提取 42+ 安全字段）
│  predict_reaction  → PubChem          │
└──────────┬────────────────────────────┘
           ↓ JSON 结果 + svg_url
    Agent 格式化回答 + 打开分子结构图截图
    ↓
send_file_to_user → 用户看到化学数据 + 分子结构图

4 个化学工具

工具	功能	数据源	输入语言
`name_to_structure`	化学名称→SMILES/分子式/分子量 + 结构图	PubChem + OPSIN	英文
`inspect_smiles`	SMILES→化学信息查询	PubChem	—
`safety_info`	化学品安全信息（GHS、危险标识、42+ 字段）	PubChem Safety	英文
`predict_reaction`	反应物化学数据查询（Agent 自行推测反应）	PubChem	英文

中文输入处理：工具只接受英文名称。用户输入中文时，Agent 自动翻译为英文后调用工具。工具返回 hint 提示 Agent 翻译重试。

渲染能力

端点	功能	引擎
`GET /api/svg/{smiles}`	分子结构图	smiles-drawer.js
`GET /api/formula/{eq}`	化学方程式（下标、上标、箭头、条件标注）	KaTeX + mhchem

快速开始

方式一：ClawHub 一键导入（推荐，PilotDeck / QwenPaw 通用）

已在 ClawHub / Modelscope 发布，可直接在 PilotDeck 或 QwenPaw 中搜索 chemvision 一键导入 Skill。

# PilotDeck 中：设置 → Skills → 从 ClawHub 安装 → 搜索 "chemvision"
# QwenPaw 中：Skill 市场 → 搜索 "chemvision" → 一键安装

安装后启动服务：

cd {skill_install_dir}
pip install -r requirements.txt
python manage.py start

方式二：手动安装

前置要求

Python 3.10+
PilotDeck / QwenPaw / Trae（任意 Agent 框架均可）

安装

cd chemvision-skill
pip install -r requirements.txt

启动服务

python manage.py start
# 输出: {"status": "started", "pid": 12345, "port": 8899}

管理服务

python manage.py status    # 查看状态
python manage.py stop      # 安全停止（不影响 Agent 主进程）
python manage.py restart   # 重启

在 PilotDeck 中使用

在 PilotDeck 中导入 SKILL.md（或从 ClawHub 一键安装）
对话框输入：苯甲酸的分子结构是什么？
Agent 自动翻译 → 调用工具 → 返回数据 + 结构图

在 QwenPaw 中使用

将 chemvision-skill.zip 导入 QwenPaw
对话框输入：苯甲酸的分子结构是什么？
Agent 自动翻译 → 调用工具 → 返回数据 + 结构图

测试验证

健康检查

curl http://localhost:8899/api/health
# {"status":"ok","tools_count":4,"tools":["name_to_structure","inspect_smiles","safety_info","predict_reaction"]}

化学名称解析

curl -X POST http://localhost:8899/api/tools/call \
  -H "Content-Type: application/json" \
  -d '{"tool_name":"name_to_structure","arguments":{"name":"benzoic acid"}}'

返回 SMILES、分子式、分子量、svg_url（分子结构图链接）。

安全信息查询

curl -X POST http://localhost:8899/api/tools/call \
  -H "Content-Type: application/json" \
  -d '{"tool_name":"safety_info","arguments":{"query":"benzene"}}'

返回 GHS 危险标识、危害声明、防护措施等 42+ 字段。

化学方程式渲染

浏览器打开: http://localhost:8899/api/formula/CH3COOH+C2H5OH<=>[浓硫酸][加热]CH3COOC2H5+H2O

KaTeX + mhchem 专业渲染，条件自动分列箭头上下：

        浓硫酸
CH₃COOH + C₂H₅OH  ⇌  CH₃COOC₂H₅ + H₂O
         加热

设计理念

为什么选择"化学"场景？

化学是 LLM 幻觉最严重的领域之一。SMILES、分子式、分子量等数据必须精确——一个数字错误就是完全不同的物质。传统 LLM 凭记忆生成的化学数据经常出错。

我们的解决方案：Agent 的"大脑"负责理解用户意图和组织回答，但具体化学数据全部来自 PubChem 真实数据库。这就是 Agentic AI 的核心价值 —— LLM 负责推理，工具负责事实。

工程亮点

零 LLM 依赖：工具服务本身不调用任何模型，纯数据查询
双源容错：PubChem + OPSIN 双数据源，主源失败自动切换
职责清晰：中文翻译由 Agent（LLM）完成，工具只做数据查询
安全数据递归提取：PubChem Section 树深度遍历，42+ 安全字段
KaTeX + mhchem 渲染：专业化学方程式渲染，全部本地加载
安全进程管理：manage.py 用 PID 文件精确追踪，不影响 Agent 主进程
ClawHub / ModelScope 发布：支持 PilotDeck / QwenPaw 一键导入，降低使用门槛

项目结构

chemvision-skill/
├── SKILL.md              ← Agent 框架读取的技能定义（PilotDeck / QwenPaw 通用）
├── manage.py             ← 服务生命周期管理
├── chemskill/
│   ├── server.py         ← FastAPI 工具服务
│   ├── config.py         ← 配置
│   ├── tools/            ← 4 个化学工具
│   ├── utils/            ← PubChem + OPSIN 客户端
│   └── static/
│       ├── smiles-drawer.js  ← 分子结构渲染
│       ├── katex.min.*       ← KaTeX 数学渲染
│       ├── mhchem.min.js     ← 化学方程式扩展
│       └── fonts/            ← KaTeX 字体
├── requirements.txt      ← 仅 4 个依赖（fastapi, uvicorn, httpx, pydantic）
└── pyproject.toml

License

MIT