@ww_nero/skills 3.1.0 → 3.2.1

package/assets/ppt_prompt.txt

@@ -0,0 +1,25 @@
+制作PPT的完整步骤如下（可根据当前实际状态，跳过部分已经完成的环节）：
+
+1. **规划PPT内容**，存储到markdown文件中：
+   - 每页Slide的规划需要包含：内容、布局方式、插图（只有用户明确提出要求时才添加插图）
+   - 不同页面应尽可能使用不同的布局方式，避免过于单调，可适当使用图表来呈现信息，例如折线图、柱状图、饼状图等；各正文页面标题样式、背景和文字色调**必须保持一致**。
+   - 如果用户未明确提出要求，则页面默认比例为宽1280px、高720px，默认背景为弱渐变的浅灰蓝（#F2F4F7 → #FCFCFC），现代科技感、扁平化风格。
+   - 如果需要插入图片，则按照以下方式：
+     - 收集图片素材，优先使用用户提供的图片；如未提供，则使用图像生成工具生成合适的图片
+     - 将图片素材保存到`images`文件夹中，使用内容和宽高比例作为图片名称，例如`main_background_16_9.png`表示该图片是主背景图，宽高比为16:9；对于用户提供的图片素材，可调用工具解读图片内容
+
+2. **通过SVG代码实现Slides的排版**：
+   - 如需Image，统一使用`rect`或`circle`元素进行占位（必须符合图片宽高比例），占位元素应设置合适的位置，可添加浅色填充或边框以便预览时识别
+   - 如需Icon，优先使用Emoji，其次使用纯SVG代码的方式绘制
+   - 如需Chart，如折线图、柱状图等，应使用纯SVG代码的方式绘制，而不是使用图片占位元素
+   - 每页Slide的保存在一个独立HTML文件中，例如`slide_01.html`、`slide_02.html`等。
+
+3. **把SVG转成PPTX文件**：
+   - 参考snippet工具中提供的`svg_to_pptx`代码示例，编写临时的python脚本，把svg转化成可编辑的pptx文件，不要遗漏任何元素（例如线条、装饰等）
+   - 转化的方法是把svg代码转化成使用python创建pptx中可操作元素的代码，示例中的创建元素的工具函数均可以使用
+   - 同时对于每个slide务必创建单独的create_slide函数，例如`create_slide1`、`create_slide2`等
+   - **不要使用`BeautifulSoup`这种通用的解析元素的方式，而是逐个元素从svg代码转化为python创建元素的代码**
+   - 转换过程中，需要把图片占位元素替换成前面准备的图片素材
+   - 每个页面编写一个单独的python脚本进行转化，最后再写一个python脚本，把所有单页的pptx文件合并成一个。
+
+**注意**：完成后**需要保留**规划文档、html页面文件和python转化脚本，方便进一步根据反馈进行修改

package/assets/snippets.json

