快速开始

方式一：桌面端（推荐）

下载安装包 → 安装 → 启动 → 开始使用

平台	下载
Windows	HippoBuddy Setup
macOS (Intel)	HippoBuddy.dmg
macOS (Apple Silicon)	HippoBuddy-arm64.dmg
Linux (AppImage)	HippoBuddy.AppImage

方式二：源码启动

# 1. 构建前端（Vite 产物直接输出到 src/main/resources/static）
cd frontend && npm install && npm run build && cd ..

# 2. 编译并打包 Java 后端（自动包含上一步的前端静态资源）
mvn package -DskipTests

# 3a. 启动桌面端（Electron）
cd electron && npm install && npm start

# 3b. 或仅启动 Web 端（不带 Electron）
mvn exec:java -Dexec.mainClass="com.example.agent.WebApplication"

配置说明

源码启动时，应用首次运行会自动根据 config.yaml.example 创建 config.yaml，编辑其中的 LLM 配置即可：

llm:
  api_key: ${DEEPSEEK_API_KEY:-your-api-key-here}
  model: deepseek-v4-flash
  base_url: https://api.deepseek.com

支持 DeepSeek / Claude / GPT / Ollama。完整配置见项目中的 config.yaml.example。

项目结构

src/main/java/com/example/agent/
├── WebApplication.java           Web 入口
├── DesktopApplication.java       桌面端入口
├── core/                         DI、事件总线、安全拦截
├── llm/                          LLM 客户端（OpenAI、Claude、Ollama...）
├── tools/                        内置工具集（16 个，MCP 可扩展）
├── execute/                      Agent 对话循环
├── subagent/                     多代理系统
├── mcp/                          MCP 协议集成
├── memory/                       长期记忆
├── context/                      上下文预算与压缩
├── session/                      会话存储与转录
├── web/                          HTTP 处理器与 SSE 流式
│   └── orchestrator/             任务编排（DAG）
├── application/                  会话应用服务
├── service/                      Token 估算、标题生成
├── desktop/                      桌面端工作区上下文
├── console/                      控制台交互
├── progress/                     进度与 diff 预览
├── logging/                      日志与指标采集
├── prompt/                       Prompt 库与管理
├── domain/                       规则、技能、内容截断
└── config/                       配置中心