ZC-GUI 0.4.1

ZCode 会话管理的 JetBrains 插件正式版 0.4.1。

适配

• 适配 ZCode CLI 0.17.0（#44，@Winminn）：CLI 升级 0.17.0 后会话列表加载失败（服务端删除 includeArchived 参数致 -32602 报错），归档列表改走新链路；旧版本 CLI 行为不变。

新增

• 浏览器独立窗口：内嵌浏览器弹窗可弹出为独立窗口（细边框、最小化 / 最大化），弹出后独立呈现，AI 的浏览器操作继续在其中执行。
• MCP 工具图片恢复：MCP 工具返回的图片恢复为消息卡片缩略图，点击可放大查看。

修复

• 修复排队消息两处丢失：点「立即发送」被服务端队列静默吞掉；app-server 僵死时排队消息无痕丢失（新增发送落位看门狗）。
• 修复 IDE 切换深浅主题后插件界面与内嵌浏览器不实时跟随的问题。
• 修复 JCEF 基础设施故障炸穿工具窗、导致插件面板整体不可用的问题。
• 修复生成速率在渠道停顿恢复期闪没的问题。
• 修复后台任务弹窗中运行中的条目沉底的问题（现固定置顶）。
• 修复会话内出现两条同秒「工作中」读秒行的问题。
• 修复产物预览卡 xlsx / m4v 等扩展名图标缺失、显示灰色兜底的问题。

---

2026-10-20 重传：修复平台兼容性报告中 2023.3 上的 2 处 internal API 引用（主题明暗判定改为反射隔离，功能无变化）。附件与 Marketplace 均已替换为修复后构建。

附件 ZC-GUI-0.4.1-signed.zip 为已签名完整安装包，可在 IDE 中离线安装（Settings → Plugins → ⚙ → Install Plugin from Disk）。也可等 JetBrains Marketplace 审核通过后直接搜索更新（"ZC GUI"）。

English: Download ZC-GUI-0.4.1-signed.zip from the assets below, then in your IDE: Settings → Plugins → ⚙ → Install Plugin from Disk, pick the zip and restart. Also available on JetBrains Marketplace (search "ZC GUI", once approved).

---

本版本由 @csuftt 发布维护，问题与建议欢迎到 GitHub Issues 反馈。
Released and maintained by @csuftt — feel free to report issues or suggestions at GitHub Issues.

ZC-GUI 0.4.0

ZCode 会话管理的 JetBrains 插件正式版 0.4.0。

新增

• 电脑操作：AI 可截屏、点击、键入直接操作本机桌面——打开应用、窗口管理、批量操作、区域放大截图等；输入框新增「电脑操作」开关，设置页可随时停用，关闭后已开启会话的工具调用也会被立即拒绝。
• 模型调用轨迹：新增「轨迹」面板，可查看会话内每次模型请求 / 响应的完整明细（读取本地 CLI 落盘记录），支持搜索定位。
• 钩子管理（#37，@Winminn）：设置页新增「钩子」tab，可查看、启停、删除工作区级与用户级钩子；会话遇到未信任钩子时顶部弹准入横幅，一键授予、当前会话即时生效。
• 模型停用开关（#36，@Winminn）：模型管理支持单个模型启用 / 停用，停用后不再出现在模型切换列表。
• 悬浮提醒弹窗（#33，@Winminn）：IDE 不在前台时，任务完成 / 等待输入 / 计划与权限审批弹全局置顶小卡片，点击回 IDE 并定位会话；显示时长与屏幕位置可配，与 IDE 内气泡通知独立开关。
• 标签页完成标记（#31，@Winminn）：回合结束时未选中的标签页名字亮 ✔，点进即清；与生成中 ● 互斥。
• 生成速率显示：AI 回复时状态行实时显示生成速率（token/s）。
• @文件补全模糊匹配（issue #38）：@ 补全不再要求连续前缀，路径分段也能命中（如输入 srcuti 可命中 src/utils）。
• 新会话免确认开关（#34，@Winminn）：行为设置新增「直接覆盖当前标签页」，开启后工具栏新会话按钮跳过确认直接开新会话。
• 已开会话标记（#43，@Winminn）：历史列表中已在某个标签打开的会话显示标签名，点击先确认再切换，避免多标签下标题相似误点。
• 其他：额度横幅手动关闭后不再重复弹出；顶栏与额度弹窗视觉对齐官方客户端。

修复

• 修复新建会话后偶发无声跳回旧会话、输入草稿被带走的问题（#39，@Winminn）。
• 修复上下文圆环两处口径问题：自定义模型上下文窗口被内置 200K 兜底覆盖（漏读个人模型规则）；新版 CLI 下构成明细与缓存命中率不显示（#42，@Winminn）。
• 修复自定义 idea.system.path 时浏览器工具失效的问题（#35，@Winminn），设置 → 环境现可指定端口文件。
• 修复消息内带行号的裸文件名（如 App.kt:1606）与目录路径不可点击的问题（#32，@Winminn）。
• 修复粘贴文件路径 / 会话 / 技能引用转 chip 后光标落到 chip 前的问题。

