fireworks-release-0.2.0

0.2.0 — 2026-10-24

中文

新增

• 新增插件详情页动画设置，支持独立脚本内置模板（含“鲸跃烟火”默认模板）、自定义 JavaScript 脚本导入、全屏预览验证、下载和 AI 生成提示词。
• 抽出通用 Canvas 动画渲染层，统一提供时间轴、绘图助手、隔离 Worker、超时与资源清理；toast 和会话跳转继续独立管理。
• 新增拟真 Canvas 粒子烟花秀（Realistic Canvas celebration shows），支持色彩混合与透明叠加，提供 Poisson 随机发射调度、模式切换（Emoji / Realistic）及彩蛋几率触发。
• 通过 clutch_fireworks/launch 事件在整个 DSH 窗口播放礼花，支持后台 Session 和跨页面排队。
• 新增可点击跳转到来源 Session 的庆祝 toast，刷新不重播，短暂断线按有效期补收。
• 新增插件原创 SVG 图标与高清截屏视觉文档。

优化

• 自定义脚本保存为 $DSH_HOME/clutch-dsh-fireworks/animations/<sha256>.js 私有文件；Host 设置只存相对路径、选择和显示元数据，旧全文配置在下次更新时迁移，备份需包含脚本目录。
• 点击动画卡片立即持久化选择，无需单独保存；紧凑自适应卡片统一浅深主题，预览使用圆形进度/停止控件，不改变当前选择。
• 导入先校验脚本头、大小、语法、render 入口和有界首帧，再提供可选全屏预览；确认添加才保存并启用，取消不写入，已知预览失败需重试成功。删除在原操作栏内二次确认，配置更新成功后只清理不再被其他模板或 profile 引用的文件；删除当前项切回 Emoji。
• 文件丢失或损坏时保留名称/时长及仅能删除的损坏卡片；Host 持久化回退到 Emoji，旧路径配置自动补齐元数据，只读或恢复写入失败时提示仅临时回退，旧页面缓存不能重建已删除文件。
• 每个排队事件实际开始前重新读取 Host 设置并检查文件，再捕获模板；跨页面切换、删除或文件损坏会影响下一事件，当前事件继续使用已捕获模板。刷新等待最多 5 秒，过期、超时或卸载会取消等待并隔离迟到响应，避免重播旧脚本。
• 优化庆祝 Toast 视觉材质与交互反馈，精炼 AI 动画生成提示词。
• 使用 DSH 原生 Remote stream 复用共享 WebSocket，撤除插件 SSE、心跳与空闲计时器；运行时注册随插件启停清理，保留静默刷新、游标补收和完整事件队列。
• 按完整事件串行播放动画与 toast，两条链路都结束后才推进下一事件；增加固定 12 秒超时、不重试及迟到回调隔离。
• 保留实际窗口的 CSS 像素宽高，以统一 DPR 控制 800 万像素预算，避免超宽或超高窗口非等比拉伸。
• 通过有界 sprite 缓存复用 emoji 与发光圆点位图，DPR 变化时刷新、超限后直接绘制；跳过不可见粒子并保留随机序列，减少重复栅格化、模糊和逐帧计算。
• 使用已鉴权的原生 Gateway，最低支持 DSH 0.2.1-rc.1，并将 peer 依赖更新至 0.2.1 系列。

修复

• 修复减少动态效果模式下的窗口缩放：保留可见画布，窗口尺寸或 DPR 改变时重绘静态中点帧，并继续独立验证完整时间轴，不重置播放期限。
• 修复减少动态效果的生命周期：静态中点帧保留至配置时长结束，完整时间轴在离屏画布验证，避免中点后出错的自定义脚本被误判通过。
• 修复深色主题下动画 iframe 配色模式不一致导致的白屏遮挡；预览和工具调用共用播放入口、渲染组件与生命周期。
• 修复独立 RPC 通道路由因 Cordis 服务依赖边界注册失败而无法展示烟花的问题；通过真实 Cordis/Connection 回归测试及已安装 DSH 的浏览器验收。
• 修复 configForms 快照结构兼容性，确保表单配置稳定读取。

English

Added

