【开源自荐】ContextOS：让 Codex 的 272K 上下文在长任务中也无需压缩代码，综合减少 60% 上下文

[yubinbin32-ops]

项目地址：https://github.com/yubinbin32-ops/ContextOS

我用 Codex 改中型项目时，最消耗上下文的经常不是“写当前函数”，而是三件事：

• 每轮都要重新理解项目结构
• 为了定位一个方法，读进来一堆无关文件
• 模型说完成了，但测试没有证据，后面反复返工

ContextOS 做的事，是把这些重复的上下文消耗从 Codex 的对话里拿出去。

使用方式

从仓库 Releases 下载 macOS App 后，App 会自动完成 MCP 安装和配置，把 ContextOS 注册到 Codex 等客户端里。

打开 Codex，ContextOS 就已经启用，不需要手动改 mcp.json。

核心流程

1. 项目结构先写入 ContextOS

在图形界面里整理模块、依赖链路、影响路径和检查点。这些内容会保存成 .contextos/graph.json，由 Git 追踪。Codex 不用每轮重新扫描目录，而是读取项目结构和相关任务上下文。

2. Codex 按任务读取上下文

任务开始时，ContextOS 返回紧凑的项目地图、相关 Block、Chain、Plan 和检查点，而不是把整个仓库塞进去。

3. AST 只提供精准定位

ContextOS 给 Codex 的是 path::symbol、函数签名和行号范围，不是完整实现代码。编辑器打开的是具体目标方法，不是整个文件。

4. run_command 压缩命令输出

命令执行结果会经过 ContextOS 的终端网关，过滤 ANSI、进度条、本地路径和重复日志，只保留结构化诊断信息。

5. 测试回执决定完成状态

完成状态绑定测试执行结果和检查点。源码改过以后，相关检查点会变成 retest_required，模型不能只靠“我觉得完成了”过关。

对比

环节	不使用 ContextOS	使用 ContextOS	实测结果
项目结构理解	每轮读目录和文件	读取 Git 追踪的项目图	不重复扫描
代码定位	读取整个源码文件	path::symbol + 行号	单任务上下文降低 99.4%
执行链上下文	返回多模块实现内容	只返回定位信息	执行链上下文降低 98.5%
命令输出	原始终端日志进入上下文	run_command 过滤和压缩	日志压缩 94.8%
完成状态	模型自我判断	测试回执 + 检查点门禁	目标模块召回 100%

表格里的 99.4%、98.5%、94.8% 来自 npm run benchmark 的可复现实测；标题里的“综合减少 60%”是我长时间任务用下来的体感。

欢迎实际试一下，尤其是已经用 Codex 跑过中大型项目的人。