dsh-any-deepseek 0.0.17 → 0.0.18

package/CONTRIBUTING.md

@@ -29,7 +29,7 @@
 
 加完这一条，面板的规格下拉里就有它了 —— 不需要改别处。
 
-**两条硬规矩**（都是付过代价的）：
+**三条硬规矩**（都是付过代价的）：
 
 1. **注释里不要写「我探过了」，除非真的探过。**
    这个仓里曾经有一条 `Probed live: the billing pair answers` 的注释，而那个路由**从没被调用过**，
@@ -39,6 +39,22 @@
    我们对外只暴露 `deepseek-v4.1-flash` 一个 id，各家的拼写由预设吸收。
    **这正是这个插件存在的理由** —— 所以别在预设里图省事写我们的 id。
 
+   三种拼写的真实例子（都在仓内）：
+
+   | 渠道 | 它要的写法 | 说明 |
+   |---|---|---|
+   | OpenCode Go / Ollama / Open Design | `deepseek-v4.1-flash` | 中转站的写法 |
+   | DeepSeek Official | `deepseek-flash` | 官方自己的短拼写 |
+   | **Tencent TokenHub** | **`deepseek-v4-flash-202605`** | **`-202605` 是 id 的一部分，不是日期** |
+
+   ⚠️ 最后那一行是最典型的坑：把后缀"规整"掉看起来像在清理，实际是让每条请求都被上游拒。
+
+3. **没有余额接口就写「没有」，别猜一个形状。**
+   判法用状态码，不用猜：不带 key 时，**真路由回 401**（存在、需鉴权），**假路径回 404**。
+   然后逐个探候选路径 —— 全 404 就是真的没有。此时**不声明 `balance`**，
+   面板会自动退回「测通」模式（发一次最小真实请求，成功就显示「余额未尽」）。
+   反面教材：仓里 open-design 那条曾声明过 `openai-billing` 并注释"已探过"，实际每次 404。
+
 ### 2. 修一处文案
 
 面板上的每一句都应该是一个**能在页面上验证的事实**。读到含糊、过时、或替宿主猜原因的，直接改。

package/README.md

@@ -56,7 +56,7 @@ dsh plugin --profile web add dsh-any-deepseek
 **渠道 id** 会自动填好（可以改，只是配置里的键名）。**显示名**留空的话用规格的默认名 ——
 同一家开两个号时，填上「主号」「备号」之类会好认。
 
-内置规格：DeepSeek Official、OpenCode Go、Ollama Cloud、Open Design、CommandCode
+内置规格：DeepSeek Official、OpenCode Go、Ollama Cloud、Open Design、CommandCode、Tencent TokenHub
 （这些名字与下拉框里显示的完全一致）。
 要接别家，见 [接一个新渠道](#接一个新渠道)。
 
@@ -95,6 +95,9 @@ dsh plugin --profile web add dsh-any-deepseek
 > **「余额未尽」不等于「还剩多少」。** 一次成功的请求只证明三件事：地址通、key 对、账户没因为欠费被拒
 > （欠费的账户会回 402，不会回 200）。所以这里只写「未尽」，**不会编一个金额给你**。
 
+**哪些内置规格没有余额接口？** 目前是 **Open Design** 和 **Tencent TokenHub** ——
+这两家只开推理面，所以它们永远显示「余额未尽」而不是金额。这是如实报告，不是缺陷。
+
 ### 看这个月花了多少
 
 切到 **用量** 分页。

package/lib/index.js

@@ -306,6 +306,50 @@ const CHANNEL_PRESETS = {
 		...V41_FLASH_CAPS,
 		compat: { ...DEEPSEEK_THINKING_COMPAT }
 	},
+	/**
+	* Tencent Cloud's TokenHub — a first-party forwarding endpoint for DeepSeek.
+	*
+	* Owner request (2026-10-23): 「我本机dsh还配了tokenhub这个渠道，这个渠道是腾讯云的渠道，
+	* 它的模型名称是固定的0605后缀就是向官方的转发」.
+	*
+	* 🔴 **The model id is frozen at `deepseek-v4-flash-202605` — the `-202605` suffix is part of the
+	* id, not a date we append.** This is the sharpest illustration of why presets exist: the same
+	* model is `deepseek-v4.1-flash` on the relays, `deepseek-flash` on the official API, and
+	* `deepseek-v4-flash-202605` here. Getting it wrong does not fail locally — the upstream
+	* rejects it on the first request.
+	*
+	* Endpoint and model id verified against TWO independent records in this container (the
+	* 2026-10-15 model-aggregator survey and the 2026-10-19 research note), and against the live
+	* `/v1/models` route (401 = present, auth required).
+	*/
+	"tencent-tokenhub": {
+		displayName: "Tencent TokenHub",
+		api: "openai-completions",
+		baseURL: "https://tokenhub.tencentmaas.com/v1/",
+		model: "deepseek-v4-flash-202605",
+		contextWindow: 1024e3,
+		maxTokens: 384e3,
+		input: ["text"],
+		reasoningEfforts: { ...V41_FLASH_CAPS.reasoningEfforts },
+		compat: { ...DEEPSEEK_THINKING_COMPAT },
+		/**
+		* 🔴 **No balance surface — measured by status-code discrimination, not assumed.**
+		*
+		* Without a key, the inference route answers **401** while a made-up path answers **404**,
+		* so 401 here means "route exists, auth required". Four balance candidates were then probed
+		* at the same prefix and ALL answered 404, i.e. they do not exist:
+		*   /v1/dashboard/billing/subscription   404
+		*   /v1/user/balance                     404
+		*   /v1/credits                          404
+		*
+		* ⇒ No `balance` is declared. The panel therefore reports "no balance API" and falls back to
+		* ONE minimal live request (`http.ts` `balanceRow`), showing 「余额未尽」 with the serving
+		* model and round-trip time — exactly what the owner asked for (「余额查询是没有的做成测通
+		* 查询即可」). Declaring a speculative `openai-billing` shape would have produced a 404 on
+		* every check, which is the mistake this repo already made once and recorded.
+		*/
+		note: "Tencent Cloud forwarding endpoint; model id is frozen with a -202605 suffix. Text-only, per the endpoint record. No balance API — the panel verifies liveness instead."
+	},
 	ollama: {
 		displayName: "Ollama Cloud",
 		api: "openai-completions",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-any-deepseek",
-  "version": "0.0.17",
+  "version": "0.0.18",
   "description": "One DeepSeek V4.1 Flash provider for DeepSeek Harness: paste a key per channel, switch channels manually, token usage booked per real upstream.",
   "license": "MIT",
   "repository": {