出问题时怎么办：诊断、错误、恢复与支持

遇到问题时，先不要反复点击、重复发送或删除文件。很多任务是分阶段执行的：界面可能显示失败，但正文已经保存；外部同步可能回写失败，但目标文件已经更新；模型可能超时，但工具已经创建了 Artifact。正确的顺序是：保存输入 → 查看当前状态 → 检查目标文件和历史 → 再决定恢复或重试。

先按症状快速定位

应用打不开、白屏或一直显示启动中

确认 Echo 来自可信安装包、架构正确、macOS 已在“隐私与安全性”允许打开。重新启动前保存能复制的输入内容。白屏时先完全退出并重开；如果只有某个 Workspace 出问题，尝试打开其他 Workspace 区分应用问题和目录问题。不要删除应用数据或 Workspace 作为第一步。

顶部显示 Core 异常

先停止当前输入或任务，等待几秒观察是否恢复。仍然异常时退出并重新打开 Echo。重启后检查当前 Workspace、对话历史和最近 Artifact；如果文件已经在磁盘上，不要因为 Core 异常就重新生成。持续异常时导出诊断，记录 Echo 版本、macOS 版本、发生时间和最后一个可见状态。

发送按钮不可用

依次检查账号是否已授权、当前 Workspace 是否可用、对话模型是否已保存并通过检查、本地配置是否完成、附件是否仍在解析、当前是否已有正在运行的任务。按照缺失项处理，不要盲目重置全部设置。

账号或会员状态不正确

确认浏览器登录的是正确账号和官方域名。网页授权成功但 Echo 未更新时，回到 Echo 等待后从 Echo 重新发起登录。不要复制旧回调 URL。会员到期会影响在线任务，但不会删除本地文件；模型 Provider 的额度和 InkFlow 会员是两套状态。

模型连接失败

检查 Provider、协议、Base URL、模型 ID 和 API Key 是否是同一服务商的有效组合。确认 Key 没过期、账户有额度、网络可用，并执行“检查配置”。如果检查成功而任务失败，减少附件和上下文，确认模型是否支持工具或当前媒体类型。不要把 Key 放进日志、截图或 Workspace。

Workspace 显示目录不可用

在“知识库”中找到该条目，点击“重新定位”，选择原来的目录。不要选择同名新目录。重新定位后刷新文件树，打开几个已知文件核对。解除登记不会删除磁盘目录；如果原硬盘未连接，先恢复硬盘挂载再定位。

Workspace 重新打开后看不到原来的内容

如果你曾经解除过 Workspace 关联，但原文件夹还在，使用“重新定位原 Workspace”重新选择原目录。不要选择同名的新文件夹；重新打开后，先核对文件树和几个已知文件，再继续任务。

如果 LLM Wiki 中的资料显示“来源已有更新”，先重新检查原始来源；如果显示“原文件已删除”，先确认本地是否还有副本，不要直接继续归档或覆盖现有 Wiki 内容。

搜索没有结果

确认当前 Workspace、文件存在且已刷新。当前搜索最多扫描 500 个文件，每类最多返回 8 个结果；单个文本文件超过 512 KB 可能不会全文索引。图片、扫描 PDF、压缩包和加密文件不能按普通全文搜索处理。改用独特标题、文件名或来源关键词。

附件解析失败

看附件状态和错误说明。对文本文件检查编码和文件是否仍存在；扫描 PDF 尝试 OCR；图片确认尺寸和清晰度；视频、音频和压缩包不要假设模型能读取内部正文。超过入口限制时拆分文件或先放入 Workspace。删除输入区附件不会删除原文件。

任务失败、超时或卡在生成中

先等待或点击停止，让任务结束，再检查对话、工具活动、Workspace 和 Artifact。网络或 Provider 临时错误通常可以重试；写文件、同步、转存、发布、购买和创建视频任务前，必须先确认上一次是否已经成功或产生部分结果。

如果运行中暂时没有新的正文，但时间线末尾仍有动态三点，先等待，不要重复发送。三点消失后，再根据“已完成”“失败”“已取消”或“已中断”判断下一步；权限卡和确认卡出现时，先处理卡片。

录屏入口打不开或无法开始

先确认当前 Workspace 可用，并且是在 Composer 的捕捉入口中选择“录屏”。如果 Echo Capture 没有打开，完全退出并重新启动 Echo，再检查是否有其他录制窗口仍然存在。

如果来源列表为空，检查屏幕录制权限，并确认没有被系统全屏应用、远程桌面或其他屏幕捕获程序占用。需要录制单个应用时，先打开目标窗口再重新打开来源选择器。

如果摄像头或麦克风不可用，录制可以按需要关闭对应设备后继续；如果必须包含该轨道，前往系统设置授予权限并重新启动 Echo。摄像头预览出现后再开始录制，避免把权限失败误判为已录入画面。

