cc-remote v5.3.6

cc-remote v5.3.6

中文

改善文件路径提示和图片文件预览的使用体验。

• 文件路径提示在鼠标停留 500 毫秒后显示，避免鼠标路过时遮住正文；键盘聚焦和点击打开文件仍即时响应。
• 居中和侧边预览中的长图默认按面板宽度从顶部显示，方便直接阅读；仍可缩小查看整张图片。
• 修复图片打开时先显示完整小图、再瞬间拉宽的闪动，第一次显示即使用正确的尺寸和位置。
• 提高触控板双指缩放的响应幅度，保留触屏缩放和 Safari 手势去重处理。

通信协议保持 v85，Claude Agent SDK 保持 0.2.174。从 v5.3.5 升级无需协议或 SDK 迁移。更新 Relay 和各台 Wrapper 后刷新 Web/PWA 或重新打开 Desktop。

cc-remote update --check --version 5.3.6
cc-remote update --version 5.3.6

普通 Wrapper 更新保留独立 Claude 会话服务；仍在 Wrapper 内运行的侧聊及排队消息需先完成。发布包含六个平台的 Relay/Wrapper 包、install.sh 和 SHA256SUMS，没有新的 Desktop 或移动端安装包。

English

Improve file path tooltips and image file previews.

• Show file path tooltips after 500 ms of hover to avoid covering text as the pointer passes over a link; keyboard focus and file opening remain immediate.
• Open tall images at panel width from the top in centered and docked previews, while retaining zoom-out to see the entire image.
• Prevent the initial flash of a smaller image before width fitting; the first visible frame uses the correct size and position.
• Increase trackpad pinch response while preserving touchscreen zoom and protection against duplicate Safari gesture streams.

Wire protocol remains v85 and Claude Agent SDK remains 0.2.174. Upgrading from v5.3.5 needs no protocol or SDK migration. Update the Relay and each Wrapper, then reload Web/PWA or reopen Desktop.

cc-remote update --check --version 5.3.6
cc-remote update --version 5.3.6

Ordinary Wrapper updates preserve the independent Claude session service. In-process side chats and queued messages must finish before activation. The release includes six platform-specific Relay/Wrapper bundles, install.sh and SHA256SUMS, with no new Desktop or mobile installer.

cc-remote v5.3.5

cc-remote v5.3.5

中文

修复居中和侧边图片文件预览无法双指缩放的问题。

• 支持电脑触控板、手机触屏双指放大／缩小，放大后可拖动查看。
• 切换居中与侧边布局时保留缩放比例；调整面板大小时约束图片位置，打开另一张图片时重置视图。
• 避免 Safari 同时发出多种手势事件时重复缩放。保留 SVG 安全处理、GIF 动画和图片解码错误提示。

通信协议保持 v85，Claude Agent SDK 保持 0.2.174。从 v5.3.4 升级无需协议或 SDK 迁移。更新 Relay 和各台 Wrapper 后刷新 Web/PWA 或重新打开 Desktop。

cc-remote update --check --version 5.3.5
cc-remote update --version 5.3.5

普通 Wrapper 更新保留独立 Claude 会话服务；仍在 Wrapper 内运行的侧聊及排队消息需先完成。发布包含六个平台的 Relay/Wrapper 包、install.sh 和 SHA256SUMS，没有新的 Desktop 或移动端安装包。

English

Fix missing pinch zoom in centered and docked image file previews.

• Support trackpad and touchscreen pinch zoom, with panning while enlarged.
• Preserve zoom when switching presentation, constrain image position when resizing the panel, and reset the view for a different image.
• Avoid double zoom from overlapping Safari gesture streams. Preserve SVG sanitization, animated GIF playback, and image decode-error feedback.

Wire protocol remains v85 and Claude Agent SDK remains 0.2.174. Upgrading from v5.3.4 needs no protocol or SDK migration. Update the Relay and each Wrapper, then reload Web/PWA or reopen Desktop.

