企业官网建设流程全解析

Hope Agent 是一款跨平台桌面 AI 助手：会跨会话记忆、能自主推进目标、可动态编排多 Agent 协作，也可服务化常驻 NAS / 云端。本教程带你 10 分钟完成Hope Agent 安装、首次配置与第一次对话，覆盖 macOS / Windows / Linux 三大平台。

🧭 什么是 Hope Agent？30 秒了解它

和普通聊天机器人不同，Hope Agent 是一个真正能"干活"的桌面 AI Agent：

数据默认全部保存在本机~/.hope-agent/目录，模型请求直连你配置的 Provider，本地优先、不经第三方中转。

🚀 第一步：一键安装 Hope Agent

三大平台都有推荐的包管理器方式，两条命令即可完成安装。

macOS：Homebrew 一键安装（推荐）

brew tap shiwenwen/hope-agent brew install --cask hope-agent

• 偏好手动安装？到官方 Releases 页面下载Hope.Agent_*.dmg，拖入「应用程序」即可（Apple Silicon 与 Intel Mac 均有原生构建）。
• 若首次启动提示"已损坏"或"无法验证开发者"，在终端执行sudo xattr -cr /Applications/Hope\ Agent.app后重新打开即可，这是因为应用采用了 ad-hoc 签名。

Windows：Scoop 安装步骤（实验性）

scoop bucket add hope-agent https://github.com/shiwenwen/scoop-hope-agent scoop install hope-agent

• 或手动下载Hope.Agent_*-setup.exe双击安装（仅提供 x64 版本）。
• 若启动提示缺少MSVCP140_1.dll等运行库文件，安装 Microsoft Visual C++ 2015–2022 运行库（x64）后重启应用即可。

Linux：apt / dnf / AUR 快速安装（实验性）

💡 各平台的完整源码包说明见官方文档：01-快速上手。

⚙️ 第二步：首次启动，3 分钟完成配置向导

双击打开 Hope Agent 后，会进入首次启动引导向导（共 6 步，草稿自动保存，可随时退出续做）：

1. 欢迎页—— 选择界面语言（支持 10+ 种语言）和主题；
2. 模型 Provider（必配）—— 从内置约 50 个模板中选一个服务商（Anthropic、OpenAI、DeepSeek、通义千问等）并填入 API Key；使用 Codex 可走 OAuth 直接登录；
3. 搜索服务（可选）—— 配置网页搜索，可跳过；
4. 用户画像（可选）—— 填昵称、时区、回复偏好，让 AI 更贴合你；
5. 审批与安全—— 决定是否开启工具审批（默认开启：危险操作前弹窗确认）；
6. IM 渠道（可选）—— 可就地绑定 Telegram / 飞书 / Slack，也可之后在设置里配置。

🦙 完全不想用云端模型？第 2 步里内嵌了本地模型一键安装卡片：选一个适合硬件的模型，Hope Agent 自动完成 Ollama 安装、模型下载与切换，全程不需要账号、API Key 或终端。详见 02-模型与Provider。

向导源码位于 src/components/onboarding/steps/，每一步都支持独立保存与回退。

💬 第三步：发起第一次 Hope Agent 对话

点完「完成」，你就来到了主对话界面——左侧是会话列表与项目，中间是聊天区，右侧是工具面板：

30 秒上手对话的 3 个技巧：

• 直接说人话：输入"帮我规划一次 3 天的京都旅行，预算 5000 元"，AI 会自动调用搜索、文件等工具完成任务，每次工具调用都会显示成可展开的工具块；
• /触发斜杠命令：在输入框输入/可唤起命令菜单，如/goal让 AI 自主推进一个长期目标；
• Enter发送、Shift+Enter换行：AI 回复中可随时点方形按钮中断；输入框底部还有一条上下文用量进度条，长对话会自动压缩。

所有日常用法（附件、语音、@提及、会话管理、无痕模式）在 03-对话与会话 中都有详解。

🗺️ 下一步：三个值得一试的专属空间

知识空间：构建你的第二大脑

在侧边栏进入知识空间后，你和 AI 操作的是同一份真实 Markdown 笔记：支持全文与向量检索、双链图谱、原子笔记，还可以直接绑定已有的 Obsidian 库。右侧 AI Agent 面板可基于笔记直接对话，回答会标注引用的来源笔记。

设计空间：从一句话到可交付设计

把一段需求或参考图丢进设计空间，可以生成网页、移动端原型、演示文稿、海报等 10+ 类产物，实时预览、逐元素编辑、支持导出 HTML / PNG / PDF / PPTX，还能直接交付到真实代码仓库。

数据大盘：看清花费与健康度

Dashboard 聚合了会话数、Token 用量、工具调用、错误率、成本趋势与活动热力图，帮你掌控 AI 的"开销"。

❓ 新手常见问题 FAQ

Q1：如何更换模型 / 添加新的 API Key？打开左下角「设置」→ 模型与 Provider，从约 50 个模板中选择并填入 Key 即可，支持为每个 Provider 配置多把 Key 自动轮换。详见 02-模型与Provider。

Q2：如何更新到最新版本？三种方式任选：① 应用内「设置 → 关于」点检查更新；② 直接在对话里说一句"检查更新"，AI 会帮你完成；③ 等应用主动提示。更新会先校验签名、失败自动回滚。

Q3：能从手机或另一台电脑访问吗？可以。在「设置 → 服务器」生成 Owner Token，把监听地址改为0.0.0.0:8420并重启，其他设备浏览器访问http://<设备IP>:8420输入 Token 即可。⚠️ 公网访问请务必加 HTTPS 反向代理，详见 Docker 部署指南。

Q4：没有图形界面 / 想在 NAS 上常驻？执行hope-agent server start（或server install注册为开机自启服务），浏览器打开http://127.0.0.1:8420即得完整网页版；也可用 Docker 镜像部署到 NAS / 云主机，完整方案见 docs/deployment/docker.md。

Q5：想从源码开发 Hope Agent？

git clone https://gitcode.com/gh_mirrors/ho/hope-agent cd hope-agent pnpm install pnpm dev:desktop # 前端 + Rust 热重载

📚 延伸学习资料

• 完整中文使用手册（14 章）：docs/user-guide/README.md
• 安装与运行模式速查：docs/user-guide/01-快速上手.md
• 项目结构与核心能力总览：README.md
• 工具与权限管控：docs/user-guide/07-工具与权限.md

到这里，你的 Hope Agent 已经可以正式上岗了。建议第一周从「日常问答 → 知识空间记笔记 → 一个 /goal 自主任务」逐步深入，它会在记忆中不断成长，越用越懂你。