【功能建议/已附源码补丁】聊天头像 Thinking / Streaming 动态状态 Hook

[cccloudK]

我想建议为 Operit 的 Bubble 聊天头像增加一个很轻量的 AI 回复状态动画 Hook。

目前在 AI 已开始处理请求、等待首个 token，以及正在流式回复时，角色头像基本保持静态。希望可以通过头像本身提供更直观的状态反馈，例如：

• Processing / waiting first chunk：头像进行轻微的柔和形变动画
• Streaming / receiving：保持动态，并稍微提高动画节奏
• Idle：平滑恢复静态
• 可选扩展：增加非常克制的 Halo 光环效果

我已经尝试把这一功能拆成一个尽量独立、低侵入性的 host-side patch，并把源码补丁附在本帖。

补丁主要包括：

• ChatAvatarDecoration request/result contract
• Jetpack Compose 原生头像动画 Host
• ToolPkg avatar decoration hook
• Bubble 聊天中等待首个 token 时保留头像、隐藏空白正文/元数据
• ToolPkg TypeScript API declaration
• fallback / sanitization / patch applicator 等相关测试

设计原则是尽量不修改 Operit 的模型请求、stream transport、消息持久化、角色提示词、记忆、世界书或工具调用。

如果没有启用对应 Hook，目标是直接回退到当前静态头像行为，不改变现有使用体验。

附件中的 apply_core_patch.py 主要用于说明和辅助集成，不要求维护者直接使用。如果当前 dev 分支的代码结构已经变化，也可以只参考其中的 contract / Compose host / ToolPkg plumbing，按照现有项目结构重新实现。

当前附件已经完成的独立验证：

• Node patch applicator tests：6/6 passed
• Kotlin contract tests：passed
• 已清理个人配置和本地敏感信息

需要说明的是：我这边没有针对当前最新 dev revision 完成完整 Android/Compose 集成构建，因此它更适合作为一个已经实现的 upstream patch proposal，而不是声称可以直接无修改 merge 的最终 PR。

如果这个方向适合 Operit，希望作者可以考虑将这个轻量 Hook 或等价实现纳入官方。具体内部实现方式以作者认为更符合当前架构的方案为准。
operit-avatar-motion-upstream-clean.zip

[3316891527]

感谢详细的建议和完整的源码补丁。我们已经仔细审阅了你提供的方案。

目前已有类似的实现，是一个更完整的浮窗小部件系统（已有 PoC 实现），以插件接口的形式实现；该系统不仅可以提供包括头像状态、动态反馈等交互体验，还支持：

• 跨应用浮窗显示（不受聊天界面限制）
• 丰富的交互方式（拖拽、点击、长按等）
• 实时状态同步和动态更新
• 资源热更新（无需重新编译 App）
• 插件化扩展机制

相比单纯在聊天气泡内增加头像动作，浮窗方案在功能完整性、交互灵活性和维护成本上都更具优势。我们认为这个方向能更好地满足未来的交互需求。

你的补丁实现思路清晰、测试完整，如果后续有其他类似的功能建议，欢迎继续提交～

[cccloudK]

好的，感谢回复，期待这个功能后续正式发布😄