cc-remote update --check --version 5.3.5
cc-remote update --version 5.3.5

Ordinary Wrapper updates preserve the independent Claude session service. In-process side chats and queued messages must finish before activation. The release includes six platform-specific Relay/Wrapper bundles, install.sh and SHA256SUMS, with no new Desktop or mobile installer.

cc-remote v5.3.4

cc-remote v5.3.4

中文

修复会话误隐藏、历史合并、缓存竞争和阅读位置跳动，并简化输入区、状态提示与手机会话列表。

• 支持 Codex 原生压缩历史，保留会话、置顶、模型和思考强度，压缩前后消息 ID 保持一致。解压放在后台线程，避免阻塞其他会话输出和停止操作。
• 原生 Codex App 恢复压缩会话后，正确识别运行状态与只读控制；子代理详情和旧版代理卡片能读取压缩记录，显示正文、工具过程及完成状态，并排除继承的父会话内容。
• 修复 Claude 已完成答案短暂消失和后台回复顺序错乱；失效会话仍可取消置顶。
• 缩短历史缓存写事务，避免并发读取时的锁竞争和旧扫描覆盖新索引。
• 自动收起过程详情时保留正在阅读的正文位置；修复已经到底却仍显示置底按钮、键盘滚动受阻，以及切换输入法时正文出现焦点横线的问题。
• 主聊与侧聊移除引导／排队切换按钮。运行中，Enter 或点击发送用于补充当前任务；桌面端 Tab 将本次输入排队，输入法和补全操作保持优先。后台任务弹层移除重复标题及关闭按钮，可点击外部或按 Escape 收起。
• 状态提示收进 idle 左侧，支持展开查看、关闭和成功后自动消失。外观提供紧凑／舒展会话排布，多账号紧凑列表以框外圆点区分账号，悬浮标题查看完整目录。
• 手机长按放大会话并稳定显示操作菜单，点击外部先收起菜单，仅当前会话常显三个点；同时修正手机引擎名称、路径浮层配色和中文标点旁的加粗链接渲染。

升级

通信协议保持 v85，Claude Agent SDK 保持 0.2.174。从 v5.3.3 升级无需协议或 SDK 迁移。更新 Relay 和各台 Wrapper 后，刷新 Web/PWA 或重新打开 Desktop。历史缓存可按需重建，原生会话记录保持不变。

cc-remote update --check --version 5.3.4
cc-remote update --version 5.3.4

普通 Wrapper 更新不会重启独立 Claude 会话服务；仍在 Wrapper 进程内运行的侧边聊天和排队消息需先完成。

发布包含六个平台的 Relay/Wrapper 包、install.sh 和 SHA256SUMS，由 GitHub Actions 完成回归、平台导入检查和 attestation。没有新的 Desktop 或移动端安装包。

English

Fix hidden sessions, history merging, cache contention and reading-position jumps, and simplify chat controls, status feedback and the mobile session list.

• Read native compressed Codex histories while preserving sessions, pins, model/effort settings and stable message IDs. Decode in background threads so other sessions and Stop commands remain responsive.
• Restore native activity and read-only control when the Codex App resumes a compressed thread. Read compressed subagent details and legacy cards with their text, tool activity and completion status, excluding inherited parent context.
• Prevent completed Claude answers from briefly disappearing and background replies from appearing out of order. Allow stale sessions to be unpinned.
• Keep history scans outside cache write transactions and reject stale index updates, reducing contention during concurrent reads.
• Preserve the visible text when process details collapse after a response. Correct bottom-button and keyboard-scroll boundaries, and remove the transcript focus line triggered by input-method switching.
• Remove the steer/queue switch from main and side chats. During an active turn, Enter or Send adds input to the current task; desktop Tab queues that input, with composition and completion taking priority. Background-task panels close on outside click or Escape without a duplicate heading or close button.
• Place expandable, dismissible status feedback beside idle, with automatic dismissal for success. Offer compact and comfortable session layouts, account dots outside compact rows, and full directory paths on title hover.
• Enlarge mobile rows on long press, keep menus stable, dismiss the menu before the sidebar on outside taps, and show persistent menu buttons only for the selected session. Correct mobile engine labels, path-tooltip contrast and bold links beside Chinese punctuation.

