前言¶
在 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 来用的开发者。
