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 選項與快捷鍵調節。

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

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

小夜