管理自己的资料：Workspace、文件、LLM Wiki 与搜索

Echo 的所有资料操作都围绕当前 Workspace（知识库）进行。Workspace 不是一个云端项目名称，而是你电脑上的一个真实文件夹，以及 Echo 为这个文件夹保存的索引、对话引用和结果记录。开始任何读取或写入任务前，先确认当前 Workspace；这是避免把资料交给错误任务、把结果写进错误目录的最重要一步。

选择一个合适的 Workspace

第一次使用时，在左侧选择“知识库”，点击添加目录，然后在系统文件选择器中选择一个项目根目录。建议一个项目使用一个独立文件夹，例如：

我的项目/
├── 原始资料/
├── 笔记/
├── 输出/
└── README.md

不要直接选择整个“桌面”“下载”或用户主目录。这样做会让 Agent 看到大量与当前任务无关的私人文件，也增加误修改文件的风险。选择后检查显示的目录末级名称和文件树内容，确认无误再点击“使用”。

切换 Workspace

点击顶部“全局搜索”或当前知识库名称，在“搜索知识库”中输入名称，再选择目标项。切换成功后，左侧文件树、当前 Workspace 名称和后续任务的资料范围应同时改变。打开一两个文件核对内容，不要只根据名称判断切换成功。

文件树会根据 Workspace 的变化刷新。刚在 Finder 或其他编辑器中修改文件时，先观察文件树是否已经更新；如果仍显示旧内容，再使用刷新。正在运行任务时，Echo 可能阻止切换。先点击停止，等待 Run 变为“已取消”或“已完成”，确认没有写入操作后再切换。不要在任务生成中强行关闭应用或更换目录。

目录不可用和重新定位

如果移动了硬盘、改了文件夹名称或从另一台电脑打开，Workspace 可能显示“目录不可用”。点击“重新定位”，选择原来的文件夹。重新定位后刷新文件树，并核对几个已知文件。

不要选择同名的新文件夹。Echo 无法仅凭文件夹名字确认它们是同一个项目；选错目录后，后续生成的 Artifact 可能写入错误位置。

删除 Workspace 登记只会解除 Echo 的关联，不会删除原文件夹。若你确实要删除资料，请在文件树或 Finder 中单独确认，并先备份重要内容。

Workspace 被解除关联后重新打开

如果 Workspace 曾经被解除关联，但原文件夹仍然存在，可以从 Workspace 恢复入口选择“重新定位原 Workspace”，再选择“选择其他 Workspace”来改用另一个目录。重新打开后，确认文件树、当前目录和最近对话是否对应同一个项目。

文件树里的日常操作

左侧文件树顶部通常提供新建笔记、新建文件夹、刷新和视图/排序操作。新建笔记时先选择目标文件夹，再输入标题；新建文件夹时确认当前父目录。外部编辑器或 Finder 修改文件后，点击刷新，否则界面可能暂时显示旧内容。

右键文件或文件夹可以看到复制、粘贴、创建副本、重命名、在 Finder 中显示和删除。创建副本适合在保留原稿的前提下让 Agent 修改。重命名会改变之后的引用路径；如果已有计划、对话或同步任务使用旧路径，重命名后要重新确认它们是否仍然指向正确文件。

删除前检查三件事：顶部当前 Workspace 是否正确、右键菜单中的完整相对路径是否正确、是否还有任务或计划正在读取它。删除文件后，对话里的旧引用不会自动变成新文件；恢复能力取决于你的系统备份或 Artifact 历史，不能假设 Echo 一定可以恢复普通文件。

文件格式和预览

文本、Markdown、常见文档和带文本层的 PDF 通常适合搜索和内容分析；图片需要视觉模型或图片解析能力；扫描 PDF 可能需要 OCR；压缩包、加密文件、数据库文件和损坏文件可能只能作为原始文件保存，不能保证读取正文。文件能显示在文件树中，不等于 Agent 已经读懂内容。

如果任务要求总结文件，先确认附件或文件引用状态为“已解析”。对于“格式未知”“解析失败”或“处理中”的文件，告诉用户当前只能保存或引用原文件，不要承诺正文分析一定成功。

小 Tip：把原始资料和生成结果分开，例如使用 原始资料/ 与 输出/ 两个目录。让 Agent“只读原始资料，结果写入输出”，比事后恢复误改文件更简单。

LLM Wiki：把资料整理成可以长期使用的知识库

