Planning-with-Files核心原理KV-Cache优化与注意力操纵技术【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running agentic tasks. Crash-proof markdown plans that survive context loss and /clear, plus a deterministic completion gate and multi-agent shared state on disk. Manus-style. Works with Claude Code, Codex CLI, Cursor, Kiro, OpenCode and 60 agents via the SKILL.md standard.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files在Meta以20亿美元收购Manus AI的背后隐藏着一个革命性的AI代理工作流模式——Planning-with-Files。这个开源项目实现了Manus的核心上下文工程技术让AI代理能够像人类一样使用文件系统作为工作记忆磁盘彻底解决了AI代理在复杂任务中容易忘记原始目标的痛点。 KV-Cache优化AI代理的成本革命KV-Cache命中率是生产级AI代理最重要的单一指标。根据Manus的统计数据缓存与非缓存的成本差异高达10倍缓存令牌$0.30/百万令牌非缓存令牌$3/百万令牌输入输出令牌比例约为100:1三大优化策略1. 保持提示前缀稳定单令牌变化就会使整个缓存失效因此要避免在系统提示中加入时间戳等动态内容。2. 掩码而非移除不要动态移除工具这会破坏KV-Cache而是使用logit掩码技术。3. 确定性序列化使上下文变为仅追加模式确保缓存的最大化利用。 注意力操纵让AI永不忘记目标Planning-with-Files通过巧妙的注意力操纵技术解决了迷失在中间效应——在约50次工具调用后AI代理会忘记原始目标。核心机制重新阅读计划在执行Write/Edit/Bash等关键操作前PreToolUse钩子会自动读取task_plan.md将目标重新拉回到AI的注意力窗口中开始上下文[原始目标 - 遥远被遗忘] ...多次工具调用... 结束上下文[最近读取的task_plan.md - 获得注意力] 三文件模式外部记忆系统Planning-with-Files采用三文件工作模式将文件系统作为持久化的外部记忆Context Window RAM易失有限 Filesystem Disk持久无限 → 任何重要内容都写入磁盘文件职责分工task_plan.md- 阶段跟踪与进度管理创建时机任务开始时更新时机完成每个阶段后findings.md- 研究与发现存储更新时机任何发现后特别是2次浏览/搜索操作后progress.md- 会话日志与测试结果更新时机整个会话过程中 智能工作循环Planning-with-Files实现了Manus的7步智能循环1. 分析上下文 2. 思考决策 3. 选择工具 4. 执行动作 5. 接收观察 6. 迭代推进 7. 交付成果⚡ 关键技术突破1. 2-行动规则每进行2次view/browser/search操作后必须立即更新findings.md防止视觉/多模态信息丢失。2. 3次错误协议尝试1诊断与修复尝试2替代方法尝试3重新思考3. 5问题重启测试如果能够回答这5个问题说明你的上下文管理是可靠的我在哪里 → task_plan.md中的当前阶段我要去哪里 → 剩余阶段目标是什么 → 计划中的目标声明我学到了什么 → findings.md我做了什么 → progress.md 实际应用效果使用Planning-with-Files的项目报告显示任务完成率提升复杂任务的完成率提高了42%错误重复率下降相同错误的重复率降低了67%上下文使用效率减少了78%的上下文浪费 核心价值主张Planning-with-Files不仅仅是一个工具它是一种上下文工程哲学的实践将文件系统作为外部记忆通过重新阅读操纵注意力保持错误的可见性永不重复失败的动作这个开源项目将Meta 20亿美元收购的技术精髓带给每一位开发者让普通AI代理也能拥有企业级的上下文管理能力。通过KV-Cache优化和注意力操纵技术Planning-with-Files正在重新定义AI代理的工作方式。无论你是构建研究助手、开发工具还是自动化工作流Planning-with-Files都能为你提供坚实的技术基础让你的AI代理在复杂任务中始终保持清晰的目标导向。【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running agentic tasks. Crash-proof markdown plans that survive context loss and /clear, plus a deterministic completion gate and multi-agent shared state on disk. Manus-style. Works with Claude Code, Codex CLI, Cursor, Kiro, OpenCode and 60 agents via the SKILL.md standard.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
