dsh-tui-marathon:为 dsh-TUI 提供 Acid Rain 主题与原生启动动画

前言

DeepSeek Harness(DSH)的终端界面 dsh-TUI 默认外观偏工程化,对话、模型与工具能力都在 Harness 侧,但启动与视觉风格往往仍是系统自带主题。若希望在不改会话与配置的前提下,给 TUI 换一套有辨识度的配色,并在每次启动时播放一段全屏开场,就需要通过插件接入宿主公开接口,而不是 fork 或本地改源码。

下面介绍社区插件 dsh-tui-marathon(可安装包名 dsh-theme-mls-tui):在 dsh-TUI 0.14.x 上提供 Marathon 风格的 Acid Rain 主题,以及基于终端字符与色块的原生启动动画;对话、模型、工具与存储仍由 Harness / dsh-TUI 负责。

这是什么

仓库名称为 dsh-tui-marathon,通过 Cordis 安装时使用的包名为 dsh-theme-mls-tui,二者对应同一发布物。

核心功能

Acid Rain 主题

主题采用 Acid Rain 黄色(#D7FF00)、深色表面与中性的正文色。插件激活后可通过选项 autoTheme(默认 true)选择并保存 MLS 主题一次。

启动开场动画

  • 动画仅在启动时自动播放;正常对话回合、取消与历史回放不会再次触发开场。
  • 开场保留电蓝、迷宫图形与红色面板退场等视觉元素;Logo 在蓝色保持与迷宫过渡阶段仍可见,直至红色扫过覆盖;结束后回到原生 TUI 界面。
  • 0.4.3 使用真实终端文本、块字形、边框与纯色单元格渲染,替代旧版全帧采样绘制;六帧绿色扫描使用较粗 box-drawing 描边,扫描阶段较 0.4.2 延长约 0.8 秒。
  • 宿主帧时钟驱动动画;文档称实测移动帧输出约 58 fps,实际受终端与机器负载影响。播放与暂停期间支持窗口缩放;校验范围包括 48–180 列、20–54 行及多种单元格宽高比。

与宿主的协作方式

  • 通过宿主公开接口隐藏默认像素鲸鱼(setWhale(false)),保留主题化原生标题,卸载时恢复先前偏好;若需保留原版蓝鲸鱼,可设 nativeWhale: true。
  • 开场期间 stock tuiScenes 会替换对话视图;关闭后恢复原有对话。插件不修改模型、凭证或会话配置;首次使用可在开场结束后按 dsh-TUI 常规定完成凭证设置。

交互与配置项

Cordis 选项 默认值 作用
autoTheme true 激活时选择并保存 MLS 主题一次
autoBoot true 播放启动开场
motion full reduced:简短静态展示;off:仅主题、无动画
graphics cells auto:仅在中央 Logo 使用宿主支持的图像协议,外围几何仍为原生单元格
cellAspect 0 读取宿主单元格度量;无法读取时回退为高度/宽度 = 2
nativeWhale false 保留不可主题化的 stock 蓝鲸鱼

运行时快捷键(README 原文):

  • Alt+M:重播开场
  • 动画中:Esc、Enter、q 或点击退出;空格 暂停/继续
  • macOS 上可按需将 Option 配置为 Alt/Meta

无特定终端品牌要求;若宿主未提供像素度量,任意字体比例无法精确推断,可选用 cellAspect(如 1.8、2.2)做单元格高宽比校准。原生单元格渲染不依赖图像协议。

安装与启用

前提:dsh、dsh-tui 与 pnpm 已安装,且现有 dsh-tui 能正常启动。支持宿主 dsh-TUI 0.14.x,资料中验证版本为 0.14.0。若设置了 DSH_HOME,安装与启动应使用同一取值。

安装主题(一次性,命令来自官方 README):

dsh plugin --profile dsh-tui add https://github.com/Huangmr0719/dsh-tui-marathon/releases/download/v0.4.3/dsh-theme-mls-tui-0.4.3.tgz

之后仍用惯用方式启动:

dsh-tui

插件会加入 launcher 默认的 dsh-tui profile,自动选择 Acid Rain 并播放开场;无需 git clone、宿主本地构建或在项目目录特殊启动。配置变更或更新后需重启 dsh-tui。

也可下载 v0.4.3 压缩包,将上述 URL 换成本地文件路径。

移除主题并继续使用 dsh-TUI:

dsh plugin --profile dsh-tui remove dsh-theme-mls-tui

典型用法

日常流程即「安装一次 → dsh-tui」。若只想保留配色、缩短或关闭动画,在 Cordis 配置中调整 motion(full / reduced / off)与 autoBoot;需要重看开场时在 TUI 内按 Alt+M。

开发调试(仅改插件源码时需要,普通安装用户可跳过):仓库要求 Node ^22.19 || >=24 与 pnpm 11.21.0,并提供 npm start 等脚本;开发启动器可通过环境变量覆盖行为,例如:

MLS_MOTION=reduced npm start
MLS_NATIVE_WHALE=1 npm start

适用场景与注意

适合谁:已在用 DSH 与 dsh-TUI 0.14.x,希望在终端里获得 Marathon 风格 Acid Rain 外观,并接受启动时全屏开场(或可配置为减弱/关闭)的开发者。

生态说明:DSH 强调「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系,本文不以「官方应用商店」表述。

安全与权限:插件随当前 dsh 进程权限运行。安装前建议阅读 GitHub 仓库 源码、MIT 许可证 及 THIRD_PARTY.md 中的素材归属说明;勿将未审查的第三方插件用于含敏感凭证的生产环境。

兼容性:更细的宿主接口与渐进展示原生内容等限制见仓库 COMPATIBILITY.md;验证与质量说明见 QUALITY.md。

结尾

dsh-tui-marathon 把 Acid Rain 主题与响应式启动动画接到 stock dsh-TUI 的公开能力上,不改模型与会话栈;安装、卸载命令明确,动画与主题均可通过 Cordis 选项与快捷键调节。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