前言¶
DeepSeek Harness(DSH)把對話、工具調用和子代理委派都收進同一客戶端。默認界面能完成工作,但運行指標往往藏在彈窗裏,子代理拓撲隨步驟摺疊而難追蹤,側欄工作區與置頂項也容易混在一列表裏。若你希望在不改宿主佈局骨架的前提下,換一套剋制的視覺體系並把這些信息固定到可見位置,社區插件 潮汐主題(npm 包名 dsh-tide-theme,倉庫 zdt3476/dsh-tide-theme)是一套可選方案。維護者爲 zdt3476;包在 npm 發佈,README 標註 dsh-market verified,當前 GitHub 星標爲 1,許可證爲 MIT(package.json 版本 0.6.1)。
這是什麼¶
潮汐主題(Tide Theme)面向 DSH 桌面 Web 客戶端:提供「深海潮汐藍」明暗兩套表面體系、清晰字階與較低信息密度,並保留宿主對話、導航與分屏結構。除 Token 覆蓋外,插件還附帶底欄性能 HUD、用量看板、Agent Graph 子代理拓撲、側欄置頂小節與篩選、輸入區模型/權限控件等增強。插件原名 dsh-simplify-theme,升級到新包需先卸載舊包;本地配置存儲鍵隨包名變更,需重新設置。
設計基線與材質開關¶
主題按固定設計契約實現(倉庫內 docs/ui-design-contract.md),而非零散改色:6-3-1 配色、單一強調色、禁用純黑與霓虹輝光,正文對比度按 WCAG AA,核心讀數按 AAA;度量數字使用等寬字體棧與 tabular-nums,避免刷新抖動。
底欄 HUD、用量看板、委派圖三個自繪組件統一受 潮汐主題材質 開關控制(設置 → 插件 → 潮汐主題 → 潮汐主題材質)。默認開啓時套用潮汐 Surface;關閉時回落 DSH 原生 token(如 --dsw-specific-menu、--dsw-alias-bg-layer-*),與宿主外觀一致。改動寫入 localStorage,實時生效,無需重啓。
核心功能¶
底欄性能 HUD 與用量看板¶
單行常駐 HUD(約 36px 高,對齊宿主 TodoPanel 形制)展示會話規模、上下文容量、端到端 TPS、緩存命中率、模型累計耗時;窄屏在 760px / 640px 斷點收窄佈局。數據未就緒時顯示同尺寸骨架條,避免佈局跳動。
TPS 口徑與原生不同:插件把網絡往返與推理思考(含 TTFT)計入,避免僅按解碼時間出現的虛高讀數。上下文容量按 ≤50%、50–75%、>75% 三檔語義色;壓縮後通過 projectedTokens 與 contextBreakdown 即時刷新。點擊 HUD 展開用量看板:容量分段、性能 KPI、Token 構成與會話耗時;浮層相對 HUD 居中貼合,空間不足時翻轉或內部滾動。
Agent Graph 子代理拓撲¶
子代理派發記錄獨立展示:SVG 弧形連線、橫向 Agent 卡片(標題、模型、狀態、步驟數)。卡片彙總宿主四個用量桶的 token,並在能匹配 OpenRouter 公開模型目錄 單價時顯示預估金額(僅供參考,未處理分時定價)。無法可靠匹配工具行與子會話時不佔位顯示節點。點擊卡片進入子會話;運行中卡片可單獨停止且不跳轉。
側欄與工作區¶
置頂與普通工作區分列爲「置頂 (N)」與「工作區 (M)」小節;支持未歸檔/歸檔標籤、實時篩選,以及置頂與普通項各自的摺疊數量上限(置頂上限爲 0 表示不限)。
輸入區與插件設置¶
輸入框下方提供按供應商分組的模型面板與 Reasoning Effort 滑塊;右下方可切換權限預設。每輪迴復操作欄顯示該輪端到端耗時。動畫尊重 prefers-reduced-motion。
安裝與啓用¶
DSH 生態主張「一切皆插件」;SkillHub 插件目錄 爲社區站點,與 DeepSeek / 幻方無官方從屬關係。安裝前建議瀏覽源碼與 LICENSE,並記住插件隨當前 DSH 進程權限運行。
方式 1(推薦):在 DSH 插件市場搜索 dsh-tide-theme(顯示名「潮汐主題」),安裝後重啓客戶端。
方式 2:命令行(摘自倉庫 README,--profile desktop 以你實際 profile 爲準):
# npm
dsh plugin --profile desktop add dsh-tide-theme
# GitHub 源碼
dsh plugin --profile desktop add git+https://github.com/zdt3476/dsh-tide-theme.git
# GitHub Release 預構建包(示例爲 v0.6.1)
dsh plugin --profile desktop add https://github.com/zdt3476/dsh-tide-theme/releases/download/v0.6.1/dsh-tide-theme-0.6.1.tgz
安裝後在 設置 → 插件 中啓用,並按 README 說明使用 Cmd/Ctrl + R 重載客戶端。package.json 要求 dsh >= 0.2.0,Node ^22.19.0 || >=24.0.0。
典型用法¶
- 安裝並啓用插件,重載客戶端。
- 打開 設置 → 插件 → 潮汐主題,按需調整 潮汐主題材質 及側欄摺疊上限等項;配置即時保存。
- 日常會話中觀察底欄 HUD;需要明細時點擊展開用量看板。
- 使用子代理或
spawn_teammate時,在 Agent Graph 區域查看拓撲與 token;若只需原生皮膚,關閉材質開關即可保留功能、僅換表面 token。
從舊包 dsh-simplify-theme 遷移時,先卸載舊包再安裝 dsh-tide-theme,並重新配置本地項。
適用場景與注意¶
適合長期開 DSH 做智能體開發、需要常駐性能讀數與子代理可見性的用戶。README 說明功能截圖部分由插件組件在隔離瀏覽器中用演示數據渲染,用於展示樣式;完整宿主佈局另由結構契約測試驗證。
OpenRouter 預估金額爲保守參考,不可作計費依據。委派圖在無法確定映射時會缺省節點,這是刻意設計而非故障。
結尾¶
潮汐主題把 DSH 的視覺與工作流信息層收成一套可開關的增強:真實 TPS、上下文語義色、子代理拓撲與側欄分層,均可從插件設置頁調節。進一步瞭解可訪問目錄頁 SkillHub · dsh-tide-theme 與 GitHub 倉庫。