Jev Engineering for Coding Agents PDF：中文阅读指南
这份 PDF 提出一种 Coding Agent harness 设计：每轮该看到哪些上下文、何时切换模型、怎样分层加载工具，以及哪些命令可以执行。它是设计建议，不是装好即可运行的 Agent 产品。
先说明作者和证据边界
PDF 封面将其描述为基于 Diogo Almeida 设计笔记的独立整理，并明确表示没有获得 TypeSafe 的关联或背书。传播中的社交帖子曾用“创始人发布”表述，不能据此改写封面的作者声明。
这篇中文页根据公开 PDF、可访问文本、官方 TypeSafe 文档和相关研究梳理内容。下面的十点是对方案的中文解释；凡涉及用时、成本和效果的数字，须回到相应原文与测试条件。
十个核心设计点
先把决策与生成分开
LLM 负责写代码，harness 负责执行；Jev 可对上下文、路由和动作许可提供有界判断。
检查缓存假设
设想每轮都要重新处理全部上下文，迫使团队看清长对话和跨模型移交的真实开销。
不要盲目切模型
更便宜的模型不一定让整个任务便宜；移交时重复处理的大上下文可能抵消差价。
先量阅读成本
文中引用外部研究说明检索与阅读在编码轨迹中占有较高比例；应以自己的任务数据确认。
按问题决定片段可见度
对同一个文件片段，可以隐藏、给短摘要、给长摘要或给全文。判断要服务于当前问题。
分层披露工具
先展示短说明，需要时再加载 Schema，少见工具才载入完整文档，减少无关上下文。
有条件地载入指令
例如进入 billing/ 时加载该目录规则；会话压缩后仍应保留这些触发条件。
按信任边界路由
涉及秘密、基础设施和高权限动作时，不能只按任务难度选模型。
复用一次只读检索
同一份检索结果可用于交叉审查、评估生成和进度解释，避免后台任务重复查找。
命令仍由程序门禁
先检查脚本和目标，再做允许、询问或拒绝；Jev 的判断不能自行授予执行权限。
怎样先做一个小实验
不要一次重写整个 Agent。挑一个反复发生、能判定结果的决策点，例如文件片段排序、模型升级、工具选择或人工复核。
- 记录任务、候选项、决策结果、后续动作和测试结果。
- 以同一任务集运行原方案和新方案，比较正确性、回退率、全流程时间、Token 和费用。
- 对高权限命令保留明确的 allow / ask / deny 规则，并由运行时做最终授权。
公开的Jev Codex Router 中文案例 →只展示模型与推理力度路由的一部分。其历史费用模拟不能证明 PDF 提出的整套 harness 已被实现或节省了多少成本。
常被转述的数字，应该怎样读
“快 200 倍 / 便宜 400 倍”
这是传播帖中的概括，不是对完整 12 页 Coding Agent 方案的端到端复现。
6.19 对 4.15
这是特定上下文长度、模型和价格假设下的路由示例；缓存和实际价格可能改变结果。
56.2% / 46.5%
PDF 引用的阅读与检索数字与 FastContext 研究 ↗有关，不是 Jev 的性能指标。
来源和延伸阅读
常见问题
这份 PDF 是 TypeSafe 官方白皮书吗？
不是。封面标为独立整理，明确写了不与 TypeSafe 关联，也未获其背书。
可以只看中文页，不读原文件吗？
可以先用中文页理解结构；若要引用数字、复用设计或评价作者观点，应核对原 PDF 和对应来源。
里面有可直接运行的 Jev Coding Agent 吗？
没有。它提出设计原则和实验方向，实际实现需要自己的 harness、规则、工具和评估数据。