前言¶
在 DeepSeek Harness（DSH）裏接自建網關、第三方中轉或兼容 OpenAI / Anthropic 協議的端點時，模型能力往往要在 cordis.patch.yml 裏手寫 provider 與 models 條目。與 @WorkBuddy-ai/dsh-llm-pi-ai 配合使用時，模型是否支持圖片，取決於 YAML 裏有沒有 input 字段：未聲明時按純文本處理，本地會攔截帶圖請求並提示不支持 image input。
手改幾百行 YAML 時，縮進和列表層級很容易出錯，還可能破壞原有註釋與格式。dsh-pi-ai-patch 把「是否聲明 text + image」做成設置面板裏的勾選框，只改 DSH 側的模型聲明，不碰 API 與網絡請求本身。
這是什麼¶
dsh-pi-ai-patch 是維護者 sdwf4wgv5z-rgb 發佈的 DSH 客戶端插件（社區目錄：SkillHub 條目）。定位是 cordis.patch.yml 的可視化配置模板工具：對你指定的模型寫入或移除如下片段，其餘 YAML 內容儘量原樣保留。
input:
- text
- image
勾選後 DSH 會認爲該模型可收圖，本地攔截不再觸發，上傳的圖片會隨請求發到你配置的端點；端點是否真能識圖，由你的 API 決定。聲明與能力不符時，錯誤可能從 DSH 本地提示變爲上游返回的錯誤。
它做什麼，不做什麼¶
插件只做一件事：在目標模型條目下增加或刪除 input 列表（text / image）。它不會給 API 增加能力，不會改寫請求體，不會訪問外網業務邏輯。
在 dsh-llm-pi-ai 中，input 是模態聲明；默認等價於 ["text"]。因此本插件解決的是「聲明與使用意圖一致」，而不是替後端實現多模態。
核心功能¶
下面能力均來自倉庫 README 與 package.json 說明。
- 設置 → 識圖配置：按 provider 分組列出模型，勾選即寫入
input: [text, image]（或僅 text 相關組合），取消即移除該字段。 - 安全編輯：行級、字節級編輯，儘量保留註釋、鍵順序與引號風格；寫入前做 YAML 校驗，解析失敗則放棄寫入。
- 自動備份：每次保存前備份爲
cordis.patch.yml.bak-vision-config。 - 本機 HTTP 服務：僅監聽
127.0.0.1:19877，供設置頁與本地邏輯通信。 - 客戶端實現方式：通過
settings.section與fetch接入，不依賴 DSH 私有 API，小版本升級相對不易被打掛。 - Bundle 補丁：插件 bundle 攜帶
cordis.patch.yml補丁入口（見package.json的dsh.bundle.patch）。
依賴：yaml ^2.9.1；運行環境 Node.js >= 20。許可證 MIT，當前 package 版本 1.0.0。
安裝與啓用¶
官方快速開始以 本地 link 註冊 爲主，而非目錄頁拼接的安裝命令。先做依賴安裝，再在 profile 裏聲明 bundle。
- 將倉庫放到本機目錄（README 示例爲 Windows 路徑，Linux 可換成等價目錄）：
git clone https://github.com/sdwf4wgv5z-rgb/dsh-pi-ai-patch.git C:\dsh-pi-ai-patch
cd C:\dsh-pi-ai-patch
npm install --omit=dev
- 在 profile 的
package.json（通常爲~/.dsh/profiles/desktop/package.json）中註冊 link 與 bundle：
{
"dependencies": {
"dsh-pi-ai-patch": "link:C:/dsh-pi-ai-patch"
},
"dsh": { "profile": { "bundles": ["...", "dsh-pi-ai-patch"] } }
}
路徑需改成你本機 clone 的實際位置；bundles 數組裏保留原有條目，並加入 dsh-pi-ai-patch。
- 完全退出 DSH 再啓動，打開 設置 → 識圖配置，按端點能力勾選模型。
保存後需 再次重啓 DSH 生效，因爲 provider 配置在啓動時加載。
安裝前建議閱讀 GitHub 倉庫 源碼與 LICENSE；插件以當前 DSH 進程權限在本機運行，並會修改你的 cordis.patch.yml。
典型用法與寫入效果¶
在識圖配置裏爲某個 model id 勾選支持圖片後，插件只在對應模型塊插入 input 段，例如：
models:
- id: gpt-4o
name: GPT-4o
contextWindow: 128000
input:
- text
- image
註釋、鍵順序、引號、BOM、換行符等其餘內容按設計應儘量不動。更完整的原理、HTTP 接口與開發說明見倉庫內 README.full.md（中文）與 README.en.md。
適用場景與注意¶
適合：已在 DSH 中使用 llm-pi-ai、通過 cordis.patch.yml 聲明自建或中轉模型，且需要部分模型在 DSH 側聲明 image 輸入，又不想手改 YAML 的用戶。
務必知曉：
- 只改 DSH 聲明，不保證上游多模態；請按端點真實情況勾選。
- 固定端口
19877；若佔用，需同時改index.js的PORT與client.js的VISION_BASE。 - 面板默認遍歷
llm-pi-ai段；使用其他 llm 插件時需調整findModelIdx。 - 僅修改
cordis.patch.yml，不碰package.json、node_modules及.dsh下其他狀態文件。
DSH 生態強調「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。本插件在目錄中分類爲客戶端，當前 GitHub 星標爲 0，以倉庫與目錄頁信息爲準。
結尾¶
若你的痛點是「識圖能力其實已在網關側具備，卻被 DSH 默認純文本聲明攔住」，dsh-pi-ai-patch 用設置裏的一行勾選，把 input 模態寫進 cordis.patch.yml，並儘量保證 YAML 編輯安全。進一步瞭解可訪問 SkillHub 插件頁 與 GitHub：sdwf4wgv5z-rgb/dsh-pi-ai-patch。
