Win11 安装 Hermes 教程：从零入门到高效使用，附避坑与技巧总结

{"type":"doc","content":[{"type":"heading","attrs":{"id":"411f0a13-6d52-4403-83d2-c8799c627d4c","textAlign":"inherit","indent":0,"level":1,"isHoverDragHandle":false},"content":[{"type":"text","text":"Win11 安装 Hermes 教程：从零入门到高效使用，少走弯路的一篇就够了"}]},{"type":"paragraph","attrs":{"id":"01b567bf-483f-44f3-ad7c-4ac35d37392e","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果你想在 Windows 11 上体验 Hermes，但又担心环境复杂、命令太多、装完跑不起来，这篇文章就是写给你的。"}]},{"type":"paragraph","attrs":{"id":"86593bd7-cbe7-4df3-99c4-4c6e8b68af94","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"我会按照“先跑通，再进阶”的思路，带你完成这几件事："}]},{"type":"bulletList","attrs":{"id":"455a17ac-d48f-43a8-87b0-956113172250","isHoverDragHandle":false},"content":[{"type":"listItem","attrs":{"id":"c14ee16e-a504-460b-99e9-993dab131215"},"content":[{"type":"paragraph","attrs":{"id":"46f212ba-c22e-4fec-8930-613bd150bd1e","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"在 Win11 上正确安装 Hermes"}]}]},{"type":"listItem","attrs":{"id":"8a84d4cf-eb5b-440a-b13e-058928004946"},"content":[{"type":"paragraph","attrs":{"id":"a090d206-042e-439a-acc1-524ceebe0495","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"理解为什么官方推荐走 "},{"type":"text","marks":[{"type":"code"}],"text":"WSL2"}]}]},{"type":"listItem","attrs":{"id":"94035764-91b4-43ff-b9d5-3d447203a322"},"content":[{"type":"paragraph","attrs":{"id":"b6fe2dec-5155-428f-826c-d9e9e0ccf398","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"完成首次模型配置与可用性验证"}]}]},{"type":"listItem","attrs":{"id":"2969b9cb-86a7-4106-aad4-a14b8821bdf9"},"content":[{"type":"paragraph","attrs":{"id":"b3fa9804-a6d7-4f83-a555-9a187cc374b7","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"解决新手最常遇到的报错"}]}]},{"type":"listItem","attrs":{"id":"0353a24a-2767-4e6f-84e7-24d5d818ea6d"},"content":[{"type":"paragraph","attrs":{"id":"8370d206-9ad1-4422-8e68-13d961a1cff4","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"掌握一批真正有用的使用技巧"}]}]}]},{"type":"paragraph","attrs":{"id":"f8ea2dc1-5b69-4db0-8228-096fc05b2b3c","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"这篇文章基于 Hermes 官方文档整理，适合发布到技术论坛，也适合你收藏后照着一步步操作。"}]},{"type":"heading","attrs":{"id":"b3893ebc-4b8b-46e6-8035-fcc9ee0ece45","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"1. Hermes 是什么，适合哪些人？"}]},{"type":"paragraph","attrs":{"id":"e96272f5-de58-497a-8e34-c5742f2c62d8","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"Hermes Agent 可以理解为一个“可调用工具的 AI 助手框架”。它不只是普通聊天，而是能在合适授权下使用终端、读写文件、搜索网页、调用技能，并把这些能力串起来完成任务。"}]},{"type":"paragraph","attrs":{"id":"61940ab8-9edc-4de5-a3e5-725065e7c8e8","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"它比较适合这几类人："}]},{"type":"bulletList","attrs":{"id":"eb0af10f-3304-4071-a5b5-e852d17e770e","isHoverDragHandle":false},"content":[{"type":"listItem","attrs":{"id":"c1be5716-d94a-435a-860e-8605a0bde415"},"content":[{"type":"paragraph","attrs":{"id":"a2fe08d3-5118-4a10-aa2f-e6998ae630a9","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"想把 AI 真正接入日常开发工作流的程序员"}]}]},{"type":"listItem","attrs":{"id":"33981551-fe42-4769-ac54-22aba0af3766"},"content":[{"type":"paragraph","attrs":{"id":"36871feb-62d5-45c9-af2a-5e7727e2d65f","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"想做自动化助手、消息机器人、知识工作流的人"}]}]},{"type":"listItem","attrs":{"id":"3eb54525-eb93-4d59-853f-3ccd7716f504"},"content":[{"type":"paragraph","attrs":{"id":"bf13ea31-0933-463d-bb59-aea7dd264c44","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"想把本地工具、远程环境、LLM 模型能力串起来的人"}]}]}]},{"type":"paragraph","attrs":{"id":"07fbb0e1-2444-4226-9d01-d5594474a0f4","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果你只是想“随便问答”，网页聊天就够了；如果你想让 AI 真的“干活”，Hermes 会更有意思。"}]},{"type":"heading","attrs":{"id":"8a1e1a02-f5d3-457f-abd0-8a21d3b112ec","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"2. 为什么 Win11 不建议原生装，而是推荐 WSL2？"}]},{"type":"paragraph","attrs":{"id":"dfa9b7c3-036e-4dbc-ac49-5768f873ee55","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"这一点非常关键。"}]},{"type":"paragraph","attrs":{"id":"41b10939-0e66-4723-a448-6930ba72767e","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"根据官方安装文档，"},{"type":"text","marks":[{"type":"bold"}],"text":"原生 Windows 当前不受支持"},{"type":"text","text":"，Windows 用户推荐先安装 "},{"type":"text","marks":[{"type":"code"}],"text":"WSL2"},{"type":"text","text":"，然后在 WSL2 的 Linux 终端里安装和运行 Hermes。"}]},{"type":"paragraph","attrs":{"id":"f0ae98f0-5229-43d5-a630-991e4690a305","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"原因并不复杂："}]},{"type":"bulletList","attrs":{"id":"fd2882c3-1607-4caa-87b7-15cc31295267","isHoverDragHandle":false},"content":[{"type":"listItem","attrs":{"id":"7faaa016-a8d1-4004-9571-a7b35b178282"},"content":[{"type":"paragraph","attrs":{"id":"5f5d7abe-11ca-4e49-9c7a-f6f679ee6539","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"Hermes 的安装与运行链路更偏 Linux/Unix 环境"}]}]},{"type":"listItem","attrs":{"id":"fe649826-0f49-4337-bc3e-4a3e67be7917"},"content":[{"type":"paragraph","attrs":{"id":"59c454cc-b3ba-427a-bd3a-1d0038ef7e70","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"一些依赖、脚本、工具链在 WSL2 下更稳定"}]}]},{"type":"listItem","attrs":{"id":"fc7e8c0b-5e4c-4c10-8eb5-93b83771c977"},"content":[{"type":"paragraph","attrs":{"id":"7e15b2f5-87e1-44f1-b49e-d43b680edb4a","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"后续如果你要接入终端、脚本、自动化、开发环境，WSL2 兼容性会明显更好"}]}]}]},{"type":"paragraph","attrs":{"id":"827e602a-52c9-48d8-bef6-708a89c8ed1b","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"所以，"},{"type":"text","marks":[{"type":"bold"}],"text":"Win11 安装 Hermes 的正确思路不是“Windows 原生安装”"},{"type":"text","text":"，而是："}]},{"type":"paragraph","attrs":{"id":"5a3fccfb-474d-41f6-8d3d-3f12bfafea91","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","marks":[{"type":"code"}],"text":"Windows 11 -> WSL2 -> Ubuntu -> 安装 Hermes"}]},{"type":"paragraph","attrs":{"id":"42dd6719-9968-42ff-8d39-59dd57c32680","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果你一开始方向就错了，后面会遇到很多没必要的坑。"}]},{"type":"heading","attrs":{"id":"d30e6fe1-22bd-4348-9820-16eb6eaf3868","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"3. 安装前准备"}]},{"type":"paragraph","attrs":{"id":"2d2bef14-c59e-4bb9-b1f9-8ad206219740","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"正式开始前，先确认几件事："}]},{"type":"bulletList","attrs":{"id":"20e71f2a-19a1-43ab-bc8b-0593f2ee1a3a","isHoverDragHandle":false},"content":[{"type":"listItem","attrs":{"id":"4b86ecb1-4de0-4297-accf-dcc02be458de"},"content":[{"type":"paragraph","attrs":{"id":"cd9a09da-ce44-446e-93c6-97b1636a5c1f","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"你的系统是 "},{"type":"text","marks":[{"type":"code"}],"text":"Windows 11"}]}]},{"type":"listItem","attrs":{"id":"0c810630-1a33-4d1f-a355-0a431f4e1e32"},"content":[{"type":"paragraph","attrs":{"id":"2e35acb8-582b-4354-a108-c3e3c1ce2493","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"可以使用管理员权限打开 PowerShell"}]}]},{"type":"listItem","attrs":{"id":"8fef294a-8921-4a13-babc-2d923c0cdcbc"},"content":[{"type":"paragraph","attrs":{"id":"3ec85b25-6bac-4802-8cc5-309ce2711bec","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"网络能够访问 GitHub 及相关依赖源"}]}]},{"type":"listItem","attrs":{"id":"03ab44e0-d867-45c0-844d-fa774dcac3bf"},"content":[{"type":"paragraph","attrs":{"id":"5a31f32a-7c03-4a2b-ab7a-aa04427b9dae","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"你至少准备好一个可用的模型提供方账号"}]}]}]},{"type":"paragraph","attrs":{"id":"a92100e2-8f1b-4d6e-b260-c4734b445261","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"官方文档提到，Hermes 安装时最核心的前置条件其实只有一个："},{"type":"text","marks":[{"type":"bold"}],"text":"Git 可用"},{"type":"text","text":"。Python、Node.js、ripgrep、ffmpeg 等依赖，安装器会尽量自动处理。"}]},{"type":"paragraph","attrs":{"id":"93a33acf-1890-4035-bed9-6ab1e3e4de1e","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"不过从实战经验看，Win11 用户还要额外注意两点："}]},{"type":"bulletList","attrs":{"id":"a9b4c5a6-7fbb-4870-8005-ad63400b8a80","isHoverDragHandle":false},"content":[{"type":"listItem","attrs":{"id":"391e998b-1033-4de8-8aff-b6ec4c4803b1"},"content":[{"type":"paragraph","attrs":{"id":"7672411d-e9ca-41e0-a37a-87132c818bc9","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果 "},{"type":"text","marks":[{"type":"code"}],"text":"WSL2"},{"type":"text","text":" 安装失败，先检查 BIOS 里是否开启虚拟化"}]}]},{"type":"listItem","attrs":{"id":"e46f8dfe-1ce6-4c9f-ab00-349d49428703"},"content":[{"type":"paragraph","attrs":{"id":"31cbcab0-dc7c-4209-bb93-78beb30b1fcd","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果公司网络较严格，建议提前准备代理，否则安装脚本和后续模型连接都可能失败"}]}]}]},{"type":"heading","attrs":{"id":"dca0b602-14e2-406c-b61c-1159fbe37ccd","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"4. 第一步：在 Win11 上安装 WSL2"}]},{"type":"paragraph","attrs":{"id":"acdf4b2d-c3d1-4bbd-b4d0-fc8e4bf4da75","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"先用管理员身份打开 PowerShell，执行："}]},{"type":"codeBlock","attrs":{"id":"11578658-f263-4c14-9afe-2ba88c3edcd8","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"wsl --install -d Ubuntu"}]},{"type":"paragraph","attrs":{"id":"eea0b705-45c5-4a21-b827-6e729c46bf5a","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"这条命令会自动完成 WSL2 和 Ubuntu 的安装。执行完成后，通常需要重启系统。"}]},{"type":"paragraph","attrs":{"id":"589a2cfa-d29e-4c7c-a796-c370001107c3","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"重启后，打开 Ubuntu，第一次启动会提示你创建 Linux 用户名和密码，照提示完成即可。"}]},{"type":"paragraph","attrs":{"id":"d963cb39-f6dd-4b8a-b2e7-e587c171e235","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"安装成功后，可以在 PowerShell 里检查一下："}]},{"type":"codeBlock","attrs":{"id":"5a218861-f911-4175-bd49-d3fece8c8df2","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"wsl --status"}]},{"type":"paragraph","attrs":{"id":"c20d3f08-1a33-4b33-a358-837ee86b84e9","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果你能看到 WSL 正常启用，并且默认版本是 2，基本就可以继续了。"}]},{"type":"heading","attrs":{"id":"c66afa6a-ba30-481c-8549-52b65b9640d0","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"5. 第二步：进入 Ubuntu，准备基础环境"}]},{"type":"paragraph","attrs":{"id":"4bf2282e-a992-4f70-b626-f2aa033d02ce","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"后面的命令，默认都在 "},{"type":"text","marks":[{"type":"bold"}],"text":"WSL2 的 Ubuntu 终端"},{"type":"text","text":" 里执行，不是在 PowerShell 里执行。"}]},{"type":"paragraph","attrs":{"id":"0f4388a2-0bd6-4168-b1b1-ed16d53fa413","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"先更新软件源并确保 "},{"type":"text","marks":[{"type":"code"}],"text":"git"},{"type":"text","text":" 可用："}]},{"type":"codeBlock","attrs":{"id":"dfe303fb-e935-4e5d-a9b7-81bd8422a85d","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"sudo apt update\nsudo apt install -y git curl\ngit --version"}]},{"type":"paragraph","attrs":{"id":"99b1b238-1085-4634-80c9-d52020a50b0c","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"只要 "},{"type":"text","marks":[{"type":"code"}],"text":"git --version"},{"type":"text","text":" 能正常输出版本号，说明前置条件满足。"}]},{"type":"heading","attrs":{"id":"7d3a6d9e-8271-4e4a-a086-bef3186e4b5e","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"6. 第三步：在 WSL2 中安装 Hermes"}]},{"type":"paragraph","attrs":{"id":"b37dbd3b-4f2d-40dc-8d02-1fd2e93691ba","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"官方推荐的一键安装命令如下："}]},{"type":"codeBlock","attrs":{"id":"cece0fcd-596c-4af1-b26b-6b94487f61d5","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash"}]},{"type":"paragraph","attrs":{"id":"e04d925a-a544-4789-8555-140130355aed","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"安装完成后，按官方建议重新加载 Shell："}]},{"type":"codeBlock","attrs":{"id":"f1397379-b715-4e6f-bbab-5ecd391bd738","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"source ~/.bashrc"}]},{"type":"paragraph","attrs":{"id":"650cbc9d-68e8-4ec3-8444-af908e26ddf2","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果你使用的是 "},{"type":"text","marks":[{"type":"code"}],"text":"zsh"},{"type":"text","text":"，则改成："}]},{"type":"codeBlock","attrs":{"id":"a70413b7-1128-4262-b81a-b58257f91041","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"source ~/.zshrc"}]},{"type":"paragraph","attrs":{"id":"61d96057-aab4-482e-8282-6716888938f3","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"然后执行："}]},{"type":"codeBlock","attrs":{"id":"4c60c641-85ed-4b83-985b-c4a082543839","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"hermes"}]},{"type":"paragraph","attrs":{"id":"aaac50f4-292e-4abe-a640-11e2937bd5ca","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果命令能正常启动，说明安装链路基本没问题。"}]},{"type":"heading","attrs":{"id":"251b90d3-8657-4348-9e1f-b6f5ba057c17","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"7. 第四步：配置模型 Provider，这是最容易出错的一步"}]},{"type":"paragraph","attrs":{"id":"a5468930-66d9-4254-a001-cf9d16c9db3c","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"很多人以为“装完就能用”，实际上真正决定 Hermes 能不能正常工作的，是模型提供方配置。"}]},{"type":"paragraph","attrs":{"id":"4e125587-af6a-4d2e-9073-6329b6bcb359","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"官方建议用下面的命令进入交互式配置："}]},{"type":"codeBlock","attrs":{"id":"bbc1db8d-d770-4e43-aec7-dabb109a1b0a","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"hermes model"}]},{"type":"paragraph","attrs":{"id":"faa9e8c1-6f6f-4906-99c6-8d50f5ccdf18","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果你是第一次使用，建议优先选择摩擦最小的路径："}]},{"type":"bulletList","attrs":{"id":"c46b6347-c0f8-4ab9-ba4c-04ca71b56402","isHoverDragHandle":false},"content":[{"type":"listItem","attrs":{"id":"6f35c7c3-d79d-4365-9e88-92aa71806c62"},"content":[{"type":"paragraph","attrs":{"id":"e141d3a1-1608-488b-a646-6254f2858ebd","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"想快速跑通："},{"type":"text","marks":[{"type":"code"}],"text":"Nous Portal"},{"type":"text","text":" 或 "},{"type":"text","marks":[{"type":"code"}],"text":"OpenRouter"}]}]},{"type":"listItem","attrs":{"id":"6173d694-482d-40c7-bf60-9f8905dc2d25"},"content":[{"type":"paragraph","attrs":{"id":"de0069c8-92b4-4dc2-990a-5550ebb025a6","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"已有 Claude / OpenAI 相关认证：可选对应 Provider"}]}]},{"type":"listItem","attrs":{"id":"3c48650c-a3da-4775-86d1-312b7a31e880"},"content":[{"type":"paragraph","attrs":{"id":"02561980-4687-48eb-bb05-6e4a1e58a560","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"想跑本地模型：可接 "},{"type":"text","marks":[{"type":"code"}],"text":"Ollama"},{"type":"text","text":" 或兼容 OpenAI API 的自建端点"}]}]}]},{"type":"heading","attrs":{"id":"54cb6813-3df4-4891-842b-6bbc77a1184f","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"一个重要要求：上下文窗口至少 64K"}]},{"type":"paragraph","attrs":{"id":"8e4cc6ef-efcd-43f9-ad9b-23619b93fe46","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"官方文档明确提到，Hermes 需要模型至少支持 "},{"type":"text","marks":[{"type":"bold"}],"text":"64,000 tokens"},{"type":"text","text":" 的上下文窗口。上下文太小，很多多步工具调用场景会直接失效，甚至在启动时被拒绝。"}]},{"type":"paragraph","attrs":{"id":"436fd735-1314-4a41-a98a-62f5ea974f80","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"所以你在选模型时，不要只看“便宜”或者“快”，还要看它是否满足上下文要求。"}]},{"type":"heading","attrs":{"id":"7a572dc6-9488-4894-85a3-8b593b8748b2","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"配置文件存在哪里？"}]},{"type":"paragraph","attrs":{"id":"33d3433a-ba2d-4a18-ae45-795a5860c436","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"这点建议新手顺手记住："}]},{"type":"bulletList","attrs":{"id":"bb582329-acbd-4d32-b63b-4fd76cfd2790","isHoverDragHandle":false},"content":[{"type":"listItem","attrs":{"id":"9d43c8ee-e66a-450a-a481-4eb5e842cfeb"},"content":[{"type":"paragraph","attrs":{"id":"0ca22f63-5cfe-4da3-b51e-1b83965093ee","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"密钥、令牌这类敏感信息："},{"type":"text","marks":[{"type":"code"}],"text":"~/.hermes/.env"}]}]},{"type":"listItem","attrs":{"id":"49f6708f-9eea-4ba4-b28c-d47c00a6311b"},"content":[{"type":"paragraph","attrs":{"id":"c3ef7f14-def8-445a-994e-f08f32e9d39c","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"普通配置项："},{"type":"text","marks":[{"type":"code"}],"text":"~/.hermes/config.yaml"}]}]}]},{"type":"paragraph","attrs":{"id":"0af264de-be91-45eb-91ea-fe86035b82a1","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果你通过 CLI 设置，Hermes 会自动把内容写到正确的位置。例如："}]},{"type":"codeBlock","attrs":{"id":"c2c4ff2c-ecf2-4dd7-80ab-8faaa092c7ef","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"hermes config set model anthropic/claude-opus-4.6\nhermes config set terminal.backend docker"}]},{"type":"paragraph","attrs":{"id":"04c0804e-22bb-4f09-a80a-2e1ada63e267","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"这种方式比你手改配置文件更稳。"}]},{"type":"heading","attrs":{"id":"050bc478-6f05-4266-9c31-bb09e6574de7","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"8. 第五步：跑通第一次对话，别一上来就折腾高级功能"}]},{"type":"paragraph","attrs":{"id":"22030a66-c1af-46ee-844e-a4753a64630b","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"安装和 Provider 配置完成后，先做一件最朴素的事：验证 Hermes 能正常聊天。"}]},{"type":"paragraph","attrs":{"id":"4a400bc1-090d-49fa-8cc8-9a23a80220e4","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"你可以用经典 CLI："}]},{"type":"codeBlock","attrs":{"id":"2f0c251c-aec4-47f8-82c6-9420b2d61828","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"hermes"}]},{"type":"paragraph","attrs":{"id":"efb804d4-c5ac-4e85-bdca-340fb8f46afa","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"也可以用官方更推荐的 TUI："}]},{"type":"codeBlock","attrs":{"id":"5aa1fa56-6b2c-4ca3-bdde-15c696840da0","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"hermes --tui"}]},{"type":"paragraph","attrs":{"id":"019e69fe-6027-47ae-a67c-d90c5c64be34","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"建议你先发一个容易验证结果的请求，比如："}]},{"type":"codeBlock","attrs":{"id":"95e4f178-337f-4a01-b876-19f0801fdbd8","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"查看我当前目录，告诉我最像项目入口文件的是哪个。"}]},{"type":"paragraph","attrs":{"id":"aba206d7-7d13-4e08-8a93-c85a95a858a5","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"或者："}]},{"type":"codeBlock","attrs":{"id":"7c48800f-2075-43cd-8173-58c7fcbe12f3","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"用 5 个要点总结一下这个仓库。"}]},{"type":"paragraph","attrs":{"id":"79ddd9ea-e38e-4428-9bd3-34d3c26f3646","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果出现以下现象，说明你已经跨过最难的一关："}]},{"type":"bulletList","attrs":{"id":"0211234a-618e-4661-a8fe-415b5abd31a2","isHoverDragHandle":false},"content":[{"type":"listItem","attrs":{"id":"b08a342d-2e9b-4648-8514-25e7a52b8fac"},"content":[{"type":"paragraph","attrs":{"id":"ee153a4f-84da-4fff-b334-3aa3d19745a1","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"启动画面能显示你当前选定的模型或 Provider"}]}]},{"type":"listItem","attrs":{"id":"86c8bb17-5acf-4d05-8a26-7b53ebbe3845"},"content":[{"type":"paragraph","attrs":{"id":"7eb9891a-60e0-484f-87b7-068dee54172c","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"Hermes 能正常回复，而不是报错或空响应"}]}]},{"type":"listItem","attrs":{"id":"b5a32472-438c-44d9-880a-72ca4a8d18ca"},"content":[{"type":"paragraph","attrs":{"id":"2c60031c-05f2-4ecf-9176-8cafd258658f","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"遇到需要时，它能调用工具"}]}]},{"type":"listItem","attrs":{"id":"82cb9ad0-b24a-4d14-9601-a02b8a35914a"},"content":[{"type":"paragraph","attrs":{"id":"ae5b8a23-96ff-46b6-95ec-b4f2bb45c0ca","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"对话可以连续进行，而不是第一轮就崩"}]}]}]},{"type":"paragraph","attrs":{"id":"eef4f603-296b-490d-a4ad-393e7015f12f","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"经验建议：如果基础聊天都还没稳定，不要急着开 Gateway、技能、语音、路由和自动化。"}]},{"type":"heading","attrs":{"id":"010c4507-720c-4aad-81fe-5e24246b0b5b","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"9. 第六步：验证会话恢复功能"}]},{"type":"paragraph","attrs":{"id":"6f8b0ceb-8591-4e29-bd56-7bf92dc8c657","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"这一步很容易被忽略，但非常实用。"}]},{"type":"paragraph","attrs":{"id":"ad7ccfde-dae0-4915-adf3-48e6901b70bf","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"执行："}]},{"type":"codeBlock","attrs":{"id":"9c474e51-e791-4f3d-9178-d56195512912","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"hermes --continue"}]},{"type":"paragraph","attrs":{"id":"f0f877e6-42d4-4458-8122-921995b49801","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"或者短命令："}]},{"type":"codeBlock","attrs":{"id":"1be2b6d4-87ea-4690-80dc-5e7976d20990","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"hermes -c"}]},{"type":"paragraph","attrs":{"id":"0dca9809-38c6-41b2-a1a4-675802c7139b","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果能恢复到你刚才的会话，说明会话保存没问题。后面你在多项目切换、长任务续跑时，会明显感受到这个功能的价值。"}]},{"type":"heading","attrs":{"id":"d9271523-cf36-40e0-8600-cf1fec1f2f7d","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"10. Win11 用户最常见的几个问题"}]},{"type":"heading","attrs":{"id":"e581f67b-954a-4c79-b134-54c2b4e6ddfb","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"1. "},{"type":"text","marks":[{"type":"code"}],"text":"hermes: command not found"}]},{"type":"paragraph","attrs":{"id":"33ea8335-aaf1-4be9-95ae-77488fd9208b","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"常见原因："}]},{"type":"bulletList","attrs":{"id":"83c556f2-d07d-4708-a1dc-e6beb9c9672f","isHoverDragHandle":false},"content":[{"type":"listItem","attrs":{"id":"9ce31e90-cd20-47df-ba91-17f1820148fa"},"content":[{"type":"paragraph","attrs":{"id":"04dc90df-689d-4c5b-9614-3aabcb307cf4","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"安装后没有重新加载 Shell"}]}]},{"type":"listItem","attrs":{"id":"ddb717cc-1370-4f49-bd12-2c35b97e91ef"},"content":[{"type":"paragraph","attrs":{"id":"c345a0f8-a7ad-44b1-949d-b535ed9484ec","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"PATH 没刷新"}]}]},{"type":"listItem","attrs":{"id":"36d97c18-b88d-4711-98e1-7c4cd8f63b9f"},"content":[{"type":"paragraph","attrs":{"id":"fc243a4b-6150-4420-8153-f8c50b92b16b","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"安装过程本身中断了"}]}]}]},{"type":"paragraph","attrs":{"id":"87212cb2-7827-4bc6-a972-19c863a67119","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"优先尝试："}]},{"type":"codeBlock","attrs":{"id":"1734afc8-eae7-4b06-9fea-acfbaed76583","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"source ~/.bashrc\nhermes"}]},{"type":"paragraph","attrs":{"id":"b91b65c6-8f8b-4d84-9579-a67cb6455ad5","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果还是不行，重新执行安装脚本通常比死磕更省时间。"}]},{"type":"heading","attrs":{"id":"8cc9debe-2891-495f-b99c-afca8ef06496","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"2. 能启动 Hermes，但回复异常、空白或报认证错误"}]},{"type":"paragraph","attrs":{"id":"fc905e31-1a0b-4a9f-9ea7-fc237a17a9f0","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"这类问题十有八九是 Provider 没配对。"}]},{"type":"paragraph","attrs":{"id":"af62f217-9f88-4968-b127-6bc0a4ff0ec8","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"直接重新执行："}]},{"type":"codeBlock","attrs":{"id":"a1810b29-373f-4e5b-b373-e7fbe8829b1f","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"hermes model"}]},{"type":"paragraph","attrs":{"id":"023425f1-2a52-4f2a-a8fb-7dee3f58c2e6","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"重新确认："}]},{"type":"bulletList","attrs":{"id":"f25ed4ac-3955-47aa-bd68-8a83319dc017","isHoverDragHandle":false},"content":[{"type":"listItem","attrs":{"id":"b439a422-a57e-43c0-ac47-483d32f6cbc3"},"content":[{"type":"paragraph","attrs":{"id":"8283e62a-0a01-4929-9ef6-a845e7d77350","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"Provider 选的是不是你真正可用的那个"}]}]},{"type":"listItem","attrs":{"id":"96faa589-bc9b-4d50-b663-e9d12fd01302"},"content":[{"type":"paragraph","attrs":{"id":"cc71a0ff-eabc-41d0-a8ca-442fd6a80a96","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"API Key 是否填对"}]}]},{"type":"listItem","attrs":{"id":"9baa461f-8a10-42c6-879c-ccc7ca69ac81"},"content":[{"type":"paragraph","attrs":{"id":"e0c073cc-bbb8-4f84-ae23-82e5fb013056","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"模型名称是否有效"}]}]},{"type":"listItem","attrs":{"id":"82745add-022c-464b-9ef9-1940e024281b"},"content":[{"type":"paragraph","attrs":{"id":"c81f8aee-49f6-4d70-84d0-090672844e79","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"自定义端点是否真的兼容 OpenAI API"}]}]}]},{"type":"heading","attrs":{"id":"390fcb03-686a-460e-872f-b2b9d605e0c0","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"3. 自建模型端点“看起来通了”，但回答乱码或行为异常"}]},{"type":"paragraph","attrs":{"id":"639b525f-0077-4d91-8860-b3778321c4b7","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"这是很多本地部署用户会踩的坑。"}]},{"type":"paragraph","attrs":{"id":"da6ce05e-4409-4143-85ef-03d3e75cfb0f","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"常见根因有三个："}]},{"type":"bulletList","attrs":{"id":"d6748032-24e1-4b90-9747-35728a2f8f27","isHoverDragHandle":false},"content":[{"type":"listItem","attrs":{"id":"6a8c9b68-9d29-4357-9b75-dbbd1227cec7"},"content":[{"type":"paragraph","attrs":{"id":"b48d80fe-95f9-4317-8efe-42524137c189","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"Base URL 填错"}]}]},{"type":"listItem","attrs":{"id":"f3bc37bd-5e76-4378-9625-eaa404bb85ac"},"content":[{"type":"paragraph","attrs":{"id":"d5eaa6e5-a772-4a25-af39-982d75cda585","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"模型名填错"}]}]},{"type":"listItem","attrs":{"id":"ce1351e0-f33f-4706-94c4-91fb87a44084"},"content":[{"type":"paragraph","attrs":{"id":"f2387358-457f-4bd1-bc48-4c78e86077f3","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"这个服务根本不是标准 OpenAI 兼容接口"}]}]}]},{"type":"paragraph","attrs":{"id":"28684565-d276-460f-b392-fa05767a5195","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"建议先用其他客户端单独验证接口，再接 Hermes，别把排错难度叠加。"}]},{"type":"heading","attrs":{"id":"a241a57a-b1aa-43e7-9fc9-2a70dfd0350a","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"4. 继续会话失败，找不到历史记录"}]},{"type":"paragraph","attrs":{"id":"ebf4abf9-8a40-4216-8c45-5c5564801562","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"优先检查："}]},{"type":"codeBlock","attrs":{"id":"a030d646-625b-46a6-b8ad-a8b689a8c671","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"hermes sessions list"}]},{"type":"paragraph","attrs":{"id":"27b1027f-113b-45f7-af76-0377cebcf0a3","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"有时不是 Hermes 没存，而是你切了 profile，或者之前的会话根本没正常保存。"}]},{"type":"heading","attrs":{"id":"526edfb7-1f0e-4046-a059-8f2399926a37","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"5. 配置越改越乱，不知道现在哪里有问题"}]},{"type":"paragraph","attrs":{"id":"295f77e3-1439-4945-ba4d-83447967f4d3","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"直接跑官方诊断："}]},{"type":"codeBlock","attrs":{"id":"a2baa7b5-1fb8-449d-8949-1e450a4b2d59","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"hermes doctor"}]},{"type":"paragraph","attrs":{"id":"3a6fa9ee-d6f6-48ce-ac9c-ef35ead3a9f6","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"这是最应该优先学会的命令之一。"}]},{"type":"heading","attrs":{"id":"9a372f4d-9842-44be-b5de-cd7880d2fdf8","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"11. 6 个非常实用的 Hermes 使用技巧"}]},{"type":"heading","attrs":{"id":"41590bb0-7567-4fb5-a69f-26b176eb3ec8","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"技巧 1：优先写清楚任务，而不是只写一句“帮我看下”"}]},{"type":"paragraph","attrs":{"id":"1bd470df-a92d-4462-8afa-6b5cba382fa1","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"Hermes 的能力越强，越吃上下文。你给的信息越具体，它越容易一次做对。"}]},{"type":"paragraph","attrs":{"id":"3343393c-6ebd-4db1-b8c3-abf6a5612c28","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"错误示范："}]},{"type":"codeBlock","attrs":{"id":"76ece522-76c5-46ff-bda8-bb2ada4743a0","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"帮我修一下代码"}]},{"type":"paragraph","attrs":{"id":"ad63935a-5a6d-48b1-8315-b6ec6648d21c","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"更好的写法："}]},{"type":"codeBlock","attrs":{"id":"a2195d5a-4fb5-4159-9ede-35dc253eb653","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"帮我检查 `api/handlers.py` 里 `process_request()` 的 TypeError，报错信息如下……"}]},{"type":"heading","attrs":{"id":"589b7f05-87d3-4b86-ac68-a54da33bb1c6","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"技巧 2：多行输入很好用"}]},{"type":"paragraph","attrs":{"id":"c8ce130d-e7e9-48b2-b71b-1decaf176c64","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"在 CLI 里可以用 "},{"type":"text","marks":[{"type":"code"}],"text":"Alt+Enter"},{"type":"text","text":" 或 "},{"type":"text","marks":[{"type":"code"}],"text":"Ctrl+J"},{"type":"text","text":" 插入换行。写长提示词、粘贴报错堆栈、贴代码块时非常舒服。"}]},{"type":"heading","attrs":{"id":"9e650c49-b024-4ae1-81e9-650f149bae05","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"技巧 3：学会中断，而不是傻等"}]},{"type":"paragraph","attrs":{"id":"4d87aea7-382e-4fa6-bb6d-121b88c5957a","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果你发现 Hermes 跑偏了，别等它输出完。你可以直接输入新消息并回车打断当前任务，或者使用 "},{"type":"text","marks":[{"type":"code"}],"text":"Ctrl+C"},{"type":"text","text":"。"}]},{"type":"paragraph","attrs":{"id":"225bcf03-7d81-4a90-9d16-6dd19a083f94","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"这会极大提升交互效率。"}]},{"type":"heading","attrs":{"id":"9e542176-df5e-4059-beee-ad694c40d495","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"技巧 4：熟悉几个高频命令"}]},{"type":"paragraph","attrs":{"id":"6768f2b8-44f4-4586-8b39-5955bf98587f","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"先记住这几个就够用了："}]},{"type":"codeBlock","attrs":{"id":"73feb0ad-fe69-487b-8bcf-1eba7f216fd2","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"hermes\nhermes --tui\nhermes model\nhermes setup\nhermes doctor\nhermes update\nhermes -c"}]},{"type":"paragraph","attrs":{"id":"749ed911-1256-4b10-994a-ef29bf12f2a7","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"你不需要第一天就把全部命令背下来，但这几个几乎是日常高频。"}]},{"type":"heading","attrs":{"id":"af221c4d-e4a1-4f78-92b2-baac9435c971","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"技巧 5：基础可用后，再去玩技能和 Gateway"}]},{"type":"paragraph","attrs":{"id":"9aff6328-51f8-46bf-a942-f753aef35129","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"Hermes 后续可以接 Telegram、Discord、Slack 等平台，也支持技能系统和更多自动化能力。"}]},{"type":"paragraph","attrs":{"id":"1b017d41-6b57-431f-aeca-bcfda4362a95","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"但正确节奏一定是："}]},{"type":"paragraph","attrs":{"id":"eb734c53-0ecd-481e-be49-3714c6e66266","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","marks":[{"type":"code"}],"text":"先装好 -> 先配模型 -> 先跑通聊天 -> 再叠高级功能"}]},{"type":"paragraph","attrs":{"id":"bd0792fd-b1a0-46ea-ba07-dd8a0da27621","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"这个顺序看似保守，实际上最省时间。"}]},{"type":"heading","attrs":{"id":"a688b244-4dfb-403a-b943-ef7fa2194144","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"技巧 6：及时更新，但更新后要做验证"}]},{"type":"paragraph","attrs":{"id":"1fbdf915-b215-45da-8e9f-8ebcd7a9f412","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"更新命令很简单："}]},{"type":"codeBlock","attrs":{"id":"71c347e2-ce8d-4d45-a704-9f74dee9416d","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"hermes update"}]},{"type":"paragraph","attrs":{"id":"bcef4b0a-00cc-4167-b019-5323b656c494","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"更新后建议顺手做这几步："}]},{"type":"codeBlock","attrs":{"id":"51522bea-ee3d-4bde-9d83-401f2d28025d","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"hermes doctor\nhermes version"}]},{"type":"paragraph","attrs":{"id":"f8df284b-11ff-4ce6-857c-1562cc3fbd27","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果你用到了 Gateway，再检查一下："}]},{"type":"codeBlock","attrs":{"id":"ecbd4730-9beb-4b19-b326-add4ec743912","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"hermes gateway status"}]},{"type":"heading","attrs":{"id":"3160ef9a-c633-4622-8464-9141d155e6dc","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"12. 进阶建议：新手最值得优先掌握的能力"}]},{"type":"paragraph","attrs":{"id":"73aa8283-d43f-4405-a180-932ff3f8976c","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果你已经跑通基础使用，我建议你按下面顺序继续："}]},{"type":"orderedList","attrs":{"id":"4ac9c6ae-bc79-466f-b0a2-623630a91caa","start":1,"isHoverDragHandle":false},"content":[{"type":"listItem","attrs":{"id":"429b40ec-7480-48ea-ba49-5b0cd299a079"},"content":[{"type":"paragraph","attrs":{"id":"a8f1ec43-1d2b-4037-80ae-63b1cc359291","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"先熟悉 "},{"type":"text","marks":[{"type":"code"}],"text":"hermes --tui"}]}]},{"type":"listItem","attrs":{"id":"e05b23fb-f62c-4ef3-8a17-a46ef2a6855d"},"content":[{"type":"paragraph","attrs":{"id":"3db226a9-67c4-46a2-a3b0-d43462eb17f5","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"学会 "},{"type":"text","marks":[{"type":"code"}],"text":"hermes model"},{"type":"text","text":" 和 "},{"type":"text","marks":[{"type":"code"}],"text":"hermes doctor"}]}]},{"type":"listItem","attrs":{"id":"2353c26f-4638-4c3f-ab30-47075a9e0a45"},"content":[{"type":"paragraph","attrs":{"id":"4138496e-3d90-4c3c-b4c1-7b2e9cf77656","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"学会恢复会话："},{"type":"text","marks":[{"type":"code"}],"text":"hermes -c"}]}]},{"type":"listItem","attrs":{"id":"f7028c5a-8beb-4d8a-87dc-ce2b0b7374eb"},"content":[{"type":"paragraph","attrs":{"id":"655c63ff-e724-44f2-b621-3fde66bbeb7b","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"再尝试 "},{"type":"text","marks":[{"type":"code"}],"text":"/help"},{"type":"text","text":"、"},{"type":"text","marks":[{"type":"code"}],"text":"/tools"},{"type":"text","text":"、"},{"type":"text","marks":[{"type":"code"}],"text":"/skills"}]}]},{"type":"listItem","attrs":{"id":"8aaf2760-16ab-4d22-8d53-980a5e898720"},"content":[{"type":"paragraph","attrs":{"id":"2b7a7ce7-8d55-4913-9e18-d9ef3aae2293","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"最后再接入消息平台或自动化"}]}]}]},{"type":"paragraph","attrs":{"id":"8b45ecb5-993c-455b-b475-cb3b8872e03e","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"这样你会比一上来就“全都想要”的用户顺利很多。"}]},{"type":"heading","attrs":{"id":"930eed90-ccb9-4e64-b41f-636cb08f643d","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"13. 一句话总结"}]},{"type":"paragraph","attrs":{"id":"8aa702f9-71a7-43a6-9155-e2ab7a7c5da8","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"在 Windows 11 上安装 Hermes，"},{"type":"text","marks":[{"type":"bold"}],"text":"最正确也最稳的方式就是走 WSL2"},{"type":"text","text":"。不要试图硬上原生 Windows 环境。装好 WSL2 后，用官方安装脚本完成部署，再通过 "},{"type":"text","marks":[{"type":"code"}],"text":"hermes model"},{"type":"text","text":" 配好 Provider，用 "},{"type":"text","marks":[{"type":"code"}],"text":"hermes --tui"},{"type":"text","text":" 或 "},{"type":"text","marks":[{"type":"code"}],"text":"hermes"},{"type":"text","text":" 跑通第一轮对话，基本就算正式入门了。"}]},{"type":"paragraph","attrs":{"id":"5f2fff91-f96d-490b-bd71-7ba7ad3b088e","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果你想少走弯路，请记住一句话："}]},{"type":"paragraph","attrs":{"id":"d7bc4d63-da7c-4e7d-bd6f-3d42c9f0e6fc","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"先让 Hermes 正常完成一次真实对话，再考虑技能、Gateway、自动化和更复杂的玩法。"}]},{"type":"heading","attrs":{"id":"fc30180d-b50c-4811-8afc-c6f74665b9e0","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"附：建议收藏的命令清单"}]},{"type":"codeBlock","attrs":{"id":"3b0e87df-e892-4e9b-9fb1-722db0260b00","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"# 启动\nhermes\nhermes --tui\n\n# 配置模型\nhermes model\n\n# 一键配置\nhermes setup\n\n# 诊断问题\nhermes doctor\n\n# 恢复会话\nhermes -c\n\n# 查看会话\nhermes sessions list\n\n# 更新\nhermes update\n\n# 检查网关\nhermes gateway status"}]},{"type":"paragraph","attrs":{"id":"64895c6c-f23d-4c24-8f20-53db2385d8a4","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false}},{"type":"paragraph","attrs":{"id":"23206e71-3875-4819-905b-ab6715377da3","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false}}]}