DeepSeek Harness 插件：doubao-dsh-plugin

前言¶

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在使用本地模型進行開發或工作流編排時，往往需要接入外部能力。doubao-dsh-plugin 正是爲了解決“如何在 DSH 中無縫調用豆包模型能力”這一問題而生。

該插件通過本地運行的 Doubao Relay（Quicker 轉發），爲 DSH 注入 doubao_ask 工具，支持聯網搜索、圖片生成、多模態識圖，並具備“粘貼圖片轉本地路徑”的瀏覽器端捕獲能力。

前置要求：Doubao Relay¶

本插件的所有能力（搜索、生圖、識圖）都依賴本地 Doubao Relay 的 OpenAI 兼容接口實現。插件本身不包含 Relay，需由 Quicker 軟件將本地網頁版豆包轉發爲 API 調用。

搭建步驟如下：

1. 安裝 Quicker 軟件。
2. 下載共享動作（點擊獲取）。
3. ⚠️ 注意：該動作年久未更新，需手動替換代碼。在 Quicker 中右鍵動作選擇“編輯”，找到“運行 C# 代碼”步驟，將 c#code.txt 中的代碼整體替換到腳本代碼區，保存後重新運行動作。此時 Relay 將監聽 127.0.0.1:56666。

若未啓動 Relay，工具調用會報錯。

安裝與啓用¶

使用官方提供的 npm 一鍵安裝命令：

dsh plugin --profile web add doubao-dsh-plugin

安裝完成後，必須重啓 harness 才能生效。客戶端 bundle 會在啓動時自動掃描裝配。

核心功能¶

• 工具注入：註冊 doubao_ask 工具，模型啓動後即可直接看到該工具。
• 聯網搜索與生圖：支持實時搜索和生成圖片，圖片以 Markdown 鏈接形式在對話中展示。
• 多模態識圖：支持傳入 URL、base64 或本地文件路徑進行識圖。若本地圖片超過 512KB，會自動壓縮至 800px 寬再發送。
• 粘貼圖片轉路徑（paste-to-path）：這是本插件的特色功能。在瀏覽器端攔截 paste 事件，將圖片字節保存爲私有臨時文件（路徑格式類似 <temp>/doubao-dsh-paste/p-*/paste<ext>），並將路徑文本插入輸入框。純文本模型不會觸發“模型不支持圖片”的准入攔截，模型看到路徑後會調用 doubao_ask 並將 image 參數設爲該路徑。
• 圖片去重與輸出：自動摺疊重複的圖片鏈接，優先保留原圖變體，輸出結構化的 images 字段。
• 日誌記錄：完整記錄請求、響應等信息。

參數說明¶

使用方式¶

1. 直接識圖：直接將圖片粘貼到輸入框。瀏覽器捕獲圖片，保存爲本地路徑，模型隨後調用工具識圖。首次識圖約需 15~20 秒（受 Relay 響應速度影響）。
2. 指令交互：在對話中直接要求“搜索 X”或“生成一張 X 的圖”，模型會自動調用本工具。

注意事項¶

• 該插件以 DSH 進程的權限運行，安裝前請檢查源碼與許可證。
• 客戶端代碼在瀏覽器端運行，複用了 modlens 的驗證實現邏輯。
• 每次請求會強制開啓新的對話（new_conversation）。