录屏停止后没有看到视频 Artifact

停止录制后先等待结果完成，不要立即关闭 Echo 或移动 Inkflow/Artifacts/recordings/。然后检查：

1. 当前 Workspace 是否仍然是录制开始时的 Workspace；
2. Inkflow/Artifacts/recordings/ 是否出现新的录制目录；
3. 对话或 Artifact 列表是否已经刷新；
4. 文件是否能播放，视频时长是否大于零。

如果目录中有文件但 Artifact 尚未出现，保留整个录制目录和当前时间，不要删除后重录。先刷新 Artifact 列表或重开对话；仍未注册时，再导出脱敏诊断信息。

录屏中途退出、取消或中断

取消录制不应被当作成功结果。退出 Echo 前等待录制进入“已完成”“已取消”或“已中断”等明确状态；如果应用异常退出，重新打开后先检查录制目录和 Artifact，再决定是否重录。不要在不知道上一次是否已保存的情况下连续创建多个相同录制。

刷新窗口或重新打开对话后，先等历史记录恢复。若出现“历史记录加载失败”，选择“重试”；如果文件已经写入 Workspace，先核对文件和修改时间，再决定是否重跑。重点检查用户消息、最终回答和执行过程是否各自完整，避免把历史加载延迟误判为任务失败。

Artifact 不见、预览空白或恢复失败

确认当前 Workspace 和文件路径。预览空白但源码存在时，可能是 HTML 沙盒不加载外部脚本或资源；先打开源码和磁盘文件。恢复前查看差异并备份当前文件；恢复失败时不要重复覆盖，检查权限、文件占用和 Workspace 状态。

计划没有运行或重复运行

确认 Echo 在计划时间保持打开、计划仍启用、时区正确、模型和能力可用。打开计划关联对话查看实际执行记录，不要只看列表摘要。重复运行时先暂停计划，检查上次是否其实已成功、输出文件名是否固定、是否有多个触发来源。

微信、视频号、网页、抖音、小红书或飞书失败

先检查连接状态、浏览器扩展、OAuth 或登录会话，再检查页面权限和目标目录。正文成功、媒体失败时保留正文和来源，只处理失败部分。状态未知时查看任务记录和目标平台，不要重复提交。登录墙、验证码、付费内容、DRM 和好友权限不能绕过。

如果微信任务显示“等待微信下载”或“下载未完成，可稍后重试”，先在微信中点击下载或播放，等本地媒体准备好后再回到 Echo 重试。飞书显示“文件已删除或已归档”时，先保留本地文件；删除同步记录不会删除本地文件，但会停止后续跟踪。

Notion 连接失败或没有可访问页面

确认你粘贴的是 Notion Internal Connection 的 Integration Access Token，并且在 Notion 中已开启读取能力、已把目标页面或数据库共享给该 Connection。Token 有效但没有共享页面时，Echo 仍可能显示“没有可访问页面”；这不是整个 Notion Workspace 为空，而是当前 Connection 没有可读范围。

连接成功后，先在“选择范围”刷新资源列表，再选择页面或数据库条目。搜索只覆盖当前 Connection 能看到的内容。若某个页面同步失败，先检查页面是否被撤销共享、是否已删除，以及本地目标目录是否仍在当前 Workspace。

正文已经保存但图片或附件缺失时，不要重建全部同步任务。先查看本地 Markdown、媒体目录和同步状态，只重新同步缺失或失败的页面。删除同步记录不会删除已经保存的本地文件；断开 Notion 也不会删除这些文件。

本地数据占用较大

进入偏好设置的“本地数据占用”，先查看“当前可删除”。可以删除过期的 Agent 执行过程记录，再根据需要选择“回收数据库空闲空间”。这不会自动删除聊天记录和 Artifact。如果重要结果只存在于任务过程里，先把结果保存到 Workspace，再执行清理。

较大视频导入失败，或附件还在处理时不能发送

先等附件导入完成；v1.4.0 会阻止包含导入中或不可用附件的发送，避免请求只剩文字。导入失败时移除失败项后重新添加，检查磁盘空间、文件读取权限和源文件是否仍在。批量添加被取消时重新选择，不要反复按 Enter。直接选择磁盘文件、粘贴内容和递归添加文件夹的限制不同，详见完成一次 AI 工作。

视频服务已经生成，但 Echo 没有成片

回到原 Workspace、原对话，检查视频任务卡；若右侧提供恢复图标，优先点击该刷新图标（悬停显示“恢复原任务”）。恢复网络并检查原服务商配置后，等待取回结果；不要新建同样的付费生成。若服务商任务已过期、输出被清理或没有可用任务 ID，保留原任务信息再联系服务商。图片或语音请求结果未知时同样先查记录，但不保证具有视频任务卡的恢复入口。

“视频创作”已安装，但无法开始制作

