前言¶
DSH 內置的 web_search 能覆蓋通用網頁檢索，但要拿 arXiv 官方直鏈、SSRN 論文原文，或者做網頁截圖、文本向量化、文檔重排，通常得自己在主機層寫膠水代碼、再註冊成工具。dsh-jina 把這條路徑省掉了：它把 jina-cli 背後的 Jina AI API 能力封裝成 12 個 jina_* 模型工具裝進 dsh，並在 Web 設置頁提供帶即時餘額檢測的 API key 配置卡片。下面介紹它的功能、安裝方式和選型注意。
這是什麼¶
dsh-jina 由 minatoAI 維護，許可證爲 MIT，當前版本 0.5.2（2026-08-29）。GitHub 倉庫是 minatoAI/jina-web-search-dsh-plugin，插件/包名爲 dsh-jina。
它做兩件事：
- 安裝後所有會話（所有 agent preset）獲得 12 個
jina_*模型工具 - 在 Web 設置 → 插件 → 配置頁提供 Jina Tools 卡片，配置 API key，即時檢測 key 身份與餘額並標註 key 來源
實現上有幾點值得留意：主機插件僅依賴 Node 內置模塊與 dsh 主機服務，無第三方 npm 依賴；項目無 build 腳本、無需 allowBuilds 授權，瀏覽器 bundle（ui/client.js）預構建後直接提交，git 安裝開箱即用；測試基於 Node 內置測試運行器，npm test 等價於 node --test，自動發現 test/*.test.js。
12 個 jina_* 工具¶
| 工具 | 說明 |
|---|---|
jina_web_search |
通用網頁搜索，默認 web 域，另有 images / blog 域，支持時間過濾與地區/語言提示 |
jina_search_arxiv |
arXiv 預印本檢索，返回 arxiv.org 官方直鏈 |
jina_search_ssrn |
SSRN 論文檢索，返回 papers.ssrn.com 直鏈 |
jina_read |
把網頁讀成乾淨的 markdown |
jina_screenshot |
網頁截圖，返回託管圖片 URL（支持整頁截圖） |
jina_datetime |
推測網頁的發佈/更新時間 |
jina_expand |
把搜索詞擴展成一組相關查詢 |
jina_embed |
文本向量化（默認 jina-embeddings-v5-text-small） |
jina_rerank |
按相關性重排文檔（默認 jina-reranker-v3.5） |
jina_classify |
文本分類 |
jina_pdf |
從 PDF 提取圖表/公式（支持 arXiv ID） |
jina_primer |
獲取主機時鐘（ISO 時間/unix/時區）、網絡事實（公網 IP 與位置）與 Jina 賬戶狀態（身份/餘額） |
安裝與啓用¶
插件按 bundle 方式分發，用 dsh plugin 安裝進 profile。從 GitHub 安裝：
dsh plugin --profile web add github:minatoAI/jina-web-search-dsh-plugin
想固定代碼版本，可以指定 commit，避免後續推送改變實際安裝到的代碼：
dsh plugin --profile web add github:minatoAI/jina-web-search-dsh-plugin#<commit-sha>
本地開發調試可以直接裝本地文件夾：
dsh plugin --profile web add ./jina-dsh-plugin
安裝完成後重啓 dsh，新 bundle 在下次啓動時生效：
dsh --profile web
API key 配置與餘額檢測¶
經過上面的步驟重啓後，打開 Web 界面 → 設置 → 插件 → 配置，展開 Jina Tools 卡片，粘貼 API key 並保存。免費 key 在 https://jina.ai/ 獲取。
卡片中的 API key 檢測區域會即時顯示當前 key 的身份（Jina 賬號）與餘額（credits），並標註 key 來源（本頁保存 / key 文件 / 匿名配額），用於確認 key 是否真正生效；保存或清除 key 後會自動重新檢測。這些數據由主機端插件的 /api/dsh-jina/primer 路由提供，與 jina_primer 工具用的是同一接口。
安全方面：key 明文永不離開主機，憑據值只通過 credentials.set 上行，任何讀取接口都不會回傳明文。設置頁保存新 key 後立即生效，無需重啓；遇到 HTTP 401 時插件會自動重讀文件並重試一次。
API key 解析順序¶
每次工具調用按以下順序查找 key，任一命中即用：
- 工具調用參數
apiKey - 設置頁保存的 key（憑據引用
JINA_API_KEY，由 dsh 憑據存儲持久化，如~/.dsh/.credentials.yaml） - 會話工作區的
jina-api-key.txt - dsh 主目錄（
$DSH_HOME，默認~/.dsh）下的jina-api-key.txt
網絡與代理¶
Jina 域名被直連網絡屏蔽，中國大陸用戶需要 VPN。插件通過系統代理訪問 Jina：每次調用前從 WinINET 註冊表發現系統代理地址，傳輸失敗時自動重新發現並重試一次，VPN 重啓換了端口也能自愈。VPN 未開啓時，工具會返回帶提示的錯誤信息。
與內置 web_search 的分工¶
README 給出的選型建議（來自與內置 web_search 的抽樣對比，非嚴格 benchmark）：
- 學術論文 →
jina_search_arxiv/jina_search_ssrn - 中文時效新聞 →
jina_web_search（加time過濾） - 泛學術 / 工程文檔 → 內置
web_search
需要注意，jina_web_search 默認的 web 域對 Springer / IEEE / ACL 等泛學術來源覆蓋面一般，學術檢索建議改用上面兩個專用工具。
適用場景與注意¶
適合在 DSH 裏需要論文直鏈、網頁轉 markdown、截圖、embedding / rerank / 分類等能力的用戶，可以作爲檢索與文檔處理工具鏈的補充。使用前注意以下幾點：
- 安裝後必須重啓 dsh，新 bundle 在下次啓動時才生效
- 大陸直連無法訪問 Jina，需要 VPN
- 插件以當前 dsh 進程的權限運行，安裝前建議閱讀倉庫源碼，並確認 MIT 許可證符合你的使用場景
- 不需要時可以隨時卸載：
dsh plugin --profile web remove dsh-jina
結尾¶
dsh-jina 的價值集中在兩處：把 Jina 的 12 項 API 能力變成模型開箱即用的工具，並把 key 管理收進 dsh 標準的插件配置入口、附帶即時餘額檢測。如果你經常在 DSH 裏做檢索和文檔處理，可以按上面的步驟裝一份試試。
- 社區目錄頁：https://www.skillhub.cn/plugins/minatoAI/jina-web-search-dsh-plugin
- GitHub 倉庫：https://github.com/minatoAI/jina-web-search-dsh-plugin
