更新日志

状态、进度、本次改动与权限查询直接读宿主事实，不再排队、复活旧计划或触发评审；Codex 的只读咨询子线程不再被误报成整个会话只读，明确修复/写入/Git 提交仍进入可写通道。Codex 的 Guarded / Auto 主执行会话默认都使用完整开发环境，Guarded 保留审批、Auto 自动批准；Plan、意图判断和独立评审仍机械只读。常驻回合增加时间、token、事件和工具调用硬上限，截断、取消与评审不可用都诚实有界结算。

状态、计划、任务账本、审计、知识和证明文件统一使用能力根目录、有界读取、原子写入、跨进程锁与 no-follow；损坏记录不再返回半真相或覆盖原证据。向量、repo-map、BM25、本地 embedding 与召回均有文件/字节/批量/并发硬上限，持久化前统一脱敏。

Claude Code、Codex、OpenCode、Grok Build、Kimi Code 均不按 CLI 版本拒绝启动，标准能力由实时协议决定，私有能力按逐项源码证据安全降级。GitHub #49 已修复：resume 只指纹当前计划声明的文档，历史 output 同类文件不再让计划假过期。

复制提示按 Unicode grapheme 计数并停留状态区；Overlay 过滤终端控制字符；宿主输入、MCP、目录信任、部署与 PR 补齐三语。Windows/macOS/Linux GNU/musl 的终端、滚动条、resize、进程树、安装和自更新路径完成回归。

Release 绑定 tag/commit/七个二进制/哈希/provenance/SBOM/manifest，npm 九包和官网只能从同一验证提交推进；进程型 Node 契约在 CI/Release 串行隔离，Linux Rust 1.97 的平台 mode_t lint 差异也已纳入标签前门禁。全工作区测试、严格 Clippy/rustdoc、MSRV、Windows GNU、四个 Linux release 目标、Node/npm/官网与 RustSec 门禁全绿；RustSec 0 漏洞。

工具形态底座请求的越界 shell 写守卫不再是死代码;ledger key 不再按能力坍缩——批准一次 npm run build 不再永久免问全项目所有 MCP 工具、子代理与其它 shell,改按具体命令与目录细分;空命令 exec 与符号链接洗白的越界写改为 fail-closed。

kimi 四条拒绝路径与 grok 超长文本不再向阻塞中的底座写协议错误,改回优雅 cancelled;claude 问答不再用会被脱敏的问题文本做关联 id,用户回答不再被误判 DENY;opencode 畸形问题不再静默丢弃挂死底座,改直接拒绝;session/new 各失败路径统一清理 folder-trust。

底座问题在同一 tick 到达时,用户正输入的无关聊天不再被当作对它的回答;取消回合会清理挂起问题,不再把下一条无关消息误当回答;upstream 权限边界穿正确 req_id。

大脑澄清问题现在会显示给用户;被截断的构建不再假显 ✅完成卡与任务完成,改标注已停;resident 聊天面精确用量不再被 /usage 标为估算。

四条独立审查线逐个亲验落地,全套测试与严格 Clippy/rustdoc/i18n 三语/架构门/ratchet 全绿;一处子代理误报经编译核实回退;Windows canonicalize 短名不确定与 PowerShell 冷启动 flake 根治。

Guarded 下批准一次普通 shell 或一次工作区外读取，不再永久免问全项目所有 shell、沙箱扩展与计划确认；这些语义请求不再与真实 shell 共用同一 ledger key。

可写档下本回合被判为咨询解释而以只读执行时会显式提示，不再让底座静默拒绝写入而档位显示自动过门；Grok 计划审阅按其契约应答并可弹真实交互面，不再卡在会话级计划模式。

被中断、等待回答或零源码却声称完成的回合不再假报完成；opencode、kimi、claude 的请求送达与拒绝路径修复，底座撤回请求不再终止会话。

粘贴进问答面板会被读取；通用问答条恢复标签与提示；矮终端 gate 选择项开窗、状态行不再互相矛盾；新增 /queue 与队列 s 立即发送；跨工作区读取可见化。

HostRequestSettled 撤回机制基础：底座撤回其请求时按 id 撤回对应问答与审批。

全套测试通过，严格 Clippy、rustdoc、i18n 三语一致性与架构门通过；CI flaky 测试簇根治，恢复干净可信信号。

Guarded 模式的 /run 在 TUI 与无界面终端都会真正停在文档确认门并持久化状态；纯文档 Fast 任务执行自己的文档步骤，即使文档是最后交付物也不会跳过确认。

/continue 可恢复全部文档步骤已完成、只等待确认的计划；确认后直接进入文档感知的最终验收，不重写已完成文档，也不误报无可恢复任务。Auto 仍端到端自动执行。

新运行在写入前记录有界源码基线，最终 QC 只归因本轮新增或真正改动文件；旧项目中内容未变化的既有问题会被明确忽略，不再让文档任务反复修复无关历史债务。

意图超时兜底仍允许查找本地仓库等只读工具任务；Codex app-server 结束仍回收完整进程树。GitHub #47 为撤回误建，#48 复现链已有回归覆盖。

Agent 2,037 项核心测试单线程全绿；工作区架构门、CLI 与集成测试、格式检查和全工作区严格 Clippy 通过。

当前用户请求成为本回合唯一授权来源；历史对话、项目文档、记忆、工具输出和子 Agent 结果只作为带来源证据。普通聊天不再携带旧计划或构建压力，明确修改与提交也不会被陈旧 read-only 状态压住。

项目事实与未决事项按当前需求召回，事实必须来自用户明确陈述、仓库文件或文件系统核验；旧推断和无来源记录保留审计但不再进入底座提示词，普通请求不会看到无关偏好。

项目指令、仓库轮廓、事实与历史笔记统一使用有界、类型化、无权限的引用封装；伪造标签、提示词注入或 Request 文本只能作为数据，不能改变任务、授权、工具边界或评审。

启动页压缩为结果优先引导，80×24 首屏不溢出；/help 在窄终端按真实显示宽度换行并可完整滚动。启动不再静默安装 Claude / Kimi hook，治理集成只由显式 install 命令写入。

底座差异由实时会话能力声明驱动，Agent 核心不再按底座名称猜能力；五底座继续接受用户安装的官方版本，审计基线只检查协议漂移，不是运行时版本白名单。

全工作区 all-targets、严格 Clippy、格式与差异检查、官网 lint/生产构建、npm 启动更新与平台包契约、版本锁均通过；原生 PTY 验证 80×24 启动、帮助、计划和退出。

/plan 同时显示 Director 与底座原生计划、完整角色团队、阻断项、修复建议和 advisory；窄终端按真实显示列处理中文与组合字符，完整内容可在 transcript 中从顶到底查看。

正常完成但格式错误的评审只修复一次 schema；空回复、失败、工具调用和超时绝不被挽救为通过。Auto 在内部只读重试耗尽后当场终止，Guarded 只允许一次 /continue，不再循环修改源码、重跑 Docker、伪造通过或无限等待。

评审材料以本轮真实变更集和计划声明文件为强制范围，并明确披露抽样和遗漏；强制文件未完整进入材料、变更集不可读取或扫描不完整时只能报告 unavailable。敏感配置不会进入提示词。

CLI/TUI 在探测底座和创建会话、账本之前识别终止凭据；取消和新运行会安全结算旧暂停。当前明确写入请求也不再被旧会话 read-only 覆盖，状态查询不会启动评审或旧计划。

源码、配置、审计、知识、证明包和治理扫描采用有界读取、全局预算与 no-follow；外部命令、验证、部署和预览统一回收进程树并限制输出，链接、FIFO、洪泛和退出后仍占管道的子进程不会再卡住运行。

官网改为只从正式 tag 的同一提交部署；Release 最终同时核验 GitHub 22 个资产、npm 九包、Pages SHA 与官网版本。CI 与 Release 统一固定 Rust 1.97、Node 24.18 和锁文件输入。

明确的 Git 提交请求由 Rust 宿主在模型和通用构建流水线之前接管：Plan 零写入，Guarded 最多确认一次，Auto 只执行一次；事务使用固定参数、精确暂存集和原子回滚，提交后不再误触发团队评审、Docker 或自动修复。

修复、登记、保存、写入和创建等明确可写请求由当前用户指令与信任档位确定权限，不再被底座模型误留在 read-only；明确只分析和 Plan 仍是不可越权的只读上限。

必需评审超时、启动失败或解析失败会进入可恢复的运行时暂停，不伪造通过，也不当成源码缺陷循环修复；/continue 只重试暂停的评审边界，源码未变时不重跑已经完成的源码工作和确定性检查。

/plan 与底部排队计数读取同一份宿主 FIFO；转向、后续任务和宿主 Git 事务不再出现显示已排队但计划为空，也不会被当前模型回合重新解释。

底座原生命令、Git 事务和恢复路径不会消费旧需求、旧计划或上一轮授权；恢复、取消、正常完成与异常退出使用独立宿主终态，迟到事件不能污染新一代会话，暂停的 gate、预算、队列和原生 session 交接得到保留或有界失效。

TUI 路由、宿主 Git、运行暂停和 Director 驱动进一步模块化，并新增 Git 事务、权限档、队列重放、评审暂停、取消竞态和 CLI/TUI 入口回归；远端三平台 CI 与七个原生二进制发布门仍在正式标签创建后最终放行。

明确的修复、登记、保存、写入和创建请求在 Guarded / Auto 下进入可写会话，不再被底座误留在 read-only；明确只分析和 Plan 模式仍是只读硬边界。

/run 和普通输入会在底座未安装或不可启动时于规划前停止并保留需求；切换底座不会再先提示成功、随后才因 PATH 缺失中止。

状态查询保持观察型路径；存在确定性阻塞时先修根因，不再重复召集 critic，消除无关评审、超时和评审自动修复循环。

新运行使用独立工作区基线，scope 扫描排除系统文件、缓存、覆盖率、本地密钥和底座私有配置，不再把历史文件或 mtime 变化误报成本轮修改。

五个底座均取消 CLI 版本白名单，版本仅用于诊断，能力由实时协议和运行时安全规则决定；Grok / Kimi 源码契约同步到最新审计提交。

当前回合明确要求修复、修改或实现时，用户指令会覆盖底座误判的 read-only 或缺失授权并进入可写会话；只有明确要求只分析或主动进入 Plan 模式才保持只读。

Claude Code 项目治理 hook 改为安全合并到本地 settings.local.json，不覆盖已有 hook；doctor 会逐阶段核验真实生效的 UmaDev 二进制。

踩坑记录补齐时间、独立 episode、修复生命周期与精确验证归因；/lessons 只显示真正复发后形成的待验证或已验证经验，记忆维护采用次数与时间双重上限。

计划、知识索引和项目事实采用原子、限大小、拒绝符号链接的持久化；队列、恢复与评审都能有界退出，不再被陈旧状态或失败循环拖住。

发布前校验七个原生二进制的 OS、CPU 和 libc 文件头，registry 完整性、可见性与 latest 提升均可重试且不可回退，避免错误架构或半发布进入 npm。

全工作区测试、doctest、严格 Clippy/rustdoc、RustSec、npm 安装与更新 smoke、Linux 交叉构建、Debian/Alpine 安装和官网生产构建通过；当前优化版完整扫描 260 个文件耗时约 0.70 秒，0 条治理问题。

询问「当前什么进展 / 还剩哪些任务」只会读取并汇总现状，不再召集团队评审、自动修复或复活旧计划；已完成的交付状态优先于陈旧 pending 计划。

Auto 模式下明确要求修复时，底座获得与用户指令一致的可写权限，不再同时收到 read-only 的矛盾提示；Plan 仍是不可越权的只读边界。

团队 critic 被宿主限制为纯评审：工具调用立即按不可用结算，围栏 JSON 与运行建议不会冒充 blocker；不可用评审不再触发自动修复和重复评审，根治超时循环。

