# 工程复盘

Orca v0.5.5 上下文预算复盘：max_tokens 384K 与压缩阈值不一致造成的死区、pinned 通知让整轮无法压缩、对照 dsh 与 Codewhale 的做法、按思考强度设定回复预留并逐请求裁剪、以 API 用量为锚测量提示大小、按工具平衡单元切分当前轮、紧急压缩只采用真正变小的结果，以及实现中把同一份偏差扣了两次的弯路。

Orca v0.5.4 git 写授权复盘：.git 在沙箱里为什么必须只读、为什么不能凭命令输出判断沙箱拒绝、Codex 让模型自己申请 require_escalated 而 DeepSeek 不申请、运行前识别 git 写命令的四种判定、单条命令授权只放开 index 与 objects 而保持 config、hooks、modules 只读、Seatbelt 与 bwrap 的做法和 Windows 的退路、「本会话允许」只记开关不记目录，以及 husky 留下的口子。

Orca 两轮 Terminal-Bench 2.0 评测复盘：指令在 argv 里导致 Agent 被自己的 /proc 扫描 kill -9（exit 137）、lifetime workspace 服务在会话结束时被 terminate_all 一并取消、修复只把指令从 orca 的 argv 挪到 sh -c 的 argv（exit 143）、Harbor 均分与 scored-only 与基础设施复跑三种口径、环境启动超时泄漏容器，以及把评测探针和台账收进仓库之后探针自己也会过期。

Pilion 录制与技能复盘：只有人能录制、Agent 提炼不能凭空造步骤、回放走与 Agent 相同的工具路径、首次回放即使完全访问也要审批；第三期把产物从归一化后的步骤改成只增不改的事件日志；以及打的字经页面正文摘录、页面回显、可访问名、「显示密码」切换四条路径漏进录制文件的过程、每个修复的代价和至今仍认不出的形状。

Cleanzo 0.1.0 到 0.1.3 复盘：$TMPDIR 与正在运行的应用缓存为什么不能整目录清，safeToClean 因 filepath.Abs 不解析符号链接而放行 /var/folders，用 lsof 与 lsappinfo 判断「正在使用」且探测失败就当在用，垃圾直接删除与用户文件进系统废纸篓的分工，读不到的废纸篓不等于空，对照柠檬清理与 Mole 的做法，以及从九个固定分类改成规则表，把原来漏掉的约 22 GB 开发缓存纳入规则。

Orca v0.5.0 终端界面改版复盘：把“生硬”拆成可指认的问题、用 HTML 交互稿评审、chrome.rs 设计 token 与颜色守卫、子代理逐任务实现与终审、审批内联与 tasks dock、Ctrl+Enter 从插到队首改成 steer、后台代理唤醒与 relay 浮点 digest、Ghostty 真终端实测、npm OIDC 发布，以及发布后才看清的投影缺口。

Orca v0.4.31 子代理运行时复盘：三档委派策略、统一准入作用域与任务树、等待时让出执行 lease、持久 outbox 交付，以及真实 DeepSeek 测试暴露的只读任务收敛问题。

从 blade-code v0.10.164~167 的三个修复出发，拆解侧问并发模型里的所有权边界——admission lease、按目标去重的取消闩锁、失败 preparation 的排空，以及为什么这类竞态只能靠真实 PTY 轨迹锁定。

从 Orca v0.4.28/29 的 full access 与问卷交互重构出发，解释运行中权限变更需要的提交点、快照隔离与专用 patch 通道，以及为什么交互校验必须由请求对象自己承担，而不是挂在调用点的模式匹配上。

从一个可伪造的沙箱拒绝信息出发，解释 Agent 权限系统为什么不能把 stderr、项目配置或 UI 响应当成授权依据，并拆解 Capability Kernel、Execution Broker、workspace identity 和 fail-closed backend 这套设计选择。

一次基于 Orca 源码和测试的 TUI 卡顿排查，记录长对话误判、流式批处理、局部投影、commit 索引、token cache 和增量渲染的修复过程。

复盘 Orca runtime-owned typed surface 重构从普通 TUI turn 到 Goal、workflow、background、ACP 和 JSONL 的完整迁移，包括原子 batch、snapshot/cursor、interaction、terminal、restart recovery 与发布验证。

复盘 Orca runtime-owned typed surface 重构：从 TUI 与 runtime 的状态分叉，到原子持久化、snapshot/cursor、request-scoped interaction、terminal settlement、restart recovery 和真实 PTY 验证。

Orca Goal Mode 第二轮重构：固定 64 轮上限误判 NoProgress，到 runtime 收回生命周期，以及 admission 矩阵如何替代无语义计数器。

复盘 Orca v0.2.46 Goal Mode 事故：session 取证、thread-local 失效、schema 与执行能力分叉，对照 Codex / Claude Code / Grok Build 重构 ownership，并用真实 DeepSeek 和 Linux CI 收口。

本文复盘 Orca v0.2.21 的一次真实生产事故：长任务已完成并提交，但 DeepSeek 最终没有产生可见 content 或 tool call，导致 Goal 被判失败。文章涵盖日志取证、语义恢复、会话历史保护、usage 统计、失败持久化、预算治理、回归测试和正式发布。

Orca @ 文件搜索从同步 git ls-files / ignore 索引迁到 ignore + Nucleo 流式会话：对比 Claude Code 与 Codex、latest-wins、三层 stale guard、browse、warm catalog、线程所有权和百万路径门槛。

本文复盘 Orca 基于 Rust 和 ratatui 的 TUI 滚动性能重构，涵盖事件循环饥饿、Markdown 渲染缓存、消息 revision、视口虚拟化、超长会话滚动、PTY 探针和真实 DeepSeek API 验证。

本文从 Orca 一次真实 DeepSeek V4 适配出发，解释 DeepSeek-native Coding Agent 为什么需要沿着 provider 行为、tool calling 语义和 agent runtime 一起调整。文章复盘 update_plan 布尔状态归一化、reasoning_content 工具回放、DeepSeek strict mode、update_goal、glob anyOf schema、max_tokens、空响应重试、工具数量上限、系统提示瘦身和 real API 探针。

本文复盘 Orca 一次真实卡死反馈：从 session 日志定位长会话压力，到参考 Codex 和 Claude Code 的上下文处理方式，再到实现 ranged read_file、grep/glob 分页、去除旧 reasoning replay、soft compaction、tool output micro-compaction、TUI 状态提示和回归测试。