前言¶
DSH 的插件生態強調「一切皆插件」，社區目錄是獨立站點，不是官方應用商店，與 DeepSeek / 幻方無官方從屬關係。
對於使用 DSH 智能體的場景，一個具體問題是如何讓智能體穩定處理圖片任務：它需要調用一個視覺分析工具，工具背後可接可配置的多模態模型，並且配置、註冊和調用過程儘量低侵入。
dsh-vision-helper 是爲 DeepSeek Harness 打造的持久化視覺插件，由 Yuuz12 維護，許可證爲 MIT。它註冊 vision_analyze 工具，基於可配置多模態模型分析圖片，同時在 Web 應用中提供設置頁界面。
下面介紹它的功能、安裝、配置、卸載和注意事項。
這是什麼¶
dsh-vision-helper 是一個 DSH 組合包插件，核心價值有三點：
- 註冊
vision_analyze工具，接受本地圖片路徑或data:URI，返回分析文字。 - 支持配置多模態模型提供方與模型；
provider和model留空時自動選擇多模態模型。 - 在 DSH Web 應用中提供「設置 → 視覺助手」界面，用於配置提供方、模型、溫度、最大輸出 tokens、最大圖片邊長。
它面向 DSH Web 部署；設置頁僅 Web 端可見，但 vision_analyze 工具本身在掛載了該插件的任何 profile 中均可用。
核心功能¶
工具調用¶
vision_analyze 接受本地圖片路徑或 data: URI，發送給配置的多模態模型，並返回分析文字。
智能體在涉及圖片的任務中，可被引導調用該工具。
模型配置¶
插件不攜帶任何 API Key。使用者需要在部署的 llm-pi-ai 設置中配置好多模態模型路由，或添加任意 OpenAI 兼容視覺端點。
可配置項包括：
provider
model
temperature
maxTokens
maxEdge
mode
其中：
provider和model留空表示自動選擇。maxEdge限制圖片最長邊像素，默認4096px。mode可選auto、force、off，分別控制自動調用引導的智能、強制和關閉模式。
設置頁¶
在 Web 應用中，可以通過「設置 → 視覺助手」配置：
- 提供方
- 模型
- 溫度
- 最大輸出 tokens
- 最大圖片邊長
配置每次使用即時讀取，無需重啓；引導段在保存時自動重新註冊。
零依賴與持久化¶
該插件採用零依賴設計：宿主模塊沒有任何 import，無需 npm install、無需修改 node_modules 結構、無需軟鏈接。
作爲 DSH 組合包，它是持久化且全局可用的：重啓不丟失，所有會話可用。
健壯性處理¶
插件還包含以下處理：
- 自動剝離粘貼路徑中的不可見 Unicode 字符，如
U+202A。 - 按最長邊限制圖片尺寸。
- 去重流式文本。
- 提供友好錯誤提示。
安裝與啓用¶
前提¶
安裝前確認以下事項：
- 已有 DSH Web 部署。
- 機器上有 pnpm。若使用 Node 自帶 corepack，可執行：
corepack enable pnpm
- 已在
llm-pi-ai設置中配置多模態模型路由，或已添加 OpenAI 兼容視覺端點。
npm 安裝¶
推薦從 npm registry 安裝：
npx @deepseek-ai/dsh plugin --profile web add dsh-vision-helper
GitHub 安裝¶
也可以從 GitHub 安裝：
npx @deepseek-ai/dsh plugin --profile web add github:Yuuz12/dsh-vision-helper
手動安裝¶
備用方式是將 dsh-vision-helper 文件夾複製到 <profile>/node_modules/，並在 <profile>/cordis.patch.yml 添加插件行：
- insert:
- id: dsh-vision-helper
name: 'dsh-vision-helper'
安裝後驗證¶
執行：
npx @deepseek-ai/dsh --profile web --dump-config
輸出中應看到 dsh-vision-helper 層。
然後重啓：
dsh web
經過上面的步驟，插件即可在 DSH 中啓用。
配置¶
可通過 Web 設置頁配置，也可編輯數據目錄下的 dsh-vision-helper.json。
配置文件位置隨安裝方式不同：
- registry / tarball / GitHub 安裝：
<profile>/dsh-vision-helper.json - 本地
link:安裝：回退到插件源碼目錄<repo>/dsh-vision-helper.json
字段示例如下，具體值按你的 llm-pi-ai 路由填寫：
{
"provider": "<provider>",
"model": "<model>",
"temperature": "<number>",
"maxTokens": "<number>",
"maxEdge": 4096,
"mode": "auto"
}
mode 說明：
auto：默認模式，控制自動調用引導的智能模式。force：強制模式，要求涉及圖片的任務使用該工具。off：關閉模式，不注入自動調用引導，但工具仍註冊。
典型用法¶
- 安裝插件並重啓 DSH。
npx @deepseek-ai/dsh plugin --profile web add dsh-vision-helper
npx @deepseek-ai/dsh --profile web --dump-config
dsh web
-
在 Web 應用中打開「設置 → 視覺助手」。
-
選擇提供方、模型、溫度、最大輸出 tokens、最大圖片邊長。
-
在任務中提供本地圖片路徑或
data:URI。 -
讓智能體調用
vision_analyze，由配置的多模態模型返回分析文字。
如果偏好配置文件，也可以直接編輯對應的 dsh-vision-helper.json，然後讓智能體再次使用視覺能力。
卸載¶
標準卸載¶
npx @deepseek-ai/dsh plugin --profile web remove dsh-vision-helper
該命令移除組合包層後，還需要刪除配置文件並重啓 DSH。
配置文件位置：
- registry / tarball / GitHub 安裝：
<profile>/dsh-vision-helper.json - 本地
link:安裝：<repo>/dsh-vision-helper.json
本地 link: 安裝時，remove 只刪除 node_modules 鏈接，源碼倉庫原樣保留。
手動卸載¶
如果之前是手動安裝：
- 從
<profile>/cordis.patch.yml移除插件行。 - 刪除
<profile>/node_modules/dsh-vision-helper。 - 刪除對應配置文件。
- 重啓 DSH。
適用場景與注意¶
適合以下使用者：
- 使用 DSH Web 部署。
- 希望智能體在圖片任務中調用獨立的視覺分析工具。
- 希望在 Web 設置頁或配置文件中管理多模態模型參數。
- 偏好低侵入安裝方式，不希望引入額外依賴。
使用前務必注意：
- 插件以當前 dsh 進程權限運行。安裝前應檢查源碼與許可證。
- 插件不攜帶 API Key，需要你自己配置多模態模型路由或 OpenAI 兼容視覺端點。
- 設置頁僅 Web 端提供；工具可在掛載該插件的任何 profile 中使用。
- 社區目錄是獨立站點，不是官方應用商店。
結尾¶
dsh-vision-helper 提供 vision_analyze 工具、可配置多模態模型和 Web 設置頁，適合把視覺分析能力接入 DSH 智能體。它的零依賴、持久化和配置即時讀取，降低了在 DSH 中集成視覺能力的成本。
GitHub：https://github.com/Yuuz12/dsh-vision-helper
目錄頁：DSH 社區目錄爲獨立站點；本文資料未提供可覈實的目錄頁 URL，請以 DSH 社區目錄發佈地址爲準。