/plan 会把当前计划和 FIFO 排队 / 转向消息一起展示；底部有 [queued N] 时不再回答「暂无计划」。

Linux musl x64 / arm64 成为一等预编译目标，Alpine 会由 npm 按 libc 自动选择正确二进制，无需源码编译。发布现在覆盖七个原生目标、九个 npm 包，并同步校验 GitHub Release、哈希、SBOM、启动器和官网。

全工作区测试、doctest、严格 Clippy、最低 Rust 1.88、npm 安装 / 更新 smoke、官网安全审计 / lint / 生产构建通过；真实 Alpine arm64 中完成原生二进制、npm 选择和交互式 TUI 验收。RustSec 无漏洞。

Shift+Tab 不再把底座误锁进只读模式导致「写不了文件」。此前 Shift+Tab 的档位循环把只读的「计划」档也串了进去,从「自动过门」按一下会掉进只读——底座完全不能写文件、反复提示「本回合只读,请输入继续」把构建卡死,可底部明明写着「转手动」(手动仍可写、只是逐项审批)。现在 Shift+Tab 只在两个能写的档之间切(手动审核 ↔ 自动过门),绝不进只读;只读只能用 /mode plan 显式选,从只读按 Shift+Tab 则退回可写档、帮你脱困。

浅色 / 白底终端下界面文字不再看不见。根因是背景亮暗判定把 COLORFGBG 排在了 macOS「终端」的浅色默认之前,而「终端」本身根本不设 COLORFGBG——出现的那个值是 shell 框架(oh-my-zsh / base16 之类)注入的、并不反映真实配色,于是一个陈旧的「暗」值把白底压成暗字全隐形。现在「终端」的浅色默认优先于这种注入值,并新增 __CFBundleIdentifier 作为识别兜底(shell 剥掉 TERM_PROGRAM 时仍能认出「终端」);OSC 11 真实背景色探测(现代「终端」其实会回应)仍会异步精修到你的真实深 / 浅配色。此问题与 CPU 架构无关,Intel 与 Apple 芯片跑的是同一套逻辑。

五个底座(claude-code / codex / opencode / grok / kimi)最全面的一轮深度适配。连续构建引擎补上与路由引擎一致的瞬时退避重试:底座触发限流 / 过载(如 codex-on-ChatGPT 最常见的失败)不再让整场多阶段构建硬中止,而是可见退避后自动续跑。Grok 不再是「被遗忘的底座」:鉴权失败会指明 grok login,model / 推理强度 / 上下文窗口正确显示并在会话重建时重新同步。Kimi 兑现「任何版本都适配」:改名的认证方式、新版 mode 目录不再被误拒会话,你选的模型也真正生效。claude 的默认连续会话路径现在会把你选的 --model 传给底座(此前被静默丢弃、跑成底座自己的默认模型)。codex 修了以顶层 turnId 上报完成时挂死、过期 auth.json 误报「已登录」、Auto 档同发两个会冲突的 sandbox flag。opencode 的一次性 Guarded 改为只读的 fail-closed(没有审批通道就不写)、老版 / 异形输出不再把原始 JSON 泄漏成答案或吐空。

对话左侧的 gutter 竖线与首行的发言人圆点对齐了(此前圆点居中、竖线左贴边,看着断开错位);顺带根治了改动 gutter 字形会把竖线漏进拖拽复制的隐患。

收敛 Dependabot:cargo / github-actions / npm 三个生态的依赖更新改为分组、月度、限额,以后不再堆一堆分支。

全量工作区测试通过、0 失败,fmt 与严格 clippy(-D warnings)、严格 rustdoc 均无告警;发布经 GitHub 三平台产物、npm 七包、官网构建及发布后干净安装门校验。三条推迟项(claude 连续会话中途死的 reopen、opencode 忙边沿回合完成、kimi 用量解析)需真机 / 真样本验证、盲改风险更高,留待后续。

隐式构建重新受治理。此前有一次内部重构悄悄让「你在聊天里说做个东西、底座真写了文件」这类隐式构建绕过了团队评审、诚实校验、任务台账与验证门——只有显式 /run 才有完整治理。现在这些治理按「底座真的写了文件」这一事实重新接通:隐式构建会走团队 QC(设计 / 前端 / 后端 / QA / 安全交叉评审)与有界返工;底座声称构建完成但一个字没写会被诚实硬门拦下,而不是含糊放过。团队 QC 默认开启,若需关闭可设 UMADEV_REACTIVE_QC=0。

撞上运行时间上限时,构建可恢复暂停并真正续跑。此前预算耗尽会硬中止、逼你重输整个需求、丢掉已做的步骤——而且底座还在真产出时也会被墙钟腰斩。现在:预算改成滑动式,底座只要还在真写代码就不会被砍,只有真卡死才由独立看门狗停;撞上上限则可恢复地暂停(已做的存好),输入 /continue 干净续跑剩余步骤、已完成的不重跑。可用 UMADEV_RUN_BUDGET_SECS 调整。

底座进程不再残留(彻底版)。上一版修了长驻会话,这次覆盖到全部一次性调用(评审 / 探测 / 单次执行):取消或超时后按进程组 / 进程树整体回收,不再有原生底座在后台继续写文件;Windows 补齐 Job Object,锁竞争 / 中毒时也不再漏杀。

在控制台打字(尤其中文)不再整屏闪烁。根因是在不支持同步输出的终端(如 macOS「终端」)上,输入清理触发了整屏擦除重画;现在改为原地增量重绘,在所有终端都不闪。

粘贴以图片名 / 图片链接结尾的一行文字不再被静默吞掉;斜杠命令歧义前缀(如 /co)回车不再误切底座;/config、/status、/design 界面补齐三语;底部用量不再把「tokens」截成「tok」。

让 UmaDev「找一下某个项目仓库在哪」这类只读任务，不再被答成「当前回合不能调用本机工具」而卡死循环。此前当底座首次响应超过意图判断的等待上限、退回确定性兜底、而请求里又没有命中「改 / 建 / 修」这类动词时，会被保守地判成纯聊天并禁用全部工具。现在改对了安全默认：判不准时允许只读的查看 / 搜索工具（只读永远不会改动工作区），只有空输入或明确的纯闲聊才禁用工具——不是靠堆砌关键词，而是让兜底本身不再误禁只读。

底座进程不再残留。经 npm 安装的 codex 是一层 Node 壳、再拉起原生 app-server;此前每次意图判断 / 回合超时或取消，只杀掉了外层 Node 壳,原生 app-server 变成孤儿进程堆积,退出后也清不掉。现在按进程组 / 进程树整体回收(codex / opencode / claude 全覆盖,无 unsafe),超时 / 取消 / 退出各路径都不再留下孤儿进程。

发布不再报红:此前发布流水线和官网部署流水线会同时抢部署同一个 GitHub Pages 环境,晚到的那个失败并占据「Active」,让发布页出现一个红叉(官网内容其实已正常上线)。现在官网部署只由一条流水线负责,发布不再重复部署。另有反应式构建治理的底层铺垫(默认关闭、开关可控),为后续彻底移除「动手前预判意图」这一层做准备。

全量工作区测试通过、0 失败,fmt 与严格 clippy(-D warnings)、严格 rustdoc 均无告警。发布经 GitHub 三平台产物、npm 七包、官网构建及发布后干净安装门校验。

构建请求不再卡在底座的只读 / plan 模式里执行不下去。此前意图判断超时退回关键词兜底、或大模型判为构建但授权字段不匹配时，会把这一轮误锁成只读，底座想动手却找不到退出计划模式的入口，于是反复重规划、卡死。现在自主（Auto）档以大模型的判断为准，低置信的兜底只读不再把底座关进计划模式，交由信任档自身的权限管辖——你明确要求「只分析、别改」的只读仍然照旧尊重。

浅色 / 白色终端下界面文字不再看不见。UmaDev 本就有深 / 浅两套配色，但过去只在启动时判一次、且在不回应背景查询的终端（如 macOS 终端）上退回深色，于是白底浅字全隐形。现在能被探测的终端启动即取正确配色，并在你运行中切换主题（浅↔深 / 换配置 / 系统日夜自动切）时实时跟随；macOS 终端通过读取其真实背景色也能自动判明；另有盲敲可用的 /theme light|dark|auto 手动开关兜底。

经中转 / 代理工具接入的底座，在你改动上游配置（如推理强度）后不再需要手动 /codex 才能恢复。此前会话在启动时缓存了底座配置、上游一改就对不上、内联重试复用旧配置照样失败；现在这类瞬时错误会像 /codex 那样完整重建会话（重新探测模型与推理强度、重新协商），底部显示的思考强度也随之刷新为你实际设置的值。

接入的所有底座现在都不挑版本：装了任何版本的 claude-code / codex / opencode / kimi / grok 都能被识别和适配，装了较新版本不再被误报为「未安装」。版本知识只用于增强能力，绝不阻断检测或基本使用；唯一的例外是 opencode 的只读（Plan）档——旧版有子代理绕过只读写文件的上游缺陷，仅在这一个档位要求升级以兑现只读承诺，其余档位任何版本照跑。

长会话后 /rewind 的回退检查点列表不再偶发为空。此前扫描窗口的一次瞬时读取失败会被当成「没有检查点」，把你磁盘上真实存在的回退点整个藏起来；现在读取失败会有界重试，真实历史不再被误判为空。

触发 5 小时限额（或底座过载 / 网络中断）被终止后，底部的执行计划面板不再凭空消失。此前计划每一步的状态其实一直实时写入 .umadev/plan.json（数据从未丢失），但中断会清空面板、且只有显式 /continue 才会重新加载——随后随便说句话会另起一个新计划，于是面板一直空着、你也无从得知进度还在。现在：被限流终止时会明确提示「计划已保存，输入 /continue 继续未完成的步骤」；面板会以「冻结态」从磁盘重新画回来——中断时正在跑的那步显示为暂停 [=]（静止，不再转圈），已完成 / 待办如实呈现，标题标明「已中断 —— /continue 继续」，绝不重现旧的「卡住的进行中」动画；一旦真正开始新计划，冻结面板自动清除。（评审面板的持久化恢复因需改动数据模型，列为后续。）

Grok / Kimi 在底座选择器里不再对已登录的用户显示「登录未验证」。此前它们只认 API Key 环境变量，漏了每个用户实际用的浏览器 / 设备登录——Grok 的登录存在 ~/.grok/auth.json、Kimi 存在 ~/.kimi-code 下，都是标准凭据文件（与 Codex、OpenCode 同一套探测方式）。现在识别到磁盘上的凭据即显示「已登录」；探测保持 fail-open：文件缺失 / 为空 / 不可读一律显示未验证，绝不误报已登录，实际能否使用仍以会话开启时的鉴权为准。

发布与 CI 加固：修掉了发布流程里若干只在真正打 tag 发布时才暴露的问题（嵌入模型哈希校验、GitHub Release 原子发布、npm latest 标签提升的读写延迟重试），并系统性消除 Windows CI 上因 runner 过载导致的测试计时抖动（安全网超时统一放宽，仍能抓真正的卡死）。不改变产品行为，只让发布与持续集成更稳。

全量工作区测试 5,191 项、0 失败，fmt 与严格 clippy（-D warnings）无告警。本版为未签名发布；发布经 GitHub 三平台产物、npm 七包、官网构建及发布后干净安装门校验。

Kimi Code 成为第五个一等底座。Claude Code、Codex、OpenCode、Grok Build 与 Kimi Code 现在全部按各厂商官方能力契约驱动——会话、权限、跨会话恢复、审批、取消、追问与后台任务逐一对齐；每个底座跑在隔离的 ACP（Agent Client Protocol）生命周期里，协议分帧限死 64 MiB、握手与探测全部有超时、进程树在退出/崩溃时确定性回收，畸形输出与管道中断一律安全降级而非拖挂宿主。

