【免费下载链接】hope-agent A cross-device desktop AI agent with memory, autonomous goals, dynamic workflows, and headless deployment | 会记忆、能持续推进目标、会动态编排多 Agent 的跨端桌面 AI 助手也可服务化常驻 NAS / 云端项目地址https://gitcode.com/gh_mirrors/ho/hope-agent点击查看免费下载Hope Agent 是一款基于Rust Tauri 2 React 19的跨端桌面 AI 助手内置记忆、自主目标推进与多 Agent 动态编排能力也可服务化常驻 NAS / 云端。本教程面向新手带你在 6 个步骤内完成仓库克隆、项目跑通、分层架构理解并贡献你的第一个 PR——即使前端和 Rust 经验不深也能照做。一、项目速览Hope Agent 技术栈与目录结构Hope Agent 同一个二进制支持三种运行模式桌面 GUITauri、HTTP/WS 守护进程、ACP stdio供 IDE 直连。完整技术选型如下层技术说明前端 UIReact 19 TypeScriptVite 8、Tailwind CSS v4、shadcn/uiRadix UI桌面壳Tauri 2薄壳只做窗口 / 菜单 / 系统集成后端核心Rust workspaceha-core 18 个特征 crate零 Tauri 依赖数据存储SQLiteWALFTS5 全文检索 vec0 向量扩展多语言i18next支持 12 种语言目录职责清晰新手建议按这个顺序阅读src/React 19 前端路径别名/指向src/crates/全部 Rust crate业务逻辑所在src-tauri/Tauri 桌面薄壳docs/architecture/子系统架构文档改代码前必读skills/内置 Agent 技能最适合新手贡献核心设计原则只有一条所有业务逻辑都在与界面无关的后端 crate 里前端和 Tauri / HTTP 服务都只是薄壳——同一套能力被桌面、服务器、CLI 三种入口复用。完整分层图见官方文档系统架构总览。二、环境搭建3 步跑通 Hope Agent 项目1. 前置工具链Node.js pnpm前端与 Tauri CLI 依赖Rust 工具链由 rust-toolchain.toml 锁定在1.95.0首次构建时 rustup 会自动安装对应工具链2. 克隆仓库并安装依赖git clone https://gitcode.com/gh_mirrors/ho/hope-agent cd hope-agent pnpm install # 安装前端依赖 Husky pre-push 钩子3. 一键启动桌面开发模式pnpm dev:desktop # 前端 Rust 后端 热重载启动后即可看到完整功能界面左侧管理会话 / 项目 / 定时任务右侧实时展示记忆、上下文用量与会话状态 浏览器或评测联调请选pnpm desktop只查某个 Rust 包可用cargo check -p crate --locked。全部命令速查见 AGENTS.md「开发与验证」。三、读懂核心架构请求如何从 React 19 流进 Rust一次请求的处理路径是理解工程分层的关键前端React 19Chat、Dashboard、知识空间等 UI 组件Transport 抽象层Tauri IPC 或 HTTP/WS 双模式自动切换薄壳层src-tauri/桌面或 crates/ha-server/HTTP 服务后端 crate特征 crate →ha-core内核→ha-config-schema→ha-base后端四层分工如下层Crate职责基础原语ha-base路径、日志、平台、安全、权限配置类型ha-config-schemaAppConfig wire 类型零行为逻辑业务内核ha-core对话引擎、Agent、工具、记忆、会话特征 crate18 个ha-cron / ha-channel / ha-knowledge …每个子系统一个可独立迁出知识空间就是一个典型的「特征 crate 前端联动」子系统修改代码前记住三条硬规则详见核心架构边界核心业务逻辑必须进crates/ha-core/或特征 crate零 Tauri 依赖src-tauri/与crates/ha-server/只做适配薄壳不写业务逻辑禁止console.log/log::info!等原生日志统一使用app_info!系列宏四、新手第一个贡献4 个低门槛方向项目 CONTRIBUTING.md 推荐了明确的贡献入口按门槛从低到高排列1. 改文档 / 修 typo最简单直接开 PR 即可无需先开 issue。2. 翻译贡献12 种语言翻译文件在 src/i18n/locales/zh与en是真相源。用脚本一键检查缺失项node scripts/sync-i18n.mjs --check # 检查缺失翻译3. 加一个新 Skillskills/ 下每个目录就是一个技能SKILL.md 可选脚本。参考 ha-skill-creator 技能说明 即可照着创作是理解「Agent 如何被技能扩展」的最佳路径。4. 接入新 LLM Provider 或 IM ChannelProvider接入点 crates/ha-core/src/provider/复用现有 4 种协议的多数情况只加配置无需写 RustChannel参考 crates/ha-channel/src/channel/ 里 12 个现成实现webhook 型最简单设计空间是前端 / 后端边界研究的好去处适合想在跑通项目后深挖 Tauri 命令与特征 crate 联动的贡献者五、提交前自检让你的 PR 顺利过 CI1. pre-push 六道自动门禁强制git push之前.husky/pre-push 钩子会自动跑 6 条检查清单见 CONTRIBUTING.mdcargo fmt --all --check # 格式检查 cargo clippy ... -D warnings # 静态检查警告即错误 cargo test ... # Rust 单测 pnpm typecheck # TS 类型检查 pnpm lint # ESLint pnpm test # Vitest⚠️不要用--no-verify绕过——CI 会再跑一遍同样检查并阻塞 PR。2. Commit message 规范type(scope): 一句话描述typefeat/fix/docs/ci/chore/refactor/perf/testscope子系统名chat/provider/channel/skill/plan…✅feat(provider): 升级内置模型模板的 provider/model 列表❌update code/fix bug每个 commit 用git commit -s加 DCO 签名原创性声明3. 两个容易漏的同步义务用户可见改动必须写进 CHANGELOG.md 的Unreleased段子系统架构变化必须在同一 PR 内同步docs/architecture/name.md4. Squash mergePR 以 squash 方式合入 main 保持线性所以单个 PR 只聚焦一件事大改动请拆成多个 PR。六、常用开发命令速查表场景命令安装依赖pnpm install --frozen-lockfile桌面开发pnpm dev:desktop前端类型检查pnpm typecheckRust 定向检查cargo check -p crate --lockedRust 全量检查cargo check --workspace --locked翻译完整性node scripts/sync-i18n.mjs --checkcrate 依赖分析pnpm analyze:crate-deps 学习资源清单CONTRIBUTING.md —— 贡献流程完整说明报 Bug / 提 PR / 翻译 / 插件式贡献AGENTS.md —— 全局约束与任务入口改跨 crate 契约前必读docs/architecture/overview.md —— 系统架构总览docs/architecture/ —— 按子系统拆分的架构设计文档docs/user-guide/ —— 用户手册中英双语至此Hope Agent 的贡献路径已经打通克隆仓库 → 跑通项目 → 读懂分层 → 从文档 / 翻译 / 技能入手 → 通过六道门禁 → 提交 squash PR。祝你在源码中玩得开心赞分享【免费下载链接】hope-agent A cross-device desktop AI agent with memory, autonomous goals, dynamic workflows, and headless deployment | 会记忆、能持续推进目标、会动态编排多 Agent 的跨端桌面 AI 助手也可服务化常驻 NAS / 云端项目地址https://gitcode.com/gh_mirrors/ho/hope-agent点击查看免费下载相关推荐无需 Docker 环境也能拉取镜像5 分钟上手 docker-pull-tar 离线打包多架构 tar 包无需 Docker 环境也能拉取镜像5 分钟上手 docker pull tar 离线打包多架构 tar 包 隔离机房上线前夜运维同事发现目标服务器既不通外开发工具容器OpenRGB 完整上手攻略用一款开源软件统一控制 150 品牌 RGB 灯光OpenRGB 完整上手攻略用一款开源软件统一控制 150 品牌 RGB 灯光 OpenRGB 是一款开源、跨平台的 RGB 灯光控制软件它不依赖任何硬件桌面应用硬件开发智能硬件React-Toastify源码贡献指南如何为开源项目提交PRReact Toastify源码贡献指南如何为开源项目提交PR 你是否曾想为开源项目贡献力量但不知道从何入手本文将带你一步步完成React ToastifUI组件创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考