UI 插件系统

UI 插件是 DriFox v0.3.0 的核心里程碑——插件不仅能扩展 AI 能力，还能直接在 DriFox 界面中**渲染自定义 UI 组件**。

三种 UI 组件类型

类型	说明	特点
🃏 浮动卡片 (Floating Card)	悬浮在聊天区域上/下方的独立 QWidget 面板	注册即命令，toggle 显示/隐藏，多窗口隔离
🧩 内容渲染器 (Content Renderer)	自定义消息 `custom` 类型内容块渲染	匹配 custom_type 自动调用渲染函数
🏭 消息工厂 (Message Factory)	根据消息条件返回自定义 QWidget	替代默认消息卡片渲染

浮动卡片特性

注册即命令 — 调用 registry.register_floating_card() 后自动注册 /卡片ID 命令
双容器位置 — top （上部，与配置卡片同级）或 bottom （下部，覆盖聊天区域）
上下文注入 — 通过 set_context_provider() 拉取项目根目录、会话 ID、主题色等
多窗口隔离 — 每个窗口独立缓存卡片实例，项目/会话切换时自动重建
热插拔支持 — 插件启用/禁用时即时创建/销毁，无需重启

生命周期

插件启用 → PluginManager 检测 ui/__init__.py
    → 标记 components["ui"] = True
    → backend._load_plugin_ui() 调用 UIPluginRegistry.load_plugin()
        → 导入 ui/__init__.py → 执行 register_ui(registry)
            → 注册浮动卡片、内容渲染器、消息工厂
                → 浮动卡片自动注册 /命令
                → 首次执行命令时创建 widget 实例

内置 UI 插件

插件	类型	说明	命令
上下文用量统计	浮动卡片	14天Token趋势、每日消息量、会话活跃度、项目分布	/context-usage-stats
项目文件树	浮动卡片	树形浏览文件，智能过滤忽略目录，搜索过滤，实时监听	/file-tree
Git 仪表盘	浮动卡片	分支切换、变更文件清单、提交历史速览	/git-dashboard
_vendor/ 依赖演示	浮动卡片	演示插件 _vendor/ 打包第三方包机制	/vendor-demo

开发一个 UI 插件

三步即可创建一个 UI 浮动卡片插件：

在插件目录创建 ui/__init__.py，提供 register_ui(registry) 函数
在 ui/cards.py 中实现 QWidget 子类（浮动卡片内容）
在 register_ui 中调用 registry.register_floating_card() 注册

设计约束

所有 UI 插件遵守**闭包设计约束**：不导入 app.core 或 app.widgets 内部模块，所有文件操作只通过 stdlib 完成，确保与主程序解耦、热重载安全。

架构说明

团队协作