跨终端、跨底座会话连续性成体系：会话记住自己属于哪个底座，切换底座时对话记忆与计划状态随黑板工件与转录移交，不匹配即丢弃重开；在 VS Code 里干到一半、换原生终端 /resume 再切底座也不再失忆。

意图判定回归底座大脑：普通对话由所选底座模型判定「聊天 / 小改 / 完整构建」，绝不靠硬编码关键词；旧计划与历史只作上下文，不再授权多余工作（不会因为一句问候就召集整支团队跑旧任务）。

总监闭环收紧：Director 恢复、步骤验收、子 Agent 结算、源码感知 PR、部署与失败退出码全部加固——底座中途死亡的步骤如实标注 Blocked 而非伪造完成，无阻塞的干净构建也产出收敛后的整合汇报，源码不再漏进 PR，失败绝不再显示成功。

工作区安全（严重级）：① Windows 持久化不再把已提交的写入静默回滚——此前两阶段替换在读路径上做覆盖式崩溃恢复，可能把刚写入的值（包括「关闭记忆采集」这类隐私设置）悄悄还原成旧值，现改为读路径永不改盘、恢复只在持锁写路径进行；② 单写者运行锁不再因机器启动标识对不上被误判过期，杜绝两个进程同时写一棵源码树；③ 工作区一旦停留在过去，构建与对话两条写入路径都立即停下并如实告知，不再往错误的树上继续写。

1.0.54 发布后的真实 npm 全局安装验收发现，新版 npm 可能把平台包放在 umadev/node_modules/@umacloud 的嵌套位置；旧启动器只查同级目录，因而把已经安装好的二进制误报为缺失。1.0.55 按 Node 依赖解析语义优先查找与主包绑定的嵌套副本，再回退到传统同级布局。

新增真实目录回归：旧同级二进制与新嵌套二进制同时存在时必须选择新版；全新全局安装和 1.0.53 升级路径都校验 main、platform、binary 三者为 1.0.55。npm 已发布版本不可覆盖，因此本补丁立即取代 1.0.54 成为 latest。

umadev update 现在同时核对 npm 主包、平台包和真实二进制版本。即使 package.json 已是 1.0.54、umadev.exe 仍是旧版，也会识别为分裂安装并继续修复；更新后只有三者完全一致才报成功。Windows 文件占用提示会明确要求关闭 VS Code、Zcode、Codex 与相关终端，并给出强制安装和 where umadev 的 PATH 排查命令；独立二进制替换失败会回滚旧文件。

跨终端生命周期重构：备用屏只进入一次、恢复幂等；终端控制回复由唯一输入读取器解析，不再与键盘争抢 stdin；OSC 11 主题探测改到备用屏之后异步处理；Windows 禁用会干扰 CJK IME 的 Kitty 键盘协商；非 ASCII 输入后做有界重绘。针对 Windows Terminal、conhost、VS Code、WezTerm、iTerm2、Terminal.app、kitty、Ghostty、tmux 等建立兼容契约与回归矩阵。

注释治理 UD-CODE-006d：只检查新增或恶化的普通注释债务，提示连续 8 行以上说明块或注释明显多于代码的改动；文档注释、许可证、生成文件和测试豁免。它是 advisory，不用注释配额阻塞开发，要求注释解释为什么与不变量，修复历史写入更新日志。

Ctrl+V 可直接附加本机系统剪贴板图片：macOS / Windows 使用系统能力，Linux 支持 Wayland wl-paste 与 X11 xclip；远程、tmux、offline、缺工具、超 10 MiB 都诚实降级，阻塞命令不占用渲染线程。另增 UMADEV_THEME=dark|light 显式主题覆盖。

Windows 影子 Git 快照不再继承用户的 autocrlf、GPG 签名、身份、hooks 与 fsmonitor 配置，首次使用也能创建字节级快照。发布链路新增真实 npm 分裂升级 smoke、版本锁步校验和 tag/Cargo 一致性门禁，防止同类 1.0.53 事故再次发布。

umadev update 在 Windows 上不再刷 EPERM 红字、不再留下垃圾目录。根因是:执行升级的那个进程,正是要被替换的那个可执行文件——npm 无法删除正在运行的 exe,只能把旧目录改名丢在那里,每升一次多一坨。现在升级改由 node 壳完成,全程不启动二进制,npm 换树时没有任何文件被占用;并会顺手清扫历次升级遗留的 .umadev-* 暂存目录。

umadev update 适配所有安装方式,不再只对 npm 有效。现在会认出这份 umadev 究竟是 npm / pnpm / yarn / bun 哪一个装的,就用哪一个升级(不再一律 npm install -g 装出第二份、互相遮蔽);用 cargo install 或直接下载二进制的用户也能真正自更新(从 Release 取本平台二进制,完整下载校验后原子换位,任何一步失败都保持原二进制不动,绝不留下半个写坏的文件);已经是最新版会直说而不再无谓重装;用 sudo 装出的 root 属主前缀会被当场点名并给出修复步骤,而不是让 npm 崩掉整个事务。

安装时不再弹出 npm 的安装脚本白名单提示(Mac 首装一次、Linux 每次)。那个 postinstall 是纯提示脚本,而 npm 默认就吞掉它的输出——它想说的话根本传不到用户眼前。现已整个移除,用户也不必再手动配置白名单。

工作区安全加固(严重)。①单写者运行锁不再因为机器启动标识对不上就被误判为过期,避免两个进程同时写同一棵源码树;②工作区自愈在恢复前,先把当前现场完整快照进影子仓库,再也不会覆盖用户手改的代码(快照失败则放弃自愈——丢掉一次自愈永远好过丢掉用户的代码),并给出一条真能执行的恢复命令;③工作区一旦停留在过去,构建与对话两条写入路径都会立刻停下并如实告知,不再往错误的树上继续写。

增强 UIUX 设计。设计令牌一致性校验进入验收地板(令牌定义、配对前景色、主题覆盖、对比度),视觉方向在动手实现前先立稿;反 AI 味配色改为按色相判定,不再是一张硬编码的色值清单;而某个色系到底允不允许用,现在交给底座大脑依据真实需求判断——需求里明确禁用的颜色不会再被放行,真正的品牌色也不会被误拦。

跨终端恢复会话后切换底座(如 VS Code 里干到一半,到原生终端 /resume 再切 codex)不再变「失忆」:修复了两个断链——①旧底座的慢预热可能在切换后才落位,把挂错底座的会话停进车位,下一轮直接开走它;②新底座第一轮(携带全部历史的那轮)因过载等瞬时错误一个字没吐就失败时,会被误判为「已吸收历史」,下一轮裸发导致新底座从没见过对话。现在会话记住自己属于哪个底座、不匹配即丢弃重开,首轮无流式证据即失败则下一轮重新喂完整固件与转录。

切换底座时打一条诚实的「上下文移交」说明(写入转录并显示):对话记忆与计划状态已随转录移交给新底座;原底座进程内的原生深层上下文(它读过的文件、推理积累)物理上不可迁移,新底座会凭黑板工件与对话记忆接手。回归测试锁死完整链路:存盘 → 新进程 /resume → 切底座 → 第一轮必携带之前的对话。

子代理输出不再与主 Agent 碎片化穿插:子代理的全部输出(文本/思考/工具行)按归属缓冲,完成时以一个完整的「子代理」分组块输出;启动时先显示「工作中」保持可见;回合结束/超限必冲刷,绝不静默丢内容。

底座派出后台子代理后不再提前汇报或直接结束:UmaDev 现在帧级追踪在途后台任务,回合欲结束而任务未归时会把底座顶回去收齐结果再写最终汇报(有界重试,超限如实标注);等待上限提高到 30 分钟。

长对话滚动卡顿(拖不动):滚轮/拖拽事件合并进帧预算 + 转录排版缓存只画可视窗口——5000 行会话单帧渲染从 12.6ms 降到 0.33ms(约 38 倍),一次甩动从约 250ms 卡死降到最多 2 次绘制;打字延迟不受影响。

构建诚实性三连:底座进程死亡后剩余步骤不再被误标完成(需步骤归属证据,否则如实 Blocked);无阻塞的干净构建同样产出收敛后的整合最终汇报;返工指令附带原始失败日志尾部便于底座精准修复。

反屎山架构门禁(确定性检查,进验收地板):新文件超 500 行阻塞并给出拆分指令;架构文档声明的分层规则对真实 import 依赖边校验(违规阻塞);新增代码 5 行级重复检测(提示复用位置)。QA 编写测试与设计令牌步骤现在是计划骨架的结构化保证,测试先行不再靠自觉;并修复了弱底座可绕过文档先行的依赖环缺陷。

QA 与安全席位改为「冷上下文」评审(全新会话仅凭黑板工件评审,不继承实现者的盲点);跨会话持久的运行笔记 .umadev/run-notes.md;输入框空闲时随机轮换占位提示(示例需求/常用命令),底部状态栏瘦身且在中文 Windows 终端不再溢出回卷;用户级 bypassPermissions 直通已文档化,守护模式拒绝提示会直接给出解法。

守护模式下完整构建现在真正在两道门暂停:三份核心文档(PRD/架构/UIUX)产出后停在 docs_confirm 等你审阅确认,前端完成后停在 preview_confirm 让你先看效果——此前默认路径只承诺不执行,直接从头跑到尾。暂停状态落盘,重启 UmaDev 后 /continue 可接着跑;自动模式保持不停。在门上输入「确认 / 通过 / approve / ok」现在真的通过(此前只认 c 键,打「确认」会被当成修订意见、整块重跑几分钟)。

构建过程中的交互全部接活:底座请求权限时真的弹 y/n 问你(此前显示「需要用户确认」却自动拒绝);/plan skip、veto 等步骤编辑和构建中输入的指令在下一个步骤边界真正生效(此前静默排队到构建结束才发,黄花菜都凉了);构建中底座提问时如实说明「先按默认继续、你的回答在下一步骤并入」。另有一批诚实性修复:恢复提示改为 /continue、/rewind 运行中拒绝(防双写)、门卡片按键说明纠正、状态栏在暂停时显示「等待确认」。

repo-map(注入底座的代码库结构切片)学会真实结构:扫描 12 种语言的 import 依赖边(歧义即放弃、绝不瞎猜),文件重要性改用真实被引用数排序,并按当前任务做个性化游走排序;测试/生成文件不再挤占上下文预算。零新依赖,无依赖边时行为与之前完全一致。

Windows 拖动/全屏窗口后偶发的整屏错乱:终端合并窗口尺寸事件导致尾事件丢失时,UmaDev 此前会一直按旧宽度绘制(每行超宽回卷);现在周期性轮询终端尺寸兜底,尺寸真变了就走完整的 resize 自愈。

部分 Windows 终端(尤其 Windows Terminal)在底座大段流式输出时会累积渲染错位 / 花屏(重启会话临时恢复、之后又复现)。根因:Windows 上同步输出探测从不发送,导致每帧清屏自愈永不触发;而 Windows Terminal 又被排除在老 conhost 的心跳自愈之外——两个流式自愈都不给,渲染 drift 永不清除。现在补上:凡是支持同步输出括号、但未确认到 sync 的终端(Windows Terminal 是典型),在流式输出时走原子心跳自愈(清屏落在同步括号内、不闪),drift 会被周期性清除。跨平台无回归:mac 的 Terminal.app、老 conhost、以及支持 sync 的 mac/linux 终端行为全不变。