如果你只是临时问一个文件，普通 Workspace 就够了。如果你要长期积累研究、客户、课程或项目资料，可以使用 LLM Wiki 的整理方式。它把“刚收集的原文”和“确认后的知识”分开：Raw/Inbox 保留原始输入，Wiki 存放整理后的内容，Source Bundle 记录来源、时间和相关媒体。

这套“原始资料、整理结果、来源记录”分层方式，受到 Andrej Karpathy 对 LLM 时代知识管理的讨论启发。原文链接：https://x.com/karpathy/status/2039805659525644595。它适合与大模型协同：先保留可追溯的原文，再让模型整理，最后由你确认后沉淀为可复用知识。链接内容和平台页面可能变化，Echo 不对第三方文章的持续可访问性负责。

推荐的整理流程

1. 先把网页、附件或聊天内容保存到 Raw/Inbox。预期：原文和来源信息都保留，不直接覆盖已有 Wiki 页面。
2. 打开 Wiki 扫描或整理入口。预期：Echo 列出可能的标题、归档位置、重复来源和冲突。
3. 阅读建议，并检查原始链接、作者、时间和内容范围。预期：你知道每条建议会写入哪个文件。
4. 选择接受、修改、合并或跳过。预期：只有确认后的决定才会写入 Wiki。
5. 回到文件树刷新并打开结果。预期：目标文件存在，来源信息仍然可以追溯。

如果同名文件已经存在，不要直接覆盖。先看差异，判断是新版本、重复来源还是不同文档。整理任务中断时，Raw/Inbox 应该保留；可以从上一次成功阶段继续，而不是重新抓取并制造重复资料。

Raw/Inbox 中的资料可能显示“需要你决定”“来源已有更新”“已整理到 Wiki”“已归档，待整理”或“原文件已删除”。这些状态表示下一步不同：来源有更新时先重新检查原文，原文件已删除时先确认本地是否还有可用副本，不要把缺失来源当成可以继续归档的正常输入。

注意：LLM Wiki 的归档建议不是事实审查。医疗、法律、财务、合同和研究结论必须人工核对原文；模型整理出的标题或摘要不能代替专业判断。

全局搜索

点击顶部“全局搜索”，输入标题、文件名、来源或对话关键词。搜索结果可能按文件、Wiki、Raw、Source 和对话分组。点击结果后，应看到对应文件、对话或定位动作；如果只是结果高亮而没有打开目标，先确认当前 Workspace 和文件是否仍存在。

当前搜索最多扫描 500 个文件，每类最多返回 8 个结果；可全文搜索的文本文件单个不超过 512 KB。超过大小、格式不可解析、索引还未刷新或文件位于另一个 Workspace 时，搜索不到并不代表文件不存在。

搜不到时按顺序检查

1. 看顶部当前 Workspace 名称是否正确。
2. 在文件树中确认文件确实存在，并点击刷新。
3. 用文件名中的独特词重新搜索，不要先使用“报告”“会议”这类常见词。
4. 如果文件很大或是图片/PDF，改用文件树打开，或先让模型处理附件。
5. 如果刚完成大量导入，等待索引完成后再搜索。

搜索结果只是定位辅助，不代表 Echo 已经把整个 Workspace 全文发送给模型。真正发送哪些内容，取决于当前任务、明确的文件引用和所选能力。

小 Tip：给重要资料保留稳定标题、日期和来源名称，例如 2026-09-07-客户访谈.md，比只使用“新建文档.md”更容易长期搜索。

资料操作的安全边界

Workspace 原文件默认留在本地，但 Agent 任务可能把你明确引用的文件内容发送给所选模型 Provider。外部连接、网页采集、MCP 和同步服务还会有自己的数据处理规则。处理客户资料、个人信息、合同、源代码或未公开研究前，先确认任务会使用哪些能力和服务商。

Agent 修改文件前，应说明目标路径、修改范围和是否覆盖原文。用户没有明确要求时，优先创建副本或写入 输出/。任何删除、覆盖、移动或批量重命名都需要再次确认。

给 Agent 的处理原则

当用户说“在我的资料里找一下”时，先确认当前 Workspace，不要搜索所有登记的知识库。用户说“整理成知识库”时，先区分是临时文件整理还是 LLM Wiki 归档。看到目录不可用、文件解析失败或搜索无结果时，报告事实和限制，不要猜测内容，也不要自动选择另一个同名目录。