前言¶
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 负责。
这是什么¶
- 仓库: Huangmr0719/dsh-tui-marathon
- 维护者: Huangmr0719
- 社区分类:趣味换装(SkillHub 目录:dsh-tui-marathon)
- 当前版本(资料中明确):0.4.3,MIT 许可证
- 定位:面向未改动的 DeepSeek Harness TUI 的外观插件;视觉灵感来自仓库 ALPDM00/dsh-theme-mls-desktop
仓库名称为 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 选项与快捷键调节。