什么是Planning with Files
Planning with Files 是一种基于文件的复杂任务规划系统，旨在模拟 Manus 的工作方式，通过持久化的 Markdown 文件构建‘磁盘上的工作记忆’。其核心理念是将大语言模型的上下文窗口（RAM）与本地文件系统（磁盘）解耦：模型有限的注意力窗口负责短期思考，而项目目录中的文本文件则承担长期、持久的信息存储功能。在启动任何复杂的多步骤任务前，用户必须首先创建三个关键规划文件——task_plan.md、findings.md 和 progress.md。这些文件构成了任务的全局状态快照，确保即使在长时间中断或模型上下文被刷新后，也能快速恢复工作状态。系统特别强调‘先写后读’原则，即每当通过浏览器、图像或 PDF 获取新信息时，必须立即将其转化为文本并写入文件，防止多模态信息因超出上下文窗口而丢失。此外，该模式还引入了一套严格的错误处理协议，要求记录所有失败尝试并主动改变策略，避免重复相同的错误。
核心功能特点
- 创建 task_plan.md、findings.md 和 progress.md 三个核心规划文件作为任务的‘工作记忆’
- 使用 session-catchup.py 脚本自动检测并同步上一会话的未更新上下文
- 遵循‘每两次查看/搜索操作后立即保存关键发现’的规则防止信息丢失
- 在重大决策前重新阅读计划文件以保持目标在注意力窗口内
- 实施‘三击错误协议’：诊断修复→更换方法→彻底重思，三次失败后升级至用户求助
- 将大型内容（如研究资料、API响应）存储于文件中而非依赖短暂上下文
适用场景
Planning with Files 最适合应用于需要组织大量信息、跨越多个工具调用且步骤超过三步的复杂任务场景。典型用例包括从零开始构建软件项目、执行系统性研究分析、开发新功能模块或进行长期的数据挖掘任务。在这些场景中，仅依赖大语言模型的短暂上下文极易导致重要细节遗忘、研究方向偏移或重复劳动。例如，当开发者需要集成一个第三方 API 并处理其文档中的复杂参数时，系统会指导用户先将 API 端点列表、认证流程和预期数据格式写入 findings.md；在实现某个算法模块时，则将阶段性成果和修改记录同步到 progress.md 中。对于简单查询、单文件编辑或快速查找等轻量级操作，此模式反而会增加不必要的文件维护负担，因此建议跳过直接使用。该工具尤其适合那些需要频繁中断、团队协作或跨会话延续工作的开发者，通过标准化的文件结构确保不同阶段的状态可追溯、可恢复。