3DOptix

面向 AI 编码 Agent 的 3DOptix

通过 3DOptix 云平台，直接使用编码 Agent 设计、模拟和分析光学系统。

此仓库是一个插件——它将 3DOptix MCP 服务与一个教 Agent 如何高效使用它的技能打包在一起。安装一次，你的 Agent 就能搭建光学装置、放置透镜和探测器、运行 GPU 光线追迹模拟和高级光学分析。

此处的技能遵循 Agent Skills 开放标准，因此可用于 Claude Code、Codex、Cursor 和其他兼容客户端。

---

安装

Claude Code

claude plugin marketplace add 3doptix/skills
claude plugin install 3doptix@3doptix

Codex

codex plugin marketplace add 3doptix/skills
codex plugin add 3doptix@3doptix

仅安装 MCP 服务

如果你只想使用工具而不需要工作流指导，该服务已在 MCP Registry 中列出，名称为 com.3doptix/optical-design；也可以直接添加：

claude mcp add --transport http 3doptix https://mcp.3doptix.com

连接你的账户

你需要一个 3DOptix 账户。在 3doptix.com 注册的新用户可获得功能完整的试用版；若要继续使用，则需要订阅。

身份验证采用 OAuth 2.0 和动态客户端注册。无需粘贴 API 密钥。

• Claude Code — 运行 /mcp，选择 3doptix，然后通过浏览器登录。
• Codex — 运行 codex mcp login 3doptix。

然后让 Agent 列出你的装置，确认连接成功。Agent 也可以引导你完成此过程——连接错误时，内置的 3doptix-setup 技能会自动启用。完整的故障排除指南：skills/3doptix-setup/SKILL.md。

---

包含内容

技能	涵盖内容
3doptix-workflow	创建装置、放置和对齐组件、光源、探测器、目录和自定义光学元件、模拟、分析、优化、Zemax 导入、CAD 上传
3doptix-setup	连接和验证 MCP 服务；身份验证错误时自动启用

3doptix MCP 服务提供用于管理装置、零件、光学和光机目录、模拟、分析及渲染的工具。工具参考：3doptix.com。

试试看

Build a 2-lens beam expander for a 5 mm 632 nm beam, 3× magnification,
then run a spot diagram on the output.

Import my Zemax file into 3DOptix and tell me where the aberrations are worst.

---

仓库结构

.claude-plugin/     Claude Code plugin + marketplace manifests
.codex-plugin/      Codex plugin manifest
.agents/plugins/    Codex marketplace manifest
.mcp.json           The 3DOptix remote MCP server
server.json         MCP Registry entry
skills/             Agent Skills — shared by every store
assets/             Store icons (the spectral sphere from the 3DOptix mark)
scripts/            validate.js, set-version.js — plain Node, no dependencies

技能内容只存放在一个位置。每个商店都有一个小型清单，指向同一个 skills/ 目录树——不会为每个客户端重复内容。

无需构建步骤。技能采用 Markdown 编写，清单采用 JSON 编写，因此你在此处看到的内容就是实际安装的内容。

---

参与贡献

添加技能

创建 skills/<name>/SKILL.md，并包含必需的 frontmatter：

---
name: your-skill-name
description: "When this skill should and should not trigger."
---

name 必须与目录名称一致——每个商店都会执行此项检查。将按需加载的内容放入 skills/<name>/references/，并在 SKILL.md 中引用。技能通过目录发现，因此无需在清单中注册新技能。

只有 skills/ 下的技能会随项目发布。仍在开发中的技能应放在 inactive-skills/ 目录中——商店不会扫描该目录，因此技能可以留在仓库中，而不会发布给用户。

检查

node scripts/validate.js

无需安装，也没有依赖项。此脚本会根据 Agent Skills 规范检查技能 frontmatter，确认四份清单的版本一致，并确保 .mcp.json 不会包含凭据。CI 会在每次推送和拉取请求时运行同一脚本。

发布更改前，还要确认用户实际会收到哪些内容：

claude plugin details 3doptix

发布版本

.claude-plugin/plugin.json 保存权威版本号。要发布新版本：

node scripts/set-version.js 1.1.0   # writes all four manifests
node scripts/validate.js
git commit -am "release: 1.1.0" && git tag v1.1.0
git push && git push --tags

切勿手动编辑清单中的 version——validate.js 会因此检查失败，这正是预期行为。

列出此插件的目录会跟踪 main 分支上的提交并自动获取更改，因此无论是否打标签，推送即为发布。仍应打标签；用户可通过它固定到已知的稳定版本。

---

支持

• 产品和账户 — [email protected]
• 这些技能中的 Bug — 在此代码库中提交 issue
• 隐私 — 隐私政策

许可证

MIT — 详见 LICENSE。