前言¶

在 DSH Web UI 中，代碼字號、表格樣式、Git 狀態、歸檔會話、MCP 服務器等細節會影響日常使用。dsh-ui-tweaks 是面向 DSH Web UI 的插件，把這些調整集中到設置面板中，並即時生效。它適合需要按工作流調整界面、並在會話內處理 Git、歸檔、MCP 和任務提醒的 DSH 使用者。

這是什麼¶

dsh-ui-tweaks 是 DeepSeek Harness（DSH）Web UI 插件，維護者爲 wlj521。它用於在設置面板中即時調整對話界面，包括代碼字號、表格樣式、GitBar、歸檔管理、MCP 管理、/init、鯨魚指示器、任務提醒，以及將緩存命中率顯示爲兩位小數。

DSH 的插件機制允許擴展 Web UI；社區目錄是獨立站點，不應理解爲官方應用商店。

版本與依賴¶

• dsh-ui-tweaks v0.12.0 需要 DSH v0.1.2-alpha.1 及以上。
• 對話時間線和對話框寬度已由 DSH 原生提供；插件移除了自帶的重複實現，也移除了消息字體大小與行高設置。
• 宿主暫未升級時，可指定舊版：dsh-ui-tweaks@0.11.2。
• package.json 要求 Node.js >=20。

安裝¶

先執行安裝命令，再重啓一次 dsh web。bundle 插件在進程啓動時掃描。

從 npm 安裝：

npx -y @deepseek-ai/dsh plugin --profile web add dsh-ui-tweaks

從 GitHub 倉庫安裝：

npx -y @deepseek-ai/dsh plugin --profile web add github:wlj521/dsh-ui-tweaks

鎖定 npm 版本：

npx -y @deepseek-ai/dsh plugin --profile web add dsh-ui-tweaks@0.11.2

鎖定 git tag：

npx -y @deepseek-ai/dsh plugin --profile web add github:wlj521/dsh-ui-tweaks#v0.11.2

從 GitHub 安裝時，pnpm 可能要求批准該包的構建腳本。把該包加入 profile 的 pnpm-workspace.yaml：

allowBuilds:
  dsh-ui-tweaks: true

然後重新執行 add。

若 pnpm 報符號鏈接或 hoist 相關錯誤，可在 profile 的 pnpm-workspace.yaml 中設置：

nodeLinker: hoisted

設置入口¶

設置入口：設置 → 界面調整。

同一份配置也可以在 YAML 中維護：

ui-tweaks:
  tableStyle: claude
  gitBarEnabled: true
  archiveManagerEnabled: true
  initCommandEnabled: true
  whaleIndicatorEnabled: true
  preciseCacheHitEnabled: true
  notificationsEnabled: true

其中 gitBarEnabled、archiveManagerEnabled、initCommandEnabled、whaleIndicatorEnabled、preciseCacheHitEnabled、notificationsEnabled 對應默認關閉的功能，設爲 true 後開啓。

核心功能¶

代碼字號¶

支持 8–32 px，默認 13。作用於代碼塊，行內代碼按比例跟隨。舊版百分比配置 codeFontScale 仍兼容；一旦設置新的 px 值，以 px 值爲準。

表格樣式¶

可選默認樣式，或 Claude Desktop 風格。

GitBar¶

GitBar 默認關閉。開啓後，當會話工作目錄是 git 倉庫時，在輸入框工具行內顯示分支與差異膠囊。

• 分支膠囊支持分支切換、新建分支、拉取、推送和提交圖譜。
• 差異膠囊打開差異面板，包含文件列表與逐文件 diff。
• 差異面板支持完整文件視圖、拖動寬度，並可在面板內提交或提交併推送。

Git 操作通過服務端 execFile('git', …) 執行，無 shell 且帶超時。

終端面板¶

提供真 PTY 終端，基於 xterm.js + WebSocket。終端寬度可拖動，也支持一鍵半屏。

打開項目¶

在會話頭部菜單中，可以用資源管理器、VS Code、IDEA、GoLand、WebStorm、PyCharm 打開當前項目。

歸檔管理¶

歸檔管理默認關閉。開啓後，設置中會出現「歸檔」頁面，可以查看、恢復、徹底刪除已歸檔會話，也支持全部恢復/全部刪除。

歸檔刪除是徹底刪除且不可恢復；正在運行的會話會被拒絕刪除。

MCP 管理¶

MCP 管理默認關閉。開啓後，設置中會出現「MCP 管理」頁面，可以添加、編輯、啓用/停用、刪除或重啓 MCP 服務器。

/init¶

/init 默認關閉。開啓後，在輸入框鍵入 /init，選擇中文或英文提示詞後提交。它會分析當前項目，並提交生成 AGENTS.md 的引導提示詞。

鯨魚指示器¶

鯨魚指示器默認關閉。開啓後，輸入框右上角會出現品牌小鯨魚；模型工作時播放游泳動畫。

任務提醒¶

任務提醒默認關閉。開啓後，會話完成或需要交互時，可通過標籤頁標題閃爍、系統通知、提示音提醒。

系統通知需要瀏覽器通知權限；權限申請掛在設置開關的點擊手勢上。

緩存命中率兩位小數¶

該功能默認關閉。開啓後，將原生統計條中的緩存命中百分比改寫爲兩位小數。

典型用法¶

開啓常用功能¶

進入 設置 → 界面調整，或在 YAML 中配置：

ui-tweaks:
  tableStyle: claude
  gitBarEnabled: true
  archiveManagerEnabled: true
  initCommandEnabled: true
  whaleIndicatorEnabled: true
  preciseCacheHitEnabled: true
  notificationsEnabled: true

使用 GitBar¶

開啓後，在輸入框工具行顯示分支與差異膠囊：

1. 點擊分支膠囊，切換或新建分支，也可執行拉取、推送、查看提交圖譜。
2. 點擊差異膠囊，查看文件列表和 diff。
3. 在差異面板內提交或提交併推送。

使用 /init¶

1. 在輸入框鍵入 /init。
2. 選擇中文或英文提示詞。
3. 提交到當前會話，用於生成 AGENTS.md 引導提示詞。

管理歸檔¶

在設置「歸檔」頁面，恢復或徹底刪除已歸檔會話。刪除前需要確認，因爲刪除後不可恢復。

管理 MCP¶

在設置「MCP 管理」頁面，添加、編輯、啓用/停用、刪除或重啓 MCP 服務器。

適用場景與注意¶

適合以下場景：

• 希望按工作習慣調整 DSH Web UI 的代碼字號、表格樣式和提示元素。
• 需要在輸入框附近處理 git 分支、diff 與提交。
• 需要管理歸檔會話、MCP 服務器，或在會話完成或等待交互時收到提醒。

注意：

• 插件以當前 dsh 進程權限運行；安裝前應檢查源碼與許可證。
• 本資料未明確許可證類型；package.json 的 files 中包含 LICENSE，但未給出許可證文本。
• GitBar、歸檔管理、MCP 管理、/init、鯨魚指示器、任務提醒、緩存命中率兩位小數默認關閉，需在設置中開啓。
• 安裝完成後需重啓一次 dsh web。
• 歸檔刪除不可恢復；正在運行的會話會被拒絕刪除。
• 任務提醒的系統通知依賴瀏覽器通知權限。
• 從 GitHub 安裝時，可能需要批准 pnpm 構建腳本，或調整 nodeLinker。

相關鏈接¶

• GitHub：https://github.com/wlj521/dsh-ui-tweaks
• 目錄頁：https://www.skillhub.cn/plugins/wlj521/dsh-ui-tweaks