前言¶
在 DeepSeek Harness（DSH）裏接第三方推理，常見做法是自備 API Key、在 profile 裏手配 provider，或先裝廠商桌面客戶端再想辦法把憑據餵給 Harness。超算互聯網（SCNet）側有免費檔模型，但若強依賴官方客戶端登錄，對只想在 DSH 裏選模型開聊的開發者會多一步摩擦。
下面介紹社區插件 dsh-scnet-connect（維護者 Phoeky，GitHub Phoeky/dsh-scnet-connect，npm 包名 dsh-scnet-connect，當前版本 1.2.0，MIT 許可證）。它把 SCNet 模型註冊爲 DSH 的 model provider，支持免客戶端用手機短信在設置頁登錄，默認只暴露免費模型 SCNet-Max；README 中通過分詞器、確定性輸出等實測說明其行爲與 DeepSeek Flash 系列（如 DeepSeek-V4.1-Flash-1017）一致，具體比對見倉庫文檔「基座認定」一節。
這是什麼¶
dsh-scnet-connect 是 DSH 的模型推理類插件：從 SCNet 網關（默認 https://api.scnet.cn/api/llm/v1）拉取模型目錄、管理憑據，並把可用模型掛到 DSH 模型選擇器。憑據來源支持「本機 SCNet 客戶端目錄」與「設置頁短信登錄」兩種路徑，也可在配置裏指定 credentialSource 與可選的 apiKey。
插件在 DSH 設置中提供 SCNet Connect 區塊（需 DSH 0.2.2 及以上，依賴 settings.section slot），用於賬號查看、登錄/退出、免費模型開關與刷新模型列表。
核心功能¶
以下能力均來自倉庫 README 與 package.json，不展開未在資料中出現的承諾。
接入與憑據
- 零客戶端路徑（推薦）：設置頁填手機號、圖形驗證碼與短信驗證碼即可登錄；無賬號時插件會按平臺返回自動走註冊再登錄，並在首次開通模型服務時調用平臺授權接口。
- 客戶端路徑：若本機已裝 SCNet 客戶端並登錄，插件可自動讀取默認憑據目錄（
~/.sclaw/agent/scnet-credentials，可通過credentialDir覆蓋）。 - 零配置默認：
freeOnly: true時只註冊標價免費的模型，避免誤開付費項。
模型能力（SCNet-Max）
- README 聲明 1M 上下文：
contextWindow: 1048576、maxTokens: 131072；附實測說明約 104.5 萬 token 輸入可通過。 - 網關偶發
503且code爲10008時，插件默認將這類響應歸一化爲可重試的服務端錯誤（retryOnTransientErrors: true），交給 DSH 指數退避重試，而不是被誤判爲不可重試的INVALID_REQUEST。
運維與排障
- 登錄失敗等診斷信息可寫入
$DSH_HOME/scnet-connect-status[.<profile>].json；會話與偏好分別落在scnet-session.json、scnet-connect-preferences.json等文件（詳見 README「配置」與「故障排查」）。
安裝與啓用¶
任選 README 列出的一種方式即可。裝完後若未生效，可改一下 profile 的 cordis.patch.yml 觸發熱重載，或重啓 DSH。
方式一：DSH 插件頁
在插件搜索/安裝框輸入包名：
dsh-scnet-connect
方式二：命令行（npm）
dsh plugin --profile desktop add dsh-scnet-connect
方式三：從源碼 link（需自行 clone 倉庫）
git clone https://github.com/Phoeky/dsh-scnet-connect.git
cd dsh-scnet-connect
dsh plugin --profile desktop add link:.
運行環境：package.json 要求 Node ^22.19.0 || >=24.0.0，DSH 版本需滿足其 engines.dsh 範圍（與 @deepseek-ai/dsh-llm 等 peer 對齊）。
啓用後請確認 profile 的 dsh.profile.bundles 中包含 dsh-scnet-connect，否則模型選擇器裏不會出現 SCNet Connect。
典型用法¶
免客戶端登錄¶
- 打開 設置 → SCNet Connect。
- 填手機號 →「獲取驗證碼」→ 輸入圖形驗證碼 →「發送短信驗證碼」→ 輸入 6 位短信碼 →「登錄」。
- 登錄成功後插件自動換取模型 Key；新賬號若提示模型服務未開通，插件會按 README 描述自動完成授權後重試。
若平臺把提交誤判爲賬號密碼登錄，README 建議刷新圖形驗證碼後重發短信碼；原始錯誤會記入 login.lastFailure 便於排查。
使用本機客戶端憑據¶
安裝並登錄 SCNet 客戶端，至少發起一次對話讓憑據落盤；插件在 credentialSource: auto（默認）下會優先嚐試客戶端再回退登錄態。
在 Harness 裏選模型¶
在 DSH 模型選擇器中選擇 SCNet Connect → SCNet-Max。設置頁可切換「只顯示免費模型」、刷新模型目錄，或退出登錄（退出後會寫入 scnet-connect-suspended.json，連客戶端憑據一併停用直至恢復）。
可選 profile 配置¶
一般無需改動；需要時在 cordis.patch.yml 爲 entry 增加 config，例如：
- id: scnet-connect
name: dsh-scnet-connect
config:
freeOnly: true
credentialSource: auto
modelIds: ''
contextWindow: 0
maxTokens: 0
更多字段（baseUrl、verifyWithGateway、retryOnTransientErrors 等）見 README 配置表。注意：設置頁切換的「只顯示免費模型」會寫入 scnet-connect-preferences.json，優先級高於配置文件中的 freeOnly。
適用場景與注意¶
適合誰
- 已在用 DSH 做 agent / 對話開發，希望直接調用 SCNet 免費檔 SCNet-Max，且不想長期掛着 SCNet 桌面客戶端。
- 需要較長上下文窗口、並能接受網關爲第三方託管（與 DeepSeek 官方直連在響應字段上可能不同，README「基座認定」中有
prompt_cache_*、service_tier等差異說明）。
使用注意
- 插件以當前 DSH 進程權限在本機讀寫憑據與會話文件；安裝前請自行閱讀 源碼 與 MIT 許可證，勿將
scnet-session.json或配置中的apiKey提交進倉庫。 - 關閉「只顯示免費模型」會把目錄中全部模型註冊出來，可能產生費用；目錄裏
toolCalling: false的模型仍會註冊，但設置頁會標「不支持工具」，選用前需留意。 - 上游
429限流插件不屏蔽，需自行降併發或稍後重試。 - SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；Stars 等信息以各頁面實時顯示爲準（GitHub 倉庫當前約 3 stars）。
結尾¶
dsh-scnet-connect 把 SCNet 的模型目錄與憑據管理收進 DSH 插件與設置頁：短信登錄、默認免費模型、長上下文聲明，以及對 503/10008 類抖動的重試歸一化，適合想把 SCNet-Max 當作 Harness 裏一個常規 provider 來用的開發者。
