Hope Agent
跨端延续任务与记忆的本地优先桌面助手。
这个 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 有哪些优点和局限？
- 同一 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？
macOS 可执行：brew tap shiwenwen/hope-agentbrew 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 与同类方案有什么区别？
与直接使用 Ollama 相比，Hope Agent 将 Ollama 作为本地运行时和 OpenAI 兼容端点的 GUI 配置路径；Qwen、Gemma 等模型仍由 Ollama 模型库分发。