打开知识应用详情，检查“运行时与工具”。本地视频需要 FFmpeg/ffprobe；动画和 Studio 还需要 Node.js 22+、npm 及可启动的浏览器。按缺少项的安装说明处理后重新打开 Echo。应用安装成功不等于所有可选工具、模型和依赖都已下载。

首次下载失败时，保留错误文字并检查网络、磁盘空间和权限，再请 Echo 继续准备同一工具。不要为修复工具安装而删除素材或整个 Workspace；可选音频环境不完整时也应先检查具体目录和错误。

Studio 链接失效，或选中元素后没有修改

让 Echo 重新打开同一 HyperFrames 项目的 Studio，并使用新返回的项目链接。不要猜测端口，也不要把普通 HTML 预览当作 Studio。先在 Studio 选择对象，再回 Echo 原对话描述修改；Studio 的“Ask agent about this element”目前不会自动把请求发送到 Echo。没有选中对象时，补充镜头、时间点或元素名称。

视频有字幕文件，但播放或发布后看不到字幕

检查交付的是 SRT 文件、可切换字幕轨还是烧录字幕。先在播放器启用字幕轨；目标平台不保留字幕轨时，可要求导出始终可见的字幕版本。烧录需要相应字体和字幕渲染能力，不能只根据文件中存在字幕轨就判断画面已经有字幕。

旧视频任务没有继续执行入口

标为“历史视频任务”的旧工作流记录只用于查看历史和作品。后续从“视频创作”知识应用启动，把已有项目和素材交给新任务继续修改。这与外部服务视频任务的“恢复原任务”是不同情况，不要通过恢复旧能力目录来强行运行已停用流程。

错误信息索引

下表是用户语言的处理方向。界面显示的内部代码可用于诊断，但用户不需要记住代码。

什么时候可以重试

通常可以重试：明确的网络超时、模型临时不可用、读取尚未开始、连接测试失败且配置已修正。需要谨慎重试：写文件、Artifact 恢复、同步、微信转存、视频下载、网页采集和媒体生成。不能直接重复：外部发布、付费操作、发送消息、删除、批量移动、用户不确定是否成功的异步任务。

重试前记录原 Run ID、目标路径、文件修改时间和第三方任务状态。优先“继续/恢复/刷新状态”，其次才是“重新创建”。

诊断文件怎么导出和分享

在设置或错误面板中选择导出诊断，保存到用户明确选择的位置。诊断可能包含产品版本、时间、错误码、状态、脱敏路径、Provider 名称或连接标识。分享前打开文件检查，不要直接上传整个诊断包。

应删除或遮盖：API Key、OAuth Token、Cookie、二维码、邮箱、账号 ID、完整本机路径、客户名称、私信内容、文件正文、第三方访问链接和任何个人信息。支持人员通常需要的是版本、系统、发生时间、操作步骤、可见提示和脱敏错误码。

支持请求模板

提交问题时请提供：

Echo 版本：
macOS 版本和芯片：
问题发生时间：
当前 Workspace（只写项目代号）：
我当时想完成什么：
从哪里进入：
看到的完整用户提示：
Run/任务是否已经产生部分结果：
我已经尝试过什么：
是否涉及外部平台或费用：
脱敏后的诊断文件：

不要提供密码、Key、Token、Cookie、二维码、完整文件夹路径或未经授权的第三方内容。

术语表

Workspace / 知识库：你选择的本地资料目录和 Echo 对它的登记、索引与任务边界。Conversation / 对话：可以持续追问的上下文。Run：一次消息或计划触发的执行。Artifact：写入 Workspace、可预览并有版本的结果文件。Skill：影响任务方法和规则的能力。MCP：连接外部工具或数据的协议和服务。Plugin：包含多个 Command 的能力包。Command：用户明确选择的具体命令。Provider：模型或外部服务商。Deployment：Provider 下的具体模型部署。Binding：能力与 Deployment 的绑定。Plan / 计划：保存后可重复运行的任务。Raw Inbox：刚采集、尚未整理的原始资料。Source Bundle：记录来源、时间和相关媒体的资料集合。

当前版本边界

本手册针对 Inkflow Echo macOS Beta。支持的 macOS 版本、芯片架构、模型协议、媒体格式、第三方平台页面和 Provider 参数可能变化；当前界面提示优先于旧截图和文字。计划需要 Echo 保持打开；第三方平台需要用户自己的账号和权限；技术上能够读取的内容不一定可以合法保存、改编、发布或商业使用。

代码中存在但没有公开入口的功能不能按可用功能宣传；只有部分格式或部分状态通过验证的功能必须标注“部分支持”；需要外部授权但尚未完成真实验证的连接器只能说明准备步骤和限制。每次版本更新应同步更新手册版本、截图日期、错误文案、限制数字和搜索索引。