Hope Agent
跨端延续任务与记忆的本地优先桌面助手。
- Star 数
- ★ 1.6k
- 最近更新
- 4 天前
- License
- MIT
- 主语言
- Rust
- FA 评分
- 40/100 · 缺口较多
30 秒速览
- 可在哪里用
- 通用 · 跨平台Codex · OpenAI API · Claude API
- 开始前需要
- 典型场景
- 需要在 Mac 桌面持续跟进多步骤研究或工作事项的个人用户，可用 Goal、Workflow、Loop 和后台 Task 管理并恢复执行。
- 主要局限
- 完整桌面体验明确以 macOS 为主；Linux 和 Windows 被标注为实验性支持，Windows 仅提供 x64。
- 源码审查
- 40/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Hope Agent 是一个以本地桌面为主要入口的个人 AI 助手，也可作为带 Web GUI 的常驻服务运行。它以 Rust 核心、Tauri 2 桌面壳和 React 19 前端构成，并提供 Desktop、Server + Web GUI 与 ACP 三种运行模式。它把项目、会话、记忆、目标、工作流与后台任务组织在同一系统中，状态默认保存于 ~/.hope-agent/。除了对话，它还能在审批条件下操作文件、运行 bash、调用 MCP、控制浏览器及 macOS，并通过子 Agent 协作推进工作。它还包含基于真实 Markdown 的知识空间，以及可生成和导出多种设计产物的设计空间。
用户先在 Onboarding 中选择 Provider 模板，填写 API Key 或使用 Codex OAuth 登录。对话可归入 Project；系统将全局、项目和 Agent 记忆分层保存，并通过全文和向量检索按需召回。用户可定义 Goal 及完成标准，Workflow 记录一次执行中的阶段、条件、并行、工具、Diff、Review 和验证，Loop 则按间隔、条件或事件再次触发推进；Task 展示实时进度。经统一审批后，它可运行 bash、读写文件、调用 MCP（含 OAuth 2.1 transport）、连接工作空间，并在 macOS 上操作桌面或通过可控浏览器执行页面操作。设计空间可生成网页、移动原型、演示文稿等产物并导出 HTML、PNG、PDF、PPTX、MP4 或 ZIP；知识空间读写 Markdown、支持检索、双链、图谱和 Obsidian 库绑定。
- 需要在 Mac 桌面持续跟进多步骤研究或工作事项的个人用户，可用 Goal、Workflow、Loop 和后台 Task 管理并恢复执行。
- 在 NAS、家用服务器或 VPS 上部署个人助手的用户，可运行 hope-agent server，通过浏览器访问 Web GUI，并让 IM 渠道和定时任务保持在线。
- 维护 Markdown 笔记或已有 Obsidian 库的知识工作者，可用知识空间归档资料、检索内容并审阅 AI 整理建议。
- 需要从文字或参考图产出网页、移动原型、演示文稿或海报的产品与设计人员，可在设计空间预览、微调、管理版本并导出交付物。
- 需要把 API、命令、文件和 MCP 服务组合到同一工作流的高级用户，可在审批下让主对话和动态子 Agent 分工执行。
如何安装或部署这个 Agent？
macOS 可执行：
brew tap shiwenwen/hope-agent
brew install --cask hope-agent自托管可执行：
docker run -d --name hope-agent -p 127.0.0.1:8420:8420 -v hope-data:/data ghcr.io/shiwenwen/hope-agent:latest容器启动后打开 http://127.0.0.1:8420。首次使用需要选择 Provider 模板并填写该 Provider 的 API Key，或使用 Codex OAuth 登录；本地模型路径可在设置中安装并配置 Ollama。
如何使用这个 Agent？
启动桌面应用，或运行 hope-agent server start 后访问 http://127.0.0.1:8420。完成 Provider 设置后直接创建对话；需要长期推进时，为任务设置 Goal 和完成标准，再让 Workflow 执行并用 Loop 设定再次推进条件。需要 IDE 后端时运行 hope-agent acp。若要从其他设备访问，将服务器监听地址设为 0.0.0.0:8420 并配置 API Key；公网部署应在前面配置 HTTPS 反向代理。
这个 Agent 有哪些优点和局限？
- 同一 ha-core 支撑桌面、无 GUI Server + Web GUI 与 ACP 模式，适合在本机和自托管环境之间延续会话、记忆和任务状态。
- 将 Goal、Workflow、Loop、Task 与可暂停、恢复和保守恢复的持久执行记录组合起来，覆盖一次性聊天之外的长期任务推进。
- 内置 MCP 客户端、bash、文件操作、浏览器控制和 macOS 控制，并为副作用操作提供统一审批及可选 Docker 沙箱。
- 同时提供真实 Markdown 知识空间与可导出 HTML、PNG、PDF、PPTX、MP4、ZIP 的设计空间，覆盖知识维护和多类交付物生成。
- 支持 40+ Provider 模板、300+ 预设模型、Ollama 本地模型与多 API Key 轮换，模型接入不局限于单一供应商。
- 完整桌面体验明确以 macOS 为主；Linux 和 Windows 被标注为实验性支持，Windows 仅提供 x64。
- 使用云模型需要自行提供 Provider API Key 或 Codex OAuth；使用本地模型则需要完成 Ollama 安装和模型下载。
- 文件写入、命令、浏览器和电脑控制具有实际副作用，即使有审批和 Docker 沙箱，仍需用户配置权限并审查操作。
- 远程访问需要调整监听地址并设置 API Key；公网部署还需要自行配置 HTTPS 反向代理。
- 状态默认位于 ~/.hope-agent/；材料说明了 Obsidian 绑定，但未说明通用的数据迁移或导入导出流程。
这个 Agent 与同类方案有什么区别？
与直接使用 Ollama 相比，Hope Agent 将 Ollama 作为本地运行时和 OpenAI 兼容端点的 GUI 配置路径；Qwen、Gemma 等模型仍由 Ollama 模型库分发。
与相关度最高的同类 agent 并排比较关键指标。
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示有工具审批流程、Docker沙箱、配置回滚、SSRF防护、日志脱敏等安全机制，但具体实现细节未在提供的文件中充分展示，且未验证实际执行效果，故各标准仅给1分。
自一致性：README、Cargo.toml、package.json等文件中的版本号、许可证、仓库地址等信息一致，但未提供完整的测试结果或运行证据，故给2分。依赖可用性：依赖列表完整，但未验证所有依赖的可获取性，给1分。失败消息：有错误处理描述，但未提供具体失败消息示例，给1分。
受众与场景：README详细描述了多种使用场景（桌面、服务器、Docker等），给2分。能力边界：有安全边界描述（如工具审批、沙箱），但未明确所有能力的限制，给1分。触发精度：有触发机制描述（如Loop、定时），但未提供精确的触发条件，给1分。环境适配：支持多平台（macOS、Linux、Windows）和多种运行模式，给2分。
信息架构：README结构清晰，有目录和详细说明，给2分。安装说明：提供了多种安装方式（Homebrew、Scoop、AUR、apt等），给2分。命名稳定性：版本号在package.json和Cargo.toml中一致，但未提供命名规范文档，给1分。示例与FAQ：有示例命令，但无FAQ，给1分。已知限制：README提到Windows实验性，但未全面列出限制，给1分。许可证：MIT许可证文件存在，给2分。版本与变更日志：有CHANGELOG.md引用，但未提供内容，给1分。维护责任：有SECURITY.md和贡献指南，但未明确维护者责任，给1分。
输出可用性：有导出功能（HTML、PNG等），但未验证实际输出质量，给1分。边际价值：功能丰富，但未与其他产品对比，给1分。成本效益：有成本追踪功能，但未提供具体成本数据，给1分。
声明可追溯性：README中的功能声明未提供具体实现链接，给1分。跨来源佐证：有CI状态徽章，但未提供独立验证，给1分。事实与推断分离：README区分了功能描述和设计意图，但未明确标注哪些是推断，给1分。
- 未验证实际运行效果，所有评分基于静态文件分析。
- 安全机制（如审批、沙箱）的具体实现细节未在提供的文件中充分展示，需进一步审查代码。
- 依赖安全性未验证，需检查依赖漏洞。
- Windows支持标记为实验性，可能存在不稳定。