Upgrade

Wire protocol remains v85 and Claude Agent SDK remains 0.2.174. Upgrading from v5.3.3 needs no protocol or SDK migration. Update the Relay and each Wrapper, then reload Web/PWA or reopen Desktop. Derived history caches rebuild as needed; native transcripts remain unchanged.

cc-remote update --check --version 5.3.4
cc-remote update --version 5.3.4

Ordinary Wrapper updates preserve the independent Claude session service. In-process side chats and queued messages must finish before activation.

The release includes six platform-specific Relay/Wrapper bundles, install.sh and SHA256SUMS, with GitHub Actions regression tests, platform import checks and attestation. It includes no new Desktop or mobile installer.

cc-remote v5.3.3

cc-remote v5.3.3

中文

修复 Claude 在原生终端与 cc-remote 之间切换时的状态显示、侧边聊天重连，以及回退后的界面和历史同步。

• 模型与思考强度选择对齐原生账号设置；从 CLI 恢复会话后，Remote 正确识别会话持有者。终端正在处理、结束或被 Ctrl+C 打断时，界面同步对应状态。
• 修复侧边聊天修改思考强度后重连时重复使用 fork 会话 ID 的问题，保留已经确认接收的消息，不自动重发。
• 回退成功后关闭弹窗；CLI 后续修改设置或发送新消息时，已回退的旧问答不再重新出现。
• 修复 Claude 首次回复前切换引擎，再切回来时，同一条用户消息偶尔显示两次的问题。
• 流式输出时可用键盘向上离开底部，到底后恢复跟随；Linux 桌面端的引擎切换快捷键调整为 Alt+1/2/3。

升级

通信协议保持 v85，Claude Agent SDK 保持 0.2.174。从 v5.3.2 升级无需协议或 SDK 迁移。更新 Relay 和各台 Wrapper 后，刷新 Web/PWA 或重新打开 Desktop。已有 Claude 历史缓存会按需重建，原生会话记录和图片等资源保留。

cc-remote update --check --version 5.3.3
cc-remote update --version 5.3.3

模型和强度遵循原生 CLI 的账号默认值规则，不新增官方尚未提供的逐会话持久化能力。普通 Wrapper 更新不会重启独立 Claude 会话服务；仍在 Wrapper 进程内运行的侧边聊天和排队消息需先完成。

发布包含六个平台的 Relay/Wrapper 包、install.sh 和 SHA256SUMS，由 GitHub Actions 完成回归、平台导入检查和 attestation。没有新的 Desktop 或移动端安装包。

English

Fix Claude session state across native CLI and Remote use, side-chat reconnects, and UI/history synchronization after rewind.

• Align model and effort choices with native account settings and track ownership when a CLI resumes another session. Mirror terminal activity, completion and Ctrl+C interruption.
• Avoid reusing a fork reservation when reconnecting a side chat after an effort change. Preserve accepted inputs without automatically resubmitting them.
• Close successful rewind dialogs and keep removed messages out of the active history branch when the CLI changes settings or sends another prompt.
• Prevent a new Claude prompt appearing twice when switching engines before its first response.
• Allow keyboard scrolling away from streaming output and resume following at the bottom. Linux desktop engine shortcuts become Alt+1/2/3.

Upgrade

Wire protocol remains v85 and Claude Agent SDK remains 0.2.174. Upgrading from v5.3.2 needs no protocol or SDK migration. Update the Relay and each Wrapper, then reload Web/PWA or reopen Desktop. Derived Claude history caches rebuild as needed; native transcripts and binary assets are preserved.

cc-remote update --check --version 5.3.3
cc-remote update --version 5.3.3