• Add animation settings on the plugin details page: standalone built-in scripts (including the default "Whale Show"), custom JavaScript imports, full-screen preview verification, downloads, and an AI generation prompt.
• Extract a reusable Canvas animation layer with timing, drawing helpers, isolated Workers, watchdogs and cleanup; keep toast and Session navigation independent.
• Add realistic canvas particle celebration shows featuring theme-aware blending, transparent overlays, and event-driven teardown; introduce Poisson launch scheduling with configurable duration and rate, mode switching (Emoji vs. Realistic), and splash shell rolls.
• Play global fireworks across the whole DSH window through clutch_fireworks/launch, including background Sessions and queued celebrations across app pages.
• Add clickable toasts that open the source Session, with silent refresh baselines and bounded reconnect catch-up.
• Add an original SVG plugin icon and refresh visual documentation screenshots.

Improved

• Store custom scripts as private $DSH_HOME/clutch-dsh-fireworks/animations/<sha256>.js files; Host settings keep only relative paths, selection and display metadata. Migrate legacy inline source on the next update, and include the script directory in backups.
• Persist card selections immediately without a separate Save step; compact responsive cards share light/dark styling, and preview uses a circular progress/stop control without changing the active selection.
• Validate import headers, size, syntax, render entry and a bounded first frame before offering optional full-screen preview. Only Confirm Add saves and activates; Cancel writes nothing, and known preview failures require a successful retry. Confirm deletion in the existing action bar; after settings commit, remove only files no longer referenced by other templates or profiles. Deleting the active template selects Emoji.
• Retain missing/damaged files as delete-only cards with name/duration metadata. The Host persists Emoji fallback, backfills metadata for old path-only settings, and reports temporary fallback when read-only settings or recovery writes prevent persistence. Stale page caches cannot recreate deleted files.
• Refresh Host settings and file availability before each queued event actually starts, then capture its template. Cross-page selection, deletion or file damage affects the next event while the current event retains its captured template. Bound refresh waits to five seconds; expiry, timeout or unload cancels the wait and isolates late responses so stale scripts cannot replay.
• Refine celebration toast material and AI animation prompt.
• Reuse DSH's shared WebSocket through native Remote streams; remove plugin SSE, heartbeats and idle timers. Scope runtime registrations to plugin lifecycle while retaining silent refresh, cursor catch-up and complete-event serialization.
• Serialize animation and toast as complete events; advance after both branches finish, with a fixed 12-second deadline, no retries, and stale-callback isolation.
• Preserve actual window dimensions in CSS pixels and bound the 8-million-pixel budget through a uniform DPR, avoiding aspect-ratio distortion in very wide or tall windows.
• Reuse emoji and glowing-circle bitmaps through a bounded sprite cache, refreshing on DPR changes and drawing directly on overflow; skip invisible particles while preserving random sequences to reduce repeated rasterization, blur and per-frame calculations.
• Use the authenticated native Gateway, requiring DSH 0.2.1-rc.1 and aligning peer dependencies with the 0.2.1 line.

Fixed

• Fix reduced-motion resizing: retain visible canvas, redraw its static midpoint when window dimensions or DPR change, and continue independent full-timeline validation without restarting playback.
• Fix reduced-motion lifecycle: retain static midpoint for the configured duration and validate the full timeline offscreen, so custom scripts failing after the midpoint cannot pass validation.
• Fix opaque white animation viewport in dark themes by matching iframe and document color schemes; share playback entry, surface and lifecycle between preview and tool launches.
• Fix missing fireworks caused by Cordis dependency boundaries preventing dedicated RPC route registration; verify with real Cordis/Connection regression coverage and browser checks in installed DSH.
• Fix support for both configForms snapshot shapes to ensure stable configuration reading.

title-release-0.1.7

0.1.7 — 2026-10-18

中文

修复

• 适配 DSH 0.2.1 架构与生命周期变更，完善 Provider 独立策略与 Remote 挂载，并修复官方 RC 下会话持久化与结构化提取修复问题。

优化

• 将支持的最低 DSH 版本基线提高至 dsh-v0.2.1-rc.1，更新 peerDependencies 至 >=0.2.1-rc.1 并对齐 Cordis 依赖至 ^4.0.5。

English

Fixed

