dsh-tool-highlight：給 bash / pwsh 與 read 輸出做分層語法染色

前言¶

在使用 DeepSeek Harness（DSH）進行開發時，開發者常通過 bash、pwsh 運行腳本，或使用 read 讀取代碼文件。這些工具的原始輸出通常是純文本，關鍵字、字符串、註釋混在一起，視覺上難以快速定位。dsh-tool-highlight 插件解決了這個問題，它在 Web 界面中爲這些特定工具的輸出添加分層語法染色，模仿 VS Code Dark+ 風格，幫助快速識別代碼結構。

核心功能¶

該插件主要針對 bash、pwsh 命令與 read 的輸出做處理，具備以下能力：

1. 分層語法染色：使用 VS Code Dark+ 風格配色，區分關鍵字、字符串、數字、函數名和註釋。
2. 智能識別：
   • read：按文件擴展名識別語言（支持 .py、.js、.ts、.json、.ps1、.sh 等）。
   • bash / pwsh：按內容啓發式識別。若輸出像 JSON 則按 JSON 分色，若像代碼則按語法分色。對於無法識別的表格或日誌，保持原樣不上色，避免視覺干擾。
3. 零 Token 開銷：純前端渲染，不調用模型，不新增或改寫會話內容，僅對已有文本進行視覺處理。
4. 狀態與摺疊：附帶退出碼狀態條（綠色表示成功，紅色表示非零退出或信號）。默認摺疊工具卡片（可開關），運行中或出錯時自動展開。

安裝與啓用¶

通過 DSH 官方命令行工具安裝，安裝後需重啓 dsh web 並硬刷新頁面（Ctrl+Shift+R）。

dsh plugin --profile web add dsh-tool-highlight

配置¶

插件支持通過用戶設置或 YAML 配置文件進行控制。

配置項說明：

配置方式：

1. 在 DSH 界面中：進入 設置 → 插件配置 → 工具卡片摺疊。
2. 在配置文件中（cordis.yml 或 settings.yaml）：

tool-highlight:
  collapseByDefault: true

工作原理與依賴¶

• 渲染邏輯：插件掛載在 DSH 的 tool.call.toolview 槽位上，根據工具名註冊渲染器。使用自研輕量正則進行分詞染色，配色方案固定爲 VS Code Dark+，並跟隨 DSH 主題 Token。
• 依賴：依賴 @deepseek-ai/schemastery。
• 互斥與共存：該插件只接管 read、bash、pwsh 三個工具卡片（優先級 -2）。若安裝了 dsh-better-tool-ui，兩者互不衝突，各自負責不同的工具。

注意事項¶

• 非模型類插件：該插件不調用任何模型，不消耗 Token。
• 內容識別：遵循“認得出來才染”的原則。表格、日誌等非結構化內容保持原樣，不會強制上色。
• 版本兼容：依賴 @deepseek-ai/schemastery (>=0.1.0-rc.1)。

鏈接¶

• GitHub: https://github.com/vollegrewar/dsh-tool-highlight
• 社區目錄: https://www.skillhub.cn/plugins/vollegrewar/dsh-tool-highlight