dsh-scnet-connect 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-scnet-connect contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,259 @@
-# Temporary Holding Version
+# SCNet Connect
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm](https://img.shields.io/npm/v/dsh-scnet-connect)](https://www.npmjs.com/package/dsh-scnet-connect)
+[![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+把 **SCNet 模型**接入 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)。
+可**免客户端登录**，使用免费模型（`SCNet-Max`，基座为 DeepSeek Flash 系列 —— 实测与 `DeepSeek-V4.1-Flash-1017` 行为一致，证据见 [基座认定](#基座认定scnet-max-与-deepseek-v41-flash-1017-的行为比对)）。
+
+- **零客户端**：不装 SCNet 桌面客户端，用手机短信登录即可使用
+- **零配置**：装了客户端的话，自动读凭据、自动发现免费模型
+- **设置页管理**：账号、登录、模型开关都在 DSH 设置里
+
+![设置页](.github/assets/settings.png)
+
+---
+
+## 基座认定：SCNet-Max 与 DeepSeek-V4.1-Flash-1017 的行为比对
+
+`SCNet-Max` 在平台目录里的 `description` 只有四个字（`SCNet-Max`），没有任何基座标注。下面是一组可复现的实测，用来判断它的基座。
+
+对比对象为 `DeepSeek-V4.1-Flash-1017`。
+
+
+### 证据一：分词器与对话模板完全一致
+
+同一字符串在两侧算出的 `prompt_tokens` 逐项相同（22 个探针，22 个一致）：
+
+| 探针 | 两侧 `prompt_tokens` |
+| --- | --- |
+| `"Hi"`（模板开销） | 31 |
+| 中文 | 36 |
+| 阿拉伯语 | 40 |
+| 印地语 | 47 |
+| 泰语 | 43 |
+| 韩语 | 41 |
+| 家庭 emoji（ZWJ） | 52 |
+| 旗帜 emoji | 46 |
+| 4 字节 CJK（`𠀋𠀌𠀍`） | 43 |
+| 零宽字符 + 组合音标 | 39 |
+| 代码块 | 44 |
+| base64 | 66 |
+| JSON | 41 |
+| 400 个 ASCII | 80 |
+| 200 个「中」 | 230 |
+
+基准串 `"Hi"` 在两侧都是 **31** token，说明 chat template 也一致。
+
+### 证据二：`temperature=0` 下逐字输出
+
+8 道确定性短题，其中 7 道字节级完全相同（sha256 前 8 位）：
+
+| 题目 | 输出 | sha256[:8] |
+| --- | --- | --- |
+| 输出 JSON `{"ok":true}` | `{"ok":true}` | `4062edaf75` |
+| 列出 1 到 5 | `1, 2, 3, 4, 5` | `43f0c4c6d1` |
+| `"hello world"` 转大写 | `HELLO WORLD` | `787ec76dca` |
+| 斐波那契第 10 项 | `55` | `02d20bbd7e` |
+| 3 的 5 次方 | `243` | `72440a20f5` |
+| `"abc"` 反转 | `cba` | `6d970874d0` |
+| 2024 是否闰年 | `是` | `b5141d3d19` |
+
+唯一不同的是自由论述题（「用一句话解释哈希表」）。该题在 `temperature=0.7` 复测时，两侧各采样出**完全相同的一整句**：
+
+```text
+哈希表是一种通过哈希函数把键映射到存储位置，从而以平均常数时间实现键值查找、插入和删除的数据结构。
+```
+
+跨两个不同网关各自采样，能撞出整句相同的汉语，基本排除「不同模型」的可能。
+
+### 证据三：知识边界重合
+
+| 事实 | 两侧答案 |
+| --- | --- |
+| Gemini 3 发布 | 2025-11-18 |
+| GPT-5 发布 | 2025-08-07 |
+| Claude 4 发布 | 2025-05-22 |
+| 2026 春节 | 2026-02-17 |
+| 2025 诺贝尔文学奖 | 拉斯洛·克拉斯纳霍尔凯（László Krasznahorkai） |
+| DeepSeek V4 | 均否认已发布（「截至 2026-04 / 2026-05」） |
+| DeepSeek-V4.1-Flash-1017 | 均不认识 |
+
+两侧都不认识自己的发布名——模型对自身 release 无知属正常现象，不构成反证。
+
+### 证据四：网关实现不同（证明这是两个独立部署）
+
+| 字段 | SCNet-Max | 对比侧 |
+| --- | --- | --- |
+| `prompt_cache_hit_tokens` / `prompt_cache_miss_tokens` | 无 | 有（DeepSeek 原生 schema） |
+| `service_tier` | 有 | 无 |
+| `system_fingerprint` | 字段缺失 | `""` |
+
+### 结论与残留不确定性
+
+**可以确定**：`SCNet-Max` 与 `DeepSeek-V4.1-Flash-1017` 在 tokenizer、chat template、知识边界、确定性输出上全部一致，属**同一模型**。
+
+**不能确定**：SCNet-Max 究竟是 `1017`，还是更早的 `DeepSeek-V4.1-Flash-0910`。DeepSeek 历代模型共用同一 tokenizer。
+
+
+## 安装
+
+三种方式，任选其一。
+
+### 方式一：DSH 插件页直接安装（最简单）
+
+打开 DSH 的 **插件** 页，在搜索/安装框里输入包名：
+
+```text
+dsh-scnet-connect
+```
+
+点安装即可。装完重启 DSH，或改一下 profile 的 `cordis.patch.yml` 触发热重载。
+
+### 方式二：命令行安装（npm）
+
+```bash
+dsh plugin --profile desktop add dsh-scnet-connect
+```
+
+### 方式三：从源码安装
+
+```bash
+git clone https://github.com/Phoeky/dsh-scnet-connect.git
+cd dsh-scnet-connect
+dsh plugin --profile desktop add link:.
+```
+
+> 装完如果没生效，改一下 profile 的 `cordis.patch.yml`（加一行注释再保存）触发热重载，或重启 DSH。
+
+---
+
+## 快速开始
+### 方式一：免客户端登录（推荐）
+
+打开 **设置 → SCNet Connect**：
+
+1. 填手机号 → 点「获取验证码」→ 输入图形验证码
+2. 点「发送短信验证码」→ 填收到的 6 位验证码
+3. 点「登录」
+
+登录成功后插件会自动换取模型 Key，无需其他操作。
+
+### 方式二：用本机 SCNet 客户端
+
+先装好 SCNet 客户端并登录，正常发起一次对话（让客户端把凭据落到本地）。
+插件会自动读取凭据，客户端之后可以关掉。
+
+---
+
+## 使用
+
+在 DSH 的模型选择器里选 **SCNet Connect → SCNet-Max**。
+
+设置页可以：
+
+| 功能 | 说明 |
+| --- | --- |
+| 查看账号 | 用户名、ID、脱敏手机号、登录态剩余天数 |
+| 登录 / 退出 | 短信登录；退出后插件停止供 Key，可随时「恢复使用」 |
+| 只显示免费模型 | 默认开启。关闭后会把目录里所有模型都注册出来（可能产生费用） |
+| 刷新模型 | 重新读模型目录并用网关校验可用性 |
+
+![模型开关](.github/assets/settings-models.png)
+
+---
+
+## 配置
+
+全部有默认值，一般不用改。需要时在 profile 的 `cordis.patch.yml` 里给 entry 加 `config`：
+
+```yaml
+- id: scnet-connect
+  name: dsh-scnet-connect
+  config:
+    freeOnly: true           # 只注册免费模型（默认开）
+    credentialSource: auto   # auto | client | login
+    modelIds: ''             # 逗号分隔；留空 = 自动发现
+    contextWindow: 0         # 0 = 跟随目录/默认
+    maxTokens: 0             # 0 = 跟随目录/默认
+```
+
+<details>
+<summary>全部字段</summary>
+
+| 字段 | 默认 | 说明 |
+| --- | --- | --- |
+| `credentialSource` | `auto` | `auto` 先客户端再登录；`client` 只用客户端；`login` 只用设置页登录 |
+| `freeOnly` | `true` | 只注册 `priceLabel=free` 的模型 |
+| `credentialDir` | 空 | 默认 `~/.sclaw/agent/scnet-credentials` |
+| `apiKey` | 空 | 直接指定 Key（会明文存在配置文件里） |
+| `baseUrl` | `https://api.scnet.cn/api/llm/v1` | 网关地址 |
+| `modelIds` | 空 | 指定模型 id，逗号分隔 |
+| `modelName` | 空 | 自定义显示名（仅单模型时生效） |
+| `contextWindow` / `maxTokens` | `0` | 覆盖上下文/输出上限 |
+| `inputImages` | `true` | 是否声明接受图片 |
+| `reasoning` | `true` | 是否声明支持思考等级 |
+| `verifyWithGateway` | `true` | 刷新时用 `GET /models` 校验 |
+
+</details>
+
+---
+
+## 故障排查
+
+| 现象 | 处理 |
+| --- | --- |
+| 模型选择器里没有 SCNet Connect | 确认插件已装、profile 的 `dsh.profile.bundles` 里有 `dsh-scnet-connect`，然后触发热重载或重启 DSH |
+| 设置页没有 SCNet Connect | 需要 DSH `0.2.2` 及以上（`settings.section` slot） |
+| 没有可用模型 | 点「刷新模型」；免客户端模式下登录成功后会自动刷新 |
+| 报 `No API key for provider: scnet` | 没有可用凭据：去设置页登录，或装客户端并登录一次 |
+| 提示「平台会话已过期」 | 在设置页重新登录一次 |
+| 短信收不到 | 确认手机号正确、图形验证码没填错；平台有 60 秒与每小时次数限制 |
+| 上游 429 | 插件不屏蔽限流，降低并发或稍等重试 |
+
+---
+
+## 安全
+
+- **不接收账号密码**：只走短信验证码，密码从不经过插件。
+- 登录会话存于 `$DSH_HOME/scnet-session.json`（权限 `0600`），退出登录即删除。
+- **这两样东西等价于你的账号权限**：不要复制给他人，不要提交进仓库。
+- 插件只在本机回环地址上暴露设置页路由，且**不返回** Key / Cookie / 验证码明文。
+- 若用 `apiKey` 配置项，它以明文存在 profile 的 `cordis.patch.yml` 里，请自行控制权限。
+
+> `sk-` Key 是账号级凭据、与 SCNet 客户端共用，平台没有吊销接口。
+> 所以「退出登录」的语义是**停止使用**，不是让 Key 在平台失效；要作废请到 SCNet 平台重置账号凭据。
+
+---
+
+## 已知限制
+
+- 免费模型取决于平台：目前只有 `SCNet-Max` 标记为 `free`。
+- 「免费」是平台侧的**限时**政策，不是永久免费；本插件不提供额度，也不绕过计费。
+- 插件内**不提供微信扫码**（平台二维码接口对非微信客户端恒返回 402）。
+- 用的是未公开的客户端内部接口，SCNet 客户端升级后可能变化。
+
+---
+
+## 开发
+
+```bash
+git clone https://github.com/Phoeky/dsh-scnet-connect.git && cd dsh-scnet-connect
+node tools/check.mjs          # 自检：凭据、模型目录、账号
+node tools/check.mjs --live   # 额外请求一次 /models
+```
+
+```text
+lib/index.js            插件入口：注册 provider、设置页路由
+lib/client.js           浏览器侧：设置页卡片
+lib/scnet-login.js      免客户端登录状态机
+lib/scnet-platform.js   平台接口封装
+lib/scnet-web-login.js  短信登录与验证码
+lib/scnet-catalog.js    模型目录发现与过滤
+lib/scnet-credential.js 客户端凭据读取
+lib/scnet-models.js     模型描述符
+```
+
+## License
+
+[MIT](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,29 @@
+# dsh-scnet-connect（SCNet Connect）bundle patch
+#
+# 把插件本体装进 profile：
+#   id   = loader entry id
+#   name = npm 包名（loader 用它 import 入口模块）
+#
+# provider（路由 `scnet`）由 lib/index.js 在 apply() 里动态注册，
+# 不在这里写 provider 配置，避免覆盖用户现有的 llm-pi-ai.providers。
+#
+# 零配置即可用：默认读取本机 SCNet 客户端凭据，自动注册客户端目录里
+# 所有 priceLabel=free 的模型（当前是 SCNet-Max）。
+# 没装客户端也能用：在设置页用手机短信登录。
+- insert:
+    - id: scnet-connect
+      name: dsh-scnet-connect
+      config: {}
+      # 全部字段有默认值；需要覆盖时取消对应注释。
+        # credentialDir: ''   # 默认 ~/.sclaw/agent/scnet-credentials
+        # apiKey: ''          # 留空 = 自动读客户端凭据（填了会明文存在本文件里）
+        # baseUrl: 'https://api.scnet.cn/api/llm/v1'
+        # modelIds: ''        # 逗号分隔；留空 = 自动注册所有免费模型
+        # modelName: ''       # 仅在只注册一个模型时生效
+        # contextWindow: 0    # 0 = 跟随客户端目录 / 内置默认
+        # maxTokens: 0        # 0 = 跟随客户端目录 / 内置默认
+        # inputImages: true
+        # reasoning: true
+        # verifyWithGateway: true  # 刷新模型时用 GET /models 校验可用性
+        # freeOnly: true           # 只注册免费模型（默认开）
+        # credentialSource: auto   # auto | client | login