Model and effort follow native account-default semantics; this release does not add per-conversation persistence absent from the native CLI. Ordinary Wrapper updates preserve the independent Claude session service. In-process side chats and queued messages must finish before activation.

The release includes six platform-specific Relay/Wrapper bundles, install.sh and SHA256SUMS, with GitHub Actions regression tests, platform import checks and attestation. It includes no new Desktop or mobile installer.

cc-remote v5.3.2

cc-remote v5.3.2

中文

修复 Claude 刷新或重新打开会话后，文件列表全部显示“差异未保存”的问题。原生会话记录中已经保存的完整文件差异，现在可以在历史中正常查看。

• 从原生记录的正确位置读取 Edit/Write 差异，兼容结果中缺少文件路径的情况，并恢复连续多次编辑后的累计差异。
• 自动重建旧的 Claude 历史缓存，保留原生会话记录、图片等资源及其他引擎的缓存。
• 缺少原始证据、工具执行失败，或文件中途被 Bash 等未记录操作覆盖时，继续显示差异不可用；无法确定归属的批量结果也不会错误关联到某个文件。

升级

通信协议保持 v85，Claude Agent SDK 保持 0.2.174。从 v5.3.1 升级无需协议或 SDK 迁移。更新 Relay 和各台 Wrapper 后，刷新 Web/PWA 或重新打开 Desktop，重新读取历史即可恢复有完整记录的差异。

cc-remote update --check --version 5.3.2
cc-remote update --version 5.3.2

从 v5.3.0 或更早版本升级时，还需遵循 v5.3.1 发布说明中的 SDK 服务升级要求，以及对应的协议迁移要求。普通 Wrapper 更新不会重启独立 Claude 会话服务。

发布包含六个平台的 Relay/Wrapper 包、install.sh 和 SHA256SUMS，由 GitHub Actions 完成回归、平台导入检查和 attestation。没有新的 Desktop 或移动端安装包；发布本身不切换线上服务。

English

Fix Claude file lists incorrectly showing “Diff not saved” after refreshing or reopening a session. Complete file patches already stored in the native transcript are now available in historical turns.

• Read native Edit/Write patches from the transcript envelope, retain the tool's file path when the result omits it, and restore cumulative diffs across consecutive edits.
• Rebuild old Claude history caches while preserving native transcripts, binary assets and other engines' caches.
• Keep missing evidence, failed edits and patch chains broken by unrecorded operations such as Bash overwrites unavailable. Ambiguous batched results are not assigned to an arbitrary file.

Upgrade

Wire protocol remains v85 and Claude Agent SDK remains 0.2.174. Upgrading from v5.3.1 needs no protocol or SDK migration. Update the Relay and each Wrapper, then reload Web/PWA or reopen Desktop. Reading history again restores diffs with complete native evidence.

cc-remote update --check --version 5.3.2
cc-remote update --version 5.3.2

Upgrades from v5.3.0 or earlier must also follow the SDK-service instructions in the v5.3.1 notes and any applicable protocol migration requirements. An ordinary Wrapper upgrade does not restart an independent Claude session service.

The release includes six platform-specific Relay/Wrapper bundles, install.sh and SHA256SUMS, with GitHub Actions regression tests, platform import checks and attestation. It includes no new Desktop or mobile installer. Publishing does not deploy services.

cc-remote v5.3.1

cc-remote v5.3.1

中文

修复 Codex 历史加载后问答顺序错乱，以及补充回答先显示原文、加载更多历史后才变成问答气泡的问题。

• 合并缓存、实时记录和历史页时，保留原生用户消息修正后的时间戳，并围绕共享消息身份排列缺失记录，避免提问与回答倒置、工具记录移动到后续正文之后。
• 完整的补充回答首次加载就显示问答气泡，加载旧历史和恢复缓存后保持一致。“已回答”状态仍需匹配唯一的前置原生提问；截断或不完整内容保留原文。
• Claude Agent SDK 从 0.2.157 升到 0.2.174。账号隔离启动对齐新版 SDK 的会话状态握手，保留显式配置，继续使用用户配置的日常 Claude Code CLI。

