Vue 3 + Vite 引入 iclient-ol，矢量瓦片加载实战指南
2026/9/15 1:07:12
1. Hermes 安装那几级台阶，先确认走完了
1.1 管理员 PowerShell 跑安装脚本
原文的第一步是复制安装命令，打开 PowerShell 粘贴运行。命令本身不难，难在「管理员权限」经常被忽略。普通窗口执行irm https://res1.hermesagent.org.cn/install.ps1 | iex时，如果中途需要写入系统目录或修改环境变量，会因为权限不足而静默失败，屏幕上不出现任何红色报错。所以打开 PowerShell 时，先在开始菜单搜 PowerShell，右键选择「以管理员身份运行」，再执行：
irm https://res1.hermesagent.org.cn/install.ps1 | iex如果 PowerShell 提示「禁止运行脚本」，多半是当前执行策略限制了，可以顺手执行一句Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，按 Y 确认后再跑安装命令。装完之后别急着关窗口，重新打开一个新终端，输入hermes --version。能显示版本号，说明 Hermes 程序本体已经就位；显示找不到命令，说明刚才安装过程有环节没走完，先补齐这一步再往后面配置。
1.2 Hermes One 与 D 盘迁移
后面两步是安装可视化界面 Hermes One，再把 Hermes 迁移到 D 盘。Hermes One 相当于图形操作台，装好之后不需要每次都用命令行。迁移 D 盘这件事，文件复制只是表面动作，真正的关键是环境变量。如果你只是把整个 Hermes 目录从 C 盘拖到 D 盘，没有修改环境变量，系统下次打开 Hermes 时还是在找 C 盘的旧路径，找不到就闪退或者报错。修改完环境变量后，必须重新打开终端或重启一次相关进程，让新的 PATH 值被真正加载。可以用where.exe hermes看一眼输出路径，确认是否已经是 D 盘的位置，确认没问题再进入模型 API 配置环节，避免后面把「路径不对」误判成「模型地址不对」。
1.3 安装完成不等于能对话
这里要说的是最容易被误会的一点：安装完成只是把 Hermes 这个外壳装好了，它里面并没有自带模型。打个比方，Hermes 像是一个已经安装好的浏览器，模型 API 地址就是地址栏里的网址；不输入网址，浏览器不可能凭空打开页面。Hermes One 打开后如果一直提示未配置模型或连接失败，不是安装出问题了，而是模型 API 还缺三项参数：Base URL、API Key、模型 ID。TaoToken 可以把这三项统一管理起来，你在官网拿一把 Key，Base URL 固定填https://taotoken.net/api，模型 ID 按需换。下载好的 Agent 能不能跑起来，真正起决定性作用的就是这一节。
2. 先拿 Key，再把 Hermes 模型 API 地址指到 TaoToken
2.1 注册、登录、创建 Key
配置前准备工作不多，打开 TaoToken，注册并登录，进入控制台的 API Keys 页面，新建一把 Key。创建后马上复制出来，存到本地一个临时文本里。注意，很多平台为了安全，Key 只在创建那一刻完整显示一次，关掉页面再回来只能重新创建。复制时不要选中多余空格，也不要手动补字符，粘贴到 Hermes 前先在记事本里看一遍末尾字符有没有丢。
2.2 在 Hermes One 里打开模型 API 设置
回到 Hermes One 的设置面板，找到模型 API 或语言模型设置。不同版本入口叫法不太一样，有的在「设置 > 模型」，有的在「AI 服务」下面，但字段基本一致：Base URL、API Key、模型 ID。如果界面上默认填了官方地址，先清空，再按下一节表格替换。有些版本还带「自定义」开关，手动填写时需要先打开这个开关，否则输入框是灰的。保存前再扫一眼，三个字段不要填反。
2.3 参数对照与 /v1 提醒
| 配置项 | 填写内容 |
|---|---|
| Base URL | https://taotoken.net/api |
| API Key | YOUR_API_KEY |
| Model ID | 以 模型广场 当前列表为准 |
这里最容易出错的，是 Base URL 末尾的/v1。许多模型服务商的地址长这样，于是到了 TaoToken 这里也习惯性补上/v1，结果 Hermes 请求时拼出一个不存在的路径，返回 404。TaoToken 的 Base URL 就是https://taotoken.net/api，后面什么都不加。API Key 必须是刚才在官网创建的YOUR_API_KEY，模型 ID 去模型广场复制，不要凭记忆手打。如果模型广场上同一个模型有好几个版本显示，挑名字跟你任务匹配的那一个复制；拿不准就选列表里标记为 Stable 或推荐的那个。
2.4 先到网页端验证 Key 是否有效
在 2.1 创建完 Key 之后，如果你担心后面排障把问题搞混，可以先在 TaoToken 模型对话 里手动选择同一个模型，用这把 Key 发一条消息。这一步能确认 Key 本身能用、模型 ID 没有写错。网页端通过后再回 Hermes 填写，后面再遇到问题，排障范围就只有 Hermes 这一侧了。
3. 验证：让下载好的 Agent 正常跑起来
3.1 先发一句最简单的对话
配置保存后回到 Hermes One，先不要着急丢长文档或复杂任务。第一步发一句「你好，请用一句话介绍你自己」。这句话返回速度快，也足够检验链路。返回正常文本，说明 Base URL、Key、模型 ID 三样全部对上，下载好的 Hermes Agent 已经能正常跑。返回报错也不要慌，按第四章顺序逐项查即可。先跑通最简对话，再去切模型、加技能或让它写代码，排查成本会低很多。
3.2 让它做一个真实的小任务
简单对话通过后，可以再试一个真实一点的任务，比如让 Hermes 写一段 Python 脚本：读取当前目录所有文件并按修改时间排序打印。注意这里 Hermes 只是生成代码，具体执行由你在本机跑，跑完把结果贴回对话。这样既能验证模型 API 的稳定性，也能确认 Agent 的回复没有被截断或超时。真正用起来时，Agent 负责生成和解释，执行操作仍由人工确认，这个边界在配置阶段养成习惯最好。
3.3 回控制台对一下调用记录
对话成功后，打开 TaoToken 控制台的用量页面，刷新一下，你应该能看到刚才那两轮对话的记录。这一步是确认 Hermes 的请求确实进了 TaoToken 通道，而不是走了旧配置或者本地缓存。能查到记录，说明「模型 API 地址改到 TaoToken」这件事真正闭环，后面写代码、总结资料、处理长文都会稳定走同一条通道；查不到记录，多半是填写项里有非打印字符，回头重新粘贴一次 Key。
4. 配置后最常碰到的三个报错
4.1 401 或 Unauthorized
401 说明请求已经到达服务端，但认证没通过。最常见的场景是 Key 在复制时漏了末尾几个字符，或者把旧 Key 当成新 Key 填了进去。处理方式是回到官网控制台的 API Keys 页面，重新创建一把 Key，完整复制后覆盖粘贴到 Hermes，粘贴后不要在 Key 前后加任何内容。如果用了多个平台的 Key，注意别把其他服务商的密钥填进 Hermes，格式虽然相似，但 Hermes 请求时认证对象不对，同样会 401。
4.2 404 或 model not found
404 和 model not found 基本指向两个原因：路径多了后缀，或者模型 ID 不存在。路径方面，检查 Base URL 是不是写成了https://taotoken.net/api/v1，把/v1删掉就能恢复；模型 ID 方面，不要自己猜测名称，以官网模型广场列出的为准。有些模型在更新后会换 ID，原来复制过的一次性文本要重新去广场复制，旧 ID 可能已经下线。
4.3 网络超时或连接失败
如果换成 TaoToken 之前一切正常，换成之后超时，先不要急着怀疑 Key。在 PowerShell 里执行Test-NetConnection taotoken.net -Port 443，看 TCP 443 是否连通。通则再把 Hermes One 完整退出重启，很多时候连接失败是进程缓存了最早填的官方地址，重启后才重新读取配置。还有一种情况是系统代理或防火墙拦掉了非默认端口的请求，可以在 TaoToken 网页端先测试同模型的对话，网页端正常就说明网络链路没问题，问题仍在本机进程。
提示：排障时先固定变量。网页端模型对话用同一把 Key 发一条消息，网页端正常就回 Hermes 排查；网页端也报错就去检查 Key 是否有效。
5. 迁移 D 盘与环境变量的收尾
5.1 确认 PATH 指向新位置
如果你按原文把 Hermes 迁移到了 D 盘，修改环境变量后，配置模型 API 前最好先确认 PATH 的新值已经生效。重新打开 PowerShell，执行where.exe hermes。如果返回的路径还在 C 盘，说明环境变量只是保存了，没有在当前会话里重新加载；关闭终端重开，或者注销一次用户会话，再看结果。这一步不做，你可能在保存模型配置后准备对话时遇到闪退，那个时刻很难判断是 API 问题还是路径问题。
5.2 检查 Hermes One 版本与配置入口
环境变量正常后，顺手确认 Hermes One 的版本号。部分旧版本的可视化界面里，模型 API 设置的入口名称不一样，有的还藏在「高级设置」下面。如果按 2.2 找不到入口，去官网查一下当前版本的接入文档，或者看设置里有没有「API 兼容模式」这类开关。版本太旧的话，先升级 Hermes One 再回来填参数，否则界面字段对不上，容易出现填了下拉框但没保存上的假象。
5.3 把配置参数留个底
模型 API 调通后，把 Base URL、Key、模型 ID 记到本地文件里。以后升级 Hermes One、重置配置或换电脑，照着填回去就能恢复。Key 从 TaoToken 创建，不要发给别人；用量记录在官网控制台随时可查。如果使用频率高，也可以提前打开 Coding Plan 看看更适合的套餐；Key 的管理和暂停统一在 控制台 API Keys 页面。到这里，Hermes 的模型 API 地址已经完整指到 TaoToken，下载好的 Agent 可以直接开始干活。