使用文档

快速开始

完成插件安装、模型配置和首次对话。

本页目录

使用前准备

  • 安装 Obsidian 1.11.4 或更高版本,并打开一个笔记仓库(Vault)。
  • 准备可用的模型服务账号、API Key 和模型名称。API Key 是调用模型服务的凭证。
  • 准备一篇用于测试的笔记。发送 AI 请求时,相关内容会交给所选模型服务。

普通对话和知识库不要求登录 EchoInk 账号。财务、英文日记、PDF 精读等 PRO 功能,需要有效权益及设备授权。模型调用费用由所选服务商另行收取。

第一步:安装插件

  1. 打开 Obsidian「设置 → 第三方插件」。
  2. 浏览社区插件,搜索并安装「EchoInk Agent」。
  3. 点击「启用」。
  4. 点击 Obsidian 左侧羽毛图标,打开工作台和 Agent 侧栏。

完成标志:工作台正常显示,能够进入 Agent 对话。ZIP 与 GitHub 安装方式见插件安装。

工作台:从模块导航进入功能,或创建、继续 Agent 任务。界面示例 · 示例数据
  1. 1选择工作台模块
  2. 2点击新任务
  3. 3中断任务可从这里继续

第二步:配置模型

  1. 打开「设置 → EchoInk Agent → 模型」,添加模型服务。
  2. 选择服务商,填写 API Key;自定义服务还需填写接口地址和协议。
  3. 获取并选择模型,或填写服务商提供的 Model ID。
  4. 点击「测试并保存」。
  5. 在「默认模型」中选择已保存的模型。

字段说明和错误处理见模型配置。

第三步:发送消息

在 Agent 对话输入框中输入以下内容并发送:

请回复“连接成功”。本次不读取或修改文件。

完成标志:对话中显示模型回复,未出现连接或鉴权错误。

第四步:关联笔记

  1. 点击桌面对话输入框旁的「关联笔记」。
  2. 选择准备好的测试笔记,确认消息中已关联正确文件。
  3. 在「权限」中选择只读。
  4. 输入以下要求并发送:
请概括关联笔记的主要内容,并列出原文中尚未说明的问题。只在对话中回答,不修改文件。

完成标志:回答与所选笔记内容一致。若回复没有使用笔记内容,检查文件关联状态与读取权限。

后续配置

配置项对应文档
新建助手、设置职责与能力Agent 创建与配置
资料目录与检索授权知识库配置
模块导航与首次任务引导工作台
登录、会员与设备启用账号与设备管理
连接失败、权限不足等问题常见故障排查

本文配图使用示例数据,界面可能随版本调整。版本变化见更新日志,移动端差异见手机与平板使用。

使用文档

界面截图