by Eynzof
Hermes Agent CN desktop app, Windows-First, built with Tauri, Typescript and Rust. Isolated Hermes Agent core insides.
# Add to your Claude Code skills
git clone https://github.com/Eynzof/hermes-agent-cn-desktopGuides for using ai agents skills like hermes-agent-cn-desktop.
No comments yet. Be the first to share your thoughts!
简体中文 · English
Hermes Agent CN Desktop 是 Hermes Agent 中文社区推出的桌面客户端,原生支持Windows与MacOS系统。项目基于 Tauri v2、Rust、React 和 TypeScript 构建,包含 hermes-agent-cn 中文社区修改版的 Hermes Agent 内核。
当前版本是
v0.1.0-alpha.2。项目仍处于 alpha 阶段,API、打包流程、运行时分发策略和界面细节都可能在稳定版发布前继续调整。
可以在 hermes-cn-ui-prototypes-sans.vercel.app 浏览高保真 UI 原型图。
点击下方预览图,或直接打开 MP4 演示视频。README 渲染器对本地视频内嵌播放支持不稳定,因此这里用可点击预览图链接到视频文件。
下面的截图展示了工作台、明暗主题、配置、内置 Skills、模型服务商配置、记忆管理、运行时诊断、日志、对话历史、聊天回复和项目 Review 工作流。
| 工作台(浅色主题) | 工作台(深色主题) | | --- | --- | | | |
| 配置总览 | 内置 Skills | | --- | --- | | | |
| 模型服务商配置 | 记忆管理 | | --- | --- | | | |
| 运行时诊断 | 日志查看 | | --- | --- | | | |
| 对话历史 | 聊天回复 | | --- | --- | | | |
| 项目 Review 工作流 | | --- | | |
Hermes Agent 已经提供本地 Dashboard。本仓库专注于 Dashboard 之外的桌面体验:原生窗口、本地进程管理、文件对话框、托管运行时安装、运行时诊断,以及生产模式下更安全的 REST 和 SSE 代理层。
本仓库是桌面端外壳。Agent runtime 和 Dashboard 源码位于 hermes-agent-cn。
预发布安装包会发布在 GitHub Releases 页面。
当前 alpha 版本包含:
Hermes.Agent.CN.Desktop_0.1.0_aarch64.dmgHermes.Agent.CN.Desktop_0.1.0_x64-setup.exe当前 Windows 与 macOS 安装包都会预置 hermes-agent-cn runtime,安装后优先从包内 runtime 完成本地内核初始化;托管 runtime 下载与更新流程只作为升级或兜底路径使用。
macOS 还需要安装 Xcode Command Line Tools:
xcode-select --install
安装依赖:
pnpm install
另开一个终端启动 Hermes Dashboard:
hermes dashboard --host 127.0.0.1 --port 9120 --no-open
启动桌面端开发模式:
pnpm web:dev
cargo run
也可以让 Tauri dev 命令自动启动 Vite:
pnpm tauri:dev
# 为当前平台构建生产包
pnpm tauri:build
# 构建带调试信息的 Debug 包
pnpm tauri:build:debug
构建产物位于 target/release/bundle/ 或 target/debug/bundle/。
├── src/ Rust 后端:Tauri commands、进程管理、runtime 管理
├── web/ React 前端:Vite、TanStack Query、Jotai
├── packages/
│ ├── protocol/ Zod schema、API 契约、IPC 类型
│ └── shared-ui/ 设计 token 和共享 UI 组件
├── static/ 打包时注入的 Dashboard、runtime、内置 skills
├── scripts/ 本地开发、runtime staging、release staging 脚本
├── .github/workflows/ CI 和桌面端发布流水线
├── Cargo.toml Rust crate 配置
├── tauri.conf.json Tauri 窗口、安全和打包配置
└── package.json pnpm workspace root
| 命令 | 说明 |
| --- | --- |
| pnpm web:dev | 启动 Vite dev server,默认端口 9545 |
| cargo run | 编译并启动 Tauri 桌面窗口 |
| pnpm typecheck | 运行 TypeScript 类型检查 |
| pnpm test:unit | 运行 Vitest 单元测试 |
| cargo check | 运行 Rust 编译检查 |
| cargo test --all-features | 运行 Rust 测试 |
| pnpm tauri:build | 构建生产桌面包 |
提交 Pull Request 前,建议运行相关检查:
pnpm typecheck
pnpm test:unit
cargo fmt --all -- --check
cargo clippy --all-targets -- -D warnings
cargo test --all-features --no-fail-fast
CI 会在 main 和指向 main 的 Pull Request 上分别运行前端和 Rust 测试流水线。
版本使用 SemVer tag:
v0.1.0-alpha.1
v0.1.0-beta.1
v0.1.0
v0.1.1
推送 v* tag 后会触发 .github/workflows/release-desktop.yml,自动构建并上传桌面端安装包到 GitHub Releases。Alpha、beta 和 release candidate tag 会被标记为 GitHub 预发布。
近期重点包括:
欢迎提交 Issue 和 Pull Request。参与贡献前请阅读 CONTRIBUTING.md。
如果要报告安全问题,请遵循 SECURITY.md,不要直接创建公开 Issue。
本项目使用 MIT License。