认识 Inkflow Echo 并完成第一次设置

Echo 是什么

Inkflow Echo 是一个在 Mac 本地运行的 AI 工作助手。你可以把自己的资料放在一个 Workspace（知识库）里，再让 Echo 根据你的要求阅读资料、整理内容、修改文件或生成新的结果。资料默认留在你选择的本地文件夹；只有当前任务明确使用的内容，才可能发送给你配置的模型服务商或外部连接。

InkFlow Pro 和 Echo 是两个配合使用的部分：Pro 提供账号、会员和线上授权，Echo 负责本地工作界面和任务执行。会员状态决定 Inkflow 的在线权益，但不会自动包含第三方模型的 API 费用，也不会自动授予微信、飞书、小红书或抖音的访问权限。

安装前先确认

当前版本支持 macOS Apple Silicon（M 系列）和 Intel（英特尔）两种 Mac 芯片。请从你确认过的官方来源取得 DMG，并核对版本和芯片架构。不要从陌生网盘下载；如果系统提示无法打开，请按 macOS 的“隐私与安全性”页面提供的允许入口操作。

安装和第一次打开

1. 双击 DMG，把 Echo 拖到“应用程序”。
2. 第一次打开如果 macOS 提示无法验证开发者，进入“系统设置 → 隐私与安全性”，确认应用来源后允许打开。
3. 再次启动 Echo。正常情况会看到主窗口或“开始使用 Inkflow Echo”的初始化界面，而不是终端窗口。
4. 如果你是覆盖升级，先停止正在运行的任务，再退出旧版本，然后用新版本覆盖安装。

卸载应用不会自动删除你的 Workspace 文件。Workspace 是普通本地文件夹，是否保留与应用卸载是两件事。

小 Tip：第一次使用时先建立一个专门的测试 Workspace，不要直接把“桌面”“下载”或整个用户目录交给 Agent。这样可以避免它看到不相关的私人文件，也方便验证写入结果。

登录和授权

在右上角账号区域，或“设置 → 初始化设置 → 账号”中点击登录。浏览器会打开 InkFlow 账号页面。完成登录和授权后回到 Echo，等待账号状态刷新为“已授权”，并确认显示的是自己的账号。

如果浏览器已经显示成功，但 Echo 没有变化：

1. 先回到 Echo 等待几秒；
2. 关闭已经完成的旧回调页面；
3. 从 Echo 重新点击登录；
4. 不要复制、修改或重复使用旧的回调 URL。

如果提示回调已使用、状态不匹配或授权过期，重新从 Echo 发起流程。切换账号前先停止运行中的任务，再退出当前账号。Echo 不需要也不应该看到你的密码、Cookie 或 Token。

会员状态怎么看

未登录用户可以打开部分界面。非会员用户通常仍可管理本地资料，但需要在线权益的 AI 任务会显示限制。会员用户需要看到“已授权”和有效权益状态，才可以使用对应的在线任务。会员到期不会删除本地文件，但可能会阻止新的在线 Run。

完成四项初始化

打开“设置 → 初始化设置”，按顺序完成：账号、Workspace、对话模型、本地配置检查。顶部的进度会从 0/4 变为 4/4。

1. 账号：完成 InkFlow 授权。预期：账号项显示已完成。
2. Workspace：选择一个有读写权限的本地文件夹。预期：目录名称和可用状态出现，左侧文件树可以刷新。
3. 对话模型：填写 Provider、协议、Base URL、模型 ID 和 API Key，点击保存。预期：Key 显示已保存但不回显明文。
4. 本地配置检查：点击检查。预期：Core、Workspace 和模型连接分别返回成功或可解释的失败原因。

“保存配置”不等于“连接成功”。只有检查通过，输入区才会解除需要模型配置的拦截。多模态模型、Skill、MCP、Plugin 和外部 APP 不是第一次发送普通任务的必需项。

主界面怎么理解

顶部通常包含全局搜索、账号、帮助和设置；左侧导航进入对话、探索、计划、能力、偏好和知识库；知识库面板显示当前 Workspace 的文件树；中央区域是对话和输入框；右侧可以打开 Artifact 结果。

切换左侧导航不会自动切换 Workspace。窗口变窄时，知识库或 Artifact 面板可能折叠，点击对应图标可以重新打开。调整面板宽度只影响本机布局，不会修改资料。

第一次发送前的自检

在输入区输入任务前，确认：当前 Workspace 名称正确、账号状态正确、模型已检查通过、附件没有“解析失败”、能力标签没有红色错误。建议第一次任务使用不会造成损失的请求，例如“请列出当前 Workspace 根目录的文件名，不要修改任何文件”。

常见问题

应用打不开：确认下载来源和芯片架构；如果 macOS 显示安全提示，打开“系统设置 → 隐私与安全性”，在 Echo 对应提示旁点击“仍要打开”或“允许”，然后重新启动应用。

进度卡在 3/4：点击未完成的项目逐项处理，不要重复填写已经成功的项目。

发送按钮不可用：检查账号、Workspace、模型和本地配置；如果有正在运行的任务，先看是否需要停止。

模型检查失败：确认 Provider、协议、Base URL、模型 ID 是同一服务商的组合，重新输入 Key 后保存再检查。

给 Agent 的判断

当用户只说“帮我开始使用”时，先确认系统平台和安装状态，再确认账号、Workspace、模型和会员状态。四项初始化未完成时，不要直接开始需要写文件或联网的任务；先告诉用户缺哪一项以及入口。看到“已保存”不能推断“已验证”，看到导航高亮不能推断任务成功。