• Align provider, Remote mounting, and lifecycle integration with DSH 0.2.1, resolving session persistence and structured extraction repair issues across official RCs.

Improved

• Raise the minimum DSH compatibility floor to dsh-v0.2.1-rc.1, update peerDependencies to >=0.2.1-rc.1, and align Cordis peer dependency to ^4.0.5.

worktree-release-0.1.18

0.1.18 — 2026-10-14

中文

新增

• 支持以远端跟踪分支和本地分支作为 Worktree 创建基线与看板比对基线，并提供一键获取远端分支（Fetch Remote）能力。
• 提取并统一带虚拟化列表与延迟过滤的单选搜索选择器（SearchableSingleSelect），用于分支选择、导入绑定与看板基线切换。
• 看板新增本地基线比对与分页 Git 提交历史查看能力。
• clutch_list_worktrees 工具契约扩展返回当前仓库的本地与远端分支列表。

优化

• 优化分支选择器的候选分支缓存、后台预取与按需延迟读取机制，提升新建与导入弹窗的响应速度与交互稳定性。
• 统一创建与导入弹窗的输入框高度与布局，并消除下拉菜单展开时的容器高度抖动。
• 在桌面端插件打包产物中内联捆绑 zustand 与 immer，避免桌面环境外部模块解析失败。

修复

• 修复主工作区（main checkout）识别、非主 Worktree 投影与 HEAD 授权边界，避免分离 HEAD 或非常规分支下的工作树状态异常。
• 修复改动文件列表中点击打开原生侧栏 Git Diff 的文件路径投影，确保子目录 Workspace 与仓库根目录对齐。

English

Added

• Support remote tracking branches and local branches as baselines for Worktree creation and Dashboard comparisons, along with a one-click fetch remote branches capability.
• Extract a unified searchable single selector (SearchableSingleSelect) with list virtualization and deferred candidate matching for branch selection, worktree import, and baseline switching.
• Add local baseline comparisons and paged Git commit history browsing to the Worktree Dashboard.
• Extend the clutch_list_worktrees tool schema to return repository local and remote tracking branches.

Improved

• Optimize branch selector caching, background prefetching, and on-demand branch loading to improve dialog responsiveness and interaction stability.
• Align dialog layouts and input field sizing across create and import modals, eliminating dropdown height jumps.
• Bundle zustand and immer directly into the desktop client distribution to prevent external dependency resolution errors in desktop environments.

Fixed

• Fix main checkout recognition, non-main worktree projections, and HEAD authorization guards under detached HEAD or alternative checkout states.
• Fix file path resolution when opening Git diffs in the native sidebar file viewer, ensuring subdirectory workspaces correctly align with the repository root.

worktree-release-0.1.17

0.1.17 — 2026-10-11

中文

新增

• 提供 Agent 原生 Worktree 工具集（clutch_new_worktree、clutch_list_worktrees、clutch_span_worktree、clutch_list_models、clutch_list_sessions、clutch_send_message）与斜杠命令，支持多 Worktree 任务派发、主动结果报告与会话状态联动。
• 支持位于 Git 仓库子目录中的 Workspace 根目录，引入 v7 Sidecar schema 准确识别 Git 根路径与子目录相对层级。
• 新增设置页错误恢复面板与诊断历史记录，并通过 Toast 通知呈现界面异常与可操作的恢复指引。
• 通过配置钩子和生命周期事件动态管理权限预设，并在预设未就绪时提供主动的 Host 重启指引。
• 侧栏导航新增平滑浮动滚动条（Overlay Scrollbar）与长标题 hover 跑马灯动效。

优化

• 基于原生 DSH turn 记录精准解析并展示会话完成与运行状态指示点。
• 对齐侧栏行操作图标、高亮选中的工作区文件夹图标，并统一设置面板与原生控件的排版和字号缩放。
• 将委托任务结果通知由轮询转为主动推送机制，并严格约束派发控制与令牌生命周期。

修复

• 基于通用 AppFrame 语义锚点和拓扑回溯统一侧栏与 Dashboard 布局定位，修复额外标题栏或非紧邻壳层节点导致的导航零高度和看板无法打开，加固桌面外壳（Desktop shell）底栏锚点与布局恢复。
• 修复子目录 Workspace 下 Session 真实 cwd 别名解析与历史 Session 预览丢失问题。

