前言¶
在使用 DeepSeek Harness (DSH) 進行智能體開發時，開發者經常需要在 Web Composer 中處理 JSON、URL、Base64 等數據格式。手動轉換這些數據不僅耗時，還容易出錯。dsh-dev-toolbox 是一個本地工具箱，旨在解決這一痛點。它直接集成在 Web Composer 的工具欄中，提供了一系列即時轉換功能，無需調用模型，也不涉及網絡傳輸。
插件概述¶
該插件由 Qingzhou-Joshua 維護，是一個獨立的 npm 包。它運行在瀏覽器端，負責處理 JSON、URL、Base64、時間戳和 UUID 的轉換。核心價值在於“本地化”和“即時性”，所有操作均在當前會話中完成，輸入和輸出均不會寫入磁盤。
核心功能¶
插件提供以下轉換功能：
- JSON 處理：支持格式化（美化輸出）、壓縮（單行）、驗證（僅解析檢查）、轉義（將文本轉爲 JSON 字符串）和反轉義（解析 JSON 字符串）。此外，還支持在輸出結果中進行正則搜索（最多 2000 個命中）和閱讀視圖切換。
- URL 工具：支持百分比編碼與解碼，以及查詢字符串與 JSON 對象之間的互轉。
- Base64 編解碼：支持 UTF-8 文本與標準 Base64 之間的轉換。解碼時會忽略負載中的空白字符，方便直接粘貼日誌片段。
- 時間戳轉換：支持 10 位 Unix 秒、13 位 Unix 毫秒、小數秒以及
Date.parse支持的文本格式（如 ISO）。輸入後會同時顯示 Unix 秒、毫秒、ISO 和本地時間。 - UUID 生成：生成 UUID v4。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add github:Qingzhou-Joshua/dsh-dev-toolbox
安裝前請確保環境滿足以下要求：
* Node.js 版本爲 ^22.19.0 || >=24.0.0。
* 如果使用 pnpm >= 10，第一次安裝可能會失敗，因爲腳本被 pnpm 阻止。此時需要將報錯中提示的 allowBuilds 鍵複製到 ~/.dsh/profiles/web/pnpm-workspace.yaml 中，然後重新運行安裝命令。
安裝完成後，運行 dsh web 啓動 Web UI。刷新頁面後，在 Composer 工具欄的 + 號右側會出現一個代碼圖標，點擊即可打開工具箱面板。
使用說明¶
打開工具箱面板後，輸入內容並點擊對應按鈕即可獲得結果。面板底部有三個通用操作：
1. Load from composer：將 Composer 中的當前草稿複製到工具箱的輸入框中（不包含 UUID）。
2. Copy output：將輸出結果複製到剪貼板。
3. Insert into composer：將輸出結果插入回 Composer。如果草稿爲空，則替換草稿；否則，在末尾追加換行符並關閉面板。
- JSON 搜索：在 JSON 標籤頁中，搜索默認爲字面量匹配。開啓“Regex”後使用 JavaScript 正則表達式。按 Enter 跳轉到下一個匹配，Shift+Enter 跳轉到上一個。
- 閱讀視圖：點擊輸出標籤旁的展開圖標，工具箱將切換爲閱讀視圖，僅保留輸出內容和搜索功能，最大化顯示輸出區域。
- 輸入限制：單次輸入超過 512 KiB 字符會被拒絕，以防止頁面卡頓。
注意事項¶
- 插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
- 不要在 harness 根目錄下運行
pnpm run build。 - 插件的輸入和輸出數據不會寫入磁盤。
總結¶
dsh-dev-toolbox 是一個輕量級的開發輔助工具，適合需要頻繁進行數據格式轉換的開發者。它通過本地化處理減少了網絡開銷和模型調用，提升了在 DSH Web Composer 中的開發效率。更多詳情與源碼可參考 GitHub 倉庫。
