Persistent external context · V3

让代码库拥有可持续的记忆。

llmdoc 保存源码难以低成本还原的架构、约束与工作知识,让 Coding Agent 更快到达 Context Floor。


Time to Context Floor

先到达足以解决问题的上下文。

Context Floor 是 Agent 完成当前任务所需的上下文丰富度。llmdoc 不试图把整个仓库塞进窗口,而是先给地图,再给相关知识。

概念演示,不是性能基准

01ls → find → rg建立仓库地图

02read × many寻找模块边界

03search again补齐遗漏关联

04context?仍在重建

工具调用反复、广泛

上下文占用持续增长

关键信息密度不稳定

Knowledge pipeline

三道门,控制什么进入上下文。

01 / RETRIEVE

检索门

按意图从地图、搜索、代码路径或已知主题进入;在足够时停止。

tree → context → show
02 / REFLECT

反思门

只捕获用户纠正、验证证伪和重大返工等高信号教训,绝不保存完整会话。

signal → candidate
03 / STABILIZE

稳定知识门

只有会改变未来选择、足够持久且难以快速重建的结论,才进入跟踪知识。

verify → llmdoc/

The boundary

知识,而不是库存。

保留

  • 架构决策及其原因
  • 模块边界与跨模块契约
  • 不变量与非显而易见的失败语义
  • 危险但可重复的工作流

留在真相源

  • 源码文件与 API 清单
  • 日志、临时计划和会话摘要
  • Schema、测试或 help 可快速重建的事实
  • 未经验证的推测

Start at the map

不向你的项目安装依赖。

通过外部 CLI 读取 llmdoc。缺少包时,npx 会写入机器缓存,而不是消费仓库。

npx -y @tokenroll/llmdoc tree
npx -y @tokenroll/llmdoc context --files src/api/client.ts
Markdown / MDXGit-native validityClaude + Codex
查看安装与宿主配置 →

Understand / retrieve / verify

先理解模型,再按意图取用。

官网文档解释 llmdoc 的概念、工作流与安全边界;CLI 负责确定性的检索、状态检查与知识维护。