---

English:

Added

• Computer use: the AI can screenshot, click and type to operate local desktop apps directly — launching apps, window management, batch actions, cropped zoom-in screenshots and more. A new "Computer use" toggle sits in the input box; it can also be disabled in settings, and tool calls in already-enabled sessions are rejected immediately once off.
• Model call trajectory: a new "Trajectory" panel shows the full request / response detail of every model call in a session (read from local CLI logs), with search.
• Hooks management (#37, @Winminn): a new "Hooks" tab in settings lists, enables/disables and deletes workspace-level and user-level hooks; when a session meets an untrusted hook, a banner appears at the top for one-click trust grant, effective in the current session immediately.
• Per-model disable toggle (#36, @Winminn): model management supports enabling/disabling a single model; disabled models no longer show up in the model switcher.
• Floating reminder popup (#33, @Winminn): when the IDE is not in the foreground, task completion / input requests / plan & permission approvals pop up an always-on-top card; clicking it returns to the IDE and locates the session. Display duration and screen position are configurable, with an independent switch from the in-IDE bubble notification.
• Tab completion marker (#31, @Winminn): when a turn finishes, unselected tab names show a ✔ mark, cleared on click; mutually exclusive with the ● generating marker.
• Generation speed: the status line shows the live generation speed (tokens/s) while the AI is replying.
• Fuzzy @ file completion (issue #38): the @ completion no longer requires a contiguous prefix — path segments match too (e.g. typing srcuti matches src/utils).
• New-session confirmation toggle (#34, @Winminn): a new "Overwrite current tab directly" option in behavior settings makes the toolbar new-session button skip confirmation.
• Opened-session marker (#43, @Winminn): sessions already open in a tab show the tab name in the history list; clicking asks for confirmation first to avoid accidental switches between similarly-titled tabs.
• Others: the quota banner stays dismissed after being closed manually; the topbar and quota popup visually align with the official client.

Fixed

• Fixed occasionally jumping back to the previous session right after creating a new one, taking the input draft away (#39, @Winminn).
• Fixed two context-ring inaccuracies: custom model context windows being overridden by the built-in 200K fallback (personal model rules ignored); context breakdown and cache-hit rate missing on newer CLI versions (#42, @Winminn).
• Fixed browser tools failing when a custom idea.system.path is set (#35, @Winminn); the port file can now be specified in Settings → Environment.
• Fixed bare file names with line numbers (e.g. App.kt:1606) and directory paths not being clickable in messages (#32, @Winminn).
• Fixed the caret landing before the chip after pasting a file path / session / skill reference converted into a chip.

---

安装 / Install

中文：从下方附件下载 ZC-GUI-0.4.0-signed.zip，IDE → Settings → Plugins → ⚙ → Install Plugin from Disk 选择该 zip，重启 IDE 生效。也可从 JetBrains Marketplace 搜索 "ZC GUI" 安装（审核通过后可用）。

English: Download ZC-GUI-0.4.0-signed.zip from the assets below, then in your IDE: Settings → Plugins → ⚙ → Install Plugin from Disk, pick the zip and restart. Also available on JetBrains Marketplace (search "ZC GUI", once approved).

---

本版本由 @csuftt 发布维护，问题与建议欢迎到 GitHub Issues 反馈。
Released and maintained by @csuftt — feel free to report issues or suggestions at GitHub Issues.

ZC-GUI 0.3.9

ZCode 会话管理的 JetBrains 插件正式版 0.3.9。

新增

• AI 提交信息：版本控制提交框新增 AI 生成按钮，参照仓库近期提交风格生成本次改动的提交信息；设置页可自定义附加要求。
• 会话列表活性同步：官方桌面端 / 手机端新建或更新的会话实时同步到列表，不再需要重启客户端才能看到。
• 逐轮文件更改与一键撤销：每轮 AI 改动的文件以更改条汇总，可打开双栏 diff 查看，并支持一键撤销本轮全部改动；AI 产出的文档 / 网页等产物自动出预览卡，点击即打开。
• 额度展示升级：上下文弹窗按套餐展示额度三列进度与重置时间；额度偏低时会话顶部显示横幅提醒。
• 输入增强：输入框支持 $ 唤起技能提及；会话列表新增未读蓝点（其他端有新消息时标记）；输入草稿按会话自动保存、重启后恢复。
• 消息内文件路径可点击（#30，@Winminn）：AI 回复中提到的文件路径渲染为链接，点击在编辑器打开并跳到对应行；压缩包（zip 等）则在系统资源管理器中定位所在目录。
• 当前文件上下文 chip（#28，@Winminn）：输入框顶栏可勾选携带当前编辑器文件（含选中代码）随消息发送，消息气泡只显示手打文字；发送后自动取消勾选，可设置为新建会话时自动启用。
• 会话置顶：会话列表支持置顶常用会话，与官方桌面客户端互通。
• 后台工作汇总：状态面板新增「后台工作」入口，集中查看后台任务与子代理任务。
• 浏览器缩放指示器：Ctrl+滚轮缩放界面时显示百分比胶囊，Ctrl+0 恢复基准档。
• 其他：模型 / 技能 / 命令等配置目录变化后自动刷新，无需重启；输入框顶栏、底栏密度与配色打磨。
• 支持 IDEA 2023.3（issue #29）：兼容范围从 2024.1 下探到 2023.3 ~ 2026.3，老版本 IDEA 可直接安装官方包，无需再本地打包。

修复

• 修复图片预览在窄窗口下放大后模糊的问题。
• 修复非中文界面下部分错误提示仍显示中文的问题。

---

English:

Added

• AI commit message: a new button in the VCS commit box generates a commit message for your changes, following your repository's recent commit style; extra requirements can be customized in settings.
• Live session list: sessions created or updated by the official desktop / mobile apps now sync to the list in real time, no client restart needed.
• Per-turn file changes & one-click undo: files changed in each turn are summarized as a change bar with a side-by-side diff viewer, and the whole turn can be undone with one click; documents / web pages produced by the AI automatically get preview cards that open on click.
• Quota display: the context popup shows plan quota as three progress bars with reset time; a banner appears in-session when quota runs low.
• Input enhancements: $ in the input box opens the skill mention picker; the session list shows unread dots (when new messages arrive from other ends); input drafts are saved per session and restored after restart.
• Clickable file paths in messages (#30, @Winminn): file paths mentioned in AI replies render as links that open in the editor at the referenced line; archives (zip etc.) reveal their containing folder in the system file manager.
• Current-file context chip (#28, @Winminn): a toggle in the input box topbar attaches the current editor file (including the selection) to your message; message bubbles show only what you typed. The toggle auto-clears after sending and can auto-enable for new sessions.
• Session pinning: pin frequently used sessions to the top; interops with the official desktop client.
• Background work summary: the status panel gains a "Background work" entry listing background tasks and subagent tasks in one place.
• Browser zoom indicator: a percentage pill shows while zooming the UI with Ctrl+wheel; Ctrl+0 restores the baseline zoom.
• Others: model / skill / command config directories now refresh automatically, no restart needed; the input box topbar and bottom bar got density and color polish.
• IDEA 2023.3 support (issue #29): the compatibility range now extends down to 2023.3 ~ 2026.3 (from 2024.1), so older IDEs can install the official package directly — no more local builds needed.

Fixed

• Fixed image preview becoming blurry when zoomed in a narrow window.
• Fixed some error messages still showing in Chinese on non-Chinese UI languages.

---

安装 / Install

中文：从下方附件下载 ZC-GUI-0.3.9-signed.zip，IDE → Settings → Plugins → ⚙ → Install Plugin from Disk 选择该 zip，重启 IDE 生效。也可从 JetBrains Marketplace 搜索 "ZC GUI" 安装（审核通过后可用）。

English: Download ZC-GUI-0.3.9-signed.zip from the assets below, then in your IDE: Settings → Plugins → ⚙ → Install Plugin from Disk, pick the zip and restart. Also available on JetBrains Marketplace (search "ZC GUI", once approved).

---

本版本由 @csuftt 发布维护，问题与建议欢迎到 GitHub Issues 反馈。
Released and maintained by @csuftt — feel free to report issues or suggestions at GitHub Issues.

ZC-GUI 0.3.9-beta.1

ZC-GUI 0.3.9-beta.1（预发布 / prerelease）

正式版 v0.3.9 已发布，包含本预发布的全部内容并已上架 JetBrains Marketplace，建议直接安装正式版：https://github.com/csuftt/zcode-jetbrains-plugin/releases/tag/v0.3.9

The stable v0.3.9 is now available (including everything in this prerelease, also published to JetBrains Marketplace). Please install the stable release instead: https://github.com/csuftt/zcode-jetbrains-plugin/releases/tag/v0.3.9

ZC-GUI 0.3.9-beta.1（预发布 / prerelease）

这是 0.3.9 的第一个预发布版本，主要为了提前验证「支持 IDEA 2023.3」：兼容范围从 2024.1 下探到 2023.3（现支持 2023.3 ~ 2026.3）。使用旧版 IDEA 的用户欢迎试用反馈，正式版会随 0.3.9 一起发布到 Marketplace。

本预发布包含 0.3.9 的全部功能改动，中文：

新增

• 当前文件上下文 chip：输入框顶栏可勾选携带当前编辑器文件（含选中代码）随消息发送，气泡只显示手打文字；发送后自动取消勾选，可设置为新建会话时自动启用。
• AI 提交信息：版本控制提交框新增 AI 生成按钮，参照仓库近期提交风格生成本次改动的提交信息。
• 会话列表活性同步：官方桌面端 / 手机端新建或更新的会话实时同步到列表，不再需要重启客户端。
• 逐轮文件更改与一键撤销：每轮 AI 改动的文件以更改条汇总，可查看双栏 diff 并一键撤销本轮全部改动；AI 产出的文档 / 网页产物自动出预览卡。
• 额度展示升级：上下文弹窗按套餐展示额度进度与重置时间；额度偏低时出横幅提醒。
• 输入增强：$ 唤起技能提及；会话列表未读蓝点；输入草稿按会话自动保存、重启后恢复。
• 会话置顶 / 后台工作汇总 / 浏览器缩放指示器 等更多改进见 CHANGELOG。
• 支持 IDEA 2023.3（issue #29）：兼容范围下探到 2023.3，老版本 IDEA 可直接安装官方包。

修复

• 修复图片预览在窄窗口下放大后模糊的问题。
• 修复非中文界面下部分错误提示仍显示中文的问题。

安装

• 下载下方附件 ZC-GUI-0.3.9-signed.zip，IDE 内 Settings → Plugins → ⚙ → Install Plugin from Disk 安装。
• 已安装旧版本的直接覆盖安装即可。

---

This is the first prerelease of 0.3.9, mainly to verify IDEA 2023.3 support early: the compatibility range now extends down to 2023.3 (2023.3 ~ 2026.3 in total). Users on older IDEs are welcome to try it and report back; the stable version will follow on the Marketplace with 0.3.9.

This prerelease contains all 0.3.9 changes:

Added

• Current-file context chip: optionally attach the current editor file (with selection) to your message from the input box topbar; bubbles show only what you typed.
• AI commit message: a new button in the VCS commit box generates commit messages following your repository's style.
• Live session list: sessions created or updated by the official desktop / mobile apps sync in real time, no restart needed.
• Per-turn file changes & one-click undo: per-turn change bars with side-by-side diff and one-click undo; preview cards for AI-produced documents / web pages.
• Quota display: plan quota progress bars with reset time in the context popup; an in-session banner when quota runs low.
• Input enhancements: $ skill mentions; unread dots in the session list; per-session input drafts restored after restart.
• Session pinning / background work summary / browser zoom indicator and more — see the CHANGELOG.
• IDEA 2023.3 support (issue #29): older IDEs can now install the official package directly.

Fixed

• Fixed image preview becoming blurry when zoomed in a narrow window.
• Fixed some error messages still showing in Chinese on non-Chinese UI languages.

Install

• Download ZC-GUI-0.3.9-signed.zip below, then install via Settings → Plugins → ⚙ → Install Plugin from Disk inside the IDE.
• If an older version is installed, installing over it works fine.

ZC-GUI 0.3.8

新增

• 手机远程会话：Z.ai 手机 App 可远程查看与操控桌面 IDE 内的会话，任务列表、模型选择、设备命名全链路打通，支持 HTTP 代理环境接入。
• 账号渠道直连：模型列表新增 Z.ai 账号订阅渠道（内置置顶区），OAuth 登录即可使用、无需手动配置 API Key，额度页同步展示账号套餐用量；模型管理新增常见供应商预设，选预设后只需填 Key。
• Node 进程管理：设置页新增「进程」页签，常驻 / 子进程 / 疑似孤立三类分栏展示，支持精准查杀。
• 会话与标签体验：新建会话增加确认弹窗（覆盖当前标签 / 新标签页打开 / 取消）；标签页支持重命名；会话列表对等待审批或输入的会话显示红点角标。
• 消息操作增强：AI 回复支持一键重发（不可重发时说明原因）；排队消息支持上移 / 下移排序；粘贴长文本自动折叠为内联 chip。
• 其他：双击上下文圆环一键压缩上下文；模型连通性测试细化到单个模型。

修复

• 修复发送消息后会话思考级别被重置的问题（issue #25）。
• 修复润色功能无响应、长时间等待的问题：改为独立请求通道并支持取消，响应更稳更快。
• 修复重开会话后卡片状态显示异常（误报运行中、流式残留）的一族问题。
• 修复重启 IDE 后子代理卡片一直显示「运行中」的问题。
• 修复切换模型后顶部残留「已切换模型」提示横幅的问题。
• 修复后台任务通知卡不实时渲染（回合结束才出现）、插入位置错乱的问题。
• 修复 AI 完成通知误报（子代理仍在收尾就弹通知）与通知缺失会话名的问题（issue #24），并新增 AI 等待审批 / 输入时的系统提醒。
• 修复文件改动统计与 diff 视图口径不一致的问题（issue #23）。

移除

• 设置页不再展示凭证状态：加密凭证无法准确判定状态，纯展示容易误导。

---

Added

• Mobile remote sessions: view and control desktop IDE sessions from the Z.ai mobile app — task list, model selection and device naming work end to end; HTTP proxy environments are supported.
• Account-based provider channel: the model list gains a Z.ai subscription account channel (built-in, pinned at top) — OAuth sign-in is enough, no manual API key needed; the quota page now shows account plan usage. Model management also adds common provider presets where you only fill in the key.
• Node process manager: a new "Processes" tab in settings shows resident, child and suspected-orphan processes in three groups, with precise kill support.
• Session & tab UX: a confirmation dialog when creating a session (replace current tab / open in a new tab / cancel); tabs can be renamed; sessions waiting for approval or input show a red badge in the list.
• Message actions: one-click resend of AI replies (with a clear reason when resending is not allowed); queued messages can be reordered up/down; long pasted text folds into an inline chip.
• Others: double-click the context ring to compact the context; model connectivity tests now run per model.

Fixed

• Fixed the session thought level being reset after sending a message (issue #25).
• Fixed the enhance (polish) action hanging or waiting forever: it now uses a dedicated request channel with cancellation support, more stable and faster.
• Fixed a family of issues where reopening a session showed wrong card states (false "running", leftover streaming indicators).
• Fixed subagent cards stuck at "running" after restarting the IDE.
• Fixed the "model switched" banner lingering at the top after a model change.
• Fixed background-task notification cards not rendering in real time (only appearing after the turn ends) and being inserted at the wrong position.
• Fixed false "task completed" notifications (fired while subagents were still finishing) and notifications missing the session name (issue #24); added a system reminder when the AI waits for approval or input.
• Fixed inconsistent file-change statistics between the summary and the diff view (issue #23).

Removed

• The settings page no longer shows credential status: encrypted credentials could not be judged reliably and the display-only info was misleading.

---

安装：下载 ZC-GUI-0.3.8-signed.zip，IDE 内 Settings → Plugins → ⚙ → Install Plugin from Disk 选择安装。
Install: download ZC-GUI-0.3.8-signed.zip and install it via Settings → Plugins → ⚙ → Install Plugin from Disk.

ZC-GUI 0.3.7

适配 / Compatibility

• 适配 ZCode 3.14.0 客户端：修复新版 CLI 推送数组格式通知导致接收线程崩溃、会话全线超时的问题。

English

• ZCode 3.14.0 client compatibility: fixed array-format notification frames from the new CLI crashing the reader thread and taking down all sessions.

新增 / What's Added

• 计划与权限审批面板重做（issue #17）：审批弹窗改为停靠输入框底部，与询问弹窗同形态；计划审批不再超时自动拒绝，会一直等待处理，并展示计划摘要。
• 子代理通知卡改弹窗阅读：通知卡只保留摘要行，点击整行在阅读弹窗中查看成果全文，长文不再原地展开刷屏。
• SendMessage 消息卡友好渲染：子代理间通信消息以独立卡片展示。

English

• Redesigned plan & permission approval panels (issue #17): approval dialogs now dock above the input box, matching the ask-dialog style; plan approval no longer auto-declines on timeout — it waits indefinitely and shows a plan summary.
• Subagent notification cards open in a preview dialog: cards keep only the summary row; click to read the full result in a markdown preview dialog instead of expanding in place.
• Friendly rendering for SendMessage cards: inter-agent messages now render as dedicated cards.

修复 / What's Fixed

• 会话标题生成后不实时更新、或稍后被顶回初始标题：修复订阅建立首帧标题事件被多标签隔离门禁拦截的竞态，并增加列表快照防回退守卫与回合结束后的延迟重拉兜底。
• Linux 下客户端更新后「ZCode CLI 未找到」（issue #19）：探测路径覆盖新版客户端运行时布局；模型列表/刷新尊重手动配置的 CLI 路径；CLI 缺少内置渠道配置文件时启动前自动补齐；无法自动补齐时报错直接给出原因与修复方法，不再需要翻日志找第一现场。

English

• Fixed session titles not updating in real time after generation, or being reverted to the initial title shortly after: fixed a race where the first title frame was blocked by the multi-tab isolation gate, and added a list-snapshot anti-rollback guard plus delayed refreshes after each turn as a fallback.
• Fixed "ZCode CLI not found" after client updates on Linux (issue #19): detection now covers the new client runtime layout; the model list/refresh respects the manually configured CLI path; a missing built-in provider config is auto-seeded before launch, and when no source is available the error explains the cause and the fix instead of pointing at logs.

---

安装 / Install

下载下方 Assets 中的 ZC-GUI-0.3.7-signed.zip，IDE → Settings → Plugins → ⚙️ → Install Plugin from Disk 磁盘安装，兼容 2024.1–2026.3。

Download ZC-GUI-0.3.7-signed.zip from the Assets below, then install from disk via IDE → Settings → Plugins → ⚙️ → Install Plugin from Disk. Compatible with 2024.1–2026.3.

ZC-GUI 0.3.6

适配 / Compatibility

• 适配新版 ZCode 客户端：兼容新版 CLI（v2 协议代），新旧客户端自动判代，会话、编辑、模型切换全功能平滑过渡。
• 模型渠道全面改为自定义渠道：升级后插件自动把原有内置渠道迁移为自定义渠道（模型能力随迁，无需手动配置）；设置页「模型管理」支持渠道的新增、编辑、删除。

English

• New ZCode client support: compatible with the new CLI generation (v2 protocol), auto-detecting old/new clients so sessions, message editing and model switching all keep working across versions.
• Model channels moved to custom providers: after upgrading, the plugin automatically migrates existing built-in channels to custom ones (model capabilities carried over, no manual setup); channels can now be added, edited and deleted in Settings → Model Management.

新增 / What's Added

• 定时任务：AI 可直接创建与管理定时任务，任务执行卡片友好展示。
• 上下文增强（issue #13/#14）：回复支持复制 Markdown；控制台日志一键送入输入框；@ 引入文件支持文件夹、补全内联化。
• 记忆搜索：设置页记忆支持全文搜索，打开时与编辑器查找联动。
• 图片预览：大图支持滚轮缩放与拖拽平移；额度卡改为单行紧凑布局。

English

• Scheduled tasks: the AI can create and manage scheduled tasks directly, with friendly task cards.
• Context enhancements (issue #13/#14): copy replies as Markdown; send console logs to the input box with one click; @ file references support folders with inline completion.
• Memory search: full-text search over memories in settings, linked with the editor's find when opened.
• Image preview: zoom with the mouse wheel and drag to pan; quota card compacted to a single row.

修复 / What's Fixed

• 底部文件统计归零与右键菜单缺失（issue #15）。
• 设置页自动记忆读取不到，并新增记忆目录排查入口。
• 自动记忆条目摘要失效、冗余路径行，改为跟随 MEMORY 索引标题与顺序。
• 子会话首批内容偶发丢失（快照/首条内容被静默丢弃）。
• 「发送选中代码」无选区时右键菜单仍显示、点击无反馈。

English

• File stats showing zero and missing editor context menu (issue #15).
• Auto-memory entries not loading in settings, plus a new memory-directory troubleshooting entry.
• Auto-memory entry summaries broken and redundant path lines; now follows the MEMORY index titles and order.
• First batch of a sub-session occasionally lost (snapshot / first content silently dropped).
• "Send selected code" showed the context menu item with no selection and did nothing on click.

---

安装 / Install

下载下方 Assets 中的 ZC-GUI-0.3.6-signed.zip，IDE → Settings → Plugins → ⚙️ → Install Plugin from Disk 磁盘安装，兼容 2024.1–2026.3。

Download ZC-GUI-0.3.6-signed.zip from the Assets below, then install from disk via IDE → Settings → Plugins → ⚙️ → Install Plugin from Disk. Compatible with 2024.1–2026.3.

ZC-GUI 0.3.5

新增 / What's Added

• 会话引用：输入框输入 # 可引用历史会话（同时支持斜杠命令与技能补全），引用以 chip 形式嵌入消息发送，AI 可直接读取被引用会话的内容继续工作。
• 编辑消息全面升级：AI 回复生成中也能编辑已发送的消息（自动停止当前回合后重新生成）；带图消息支持编辑重发、图片自动回填；编辑交互与弹窗统一。
• 多图消息预览：用户消息带多张图片时，点开大图可左右切换查看。
• 网络代理支持（issue #12）：设置 → 基础设置 → 环境 新增「网络代理」——代理地址、不走代理的地址（可选）、CA 证书路径（可选）三项，保存后一键重启生效。插件与 ZCode 客户端共用同一份代理配置，模型请求与额度查询全部走代理。
• 模型切换卡显示供应商：切换模型的提示卡显示供应商名，多渠道时一眼可辨。

English

• Session references: type # in the input box to reference a previous session (slash commands and skills are also completed), sent as chips embedded in the message so the AI can directly read the referenced session's content.
• Message editing overhaul: edit a sent message even while the AI is still replying (the current turn is stopped and regenerated automatically); messages with images can be edited and re-sent with the images kept; unified editing entry and dialog.
• Multi-image preview: when a user message carries multiple images, open one and swipe left/right to browse.
• Network proxy support (issue #12): a new "Network Proxy" section under Settings → Basic → Environment — proxy URL, no-proxy list (optional) and CA certificate path (optional), with one-click restart to apply. The plugin shares the same proxy config with the ZCode desktop client; both model requests and quota queries go through the proxy.
• Provider name on model-switch card: the model switch card now shows the provider name, easy to tell channels apart.

修复 / What's Fixed

• 模型选择按会话隔离（issue #9）：每个会话独立记忆自己的模型，切换模型不再影响其他会话；排队消息按切换后的模型发送；修复冷启动切模型误报 -32603、切换中乐观转圈丢卡等问题。
• 升级后启动报错循环（issue #11）：修复 0.3.4 在部分环境启动即报错并循环重试的问题——环境未就绪时给人话指引而非崩溃循环，冷启动增加就绪探测。
• 思考块与工具组卡内部滚动：AI 回复生成中，向上滚动查看思考块/工具卡的历史内容不再被自动置底拉回。
• 取消引导假成功致消息重复发送：AI 回复生成中点「取消引导」，消息看似已撤回、实际仍会注入当前回合（删除排队消息同理）；现在撤销以服务端确认为准，注入完成后取消会明确提示，不再出现同一句话发两条。
• 其他：消息气泡内文件 chip 尾部多出一个路径字符；大会话冷启动恢复更顺（打开历史会话不再长时间无响应）；模型请求 UA 版本号对齐官方客户端。

English

• Model selection isolated per session (issue #9): each session remembers its own model, switching no longer affects other sessions; queued messages are sent with the switched model; fixed false "-32603" on model switch during cold start and cards lost while switching.
• Startup error loop after upgrade (issue #11): fixed 0.3.4 failing right at startup and retrying in a loop on some setups — a human-readable hint is shown instead of a crash loop, with a readiness probe on cold start.
• Inner scrolling of reasoning blocks and tool group cards: scrolling up inside them while streaming is no longer dragged back to the bottom.
• False-success on steer cancel caused duplicated messages: cancelling a steer message while the AI is replying looked successful while the message still got injected into the turn (same for deleting a queued message); the cancel result now follows the server's confirmation, a clear notice is shown when injection has already happened, and the same text is no longer sent twice.
• Miscellaneous: file chips in message bubbles no longer keep a trailing path character; cold start of large sessions recovers more smoothly (opening history no longer hangs); model request UA version aligned with the official client.

---

安装 / Install

下载下方 Assets 中的 ZC-GUI-0.3.5-signed.zip，IDE → Settings → Plugins → ⚙️ → Install Plugin from Disk 磁盘安装，兼容 2024.1–2026.3。装过 0.3.5-beta.1 的可直接覆盖升级。

Download ZC-GUI-0.3.5-signed.zip from the Assets below, then install from disk via IDE → Settings → Plugins → ⚙️ → Install Plugin from Disk. Compatible with 2024.1–2026.3. Upgrading from 0.3.5-beta.1 in place is fine.

ZC-GUI 0.3.5-beta.1

正式版 0.3.5 已发布：请到 ZC-GUI 0.3.5 下载安装，本预发布仅作存档。

The final 0.3.5 release is out: grab it from ZC-GUI 0.3.5; this pre-release is kept for reference only.

测试版（预发布）：网络代理支持（issue #12），含 0.3.5 全部功能走查。

主要变化：

• 设置 → 基础设置 → 环境 新增「网络代理」：代理地址、不走代理的地址（可选）、CA 证书路径（可选）三项，保存后一键重启生效。与 ZCode 客户端共用同一份代理配置，模型请求与额度查询全部走代理。
• 会话引用：输入框输入 # 引用历史会话（支持斜杠命令与技能补全），引用以 chip 形式嵌入消息。
• 编辑消息升级：AI 回复生成中也能编辑已发送的消息（自动停止当前回合重新生成）；带图消息编辑重发、图片自动回填。
• 多图消息预览：多图消息点开大图可左右切换。
• 模型切换卡显示供应商名。
• 模型选择按会话隔离（issue #9）：每个会话独立记忆模型，切换不再串会话；排队消息按切换后模型发送。
• 修复升级后启动报错循环（issue #11）、思考块/工具组卡流式期间内部滚动被拉回等问题。

完整清单见 CHANGELOG。装了正式版 0.3.4 的可以直接覆盖安装；有问题欢迎在 issue 里反馈。

English:

Pre-release build: network proxy support (issue #12), with everything else planned for 0.3.5.

• New "Network Proxy" section under Settings → Basic → Environment: proxy URL, optional no-proxy list and CA cert path, one-click restart to apply. Shares the same proxy config with the ZCode desktop client; model requests and quota queries all go through the proxy.
• Session references: type # to reference a previous session (slash commands / skills completed too), sent as chips.
• Message editing overhaul: edit sent messages even while the AI is replying; image messages keep their images on edit.
• Multi-image preview with left/right swiping.
• Provider name on the model-switch card.
• Model selection isolated per session (issue #9).
• Fixed the startup error loop after upgrading (issue #11) and inner scrolling of reasoning/tool-group cards during streaming.

See CHANGELOG for the full list. Upgrading over 0.3.4 in place is fine; feedback welcome in the issues.

ZC-GUI 0.3.4

新增 / What's Added

• 历史会话归档与自动归档：历史视图新增「已归档」页签——不常用的会话可手动归档收起、随时还原，已归档会话也可删除；开启自动归档后，超过保留天数的已完成会话自动移入归档（开关与保留天数和 ZCode 客户端共享），每次自动归档有记录可查。
• 排队消息支持图片：AI 生成中发送的带图消息正常排队（卡片显示图片徽标），编辑回填不再丢图。
• 询问用户弹窗升级：弹窗停靠面板底部、可折叠最小化，不再遮挡对话；默认一直等待回答（不再 5 分钟超时强制继续），也可在设置中开启「提问自动继续」恢复超时自动继续；回合结束后提问工具卡可回看——点开即见当时的问题与你的回答（多问题翻页展示）。
• 任务执行中也可分叉：会话分叉不再要求等待回合结束，AI 执行任务时可随时从历史回复分叉出新会话。
• 状态栏可折叠：输入框底部状态栏（模型/上下文/额度）可从工具条收起，折叠状态重启后保持。
• 内置渠道自定义 API Key（issue #8）：团队套餐用户可在设置「模型管理」为内置渠道手动指定 API Key（插件自有配置 ~/.zcgui/config.json，渠道地址与模型清单仍自动跟随客户端）；模型卡片显示当前实际计费的 Key（脱敏展示、可点眼睛查看全部）及来源（自定义 / ZCode 配置 / OAuth），套餐用量页的查询凭证同步显示；客户端选中团队套餐但未配置 Key 时，输入框与卡片给出计费提醒，一键直达配置；清空自定义 Key 即恢复客户端原有计费方式。

English

• History archive & auto-archive: The history view gains an "Archived" tab — archive sessions you rarely use and restore them anytime, or delete archived ones for good. With auto-archive enabled, completed sessions older than the retention window move to the archive automatically (the switch and days are shared with the ZCode client), and every sweep is logged.
• Images in queued messages: Messages with images sent while the AI is generating now queue properly (the card shows an image badge), and editing no longer loses the attachments.
• Ask-user dialog overhaul: The dialog docks at the bottom of the panel and can be minimized so it no longer covers the conversation. It now waits for your answer indefinitely by default (no more 5-minute forced timeout); opt into "auto-continue" in settings to restore the timeout. After the turn ends, the question tool card becomes a reviewable record — click it to see the questions and your answers, paginated.
• Fork while a task is running: Session forking no longer requires the turn to finish — fork from any earlier reply even while the AI is working.
• Collapsible status bar: The status bar below the input box (model / context / quota) can be collapsed from the toolbar; the state survives restarts.
• Custom API Key for built-in providers (issue #8): Team-plan users can now assign a custom API Key to a built-in provider in Settings → Model Management (stored in the plugin's own ~/.zcgui/config.json; the endpoint and model list still follow the client config). The provider card shows the key actually used for billing — masked by default, reveal via the eye icon — along with its source (custom / ZCode config / OAuth), and the usage page shows the same for its query credential. When a team plan is selected but no team key is configured, the input box and the card warn that requests are billed to the personal key, with a one-click shortcut to configure it. Clearing the custom key restores the client's original billing.

修复 / What's Fixed

• 团队套餐误显示为个人套餐（issue #8）：团队套餐用户在模型选择器与设置页的套餐徽章此前错误兜底显示「个人套餐」，现已正确识别为「团队套餐」。
• 模型设置栏信息显示不全：渠道卡片信息过长被截断，现改为头部两行制并允许徽章换行。
• IDE 2026.1 兼容性：消除插件验证器自 2026.1 起报告的 ReadAction 弃用警告。
• 远程开发兼容（issue #6）：Gateway/WSL 远程开发下不再误报「浏览器调试通道不可用」，浏览器控制卡明示远程环境下浏览器工具不可用。

English

• Team plans shown as personal plan (issue #8): For team-plan users the plan badge in the model selector and settings wrongly fell back to "Personal plan"; it is now recognized as "Team plan".
• Model settings cards truncated: Channel cards clipped long info; the header is now two-line and badges can wrap.
• IDE 2026.1 compatibility: Resolved ReadAction deprecation warnings reported by the plugin verifier since 2026.1.
• Remote development compatibility (issue #6): No more false "browser debug channel unavailable" banner under Gateway/WSL remote development; the browser control card now makes clear that browser tools are unavailable in remote sessions.

---

安装 / Install

下载下方 Assets 中的 ZC-GUI-0.3.4-signed.zip，IDE → Settings → Plugins → ⚙️ → Install Plugin from Disk 磁盘安装，兼容 2024.1–2026.3。

Download ZC-GUI-0.3.4-signed.zip from the Assets below, then install from disk via IDE → Settings → Plugins → ⚙️ → Install Plugin from Disk. Compatible with 2024.1–2026.3.