Is alphacam-bridge safe to install?

SaferSkills independently audited alphacam-bridge (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.

CategoryWeightCategory scoreContribution

Securityprompt, exec, net, exfil, eval

35%

100

35.0 pts

Supply chainhash, typosquat, maintainer, lockfile

20%

100

20.0 pts

Maintenancestaleness, pinning, CI

15%

100

15.0 pts

TransparencySKILL.md, perms, README

15%

100

15.0 pts

Communityinstalls, verify, response

15%

100

15.0 pts

Findings & checks · 0 flagged

Securityscore 100 · 0 findings

✓—All security checks passedNo findings in this category for the latest scan.pass

Supply chainscore 100 · 0 findings

✓—All supply chain checks passedNo findings in this category for the latest scan.pass

Maintenancescore 100 · 0 findings

✓—All maintenance checks passedNo findings in this category for the latest scan.pass

Transparencyscore 100 · 0 findings

✓—All transparency checks passedNo findings in this category for the latest scan.pass

Communityscore 100 · 0 findings

✓—All community checks passedNo findings in this category for the latest scan.pass

The primary manifest — the file an agent reads to learn what this artifact does.

SKILL.md · 1 file

SKILL.md7.6 KB · Markdown

name: alphacam-bridge

description: 通过 MCP 协议直接实时操作 AlphaCAM 2016 R1 的桥接器插件使用指南。

AlphaCAM MCP 桥接器 — AI 实时操作 AlphaCAM

通过 alphacam-bridge 插件提供 69 个 MCP 工具，用于直接控制 AlphaCAM 2016 R1。

可用工具

状态与信息

`get_status` — 检查连接状态、版本、路径
`get_drawing_info` — 当前图纸详情（几何、路径、图层、操作）

文件

`new_drawing` / `open_drawing` / `open_dxf` / `open_step` / `open_stl`
`save_drawing` / `output_nc`

几何创建与查询

`create_rectangle` / `create_circle` / `create_line` / `create_polygon` / `create_ellipse` / `create_text`
`get_all_geometries` / `list_geometries` / `list_operations` / `list_toolpaths`
`delete_selected` / `delete_all_geometries`

裁剪与加工

`trim_with_boundary` — 以边界裁剪线段
`run_machining` — 完整加工控制（进给、转速、深度、加工类型）

工作平面与图层

`create_workplane` / `set_workplane` / `create_layer`

刀具

`select_tool` / `get_current_tool`

路径操作

`mirror_path` / `offset_path` / `copy_temporary_store`
`get_path_attributes` / `set_path_attribute`

排版

`has_nesting` / `get_nesting_info` / `get_sheet_extents`
`order_operations_all` / `order_manual`

屏幕控制

`lock_acam` / `unlock_acam`

VBA 与插件（9）

`run_vba_macro` — 运行 VBA 宏（支持传参）
`run_vba_line` — 直接执行一行 VBA 代码（自动创建临时模块）
`list_vba_modules` — 列出 VBA 项目全部模块
`get_vba_code` — 读取 VBA 模块完整源码
`install_vba_module` — 安装/覆盖 VBA 模块（从源码）
`delete_vba_module` — 删除 VBA 模块（按名称）
`load_addin` / `enable_addin` / `list_addins`

后处理器

`select_post`

API 文档

`list_docs` — 列出文档来源 + CHM 索引状态（33 个 .chm 转换状态）
`search_docs` — 关键词搜索（含 CHM 描述搜索 + 内容片段预览 + 60s 缓存）
`read_doc` — 读取文档页全文（max_len 控制）
`chm_to_html` — 单文件 CHM 转 HTML
`chm_to_html_all` — 批量转换全部未处理 .chm

实用工具

`set_undo_point` / `zoom_all` / `run_workflow`（批量多步骤）
`list_layers` / `close_drawing` / `shell_command`

加工类型常量

1 = 粗精加工
2 = 轮廓铣槽
10 = 雕刻
21 = 钻孔 / 22 = 啄钻 / 23 = 攻丝 / 24 = 镗孔

CDM 橱柜门自动化（modAutoImportNest + frmAutoNest）

CDM 工程中已安装 modAutoImportNest 模块与 frmAutoNest 窗体，实现一键自动化：

菜单 → CDM → 自动化生产排版（弹出 frmAutoNest 窗体，CSV 路径记忆回填）
  → 选择/输入 CSV → 确定
  → 客户"自动化生产" → 创建订单（重名取消）→ 逐行导入门板明细（复制 UserStyle 参数）
  → 勾选"只导入订单，不生产排版"？ 是→仅导入，结束
  → 否 → g_Make_Master 批量生产 + 排版 + NC 输出

菜单触发：m_AutoImportNest → AutoImportNest()（弹 frmAutoNest 窗体）；窗体"确定"→ AutoImportNestWithParams(CSV路径, "自动化生产", bRunNest, bOverwrite, sMaterialOverride)（v1.10：sMaterialOverride = 窗体材料下拉选中的材料，非空即整批覆盖并忽略 CSV 第 13 列；为空才回退逐行取 CSV 第 13 列。两条路径都要求材料已存在于 AD_MATERIALS）
窗体含 10 控件：lblCSV/txtCSV/cmdBrowse/chkOnlyImport（只导入勾选框）/chkOverwrite（强制覆盖重名订单勾选框）/cmdRegenLabel（重新生成标签）/cmdOK/cmdCancel/lblMaterial + cboMaterial（v1.10 材料下拉，Style=2 只可选，启动时从 AD_MATERIALS 加载，预选 = 上次选择 → MaterialDefault=True 行 → 第一项）；AlphaCAM 不支持导入 .frm，窗体需手动创建一次（见 CDM功能/frmAutoNest_手动创建.md）
930 用户样式门型（如平板PETA）需复制 StyleName=UserStyleName + UserValue_0~6，否则报"无法连接用户定义的宏"
VBA 工程自动定位：ActiveVBProject → CDM 工程 → 首个工程（_get_vba_project()）

VBA 窗体/控件编程（VBIDE）

通过 COM 访问 Application.VBE 扩展对象模型，可编程添加/修改窗体控件、替换窗体代码，无需手工拖拽：

链路: VBE → VBProjects → VBComponents("窗体名")
        ├─ .Designer.Controls.Add(ProgID, 名称)   ← 添加控件（Forms.CheckBox.1 / TextBox.1 / CommandButton.1 / Label.1 ...）
        └─ .CodeModule.DeleteLines / AddFromString ← 替换代码

proj = com._get_vba_project()
comp = proj.VBComponents('frmAutoNest')
d = comp.Designer
cb = d.Controls.Add('Forms.CheckBox.1', 'chkOnlyImport')   # 先加控件
cb.Caption = '只导入订单，不生产排版'; cb.Left = 78; cb.Top = 54
cm = comp.CodeModule                                        # 再改引用它的代码
cm.DeleteLines(1, cm.CountOfLines); cm.AddFromString(code)  # 建议先备份，失败回滚

顺序关键：先 Controls.Add 再更新代码，反了会编译报"找不到方法或数据成员"
可读现有控件坐标（c.Left/c.Top）辅助定位；前提：AlphaCAM 运行中、工程未锁定
受限：窗体本体需手动创建一次（.frm 无法导入），之后设计/代码全自动

MCP 工具 vs VBA 代码选择指南

场景	使用
快速创建几何	MCP 工具
标准加工操作	MCP 工具
复杂批量操作	`run_workflow`
自定义逻辑/循环/条件	生成 VBA 代码
自定义菜单/插件	生成 VBA 代码
事件处理（保存前、输出后）	生成 VBA 代码
交互式用户选择	MCP 工具
多步骤自动化工作流	MCP `run_workflow`
安装/读取/删除 VBA 模块	`install_vba_module` / `get_vba_code` / `delete_vba_module`

注意事项

桥接器通过 COM 连接 AlphaCAM，AlphaCAM 必须在运行状态
VBA 宏调用使用 Project.Module.Procedure 格式
工作平面检查：打开临时图纸时检查 Drawing.WorkPlanes.count，若包含工作平面则无法插入
文档搜索自动检测 AlphaCAM 安装目录，涵盖 VBA API + 3D/4D 用户手册
改 CDM 模块必须走 `tools/` 的部署闭环：running_snapshot.py 存基线 →

component_deploy.py audit（运行版/仓库/基线三方比对，不匹配就拒绝写）→ deploy （整体替换 + 读回校验 + 失败回滚）→ deploy_probe.py（标记断言 + 全工程编译探针）。详见 tools/README.md

比对运行中 VBA 代码与仓库文件时必须大小写不敏感：VBA 编译时会把成员名归一化

（.Add → .add），按字节比对会误报"部署失败"

读 CDM.ctx 等文本资源槽（Frame.ReadTextFile(文件, 行, 列)）绝不能盲试行号：

槽不存在会弹模态框并让 AlphaCAM 的错误处理开一堆 CDM.err 记事本；而且它不阻塞 COM，探针照样返回 ok —— "探针过了"不能当作"屏幕上没弹窗"

AlphaCAM 的进程名是 Acam.exe（主窗口类 AlphaCAM_3DMILL），

用 ProcessName -match 'alphacam' 过滤不到它

支持 .env 文件配置 ALPHACAM_PROG_ID、ALPHACAM_VISIBLE 等环境变量
需要打开 VBA 编辑器时：运行 open_vba_editor.py（激活/最大化 AlphaCAM 窗口 + Alt+F11），已获用户授权

alphacam-bridge— agent skill

Is alphacam-bridge safe to install?

AlphaCAM MCP 桥接器 — AI 实时操作 AlphaCAM

可用工具

状态与信息

文件

几何创建与查询

裁剪与加工

工作平面与图层

刀具

路径操作

排版

屏幕控制

VBA 与插件（9）

后处理器

API 文档

实用工具

加工类型常量

CDM 橱柜门自动化（modAutoImportNest + frmAutoNest）

VBA 窗体/控件编程（VBIDE）

MCP 工具 vs VBA 代码选择指南

注意事项

Audit the pieces. Scan the whole. Decide.

Is alphacam-bridge safe to install?

AlphaCAM MCP 桥接器 — AI 实时操作 AlphaCAM

可用工具

状态与信息

文件

几何创建与查询

裁剪与加工

工作平面与图层

刀具

路径操作

排版

屏幕控制

VBA 与插件（9）

后处理器

API 文档

实用工具

加工类型常量

CDM 橱柜门自动化（modAutoImportNest + frmAutoNest）

VBA 窗体/控件编程（VBIDE）

MCP 工具 vs VBA 代码 选择指南

注意事项

Audit the pieces. Scan the whole. Decide.

MCP 工具 vs VBA 代码选择指南