高级 Marionette 脚本
高级 Marionette 开发人员可以创建自定义节点，用于自己的工作或分配给其他人。咨询开发人员 wiki 主页：developer.vectorworks.net 以了解有关创建 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 文件。