English

Added

• Provide native Agent Worktree tools (clutch_new_worktree, clutch_list_worktrees, clutch_span_worktree, clutch_list_models, clutch_list_sessions, clutch_send_message) and slash commands, enabling multi-worktree task delegation, pushed result reports, and session state coordination.
• Support Workspace roots located in Git repository subdirectories, introducing a v7 Sidecar schema to accurately resolve Git roots and relative subdirectory paths.
• Add an error recovery panel and diagnostics history in Settings, and surface interface errors with actionable recovery guidance via toast notifications.
• Manage permission presets dynamically via configuration hooks and lifecycle events, offering proactive Host restart guidance when presets require activation.
• Add an overlay scrollbar and hover title marquee animation to the sidebar navigation.

Improved

• Resolve session completion and running status indicators directly from native DSH turn records.
• Align sidebar row action icons, active workspace folder icon highlights, and settings panel styling and font-size scaling with native controls.
• Transition delegated task result reporting from transcript polling to a pushed reporting model with strict delegation control and token lifecycle guards.

Fixed

• Unify Sidebar and Dashboard layout resolution around public AppFrame anchors and topological ancestry, fixing zero-height navigation and Dashboards failing to open with extra titlebars or nonadjacent shell nodes, while hardening desktop shell footer anchoring and layout recovery.
• Fix session cwd alias validation and preserve legacy session previews for subdirectory workspace roots.

worktree-release-0.1.16

0.1.16 — 2026-10-02

中文

新增

• 当插件组合层不可用或断开连接时，在界面提示用户重启 Host。

优化

• 侧栏采用磨砂玻璃质感与平滑折叠动效展示 Worktree 与 Session 树形结构，并排除窗口顶部拖拽区域对侧栏 overlay 锚点的影响。
• 优化 Dashboard 顶部栏布局与粘性吸顶交互，保持滚动时基线与关键操作常驻可见。

修复

• 完善 Workspace 根目录缺失时的状态分类，仅在确认物理缺失时保留 Sidecar 列表与指令读取，Git 相关读取呈现明确的缺失状态并拦截破坏性操作。
• 修复 Main Dashboard 中查看已提交改动时未能正确从 Git root 读取文件的问题。

兼容性

• 最低 DSH 兼容版本升级至 dsh-v0.2.0-rc.1（peerDependencies >=0.2.0-rc.1），并隔离 Client UI remote 类型图以保证 Host 构建稳定。

English

Added

• Prompt users with a toast notice to restart Host when the plugin composition layer is unavailable or disconnected.

Improved

• Present the sidebar with a frosted glass surface and smooth expansion animations, excluding window drag chrome from overlay anchoring.
• Optimize the Dashboard top bar layout with sticky headers so baselines and primary controls remain visible while scrolling.

Fixed

• Classify Workspace root stat errors precisely, keeping sidecar-backed list and instruction reads visible while presenting a dedicated missing state for Git operations and guarding destructive actions when the root is missing.
• Fix Main Dashboard committed file reads by resolving paths against the Git repository root.

Compatibility

• Bump the minimum DSH compatibility floor to dsh-v0.2.0-rc.1 (peerDependencies >=0.2.0-rc.1) and isolate Client UI remote types during Host builds.

title-release-0.1.6

0.1.6 — 2026-10-02

中文

新增

• 新增模型输出不可用时的自动修复机制与重试次数配置（0–3 次），并在 Token 统计中包含实际消耗的重试调用。
• 新增设置中心异常诊断与错误日志面板，支持查看累计异常、重试与修复成功次数、最近 10 条异常详情及独立重置。
• 新增插件客户端已加载但 host 服务不可用时的原生重启提示 Toast，提醒及时重启 DSH 服务。

优化

• 将支持的最低 DSH 版本基线提高至 dsh-v0.2.0-rc.1，并将 peerDependencies 更新为 >=0.2.0-rc.1。

English

Added

• Add automatic output repair with configurable retry attempts (0–3) for unusable model responses, including consumed retry calls in token statistics.
• Add diagnostics and error log panel in Settings, supporting cumulative counts, recent 10 incident details, and independent error log reset.
• Add native restart reminder toast when plugin client is loaded but host service is unavailable.

