前言¶
DeepSeek Harness(DSH)裏很多對話模型只處理文本,用戶卻在會話裏直接貼圖。常見做法是換用自帶多模態的模型,或在宿主外單獨跑視覺 API,再把結果塞回上下文。維護者 iguanren 的 Ts-vision(中文名 泰山識圖)走另一條路:在 DSH 桌面客戶端裏掛 bundle 插件,用智譜 GLM 免費視覺模型做識圖,當前選中的純文本模型仍負責推理與回覆。插件分類爲「模型推理」,當前 GitHub 星標爲 0;發行渠道僅爲 GitHub 倉庫 iguanren/Ts-vision,社區目錄頁見 SkillHub 條目。SkillHub 爲獨立社區目錄,與 DeepSeek、幻方無官方從屬關係。
這是什麼¶
Ts-vision 是面向 DSH Windows 桌面客戶端的 Cordis bundle 插件(package.json 中版本 1.2,許可證 MIT)。README 標明需 DSH ≥ 0.1.7,並寫明適配桌面客戶端 V0.1.7-rc.2,重啓後配置持久生效。
一句話定位:智譜 GLM 免費視覺模型識圖 + 當前模型推理,讓純文本模型也能在帶圖對話裏工作。
核心功能¶
下面能力均來自倉庫 README 與 package.json 說明,未在資料中出現的細節不寫。
- 免費識圖:默認推薦
glm-4.6v-flash、glm-4.1v-thinking-flash(資料中標註完全免費);前一個失敗時按面板裏模型順序自動嘗試下一個。 - 原生配置面板:DSH 側邊「插件」→
ts-vision,與官方插件卡片同機制;bundle 頂部有「啓用 ts-vision」總開關,由宿主統一管理。 - API Key:在面板「智譜 API KEY」行粘貼並保存,立即生效;明文不回顯,重啓不丟。也可寫入
~/.dsh/.credentials.yaml的refs下ZHIPU_GLM_API_KEY。 - 模型列表:勾選控制單個視覺模型啓停,拖動手柄調整調用順序;未配置 Key 的模型默認關閉。
- provider 補丁:
zhipu-glm聲明缺失時,插件自動寫入 profile 補丁(需重啓 DSH 後生效)。 - 工具與防護:模型可調用
ts_vision_describe_image(參數image_ref爲圖片附件 ID);視覺返回帶圍欄聲明,減輕圖片內指令注入風險。排障可用ts_vision_diag輸出憑據、路由、包裝狀態。
默認推薦免費模型參數(README 表格):
| 模型 | 上下文 | 最大輸出 |
|---|---|---|
| glm-4.6v-flash | 128K | 32K |
| glm-4.1v-thinking-flash | 64K | 16K |
安裝與啓用¶
資料說明:不需要 dsh CLI,不寫 npm;從 GitHub 取源碼後在本機執行安裝腳本。安裝前請自行審閱倉庫源碼與 MIT 許可證;插件隨當前 DSH 進程權限運行,憑據寫入本地 profile,使用前確認環境可信。
先做克隆或下載倉庫,再在倉庫根目錄運行一鍵安裝腳本:
git clone https://github.com/iguanren/Ts-vision
cd Ts-vision
powershell -NoProfile -ExecutionPolicy Bypass -File install-desktop.ps1
腳本會:複製插件到 ~/.dsh/profiles/desktop/node_modules/ts-vision;更新 profile 的 package.json(dependencies 與 dsh.profile.bundles);在 cordis.patch.yml 追加 ts-vision 條目(已存在則跳過)。重複運行即升級。
經過上面的步驟後,重啓 DSH 客戶端生效。
若需手動安裝,README 給出等效路徑:將 lib/、locale/、package.json、cordis.patch.yml 複製到 C:\Users\<你>\.dsh\profiles\desktop\node_modules\ts-vision\,並在 profile 的 package.json 與 cordis.patch.yml 中按 README「手動安裝」一節追加依賴與 - id: ts-vision 條目,同樣需重啓客戶端。
配置 API Key¶
打開「插件」面板 → ts-vision,在「智譜 API KEY」行粘貼 Key 並點「保存」。Key 可在 open.bigmodel.cn 申請(資料寫明免費檔即可用 GLM 視覺模型)。
首次安裝時,若 zhipu-glm 提供方尚未註冊,插件已自動寫入 profile 補丁;粘貼 Key 保存後 再重啓一次 DSH,GLM 模型纔會出現在「可用視覺模型」列表。之後可在面板勾選模型、拖動排序,或在改 Key / 改模型配置後點「重新掃描」。
典型用法¶
- 發送帶圖片的消息。插件會自動注入識圖相關指令,純文本模型也會收到「請調用識圖工具」類提示。
- 模型調用
ts_vision_describe_image,image_ref傳圖片附件 ID,拿到描述後再回答用戶。 - 也可直接讓模型「描述這張圖」。
識圖失敗時,可讓模型執行 ts_vision_diag,或查看 DSH 終端中帶 [泰山識圖] 的日誌。插件頁無表單時,README 建議確認 DSH ≥ 0.1.7 並重啓;仍異常時可按 README 在開發者工具 Console 檢查 window.__TSVISION_* 相關變量。
適用場景與注意¶
適合:已在 Windows 上使用 DSH 桌面客戶端、主模型爲純文本、又需要在同一會話裏讀圖的用戶;希望用智譜免費視覺檔、不想單獨維護一套識圖 HTTP 服務的場景。
注意:
- 安裝與路徑示例以 Windows profile(
~/.dsh/profiles/desktop)爲準;Linux 用戶若 profile 佈局不同,需對照本機 DSH 文檔調整,資料未給出非 Windows 一鍵腳本。 - 卸載可在插件面板點「卸載」,或按 README 刪除
node_modules/ts-vision、清理package.json/cordis.patch.yml中相關條目;不再使用的ZHIPU_GLM_API_KEY可從~/.dsh/.credentials.yaml手動刪除。 - 自舊版 taishan-vision 升級時,工具名與 HTTP 路徑已變更(如
ts_vision_describe_image、/api/ts-vision/*),憑據變量名ZHIPU_GLM_API_KEY不變。
結尾¶
泰山識圖把「看圖」拆成 GLM 視覺識別與現有文本模型推理兩步,並嵌進 DSH 插件面板與 bundle 開關,適合在 Harness 生態裏按「一切皆插件」的方式擴展多模態能力。進一步瞭解請查看 GitHub 倉庫 與 SkillHub 目錄頁。