内容
# 代码大全 ChemDraw 技能
[简体中文](docs/zh-cn.md)
一个用于 ChemDraw 和 `cdxml-toolkit` 工作流程的 Codex 技能和 MCP 服务器,适用于 Windows。它为 Codex 提供任务级工具,用于绘制、清理、合并、渲染、识别、分析和嵌入化学结构。
这是一个独立的社区项目。它与 Revvity、Anthropic、OpenAI 或 DECIMER 项目无关。
## 功能
- 解析名称、SMILES、InChI 和常见的结构标识符。
- 以 CDXML 格式绘制和编辑结构和反应方案。
- 清洁、合并、润色、分割和渲染 ChemDraw 文档。
- 使用本地 DECIMER 模型或显式确认的远程请求转换图像。
- 在支持的 Windows 系统上将 CDXML 对象嵌入 PowerPoint 和 Word 文件中。
- 发现实验文件并处理选定的 LCMS、RDF 和实验室工作簿工作流程。
## 要求
- Windows 10 或更高版本。
- 需要授权并激活的 ChemDraw 安装,以实现原生渲染和自动化。
- Python 3.10 或更高版本;Python 3.12 是已测试的配置。
- `cdxml-toolkit==0.5.17` 是已测试的配置。
- 用于技能和 MCP 集成的 Codex CLI 或 Codex 桌面版。
ChemDraw、Microsoft Office 和本地 DECIMER 模型权重不包含在内。
## 快速入门
```powershell
git clone https://github.com/ZiChenWang114514/codex-chemdraw-skill.git
Set-Location codex-chemdraw-skill
conda create -n cdxml python=3.12 -y
conda run -n cdxml python -m pip install "cdxml-toolkit==0.5.17"
$python = (conda run -n cdxml python -c "import sys; print(sys.executable)" | Select-Object -Last 1)
Set-ExecutionPolicy -Scope Process Bypass
& .\scripts\install.ps1 -Python $python -Apply -ConfigureMcp
```
安装后重启 Codex,然后验证集成:
```powershell
codex mcp get cdxml-toolkit --json
& "$HOME\.codex\skills\chemdraw\scripts\health_check.ps1" -Python $python
```
安装程序是只读的,除非提供 `-Apply` 参数。现有的技能和 MCP 配置文件将在替换前备份。
## 文档
- [项目指南](docs/guide.md):安装、运行时发现、架构、测试、安全性和第三方边界。
- [贡献](.github/contributing.md):开发工作流程和拉取请求期望。
- [安全](.github/SECURITY.md):私有漏洞报告和支持的版本。
可部署的技能位于 [`skill/chemdraw`](skill/chemdraw)。存储库特定的说明位于 [`AGENTS.md`](AGENTS.md)。
## 安全
除非调用者显式确认上传,否则远程图像识别将被禁用。修改工具默认创建新的输出路径并拒绝意外覆盖。化学输出必须在科学使用前与源材料进行检查。
## 许可证
存储库作者的代码和文档根据 [MIT 许可证](LICENSE) 授权。第三方软件保留其自身的许可证: [ChemDraw](https://revvitysignals.com/products/research/chemdraw)、 [cdxml-toolkit](https://github.com/kienerj/cdxmltoolkit) 和 [DECIMER](https://github.com/Kohulan/DECIMER-Image_Classifier)。