SuperAPI AI 工具集

scad-load

编程与开发

查看项目

更新于 10-15 20:34

技能介绍

用途:在修改或调试 OpenSCAD 文件前,系统化加载目标 .scad 文件及其依赖,输出依赖树、可用模块与函数、Customizer 参数和配置变量,便于理解上下文。

主要能力:读取指定文件并提取元数据;递归解析 use/include 语句;按 OpenSCAD 规则解析库路径(项目 lib/、macOS 的 ~/Documents/OpenSCAD/libraries/、Linux 的 ~/.local/share/OpenSCAD/libraries/、相对路径);提取模块、函数、Customizer 参数与顶层变量;检测循环依赖、缺失文件与路径解析失败;以结构化摘要呈现依赖树和 API 表面。

使用方式:通过显式触发词调用,如“load scad [file]”“/scad-load [file]”“load openscad context for [file]”“show dependencies for [file]”。示例命令:/scad-load workshop/workbenches/mini-workbench.scad。依赖解析默认最大深度为 5,避免加载整个库树。

适用场景:修改 OpenSCAD 文件前了解上下文;调试渲染错误、模块未定义、变量 undef、循环依赖或库路径问题;规划重构;查看模块可用性。

限制:需要能访问项目目录与系统库目录;依赖 Read、Grep、Bash 等工具;不加载完整库文件,仅摘要;需区分 use(仅导入模块/函数)与 include(导入全部并执行顶层代码);下划线私有命名约定并非所有项目都适用。具体支持文件与示例输出格式以资料为准,其他细节暂未提供。