@@ -0,0 +1,73 @@
+{
+  "html_to_png": {
+    "title": "HTML 转 PNG",
+    "description": "Playwright 渲染 HTML 后截图，自动按主体尺寸设置 viewport，适合静态页面或组件 demo。",
+    "codeFile": "html_to_png.py",
+    "notes": [
+      "默认等待 1500ms 以确保样式/异步资源加载完成，可通过脚本中的 wait 参数调节。",
+      "使用 device_scale_factor=4 输出高清图，如需更快速度可降低倍率。",
+      "截图时优先取 body 内的顶层单节点，否则回退到整个 body，保证尺寸合理。"
+    ]
+  },
+  "pdf_to_png": {
+    "title": "PDF 转 PNG",
+    "description": "调用 pdf2image 将 PDF 分页转成位图，并按序号命名输出。",
+    "codeFile": "pdf_to_png.py",
+    "notes": [
+      "支持自定义 dpi 与输出格式（png/jpg 等），默认 300dpi 用于打印级清晰度。",
+      "输出目录会自动创建，文件名形如 page_0001.png，便于批量处理。",
+      "如需大批量转换，可将 convert_from_path 的线程参数打开以提升性能。"
+    ]
+  },
+  "pptx_to_png": {
+    "title": "PPTX 转 PNG",
+    "description": "使用 LibreOffice 无头模式转换为 PDF，再通过 pdf2image 转成 PNG 图片，兼容 Windows/macOS/Linux。",
+    "codeFile": "pptx_to_png.py",
+    "notes": [
+      "脚本会自动探测 soffice 路径，如未安装需先安装 LibreOffice。",
+      "内部先转 PDF 再转 PNG，中间文件在临时目录处理，不会残留。",
+      "支持自定义 dpi，默认 300dpi 用于打印级清晰度。",
+      "输出目录会自动创建，文件名形如 page_0001.png，便于批量处理。"
+    ]
+  },
+  "svg_to_pptx": {
+    "title": "SVG 转 PPTX",
+    "description": "把 SVG 转化成在 PPTX 中创建可操作的元素。",
+    "codeFile": "svg_to_pptx.py",
+    "notes": [
+      "【Icon 元素处理】对于复杂的 SVG 图标（如 <g id=\"icon-*\"> 元素或包含 path 的小图标），应先将其独立保存为小的 PNG 图片，再插入到 PPTX 中。**不能遗漏任何图标**。",
+      "【文本颜色丢失】python-pptx 设置字体名称时会添加 a:latin/a:ea 等元素，如果颜色填充放在 rPr 末尾会被 PowerPoint 忽略。解决：用 rPr.insert(0, solidFill/gradFill) 将颜色填充插入到 rPr 开头，确保优先级最高。",
+      "【渐变文本失效】设置渐变前必须先清理 a:solidFill、a:gradFill、a:noFill 三种标签，否则会冲突。同时添加 rotWithShape=\"1\" 和 scaled=\"1\" 属性确保渐变方向正确。",
+      "【背景渐变被覆盖】直接操作 slide._element 时，若 p:bg 已存在需先 clear() 再重建，否则新旧元素混杂导致渲染异常。用 cSld.insert(0, bg) 确保背景节点在正确位置。",
+      "【透明度不生效】设置透明度前需检查 fill.type == 1（纯色填充），然后定位到 srgbClr 节点追加 a:alpha 子元素，添加前先移除已有的 a:alpha 避免重复。",
+      "【中文字体回退】仅设置 run.font.name 对中文无效，需额外通过 XML 插入 a:ea 元素并指定 typeface=\"Microsoft YaHei\"，且 a:ea 要插入到 rPr 开头防止被后续元素覆盖。",
+      "【形状渐变填充】设置形状渐变时，必须先移除 spPr 下已有的 a:solidFill/a:gradFill/a:noFill，否则渐变不生效。渐变位置 pos 使用 0-100000 范围（百分比*1000），角度 ang 使用度数*60000。",
+      "【渐变透明度】每个渐变停止点的透明度需在对应 srgbClr 下追加 a:alpha 元素，val 值为透明度*100000（如 0.5 透明度对应 50000）。",
+      "【曲线绘制】使用 build_freeform 绘制曲线时，起点坐标在构造器中指定，后续点通过 add_line_segments 添加。若需平滑曲线，可用 Catmull-Rom 样条插值生成中间点。",
+      "【线宽单位换算】线条宽度不能使用 Pt，应使用 EMU 单位：width * 9525（1px 约等于 9525 EMU）。",
+      "【移除阴影效果】如果 SVG 代码中没有显式设置阴影（如 box-shadow 或 filter: drop-shadow），插入元素后需要移除默认阴影，方法是在 spPr 下添加空的 a:effectLst 元素。",
+      "【Emoji 处理】Emoji 可以像普通文本一样直接插入到 PPT 中，使用 add_text_box 函数即可，无需特殊处理。"
+    ]
+  },
+  "step_to_stl": {
+    "title": "STEP 转 STL",
+    "description": "使用 pythonocc-core 将 STEP/STP 文件转换为 STL 网格文件，适合 3D 打印或可视化。",
+    "codeFile": "step_to_stl.py",
+    "notes": [
+      "依赖 pythonocc-core 库，需通过 conda 或 pip 安装。",
+      "网格精度由 BRepMesh_IncrementalMesh 的参数控制，默认 0.1 适合一般用途。",
+      "输出为二进制 STL 格式，文件更小，加载更快。",
+      "命令行用法: python step_to_stl.py <input_file> [output_file]"
+    ]
+  },
+  "combine_stls": {
+    "title": "合并 STL 文件",
+    "description": "使用 gmsh 将多个 STL 文件合并成一个 STL 文件。",
+    "codeFile": "combine_stls.py",
+    "notes": [
+      "依赖 gmsh 库，可通过 pip install gmsh 安装。",
+      "输出为二进制 STL 格式。",
+      "命令行用法: python combine_stls.py <output_file> <input1.stl> <input2.stl> ..."
+    ]
+  }
+}