升级

通信协议保持 v85，从 v5.3.0 升级无需协议迁移。更新 Relay 和各台 Wrapper 后，刷新 Web/PWA 或重新打开 Desktop。

cc-remote update --check --version 5.3.1
cc-remote update --version 5.3.1

本次改变 SDK 固定版本。使用独立 Claude 会话服务的安装，需要先让原生任务、后台工作和待授权请求结束，再按会话服务升级流程协调升级服务与 Wrapper。普通 Wrapper 更新不会替换仍在运行的 SDK 服务；不要跳过 SDK 版本校验或强行重启忙碌的服务。从更早协议升级仍需按 v5.3.0 发布说明协调迁移。

发布包含六个平台的 Relay/Wrapper 包、install.sh 和 SHA256SUMS，由 GitHub Actions 完成回归、平台导入检查和 attestation。没有新的 Desktop 或移动端安装包；发布本身不切换线上服务。

English

Fix Codex question/reply order after history loading and supplemental answers changing from raw text into a question/answer bubble only after loading older history.

• Preserve refined native user-message timestamps when merging cached, live and historical records. Interleave missing records around shared message identities so questions stay before their replies and tools stay beside the relevant commentary.
• Render complete supplemental answers consistently from the first page through cache restoration and pagination. Answered receipts still require one unambiguous preceding native question; truncated or incomplete content retains its original text.
• Upgrade Claude Agent SDK from 0.2.157 to 0.2.174. Align the account-isolated transport with the SDK session-state handshake, retain explicit settings and continue using the configured daily Claude Code CLI.

Upgrade

Wire protocol remains v85. Upgrading from v5.3.0 needs no wire-protocol migration. Update the Relay and each Wrapper, then reload Web/PWA or reopen Desktop.

cc-remote update --check --version 5.3.1
cc-remote update --version 5.3.1

The SDK pin changes in this release. Installations with an independent Claude session service must let native turns, background work and pending callbacks finish, then coordinate the service and Wrapper upgrade using the session-service procedure. An ordinary Wrapper upgrade does not replace a running SDK service. Do not bypass version checks or restart a busy owner. Earlier wire protocols still require the coordinated migration described in the v5.3.0 notes.

The release includes six platform-specific Relay/Wrapper bundles, install.sh and SHA256SUMS, with GitHub Actions regression tests, platform import checks and attestation. It includes no new Desktop or mobile installer. Publishing does not deploy services.

cc-remote v5.3.0

cc-remote v5.3.0

中文

新增 Claude Code 回退功能：在历史用户消息旁点击“回退”，或输入 /rewind 选择消息，再确认恢复到发送这条消息之前。支持多轮历史中的位置以及第一条消息之前的空对话。

• 提供“恢复对话和文件”“仅恢复对话”“仅恢复文件”三个选项。长消息折叠后可展开，手机端保持圆角确认按钮可见。
• 检查原生能力和文件检查点，拒绝忙碌或已经过期的确认，避免重连后重复回退；对话与文件的部分成功会分别说明。
• 回退结果在刷新及其他客户端中保持一致。仅请求端会把原消息放回空白输入框，保留已有草稿；仅恢复文件不改变对话。

文件恢复使用 Claude Agent SDK 的公开 rewind_files 接口；对话恢复使用经过能力探测的原生 CLI 控制接口，并非公开的 Python SDK 方法。不支持的运行时会明确拒绝。文件检查点不覆盖任意 shell 操作，被记录文件后续的手工修改可能被覆盖。此功能限 Claude Code，Codex、DSH 与 Work 不显示回退入口。

升级

通信协议从 v84 升到 v85，Claude Agent SDK 保持 0.2.157。需要协调 Relay、所有 Wrapper 与 Web/PWA：完成依赖 Wrapper 进程的任务和排队请求，停止不兼容的旧 Wrapper，更新 Relay/Web，再更新各 Wrapper，最后刷新 Web/PWA 或重新打开 Desktop。

