surfcad

surfcad-agent

为自带 Agent 提供的 SurfCAD 技能和辅助库。SurfCAD 是一款基于定制 Manifold 内核的 Web CAD 应用。Agent 使用自己的模型。本仓库不包含 API 密钥，也不会调用托管模型。

预发布版。 版本 0.1.0 包含目录树结构、随仓库提供的辅助运行时和技能。packages/mcp-server 中的 MCP 服务只是占位项（stdio 进程将在后续版本中提供）。此版本不包含 server.json 和注册表发布流程。本目录树中的任何内容都不会发布到 npm。

npm 上已存在 surfcad 和 surfcad-mcp，均为 0.0.1 占位包（标记为“即将推出”）。本仓库中的包版本为 0.1.0，尚未发布。插件 .mcp.json 指向 [email protected]；在该版本发布之前，无法从注册表解析此包。

许可证：Apache-2.0。

目录结构

.claude-plugin/marketplace.json     marketplace name: surfcad-agent
plugins/surfcad/                    plugin name: surfcad (no bin/)
  .claude-plugin/plugin.json
  .mcp.json                         npx -y [email protected]
  skills/surfcad/SKILL.md           skill name: surfcad
  skills/surfcad/references/
packages/surfcad/                   npm surfcad, the helper library
  UPSTREAM                          pinned 3dculos SHA
  vendor/                           copy of that commit's sync-files.json list
packages/mcp-server/                npm surfcad-mcp, placeholder
scripts/sync-3dculos.mjs            re-vendor the pin
scripts/gen-references.mjs          regenerate four skill references

这里只有一个技能文件夹，没有 .claude/skills 或 .agents/skills 副本。

辅助库

packages/surfcad 重新导出 loadManifold、runScript、helperScope 以及 STL / 3MF / STEP 导出器。wasm 文件位于 vendor/built/manifold.wasm，从包目录解析，因此无需依赖进程的工作目录，即可从 node_modules/surfcad 正常工作。这是 3dculos 随附的定制内核，并非 npm manifold-3d。

固定版本为 packages/surfcad/UPSTREAM 中的完整 SHA。npm run sync 会从 GitHub 下载该提交，将 sync-files.json 中的每个 runtimeFiles 和 catalogFiles 路径复制到 vendor/（保留路径），并写入 vendor/MANIFEST.json。CI 会再次运行同步；如果目录树存在差异，检查将失败。

npm test

请在此目录中运行该命令。无头测试会构建一个带圆角的盒子、一个双实体装配体和一块弯折钣金，并检查状态、边界框、体积、实体数量，以及 STL、3MF 和 STEP 文件是否非空。

安装技能

Agent	技能	MCP
Claude Code	/plugin marketplace add artur0x0/surfcad-agent，然后运行 /plugin install surfcad@surfcad-agent	插件 .mcp.json 会在该版本发布后启动 npx -y [email protected]。独立安装：claude mcp add --transport stdio surfcad -- npx -y [email protected]
claude.ai / Cowork	依次选择 Customize、Plugins、Add marketplace artur0x0/surfcad-agent，或上传 plugins/surfcad 文件夹	Chat 需要远程 HTTP 服务。此版本仅提供 stdio 配置，因此 Chat 可获取技能，但无法使用工具
Claude API	上传 plugins/surfcad/skills/surfcad（name 与文件夹名称一致）	—
Grok Build	可读取此 Claude marketplace，或运行 npx skills add artur0x0/surfcad-agent -a grok	grok mcp add surfcad -- npx -y [email protected]
Hermes	hermes skills install artur0x0/surfcad-agent/plugins/surfcad/skills/surfcad	hermes mcp add surfcad --command npx --args -y [email protected]
其他 Agent	npx skills add artur0x0/surfcad-agent	发布后的注册表名称：io.github.artur0x0/surfcad

该技能的 frontmatter 仅包含 name、description、license、compatibility、metadata 和 allowed-tools。metadata.version 是字符串 "0.1.0"。