高级 Marionette 脚本
高级 Marionette 开发者可以创建自定义节点，以用于自己的工作或将其分配给其他人。请参阅开发者 wiki 主页：Github.com/Vectorworks 以获取有关创建 Marionette 节点的更多信息。
高级开发者可以使用各种 Python 库。在开发过程中，您可以测试各种 Python 库包，以确保您使用的是最适合您的脚本的包。开发者 wiki 上列出了可用的包（要快速访问，请从 Marionette 首选项的内容部分单击 Python 资源存储库）；此外，您还可以要求特定的软件包通过 Vectorworks 上传到那里 。
在您的 Marionette 节点中，您可以参照 Vectorworks 开发者页面上包含的 Python 库包。适合您指定的平台和版本的包将在脚本执行时由脚本用户自动下载。
参照 Python 库
要在自定义的 Marionette 节点中参照 Python 库包，以下 Marionette.Node 构造函数语法指定节点的版本和包依赖关系：
this.CustomNode("CustomNodeName", "OptionalLocalizedName", "OptionalNodeVersionNumber", [('Geopy', '2.2.0'), ('scipy', '1.7.3')])
示例语法的括号部分说明了如何指定节点所依赖的两个不同的 Python 包，以及每个包的可选版本号。
如果您需要的 Python 库不包含在 Vectorworks 服务器上，请使用上面描述的开发者 wiki 网页向 Vectorworks 发送电子邮件，以告知您需要的包。Marionette 团队会将该包上传至服务器。由于 Python 依赖项总是存在并按需安装，因此您可以确信自定义节点在不同版本之间都能正常运行。
Python 库安装
在脚本执行期间，如果参照的 Python 包已经安装，则脚本执行。
如果 Python 库包尚未安装，则脚本用户将有机会从 Vectorworks 服务器自动安装该包。
要安装所需的 Python 库文件：
如果 Marionette 检测到需要从 Vectorworks 服务器安装库文件，则“安装 Python 包”对话框打开。
列出了所需的包及其详细信息。单击确定以将包安装在用户文件夹内的单独的 PythonExternals 文件夹中；如果文件夹不存在，则会自动创建。
安装完成后，“安装详细信息”对话框将打开。单击详细信息以查看包含安装结果的文本文件；它显示安装了哪些包、安装在哪里，以及安装是否成功。
成功安装所需的 Python 库包后，脚本就会执行。
手动安装 Python 库
|
模式 |
工具 |
工具集 |
|
首选项
|
Marionette
|
基础 |
在开发过程中，您可以手动安装某些 Python 库，以确保为编写的自定义节点使用最佳库。
要安装 Python 库：
单击“工具和模式”。
“Marionette 首选项”对话框打开。
单击内容部分中的 Python 资源库，以查看可从 Vectorworks 服务器中获取哪些 Python 库。
单击安装 Python 库。
“Python 库位置”对话框打开。
输入 Python 库文件的 URL，以安装该位置的库文件。
测试脚本；如果库文件对您有用，并且您需要将它用于自定义 Marionette 开发，请通过从开发者 wiki 网站向 Vectorworks 发送电子邮件来请求将其添加到 Vectorworks 服务器。
要查看已安装的库文件和包，请参阅用户文件夹中的 Python Externals 文件夹中的 InstallOutput.txt 文件。