cc-remote update --check --version 5.3.0
cc-remote update --version 5.3.0 --allow-protocol-change

该开关表示已安排协议迁移，不会自动升级其他设备。独立 Claude 会话服务保留运行；私有 BTW、进程内会话和排队任务仍需先结束。参见部署指南。

发布包含六个平台的 Relay/Wrapper 包、install.sh 和 SHA256SUMS，经过 GitHub Actions 回归、平台导入检查和 attestation。没有新的 Desktop 或移动端安装包；发布本身不切换线上服务。

English

Add Claude Code rewind from a historical user message or /rewind. Select a message and confirm restoration to the point before it was sent, including older turns and the empty conversation before the first message.

• Choose conversation and files, conversation only, or files only. Long prompts expand within a bounded area; rounded confirmation buttons remain accessible on phones.
• Probe native capability and file checkpoints, reject busy or stale confirmations, and prevent duplicate mutations after reconnect. Report partial conversation/file results separately.
• Preserve the restored conversation across refresh and other clients. Only the requesting client prefills an empty draft; existing drafts remain intact. File-only restore leaves the conversation unchanged.

Files use the public Agent SDK rewind_files method. Conversation restore uses a capability-probed native CLI control, not a public Python SDK method; unsupported runtimes reject the operation. File checkpoints do not cover arbitrary shell effects and may overwrite later manual edits to tracked files. This feature is limited to Claude Code, excluding Codex, DSH and Work.

Upgrade

Wire protocol advances from v84 to v85; Claude Agent SDK remains 0.2.157. Coordinate Relay, all Wrappers and Web/PWA: finish Wrapper-owned work and queued requests, stop incompatible Wrappers, update Relay/Web, update each Wrapper, then reload Web/PWA or reopen Desktop.

Run cc-remote update --check --version 5.3.0, followed by
cc-remote update --version 5.3.0 --allow-protocol-change in an independent terminal. The flag acknowledges coordinated migration; it does not update other devices automatically. Independent Claude services remain running, while private BTW, in-process sessions and queued work must drain first. Follow the deployment guide.

The release includes six platform-specific Relay/Wrapper bundles, install.sh and SHA256SUMS, with GitHub Actions regression tests, platform import checks and attestation. It includes no new Desktop or mobile installer. Publishing does not deploy services.

cc-remote v5.2.2

cc-remote v5.2.2

中文

修复多个 Claude 子代理连续完成时，返回链接挤到同一段回复、后续回复缺少对应链接的问题。

现在以主会话实际接收结果的时点关联返回链接；任务完成状态仍即时更新。历史记录会纠正旧实时数据和缓存里的链接位置、进度标题，刷新、切换会话及展开详情后仍保留正确归属。

升级

通信协议保持 v84，Claude Agent SDK 保持 0.2.157。从 v5.2.0 或 v5.2.1 升级无需协议迁移：

cc-remote update --check --version 5.2.2
cc-remote update --version 5.2.2

本次修复同时涉及 Wrapper 和 Relay 的 Web 客户端，请更新 Relay 及各台设备，随后刷新 Web/PWA 或重新打开 Desktop。升级保留独立 Claude 会话服务。从 v5.1.1 或更早版本升级仍需按 v5.2.0 发布说明协调迁移到协议 v84。

发布包含六个平台的 Relay/Wrapper 包、install.sh 和 SHA256SUMS，由 GitHub Actions 完成回归、平台导入检查和 attestation。没有新的 Desktop 或移动端安装包；发布本身不切换线上服务。

English

Fix overlapping Claude child-agent returns placing several links above an earlier reply while leaving a later reply unattributed.

Return links now follow the main session's actual consumption of each result; task completion status still updates immediately. Canonical history corrects stale link positions and progress titles from older live/cache data, preserving attribution after refresh, session switches and detail expansion.

Upgrade