企业级工程规范注入,让底座产出商业级结构、少写屎山:① 每次构建都注入一段常驻代码纪律(分层+依赖单向、领域语义命名、DTO 与实体分离、单一职责、禁 god 文件与 util 黑洞、业务规则不写进 controller);② 新增 6 份全栈深度标准(通用方法论 + Java/Spring + TS/Node + Go + Python + Vue3/TS,各带正例与反例、命名与字段规范、分层分包、反屎山硬指标如单文件/单函数行数与圈复杂度上限),按需检索注入底座。

完整构建的最终汇报改到「全部收敛之后」再出:此前底座在每步做完时就吐一份「完成+下一步」的过早汇报,而团队评审与阻塞项修复发生在其后,导致有阻塞时那份汇报是过时的。现在经过阻塞项修复的构建会在收敛后产出一份整合汇报(交付了什么、评审发现哪些阻塞项及如何解决、由此引起的计划与依赖变化);无阻塞的干净构建行为不变、不加额外开销。

底座派子代理(Explore / Agent / Task)时,子代理的嵌套输出(如文件树)不再冒充主线内容:带子代理标识的帧现在会加「↳ 子代理」归属前缀,和主线输出区分开(完整的流拆分仍在打磨,需真机样本)。

构建完成后新增「任务完成情况」总结:即便因异常没跑完,完成卡也会像计划面板那样列出每个任务的最终状态——哪些完成 [x]、哪些受阻 [!]、哪些未完成 [ ],并在未完全交付时标出受阻/未完成的数量。此前完成时计划面板被清空、看不到明细,现在这份总结会留在对话里。

底座(claude)的原生子代理(Explore / Agent / Task)在 UmaDev 里不真跑、且底座整体「变笨」的根因修复:UmaDev 之前只给 claude 预批准了极少数工具(守护模式下只有 Read),导致底座每用一次 Grep/Glob/WebSearch/WebFetch/TodoWrite 或派子代理都要走一轮审批,在交互聊天里还会卡成一次会超时拒绝的暂停——于是子代理被误拒、底座事后编「我没真派」。现在把这些只读/研究类原生工具 + 子代理工具(Agent/Task)都加入预批准,底座在 UmaDev 里恢复和直接用 claude 一样的原生能力(兑现「注入 NOTHING」);Edit/Write/Bash 在守护模式下仍走信任地板,子代理内部的写操作也照样过治理,安全不变。(子代理嵌套输出的渲染归属仍在打磨,需真机帧样本验证。)

多轮对话后触发压缩(自动或 /compact),早前历史会莫名「串」回对话中间、且一个纯提问会被误当成构建任务执行。根因:UmaDev 只压缩了自己那份对话视图,但真正驱动每一轮的是底座常驻会话——它内存里仍是全量未压缩历史,压缩对底座形同虚设,于是底座在陈旧上下文里重吐旧内容(串味)、对提问也照写文件(误当构建)。现在压缩时会像 /clear 一样断开并重开底座会话(但保留同一份存盘对话),让底座下一轮拿到的正是压缩后的转录、不再 resume 全量历史,底座上下文与压缩视图对齐;压缩摘要也明确框定为「背景上下文、只回应用户最新消息」,双重防止被误读成「继续构建」的指令

完整构建不再跳过文档直冲后端代码:默认 /run 走底座自己拟的计划,弱底座常返回后端优先、没有 PM/架构/设计文档步骤的计划,于是不产 output/ 文档、直接写后端。现在无论底座返回什么,deliberate 构建都会确定性地在计划最前插入三份核心文档步骤——PM 写 output/{slug}-prd.md(功能需求 FR-)、架构师写 output/{slug}-architecture.md(API 契约)、设计师写 output/{slug}-uiux.md(设计令牌),前后端代码步骤依赖架构步骤、无法在文档产出前开工;每个步骤的指令还会明确告诉底座把文档写到确切的 output/ 路径,避免写错地方导致卡住。底座仍自主决定实现细节,但文档优先的纪律现在是强制的

多角色构建时任务不再看起来被跳过:计划里彼此独立、依赖都已满足的就绪步骤,此前按下游影响面(blast radius)排序,会先跑下游依赖多的步骤,于是显示上像跳过了前面的任务(反复反馈的现象),而且会在编写测试的步骤之前先写代码。现在改为按计划顺序(从上到下)调度就绪步骤——执行顺序和清单显示一致,也更符合测试先行;DAG 依赖约束不变,步骤永远不会在其前置完成前运行

构建结束时始终打印一份持久的任务总结:以前那个逐任务清单是临时面板,run 一结束就消失,遇到预算 / 门禁导致的异常收尾就看不到多个任务里哪些完成、哪些堵塞、哪些没做完。现在每次收尾(clean / 预算耗尽 / 堵塞)都会往转录里写一份逐任务终态小结([√] 完成 · [~] 进行中 · [✗] 堵塞 · [ ] 未完成),异常收尾也一目了然;中 / 繁 / 英三语。顺带说明:计划是按依赖就绪顺序执行的,某个任务显示还没做不代表被跳过,可能只是还没轮到或预算已耗尽——现在总结会把它的终态讲清楚

焦点切走几分钟再切回窗口后乱码(多屏 Windows):焦点回来时终端(尤其 Windows 控制台、跨多显示器合成器)会用自己的缓冲重绘好几帧,此前只做一次自愈会被随后的终端重绘盖回去、乱码残留。现在把焦点自愈从单帧改成一小段窗口(约 450ms),让我们的重绘成为最后一笔;并对不发焦点事件的终端加了兜底(回来后首次交互也开同样的窗口)

umadev update 升级后检测 PATH 遮蔽:若 PATH 上有多个 umadev(只有第一个生效),升级成功后会列出所有路径并标出生效的那个,提示删除靠前的旧启动脚本——解决升级成功但 --version 还显示旧版的情况(旧 shim 排在 npm-global 之前)

