企业官网建设流程全解析

还在用 AI 聊天工具"聊完就忘"？试试Hope Agent——一款会记忆、能持续推进目标的跨端桌面 AI 助手。它的知识空间功能，就是为你打造的"第二大脑"：笔记全部是真实的 Markdown 文件，AI 能和你一起读、写、整理笔记，还能直接绑定你现有的 Obsidian 库，双向链接实时同步。本教程带你从安装到进阶，5 步搭建真正属于自己、永不锁定的 AI 知识库。

为什么你的笔记需要一个 AI 写手 🤖

传统笔记工具（Obsidian / Logseq）里，AI 是事后装上的插件；Hope Agent 反其道而行——AI 是知识库的第一公民。官方定义的三条核心原则：

💡 知识空间与"记忆系统"不同：记忆是一句话事实、后台自动沉淀；知识空间是整篇文档、你主导、可见度最高。两者的区别详解见 04-记忆系统.md。

第一步：安装 Hope Agent 的 3 种方式

知识空间是 Hope Agent 的一级功能，装好应用即可使用。各平台安装命令（完整说明见 01-快速上手.md）：

# macOS（推荐 Homebrew） brew tap shiwenwen/hope-agent brew install --cask hope-agent

• Windows：scoop install hope-agent或下载.exe安装包
• Linux：提供 apt / dnf / AUR / AppImage 等原生构建

首次启动会进入引导向导：选模型服务商 → 填 API Key → 开聊，全程约 2 分钟。所有数据都保存在本机~/.hope-agent/目录，隐私安全。

第二步：创建你的第一个知识空间

点击左侧导航栏的「知识空间」图标，再点「+ New space」即可新建。本质上就是新建一个装.md笔记的文件夹，首次安装时系统已自动为你建好一个内部空间和一篇欢迎笔记。

界面上从左到右是三个区域：空间与笔记列表、CodeMirror 编辑器（源码 / 预览 / 分屏 / 实时 / 大纲 5 种模式）、AI Agent 对话面板。桌面版还支持右键侧边栏图标「在独立窗口打开」，写长文时视野更专注。

向量、图谱等索引都只是"可重建缓存"——删掉也能从.md文件全量重建，你的内容永远安全。

第三步：一键绑定你的 Obsidian 库（零锁定）✨

这是 Hope Agent 知识空间最大的杀手锏：直接"点亮"你现成的 Obsidian / Logseq 笔记库，把它作为一个知识空间使用。

操作方法：

1. 在知识空间入口选择绑定外部目录，指向你的 Obsidian vault
2. 外部对文件的改动会实时同步进来（绑定和启动时还会全量对账）
3. 在 Obsidian 里写的笔记，AI 立刻就能检索和引用

⚠️ 安全默认值：外部库默认彻底只读——AI 和界面都不能写。需要编辑时，去空间设置里手动开启「允许写入外部库」。这个设计非常克制：

• 后台自主整理永远不会写外部库，无论开关状态
• 所有写入都是原子写盘 + 冲突保护
• Obsidian 那边改了文件，界面会弹「外部修改冲突」提示，让你选择重新加载或保留自己的改动

简单说：两个工具共用一个文件夹，谁都不会弄丢对方的改动。

第四步：和 AI 一起读写笔记的 5 种姿势

AI 内置了完整的note_*工具族（源码见 note.rs），在对话里用自然语言指挥它即可：

几个实用小技巧：

• 在消息里写[[笔记名]]，可以把该笔记内容注入对话，让 AI 基于它展开（内容作为不可信外部数据，不会被当成指令执行）
• 知识空间右栏的AI 对话面板可以就当前笔记做跨笔记检索和改写，答案还能"沉淀成笔记"，审核 diff 后才写盘
• 选中一段文字可以「加入对话」让 AI 改写，或用浮动的「快捷改写」条一次性改写
• 移动或改名笔记时，指向它的双链会自动改写，不会断链

第五步：开启语义检索、图谱与自动整理 🚀

配置 Embedding 模型，实现"按意思找笔记"

默认检索是关键词全文匹配。想"按语义找"（比如搜"心情低落"能找到讲"情绪低落"的笔记），去设置 → 记忆 / Embedding 模型配一个向量模型即可：

• 支持本地 Ollama 一键下载推荐向量模型，完全离线
• 知识空间独立选用自己的 Embedding 模型，与记忆系统物理隔离
• 不配置也完全可用，自动降级为关键词检索

配好之后，笔记会以chunk 级粒度入库（按标题分段 + 大小封顶），命中精确到段落和#heading锚点。

双链图谱与自主整理

• 图谱视图：可视化所有[[双链]]的关系网，可以拖拽固定布局并保存
• 相关笔记提示（默认开启）：每轮对话后台自动找出与当前话题相关的笔记标题附给 AI，不调用模型、非常省
• AI 自主整理（默认关闭，高风险）：后台自动建链、救援孤岛笔记、去重合并、补标签，产出「整理提案」等你逐条审核

相关笔记提示与自主整理的完整参数见 05-知识空间.md。

访问控制：你的笔记，AI 说了不算 🔐

知识空间的访问模型值得单独拎出来说，因为它是"第二大脑"敢放心用的前提：

• 默认拒绝 + 显式挂载：想让某次对话用上某个知识空间，需要在输入框的知识选择器里显式挂载（可选只读 / 读写），没挂载时 AI 根本看不到笔记工具
• 外部库写入需要两步授权：先开「允许写入外部库」开关，再显式选「读写」权限
• 无痕会话零访问：完全无法碰任何知识空间
• IM 渠道默认零访问：需要按账号显式开启

所有 agent 侧读写都经过唯一裁决点，这套机制的完整设计见 knowledge-base.md。

进阶：让外部 Agent 也能"读"你的知识库

如果你的 Claude Code、Cursor 等工具也想要这份长期记忆，Hope Agent 提供稳定的 MCP / HTTP 门面，默认只读：搜索、读取、展开上下文、查原始资料源。接入配置见 knowledge-agent-access.md。

常见问题 FAQ

Q1：笔记会被锁在 Hope Agent 里吗？不会。真相源就是磁盘上的标准.md，任何工具都能直接打开；SQLite 索引只是可重建的旁路缓存。

Q2：AI 会乱改我的 Obsidian 库吗？外部库默认只读，且后台自主整理永不写外部。即使开了写入，所有落盘前都要你审核 diff。

Q3：不用向量模型能用吗？能。自动降级为关键词全文检索，配了 Embedding 才解锁语义检索。

Q4：知识空间能多窗口吗？桌面版支持独立窗口打开，未保存的笔记在弹出/收回时会先提示「保存 / 放弃 / 取消」。

写在最后

希望这篇教程帮你搭好了 AI 共读写的第二大脑。核心就一句话：你的笔记是文件，AI 是写手，Obsidian 是你永远的逃生门。想深入架构细节，推荐阅读 docs/architecture/core/ 下的完整设计文档；想配置本地模型实现完全离线运行，见 02-模型与Provider.md。