Skip to content

内置插件

Blue 的一切表面都是插件(patch 行)——本页是 22 个内置插件的目录。它们同时也是"插件能做什么"的活例子:状态栏条目、工具卡片、编辑器增强、完整面板,全部经 Seam 参考里的缝注册,逐个可拆。

三段结构一张图(与仓库 README 同源,单一来源 docs/diagrams/blue-composition.mmd):

基线插件(5 个)

组成最小可用 Blue UI 的五个插件——纯基线,建议整组保留:

插件说明
blue-core终端核心:全树唯一的 pi-tui 适配器,提供屏幕/键位/组件工厂/终端事实四项服务
blue-theme-dark内置 dark 调色板(blueTheme 服务的 plain 默认提供方)
blue-banner启动欢迎横幅:logo + Welcome//help 头两行、Directory/Model/Version 信息行
blue-transcript会话流主体:事件折叠与渲染、状态栏注册表与两行 footer 壳
blue-status-basic状态栏基线条目:model 名(优先级 0)

增强插件(14 个,均可独立启停)

在纯基线之上的可选层——每一行都可单独删除而不破坏基线:

插件说明
blue-editor-plus输入编辑器增强:! bash 模式 + 斜杠/@ 补全 + 参数幽灵提示
blue-attachments附件存储:文件系统图片库(魔数嗅探、容量上限)
blue-paste-imageCtrl-V 剪贴板贴图,[image #N] 标记,提交拆为图片块
blue-status-cwd状态栏:会话工作目录(优先级 5,深路径缩写)
blue-status-git状态栏:git 徽章 branch [+a -d ↑u↓v](优先级 10,TTL 缓存探测)
blue-status-mode状态栏:会话模式徽标 plan/yolo(优先级 2,normal 态隐藏)
blue-status-title状态栏:会话标题(优先级 30,行 1 右对齐;S30 换位前是轮换教学提示的槽位)
blue-status-context状态栏:context 占用 context: N%(优先级 20,第二行右对齐)
blue-intent-diffdiff 专属工具卡(Write/Edit 的统一 diff 着色呈现)
blue-intent-terminal终端输出专属工具卡($ command + exit 徽章)
blue-pane-activity活动面板:等待/运行/撰写的模式指示(月亮与 braille spinner)
blue-pane-queue排队消息面板 + 空编辑器 Up 召回
blue-pane-todotodo 面板(Ctrl-T 折叠切换,全完成自动收起)
blue-pane-btw/btw 侧问面板:fork 当前会话问旁路问题
blue-pane-agents子代理分组面板:运行中的子代理组卡片(dock 末行,kimi swarm-pane 语义)

装配插件(3 个)

收尾装配层,提供输入交互与 Agent 驱动:

插件说明
blue-interaction输入编辑器、内置命令、问卷 provider、审批应答方
blue-startup启动值提供方:[task] 位置参数与 --resume 解析
blue-appAgent 驱动:创建/恢复会话并发布 blueSession

启停与定制

内置插件无需安装——它们就是 bundle 的 cordis.patch.yml 行。想定制组合时,直接编辑 profile 的 patch 文件增删行即可(dsh plugin --profile blue add link:… 装入后,patch 位于 profile 目录下);三段式装配与 dock 顺序的机制说明见功能总览

生态插件的发现与一键安装见插件市场(建设中)。

预览版 · v0.1.0-rc.1