模型与算子库管理面板 (Managing Models and Libraries)
在 Griptape Nodes 中，部分算子节点需要在本地运行开源 AI 模型，因而在执行前必须先将庞大的模型权重下载并缓存至本地磁盘；另一些节点则来自于尚未安装的第三方扩展算子库。
这两大核心资源的生命周期均由编辑器顶部菜单栏的 Manage 菜单统一纳管：分别对应 Model Management (大模型管理) 与 Library Management (算子库管理) 两大专属视窗。
关于算子库运行容器的底层技术原理（虚拟环境隔离、Shared 与 Isolated 模式切换等），请参阅 算子库管理手册。本文档专注于上述两大图形化管理面板的具体交互。
大模型管理 (Model Management)
从顶部菜单栏选择 Manage → Model Management 即可打开模型管理中心，负责检索、后台异步下载以及清理本地模型权重。
该面板的所有功能均完整提供了对应的命令行 CLI 支持：gtn models（包含搜索、下载、列举、删除与下载进度审计），详见 命令行工具参考。
1. 检索 Hugging Face 模型库
在搜索框中键入关键词，系统会自动联想检索 Hugging Face 官方 Hub 上的开源模型。下拉结果卡片清晰展示模型的 Model ID、描述、社区累计下载量、点赞数 (Likes) 以及核心任务标签；对于本地已经安装的模型，会自动打上 Installed 标识。
若已明确知晓具体的模型命名空间（如 black-forest-labs/FLUX.1-schnell），可以直接在框中完整输入。
2. 后台异步下载模型
选中目标模型后点击 Download 按钮。下载任务在底层以完全异步的后台服务方式运转：创作者可以随时关闭该管理弹窗、切回画布继续搭建工作流，或者切换至算子库面板，后台断点续传与下载进度丝毫不会中断。
3. 监控下载进度与状态
Downloads 选项卡集中列出了所有正在进行与最近完成的任务：
| 状态标签 | 状态标识含义与详细展现 |
|---|---|
| Downloading（下载中） | 实时呈现动态进度条、已下载数据量 / 总数据量（GB）以及精确的百分比进度。 |
| Completed（下载完成） | 模型已成功落盘并完成 SHA256 完整性哈希校验，进度条满格呈现绿色。 |
| Failed（下载失败） | 因网络波动或无权限导致中断。卡片下方会明确输出详细报错（若因门禁限制，会附带 Hugging Face 申请直链）。 |
使用顶部的 All / Downloads / Models 过滤芯片可极速切换查看活跃任务或已落盘模型。点击下载中任务卡片上的垃圾桶图标，可在确认后随时取消下载并清理未完成的临时碎片。
4. 清理与删除本地模型
切换至 Installed Models 面板，此处列出了本机磁盘上已缓存的所有模型实体及其占用的真实磁盘空间（GB）。
点击垃圾桶图标会弹出 Delete Model 确认框：删除是彻底物理擦除并释放硬盘空间。依赖该模型的任何工作流在重新下载前将无法执行。
5. 受门禁保护模型 (Gated Models) 的 Token 配置
Hugging Face 上的部分知名开源大模型（例如 Llama、FLUX 等）属于门禁模型——在拉取权重前，用户必须首先在 Hugging Face 网页端签署用户协议获得授权，并在 Griptape Nodes 中配置个人的访问令牌 (Token)：
若检测到尚未配置 Token，面板顶部会弹出醒目的警告横幅：点击横幅直达 Settings → API Keys & Secrets，将申请到的凭证写入 HF_TOKEN 环境变量即可立即解锁下载权限。
算子库管理 (Library Management)
从顶部菜单栏选择 Manage → Library Management 唤出算子库管理器。在命令行终端下，等价于 gtn libraries download <git-url> 与 gtn libraries sync 命令。
面板顶部提供实时过滤器（可按库名搜索，或通过 All / Updates / Errors 芯片筛选），点击右上角图标可一键全局探测更新或手动刷新列表状态。
点击任意算子库的行卡片可展开其详细视图：查看库描述、Git 远程仓库地址、当前分支/提交哈希，以及引擎在加载该库时抛出的任何详细日志。
1. 安装新算子库
点击 Add Library 唤起安装弹窗，粘贴社区开源库的 Git 仓库地址（如 GitHub 链接），点击 Install。
编辑器首先会快速探测该仓库的元数据清单，向你呈现包含库名称、描述版本以及所含节点总数的确认弹窗，确认无误后开始克隆并安装依赖。
点击 Advanced Options（高级选项）可以手动指定：
- Branch / Tag / Commit：精准指定拉取某个特定的 Git 引用而非默认的 main 分支；
- Download Directory：自定义该库的本地磁盘落盘路径。
若暂时不确定安装什么，点击下方的 Browse Community Libraries 即可探索官方精选的社区插件库。
2. 算子库在线平滑升级 (Updating)
展开带有 Git 远程源的算子库，点击 Check for Updates 即可比对本地提交与远端最新版本。一旦检测到可用更新，行操作区会浮现 Update to x.x.x 按钮，点击一键拉取最新代码并热重载。
若某库的 Pip 依赖在首次拉取时偶发中断，无需重新克隆整个仓库，直接点击其卡片中的 Install Dependencies 按钮即可单独对依赖环境进行安全重试重装。
3. 停用与卸载算子库
Library Management 视窗专注于算子库的拉取与版本对齐，若需要彻底从磁盘物理擦除算子库、将其临时置灰停用，或调整其在操作系统层面的运行容器（Shared 进程混跑 vs Isolated 子进程沙盒隔离），请在 Configuration Editor → Libraries 面板中操作，详见 算子库管理手册。