组件路径

理解实例根目录、Python 和 Core 的区别，并安全地修改组件引用。

一个实例包含三个不同的位置：实例根目录是整个实例的边界，Python 目录保存独立运行环境，Core 目录保存 WebUI 代码。Python 和 Core 可以位于实例根目录内，也可能在导入或扫描时引用外部目录。

修改 Python 或 Core 路径

建议先停止 WebUI，并等待安装、版本、扩展、快照和模型任务结束。路径更新需要独占当前实例；应用也可能在更新前停止相关运行资源。

Python 目录必须是可用的独立 Python 环境；Core 目录必须符合当前 WebUI 类型。不要选择磁盘根目录、用户主目录或另一个实例正在使用的目录。

在“组件路径”中填写或选择新目录，确认两项都不为空，再点击“应用”。后端会验证路径、实例重叠和组件类型。

如果页面提示实例配置已发生变化，点击“重新加载”，重新选择目录后再提交。不要用旧页面覆盖其他管理操作刚写入的配置。

返回“实例信息”检查 Python 版本和 Core 路径，再打开实例终端执行版本检查，最后重新启动 WebUI。

修改路径不会移动文件

应用只更新实例记录中的组件引用，不会把原目录复制或移动到新位置。需要搬迁整个实例时使用实例维护中的“迁移实例”。

外部组件不会因为修改路径、迁移或删除实例而自动搬移。后续如果要强制重建外部 Python/Core，后端会拒绝删除实例根目录之外的组件，需先规划新的受管目录。