Loop 的工作区，本质上是某个智能体（agent）在本机上的工作目录。它既会存放 Loop 自己用于恢复上下文、保存记忆、归档历史的文件，也会存放智能体执行任务时产生的项目文件、代码、脚本、素材和输出结果。
换句话说，工作区不是只有固定几种文件类型，而是一个“既有系统约定目录，也有业务文件”的综合目录。
通常可以把工作区里的内容分成两大类：
一、Loop 自己管理的文件
这类文件主要用来帮助智能体：
- 记住当前在做什么
- 在重启后恢复上下文
- 保存长期知识
- 归档历史记录
常见包括以下几类：
1. state/
这是工作区里最重要的运行态目录之一，用来保存当前任务和上下文恢复信息。
常见文件例如：
active-task.json：当前正在处理的任务状态open-loops.json：还没闭环的待跟进事项active-context.md：当前运行上下文摘要
可以把它理解成：智能体当前“脑子里正在想什么” 的结构化存档。
2. MEMORY.md
这是智能体的记忆索引页。
它通常不会保存特别长的具体内容，而是告诉智能体：
- 现在最重要的上下文是什么
- 重启后优先读哪些文件
- 哪些知识文件值得参考
可以把它理解成：工作区里的“目录首页”或“导航页”。
3. kb/
kb 一般表示 knowledge base，也就是长期知识库。
这里通常会存：
- 领域知识笔记
- 用户偏好
- 渠道背景
- 某些任务的长期说明文档
文件类型通常以 md 为主，也可能包含少量配置或辅助文件。
这部分不是短期运行态，而是为了让智能体在多次会话之间保留更稳定的知识。
4. archive/
这是历史归档目录。
通常会存：
- 历史 checkpoint
- 旧任务记录
- 归档笔记
- 不再属于当前活跃上下文、但仍有参考价值的资料
可以理解成“资料室”或“历史仓库”。
5. sessions/
有些工作区里会有 sessions/，用来保存会话过程相关的产物。
具体内容取决于 runtime 和具体实现，可能包括：
- 会话记录
- 中间过程文件
- 临时执行产物
这部分更偏“过程数据”，不一定每个工作区都会以完全相同的形式出现。
二、智能体执行任务时产生的项目文件
除了 Loop 自己的状态和记忆文件外，工作区还会存放智能体真正干活时产生的各种文件。
这部分内容没有严格限制，可能是：
- 代码文件
- 脚本文件
- 文档文件
- 配置文件
- 图片、音频、视频素材
- 生成结果
- 调试输出
- 测试文件
例如你可能会看到类似这样的目录：
text-to-video/my-project/demo/scripts/assets/
这些目录通常不是 Loop 统一规定的，而是由具体任务决定的业务目录。
也就是说，某个 agent 如果在写代码，工作区里就可能有源码和配置；如果在处理图片或视频，工作区里就可能有素材和导出文件。
三、可能还会有一些隐藏文件或隐藏目录
除了 UI 中常见的目录，工作区里有时还会存在一些不一定总是明显展示的隐藏项，例如：
1. .git/
如果这个工作区本身是一个 Git 仓库，就会有 .git/。
这说明智能体可能在这个目录里：
- 管理代码版本
- 提交改动
- 对接 review 流程
2. .loop/
有些工作区会带有 .loop/ 目录，用于存放 Loop 自己的内部元数据。
具体内容取决于实现，一般不属于业务文件。
3. 其他运行态文件
例如：
.daemon-state.json- 临时锁文件
- 一些 runtime 生成的内部状态文件
这些通常是本地运行时需要的辅助数据。
四、工作区里的文件类型是不是固定的？
不是固定的。
更准确地说，Loop 工作区采用的是：
- 一部分固定约定目录（比如
state/、kb/、archive/、MEMORY.md） - 一部分自由业务目录（由 agent 当前任务决定）
所以你在不同 agent、不同任务、不同机器上看到的工作区内容，可能会不完全一样。
五、可以怎样理解整个工作区？
一个比较好理解的说法是：
Loop 工作区 = 智能体的“脑子” + “记忆” + “历史记录” + “实际干活的项目目录”
其中：
state/更像当前思路和运行状态MEMORY.md更像索引和导航kb/更像长期知识库archive/更像历史资料室- 项目目录则是智能体真正产生产物的地方
六、哪些文件最好不要随便删？
如果你只是查看内容，一般没有问题；但如果要清理目录，建议谨慎对待下面这些内容：
state/MEMORY.mdkb/archive/.loop/- 任何你不确定用途的隐藏状态文件
因为这些文件可能影响：
- 智能体恢复上下文
- 历史记忆读取
- 当前任务连续性
- 本地运行状态
相比之下，某些明显是业务产物的目录（例如临时项目输出）是否可删，要结合具体任务判断。
七、总结
如果只用一句话概括：
Loop 工作区里既会存放系统约定的状态、记忆、知识和归档文件，也会存放智能体实际执行任务时产生的各种项目文件与输出结果。
因此，工作区不是单纯的“缓存目录”，也不是只有固定格式的文件夹，而是智能体在本机上的完整工作环境。