前言¶
在 DeepSeek Harness(DSH)里长时间跑 agent,常见问题是:会话是否在跑、是否在等审批、是否出错,往往要靠盯日志或消息流。纯 UI 装饰类插件不会改 agent 逻辑,但可以在输入框边缘用视觉信号把状态「挂」在余光能扫到的地方。下面介绍社区插件 RainbowSpeak(虹语)——@kenz1117/dsh-ui-rainbowspeak,由维护者 kenz1117 发布,在 SkillHub 目录中归类为「趣味换装」,GitHub 星标为 1。它只做一件事:给聊天 composer 输入框卡片加一圈可配置的彩虹跑马灯边框,并按会话状态改变流速与配色。
这是什么¶
RainbowSpeak 的定位是:DeepSeek Harness 聊天输入框(composer)上的彩虹跑马灯边框装饰。npm 包名 @kenz1117/dsh-ui-rainbowspeak,当前资料中的版本为 0.0.2,许可证 MIT。
插件自述为纯浏览器端装饰:不接管插槽、不打宿主补丁、不注册工具、不注入系统提示。客户端 bundle 约 17 KB;引擎不支持 CSS @property 时,流动动画会降级为静态渐变环。
锚点是宿主上的输入框卡片元素 [data-composer-card],在卡片 ::before 上用 conic-gradient 与蒙版只保留边缘环带。
核心功能¶
彩虹边框与设置面板¶
默认是一圈沿卡片边界流动的 conic 渐变彩带,角度由注册的 @property --dsh-rainbow-angle 驱动关键帧旋转。
在宿主 Settings → Rainbow border 中可调整:
- 启用 / 禁用
- 流速(1–10 秒/圈)
- 环宽(1–6 px)
- 配色与位置(四边 / 顶部 / 底部)
- 反向流动、呼吸亮度叠加
偏好写入 localStorage,改完即生效。
七种配色¶
资料列出的配色包括:经典彩虹、极光、日落、蜜桃、海洋、赛博霓虹(青/紫/品红,带白色灯闪段),以及 跟随主题——经 color-mix 从宿主品牌色派生,深浅主题切换时边框跟随。
会话状态感知¶
插件通过宿主 dock 座位读取会话状态(仅在插件层,不涉及 agent-loop),边框行为包括:
| 状态 | 表现(据 README) |
|---|---|
| agent 运行中 | 环加速(约 4 s → 1.2 s/圈) |
| 工具审批或 ask-user 待处理 | 琥珀色慢脉冲 |
| 发送失败或 agent 出错 | 红色快脉冲 |
| 一轮完成 | 一周期的庆祝闪光 |
优先级:错误 > 提醒 > 运行。
其它行为¶
- 聚焦增亮:输入框聚焦时环增亮、增饱和,失焦缓退。
- 无障碍:遵循
prefers-reduced-motion(动画禁用,保留静态环);设置控件带本地化标签与 aria。 - 中英双语:文案经宿主 locale 注册表下发。
安装与启用¶
官方推荐用 dsh CLI 安装:
dsh plugin add @kenz1117/dsh-ui-rainbowspeak
也可在 profile 的 package.json 里手动加入依赖:
{
"dependencies": {
"@kenz1117/dsh-ui-rainbowspeak": "*"
}
}
在 profile 目录执行 pnpm install 并重启宿主后生效。
本地开发时,可将依赖指向 checkout(资料示例为 link: 绝对路径),在插件仓库执行 pnpm bundle,宿主下次重启即可加载改动,无需重装。
环境要求(package.json):Node ^22.19.0 || >=24.0.0,DSH >=0.1.2-alpha.1;客户端平台为 web(desktop/web 宿主)。Peer 含 @deepseek-ai/cordis 及若干 dsh-client-ui-* 包,由宿主在运行时提供。
典型用法¶
安装并重启宿主后,边框默认出现在 composer 卡片上。日常调节走设置面板即可,无需额外命令。
若需确认插件是否按预期挂载:apply 时会插入一张 <style data-plugin> 样式表,dispose 时移除;用户偏好与会话状态会投影到 <html> 的 data-rainbow-* 属性与内联 CSS 变量。
维护者本地开发流程(摘自 README):
pnpm install
pnpm test
pnpm typecheck
pnpm bundle
适用场景与注意¶
适合谁:希望在 DSH Web 客户端里给输入框加一点辨识度、又希望边框能反映 agent/审批/错误状态的开发者;分类上属于「趣味换装」,不改变对话能力本身。
兼容性:流动动画依赖 @property(Chromium/Electron 构建可用);其它引擎为静态环。
安全与权限:与其它 DSH 插件一样,插件随当前 dsh 进程与 profile 加载。安装前建议阅读 GitHub 仓库 源码与 MIT 许可证,确认符合你的环境策略。社区目录 SkillHub 为独立站点,与 DeepSeek / 幻方无官方从属关系,并非官方应用商店。
结尾¶
RainbowSpeak 把 composer 边框做成可配置的彩虹环,并把运行、待审、出错等状态编码进流速与颜色,属于零侵入的 UI 装饰。需要安装命令与细节时,以仓库 README 为准。