dsh-account-pool 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cliii-one
+
+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

@@ -355,8 +355,77 @@ npm run check
 - 账号池状态（冷却、熔断计数）是进程内状态，重启后重置
 - 本插件只负责「接入与调度」，不做自动签到、成长任务等上游活动
 
+## 参考与致谢
+
+本项目的上游协议细节（端点、请求头、字段名、刷新契约、解密方式）
+不是猜出来的，而是在这四个项目的实测结论基础上做的。**没有它们，
+就没有这个插件**——尤其是那些"看起来奇怪但必须这样写"的地方，
+每一处背后都有人踩过坑并记录下来。
+
+### [workbuddy2api-panel](https://github.com/linguo2625469/workbuddy2api-panel)
+
+WorkBuddy（CodeBuddy）网关面板，Go 实现。
+
+| 用到的部分 | 在哪个文件 |
+|---|---|
+| 请求头形态（`X-CodeBuddy-Request`、设备标识派生规则） | `lib/headers.js` |
+| 选号策略（三因子加权 + Top-5 抽签） | `lib/selector.js` |
+| 用量统计口径 | `lib/usage.js` |
+| 积分包解析（`CapacityRemain` / 周期包三档判定） | `lib/upstream.js` |
+
+### [dsh-connect-workbuddy](https://github.com/dingminhua/dsh-connect-workbuddy)
+
+同样把 WorkBuddy 接进 DSH 的插件，安全设计上做了正确的示范。
+
+| 用到的部分 | 在哪个文件 |
+|---|---|
+| shim 安全模型（回环绑定、随机端口、进程内 secret、Host 校验） | `lib/shim.js` |
+
+> 安全代码不做"改善"——这是它验证过的形态，照做。
+
+### [dsh-connect-trae](https://github.com/dingminhua/dsh-connect-trae)
+
+Trae 接入 DSH 的插件，带完整取证文档（`docs/` 下有实测记录）。
+
+| 用到的部分 | 在哪个文件 |
+|---|---|
+| 上游常量（host、`APP_ID`、`IDE_VERSION`） | `lib/trae-accounts.js` |
+| 刷新契约（按 region 分流的 ClientID 与端点） | `lib/trae-accounts.js` |
+| SSE 协议转换（Trae 命名事件 → OpenAI chunk） | `lib/trae-bridge.js` |
+| 目录与通道不一致的取证（`glm-5.3` 为何不可调用） | `lib/trae-upstream.js` |
+| 设备身份策略（导入时生成一次、复用而非每请求重新生成） | `lib/trae-accounts.js` |
+
+### [traework2api](https://github.com/Sliverkiss/traework2api)
+
+Trae 网关，Go 实现，登录脚本带有最完整的实测结论。
+
+| 用到的部分 | 在哪个文件 |
+|---|---|
+| 凭据解密（`storage.json` 的 AES-CBC 盐值与布局） | `lib/trae-storage.js` |
+| 签到流程与必需的 `X-Device-Id` | `lib/trae-accounts.js` |
+
+### 这些参考带来的具体判断
+
+有些"为什么不那样写"的答案来自这些项目：
+
+- **`glm-5.3` 在目录里但不能用** —— Trae 的目录（`get_detail_param`）与调用通道
+  （`llm_utils_chat`）是两个面，前者是全量、后者只服务子集
+- **Trae 必须做协议转换** —— 它的 SSE 是命名事件格式，pi-ai 只认 OpenAI 格式，
+  直通会撑到超时（表现为"很慢、几乎都失败"）
+- **签到要带 `X-Device-Id`** —— 缺了回业务码 `9004`，HTTP 却是 200
+- **周期积分包不能靠 `CapacityType` 枚举判定** —— 要用三档数据驱动，
+  否则"刚好用完"的包会算错
+
 ## 免责声明
 
-本项目仅供个人学习和研究使用，仅驱动使用者自己的 WorkBuddy 账号。
-使用者需遵守 WorkBuddy 的服务条款，因使用本项目产生的任何后果由使用者自行承担。
-本项目与腾讯、WorkBuddy、DeepSeek 均无关联。
+本项目仅供个人学习和研究使用，仅驱动使用者自己的账号。
+
+使用者需遵守所接入服务（WorkBuddy / CodeBuddy、Trae）的服务条款；
+因使用本项目产生的任何后果由使用者自行承担。
+
+本项目与腾讯、字节跳动、WorkBuddy、CodeBuddy、Trae、DeepSeek 均无关联，
+未获得上述任何一方的授权或认可。
+
+## 许可
+
+[MIT](LICENSE) © 2026 cliii-one

package/lib/index.js