Improved

• Raise the minimum DSH compatibility floor to dsh-v0.2.0-rc.1 and update peerDependencies to >=0.2.0-rc.1.

title-release-0.1.5

⚠️ 重要提示 / Important Notice

中文： 0.1.4 版本存在 Bug（字段提取消息来源导致 DSH 0.1.7 会话重新加载与 format v4 关系校验失败），已在 0.1.5 版本中彻底修复，务必升级到 0.1.5！

English: Version 0.1.4 contains a critical bug causing session reload and format v4 validation failures under DSH 0.1.7. This has been resolved in 0.1.5. Please be sure to upgrade to 0.1.5!

---

0.1.5 — 2026-09-27

中文

修复

• 优化标题提取包装消息来源为 DSH 原生 dsh-session-title-llm 类型，解决 DSH 0.1.7 会话重新加载时的 format v4 关系校验失败问题，并保留 clutch-dsh-title 标题提供者标识。
• 修复 0.1.4 版本中相关 Bug，建议所有 0.1.4 用户立即升级到 0.1.5。

English

Fixed

• Set the title extraction wrapper message source to DSH native dsh-session-title-llm to resolve format v4 validation errors during session reload, while retaining clutch-dsh-title as the title provider identity.
• Fix critical session reload bug present in 0.1.4; all users on 0.1.4 should upgrade to 0.1.5 immediately.

fireworks-release-0.1.4

0.1.4 — 2026-09-26

中文

修复

• 适配 DSH 0.1.7 会话 API 与主视图选定会话变更，并在会话状态异常或缺失时提供安全回退。
• 将 DSH 依赖基线更新为 >=0.1.7-rc.1，并对齐 Cordis ^4.0.1 peer 依赖范围。

English

Fixed

• Adapt to DSH 0.1.7 session APIs and main-view session selection, with safe fallback when session state is malformed or absent.
• Update DSH peer dependency baseline to >=0.1.7-rc.1 and align Cordis peer dependency range to ^4.0.1.

worktree-release-0.1.15

0.1.15 — 2026-09-27

中文

优化

• 全面适配 DSH 0.1.7 系列版本（支持 >=0.1.7-rc.1 及已验证的 0.1.7-rc.2），更新 Session 导航、重命名与选中适配层，兼容 DSH 1.7 移除 current 字段后的 mainView 归属与 using() 生命周期。
• 采用 producer-owned 指令来源 plugin:@cerbur/clutch-dsh-worktree 注入 Worktree 与 Main 指令，并向前兼容读取 DSH 历史指令来源。
• 桥接 TypertLookup 生成元数据，提升在新版 DSH typert 协议下的类型与 RPC 生成稳定性。

English

Improved

• Add full compatibility for DSH 0.1.7 releases (supporting >=0.1.7-rc.1 and the verified 0.1.7-rc.2 release graph), adapting Session navigation, rename, and selection to handle DSH 1.7's mainView retention and using() lifecycle without the deprecated current field.
• Use producer-owned instruction source plugin:@cerbur/clutch-dsh-worktree when injecting Worktree and Main instructions, while retaining backward-compatible recognition of historical sources.
• Bridge TypertLookup in typert protocol metadata for resilient type and RPC descriptor generation under newer DSH runtimes.

title-release-0.1.4

0.1.4 — 2026-09-26

中文

优化

• 适配 DSH 0.1.7 架构与 API 变更，支持可合并扩展的消息来源类型与 profile 驱动的 volatile 设置表单。
• 将 DSH 依赖基线更新为 >=0.1.7-rc.1，并将 Cordis 依赖范围调整为 ^4.0.1。
• 将预设 emoji 模板描述长度上限规范为 64 字符，并使用插件内置 SVG 图标替换已废弃的 UI Primitives 图标。

English

Improved

• Support DSH 0.1.7 architecture and API updates, including merge-extensible LLM message sources and profile-backed volatile settings forms.
• Update DSH peer dependency baseline to >=0.1.7-rc.1 and broaden Cordis peer range to ^4.0.1.
• Standardize description length limit for the preset emoji template to 64 characters and replace retired UI Primitives icon with a title-owned SVG.