用自然语言问 Agent，不用先学命令

Immake 通过公开 CLI 分发，但正常使用入口是你的 Agent。只需在 Codex 或 Claude Code 中安装一次 Skill，选中受支持的单零件 CAD 文件，然后直接描述你想知道的制造问题。

分析 /absolute/path/bracket.step。这个零件能不能加工？建议三轴还是五轴？
实际需要几次装夹？H2 加工工时是多少？有哪些 DFM 风险需要重点处理？

Skill 会给 Agent 一套明确规则：只读取你指定的文件，只调用一次分析，保留各组件的真实状态，并把结构化结果整理成通俗的制造说明，而不是丢给你一堆 CLI 参数或 JSON。

一分钟完成安装

需要 Node.js 20 或更高版本。

把这句话交给 Agent

请按照 https://www.immake.com/open/immake-cli/installation.md 安装 Immake

安装契约会告诉 Agent 如何完成安装、检查连接并说明怎么开始第一次分析，不需要你手工输入命令。

也可以手工安装

安装到 Codex：

npm install -g @immake/cli@latest
immake install --agent codex --json
immake doctor --json
immake login

安装到 Claude Code 时，把 codex 改成 claude。只有明确需要同时安装到两者时才使用 --agent all。doctor 只检查服务连通性和当前能力，不会读取或上传零件。login 会打开 10 分钟有效的浏览器设备授权；终端不会收集网站密码。

账户、能力与额度

• immake login、logout、whoami、quota 和 devices 用于管理个人账户与 CLI 设备。
• immake login --json 会先把包含浏览器地址和设备码的 authorization_required 事件写入 stderr，授权成功后再把最终 JSON 写入 stdout。
• Free 账户每个 UTC 自然月可分析 50 个零件；默认能力为 Geometry，并有终身 10 个零件的任意高级能力组合体验。
• Pro 账户每个 UTC 自然月可分析 500 个零件，可显式请求 geometry、dfm、machining、preview_3d、thumbnail 五项能力。
• 同一个零件无论组合几项能力都只占一次月度次数；轮询、查看结果和幂等重试不会重复计数。
• 登录凭据保存在用户的 Immake 配置目录，POSIX 权限为 0600；网站可以撤销任意 CLI 设备。

Immake 能帮你回答什么

| 制造问题 | 返回的依据 | 详细说明 | | --- | --- | --- | | 这是一个什么零件？ | 明确标注的全局 X/Y/Z 包围盒、车间长×宽×厚、实体体积、表面积、复杂度和源文件格式 | 图纸尺寸与相关信息 | | 应该选什么毛坯？ | 几何最小毛坯，以及单独展示的实际加工毛坯来源、局部坐标、车间长×宽×厚、体积、重量和包络检查 | 报价前置分析 | | 应该走三轴、车铣还是五轴？ | 只返回一个最终建议：three_axis、mill_turn 或 five_axis | 路线与刀具可达性 | | 实际需要几次装夹？ | 内部选中可执行三轴路线时，只返回一份装夹次数、置信度和验证状态 | 装夹次数判断 | | 加工需要多长时间？ | H2 原始刀路总工时、实际返回的规划阶段，以及孔加工、粗加工、精加工和去毛刺分类 | 加工时间 | | 哪些地方不好加工？ | 结构化 DFM 严重程度、位置、原因、建议和关联的 3D 节点 | DFM 检查 | | 能不能直观看结果？ | 3D 预览和缩略图状态，以及可用时返回的公开结果链接 | 分享分析结果 | | 能不能自动报价？ | 登录后对单实体可执行三轴结果，使用网页后台的版本化费率生成含利润和税费的自动估算报价 | 成本前置检查 |

H2 总工时、规划阶段工时和四类 CNC 工时是同一份加工时间的不同视图，不能相互重复相加。

一份典型的 Agent 回答

以下数值是演示数据。真实回答来自你选中的模型，并会保留缺失或未完整组件的状态。

零件： bracket.step

• 几何： 包围盒 120 × 80 × 36 mm；实体体积 184.2 cm³；中等复杂度。
• 加工路线： 建议 three_axis；只显示一份 2 次装夹预测、置信度和验证状态。
• H2 工时： 原始刀路总工时 42.6 分钟。粗加工、精加工、孔加工和去毛刺是这个总工时的分类视图，不是额外工时。
• DFM： 深腔刀具可达性和小径深孔需要在投产前复核；每个问题都说明位置和后续处理建议。
• 结果状态： 即使 DFM 或 3D 预览存在缺口，已经完成的几何和工时结果也会继续保留，不会被包装成“全部成功”。