@@ -299,22 +299,41 @@ async function createRegionStack({ region, dshHome, config, logger, ctx }) {
   let creditsCache = { at: 0, value: null }
 
   /** 查各账号积分（带缓存）；单个账号失败不影响其他账号。 */
+  /**
+   * 查本区域各账号的积分（带 60 秒缓存）。
+   *
+   * 账号之间**并行**查询：每个账号是一次独立的上游请求，串行会让
+   * 设置页的等待时间等于所有账号之和（实测 3 个账号串行约 1.5s）。
+   * 并行后约等于最慢的那个。
+   *
+   * 单个账号失败只丢它自己的数据，不影响其他账号。
+   */
   const loadCredits = async (force = false) => {
     const now = Date.now()
     if (!force && creditsCache.value !== null && now - creditsCache.at < 60_000) {
       return creditsCache.value
     }
-    const out = {}
-    for (const account of await store.list()) {
+    const accounts = await store.list()
+
+    /** 查一个账号的积分；失败返回 undefined 而不是抛错。 */
+    const queryOne = async (account) => {
       try {
         const credential = await store.usable(account.id)
-        out[account.id] = await fetchRegionCredits(credential)
+        const credits = await fetchRegionCredits(credential)
         // 顺手把总积分喂给选号器，让加权用上真实余额。
-        picker.setCredits(account.id, out[account.id].total)
+        picker.setCredits(account.id, credits.total)
+        return [account.id, credits]
       } catch (error) {
         logger.warn(`账号 ${account.id} 查询积分失败：${error?.message ?? error}`)
+        return undefined
       }
     }
+
+    const settled = await Promise.all(accounts.map(queryOne))
+    const out = {}
+    for (const entry of settled) {
+      if (entry !== undefined) out[entry[0]] = entry[1]
+    }
     creditsCache = { at: now, value: out }
     return out
   }
@@ -625,34 +644,41 @@ export function apply(ctx, config = {}) {
         if (!loopbackOrigin(req)) { json(res, 403, { ok: false, error: '仅允许本机访问' }); return }
         try {
           const list = await ready
-          const out = {}
-          for (const stack of list) {
+
+          /**
+           * 取一个区域的状态。
+           *
+           * 区域之间**并行**：cn 与 trae 是两套独立上游，串行会让设置页
+           * 的等待时间变成两者之和（冷缓存实测约 1.5s）；并行后约等于
+           * 最慢的那个。
+           */
+          const regionState = async (stack) => {
             const snapshot = stack.picker.snapshot()
-            out[stack.region] = {
+            const listed = await stack.store.list()
+            const credits = await stack.loadCredits()
+            return [stack.region, {
               provider: stack.providerId,
               displayName: REGION_DISPLAY_NAMES[stack.region],
               models: stack.getCatalog().length,
-              accounts: (await (async () => {
-                const listed = await stack.store.list()
-                const credits = await stack.loadCredits()
-                return listed.map(account => ({
-                  id: account.id,
-                  nickname: account.nickname,
-                  uid: account.uid,
-                  domain: account.domain,
-                  expiresAtMs: account.expiresAtMs,
-                  ...snapshot[account.id],
-                  cooling: snapshot[account.id]?.cooling ?? false,
-                  // 积分：剩余 + 总量 + 套餐明细（界面展示用）。
-                  // size 供悬停提示展示「总量 / 已用 / 剩余」构成。
-                  credits: credits[account.id]?.total,
-                  creditsSize: credits[account.id]?.size,
-                  creditPackages: credits[account.id]?.packages?.slice(0, 5) ?? [],
-                }))
-              })()),
-            }
+              accounts: listed.map(account => ({
+                id: account.id,
+                nickname: account.nickname,
+                uid: account.uid,
+                domain: account.domain,
+                expiresAtMs: account.expiresAtMs,
+                ...snapshot[account.id],
+                cooling: snapshot[account.id]?.cooling ?? false,
+                // 积分：剩余 + 总量 + 套餐明细（界面展示用）。
+                // size 供悬停提示展示「总量 / 已用 / 剩余」构成。
+                credits: credits[account.id]?.total,
+                creditsSize: credits[account.id]?.size,
+                creditPackages: credits[account.id]?.packages?.slice(0, 5) ?? [],
+              })),
+            }]
           }
-          json(res, 200, { ok: true, regions: out })
+
+          const settled = await Promise.all(list.map(regionState))
+          json(res, 200, { ok: true, regions: Object.fromEntries(settled) })
         } catch (error) {
           json(res, 500, { ok: false, error: safeMessage(error) })
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-account-pool",
   "displayName": "Account Pool",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "把多个 WorkBuddy / Trae 账号汇成账号池接入 DeepSeek Harness：自动切换、限流熔断退避、凭证安全落盘",
   "type": "module",
   "license": "MIT",
@@ -26,7 +26,8 @@
   "files": [
     "lib",
     "cordis.patch.yml",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "engines": {
     "node": "^22.19.0 || >=24.0.0"