修复 Issue [#64] 中可由 CC-Panes 控制的启动、终端观察、身份与交互问题,并补齐发布前跨层审阅发现的遗漏。随后一轮实机排障解决了终端画面偶发停住的根因,并为 Codex 新的全屏 transcript 模式补上与 Grok 一致的按进程注入。
修复
- CLI 设置可立即编辑;检测超时或失败不再令页面空白,也不会误禁用启动入口。迟到检测结果仍可更新。
- MCP/REST 派工支持独立 cwd 与本次权限覆盖;local、WSL、SSH 各自使用真实工作目录,历史与接管恢复保留该目录,工作空间配置身份保持独立。
- Claude
/clear清理旧身份后重新接收 SessionStart 身份;同步 hooks 的 clear matcher,并阻止旧用量和旧 resume 身份回灌。 - Claude MCP 配置只回收明确退休超过 7 天的文件,保留活跃、未知旧配置和 Pi 文件。
- 终端纯文本观察处理有界 VT 重绘;单行 slash 使用原生键入,多行保留 bracketed paste;等待权限优先采用结构化信号。
- leader 重新注册清除旧失败状态;线程创建失败返回错误或降级,不因单次后台任务创建失败直接 panic。
- 提升九套主题的光标和选区可见性,并增加可选覆盖设置。
- 修复文档站诊断记录链接触发的构建死链。
- 终端画面偶发停止更新、需右键刷新才恢复:桌面端到 daemon 的 REST 请求改为 HTTP keep-alive 连接复用,不再每次请求新建短连接;后台或休眠的终端视图不再每 2 秒查询 daemon,
get_all_terminal_status改为页面级合并并缓存 1.5 秒。此前多会话下每秒约 29 条短连接把本机端口堆满(WSAENOBUFS 10055),WebSocket 掉线后反复全量重放把渲染主线程占死。排障记录见docs/bugs/daemon-socket-churn-terminal-stall.md。 - WebView2 渲染进程报告无响应时自动重载页面(120 秒冷却),不再只记一条日志。
- 终端恢复快照携带 delta 起点的 PTY 尺寸与窗口内 resize 点,前端按当时尺寸重放;Ink 等按列宽差量重绘的 TUI 不再把残帧堆进 scrollback。旧 daemon 不带尺寸时回落按当前尺寸整写。
- 终端输出视图缩小时保留最近文本与 Unicode 字符,MCP
get_session_output读到的纯文本不再被截坏。 - 使用统计扫描同一文件重复解析失败只告警一次,之后降为 debug,不再每天写几千条 WARN。
- 移动端布局镜像同时读取 0.12.11 之后按布局空间保存的快照与旧
default快照并取较新者;此前只读旧 id,拿到的是升级前停更的陈旧布局。
新增
- Codex 托管会话默认按进程注入全屏 transcript 模式(
-c tui.fullscreen_transcript=true,Codex 0.158 起的「TUI mode」),adapterOptions.screenMode可选scrollback/inherit;本地与 WSL 一致,不改写用户~/.codex/config.toml,与 Grok 的处理方式对齐。 - 发布版也把终端 watchdog、渲染器切换、WebGL 上下文、resync 与 recovery 事件限频落盘到
cc-panes.log([terminal-diag]前缀),正式版里的停住不再只能靠性能采样反推。 - cc-panes-web 新增
GET /api/sessions/:id/recovery-snapshot,返回 checkpoint + delta 恢复快照(结构化 404,epoch 以字符串下发,旧后端回落纯 delta)。 - 移动端可运行于 iOS,并提供基础 iPad 自适应布局(宽屏切换为侧边导航栏)。
- 可选的完成任务收窗,默认关闭且逐会话启用;只有完成摘要、真实 PTY 退出与可读归档输出齐备才收窗,不终止会话。
- 完成终端输出有界保存供回看,旧 daemon 缺少退出/留存证据时保持自动收窗禁用。
兼容说明
- 数据库 v39 增加可空 launch_cwd,保留旧观测记录与旧客户端更新。
- Claude 自身 jobs/adopt/respawn 及宿主 OOM 的外部问题不宣称完全解决。
macOS 安装说明
由于应用未经 Apple 签名,macOS 可能提示"文件已损坏"或"无法验证开发者"。请使用以下任一方式解决:
方式一:系统设置(全版本可用) 先双击打开一次(会被拦截),然后打开"系统设置 → 隐私与安全性",在底部找到被阻止的应用,点击"仍要打开"。
方式二:终端命令
:::bash
xattr -cr /Applications/CC-Panes.app
注意:旧教程里的"右键 → 打开"绕过方式在 macOS 15 Sequoia 已被系统移除,请使用上面两种方式。
Linux 安装说明
Deb 包(Ubuntu/Debian):
:::bash
sudo dpkg -i cc-panes_*.deb
sudo apt-get install -f # 安装缺少的依赖
AppImage:
:::bash
chmod +x cc-panes_*.AppImage
./cc-panes_*.AppImage