Wire protocol remains v84 and Claude Agent SDK remains 0.2.157. Upgrading from v5.2.0 or v5.2.1 does not require a protocol migration:

cc-remote update --check --version 5.2.2
cc-remote update --version 5.2.2

This fix changes both the Wrapper and Relay Web client. Update the Relay and each device, then refresh Web/PWA or reopen Desktop. The independent Claude session service stays running. Upgrades from v5.1.1 or earlier still require the coordinated protocol v84 migration described in the v5.2.0 release notes.

The release includes six platform-specific Relay/Wrapper bundles, install.sh and SHA256SUMS, with GitHub Actions regression tests, platform import checks and attestation. It includes no new Desktop or mobile installer. Publishing does not deploy services.

cc-remote v5.2.1

cc-remote v5.2.1

中文

修复发送 Claude 新消息时，正文短暂闪出“重试加载详情”，随后才显示“正在处理”的问题。

前端现在仅在已确认的历史回合或已有历史摘要上自动读取详情。新消息等待实时输出，回复结束到会话空闲之间也不会误触发。刷新、切换设备和子代理续办时的历史恢复继续保留。

升级

通信协议保持 v84，Claude Agent SDK 保持 0.2.157。从 v5.2.0 升级无需协议迁移：

cc-remote update --check --version 5.2.1
cc-remote update --version 5.2.1

该修复随 Relay 的 Web 客户端发布，更新后刷新 Web/PWA 或重新打开 Desktop。其他设备可分别更新。从 v5.1.1 或更早版本升级仍需按 v5.2.0 发布说明协调迁移到协议 v84。

发布包含六个平台的 Relay/Wrapper 包、install.sh 和 SHA256SUMS，由 GitHub Actions 完成回归、平台导入检查和 attestation。没有新的 Desktop 或移动端安装包；发布本身不切换线上服务。

English

Fix the brief “Retry loading details” message that appeared in a new Claude
reply before the normal processing UI.

Automatic detail reads now require a confirmed history turn or an existing
history summary. New turns wait for live output, including the interval between
reply completion and the session becoming idle. History restoration after
refresh, device switches and child-agent continuations remains available.

Upgrade

Wire protocol remains v84 and Claude Agent SDK remains 0.2.157.
Upgrading from v5.2.0 does not require a protocol migration:

cc-remote update --check --version 5.2.1
cc-remote update --version 5.2.1

The fix ships in the Relay Web client. Refresh Web/PWA or reopen Desktop after
updating; other devices can update separately. Upgrades from v5.1.1 or earlier
still require the coordinated protocol v84 migration described in the
v5.2.0 release notes.

The release includes six platform-specific Relay/Wrapper bundles, install.sh
and SHA256SUMS, with GitHub Actions regression tests, platform import checks
and attestation. It includes no new Desktop or mobile installer. Publishing does
not deploy services.

cc-remote v5.2.0

cc-remote v5.2.0

中文

v5.2.0 新增持久化 Claude 计划、完善权限同步，并支持在会话图片之间切换。通信协议从 v83 升到 v84，Claude Agent SDK 保持 0.2.157。

计划与权限

• 计划审批展示完整文档，并使用统一样式的权限选项选择批准后的执行模式；支持键盘操作和手机布局。
• 计划批准与任务完成分开显示。原生任务工具的成功结果更新进度，未完成的清单继续保留；只有计划正文、没有任务进度的计划仍可手动确认完成。
• “确认已完成”位于计划标题右侧。确认后各客户端同步收起，刷新、重连或重启后不会因为旧历史重新显示；计划正文仍保留在会话历史中。
• 原生进入或退出计划模式时同步真实权限。待处理工具授权不会因切换会话、旧回复结束或状态变为空闲而提前消失。
• 修复原生终端同步、TUI 计划读取、计划回放和会话回滚中的状态恢复。安装快照新增计划数据库与收起记录，兼容旧格式快照的原有恢复范围。

会话恢复与图片浏览

