前言¶
DeepSeek Harness（DSH）通過插件擴展模型來源、會話選項和 Agent 預設。若要在桌面端使用 ShanghaiTech GenAI 本地或遠程網關，並保留網站側的聯網搜索、深度思考、網頁附件等能力，需要統一的 provider ID、會話 UI 與憑證讀取方式。dsh-shanghaitech-genai 由 Github-Anderson 維護，分類爲模型推理，將上述能力打包爲符合 DSH Bundle 規範的插件；本地網關與部署腳本在配套倉庫 ShanghaiTech-GenAI 中提供。
這是什麼¶
插件包名 dsh-shanghaitech-genai，當前資料中的版本爲 1.0.5，要求 DSH Desktop ≥ 0.2.1-rc.2。模型來源、Agent 預設及 provider ID 均爲 shanghaitech-genai，界面顯示爲 ShanghaiTech GenAI。它不負責單獨實現推理服務，而是適配網關、掛載會話選項與 Standard 原生工具流程，並從本地部署目錄或環境變量讀取 base_url 與密鑰。
核心功能¶
模型與會話選項¶
支持獨立的 Search / Thinking 選項、網站附件、來源與 usage 展示。輸入區按鈕隨 DSH 語言顯示爲「聯網搜索 / 深度思考 / 網頁附件」或 “Search / Thinking / Attachments”；啓用時高亮，行爲對應原網站功能。Thinking 是否顯示取決於網關能力；配套配置對 Kimi 與 GPT 系列開放。
網頁附件¶
發送消息時，附件走網站圖片上傳或文檔解析接口。圖片接受 PNG、JPEG、WebP、GIF，嚴格小於 20 MiB；文檔接受 PDF、TXT、CSV、DOCX、XLS、XLSX、PPT、PPTX、HTML、JSON，嚴格小於 10 MiB。資料註明 DOC、XML 被網站拒絕而未開放；需網關與所選模型均支持附件，掃描件無文本時不提供 OCR 回退。
PDF 與原生工具¶
獨立 PDF 文本工具名爲 shanghaitech_genai_read_pdf，仍只處理 PDF。
刪除會話¶
「刪除會話 / Delete session」有獨立確認，默認勾選「同時刪除網站歷史 / Also delete website history」。確認後永久刪除當前本地會話及子代理，並清理工作區記錄；不刪除工作區文件或獨立分叉。同步刪除網站歷史時，須等網站確認成功後再刪本地；舊會話缺少上游映射或登錄令牌變更時，可在網站清理歷史，或取消勾選僅刪本地。生成中或有待處理工作的會話須先停止。插件兼容 DSH 默認關閉的全文搜索；刪除後搜索索引刷新異常僅警告。功能適配已檢查的 JSONL 存儲生命週期；更新插件後應完全退出 DSH（含 Windows 托盤或 macOS 後臺進程）再重新打開。
安裝與啓用¶
已發佈版本（DSH Desktop 插件界面）¶
在插件安裝界面提交以下來源：
github:Github-Anderson/dsh-shanghaitech-genai#v1.0.5
已配置 DSH CLI 時，可安裝到指定 profile：
dsh plugin --profile <profile-name> add github:Github-Anderson/dsh-shanghaitech-genai#v1.0.5
私有 GitHub 倉庫安裝需要當前 Git 環境具備讀取權限。
本地開發與網關¶
Windows 與 macOS 可在兩個同級倉庫的父目錄運行配套腳本，從源碼打包並安裝插件。
Windows（PowerShell）：
powershell -ExecutionPolicy Bypass -File .\ShanghaiTech-GenAI\tools\Sync-Local.ps1
powershell -ExecutionPolicy Bypass -File .\ShanghaiTech-GenAI\tools\Deploy-Local.ps1
macOS（終端）：
./ShanghaiTech-GenAI/tools/Sync-Local.sh
./ShanghaiTech-GenAI/tools/Deploy-Local.sh
在網關倉庫運行 tools/Setup.sh（macOS）或 tools/Setup.ps1 / tools/Setup.cmd（Windows）完成首次部署與更新。默認運行目錄爲 macOS 的 ~/.local/share/shanghaitech-genai/，或 Windows 的 %LOCALAPPDATA%\ShanghaiTech-GenAI\；配置與網站憑證在 deploy/private/。檢查完成後完全退出 DSH，再通過運行目錄中的 deploy/Start.sh 或 deploy/Start.ps1 啓動。詳細參數見配套倉庫 tools/README.md。
網關地址與憑證¶
本地部署會自動登記私有目錄，插件從其中的 dsh-gateway.json 讀取 base_url 和 key_file。base_url 未填或留空時使用 http://127.0.0.1:8000/v1 及私有目錄中的 gateway.key；配置遠程地址時使用 key_file 指定的密鑰文件（相對於私有目錄）。尚未登記私有目錄時，可用環境變量 SHANGHAITECH_GENAI_BASE_URL 提供地址，密鑰使用 DSH 憑證引用 SHANGHAITECH_GENAI_API_KEY。
配置憑證後重啓 DSH，新建會話，選擇 ShanghaiTech GenAI 預設與同名模型來源。網關首次登錄與憑證導入見配套 安裝指南。
典型用法¶
1、按上文安裝插件並完成網關 Setup 與 Start。
2、在 DSH 中配置憑證並重啓，新建會話。
3、模型來源與會話預設均選 ShanghaiTech GenAI，按需開啓 Search、Thinking 或網頁附件後正常對話。
4、需要讀 PDF 文本時，由 Agent 通過 shanghaitech_genai_read_pdf 調用（與附件中的 PDF 解析路徑不同，工具僅處理 PDF 文件）。
適用場景與注意¶
適合已在或計劃使用 ShanghaiTech GenAI 網關、並希望在 DSH Desktop 內統一模型來源與會話選項的開發者。插件以當前 DSH 進程權限運行，安裝前應閱讀倉庫源碼與 MIT License。Node 需滿足 package.json 中 ^22.19.0 || >=24.0.0；包標記 private: true，避免誤發佈到 npm。社區目錄頁與 GitHub 倉庫相互獨立，目錄站點並非 DeepSeek 或幻方官方應用商店。
結尾¶
dsh-shanghaitech-genai 把 ShanghaiTech GenAI 的模型適配、會話選項、附件路由與刪除會話行爲收進一個 DSH Bundle，並與配套網關倉庫的部署流程對齊。進一步瞭解可查看 SkillHub 目錄頁 與 GitHub 倉庫。
