AI Hub
AI Hub 是所有 AI 相关事务的桌面一侧。它有三个标签页——AI Agents、Knowledge Base 和 Settings——在浏览器里不好办的事都在这里做：准备运行环境、下载数 GB 的模型，以及指定要索引的 文件夹。
首次运行：三步向导
从未跑过 AI 的机器看到的是一个向导，而不是一整面设置：
- Environment —— 检查是否有 Python 3.10 或更高版本，并安装依赖。这是耗时以分钟计、下载量 最大的一步。
- Model —— 列表按这台电脑匹配：把它的处理器、内存、显卡和可用磁盘空间与最新的模型列表进行比较， 并预先选中最合适的一个。每一行都说明模型会在哪里运行（显卡、显卡 + 内存或处理器）以及速度如何。
- Launch —— 启动服务并载入模型。
如果环境检查报告找不到 Python，装好之后再检查一次；在 Windows 上安装程序通常会附带一份私有副本， 所以这一般只出现在便携版。参见 在 Windows 上免安装运行 Filemote。
AI Agents
Main Orchestrator 是默认作答的模型。它的卡片显示服务在线还是已停止、权重是否仍在载入，以及一个 请求计数。
- Start AI / Stop AI 控制服务。
- Change Model 或 Replace 更换已载入的模型。
- Unload 释放模型占用的内存，但不停止服务。
- Model Catalog 展开后列出所有适合这台电脑的模型，可用于主模型或专家槽位。每次下载在使用前都会经过 校验和验证。在搜索框中输入还会搜索 HuggingFace，用于手动挑选主模型。
启动之前，配置器可以校验模型：确认它确实存在、类型适合聊天，以及机器内存是否够用——会直白地 提示「模型需要约 7 GB，只有 4 GB 可用」，而不是让你在十分钟后才失败。
专用代理就是文档、视觉、代码和摘要这几个槽位。载入某一个，就把该类问题交给它；留空则回落到 主编排模型。每个已载入的模型只要还载着就一直占内存——这就是全部的取舍。
关于 Stop 按钮
Stop AI 会停止 AI 服务，而且值得知道：如今这句话成立的方式，和过去并不相同。
配置器和代理可能同时持有 8765 端口上的同一个 AI 服务。曾有一个版本，Stop 只结束了窗口恰好持有的 那个句柄——由另一侧启动的服务照旧运行，而状态轮询发现它还活着，实际上又把它带了回来。如果你曾见过 AI「自己起来」，就是这件事，现在已经修好：Stop 会结束该端口上的进程，并记下这是你要求的，因此不会 有人在你背后把它复活。
AiAutoStart 是另一个设置：它让 AI 服务随代理一起启动，按下 Stop 并不会改变它。
Knowledge Base
顶部的计数显示chunks、documents 和磁盘占用大小。
Indexed Folders 就是真正会被读取的那份列表；+ Add Folder 与 Remove 管理它，索引过程会 显示进度，并有自己的 Stop。另有两个来源藏在同意勾选之后：Browser history 与 Email (.eml/.msg)——各自能走多远，写在 AI 模型与知识库里。
一个有用的细节：处理知识库并不需要完整的 AI 服务。当代理没有运行时，配置器会启动一个只管知识库的 小助手，因此索引一个文件夹并不意味着先要载入一个语言模型。
Settings
模型默认值、计算设备、回复长度、系统提示词，以及索引计划。这里的每个字段都对应
app_settings.json 里的一个字段，列在
手动配置代理中。
当它起不来时
Hub 会说明发生了什么，而不是默默失败：模型未下载、服务器不可用、载入失败。每条消息都点名是哪一步。 按值得排查的顺序列出的原因清单，见 AI 无法加载。
更新于 2026-10-02