Repository navigation
Releases: sun168567/cc-desk-tunnel
Releases · sun168567/cc-desk-tunnel
Release list
CC Desk Tunnel 0.3.1
用桌面客户端驱动云端的 Claude Code，经反向隧道在你自己的电脑上执行。
客户端新增 macOS 与 Linux 版本（实验性），服务端可以部署在 arm64 的服务器上（实验性）。对话里的公式和 SVG 直接显示，审批模式可选“绕过权限”，通知不再频繁闪动任务栏图标。
新增功能
- macOS 客户端（实验性）：Apple 芯片与 Intel 各一个安装包，界面和功能与 Windows 相同，Claude 的命令由你自己的 shell（zsh 或 bash）执行。安装包没有签名，首次打开的步骤见 macOS 说明。（#18、#40，dcomdjl）
- Linux 客户端（实验性）：Ubuntu LTS x64 的 deb 安装包，见 Linux 说明。
- 一个会话可以在 Windows、macOS、Linux 的电脑之间接管或分叉：Claude 会被告知现在的电脑是什么系统、该怎样执行命令。
- 服务端支持 arm64 的服务器（实验性）：安装脚本不再拒绝 arm64。镜像构建和部署自测已在 arm64 上自动通过，还没有人在 arm64 服务器上用真实账号跑过会话。（#49，Pandaver）
- 对话里的公式排版显示：
$…$、$$…$$、\(…\)、\[…\]四种写法都支持，代码里的$和正文里的价格（如“$5”）不受影响。（#46，ancientJH） svg代码块显示为图像，旁边可以切换查看源码。图像不会执行其中的脚本，也不会加载外部资源。- 审批模式增加“绕过权限”：Claude 做任何事都不再询问。默认不出现，要先在“设置 → 常规 → 审批”里打开“允许绕过权限”，选中时还要再确认一次；选中后审批标签显示为红色。只建议在测试机或虚拟机里使用。（#48，chokhung588-cell）
优化改进
- 只有等待审批和 Claude 提问会闪动任务栏图标；任务完成、失败、定时任务未发出和连接中断只发系统通知。此前这些通知都会让图标一直闪到点回窗口为止，通知横幅消失后看起来像是无缘无故在闪。
- 在前台看到某个会话时，它的通知自动标为已读，铃铛上的红点不再需要专门点一下才消失。
- 服务端安装和升级时构建镜像更稳：安装依赖的一步偶尔因下载中断而失败，现在会自动再试一次。
- 没有手动选过推理强度时，滑块不再画出填充和手柄，不会再看起来像是选了“高”。（#38，chokhung588-cell）
问题修复
- 发送消息后恰好断线、随后自动重连成功时，顶部不再仍然显示“连接中断”：改为说明连接已恢复、上次请求的确认没有收到，请查看历史确认。（#43，kilisamemarisaaa）
升级说明
- 两端的通信协议有变化，服务端和客户端必须一起升级到本版，旧版本的客户端连不上新的服务端。
- 试用过预发布 0.3.0 的，同样两端一起升级到本版。
- Windows 客户端照常在应用内升级。macOS 与 Linux 的客户端没有应用内升级：到发布页下载新版本的安装包再安装一次，设置会保留；macOS 上可能需要重新填写服务凭据、重新授权文件夹。
- macOS 与 Linux 客户端、arm64 服务端都是第一次发布，维护者没有这些设备，主要靠自动测试和使用者的试用。遇到问题请到议题反馈。
下载与升级
- 已在使用：在客户端的“设置 → 关于与更新”里先升级服务端，再按提示升级客户端；两端需要同一版本。
- Windows 客户端：下载
CC-Desk-Tunnel-Setup-0.3.1-x64.exe并安装。安装包没有代码签名，SmartScreen 与杀毒软件的提示见说明。 - 服务端：新部署按快速开始用一条命令安装；
cc-desk-tunnel-server-0.3.1.tar.gz是它下载的程序包。 - macOS 与 Linux 客户端（实验性）：
CC-Desk-Tunnel-0.3.1-linux-amd64.deb、CC-Desk-Tunnel-0.3.1-mac-arm64.dmg、CC-Desk-Tunnel-0.3.1-mac-x64.dmg。没有签名，也不带应用内更新，升级时重新下载安装；安装与首次打开见 macOS 说明与 Linux 说明。 - 校验：各文件的 SHA256 在
SHA256SUMS与release.json中。
CC Desk Tunnel 0.3.0
用桌面客户端驱动云端的 Claude Code，经反向隧道在你自己的电脑上执行。
客户端新增 macOS 与 Linux 版本（实验性），服务端可以部署在 arm64 的服务器上（实验性）。对话里的公式和 SVG 直接显示，审批模式可选“绕过权限”，通知不再频繁闪动任务栏图标。
新增功能
- macOS 客户端（实验性）：Apple 芯片与 Intel 各一个安装包，界面和功能与 Windows 相同，Claude 的命令由你自己的 shell（zsh 或 bash）执行。安装包没有签名，首次打开的步骤见 macOS 说明。（#18、#40，dcomdjl）
- Linux 客户端（实验性）：Ubuntu LTS x64 的 deb 安装包，见 Linux 说明。
- 一个会话可以在 Windows、macOS、Linux 的电脑之间接管或分叉：Claude 会被告知现在的电脑是什么系统、该怎样执行命令。
- 服务端支持 arm64 的服务器（实验性）：安装脚本不再拒绝 arm64。镜像构建和部署自测已在 arm64 上自动通过，还没有人在 arm64 服务器上用真实账号跑过会话。（#49，Pandaver）
- 对话里的公式排版显示：
$…$、$$…$$、\(…\)、\[…\]四种写法都支持，代码里的$不受影响。（#46，ancientJH） svg代码块显示为图像，旁边可以切换查看源码。图像不会执行其中的脚本，也不会加载外部资源。- 审批模式增加“绕过权限”：Claude 做任何事都不再询问。默认不出现，要先在“设置 → 常规 → 审批”里打开“允许绕过权限”，选中时还要再确认一次；选中后审批标签显示为红色。只建议在测试机或虚拟机里使用。（#48，chokhung588-cell）
优化改进
- 只有等待审批和 Claude 提问会闪动任务栏图标；任务完成、失败、定时任务未发出和连接中断只发系统通知。此前这些通知都会让图标一直闪到点回窗口为止，通知横幅消失后看起来像是无缘无故在闪。
- 在前台看到某个会话时，它的通知自动标为已读，铃铛上的红点不再需要专门点一下才消失。
- 没有手动选过推理强度时，滑块不再画出填充和手柄，不会再看起来像是选了“高”。（#38，chokhung588-cell）
问题修复
- 发送消息后恰好断线、随后自动重连成功时，顶部不再仍然显示“连接中断”：改为说明连接已恢复、上次请求的确认没有收到，请查看历史确认。（#43，kilisamemarisaaa）
升级说明
- 两端的通信协议有变化，服务端和客户端必须一起升级到本版，旧版本的客户端连不上新的服务端。
- Windows 客户端照常在应用内升级。macOS 与 Linux 的客户端没有应用内升级：到发布页下载新版本的安装包再安装一次，设置会保留；macOS 上可能需要重新填写服务凭据、重新授权文件夹。
- macOS 与 Linux 客户端、arm64 服务端都是第一次发布，维护者没有这些设备，主要靠自动测试和使用者的试用。遇到问题请到议题反馈。
下载与升级
- 已在使用：在客户端的“设置 → 关于与更新”里先升级服务端，再按提示升级客户端；两端需要同一版本。
- Windows 客户端：下载
CC-Desk-Tunnel-Setup-0.3.0-x64.exe并安装。安装包没有代码签名，SmartScreen 与杀毒软件的提示见说明。 - 服务端：新部署按快速开始用一条命令安装；
cc-desk-tunnel-server-0.3.0.tar.gz是它下载的程序包。 - macOS 与 Linux 客户端（实验性）：
CC-Desk-Tunnel-0.3.0-linux-amd64.deb、CC-Desk-Tunnel-0.3.0-mac-arm64.dmg、CC-Desk-Tunnel-0.3.0-mac-x64.dmg。没有签名，也不带应用内更新，升级时重新下载安装；安装与首次打开见 macOS 说明与 Linux 说明。 - 校验：各文件的 SHA256 在
SHA256SUMS与release.json中。
CC Desk Tunnel 0.2.13
用桌面客户端驱动云端的 Claude Code，经反向隧道在你的 Windows 本机执行。
修复“改从 GitHub 发布页下载”升级时报错的问题。
问题修复
- 登录页提示版本不一致时，点“改从 GitHub 发布页下载”不再报“Cannot find module … release-download.mjs”：安装包里漏了这项功能用到的一个文件，0.2.11 加入该功能时即如此。
升级说明
- 0.2.11 和 0.2.12 的客户端上这个按钮仍然不可用，升级到本版请用默认的“升级客户端”（从服务端下载），或到发布页手动下载安装包。
- 服务端没有功能变化，但两端版本需一致，仍要一起升级。
下载与升级
CC Desk Tunnel 0.2.12
用桌面客户端驱动云端的 Claude Code，经反向隧道在你的 Windows 本机执行。
连接断了任务不再丢：任务在服务端继续，客户端自动重连并补上期间的内容，被中断的一轮可以一键继续。会话历史占用的磁盘空间大幅减少，Claude 在电脑上执行脚本更稳。另有几处界面改进。
BUG：该版存在“改从 GitHub 发布页下载”按钮无法使用的问题，推荐直接升至0.2.13
新增功能
- 连接断了不再丢掉正在进行的任务：任务在服务端继续跑，等这台电脑连回来。断开那一刻正在电脑上执行的那条命令会失败，Claude 会看到并自行处理；之后的命令等电脑回来再执行。此前连接一断，任务立即被结束。
- 客户端自动重连：断线后留在原来的界面，一直重试到连上为止，网络恢复时立即重试，连上后补上期间的内容。此前任何断线都会退回登录页。只有服务端明确拒绝（凭据不对、版本不一致）时才回到登录页。
- “继续”按钮：任务被手动停止或因离线太久而中断后，输入框右下角的发送键变成“继续”，点一下就接着做，不必再写一句话。
优化改进
- 电脑离线超过 5 分钟任务才停止，可在服务端用
PROXY_GRACE_SECONDS调整；主动断开连接或退出客户端仍然立即结束任务。 - 同一台电脑上的几个窗口都可以操作这台电脑的任务（停止、答复审批），不再限于发起它的那个窗口。
- 更换会话所在的项目时可以直接选一个新文件夹：项目列表下面多了“选择其他文件夹…”，选中的文件夹同时加入项目列表。此前要先把它添加为项目。
- Claude 在电脑上执行 PowerShell 脚本更稳：脚本原样送到电脑上执行，不再先编码成 Base64。长脚本不再因命令行长度限制而失败，中文不再需要脚本自己设置编码，出错时返回的是一句可读的文字而不是一段 XML。（#31，chokhung588-cell）
- Claude 可以查看粘贴的截图和图片附件：明确允许它把电脑上的那一张图片复制到服务端查看，看完删除副本。此前能力较弱的模型会认为自己看不到图片。（#32，chokhung588-cell）
- 已结束回合的折叠里，Claude 在两次操作之间写的说明按正文的字号和颜色显示，折叠的摘要里写明有几条说明。（#33，chokhung588-cell）
- 推理强度滑块下面显示各档的名称，点名称可以直接切换。（#34，chokhung588-cell）
- 输入框右下角的上下文窗口图标改为圆环进度：一眼能看出用了多少，用到七成变为黄色，九成变为红色。此前是一个静态图标，要把鼠标移上去才知道。
- “定时任务”页提醒：任务由程序自动发送，订阅账号下是否合适请对照官方说明判断，并附上链接。
- 会话历史占用的磁盘空间大幅减少，写盘次数也随之减少：Claude 输出的一段文字现在只存一条记录，边输出边显示的效果不变。此前每吐出一小段就存一条，几十轮对话的会话库就有几十 MB。
问题修复
- 修复：服务端下好客户端安装包之后，第一个登录的旧版本客户端仍被告知“还没有备好”，要再连一次才出现升级按钮。
升级说明
- 两端的通信协议有变化，服务端与客户端需要一起升级。
- 原生终端不在此列：连接断开时终端仍会关闭。
- 升级后每个已有会话的下一轮对话不命中提示缓存，按全价计一次，之后恢复正常。原因是给 Claude 的远程操作说明有改动。
- 服务端第一次以新版本启动时会把已有的会话历史按新的方式合并一次，内容不变，会话多时启动会多花几秒到几十秒。合并之前会话库的完整副本留在数据目录的
state/backups/history-<时间>/里，旁边的README.txt说明了它是什么、如何恢复；确认一切正常后可以删除；manage.sh backup不把它打进归档。合并后的会话库旧版本也能读取。 - 服务端异常退出（进程被杀、断电）时，正在输出而尚未结束的那一段文字不会留在界面历史里；它仍在 Claude 自己的会话记录中，不影响接着对话。
下载与升级
CC Desk Tunnel 0.2.11
用桌面客户端驱动云端的 Claude Code，经反向隧道在你的 Windows 本机执行。
同一个人的几台电脑可以同时连接，会话可以接到另一台电脑上继续；Claude 在电脑上执行命令更快；升级不再卡在下载安装包上。另有连接日志、粘贴图片和两个新的设置开关。
新增功能
- 同一个人的几台电脑可以同时连接：此前第二台登录会被拒绝，现在各连各的，互不影响。同一台电脑上开两个窗口也一样。
- 会话记着它的项目目录在哪台电脑上：侧栏默认只列本机的会话，其他电脑上的收在“其他设备”一组里，可以打开查看。
- 可以把其他电脑上的会话接到本机继续：打开后选它在本机的项目目录，点“在本机继续”；下一条消息会告诉 Claude 换了电脑和目录。也可以“分叉到本机”，原会话留在原来的电脑上。
- 可以直接粘贴或拖入剪贴板里的图片：截图、从网页复制的图片没有对应的文件，客户端把它存到本机再作为附件交给 Claude，一周后自动清理。此前只能粘贴资源管理器里复制的文件。
- “显示思考过程”开关（设置 → Claude Code）：关闭后不再向 Claude 索取思考摘要，对话里不出现“思考”，模型照常思考。默认开启；第三方模型自己输出的思考不受影响。
- “工具搜索”开关（设置 → Claude Code）：工具的说明不再随每次请求全部发出，Claude 用到时再查找，工具多时能明显减少上下文占用。默认跟随 Claude Code：官方账号开启，第三方接口关闭。
- 客户端有了连接日志：每次连接何时建立、何时断开、是哪一方先断开及原因，记在本机，“设置 → 关于与更新”里可以打开它所在的文件夹。不含凭据、对话和命令内容。连接无故中断时可以对照服务端日志判断问题出在哪一段。
优化改进
- Claude 在电脑上执行命令更快：一台电脑的命令共用一条 SSH 连接，不再每条命令都重新登录。实测每条命令的固定开销从约 1.2 秒降到约 0.25 秒。
- 原生终端不再独占整个服务：终端只占用它所在的会话，其他会话照常运行，别的窗口和电脑也不再被它锁住。此前开着一个终端时，所有会话都不能发消息。
- 服务端启动时清理上一版的程序文件和没下完的安装包。此前上一版的程序要到再下一次升级才删除，每个版本多占约 600 MB。
- 客户端能自己发现连接已经断了：约 45 秒收不到服务端的任何回应就回到登录页并说明原因。此前途中的网络或代理悄悄中断连接时，客户端会一直显示“已连接”和运行中的任务，直到下一次操作才发现，而服务端早已把任务结束。
- 服务端日志里每条连接记着是哪台电脑、从哪个地址来、保持了多久。
- 同时进行的运行和终端有了上限，按服务器内存估算，避免内存不足时拖垮所有任务；可在服务端用
PROXY_MAX_RUNS调整。 - 升级服务端不再等待客户端安装包：服务端装好新程序就重启，安装包在重启后由服务端在后台下载。此前这一步要等一个约 200 MB 的文件下完，网络慢时会长时间停在“下载客户端安装包”。
- 服务端下载发布文件改为分段续传：一条连接变慢或没有数据时换一条连接接着下，不再从头开始；下载失败后隔几分钟自动重试，有旧版本客户端登录时也会立即重试。
- 客户端升级可以选择安装包的来源：登录页提示版本不一致时，除了从服务端获取，还可以直接从 GitHub 发布页下载，同样校验后覆盖升级，下载时显示进度。服务端还没下好安装包、或服务器访问 GitHub 很慢时不必再等。
- 服务端还在下载安装包时，登录页会显示它的进度。
- 会话的右键菜单和“更多”按钮里多了“移到其他项目…”：此前只能点输入框上方的项目标签来更换会话所在的项目，入口不容易找到。
问题修复
- 修复：告诉 Claude “命令的 SSH 会话结束时，它在电脑上启动的进程也会结束”并不准确，没有输出的进程会留下来。现在如实说明，由 Claude 在结束命令前自己停掉进程。
升级说明
- 两端的通信协议有变化，服务端与客户端需要一起升级。
- 升级后每个已有会话的下一轮对话不命中提示缓存，按全价计一次，之后恢复正常。原因是给 Claude 的远程操作说明改短了。
- 升级前的会话没有电脑信息，在每台电脑上都照常列出，归第一个向它发消息的那台。
下载与升级
CC Desk Tunnel 0.2.10
用桌面客户端驱动云端的 Claude Code，经反向隧道在你的 Windows 本机执行。
执行通道改为由客户端经服务地址建立，不再使用 frp：服务器只需放行一个端口，客户端不再带常被杀毒软件拦截的 frpc.exe。调用日志可以翻页，并新增缓存命中率、Token 构成趋势和按模型统计。
新增功能
- 调用日志可以翻页：每页 50 条，可以上一页、下一页或输入页码跳转，并显示总条数。原先只能逐次“加载更多”。
- 调用日志新增缓存命中率：汇总里多一项，按“缓存读取 ÷（输入 + 缓存读取 + 缓存写入）”计算。
- 调用日志新增“Token 构成”趋势图：输入、输出、缓存读取、缓存写入四条折线，下方是同一时间轴上的缓存命中率，鼠标移上去显示该时段的各项数值。
- 调用日志新增按模型统计：每个模型的请求数、Token、缓存命中率、等价费用和费用占比。
- 侧栏里的项目可以收起：点项目名收起或展开它下面的会话，收起时显示会话数量，有会话在运行时带运行标记；搜索时仍会显示匹配的会话。
优化改进
- 安装版的登录页不再显示“本地模拟 / 远程代理”切换。“本地模拟”只用于开发调试，从源码运行时仍然提供。
- Claude 到电脑的执行通道改走服务地址本身，与登录和对话用同一个端口、同一张证书。服务器只需放行一个端口（默认 8787），原先的隧道端口（默认 7000）不再使用。
- 安装包不再带
frpc.exe，服务端镜像不再带frps。它们常被杀毒软件和云厂商的主机安全组件当作风险软件拦截或告警。 - nginx 反代模式下执行通道也经过 nginx，不再需要另外放行隧道端口，也不要求客户端能直接连到服务器。
- 经系统代理连接时，执行通道与登录走同一条路径，不再有单独的隧道连接需要代理放行。
- 连接失败的提示按新的通道重写：区分本机 SSH 服务没能启动、执行通道没有就绪两种情况，并带上具体原因。
问题修复
- 修复：Claude 同时发起十条以上命令时，个别命令可能被本机 SSH 服务随机拒绝。
升级说明
- 两端的通信协议有变化，服务端与客户端需要一起升级。可以先在客户端菜单里升级服务端，重新连接后按提示升级客户端。
- 升级后可以从服务器防火墙和云安全组里去掉隧道端口（默认 7000/TCP）。从客户端升级的 Docker 部署，容器暂时仍发布着这个端口，但已经没有程序监听；下次在服务器上执行
manage.sh upgrade后不再发布。 - nginx 反代的部署：Claude 每执行一条命令，客户端就另开一条到
/ws的连接。如果给这个站点配置了limit_conn之类的并发限制，需要放宽。 - frp 留下的配置和证书会自动清理：服务端升级后第一次启动时，删除数据目录里的
tls/frp.crt、tls/frp.key，并去掉service.env里的FRPS_*和PROXY_PUBLIC_HOST；在服务器上执行manage.sh upgrade时去掉部署配置里的FRPS_PORT。 - 从客户端升级的 Docker 部署，镜像里还留着不再运行的
frps程序文件，连同上面提到的端口发布，都要在服务器上执行一次manage.sh upgrade重建后才会消失。
致谢
- 执行通道改走 WSS 的思路最早由 @jiangan-code 在 #9 中提出（Linux 客户端的 WSS 中继）。本版本参考这一思路重新设计并实现，感谢。
下载与升级
Contributors
jiangan-code
Assets 7
CC Desk Tunnel 0.2.9
用桌面客户端驱动云端的 Claude Code，经反向隧道在你的 Windows 本机执行。
Claude 放到后台的命令不再随回答结束而终止，完成后会自动接着处理；修复域账号电脑无法连接，连接等待时间可以调整。
新增功能
- 连接等待时间可以调整：连接服务器、本机 SSH 服务启动、执行通道就绪各有一项，在“设置 → 常规”里修改，默认值不变。
- 登录页新增“本机设置”：不用先连接，就能改常规、通知和快捷键这些只属于本机的设置。
优化改进
- 对话内查找只查已经加载的内容；还有更早记录没加载时，数量后标注“仅已加载部分”，加载后自动纳入。
- 向上翻到已加载内容的开头时自动加载更早记录，不用再点按钮。
问题修复
- 修复：Claude 把命令放到后台后结束回答，后台命令随即被终止，也不会在完成后接着处理。现在后台任务会继续运行，完成后 Claude 自动接着处理；等待期间会话显示“后台任务”，列出每个任务并可单独结束，输入框照常可用。
- 修复：Windows 域账号登录的电脑连接失败，本机 SSH 服务拒绝了自己的账号。
- 修复：登录 Claude 账号时“复制链接”按钮无效。
- 修复：使用重置卡后，如果第一次读到额度时已经又用了一些，本周期统计没有重新开始。
- 修复：右键复制后，会话顶部的“已复制”一直不消失。
- 修复：从 0.2.7 及更早版本升级时，恢复统计周期会读取全部会话记录，记录多时启动变慢。
升级说明
- 两端的通信协议有变化，服务端与客户端需要一起升级。
下载与升级
CC Desk Tunnel 0.2.8
用桌面客户端驱动云端的 Claude Code，经反向隧道在你的 Windows 本机执行。
会话增加消息日期、复制与查找，修复用量统计和最近使用时间。
新增功能
- 消息日期：显示简短时间，悬浮查看完整日期与时区。
- 复制：会话文字右键菜单、消息和代码块复制按钮；输入框支持右键剪切、复制、粘贴。
- 对话内查找：Ctrl+F 打开，高亮匹配并显示数量，上下跳转；包含折叠内容和更早记录。
优化改进
- 模型菜单显示具体型号，可重新读取原生列表；Claude Code 更新到 2.1.293，内置目录加入 Haiku 5.5。
问题修复
- 修复：额度尚未重置，本周期统计却提前归零。恢复受影响的统计范围，保留调用记录。
- 修复：仅打开查看会话也会刷新最近使用时间。
升级说明
- 服务端升级时会安装所需的 Claude Code，SDK 版本不变，不需要重建镜像。
下载与升级
CC Desk Tunnel 0.2.7
用桌面客户端驱动云端的 Claude Code，经反向隧道在你的 Windows 本机执行。
界面改版为三栏布局，Claude 的提问可以直接作答；修复重连后整段对话重新计费的问题，连接失败时给出原因。本版包含 0.2.6 的全部内容，并修复了 0.2.6 安装版无法启动的问题；0.2.6 已撤下。
新增功能
- 界面改版：自绘标题栏（后退 / 前进、“文件 / 视图 / 帮助”菜单）、左侧图标栏、随页面变化的侧栏与主区；设置改为带分类和搜索的整页，账号与额度、调用日志并入其中。
- 系统通知：窗口不在前台时，任务完成、失败、等待审批、Claude 提问、定时任务没能发出、连接中断经 Windows 通知提醒，点击回到对应会话；每一类可单独关闭，侧栏铃铛保留最近的记录。
- 提问卡片：Claude 提问时列出问题与选项，可单选、多选或自己写，不再只有允许 / 拒绝。
- 更换会话的项目、更改项目指向的文件夹：变更随下一条消息告诉 Claude，不影响已有上下文。
- 快捷键：后退 / 前进、收起侧栏、新建会话、打开设置、界面缩放，可在设置里逐项修改或整体关闭；只在本窗口处于前台时起作用。
- 会话与项目置顶、项目显示名称、把会话导出为 Markdown、显示项目当前的 git 分支。
- 添加文件：选择、拖入或粘贴文件，把它在本机的路径放进消息。
- 设置页新增 8 个 Claude Code 设置项，并按“上下文与记忆 / 模型与额度 / 行为 / Git”分组。
- 帮助页：工作方式、审批模式、定时任务与常见问题的说明。
优化改进
- 审批模式菜单每项带一行说明；模型与推理强度合并为一个面板。
- 连接失败时说明是哪一步、什么原因、该检查什么：区分域名解析、连接超时或被拒绝、证书问题、服务凭据错误、隧道端口不通、隧道组件被安全软件拦截或缺失等情形。首页增加“连接失败时”排查表。
- 打包完成后自动启动实际发行程序，检查登录页、预加载接口与 Git 分支读取；失败时中止发布。
问题修复
- 修复：客户端每次重连后，会话的第一个请求把整段对话重新写入提示缓存，产生大额费用。原因是系统提示词里带有随连接变化的路径；现在一个会话的系统提示词在压缩之前保持不变。
- 修复：0.2.6 安装包遗漏读取 Git 分支的模块，安装或自动升级后启动报错
Cannot find module './git-branch.cjs'。
升级说明
- 从 0.2.5 及更早版本：两端的通信协议有变化，服务端与客户端需要一起升级。先在客户端里点“升级服务端”，服务端重启后登录页会提示“升级客户端”。服务器不需要重建镜像。
- 升级后，每个已有会话的第一次运行会重新写入一次提示缓存（系统提示词里的路径改了一次），之后恢复正常。较长的会话可以先压缩再升级。
下载与升级
CC Desk Tunnel 0.2.5
- 账号页显示按模型的每周额度：Max 订阅的 Fable 每周额度与 5 小时、每周额度并列，带进度条、重置时间和本周期统计。
- 客户端跟随 Windows 系统代理：设置了 HTTP 代理时，登录连接、客户端升级下载和执行通道都经代理到达服务端，不必开启 TUN 模式；未设置代理时与此前一样直连。