这才是 Agent 应该给你的答案：有制造结论、有数据依据、有边界，也告诉你下一步需要确认什么，而不是原样输出机器数据。

直接使用 CLI

Agent 正常分析应使用有界输出：

immake analyze "/absolute/path/part.step" --capabilities geometry,dfm,machining,preview_3d,thumbnail --wait --compact-json

一次最多分析 5 个明确指定的文件：

immake analyze "/absolute/path/a.step" "/absolute/path/b.x_t" --capabilities geometry,dfm,machining --wait --compact-json

已知真实毛坯时应明确传入，不能偷偷改成几何最小毛坯：

immake analyze "/absolute/path/block.step" --stock-box 20 868 175 --wait --compact-json
immake analyze "/absolute/path/round.step" --stock-cylinder 60 25 --wait --compact-json

从已有批次读取某一部分，不需要重新上传：

immake analyze status <batch-id> --extract route
immake analyze status <batch-id> --extract dfm

三种输出模式互斥：

• --compact-json：给 Agent 的有界摘要，正常使用时推荐。
• 紧凑与完整 JSON 都保留服务端 request_id，便于把批次与 Edge、API、Forge 证据关联起来。
• --extract overview|geometry|stock|machining|route|dfm|preview：提取批次中每个零件的同一类结果。
• --json：完整 CLI 数据，只用于明确的调试或集成需求。

未传 --capabilities 时只请求 geometry。高级分析必须显式声明，例如 --capabilities geometry,dfm,machining；服务端不会先运行隐藏组件再仅靠前端隐藏。

支持的文件与安全边界

当前支持以下单零件 CAD 文件：

.step  .stp  .x_t  .x_b  .sat  .sldprt  .prt  .ipt  .catpart

• 每个文件最大 10 MiB；每批最多 5 个文件。
• 只接受明确指定的精确路径，不扫描目录、通配符或相邻文件。
• 拒绝 .sldasm、.asm、.iam、.catproduct、.3dxml、.stl、.obj 等装配体和网格文件。
• 文件包含多个实体时，Immake 返回实体数量、覆盖全部实体的整体包围盒尺寸和各有效实体体积之和；加工、DFM、毛坯和自动报价均不可用，并返回 MULTI_SOLID_UNSUPPORTED。
• 原生 CAD 的必要预处理只用于内部制造分析；公共 CLI 不提供独立格式转换或派生 CAD 文件下载。
• 公开结果链接及其中的 3D 访问有效 7 天。不要上传你无权分享的模型。

自动估算报价

公开分析结果不返回商业字段。登录后，quote 会为每个设计独立请求 geometry + dfm + machining，再由服务端使用网页后台中的版本化费率计算一份统一的 CNY 自动估算报价：

immake quote \
  --item "/absolute/path/a.step" --quantity 10 --material 6061 \
  --item "/absolute/path/b.step" --quantity 25 --material 304 \
  --compact-json
immake quote status <quote-id> --wait --compact-json

Free 使用管理员默认费率且看不到单位费率；Pro 可在账户后台维护私有费率，未配置时回退默认费率。仅单实体、可执行三轴、四类工时、正整数装夹次数、可信毛坯重量和材料费率都完整时出价。DFM 风险随报价返回但不自动改变金额。报价不是订单或有约束力合同。

旧版 immake cost-profile 命令和本机文件继续保留兼容，但新 quote 永远不会读取、上传或覆盖它。

更新与排查

immake update --agent codex --json
immake doctor --json
immake --help

成功请求分析服务后，Immake 最多每 24 小时检查一次 npm 新版本。发现更新时只提示，不会在没有用户授权的情况下自动安装。

相关资料

• Immake 中文官网
• 给用户看的安装说明
• 给 Agent 读取的标准安装契约
• npm 软件包
• 公开分析 API
• 公开结果页面

开发与验证

npm install
npm run verify
npm pack --dry-run

仓库设计与证据规范：

• 当前架构
• 开发流程与 Agent Notes
• 测试与证据
• CLI 发布手册

把标准安装说明、Skill 和 manifest 导出到官网仓库：

npm run export:site-docs -- ../ImmakeSkillWeb

发布只由本仓库受保护 tag 的 Gitea Workflow 执行。manufacturing-ops 只负责仓库专用 Runner 的生命周期和只读 evidence 消费，不能发布 npm 包。

许可证

MIT