package/index.js

@@ -6,6 +6,7 @@ const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
 const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
 const { CallToolRequestSchema, ListToolsRequestSchema } = require('@modelcontextprotocol/sdk/types.js');
 
+const SCRIPTS_ROOT = path.join(__dirname, 'scripts');
 const ASSETS_ROOT = path.join(__dirname, 'assets');
 
 const convertPath = (filePath) => {
@@ -61,151 +62,34 @@ const resolveWorkingDirectory = (rawPath) => {
   return resolved;
 };
 
-const resolveAsset = (relativePath) => {
-  const target = path.resolve(ASSETS_ROOT, relativePath);
-  const rel = path.relative(ASSETS_ROOT, target);
+const resolveScript = (relativePath) => {
+  const target = path.resolve(SCRIPTS_ROOT, relativePath);
+  const rel = path.relative(SCRIPTS_ROOT, target);
   if (rel.startsWith('..') || path.isAbsolute(rel)) {
     throw new Error('非法资源路径');
   }
   if (!fs.existsSync(target)) {
-    throw new Error(`未找到资源: ${relativePath}`);
+    throw new Error(`未找到脚本: ${relativePath}`);
   }
   return target;
 };
 
-const loadText = (relativePath) => fs.readFileSync(resolveAsset(relativePath), 'utf8');
-
-const SNIPPETS = {
-  html_to_png: {
-    title: 'HTML 转 PNG',
-    description: 'Playwright 渲染 HTML 后截图，自动按主体尺寸设置 viewport，适合静态页面或组件 demo。',
-    codeFile: 'html_to_png.py',
-    notes: [
-      '默认等待 1500ms 以确保样式/异步资源加载完成，可通过脚本中的 wait 参数调节。',
-      '使用 device_scale_factor=4 输出高清图，如需更快速度可降低倍率。',
-      '截图时优先取 body 内的顶层单节点，否则回退到整个 body，保证尺寸合理。'
-    ]
-  },
-  pdf_to_png: {
-    title: 'PDF 转 PNG',
-    description: '调用 pdf2image 将 PDF 分页转成位图，并按序号命名输出。',
-    codeFile: 'pdf_to_png.py',
-    notes: [
-      '支持自定义 dpi 与输出格式（png/jpg 等），默认 300dpi 用于打印级清晰度。',
-      '输出目录会自动创建，文件名形如 page_0001.png，便于批量处理。',
-      '如需大批量转换，可将 convert_from_path 的线程参数打开以提升性能。'
-    ]
-  },
-  pptx_to_png: {
-    title: 'PPTX 转 PNG',
-    description: '使用 LibreOffice 无头模式转换为 PDF，再通过 pdf2image 转成 PNG 图片，兼容 Windows/macOS/Linux。',
-    codeFile: 'pptx_to_png.py',
-    notes: [
-      '脚本会自动探测 soffice 路径，如未安装需先安装 LibreOffice。',
-      '内部先转 PDF 再转 PNG，中间文件在临时目录处理，不会残留。',
-      '支持自定义 dpi，默认 300dpi 用于打印级清晰度。',
-      '输出目录会自动创建，文件名形如 page_0001.png，便于批量处理。'
-    ]
-  },
-  svg_to_pptx: {
-    title: 'SVG 转 PPTX',
-    description: '把 SVG 转化成在 PPTX 中创建可操作的元素。',
-    codeFile: 'svg_to_pptx.py',
-    notes: [
-      '【Icon 元素处理】对于复杂的 SVG 图标（如 <g id="icon-*"> 元素或包含 path 的小图标），应先将其独立保存为小的 PNG 图片，再插入到 PPTX 中。**不能遗漏任何图标**。',
-      '【文本颜色丢失】python-pptx 设置字体名称时会添加 a:latin/a:ea 等元素，如果颜色填充放在 rPr 末尾会被 PowerPoint 忽略。解决：用 rPr.insert(0, solidFill/gradFill) 将颜色填充插入到 rPr 开头，确保优先级最高。',
-      '【渐变文本失效】设置渐变前必须先清理 a:solidFill、a:gradFill、a:noFill 三种标签，否则会冲突。同时添加 rotWithShape="1" 和 scaled="1" 属性确保渐变方向正确。',
-      '【背景渐变被覆盖】直接操作 slide._element 时，若 p:bg 已存在需先 clear() 再重建，否则新旧元素混杂导致渲染异常。用 cSld.insert(0, bg) 确保背景节点在正确位置。',
-      '【透明度不生效】设置透明度前需检查 fill.type == 1（纯色填充），然后定位到 srgbClr 节点追加 a:alpha 子元素，添加前先移除已有的 a:alpha 避免重复。',
-      '【中文字体回退】仅设置 run.font.name 对中文无效，需额外通过 XML 插入 a:ea 元素并指定 typeface="Microsoft YaHei"，且 a:ea 要插入到 rPr 开头防止被后续元素覆盖。',
-      '【形状渐变填充】设置形状渐变时，必须先移除 spPr 下已有的 a:solidFill/a:gradFill/a:noFill，否则渐变不生效。渐变位置 pos 使用 0-100000 范围（百分比*1000），角度 ang 使用度数*60000。',
-      '【渐变透明度】每个渐变停止点的透明度需在对应 srgbClr 下追加 a:alpha 元素，val 值为透明度*100000（如 0.5 透明度对应 50000）。',
-      '【曲线绘制】使用 build_freeform 绘制曲线时，起点坐标在构造器中指定，后续点通过 add_line_segments 添加。若需平滑曲线，可用 Catmull-Rom 样条插值生成中间点。',
-      '【线宽单位换算】线条宽度不能使用 Pt，应使用 EMU 单位：width * 9525（1px 约等于 9525 EMU）。',
-      '【移除阴影效果】如果 SVG 代码中没有显式设置阴影（如 box-shadow 或 filter: drop-shadow），插入元素后需要移除默认阴影，方法是在 spPr 下添加空的 a:effectLst 元素。',
-      '【Emoji 处理】Emoji 可以像普通文本一样直接插入到 PPT 中，使用 add_text_box 函数即可，无需特殊处理。'
-    ]
-  }
+const loadScript = (relativePath) => fs.readFileSync(resolveScript(relativePath), 'utf8');
+
+const loadJson = (filename) => {
+  const filePath = path.join(ASSETS_ROOT, filename);
+  return JSON.parse(fs.readFileSync(filePath, 'utf8'));
 };
 
-const GUIDES = {
-  convert_doc_types: {
-    title: '转化文档类型',
-    content: `执行文档类型转化任务（如 PPTX、PDF、DOCX、HTML、PNG 等格式互转）时，可参考以下方法：
-
-## 方法一：使用命令行工具（推荐用于简单场景）
-
-以下工具均已安装，可直接在终端调用：
-
-- **LibreOffice (soffice)**：支持 Office 文档互转
-  - PPTX → PDF: \`soffice --headless --convert-to pdf input.pptx --outdir ./output\`
-  - DOCX → PDF: \`soffice --headless --convert-to pdf input.docx --outdir ./output\`
-  - XLSX → PDF: \`soffice --headless --convert-to pdf input.xlsx --outdir ./output\`
-
-- **Pandoc**：支持多种文档格式转换
-  - Markdown → DOCX: \`pandoc input.md -o output.docx\`
-  - Markdown → PDF（中文）: \`pandoc input.md -o output.pdf --pdf-engine=xelatex -V CJKmainfont="Microsoft YaHei"\`
-  - HTML → Markdown: \`pandoc input.html -o output.md\`
-
-- **LaTeX (pdflatex/xelatex)**：用于高质量 PDF 生成
-  - TEX → PDF: \`xelatex input.tex\`
-
-## 方法二：编写临时 Python 脚本（推荐用于复杂场景）
-
-参考 \`snippet\` 工具中提供的转化脚本示例（已验证正确性），编写临时 Python 脚本：
-
-| 转化类型 | snippet 名称 | 说明 |
-|---------|-------------|------|
-| HTML → PNG | \`html_to_png\` | 使用 Playwright 渲染并截图 |
-| PDF → PNG | \`pdf_to_png\` | 使用 pdf2image 分页转换 |
-| PPTX → PNG | \`pptx_to_png\` | 使用 LibreOffice + pdf2image |
-| SVG → PPTX | \`svg_to_pptx\` | 转化为可编辑的 PPTX 元素 |
-
-调用示例：使用 \`snippet\` 工具获取参考代码，如 \`snippet({ title: "pdf_to_png" })\`
-
-## 解读 PPTX 或 PDF 文档
-
-当用户需要解读 PPTX 或 PDF 文档内容时：
-1. 编写临时 Python 脚本，将 PPTX/PDF 转化为 PNG 图片
-2. 对生成的图片进行视觉分析或内容解读
-3. 完成后删除临时脚本和中间文件
-
-## 注意事项
-
-- 临时脚本执行完成后应删除，除非用户明确要求保留
-- Python 环境已全局安装 \`playwright\`、\`pdf2image\`、\`python-pptx\`、\`Pillow\` 等常用库
-- 如需其他库，可使用 \`pip install\` 安装`
-  },
-  make_ppt: {
-    title: '制作PPT',
-    content: `制作PPT的完整步骤如下（可根据当前实际状态，跳过部分已经完成的环节）：
-
-1. **规划PPT内容**，存储到markdown文件中：
-   - 每页Slide的规划需要包含：内容、布局方式、插图（只有用户明确提出要求时才添加插图）
-   - 不同页面应尽可能使用不同的布局方式，避免过于单调，可适当使用图表来呈现信息，例如折线图、柱状图、饼状图等；各正文页面标题样式、背景和文字色调**必须保持一致**。
-   - 如果用户未明确提出要求，则页面默认比例为宽1280px、高720px，默认背景为弱渐变的浅灰蓝（#F2F4F7 → #FCFCFC），现代科技感、扁平化风格。
-   - 如果需要插入图片，则按照以下方式：
-     - 收集图片素材，优先使用用户提供的图片；如未提供，则使用图像生成工具生成合适的图片
-     - 将图片素材保存到\`images\`文件夹中，使用内容和宽高比例作为图片名称，例如\`main_background_16_9.png\`表示该图片是主背景图，宽高比为16:9；对于用户提供的图片素材，可调用工具解读图片内容
-
-2. **通过SVG代码实现Slides的排版**：
-   - 如需Image，统一使用\`rect\`或\`circle\`元素进行占位（必须符合图片宽高比例），占位元素应设置合适的位置，可添加浅色填充或边框以便预览时识别
-   - 如需Icon，优先使用Emoji，其次使用纯SVG代码的方式绘制
-   - 如需Chart，如折线图、柱状图等，应使用纯SVG代码的方式绘制，而不是使用图片占位元素
-   - 每页Slide的保存在一个独立HTML文件中，例如\`slide_01.html\`、\`slide_02.html\`等。
-
-3. **把SVG转成PPTX文件**：
-   - 参考snippet工具中提供的\`svg_to_pptx\`代码示例，编写临时的python脚本，把svg转化成可编辑的pptx文件，不要遗漏任何元素（例如线条、装饰等）
-   - 转化的方法是把svg代码转化成使用python创建pptx中可操作元素的代码，示例中的创建元素的工具函数均可以使用
-   - 同时对于每个slide务必创建单独的create_slide函数，例如\`create_slide1\`、\`create_slide2\`等
-   - **不要使用\`BeautifulSoup\`这种通用的解析元素的方式，而是逐个元素从svg代码转化为python创建元素的代码**
-   - 转换过程中，需要把图片占位元素替换成前面准备的图片素材
-   - 每个页面编写一个单独的python脚本进行转化，最后再写一个python脚本，把所有单页的pptx文件合并成一个。
-
-**注意**：完成后**需要保留**规划文档、html页面文件和python转化脚本，方便进一步根据反馈进行修改`
-  }
+const SNIPPETS = loadJson('snippets.json');
+
+const loadText = (filename) => {
+  const filePath = path.join(ASSETS_ROOT, filename);
+  return fs.readFileSync(filePath, 'utf8');
 };
 
+const PPT_PROMPT = loadText('ppt_prompt.txt');
+
 const buildSnippet = (title, workingDirectory) => {
   const entry = SNIPPETS[title];
   if (!entry) {
@@ -214,7 +98,7 @@ const buildSnippet = (title, workingDirectory) => {
   }
 
   const workingDir = resolveWorkingDirectory(workingDirectory);
-  const code = loadText(entry.codeFile);
+  const code = loadScript(entry.codeFile);
   const outputPath = path.join(workingDir, entry.codeFile);
   fs.writeFileSync(outputPath, code);
 
@@ -231,19 +115,6 @@ const buildSnippet = (title, workingDirectory) => {
   return lines.join('\n');
 };
 
-const buildGuide = (title) => {
-  const entry = GUIDES[title];
-  if (!entry) {
-    const supported = Object.keys(GUIDES).join(', ');
-    throw new Error(`title 仅支持: ${supported}`);
-  }
-
-  const lines = [];
-  lines.push(`【${entry.title}】技能指导`);
-  lines.push(entry.content);
-
-  return lines.join('\n');
-};
 
 const listTools = () => ({
   tools: [
@@ -255,11 +126,11 @@ const listTools = () => ({
         properties: {
           working_directory: {
             type: 'string',
-            description: '工作目录的绝对路径，生成的脚本文件将保存到此目录'
+            description: '工作目录的绝对路径，示例脚本文件将保存到此目录'
           },
           title: {
             type: 'string',
-            description: '示例类型，可选: html_to_png | pdf_to_png | pptx_to_png | svg_to_pptx',
+            description: '示例类型，可选: html_to_png | pdf_to_png | pptx_to_png | svg_to_pptx | step_to_stl | combine_stls',
             enum: Object.keys(SNIPPETS)
           }
         },
@@ -267,24 +138,18 @@ const listTools = () => ({
       }
     },
     {
-      name: 'guide',
-      description: '返回技能指导说明',
+      name: 'make_ppt',
+      description: '制作PPT的全流程指导说明及注意事项',
       inputSchema: {
         type: 'object',
-        properties: {
-          title: {
-            type: 'string',
-            description: '技能类型，可选: convert_doc_types | make_ppt',
-            enum: Object.keys(GUIDES)
-          }
-        },
-        required: ['title']
+        properties: {},
+        required: []
       }
     }
   ]
 });
 
-const server = new Server({ name: 'skills', version: '3.1.0' }, { capabilities: { tools: {} } });
+const server = new Server({ name: 'skills', version: '3.2.1' }, { capabilities: { tools: {} } });
 
 server.setRequestHandler(ListToolsRequestSchema, async () => listTools());
 
@@ -301,10 +166,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       return { content: [{ type: 'text', text: result }] };
     }
 
-    if (name === 'guide') {
-      const title = args?.title;
-      const payload = buildGuide(title);
-      return { content: [{ type: 'text', text: payload }] };
+    if (name === 'make_ppt') {
+      return { content: [{ type: 'text', text: PPT_PROMPT }] };
     }
 
     return { content: [{ type: 'text', text: `未知工具: ${name}` }], isError: true };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ww_nero/skills",
-  "version": "3.1.0",
+  "version": "3.2.1",
   "description": "MCP server that returns Python reference snippets and skill guides",
   "main": "index.js",
   "bin": {
@@ -8,6 +8,7 @@
   },
   "files": [
     "index.js",
+    "scripts",
     "assets"
   ],
   "dependencies": {

package/scripts/combine_stls.py

@@ -0,0 +1,45 @@
+import os
+import sys
+from typing import List
+import gmsh
+
+
+def combine_stl_files(input_files: List[str], output_file: str) -> bool:
+    """合并多个STL文件成一个STL文件"""
+    try:
+        gmsh.initialize()
+        gmsh.clear()
+
+        for stl_file in input_files:
+            print(f"正在加载: {stl_file}")
+            gmsh.merge(stl_file)
+
+        os.makedirs(os.path.dirname(output_file), exist_ok=True)
+        gmsh.option.setNumber("Mesh.Binary", 1)
+        gmsh.write(output_file)
+        print(f"合并后的STL文件已保存至: {output_file}")
+        return True
+
+    except Exception as e:
+        print(f"合并过程中出现错误: {e}")
+        return False
+
+    finally:
+        gmsh.finalize()
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 3:
+        print("用法: python combine_stls.py <output_file> <input_file1> <input_file2> ...")
+        print("示例: python combine_stls.py combined.stl part1.stl part2.stl part3.stl")
+        sys.exit(1)
+
+    output_file = sys.argv[1]
+    input_files = sys.argv[2:]
+
+    success = combine_stl_files(input_files, output_file)
+    if success:
+        print("合并成功!")
+    else:
+        print("合并失败!")
+        sys.exit(1)

package/scripts/step_to_stl.py

@@ -0,0 +1,55 @@
+import os
+import sys
+from OCC.Extend.DataExchange import read_step_file, write_stl_file
+from OCC.Core.BRepMesh import BRepMesh_IncrementalMesh
+
+
+def convert_step_to_stl(input_file: str, output_file: str = None) -> str:
+    """
+    将STEP文件转换为STL文件
+
+    参数:
+        input_file: STEP文件路径
+        output_file: 输出STL文件路径，默认为输入文件同目录下同名.stl文件
+    返回:
+        输出文件路径
+    """
+    if output_file is None:
+        filename_without_ext = os.path.splitext(input_file)[0]
+        output_file = f"{filename_without_ext}.stl"
+
+    output_dir = os.path.dirname(output_file)
+    if output_dir and not os.path.exists(output_dir):
+        os.makedirs(output_dir)
+
+    try:
+        shape = read_step_file(input_file)
+    except Exception as e:
+        raise Exception(f"读取STEP文件失败: {str(e)}")
+
+    mesh = BRepMesh_IncrementalMesh(shape, 0.1, False, 0.1, True)
+    mesh.Perform()
+
+    try:
+        write_stl_file(shape, output_file, mode='binary')
+        print(f"转换成功: {output_file}")
+        return output_file
+    except Exception as e:
+        raise Exception(f"STL文件写入失败: {str(e)}")
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("用法: python step_to_stl.py <input_file> [output_file]")
+        print("示例: python step_to_stl.py model.step")
+        print("      python step_to_stl.py model.step output/model.stl")
+        sys.exit(1)
+
+    input_file = sys.argv[1]
+    output_file = sys.argv[2] if len(sys.argv) > 2 else None
+
+    try:
+        convert_step_to_stl(input_file, output_file)
+    except Exception as e:
+        print(f"转换失败: {str(e)}")
+        sys.exit(1)