企业官网建设流程全解析

• 人工智能
• AI Agent
• 桌面应用

Hermes-CN-Desktop 是一款免费的开源AI Agent 桌面客户端，基于 Tauri v2、Rust 和 React + TypeScript 构建，内置独立的 Hermes Agent 内核，原生支持 Windows 与 macOS。它把聊天、MCP 工具、Skills 技能库、长期记忆、定时任务、健康诊断等 Agent 能力集成到一个原生窗口里，安装后配置 API Key 即可对话，使用门槛极低。本文是一份面向新手和普通用户的完全指南，带你 3 步完成上手，并顺带了解开发者如何从源码构建它。

一、Hermes-CN-Desktop 是什么？为什么值得装？

简单说：它是一个"能干活"的 AI Agent，而不只是一个聊天框。相比网页版或命令行，桌面客户端的优势在于：

• 🪟原生体验：基于 Tauri 使用系统 WebView，安装包小、不捆绑 Chromium，轻量跨平台；
• ⚙️内置独立内核：安装包预置 Hermes-CN-Core runtime，支持安装、更新、签名校验、健康检查和回滚，开箱即用；
• 🧩完整 Agent UI：聊天流式输出、附件、LaTeX/Mermaid 渲染、MCP 工具、Skills、Memory、Profiles、定时任务一应俱全；
• 🇨🇳中文生态友好：覆盖主流国内云端模型服务商，也支持 Ollama、vLLM、LM Studio 等本地部署方案，还能配置飞书、微信消息平台接入。

下面是 Hermes-CN-Desktop 的主界面——左侧是会话列表，中间是新任务工作台，底部是系统健康状态栏：

想先直观感受一下？仓库里有一段完整的演示视频：hermes-agent-cn-desktop-demo.mp4

二、3步上手教程：从下载到第一次对话

第 1 步：下载安装包（支持 Windows / macOS）

从桌面端官网下载对应平台的安装包即可，当前版本为v0.8.0-rc3，包含：

💡 小贴士：Windows 与 macOS 安装包都会预置 Hermes-CN-Core runtime，安装后优先从包内 runtime 完成本地内核初始化，托管 runtime 的下载更新只作为升级或兜底路径，所以不需要你手动装任何 Python 依赖。

第 2 步：配置模型服务商和 API Key

打开「配置 → 模型」页面（/models），左侧是服务商列表，右侧填写 API Key、Base URL 和模型名称，填完点「保存配置」并「设为当前模型」，还可以一键「测试连接」验证。支持云端服务商和 LM Studio、vLLM 等本地部署方案：

第 3 步：发起第一次 AI 对话

回到「工作台」，在输入框描述任务，Enter 发送、Shift+Enter 换行；底部可以选择工作区和模型。回复以流式输出，支持 Markdown、LaTeX 公式与 Mermaid 渲染，底部还能看到耗时、token 消耗等统计信息：

涉及数学公式、代码推导等场景时，LaTeX 也会渲染得整整齐齐：

三、进阶功能：让 AI Agent 越用越顺手

装好之后，建议花几分钟了解这几个高频功能：

🛠 技能库（Skills）：内置 87 个 Skills，覆盖 Apple 备忘录、提醒事项、iMessage 等，可在「配置 → 技能」中启用/禁用，也能在输入框用/选择 Skill：

🧠 记忆管理（Memory）：Agent 会把跨会话的长期记忆与"用户画像"存在当前档案下，在「配置 → 记忆」页可查看、编辑、追加，字符用量也有可视化配额：

🩺 健康检查：遇到连接或模型异常，先去「高级 → 健康检查」看一眼——Dashboard、Hermes Home、默认模型、API Token、Provider 配置等检查项一目了然，还给出建议处理顺序：

⚠️ 高风险操作（YOLO 模式）：「设置 → 常规」底部的「高风险操作」区提供独立开关，开启后 Agent 执行危险命令时不再弹出二次确认。切换后桌面端会自动重启内核生效，详细说明见 docs/yolo-mode.md。

四、开发者快速上手：从源码构建桌面端

如果你想参与贡献或定制，桌面端仓库本身就是前端 + Rust 后端 + 协议层的 workspace（前端在 web/src/，Rust 后端在 src/，API 契约在 packages/protocol/）。

环境要求：Rust stable、Node.js 20+、pnpm 9+，macOS 需另装 Xcode Command Line Tools（xcode-select --install）。

从源码获取仓库：

git clone https://gitcode.com/gh_mirrors/he/Hermes-CN-Desktop cd Hermes-CN-Desktop pnpm install

启动开发模式（另开一个终端先启动 Hermes Dashboard 后端）：

hermes dashboard --host 127.0.0.1 --port 9120 --no-open pnpm web:dev cargo run

也可以直接用pnpm tauri:dev让 Tauri 自动拉起 Vite。常用命令速查表（安装依赖、类型检查、单元/端到端测试、生产构建等）都写在 package.json 的 scripts 里；如果只想在浏览器里调试 UI，可以运行 run.py 同时拉起后端（默认 9120 端口）和前端 dev server（默认 9545 端口），完整选项见 docs/run-py-usage.md。

构建生产包则执行pnpm tauri:build，产物位于target/release/bundle/。

五、项目资料与延伸阅读

• 官方 PRD 与功能清单：docs/desktop-prd/README.md
• YOLO 模式说明：docs/yolo-mode.md
• 网关连接重构方案：docs/gateway-connection-overhaul.md
• macOS 签名与公证：docs/macos-signing-and-notarization.md
• 贡献指南：CONTRIBUTING.md

📌 最后提醒：本项目非商业使用遵循 PolyForm Noncommercial License 1.0.0，商业使用需单独获得授权，详见 LICENSE。

按本文的 3 个步骤操作，你只需下载安装包、填好 API Key、发起第一次对话，就能开始用 Hermes-CN-Desktop 这个开源 AI Agent 桌面客户端处理日常任务了。项目仍在快速迭代，欢迎跟进版本更新或提交 Issue 参与共建！

• 人工智能
• AI Agent
• 桌面应用