news 2026/7/6 20:12:36

Planning-with-Files核心原理：KV-Cache优化与注意力操纵技术

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Planning-with-Files核心原理：KV-Cache优化与注意力操纵技术

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），仅供参考

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/7/6 20:10:40

Swagger-docs安全指南：保护API文档的7个最佳实践和配置技巧

Swagger-docs安全指南：保护API文档的7个最佳实践和配置技巧 【免费下载链接】swagger-docs Generates swagger-ui json files for Rails APIs with a simple DSL. 项目地址: https://gitcode.com/gh_mirrors/sw/swagger-docs Swagger-docs是一个为Rails API生…

作者头像 李华
网站建设 2026/7/6 20:10:37

安全编码标准：Instatic插件开发规范

安全编码标准：Instatic插件开发规范 【免费下载链接】Instatic Instatic is a modern self-hosted visual CMS - get it running in 1 minute 项目地址: https://gitcode.com/GitHub_Trending/in/Instatic Instatic作为一款现代自托管视觉CMS，其插…

作者头像 李华
网站建设 2026/7/6 20:09:30

vz错误处理：常见问题排查和调试技巧大全

vz错误处理：常见问题排查和调试技巧大全 【免费下载链接】vz Create virtual machines and run Linux-based operating systems in Go using Apple Virtualization.framework. 项目地址: https://gitcode.com/gh_mirrors/vz1/vz 在使用vz创建和管理虚拟机时&…

作者头像 李华
网站建设 2026/7/6 20:09:07

10分钟上手django-mongoengine：从安装到第一个文档模型的创建

10分钟上手django-mongoengine：从安装到第一个文档模型的创建 【免费下载链接】django-mongoengine django mongoengine integration 项目地址: https://gitcode.com/gh_mirrors/dj/django-mongoengine 想要在Django项目中轻松使用MongoDB吗？djan…

作者头像 李华
网站建设 2026/7/6 20:06:57

Planning-with-Files部署与配置：从开发到生产的最佳实践

Planning-with-Files部署与配置：从开发到生产的最佳实践 【免费下载链接】planning-with-files Persistent file-based planning for AI coding agents and long-running agentic tasks. Crash-proof markdown plans that survive context loss and /clear, plus a …

作者头像 李华
网站建设 2026/7/6 20:04:10

如何用MediaCrawler轻松搞定多平台数据采集：5分钟快速上手指南

如何用MediaCrawler轻松搞定多平台数据采集：5分钟快速上手指南 【免费下载链接】MediaCrawler 项目地址: https://gitcode.com/GitHub_Trending/mediacr/MediaCrawler 在当今数字时代，跨平台数据采集已成为市场分析、内容监控和学术研究的必备技…

作者头像 李华