知识检索不再误删内容不同的相邻片段:同一超长小节被切成多个子片段、若它们首行恰好相同(如都以 ``` 代码围栏开头),去重此前按(标题 + 小节 + 首行)判重会把第二个真片段悄悄丢掉。改为按完整正文判重,只有逐字节相同的重复(同一条经验沉淀两次)才折叠,内容不同的一律保留

评审:损坏的安全扫描文件不再被当成没扫过:security-scan.json 若损坏 / 截断,此前和文件不存在一样报没有安全扫描记录,可能把一次真扫到密钥的结果悄悄藏掉。现在区分二者——文件在但解析失败会 Warn 提示重跑扫描,不再读成什么都没扫

部署命令 wait 失败时也清理整个进程组:deploy 的子进程 wait 本身出错(极少见)这条路径此前只靠 kill_on_drop 收直接子进程,detached 的 npx / node 孙进程会漏收;现在和超时分支一样杀整个进程组

检索相关的两处边界:阶段过滤把课程放行的判据从松散子串 lesson- 改成文件名前缀(curated 的 best-lesson-practices.md 不再被误当课程绕过过滤);over-fetch 计算改用 saturating 乘法,避免用户把 top_k 设成离谱大值时溢出

并行测试 / 构建健壮性:Linux 上并行测试写-then-exec 假底座脚本会偶发 Text file busy(ETXTBSY,另一测试的 spawn 在 fork→exec 间短暂继承了写句柄)——对 ETXTBSY 加有界重试根治;跟进 Rust 1.97 工具链的新 clippy lint;修一处只在 Unix 成立的越界路径测试断言(Windows 上 /etc 不是绝对路径),让跨平台 CI 稳定转绿

Windows 输入闪屏根治:经典 conhost 不支持同步输出,为治长流式漂移加的周期性全屏清除心跳,触发条件里带了「最近在编辑」——于是每敲一个键后的两秒内每秒整屏擦一下,打字就闪。现在彻底移除打字触发全屏擦除,同行编辑交给 ratatui 差分(退格会正确写空格覆盖);全屏自愈只在真有流式输出写入时按节流触发,打字 / 静止屏 / idle 一律不擦

GPU 终端(otty 等)鼠标滚动闪屏、滚到底更明显:确认支持同步输出后此前每帧都整屏清除,在 zed 上被同步屏障藏住不可见,但 otty 这类自带 GPU 平滑滚动的终端在每帧擦上会闪(非同步的自带终端反而不走每帧擦、不闪)。现在把每帧擦收紧成同一个门槛——只在真流式输出时按节流擦,滚动 / idle 不再触发

opencode 守护 / 计划模式下编辑被误当拒绝:构建的运行模式在下发时被快照,计划(只读)模式会升级所有非读动作去要审批,而默认运行路径缺少计划模式的只读守卫,于是每次写都被审批地板拒、零源码产出还刷屏。现在续跑与新建两条路径都补上只读守卫,计划模式干净停在只读并提示切到 guarded / auto 执行

危险 shell 命令不再被自动放行(安全):底座把 shell 执行报成 action=bash、真正的命令(rm -rf、curl|sh、dd、git push)在 target 里,而信任地板只看 action,于是这些危险命令在守护 / 自主模式下被当成 bash 自动放行。现在遇到 shell 执行会递归按 target 里的真命令分类,不可逆动作在所有模式(含自主)都拦

泄漏密钥不再被当可合并放行:没装 gitleaks 的机器上(默认),自带 SAST 扫到的硬编码密钥被并进普通发现行,而评审硬拦门只认专门的 secrets 行,于是提交里带 sk_live_ / 私钥仍报可合并。现在把密钥类发现拆成独立 secrets 行,评审据此拦下 PR

深审一批正确性:Rust axum/actix 链式 .route().route() 路由被 handler 窗口吞并、兄弟路由丢失且动词错记,改锚点+边界窗口逐路由归属;运行时证明不再把端口上跑着的外部服务当成自己构建报已验证、e2e 失败会降级、契约路由全 404 也会降级;底座判 greenfield 的全栈应用不再因只有页面关键词被误窄成纯前端而丢掉后端阶段;知识索引写失败不再仍写签名导致读到陈旧索引;curl -o s.sh && sh s.sh 这类先下载再检查再运行的安全写法不再被误当 RCE 拦;id_rsa / credentials 等无扩展名密钥文件补进扫描

Windows 粘贴多行需求不再在回车处截断提交:Windows 控制台把括号粘贴拆成一个个按键(不是 crossterm 的 Event::Paste),粘贴内的换行被当成 Enter 把回车前那段提前提交了。现在事件循环测真实按键间隔,亚毫秒突发(粘贴远快于打字)里的 Enter 判为换行而非提交;仅 Windows,测试与其它平台不受影响

明确的后端任务不再拉 UI 评审角色:底座(尤其较弱的第三方模型)把优化后端代码这类纯后端任务笼统判成 greenfield 时,会 convene uiux-designer + frontend-engineer 白白评审。现在在底座已判构建后,对有明确单领域信号的需求用确定性分类把团队收窄到该领域(后端→架构/后端/QA/安全),不重新路由意图、只收窄团队

缩放控制台窗口不再布局混乱:拖动窗口会连发多帧 Resize、终端跨帧 settle 自己的缓冲,单次污染清屏不够、残留 pre-settle 尺寸的旧单元格。现在 resize 后开一小段(300ms)愈合窗口,每帧清屏重绘盖住整个拖动+settle

TUI 闪屏根治(WezTerm / git bash / 任何界面刷新都闪):(1)每帧全屏清除此前只凭允许名单就做,而 Windows 从不发同步探测确认,在 conpty 不保证 DEC-2026 原子交换时每帧可见地闪——现在改为只在探测真确认同步输出时才每帧清除;(2)非同步终端的 1Hz 全屏重绘心跳此前对所有 Windows 生效,把 WezTerm/git bash/mintty 这些本不漂移的好终端也一起闪——现在收窄到真 legacy conhost(排除 Windows Terminal / MSYS / WezTerm / VS Code / kitty 等);(3)缩短 1.0.38 引入的空闲自愈窗口(12s→3s)。好终端不再闪,conhost 的错乱仍由收窄后的心跳愈合

分析中打字 5-8 秒才显示 → 实时回显:底座分析/思考时会密集不间断地吐 reasoning token,事件循环此前无界地把每一个都排空完才回到 select!,整个 5-8 秒响应窗口内 input 从不被 poll,打字全憋着最后一次性刷出(连选择答案都被批量应用弄乱)。现在给单次排空加上限、满了就回到 select!(input 被 poll),既保留合并渲染又恢复实时响应

opencode(及所有底座)未登录不再硬拦:登录探测对指向本地/第三方模型的底座是假阴性(那种根本不需要 auth login),而产品契约是驱动底座已配置的一切。改为两步软确认——首次给登录提示,同一底座再选一次即可继续进入

codex + Windows + 限制性沙箱开跑前主动提示:codex 的 workspace-write 沙箱在 Windows 会屏蔽网络/dev 端口/git(全栈构建跑不完),且其沙箱辅助进程在部分机器缺运行时会崩(原生弹窗 UmaDev 拦不到)。现在提前提示并指向一条命令 /sandbox danger-full-access

限流/第三方模型(如 claude-code 指向 GLM)下不再“只有第一轮能用”:一次模型错误(高峰限流/过载)会让 --print 持续会话进程退出,而 UmaDev 此前失败后不失效已存的会话 id、下一轮继续 --resume 这个已死会话、底座报 No conversation found 再退出——每轮循环、永久失效,重启只救一轮。现在会话丢失(断管道/进程退出/找不到会话)后立即失效会话 id,下一轮开全新会话并用 UmaDev 自己的对话记录重放上下文,自动恢复

发送前检活:底座子进程若在两轮之间已死,此前要到下一次写入才暴露为原始断管道(Windows os error 232),现在发送前先探活、直接给出“底座会话已结束”的明确原因并走恢复,不把命令写进死管道

Windows 持续会话驱动改用真 claude.exe:此前用 cmd /c claude.cmd 外壳(单发驱动早已避开),会引发 os error 193/232,且 kill 只终止 cmd.exe、把真正的 node claude 变孤儿。现与单发驱动一致直接启动真二进制

os error 232(Windows 断管道,并非 os error 32 的超串)及其本地化文本(“管道正在被关闭”)现被正确归类为可重试的瞬时故障

默认底座静默空闲上限从 600s 提高到 1200s:底座指向限流的第三方模型时会像单独 CC 一样活着静默地内部重试,更长的耐心让它的重试有机会落地而不被过早中断(仍可用 UMADEV_IDLE_TIMEOUT_SECS 调,Esc 随时取消)

Windows TUI 页面切焦点/久置后错乱:非同步输出终端上,焦点切走再回来或久置后屏幕漂移而增量 diff 空转不自愈。新增“刚空闲”的一段自愈窗口配合已有焦点/resize 自愈;急救可随时按 Ctrl+L 或 /redraw 强制重绘

opencode 挂死根治(源头级):opencode 自己的 run.ts 对每个非交互运行都会 deny 掉 question/plan_enter/plan_exit(非交互下没渠道回答,允许提问会让会话永不 idle 导致挂死)。UmaDev 会话 ruleset 之前没 deny 这三个,底座一提澄清问题就阻塞、相位挂死。两档都加上,和官方一致,从源头不让它问

opencode critic 只读 fork 现在能读黑板:之前用全通配 deny 把 read/grep/glob 也拒了,critic 读不了要评审的文件;改成放行读、只 deny 写/bash/交互提问,既能读又保持单写不变量

codex 默认守护路径审批真 bug:UmaDev 回审批发 approved 布尔,但当前 codex(app-server V2)要的是 decision 枚举(accept/decline),approved 字段 codex 没有、必需的 decision 缺失导致反序列化失败。默认档下 codex 对联网/越工作区动作发起的审批此前答不上;现在按官方 serde 类型发 decision

codex 命令实时日志对齐 V2:之前监听的 item/updated 通知 codex V2 根本不发,实时流从不触发;改为监听真正的 item/commandExecution/outputDelta 增量通知

codex 终止事件不再可能丢:stdout 关闭时的终止事件之前用 try_send(槽满会丢),改为阻塞 send 保证送达、立即归因失败

聊天 turn 不再无限挂死:底座(尤其 opencode)在工具运行中帧就进入在工具态,若它其实卡住或在等一个永远等不到的答复而进程一直活着,聊天路径此前无超时兜底会永久空转(工具调用 8684 秒)。现在加了 in-tool 累计静默上限,产出为零达到上限即 settle、控制权还给你(默认 30 分钟,env 可调);合法长构建周期性吐进度自然重置,不受影响

信任模式中途切换现在对正在跑的 turn 即时生效:此前模式在指令下发那一刻被快照,中途 shift+Tab 切换只改显示不改这一轮,导致守护下发再切自主无效、edit 仍被暂停超时拒绝。现在模式是进程级活值、每次授权决策实时读取;切到自主还会立即放行挂起中的审批,被暂停的动作马上继续

greenfield 构建不再在第一步就崩:写文档的 Build 步骤(PM 写 PRD、架构师写架构、设计师写 UIUX)产出的是 output/*.md 文档而非源码,却被源码存在性诚实地板误判为声称有源码却 0 源文件、步骤 Blocked、拖垮整条计划。现在源码地板只对写代码的座位(前端/后端)生效,文档座位由自己的文件证据验收,诚实地板本身不动

底座连接失败能被识别与恢复:现在识别 ConnectionRefused(无空格写法)和 broken pipe / EPIPE,一个连不上端点后退出的底座被归为可重启的瞬时故障、自动重启会话重试,而不是当成无法分类的硬失败直接失败

预览门不再每次误报缺 Prd:前端预览评审物料包漏塞 PRD,而参与座位声明读取 Prd,导致每次 UI 构建都被逐跳交接检查误报缺少输入。补上后不再误报,设计 critic 也拿回真实 PRD 上下文

文档物化解析器三处修正:代码围栏内的 # 注释不再当成标题、中文全角冒号能正确分割数据模型字段、去掉过宽关键词避免被更早段落劫持

/run 主评审路径加 panic 隔离:一个 critic 在畸形回复上 panic 不再击穿并发驱动、中止整个运行,收敛为其空的接受判决

spec 阶段不再误报 build claimed done but no source:底座在 docs/spec 阶段写 PRD/架构/UIUX/SRS 文档时,以前任何工作区写入都被当成写代码构建、触发源码 QC、没代码就误报每回合重复。现在写文档(output/、.md、.umadev/)不再翻成代码构建;只有真写代码才触发,后续真写代码仍会触发,空/未知路径当代码(绝不放过真幻觉),诚实地板本身不动

umadev init 现在像 Claude Code 的 /init 一样理解项目:重执行时检测技术栈 + build/test/lint 命令 + 索引源码,把一个受管的 Project 段写进 CLAUDE.md;重跑只刷新该段,治理前言和你的手改都保留。此前只写死模板、重跑什么都不更新,现在真正分析项目 + 刷新详细索引/进度

第三方低并发底座(如 GLM / open.bigmodel.cn)不再撞 529 访问量过大:UmaDev 是一支团队,常态下可能同时握着多个底座进程(常驻聊天会话 + 后台预热会话 + 构建时每个 critic 各自 fork 的会话),而直连底座永远只有 1 条连接;这些额外并发连接超过第三方网关的小并发配额,就被 529 全拒、每回合都炸。新增全局底座调用并发闸(base_gate):每次真正打底座的回合都先拿一个许可,默认并发=1,和直连底座完全一样的足迹 -- 接入即用,任何底座、零配置

强底座提速开关:官方高并发端点的用户可设 UMADEV_BASE_CONCURRENCY=4 恢复 critic 并行 + 预热加速,是给进阶用户的隐形开关,普通用户永远不用碰

并发闸工程细节:许可为单次回合粒度、结构上不可能自锁;预热用 try_acquire 拿不到就跳过、绝不阻塞你的回合;聊天 firmware 本就是 Light 档(仅身份),单次调用不因此变重

座位能力卡(Seat Card):每个座位(PM/架构/设计/前端/后端/QA/安全/DevOps)有一张 typed 自描述能力卡,声明它 owns 什么、reads 哪些契约输入、produces 哪些产出;roster 自描述,每次交接都成为显式可校验的契约

每跳交接校验(双向):座位运行前即比对声明的输入/产出与黑板现状 —— 缺声明输入(错位)或没产出其负责的 artifact(规格缺口)都在交接处折进 verdict 暴露,不再变成下游谜团,活在评审流里

两层 artifact 物化:把散文文档里的决策抽成 typed 契约(数据模型/设计令牌/验收标准)emit 到 .umadev/contracts/,与 API 契约并列,接进文档阶段

verdict 结构化溯源:评审结论可带来源座位 + 关联 artifact + 诊断说明,由确定性标注器填充(不采信底座自述),打回更可诊断、审计链可重建;serde 向后兼容

artifact 版本化 → DAG 陈旧失效:黑板文档带内容版本;跨会话改了 PRD/架构/UIUX 后 resume,消费该文档的步骤及下游自动翻回待办、对着变更后的上游重新推导,不信任被静默污染的旧结果

mac 长会话每秒闪屏根治:1.0.30 为 Windows conhost 防漂移加的 ~1 秒周期性全屏重绘,在不支持「同步输出」的 Terminal.app 上就是每秒闪一下 —— 现把这个心跳限定到 Windows,mac / Linux 靠增量重绘 + 事件驱动自愈(想彻底无闪无漂移可用 iTerm2 / WezTerm / kitty / Ghostty 等支持同步输出的终端)

自学习踩坑计数不再卡住:复现索引此前用原始签名建 key、却用归一化签名查找,归一化逻辑加入前存下的老记录永远匹配不上、频次冻结(反馈的「已踩 17 次」不再增长);改为索引也归一化 + 同签名保留最高计数条

长转录滚动锚定不再漂移:转录超过 8000 行渲染上限触发 front-trim 后总行数被封顶,上滚锚定静默失效、阅读位置被新内容顶走;补上 front-trim 增量补偿,长流式下上滚看历史位置稳住

同一 diff 不再显示两遍:底座可能在文本叙述与结构化工具调用里各带一次同一处修改(或 opencode 工具分片两个 id);加防御护栏,连续出现的完全相同 diff 折叠为一张(不同修改仍各自成卡)

跨平台 CI 转绿:doctor claude-hook 测试接受「已注册但命令不解析」;TUI meta 行测试锁英文 + 加宽;终端模式 / 路径 / fork 计时等平台假设测试按平台门控;修 Windows 构建 unused-import / dead-code(-D warnings)

鼠标选中 → 剪贴板复制正式生效:拖选文字经 OSC52 复制到系统剪贴板(含 tmux 透传)+ conhost 控制台守卫,随本版发布(此前已实现但未随 1.0.30 上线)

启动时后端日志不再全屏抢屏:spawn 本地 dev-server / 后端时经新的 detach_from_controlling_terminal(Unix setsid / Windows CREATE_NEW_PROCESS_GROUP)脱离控制终端,直接写 /dev/tty 的后端日志(Spring/Logback、Maven/npm 进度条)不再绕过管道画花整屏

Windows 长时间运行界面不再错乱:经典 conhost 上每帧全重绘的安全网够不着,长会话累积漂移永不被擦;现在非同步路径按 ~1 秒心跳周期性全重绘,漂移活不过心跳(同步输出终端不受影响)

/stop-preview 真的停了:此前只杀 npm/pnpm 外壳,占端口的 node/vite 孙进程还活着(报「已停止」却是假的);现在杀整个进程组(setsid 让预览成组长,Unix killpg / Windows taskkill /T),连孙进程一并清,退出清理同样修正不留孤儿。另修 Windows 本地服务启动的 cd 前缀路径解析

输入手感对齐 Claude Code:输入框内的文字现在可直接拖选 + 复制(独立应用内选择层,软换行不断 / 硬换行保留 / CJK 安全,不用切 /mouse);↑/↓ 像 CC 一样召回历史 —— 光标在首行按 ↑ 即调上一条已发内容(草稿暂存、↓ 还原),多行历史改 JSON 持久化不再被拆散

守护模式:提问真的会停下等你答 —— 交互式 TUI 里 park 住会话真等你回答、再用答案 resume 同一会话(此前提问后马上跳过、连问 3 次),无头 / run 完全不变绝不阻塞;守护模式对有后果的写 / shell 逐项审批(账本记住不重复问);ExitPlanMode 显示 plan 全文、标成「底座的计划模式」与守护模式区分;新增 /questions text 文字提问开关

界面不再闪 / 每隔几十秒常刷:80ms 动画 tick 此前会在已稳定 / 上滚看历史的画面上每 80ms 强制整屏清屏重绘,现在只在真有活的东西时(思考 spinner / 运行中任务 / 取消中)才绘制,静止对话保持安静;大缓冲上滚也不再每格强制清屏(删掉 scroll_jump_repaint);内部 eprintln 诊断改走 tracing,stderr 不再污染界面帧

上下文余量表不再超 100%:此前给窗口探测传的是空模型名,codex 一律吃 128K 兜底、显示 186K/128K —— 现在优先用底座自己上报的上下文窗口 → 探测到的真实模型窗口 → 才回落后端默认,余量表随真实模型走

会话连续性(流式路径):流式路径此前手搓 stream-json 参数丢了会话旗标、每轮冷启动新底座会话丢累积上下文;现在复用与非流式 complete() 完全相同的会话矩阵(首轮 pin session-id、后续精确 resume),「一个连续会话」在流式路径也成立

预览对齐真实框架:/preview 与自动预览过去起的是 UmaDev 自带的轻量验收 harness node 服务;现在识别该 harness 并把预览路由到项目真实框架子目录(如企业级 Vue 单仓的前端子工程)去跑真正的 dev server

深层目录扫描:源码 / 覆盖 / 前端调用 / 后端路由四类扫描深度 8→16,企业级 Vue / Java 大树不再漏扫、不再给 QA 喂空 / 半截证据(加强地板,文件数上限不变)

检索会自我调优:内置知识库检索按每一步成败给知识块打有用性、上浮有用的下沉没用的(叠加在 BM25 / 向量 / RRF 之上,不改既有排序器),补齐自进化三件套(经验从失败学、配方从成功学、检索从是否真帮上忙学);检索反馈只在真实构建路径落盘,修一处轻路径回归

交付证据不再造假:deliberate 构建过去在收尾时回填 TODO 模板的 PRD / 架构 / UIUX 文档桩(还带假的 FR-001 编号),让 FR 覆盖检查跑在假输入上、形同虚设 —— 现在不再伪造:缺哪份核心文档就在证据包 / 评分卡里如实标注「未产出」;且 deliberate 构建的 PM / 架构步骤前置要求真产出带 FR- 的文档(在确定性地板上验证),文档是真做出来的、不是事后补的桩

评审不能橡皮图章:review 步修复轮之后,若还有被确定性地板(治理扫描 / 契约 / verify)佐证的残留阻塞问题,该步不再静默通过、会折进最终门 —— 但 critic 的纯主观意见仍只作参考、绝不据此判失败,守住「评审只咨询、地板主管」的原则

记忆不再腐坏:事实被本轮运行明确反证(值变了 / 路径已不存在)就降级、不再误导后续;新学到的经验若与旧经验直接矛盾,保留更有效力的那条、压下另一条 —— 都非破坏性(留档可追溯)、且保守(弱信号绝不误删好记忆)

延续深层引擎自审:不加一个可见的 UI 功能,只让内核少信一次自我陈述、多一分可证伪;全部确定性、fail-open、有界,非破坏性(墓碑 / 降级 / 压制均留出处),不改运行控制、四条治理不变量或验收 / 覆盖 / 门禁地板

评审看得到构建过程:critic 评审席位现在 fork 真实的构建对话(--resume --fork-session,原生只读),而不是从零开始的新会话 —— QA / 安全 / 架构评审能看到 doer 看到的一切来判断,而不是只看产出的文档摘要;写入永远碰不到父会话,plan 许可模式 + Read/Grep/Glob 白名单是两道原生只读栅栏(仅 claude,codex / opencode 保持各自现有的只读 fork)

计划可以重规划:某一步被卡住(Blocked)且会连累一整片后续子任务时,协调者做一次有界的重规划 —— 用被阻塞步 + 类型化缺口证据 + 搁浅子树让底座给出绕过 / 解决阻塞的替换子计划,过同样的归一化与验收地板后并入继续,已完成的步绝不重跑;严格每轮最多一次,失败 / 无改善则回到诚实的「已阻塞」上报,不循环、不掩盖真死路

绿构建不再只信底座的话:底座在散文里写「已跑测试、全通过」不再被直接采信 —— 现在只有本轮工具调用流上真观测到一次构建 / 测试 / lint 命令作佐证时,才跳过 UmaDev 自己的复核;只是嘴上说通过就触发 UmaDev 亲自跑一遍验证,但绝不误判:无佐证一律去真跑(真正干净的构建照样再次通过)、从不据此判失败

失控轮次保护:按任务深度给底座会话一个宽松的轮次上限(快速改动 / 构建 / 深度构建分层,评审咨询上限很低),防止极端情况下无限打转,正常构建远远够用

观测底座回传的 control_response / init 事件(不再静默丢弃);经确认 UmaDev 对 claude 的驱动本就是持久双向 stream-json 会话 + 带内许可通道,故无传输层重写、只做安全的加法式升级;全程 fail-open、有界、确定性,治理不变量与确定性地板不变

自进化闭环接入默认路径:lesson 的信任分随每步验收结果升降、pitfall 复原后标记解决、真复发时触发反思策略、交付时做记忆和解 —— 此前这些只在旧的单发路径跑、主线的总监循环是死代码,于是真实路径上信任永不更新、pitfall 永不标记解决、反思永不触发;记忆从「捕获+频率+召回」变成真进化,每条都是总监已算出的验收结论的副作用,借脑一律只读 fork + fail-open

效力闭环:lesson 按「是否真防住复发」赚取召回位置 —— 被召回后通过记有用票、被召回却仍复发记有害票,证明有用的上浮、没用的沉底,有毒的(样本够后)从召回中剪除但留盘做溯源;效力成为衰减分里的第五个乘性轴,喂给固件踩坑摘要、逐步召回与 coach 重排

成功配方记忆:干净交付后把赢的打法(通过的步骤顺序/席位/关键脚手架/模式)蒸馏成跨项目可复用配方,下次同技术栈规划时作为可采纳的先验注入(「过去一次干净构建用过这个形状,合适就采纳、不是模板」)—— 从只从失败学,变成也从成功学;配方是先验、绝不是门禁

席位从换名字的提示词变真专家:per-seat 知识路由让前端席抽前端/设计知识、安全席抽安全/合规知识、后端席抽后端/API/架构知识、QA 席抽测试/性能知识,每个席位带自己专业的工作方法清单 —— 同一步换个席位就是不同知识 + 不同方法(测试证明是席位在驱动)

per-seat 确定性地板:后端步自动要求真实路由/契约、QA 步要求测试真通过、前端步要求治理/构建干净;过半构建步仍缺强约束时判定大脑整体欠指定、给每个裸构建步补默认可证伪约束,全部复用既有验收契约、不新增门禁语义

endpoint 验收对照真实后端路由注册(Express/Koa/Fastify/NestJS、Flask/FastAPI/Django、axum/actix、gin/Spring…)判断接口是否实现,而不是路径字符串在源码里任何地方出现过就算 —— 杜绝前端 fetch() 调用就当后端已实现的假通过;零可检测后端注册的纯前端项目 fail-open 回落旧行为、绝不误判为失败

Linux glibc 兼容性:linux x86_64 二进制此前在 Ubuntu 24.04(glibc 2.39)上普通 cargo build、于是绑定 GLIBC_2.39,在 RHEL / Rocky 9、Ubuntu 22.04 及任何 glibc 2.31–2.38 系统上以「GLIBC_2.39 not found」一启动就失败(一位 glibc 2.34 的用户被挡住);现两个 linux 二进制都改经 cross(Ubuntu 20.04 基础镜像 / glibc 2.31)构建,凡 glibc >= 2.31 皆可运行,并加一道 CI 守卫:一旦二进制再需要更新的符号即让发布失败,这类回归无法静默发货

移除 /model:模型 100% 是底座的事,UmaDev 不拥有任何模型端点 —— 底座登录 / 配置成什么(含第三方或本地模型)跑的就是什么,注入的是空;内置 /model 选择器 + 精选模型清单(opus / sonnet / haiku…)错误暗示 UmaDev 在管模型、且对接了自定义 / 本地模型的用户根本是错的,故整套删除(含 --model 旗标),要换模型请在你的底座 CLI 里配置;保留底座自身模型的只读展示与上下文余量表

Ctrl+J 换行,不再误提交:多行输入不再在 Apple Terminal / 默认终端上悄悄误发 —— Ctrl+J 在每个终端都能换行,并开启 kitty 键盘协议让 Shift+Enter 在支持的终端上也生效;Enter 仍提交

多语言代码高亮:代码块从手搓 ~5 语言的关键词着色升级为纯 Rust 的约 25 语言真词法高亮(字符串 / 注释 / 数字 / 关键词,含多行),配色随主题 token、无硬编码色值,每次调用 fail-open 回落旧着色

交互式 /model 选择器:/model 空参打开选择器(按底座列常见模型带描述,外加一行自定义 id);/model <id> 与 /model plan|build 仍直接生效,经既有配置路径持久化

Ctrl+点击打开链接 / 文件路径:Ctrl+左键命中转录里的 URL(仅 http/https)或存在的文件路径直接打开;opener 始终是 argv 向量,Windows 用 explorer 使查询串里的 & 无法注入命令

底座失败给下一步:底座 CLI 失败(认证过期 / 限流 / 过载 / 上下文超长 / 网络)时不再甩原始报错,而是点名下一步命令(claude auth login / codex login / opencode auth login / /model / /compact)

渲染自愈成为原语,根除乱码类:启动时经 DECRQM 探测终端是否真支持同步输出(250ms 超时回落白名单先验,终端应答双向覆盖);已确认支持的终端上每一帧都是同步括号内的原子整帧重绘 —— 造成长跑 / 焦点切换 / 叠字乱码的显示漂移活不过一帧且无闪烁;不支持的终端经一个污染标志在离散转换点自愈;旧的周期刷洗与逐事件强制重绘整套删除

输入两路收敛,根除 Windows 输入类:unix 与 Windows 输入路径共用同一张键位映射表,配 9 组跨路径契约测试(退格 / 方向键 / Home-End / Ctrl / F 键 / 焦点 / 粘贴 / 滚轮 —— 同一输入必产同一事件,未来分叉是 CI 挂掉、不是发到用户手里);ESC 冲刷定时器粘贴态感知(平时 50ms / 粘贴中 500ms),被劈开的粘贴结束标记不再卡死、旧兜底删除;终端模式启用收敛为一个幂等块、启动与恢复共用,配启用 / 还原对称性测试;契约测试当场揪出并修好 macOS / Linux 上一直坏着的 Alt+退格删词

Windows 焦点切换乱码(用户实测):焦点上报此前从未启用、事件循环也无处理臂 —— 现启用 DEC 1004 并在焦点回来时强制一次干净整帧重绘,alt-tab 切走再切回不再乱

会话历史随会话保存:看得见的转录(工具行 / 计划卡 / 评审结论 / 备注)随聊天持久化并在重开 / resume 时逐行重建 —— 重开 UmaDev 不再是一片空白的对话;旧会话文件回落全文播种,坏行安全跳过、加载绝不因此失败

外部终止也还原终端:SIGTERM / SIGHUP / 关终端窗口现同步保存聊天并还原终端,外部 kill 后不再留下坏 shell

续跑历史标记:继续被阻塞的运行会插入'──── 继续运行 — 更早的步骤在上方(向上滚动查看)────'分隔线,先前步骤与续跑输出读作一段连续历史

跑测试前先把依赖(含 dev / test 附加项)一次装齐,不再上演'跑 pytest → No module named pytest → sync → 重试'的来回:一次运行里的缺模块报错被当成漏装依赖、不是测试失败;专门点了 uv 的坑(默认 uv sync 不含 dev 附加项 → uv sync --extra dev / --all-extras);固件指令 + error_kb 识别 + 知识标准三管齐下、只在构建 + 验证路径生效

长跑不再乱码:一次长时间流式运行结束后不再留下互相叠字的转录与冻住的'本轮已中止'页脚 —— 在运行落定的边沿与转录换基 / 收缩时强制一次干净整帧重绘(此前只覆盖输入框);稳态粘底流式增长不重绘、不抖动,每种终端都生效

评审阻塞现在给解决建议:某个评审席位打回时,除指出哪里不对,还逐条给出'怎么修'与下一步('/run 让团队应用这些修复,或 /revise <指引>')—— 同一次评判轮产出、不额外调大脑;RoleVerdict 加 remediation 通道与 blocking 按下标对齐;advisory + fail-open,缺失就照旧显示、绝不编造

第三条持久记忆通道 —— OPEN-DECISIONS 悬置项登记册:未决 / 推迟 / 受阻 / 等待未来触发的事项落进 docs/decisions/OPEN-DECISIONS.md(提交进仓库、只追加、就地解决、分三类),每次任务开始自动回灌进底座上下文并带'(N 条未决 + M 条已解决)'摘要,悬而未决的事再也不会丢;与 facts.jsonl(持久事实)、lessons(踩坑)并列

全部改动 fail-open / 确定性 / 门控到对应路径;+知识标准 x2(依赖先装、悬置项登记,quality 95)+23 测试;计数 agent 1137 / tui 697

Windows 上退格能删字了(Windows Terminal / ConPTY:0x08 BS 与 0x7f DEL 都归一到 Backspace)—— 用户实测'删不掉'的真修复;Windows 默认走原生 crossterm 输入后端让 Esc / 方向键都认得;Alt-退格删除前一个词

帮助浮层 Down/PgDn 夹取到真实底部(不再'按住下键再上看着像卡住')+ Home/End/g/G 跳转;前向 Delete 与整行 / 整词删除在 token 变化时,重新弹出被关掉的 @ 提及浮层

质量评审裁判有据可依:把有界、已排序的真实测试 + 源码文件清单注入评审上下文,它真正看见并据此评判,不再凭空断言'没有测试 / 后端 / 源码'触发冤枉返工;移除粗糙的事后过滤(按文件数丢弃 blocking / 强制 accept)与过宽的后端分类器,裁判意见仍 advisory、确定性地板主导

Coach:CURRENT.md 复用已渲染的阶段正文(一次渲染、字节完全一致)

对外文档整体同步 + 去味:说清 UmaDev 是什么而非不是什么,清掉只有内部才懂的'总监 / director'框架与 AI 营销腔;新定位标语(指挥你已经在用的 Claude Code / Codex / OpenCode)铺开到 README / 文档 / 官网,事实与功能不变

host / agent / governance 测试改用 RAII 守卫还原环境变量(杜绝跨测试 env 串味);临时文件走 tempfile 路径;文案更正为'三个宿主 CLI 底座'

更凝练的定位:UmaDev 指挥你已经在用的 Claude Code / Codex / OpenCode 干活(README / 文档 / 官网 / npm 全量铺开)

Windows 预览开发服务器能起来了(此前 sh 硬编码、npm.cmd 找不到、彻底死掉);/preview 与 web 构建后的自动预览都通了

不可逆命令信任地板认得 Windows 动词(del / rd / format / Remove-Item),Auto 档不再跳过确认

Windows 控制台不再花屏:历史召回 / clear 后强制整帧重绘;/exit 与 /quit 不再让 PowerShell 不可用(完整逆序终端恢复);拖入的图片路径不再被反斜杠当转义吞掉

新增 PTY 启动冒烟拉起真二进制 + windows 测试转绿,启动崩溃再也无法静默发布

致命退化:1.0.17/1.0.18 一启动就 panic、应用完全无法运行 —— tokio::select! 的分支表达式每轮都会被求值(if 守卫只控制是否 poll、不阻止求值),取消-drain 分支在 1.0.17 的 M1 修复里被从惰性 async 块改成了直接函数调用 drain_cancelled_task(cancel_drain.as_mut().expect(…), …),于是空闲时 cancel_drain 为 None、启动第一轮循环即 .expect() panic;现改回惰性 async 块、仅在守卫为真真正 poll 时才访问 cancel_drain,并新增 PTY 启动冒烟验证。请所有 1.0.17 / 1.0.18 用户尽快升级到 1.0.19

每步可证伪的证据契约(前沿 F1):'完成'不再是粗粒度的整仓检查 —— 大脑在计划 JSON 里逐步声明证据(文件存在 / 含某串 / 构建干净 / 测试通过 / 路由响应),UmaDev 解析并拥有,任一 gap 即该步未完成、且精确指出缺哪个文件 / 测试 / 路由;空证据回落既有验收(fail-open)

不确定即失败关闭的不可逆动作边界 + 连败熔断(前沿 F3):一个躲过 token 扫描的混淆命令(base64 解码管道进 sh、eval $(...)、内联 -c 解释器、\x 字节串)此前在 Auto/Guarded 被静默放行 —— 现归为 Reversibility::Uncertain、每档都强制升级确认、绝不记忆自动放行;另加连败熔断(同类构建 / 评审验证连失 3 次即收尾,不再磨到 32 步上限,且不假报成功)

裁判开全新独立只读会话(更深的 F2):此前 claude 经 --resume + --fork-session、codex 经 thread/fork 分叉,只读裁判继承了 doer 的全部推敲(maker-checker 推理泄漏);现 claude 起全新 --session-id(无 resume / fork)、codex 经 thread/start 开只读新线程,裁判在宿主层就在真正干净的上下文上评审,F2 prompt 防火墙变双保险

注入的记忆增量手册字节有界(前沿 F4):记忆层本就是去重蒸馏的增量手册(非原始 episode、按频率 × 新近排序、聚类成高层规则),但 relevant_lessons_for_prompt 只限条数不限字节 —— 直接注入的调用方(runner / director_loop)会被 3 条肥增量撑爆上下文;现加 3000 字硬预算,高分优先、溢出丢低分、必要时截断单条,对每个调用方按条数 + 字节双重有界

KV 缓存稳定的固件前缀钉死 + 计划进度复述(前沿 F5):固件本就稳定块在前、易变块在后(逐块确定性排序、前缀里无 HashMap 迭代 / 时间戳),现加模块文档 + STABLE→VOLATILE 边界注释 + 锁测试钉死字节级前缀不变;另加有界的一行计划进度复述('M 步已完成 N 步;接下来:后两步标题')串进每轮 / 每次返工指令,长多步构建里底座不再跑偏

doctor 检测缺失 CLAUDE_CODE_OAUTH_TOKEN(用户反馈 401):claude login 后探测显示已登录,但 UmaDev 非交互跑 claude --print 要的是 headless 凭证、否则运行时 401 —— 现 claude-code 底座无 headless 凭证给 WARN + 指引 claude setup-token,有则 PASS,其它底座不误报

本地 fp16 语义 RAG 复活:本地模型出 384 维向量但 VectorStore 钉死 1536 维、search 拒掉每个查询且守卫抓不到 —— 每次 npm install 静默只跑 BM25、宣传的本地语义层从不生效;现按真实嵌入宽度打标 + 读本地后端真实 hidden_size,端到端 384 维一致,本地双轨 RAG 真正可用

复制 / 粘贴 + 输入卡死根治(用户反馈):粘贴结束标记被 50ms 的 lone-ESC flush 劈开时输入框会永久吞键(退格 / 方向 / ESC / 历史全死)—— 现两个分支都在字符边界安全地识别并闭合粘贴;输入框拖选选不中时加一次性三语提示指向 Shift+drag / /mouse

底座长进程日志可见 · /logs(用户反馈):一个开关串流底座的多分钟构建 / 进程输出 —— 此前 codex 的 item/started·updated 帧被忽略、多分钟 Maven/Spring 构建期间零输出;开启后立即显示运行指示 + 增量串流,完成上限 200 字放宽到 16KiB,默认关

AskUserQuestion 桥接到用户(用户反馈):底座自己 headless 跑提问、渲染不了选择器会静默自动取消 —— 现渲染问题 + 每个编号选项 + 提示「回复你的选择,会转发给底座、在等你回答而非取消」,回复作为下一轮续进同一会话,三家底座通用

记忆不丢(双保险之一·持久事实):新增 .umadev/memory/facts.jsonl —— 底座发现的项目事实(JDK17 在哪个路径、构建 / 测试命令、环境约束)每轮注入固件头部,无论转录被裁剪还是底座自己上下文轮换都还在,从此永不重新查找(根治用户实测的「记了又重查」)

记忆不丢(双保险之二·智能压缩):token 超预算时把早期轮次在只读 fork 上做结构化摘要(意图 / 涉及文件 / 关键决策 / 错误修复 / 待办 / 当前工作),近期尾巴逐字保留,替掉过去有损的 16 条 FIFO + 160 字 /compact;完整逐字转录始终落盘、/resume 无损还原、连续 3 次摘要失败即熔断 fail-open

写文档不再烧 token:借底座大脑先判「写一份文档 vs 做文档描述的那个产品」—— 写 PRD / 设计文档 / 调研报告是轻触(至多 1 席产品经理过目),不再上 8 席团队 + 多轮评审 + 完整流程;真做文档平台 / 产品的构建一字不变(has_heavy_signal 守住)。并修了源码存在性地板 —— 它过去对纯文档伪报「无代码失败」、逼底座去写本不需要的代码白烧多轮,现已文档感知。根因是之前脑判了意图却仍用关键词表给构建定规模,现在大脑定规模为主、关键词只兜底

开发团队架构做实 · Wave A 智能席位建造:完整构建按 router 自动判定逐角色真建造(产品 → 架构 → 设计 → 前后端 → QA → 安全 → DevOps,每角色真建自己那摊),小任务仍走单轮便宜路径 —— 全自动判,不让用户选

开发团队架构做实 · Wave B 角色真产物:design-tokens 升为一等交付物 + DesignTokensPresent 验收;契约优先 DAG(前后端依赖架构师先定的契约);QA 先写测试(测试作者≠代码作者,结构性去偏)

API 报错不再被静默吞掉:底座限流(429)/鉴权/网络/过载等错误会直接显示真实错误文案 + 可操作提示(如"未登录,运行 claude /login""限流,稍后重试或 /model 切换"),不再假报"完成 / 无文件变更"

codex 沙箱可配:.umadevrc 加 [codex] sandbox_mode,可设 danger-full-access 解锁本地端口(npm start)/git 提交;默认仍 workspace-write 保底,高危模式开机红字警告

界面跑久了错乱:渲染自愈(同步输出内定期原子重绘 + 睡眠唤醒/resize/SIGCONT 自愈),不用再按 Ctrl+L;resize 不再闪烁

/status 弹窗可用滚轮滚动(之前小窗口截断滚不动);/plan 现在显示完整团队评审(不再只给 +N)

命令统一:palette/help/dispatch 同一注册表(/model 等全可搜,以后不再漂移)+ Ctrl+O 一键展开/收起所有折叠内容

/continue 恢复底座会话带回完整上下文(不再"不记得上次任务");Ctrl+C 不再误退

Ctrl+C 不再退出 UmaDev:它是复制的通用肌肉记忆,误按一下就退出太容易丢会话。现在 Ctrl+C 只清空半截输入 / 提示用 /quit,绝不退出;要退出用 /quit、/exit、Ctrl+D 或双击 Esc

/continue 跨会话续接:之前 /run 跑过、关掉 TUI 再打开,用 /continue 只会提示重启。现在它会自动加载持久化的 plan.json,重新贴出计划(已完成的步骤打勾)、只跑剩余步骤续上,不用重头再来

界面跑久了显示错乱 / 刷新撕裂(Windows 尤其明显):抄 Claude Code 的做法,用 DEC 2026 同步输出把整帧原子刷新 —— 终端缓冲整帧再一次性交换,刷新中途不再出现半成品的错乱画面;按终端类型检测支持(iTerm2 / WezTerm / ghostty / kitty / Windows Terminal 等,跳过 tmux)

滚动时输入框出现乱码 + 假的「本轮已中止」:鼠标滚动的 SGR 序列在高负载下偶发被劈碎,ESC 被当退出键、其余进了输入框。现在加了防御式过滤,识别并丢弃被劈碎的鼠标序列,真正的 Esc 和正常输入不受影响

Ctrl+L / /redraw 强制全屏重绘 —— 万一画面还是花了一键恢复;窗口 resize 时清屏(某些终端 resize 后留残影);长路径 / Tab 裁切到可视宽度,不再溢出串行

【1.0.11 回归 · 重要】滚轮滚动不再破坏输入 / 假中止:OSC11 主题探测线程残留抢 stdin、把鼠标滚动序列劈碎,导致输入框出现乱码、假的「本轮已中止」、滚动卡顿。已彻底移除该探测线程

/status 现在真反映进度:之前只写了状态文件、但 /status 弹窗读的是内存里从不更新的阶段表,所以一直全 pending。现在 /status 对账 workflow-state.json,阶段表推进到真实进度

计划真正一步步推进:每步硬限定单步、不再一回合做完整个项目;表头显示当前步;单回合到预算就收尾(不再无限跑);长回合有心跳

底座出错能看到原因(聊天 + /run 构建两条路径都接上):底座配置 / 登录坏了时它的 stderr 报错 + 退出码会显示,不再只是「base session idle」;codex 握手加超时

团队评审每个 critic 的意见都能看:之前只显示第一个、其余折叠成 +N 无法查看;现在每条完整镜像进可滚动的对话历史,折叠行提示滚动 / /plan 看全部

滚轮滚动 + 鼠标拖拽复制都能用(对标 Claude Code):备用屏上鼠标滚轮直接滚回历史,拖拽选中文字应用自绘高亮、松开即复制 —— 本地走 pbcopy / xclip / wl-copy(任何终端都行,含 macOS Terminal.app),远程才用 OSC52;/mouse 可切回终端原生选择

/status 现在反映真实进度:之前 /run 跑完写了真实代码,但状态机停在 research、9 阶段全 pending(只有 legacy 路径更新状态文件)。现在 director 循环同步写 workflow-state.json(按角色诚实映射阶段、单调不回退、只在真干净时才报交付),/status 跟着真实进度走

计划不再卡 0/N:底座以前一个回合就把整个项目做完、计划一小时不动。现在每步提示硬限定单步(别做其它步、本步验收达成就停),计划真正一步步推进;表头显示当前进行的步号 + 长回合有心跳;单回合也加了总时长上限(到预算就收尾,不再无限跑)

底座出错能看到原因:底座配置 / 登录坏了时它的报错只进 stderr(以前被丢弃),用户只见「base session idle」。现在 idle / 退出时显示底座自己的报错(如 model X not available)+ 进程退出码;codex 持续会话握手加了超时,坏底座不再永久挂起

/run 需求可带空格 / 中文:之前第一个词被误当 slug,任何带空格或中文开头的需求被拒。现在只有带 - / _ 的纯 ASCII 词才算 slug

大段粘贴卡顿(O(n²)→O(n))· 上方向键召回到 / 命令后失效(现在继续召回,不被斜杠面板劫持)· Esc 取消冻 UI 2 秒 · 历史召回丢草稿 · 复制带多余符号 / 空格 · 一批越界与状态同步加固

图片输入:把图片拖拽 / 粘贴进输入框,自动识别成 [图片 N] 附件,提交时改写成底座能读的 @绝对路径(底座自己读文件,UmaDev 不做 base64);非图片粘贴照常按文本处理

codex 在 Windows 持续会话不可用:sandbox 枚举发成了 camelCase(workspaceWrite),新版 codex 只认 kebab-case(workspace-write / read-only),报 unknown variant 直接挂掉,已对齐

彻底不管模型:UmaDev 不再向底座传 / 切换模型,底座永远用它自己配置或登录的模型(官方订阅,或你接入的第三方 / 本地都行);/model 不再切换,只说明模型在底座侧配置

统一模型下载:之前国内拿 f32(~448MB)、国外拿 fp16(~224MB)大小不一致 —— 现在国内外都从 HuggingFace / hf-mirror.com 下同一个 f32,体积一致;GitHub fp16 降为兜底

工具命令不再被模型下载阻塞:umadev update / --version / --help / doctor 等不再触发 224MB 模型下载(之前模型没下完时连 update 都卡住);进度条美化(块字符 + 颜色 + 实时 MB/s)

本地向量模型分发:1.0.7 时 224MB 的 fp16 模型超过 npm 体积上限被拒(npm 用户只能用 BM25)。现在模型作为 GitHub Release 附件分发,首次启动自动下载到 ~/.umadev/embed-model(带进度条),装完完全本地、运行时无需联网;国内自动走 hf-mirror.com(HuggingFace 国内镜像,免费、快、稳)、全球走 HuggingFace / GitHub,带实时进度条,任一源失败自动换下一个并降级 BM25,UMADEV_MODEL_BASE_URL 可覆盖

纯本地双轨 RAG 真正落地:向量轨用 multilingual-e5-small(fp16)经 candle 在本地运行——无需 API key、运行时不联网;与纯 Rust BM25 经 RRF 融合 + HyDE 查询扩展;model_dir 自动发现 ~/.umadev/embed-model,零配置生效。摆脱臃肿的云端依赖,让 AI 真正写出最懂你业务的代码

等待指示器随底座活动动态变化:不再从头到尾死板的「正在思考」——调用工具时显示「正在读取 / 正在编辑 / 正在运行 / 正在搜索 / 正在检索」,工具一结束立刻回到思考

真实 token 消耗:等待指示器显示底座自己上报的真实累计用量(本次会话),不再是字符估算,格式如 ≈12K token

三底座适配收尾(F1-F6):opencode 改代码渲染 diff 卡 + 合并工具兜底 + 回复不重复;codex 真实 usage(对照真实协议修正)+ send 不阻塞 + 早期 ESC 不丢;claude 真实 usage

意图判断与统一构建:默认对话界面由底座自己的模型判断每句话——对话 / 解释 / 小改 / 调试 / 构建;底座连不上就走最轻路径,不用关键词表。取消「对话 vs /run」的分叉:触发完整流程的是「真实构建」本身,不是某条命令——对话里随手提的构建,和 /run 享有同一套系统;底座也会以行动判断,写下第一个文件就把这一回合变成一次构建

统一的常驻系统:每次真实构建都自动拥有——设计系统 / 反 AI 模板法(每个干活回合都在,无延迟成本)、构建后治理 + 设计扫描、角色团队评审(产品 / 架构 / UI-UX / 前端 / 后端 / QA / 安全,只读分叉、并行、建议性)、知识库摘要、以及从每次运行学习(记录踩坑,在后续工作里召回)。小改动召集精简 UI 团队(设计 + 前端 + QA),完整构建召集全员

/goal 命令:`/goal <目标>` 驱动一次目标导向的构建,让底座持续工作到目标达成,带完整的统一系统;三个底座(claude / codex / opencode)都可用(UMADEV_NO_GOAL_MODE=1 可退出)

知识库内置进二进制:完整语料(418 份商业级工程规范 + 设计规则 + 你现有代码的结构图)随包内置,首次运行自动解压到 ~/.umadev/knowledge——零配置下发到每个用户项目,不再是用户机上的空语料

检索与代码库理解:知识检索用 BM25(中文友好双通道分词)+ 可选向量层(OpenAI 或本地嵌入)+ RRF 融合;另有逐语言符号扫描(repo-map)给底座你现有代码的结构概览

深读 Claude Code / opencode 源码整体修 TUI 交互:解耦「活着感」与吐字;修无滚动 / 无鼠标 / 小终端裁切 / opencode 不流式 / 静默阻塞等 P0 问题

运行中可在空隙排队输入,ESC 中断当前工作,底座工具调用可见;运行锁单写者收敛

新增 Windows on ARM(win32-arm64)支持 —— 骁龙 / Surface 等 ARM 架构的 Windows 现在会自动安装 x64 二进制,经 Windows 11 内置 x64 模拟运行;`npm install -g umadev` 不再报 unsupported platform

1.0.4 的底座 .cmd 启动修复随本次全平台重编一并带入,Windows(含 ARM)的 claude / codex 识别 + 运行彻底打通

全链路版本锁定:Cargo crate、npm 包、二进制 `--version` 三者同号;新增 `bump-version.sh` 一键改版脚本,杜绝「装 1.0.5 终端却显示 1.0.0」

修复 Windows 下「找到底座却启动失败」的问题 —— 报错 `os error 193 / 不是有效的 Win32 应用程序`。npm 安装的 claude / codex 是 `.cmd` 垫片,不是 PE 可执行文件,CreateProcess 无法直接运行;改为经 `cmd /c` 启动(Rust 官方文档标准做法)

同一套程序解析统一覆盖底座 CLI、npm 操作(audit / install / uninstall)与构建步骤(npm / tsc / cargo),凡 `.cmd`/`.bat` 一律 `cmd /c`

修复 Windows 下识别不到底座的问题 —— npm 安装的 Claude Code / Codex / OpenCode 是 .cmd 垫片,此前裸名解析只认 .exe 导致检测失败;现按 PATHEXT 正确解析为 .cmd / .exe / .bat 全路径

npm 操作(audit / install / uninstall)与构建步骤(npm / tsc / cargo)同步适配 Windows,统一走同一套程序解析

修复部分环境安装后二进制无法执行(EACCES)的问题 —— npm 多包分发中转会剥掉可执行位,启动器现在运行前自动恢复 chmod +x,对所有平台兜底

全平台 npm 一键安装:Windows / Linux / Intel Mac / Apple Silicon Mac 均可 `npm install -g umadev`,按系统自动分发对应预编译二进制

随包内置离线知识库,无需额外配置即可检索

完整 9 阶段商业交付流水线:research → docs → spec → frontend → backend → quality → delivery,含文档确认、预览确认两道人在环确认门

三种本机 CLI 底座:Claude Code、Codex CLI、OpenCode —— 直接驱动你已登录的 CLI 并共享它自己的模型与推理强度,UmaDev 不持有任何 API key

并行扇出:文档阶段并发起草架构与 UI/UX,缩短交付墙钟时间

UIUX 一致性硬门 + 反 AI-slop 设计法:命名禁令(默认 indigo / 紫渐变 / emoji 图标 / 模板骨架)与设计 token 纪律,不符合声明设计系统的 UI 自动打回重做

失败开放治理内核:写入前 hook + CI + 质量门补扫,禁 emoji 图标 / 硬编码颜色 / AI 套话;合规映射 SOC 2 · ISO 27001 · EU AI Act