# 功能实现状态

更新日期：2026-10-27。最近已发布版本为 1.0.0；npm latest 与发布包完整性已核验，代码与设置已安装本机 desktop/web。本文区分发布状态、实现状态和待办，作为需求文档的状态入口。受控页面通过不代表原生客户端全部视觉与性能已验收，发布检查见[发布文档](../engineering/发布.md)。

## 已发布

| 功能 | 对应版本 | 当前范围与设计 |
| --- | --- | --- |
| 品牌标识质感、蓝红预设与鲸鱼喷水 | 0.5.0 | 两套内置配色，侧栏周期喷水、新会话入场后单次喷水；见[品牌设计](品牌质感预设设计.md) |
| 输入框混色细边与聚焦柔光 | 0.2.0 | 未聚焦时保留细边，聚焦后发光；页面丝带有独立开关 |
| 输入与流式光标、逐字点亮 | 光标自早期版本提供；逐字反馈为 0.3.0 | 逐字反馈可独立关闭；见[逐字波浪设计](文字逐字波浪需求设计.md) |
| 新会话粒子、标题描边与辅助控件 Echo | 0.3.0 | 主动画完成后辅助控件入场；见[输入与新会话设计](输入与新会话动效设计.md) |
| 运行会话星河、分组折叠、左右面板过渡 | 0.4.0 | 保留原生状态图标与业务操作；见[面板与会话列表设计](面板与会话列表动效设计.md) |
| 页面级新会话丝带 | 0.6.0；缩放定位修正为 0.6.2 | 聚焦时从左下流入、绕过输入框并向右上舒展，失焦淡出；采用 SVG 美术与 WebGPU 网格 |
| 发送按钮两圈水纹 | 0.6.1；缩放定位修正为 0.6.2 | 与发送模式独立，支持键盘和仅附件发送；见[发送反馈设计](发送反馈设计.md) |
| 流光、水滴、文字消解与小幽灵发送 | 水滴等为 0.2.0；流光及水滴细化为 0.7.0 | 默认流光，已有有效选择保留；首次发送支持输入框归位，目标消息背景与文字共同显现；见[流光发送需求](流光发送需求.md) |
| 设置分区、独立开关与草稿保存 | 0.4.0 | 设置保存后热生效，插件代码更新仍需重启；见[设置页设计](设置页重构设计.md) |

## 1.0.0 已发布

| 功能 | 当前实现 | 验证边界 |
| --- | --- | --- |
| 四档综合性能偏好 | 性能优先、均衡、画质优先、极致画质；默认均衡，参数来自同一预算表 | 配置兼容、宽窄布局和 WebGPU 管线已完成受控验证；实际设备体验待确认 |
| 统一绘制调度与窗口暂停 | 星河、页面丝带、入场粒子、发送转场共享调度；失焦、隐藏及减少动态时暂停或清理 | 不表示所有 CSS 动画都进入脚本限帧；详见[性能架构](../engineering/动效性能架构.md) |
| 设置页自身轻反馈 | 单行按钮组和参数 tip、分区原位渐亮、选项及保存成功时短反光 | 无卡片浮动，跟随减少动态；已受控验证，原生观感由用户确认 |
| 绘制开销优化与诊断 | 星河缓存与计算复用、按档位分配光带资源，排查区显示绘制状态 | 受控测量不能代替真实客户端整体占用，实际候选包新装、升级与设置保留检查已完成；原生视觉确认另计 |

## 1.0.0 已发布短过渡

| 功能 | 当前实现 | 验证边界 |
| --- | --- | --- |
| 居中弹框统一过渡 | 内容轻缩放淡入，关闭后局部快照短淡出；遮罩保留宿主行为 | 已核对原生弹框语义与立即卸载生命周期，受控浏览器验证；原生观感待确认 |
| 菜单与浮层过渡 | 已验证原生菜单及提示浮层按触发方向揭示、关闭淡出，保留子菜单定位 | 不覆盖没有已验证语义钩子的任意第三方浮层 |
| 会话选中切换 | 同树邻近底板平滑交接，远距离与跨树就地淡入，快速切换接续 | 不移动文字、不改变选中逻辑；滚动和缩放取消局部过渡 |

三项均可独立关闭，默认开启；旧设置继承相关关闭意图。空闲会话柔光尚未定案。

发送流光的现行交付链路已完成并于 0.7.0 发布，不再单列“连续交棒精修”待办；早期更细的形变、变速设想仅保留为历史探索，后续迭代需重新确认范围。

效果演示与设置页局部预览暂缓，后续是否接入另行确认。官方设置卡片通道迁移、部署默认与锁定层属于工程规划，不列作待实现特效。

## 运行光团（体积材质接入，待客户端验收）

2026-10-27，用户确认运行光团及外围柔光的放大效果稿，图片已存入工程。目标是以柔软变形的蓝青、珊瑚粉光团替换左侧运行圆环，与底部星河协调；不是新业务状态。工作区已有 Canvas 渐变叠加试作及宿主接入框架，但视觉未达到定稿，尚未验收；已发布的 1.0.0 仍为原有圆环。已按用户认可的圆润体积材质原型接入共享 WebGL2 小画布，内部翻涌与约 4 秒红蓝交替共用预览 shader，再合成至星河行画布；复用共享调度与性能档位。待重启真实客户端验收，不声明已达到最初确认稿。

入口：[需求与定稿图](会话运行光团需求.md) · [实现设计](../engineering/会话运行光团实现设计.md)。先完成静态 SVG 美术，再用共用绘制器核对真实图标尺寸与动态层次，最后接入原生状态和性能预算。不得将静态效果稿或方案参数写成已实现能力。

## 工具执行动效（1.2.0 已发布，待客户端验收）

2026-10-29，已接入通用读取、搜索、修改行与命令执行图标周围的柔光、原位完成收束和正文展开反馈，设置增加独立开关并默认开启。保留原生日志、错误和停止状态，不改变收起卸载、布局与点击。历史完成项不补播，快速完成跳过持续装饰，同屏最多两处持续柔光；未知、提问和多根嵌套结构跳过。

[产品设计](工具执行动效设计.md)与[实现设计](../engineering/工具执行动效实现设计.md)记录现行边界。`docs/demo/tool-motion.html` 是独立设计原型，真实构建验证由 `tools/verify-tool-motion.mjs` 执行，不能把原型当成客户端验收。

## 阅读历史设计的规则

旧文档中的“当前”“本轮”“待实现”通常对应当时的阶段。页首状态与本文优先于历史实施流水；不能据此把已发布的丝带、水纹、流光发送、分组开合等重新列为待做。技术预算以[性能架构](../engineering/动效性能架构.md)和 `src/client/core/performance.ts` 为准，不沿用早期的固定效果数量或固定粒子数。