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