这一版有四条主线。性能专项让多开窗格、并行编译不再拖垮整机。新增多设备,可以连接服务器或其他电脑上的 CC-Panes。资源库统一管理 MCP 与技能。界面整体打磨得更像原生应用。另外,对话分叉、Agent 对话、WSL 路径和启动可靠性也有一批修复。
新增
- 多设备:左侧新增「设备」视图,可以连接另一台机器上的 CC-Panes。
- SSH 服务器:桌面端一键部署 headless
cc-panes-web(systemd 用户服务,没有 systemd 时回退 nohup),经 SSH 隧道访问。 - 其他电脑:通过局域网或 Tailscale 直连,用 6 位配对码换取设备令牌。
- 设备卡片显示在线状态、版本、claude/codex 安装状态、对方的工作空间和运行中的会话。对方的会话可以直接作为标签开在本机窗格里,也可以在对方项目上新建会话;会话由对方机器启动,MCP、技能、记忆都按对方配置注入。设计见
docs/111-multi-device.md。 - 「性能」设置面板:把 15 个性能开关收在一处,默认只开低风险项。
- 新会话注入构建并行度环境变量(
CARGO_BUILD_JOBS、MAKEFLAGS等),默认为核数减 8,用户已有的设置不覆盖。本地、WSL、SSH、Codex 行为一致。 - Codex 托管会话默认关闭动画和自动 recap,运行中状态条的重绘从每 32 ms 一次降到每 1 s 一次。
- 隐藏窗格停泊:隐藏 30 秒后卸载 xterm 实例,只保留 6 个热实例,切回时从恢复快照重建。隐藏的 WebGL 上下文最多保留 6 个,按 LRU 逐出。冷恢复时重放串行执行,前台标签优先。
- 资源管理器 2.0:整机负载高时列出会话之外的高占用进程。每个会话可以切换「正常 / 让路 / 效率模式」,策略降级的原因可见。占资源多的标签亮琥珀点,点击直达。
- 重负载命令台账与门禁:
- 自动记录各会话里耗资源的命令(hook 加边沿触发采样,空闲时不采样),资源管理器新增「最贵命令」标签。
- 新增
cc-panes-ctl run [--heavy] -- <cmd>。门禁默认关闭;开启后重命令先向 CC-Panes 申请槽位再执行,排队状态显示在标签上,并自动注入ccpanes-heavy-run技能。 - Windows 会话超过 Job 内存通知水位时,标签和资源管理器给出提示,构建不会因此失败。
- WSL 会话放进 systemd scope(CPUWeight / MemoryHigh),资源管理器显示真实的 cgroup 读数。
- 资源库:左侧新增资源库,统一管理 MCP 和技能。
- MCP 按启动档管理,支持粘贴配置添加,内置发现市场。
- 技能页替代原来的技能市场入口;技能市场精选收录 vercel-labs/agent-desktop(桌面 Computer Use)。
- 对话分叉:终端会话和 Agent 对话都能分叉成独立对话。分叉的改动可以对比后采纳,并附带任务验证证据。
- Agent 对话:
- 对话时间线导航和书签;问题卡、截图附件预览、文件变更撤销、文件标签预览。
- 持久记录、完成验收、整轮检查点。
- 接入 Codex App Server,CLI 与 Agent 两种形态共用。
- 右侧面板:加入 Cursor 式对话,视图图标改为最右侧竖栏。
- 会话审阅与浏览器:
- 新增会话审阅、worktree 启动。
- 浏览器支持 Computer Use 和标注,内容标签统一;新增置顶的紧凑浏览器小窗。
- Codex 任务技能,以及显式的桌面草稿交接。
- MCP 新增
open_terminal_tab:AI 可以在窗格里开一个普通 shell 终端标签。 - 终端:
- 右键菜单重新整理,新增分叉会话、复制和深度链接。
- 可选自动信任已登记的项目,Claude 不再按目录、按账号逐个弹信任确认。
- 状态栏显示会话费用估算。
- 工作空间:项目清单改为按机器分段的
.ccpanes/projects.yaml。工作空间放在网盘里被多台机器共用时,每台机器只改写自己那一段。 - 资料空间(实验功能,默认关闭):提供模板和 skills,一键创建并拉起素材助手。
- 原生手感:
- 设置改为独立的原生窗口;支持系统强调色;macOS 使用 vibrancy,Windows 使用 Mica。
- 确认框改用系统对话框;图标按钮的 title 改为 Tooltip;文件树和工作空间树支持 type-ahead 按键定位。
- 去掉转场动画和手形光标,启动时不再闪烁。
- 启动后回到上次的工作现场;首页改为启动器。
- 活动栏、标题栏、状态栏和侧栏整体收窄;侧栏改为 Codex 式的简洁风格;布局卡片收成两行。
修复
- WSL:
- 新增零依赖 crate
cc-panes-paths,作为路径归一化的唯一来源,前后端共用同一张用例表。会话归属匹配按发行版隔离;WSL UNC 路径不再被整体转成小写。 - 启动失败时记为 failed 并撤回预发的 resume id。默认发行版启动后回写实际的发行版。
- 令牌不再写进启动脚本或 Codex 的 argv,改走
WSLENV。会话注入CC_PANES_DATA_DIR,hook 能看到实际的数据目录。 - macOS 终端右键菜单打不开。
- 切回标签后终端输出出现缺口;watchdog 不再把有意的断流当成故障。
- 启动 CLI 时顶替当前活动的空白终端标签,空态页不再残留。
- MCP 打开的浏览器标签落在没在看的布局里时报 unknown browser tab:现在会在后台补建原生 webview。
- 资源库 MCP 页点「发现」后没有返回入口:滚到市场区后,按钮会变成「回到我的服务器」。
- 布局卡片太多时浏览不到后面的布局。
- 工作空间:拒绝过期的快照覆盖注册表;迁移前校验路径;
projects.yaml解析失败时先留底再覆盖。 - 历史恢复、删除语义和设置重置的归属更严格;设置编辑串行化;编辑器草稿不再丢失。
- Agent 审批与进程生命周期、取消与并发提交、恢复与任务重试流程补齐。
- SSH 凭据检查移出 UI 线程,SSH 和 daemon 不再做破坏性重试;Web 访问退出时保留共享的 daemon 会话。
- 主窗口关到托盘或最小化时,WebView2 进入隐藏态,只为显示服务的前端轮询暂停。
- daemon 和 cc-panes-web 的 tokio worker 数限制在 2 到 8 之间。daemon 建会话前重读设置(最多每 2 秒一次)。WebGL 上下文丢失后 60 秒内最多重试 3 次。
- Windows 上仓库快照、ACP 并发写入,以及若干测试的失败。
兼容说明
- 数据库升级到 v42:v40 新增
heavy_commands表,v42 新增启动失败相关的列。 - 旧的
.ccpanes/projects.csv在本机第一次写入时并入projects.yaml,并入后删除;不属于本机的行归入unattributed段,不会丢弃。 SessionStatusInfo新增若干可选字段,旧 daemon 不发送时为空。新的 daemon 路由在旧 daemon 上返回 404,界面显示「不支持(daemon 过旧)」。- 老的
config.toml没有[performance]段时,全部取默认值。 - 发布产物新增 Linux 服务端包
cc-panes-web_<版本>_linux-<x86_64|aarch64>.tar.gz(附.sha256),供设备部署使用,要求 glibc ≥ 2.35。 - 发布构建启用 fat LTO 和单 codegen unit。
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