• 切换设备再返回时，恢复原回复结束后仍在继续执行的 Claude 内容。使用明确的原生归属读取最新详情，保留较新的实时输出和工具状态，不重新发送问题。
• 子代理返回链接在刷新、浏览器缓存和详情分页后保留，并继续打开对应子代理。
• 上传与生成的图片支持手机左右滑动、键盘和按钮切换；放大后可拖动查看。原图失败或超时时保留提示和重试入口，即使已有缩略图也能重试。

升级

从 v5.1.1 或更早版本升级，需要协调 Relay、所有 Wrapper 和 Web/PWA 到协议 v84。 先确认全部设备的升级窗口，完成依赖 Wrapper 进程的任务与排队请求，按部署指南停止不兼容旧 Wrapper，升级 Relay/Web，再升级各 Wrapper，并刷新 Web/PWA。

在独立终端中检查并选择本版本：

cc-remote update --check --version 5.2.0
cc-remote update --version 5.2.0 --allow-protocol-change

这个开关表示已安排协议迁移，不会自动升级其他设备。首台设备可能需要既有 Relay 管理员的 --relay-ssh 配置；后续设备跳过已更新的 Relay。原有独立 Claude 服务不随 Wrapper 升级重启，私有 BTW、进程内会话和排队任务仍需先结束。完整步骤见安装与升级。

发布包含六个平台的 Relay/Wrapper 包、install.sh 和 SHA256SUMS，由 GitHub Actions 完成回归、平台导入检查和 attestation。没有新的 Desktop 或移动端安装包；发布本身不切换线上服务。

English

v5.2.0 adds persistent Claude plans, synchronized permissions and conversation
image navigation. Wire protocol advances from v83 to v84; Claude Agent SDK
remains 0.2.157.

Plans and permissions

• Show the full plan for approval with styled, keyboard-accessible choices for
  the execution mode after approval, including narrow mobile layouts.
• Separate approval from completion. Successful native task updates drive the
  checklist; unfinished steps retain the plan. Document-only plans retain manual
  completion.
• Place the completion button beside the plan heading. Dismissal synchronizes
  across clients and survives refresh, reconnect and restart; the document stays
  in conversation history.
• Mirror native permission changes. Keep pending tool approvals visible through
  session switches, parent-response completion and idle-state transitions until
  answered or explicitly closed.
• Recover canonical plans through native terminal mirroring, TUI reads, replay
  and conversation rollback. Activation snapshots include the plan database and
  dismissal receipts; older snapshot formats retain their original restore scope.

Conversation recovery and images

• Restore Claude work continuing after a completed response when returning from
  another device. Load the exact native owner's latest detail, preserve newer
  live output and tool state, and never resend the prompt for recovery.
• Retain child-agent return links through refresh, browser caching and paged
  detail restoration, including navigation to the exact child.
• Navigate uploaded and generated images with mobile swipes, keyboard and
  buttons. Preserve panning while zoomed and show original-image errors and retry
  controls even when a cached thumbnail is available.

Upgrade

Upgrading from v5.1.1 or earlier requires a coordinated protocol v84 upgrade
of Relay, every Wrapper and Web/PWA. Arrange the maintenance window, finish
Wrapper-owned work and queued requests, stop incompatible old Wrappers, update
Relay/Web, update all Wrappers, then reload Web/PWA. Follow the
deployment guide.

In an independent terminal, run cc-remote update --check --version 5.2.0, then
cc-remote update --version 5.2.0 --allow-protocol-change. This flag acknowledges
the coordinated migration; it does not update other devices automatically. The
first device may need the existing Relay administrator's --relay-ssh setting;
later devices skip the updated Relay. Independent Claude services remain running
during Wrapper upgrades; private BTW, in-process sessions and queued work must
finish first. See the
installation guide.

The release includes six platform-specific Relay/Wrapper bundles, install.sh
and SHA256SUMS, with GitHub Actions regression tests, platform import checks
and attestation. It includes no new Desktop or mobile installer. Publishing does
not deploy services.