前言¶

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。智能體在執行復雜任務時，中間環節往往需要調用一些確定性的工具，例如 JSON 與 YAML 的互轉、SQL 語法遷移、正則表達式測試或 JWT 解碼。

如果通過提示詞讓大模型直接處理這些需求，通常速度較慢、Token 消耗更多，且難以保證結果的完全可復現。dsh-devkit 正是爲了解決這一問題而生，它提供了一組輕量級的確定性操作工具，讓智能體在任務流中間能夠快速、低成本地調用。

插件定位¶

該插件由 mario03690 維護，是一個基於 MCP (Model Context Protocol) 的工具集。它不包含任何本地執行代碼，僅通過一個配置補丁與 DSH 的 MCP 客戶端通信，旨在爲智能體提供 JSON/YAML 處理、SQL 轉譯、文本脫敏、二維碼生成等通用能力。

安裝與啓用¶

使用 DSH 的插件管理器進行安裝：

dsh plugin --profile <your-profile> add github:mario03690/dsh-devkit

安裝後，插件會向 DSH 的 Cordis 配置中注入必要的 MCP 客戶端配置。

核心工具列表¶

插件提供了 14 個工具，覆蓋了智能體開發中常見的基礎操作：

• what_can_you_do: 描述任務（支持任意語言），返回能執行該任務的工具列表及調用示例。
• redact_text: 從文本中剝離敏感信息，包括郵箱、電話、ID、API Key、JWT、卡號和 IP。
• json_yaml: JSON 與 YAML 的雙向轉換，自動識別輸入格式。
• validate_json: 校驗文本是否爲有效 JSON，並可檢查特定 Schema 和頂層類型。
• diff_text: 計算文本差異，返回新增和刪除的行號（基於最長公共子序列算法）。
• jwt_decode: 解碼 JWT 的 Header 和 Payload，將時間戳轉換爲可讀格式，並計算剩餘有效期。
• regex_test: 使用正則表達式測試文本，返回匹配位置、捕獲組（支持命名捕獲組）。
• transpile_sql: SQL 語句方言轉換，支持 MySQL、PostgreSQL、SQLite、TSQL、Oracle、Snowflake、BigQuery、ClickHouse、Doris、StarRocks 等。
• make_qr: 生成二維碼 PNG，支持文本或 URL。
• json_format: 驗證並格式化 JSON（2 空格縮進），若無效則報錯位置。
• timezone_convert: 時區轉換，支持任意 IANA 時區（如 Asia/Shanghai）及當前時間查詢。
• unit_convert: 單位轉換，涵蓋長度、重量、溫度、面積、體積、速度和數據大小。
• sql_from_description: 根據自然語言描述和表結構生成可直接運行的 SQL 文件。
• screenshot_url: 對指定 URL 進行全頁截圖，生成 PNG 圖片。

典型用法¶

智能體可以調用這些工具來完成具體任務：
* SQL 轉譯：將 MySQL 的查詢語句轉換爲 PostgreSQL 語法。
* 敏感信息處理：從一段長文本中提取並清理出郵箱、電話和 API Key。
* 二維碼生成：將任意文本或 URL 轉換爲二維碼圖片。
* 時間處理：將東八區的時間轉換爲紐約時間。
* 截圖：獲取指定網頁的完整截圖。

成本與隱私¶

• 計費：大多數工具爲 $0.001/次。sql_from_description 爲 $0.01/次，screenshot_url 爲 $0.003/次。失敗調用不收費。
• 數據保留：文檔和提示詞僅在內存中處理，不會被存儲或持久化。
• 權限：無需任何憑證即可使用免費額度。可選的 AllRouter Key 僅在請求頭中傳遞，不會存儲。

兼容性與運行環境¶

• 運行時：依賴 dsh v0.1 developer preview (Cordis v4)。僅依賴 @deepseek-ai/dsh-mcp-client。
• 本地執行：無。插件不包含任何工具代碼，不構建本地二進制文件，不包含生命週期腳本。
• 文件系統：無訪問權限。
• Shell/進程：無訪問權限。
• 網絡訪問：僅允許出站 HTTPS 到 ainetcafe.com。

總結¶

dsh-devkit 適合需要在智能體工作流中集成格式轉換、文本處理、SQL 操作或截圖功能的場景。它通過服務端操作解決了本地執行受限的問題，同時保證了極高的確定性和較低的成本。

更多信息，請訪問 插件目錄 或 GitHub 倉庫。