dsh-wtq-pool 1.3.1 → 1.3.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -10,7 +10,7 @@
10
10
 
11
11
  <p align="center"><sub>DeepSeek Harness 版 · <a href="https://github.com/chengzhi-c/pi-desktop-wtq-pool">PI-Desktop 版</a></sub></p>
12
12
 
13
- <p align="center"><b>把本机已登录的 WorkBuddy、Trae、Qoder 账号接入 DeepSeek Harness,限流或额度用尽时自动换号。</b></p>
13
+ <p align="center"><b>在 DeepSeek Harness 中使用本机 WorkBuddy、Trae 和 Qoder 登录,按账号状态自动换号。</b></p>
14
14
 
15
15
  <p align="center">
16
16
  <a href="README.en.md">English</a> | <b>简体中文</b>
@@ -27,207 +27,139 @@
27
27
 
28
28
  <p align="center">
29
29
  <a href="https://www.npmjs.com/package/dsh-wtq-pool"><img src="https://img.shields.io/npm/v/dsh-wtq-pool?style=flat-square&amp;label=npm&amp;color=cb3837" alt="npm version"></a>
30
- <a href="https://www.npmjs.com/package/dsh-wtq-pool"><img src="https://img.shields.io/npm/d18m/dsh-wtq-pool?style=flat-square&amp;label=downloads&amp;color=cb3837" alt="npm downloads"></a>
31
30
  <a href="LICENSE"><img src="https://img.shields.io/github/license/chengzhi-c/dsh-wtq-pool?style=flat-square" alt="MIT license"></a>
32
- <a href="https://github.com/chengzhi-c/dsh-wtq-pool/releases"><img src="https://img.shields.io/github/v/release/chengzhi-c/dsh-wtq-pool?style=flat-square&amp;label=release" alt="release"></a>
33
- <a href="https://github.com/chengzhi-c/dsh-wtq-pool/stargazers"><img src="https://img.shields.io/github/stars/chengzhi-c/dsh-wtq-pool?style=flat-square" alt="GitHub stars"></a>
34
31
  </p>
35
32
 
36
- > 本项目仅供学习使用。使用非官方客户端可能触发厂商的账号风控或限制。请评估相关风险,并遵守对应服务的使用条款。
33
+ > 本项目仅供学习使用。非官方客户端可能触发厂商的账号风控或限制。使用前请评估风险并遵守对应服务条款。
37
34
 
38
- 把本机 WorkBuddy、Trae、Qoder 的桌面登录接入 DeepSeek Harness。WorkBuddy 在账号被限流或额度用尽时自动换号;Trae、Qoder 按请求选择账号,认证失败、限流或余额耗尽时改用下一个登录重试,模型不在目录里、请求体不是合法 JSON 或缺 model 这类请求自身的问题,网关在本地直接返回 404 或 400,不占用账号。三个来源各自开关,国内与国际账号分别成组。
35
+ 各厂商和区域分别注册模型组。账号遇到限流、额度耗尽或登录失效时,按对应策略切换账号。
39
36
 
40
- Trae 的登录失效有时不带错误码、只给一句说明。插件按已知的英文措辞识别这种帧并换号;其余措辞按上游故障返回 502。
41
-
42
- 限流按上游给出的等待时间冷却,上游未给出时按配置的窗口。上游 5xx 改用下一个登录。额度用尽与登录失效不会自行恢复,账号退出轮换:额度用尽的挂起在重新读到有余额后释放,登录失效的挂起在刷新成功、重新登录或手动重置冷却后释放,两者都以六小时为上限(WorkBuddy 侧)。积分、签到状态、模型目录与手动签到这些非流式请求遇到登录失效,会先强制刷新令牌并重试一次:刷新令牌还有效的账号当场恢复,不退出轮换;刷新令牌同样失效的才挂起。Trae、Qoder 的失败挂起另计:只按冷却窗口(默认 60 秒,最长可配到 24 小时)或上游给出的等待时间降权,池中只剩它一个时仍会使用。上游主机不可达时跳过该账号并尝试下一个;连续两个账号都不可达后,只要还有登录属于尚未失败的网关就继续尝试,所有网关都失败才结束本轮并报告网络错误。上游判定账号套餐不含某模型(11158)时,该账号的这个模型停用 24 小时,其他模型照常服务;全部账号都不含该模型时按 400 返回。
43
-
44
- ## 预览
45
-
46
- 面板界面如下,默认亮色:
47
-
48
- ![账号池](https://github.com/chengzhi-c/dsh-wtq-pool/raw/main/docs/preview-pool.png)
49
-
50
- 面板在载入时读取宿主的 `app.getAppearance()`,配色与语言随之确定。宿主切换主题后,按卡片上的「重新载入面板」重新取一次:
51
-
52
- ![暗色主题](https://github.com/chengzhi-c/dsh-wtq-pool/raw/main/docs/preview-dark.png)
53
-
54
- 模型页编辑每个模型的显示与发布参数。Trae 目录给出的默认窗口因模型而异(116k 至 400k);未声明更大档位的模型,按 1M 发布上限。Trae 目录给出费率的模型带 `x0.79` 形式的费率标签;目录未给出费率的模型以及全部 Qoder 模型均不标注:
55
-
56
- ![模型设置](https://github.com/chengzhi-c/dsh-wtq-pool/raw/main/docs/preview-models.png)
57
-
58
- 成长中心:
59
-
60
- ![成长中心](https://github.com/chengzhi-c/dsh-wtq-pool/raw/main/docs/preview-growth.png)
61
-
62
- 在线预览:<https://chengzhi-c.github.io/dsh-wtq-pool/>。
63
-
64
- `docs/index.html` 以虚构演示数据加载实际面板代码,支持来源切换、模型设置与主题预览。
65
-
66
- ![预览页](https://github.com/chengzhi-c/dsh-wtq-pool/raw/main/docs/preview-page.png)
37
+ ## 安装
67
38
 
68
- 本地预览需先克隆仓库,运行 `node docs/serve.cjs`,再打开它输出的地址。该页面不能用 `file://` 打开,因为浏览器不允许它读取同目录下的面板文件。
39
+ 支持 DeepSeek Harness `0.2.0` 与 `0.2.2` 系列(含 `engines.dsh` 允许的预发布版本),要求 Node `^22.19.0 || >=24.0.0`,并满足宿主的 Node 版本要求。
69
40
 
70
- ## 功能
41
+ ### 桌面版
71
42
 
72
- - 复用本机登录:读取三家桌面 App 已保存的登录文件。WorkBuddy 另支持在面板「添加账号」,通过官方登录页授权后将登录保存到插件自管目录。
73
- - 按 region 注册模型分组:三家厂商各自的 region 各注册为一个 provider,可同时启用;没有账号的 region 不注册。国内模型只走国内账号,国际版模型只走国际账号。
74
- - 账号分发:WorkBuddy 支持先用一个账号、轮流使用、临期积分优先和同一对话固定一个账号,并在限流、额度用尽或上游 5xx 时自动换号;Trae、Qoder 支持优先使用、轮流使用与临期积分优先,认证失败、限流或余额耗尽时改用下一个登录重试。
75
- - 网关以 SSE 返回 `chat.completion.chunk`;请求体里的 `stream` 字段不改变响应格式。
76
- - 积分自动化:自动签到默认关闭。开启后的定时任务与「立即运行」执行同一轮,包含三家签到、WorkBuddy 的连登奖励和猫猫旅行。连登天数由上游按对话推进,该轮在每个账号读取连登档位前先补发一次对话活动上报,因此档位到点即可解锁领取。连登环节还会在昨日漏签且持有补签卡时自动补签以保住连续天数,领取一次性的新手礼包与活动补偿,并在兑换解锁的档位后把由此获得的抽奖次数抽完。这些成长步骤国内版与国际版都执行;猫猫旅行仅用于国内账号。
77
- - 登录令牌保活:独立卡片,按需执行。桌面端留下的登录快照在扫描时并入插件自己的登录目录,由插件接管续期;桌面端正在使用的登录由桌面端续期。「立即刷新」处理插件自管的副本,按签发时间判断:签发满 6 小时的刷新,距到期不足 5 分钟的同样刷新。刷新结果写回插件自己的登录文件,登录被上游拒绝时当天即可发现。同一账号在多处留有登录时按签发时间取最新的一份。停用账号、已停用的 region 与登录已被上游拒绝的账号不参与。
78
- - 输入框积分:开启 `showComposerPoints` 后,输入框工具栏显示当前模型所用账号的余额,点开可换号。国内版与国际版各自发布所在网关的模型目录,分别列为 `WTQ Pool (CN)` 与 `WTQ Pool (Global)` 两个提供商;积分浮层按当前选中的提供商确认归属,只跟随本插件的模型。轮流使用与同一对话固定账号时,浮层显示下一个或最近一次服务该模型的账号。功能关闭后浮层隐藏,读数降为每 5 分钟一次,重新开启后无需切换模型即可恢复。
79
- - 面板:账号与池状态、模型勾选、连接检查、成长中心都在插件页的「账号池(dsh-wtq-pool)」卡片内。模型目录在启动时加载,缓存过期后按需刷新,空闲时不轮询。停用的账号与登录已被上游拒绝的账号不参与探测。
80
- - 连接检查:每条发现都带判定。网关没有监听、模型目录读取失败、发布的地址与实际绑定的不一致、provider 未被宿主接受,都算失败并给出需要修改的内容。网关启动失败时给出原因,面板按地址漂移提示重新加载插件。检查自身出错也记一条发现,报告照常给出其余结果。
43
+ 在 DeepSeek Harness「插件」页选择「添加插件」→「安装第三方插件」,输入 `dsh-wtq-pool` 并安装,然后启用插件。
81
44
 
82
- ## 安装
45
+ ### 命令行
83
46
 
84
- 本地包:在源码目录依次执行:
47
+ 需要已安装 DSH CLI(`@deepseek-ai/dsh`)。CLI 只管理 `web`、`tui` 等非桌面 profile;`desktop` profile 由桌面应用独占,请在应用内安装。
85
48
 
86
49
  ```powershell
87
- pnpm install
88
- pnpm run build
89
- New-Item -ItemType Directory -Force dist | Out-Null
90
- npm pack --pack-destination dist
50
+ dsh plugin --profile web add dsh-wtq-pool
91
51
  ```
92
52
 
93
- 再安装生成的 `.tgz`:
53
+ `web` 是 profile 名,按实际使用的 profile 替换。安装后在「插件」页打开 WTQ Pool。从 1.1.x 升级到 1.2.0 后,提供商 ID 改为 `wtqpool-*`,请重新选择模型。
94
54
 
95
- ```powershell
96
- $package = (Get-ChildItem .\dist\*.tgz | Sort-Object LastWriteTime | Select-Object -Last 1).FullName
97
- dsh plugin --profile desktop add $package
98
- ```
55
+ ## 使用
99
56
 
100
- 需要 DeepSeek Harness 0.2.0 与 0.2.2 两条预发布线(`package.json` 的 `engines.dsh`:`>=0.2.0-rc.1 <0.2.1-0 || >=0.2.2-rc.1 <0.2.3-0`)与 Node `^22.19.0 || >=24.0.0`。npm 的 `latest` 目前指向 `0.2.2-rc.1`,该宿主要求 Node `>=24.9.0`;插件自身的 Node 要求 `^22.19.0 || >=24.0.0` 同样适用。0.2.2 稳定版尚未发布,发布后上述版本范围会覆盖它。
57
+ 在 WorkBuddy、Trae 或 Qoder 桌面应用登录后,点击「重新检测账号」。WorkBuddy 支持多个登录;国内 Trae 分别读取 Trae CN 与 TRAE SOLO CN。每个 Qoder 安装及 WorkBuddy 国际版各保留一个登录,切换时替换原登录。
101
58
 
102
- > 从 1.1.x 升级到 1.2.0 后,模型提供商 ID 改为 `wtqpool-*`,请在模型选择里重新选一次。
59
+ WorkBuddy 5.6 起的 `$wbEncrypted` 登录需要本机 WorkBuddy 的解密密钥。Windows 只使用固定本地磁盘上签名有效且公钥受支持的安装,管理员进程跳过解密;macOS 会运行本机应用读取密钥,不校验签名,macOS 和 Linux 的 root 进程跳过解密。请使用可信的 WorkBuddy 安装。
103
60
 
104
- 请将 `desktop` 替换为实际使用的 profile 名。若 `dsh` 不在 `PATH` 中,改用安装目录中的 CLI。也可按 npm 包名 `dsh-wtq-pool` 或仓库地址安装;仓库地址安装直接使用已提交的 `lib/`。
61
+ ### 添加账号
105
62
 
106
- **面板位置**:在侧边栏进入 **插件**,打开 **dsh-wtq-pool** 卡片(或其旁的 **配置**),完整面板嵌在该卡片内。模型分组未出现时,按面板顶部的提示重新加载插件。
63
+ 在面板通过官方登录页添加,或导入含 `{auth, account}` 的 `.info` 文件。从源码仓库运行:
107
64
 
108
- ## 使用
65
+ ```powershell
66
+ $dshHome = if ($env:DSH_HOME) { $env:DSH_HOME } else { Join-Path $HOME ".dsh" }
67
+ $pluginData = Join-Path $dshHome "dsh-wtq-pool"
68
+ $accountFile = Read-Host "账号文件路径"
69
+ node .\tools\import-signins.cjs --data $pluginData --from $accountFile
70
+ ```
109
71
 
110
- 在各家桌面 App 中登录,再点面板的「重新检测账号」。WorkBuddy 支持读取多个已保存的登录,需要多个账号就在 App 里逐个登录;5.6 起的 `$wbEncrypted` 登录由插件向本机已安装的 WorkBuddy 索取密钥后读取。Trae 国内版有 Trae CN 与 TRAE SOLO CN 两个登录位;Qoder 每个安装只保存一个登录,在 App 里重新登录会覆盖前一个。WorkBuddy 国际版只有一个登录文件,切换账号会直接覆盖上一个。插件在扫描时为被覆盖的登录留档,该账号照常参与分发,直到它的令牌到期;在 App 里重新登录即可续期。
72
+ 可选参数:`--region cn|global|all`、`--dry-run`、`--force`。
111
73
 
112
- Windows 下解密登录时,插件只使用固定本地磁盘上签名有效且签名公钥受支持的 WorkBuddy。宿主以管理员权限运行时,以及 macOS 或 Linux 下以 root 运行时,不解密这类登录。若 WorkBuddy 更换签名公钥,需更新插件后才能解密。macOS 下插件直接执行本机安装的 WorkBuddy 应用进程读取密钥,不校验其签名;只应执行你信任的安装。
74
+ `signins/` 含可用的访问令牌和刷新令牌,应按账号密码保护。自管登录可二次确认删除;桌面应用当前使用的登录不能从面板删除。
113
75
 
114
- 没有桌面 App 也可以添加账号:面板 WorkBuddy 标题栏的「添加账号」在新标签页中打开官方登录页,登录完成后该账号即加入账号池。凭证写在插件自管目录的 `signins/` 下,与桌面登录同等参与分发。这类账号在面板上另有「删除」,按两次确认;删除范围见「数据」一节。桌面端正在登录的账号不给删除,那份会话属于桌面端。添加的账号属于当前选中的 region,国内版登国内号,国际版登国际号。
76
+ ### 面板
115
77
 
116
- 迁移其他工具留下的账号,直接向该目录写入文件即可:`signins/` 本身就是导入导出格式,放入一份以 `.info` 结尾的 `{auth, account}` 登录文件,下次扫描即作为一个普通账号。仓库中的 `tools/import-signins.cjs` 读取其他工具留下的账号文件(`--from` 接受文件或目录),按本插件识别的形状写入 `signins/`,默认跳过本插件数据目录里已有的账号,`--dry-run` 先查看,`--force` 才覆盖。该脚本不随 `.tgz` 分发,需要克隆仓库并安装开发依赖后运行:
78
+ 「账号池」管理登录和账号状态;「模型」页设置模型组及显示选项;连接检查报告网关、模型目录、注册地址和宿主注册状态;成长中心领取 WorkBuddy 奖励。
117
79
 
118
- ```
119
- node tools/import-signins.cjs --data <插件数据目录> --from <账号文件或目录> [--region cn|global|all] [--dry-run] [--force]
120
- ```
80
+ 自动签到默认关闭,默认北京时间 09:00,可在面板调整;签到和手动「立即执行」可能消耗补签卡或抽奖次数。国内 Trae 每台设备每天可签到一次,Qoder 通常在北京时间 10:00 开放。
121
81
 
122
- 备份即复制 `signins/` 目录;这些文件持有完整可用的令牌,其权能与账号本身相同。
82
+ 「立即刷新」只续期签发满六小时或五分钟内到期的插件自管登录;桌面应用登录由应用续期。
123
83
 
124
- - **账号池**:每个账号的标签、剩余积分、额度到期时间、冷却状态与签到进度。可单独停用某个账号、将其移除,或指定某个 region 优先使用哪个账号。登录被上游拒绝的账号另显示「需重新登录」徽标、拒绝原因与「暂停至」时间,挂起期间积分与签到留空。被上游判定异常使用的账号另显示「已限制」徽标与「被上游限制,直至」时间,六小时重试一次,需要到官方后台申诉。Trae、Qoder 两个账号重名时,名称后带 `#` 与用户 ID 后 8 位,用于区分。
125
- - **模型**:勾选该 region 要暴露的模型,未勾选的模型不进入模型选择器。可修改显示名、上下文窗口、输出上限、思考等级与贴图支持。一个模型组最多发布 64 个模型,超出部分标记为「未发布」,网关仍会服务它们。
126
- - **连接检查**:逐条报告网关是否监听、模型目录读到几个、注册的地址与实际绑定的是否一致、每个 provider 是否被宿主接受,并可复制整份报告。
127
- - **成长中心**:仅对 WorkBuddy 生效。页面按账号逐行列出,展开一行可见该账号的连登档位。「读取状态」读取当前档位与可领取项;「立即执行」产生领取并执行成长环节,按步骤报告结果。登录被上游拒绝的账号在该轮被跳过。
84
+ ## 功能
128
85
 
129
- 签到可对单个账号执行,也可在标题栏一次领完该来源。自动签到默认关闭,开启后默认于 09:00(北京时间)执行;当天错过的时段在当天内的下一次启动仍会补领,跨天则不补。Trae 的每日签到每台设备限领一次;Qoder 的活动开放时间以活动列表返回的 `startAt` 为准,常见为每天 10:00(北京时间)。是否显示签到取决于上游对该账号返回的活动状态。登录被上游拒绝的账号在该轮被跳过。
86
+ - 分发:按优先级、轮询或临期积分;WorkBuddy 另支持同一对话固定账号。
87
+ - 输入框积分:显示当前账号积分并可切换账号;关闭时每五分钟读取余额。
88
+ - 每个模型组最多发布 64 个模型;网关使用 SSE 流式响应,模型目录按需刷新。
130
89
 
131
- WorkBuddy 国内版上游会检查 system 与助手轮次里的措辞,命中属于它不服务的客户端的措辞时返回 11128(渠道校验未通过)。插件收到这条拒绝后重试一次:系统消息并入首条用户消息,`developer` 角色并入 system,助手历史里的客户端名称替换为 `DeepSeek`,请求仍保留一条中性系统消息。通过的提示按 region 缓存,同一段提示之后不再重复这次往返。签到、成长中心与保活走各自的接口。
90
+ ### 换号与恢复
132
91
 
133
- 「立即刷新」的结果按刷新、已是最新、失败、无刷新令牌分项报告。
92
+ | 情况 | 处理方式 |
93
+ | --- | --- |
94
+ | 请求无效,或 Trae、Qoder 模型不在目录 | 返回 400 或 404,不发送对话请求 |
95
+ | WorkBuddy 限流、5xx 或主机不可达 | 尝试下一个账号;限流按上游等待时间或冷却处理 |
96
+ | WorkBuddy 额度耗尽 | 最长暂停六小时;读到正余额或手动清除冷却后恢复 |
97
+ | WorkBuddy 登录失效 | 最长暂停六小时;成功刷新令牌、重新登录或手动清除冷却后恢复 |
98
+ | WorkBuddy 套餐不支持模型(11158) | 该账号对此模型暂停 24 小时;全部账号均不支持时返回 400 |
99
+ | Trae、Qoder 登录失效、限流、额度耗尽或空响应 | 尝试下一个登录,并按冷却降低优先级;仅剩一个登录时仍会使用 |
100
+ | Trae、Qoder 上游 5xx | 返回上游错误 |
134
101
 
135
- 读取结果留在宿主进程内:重新载入面板仍显示上次的数字。读数超过两分钟、之后又跑过一轮,或某个 region 被停用时,进入页签会重读。
102
+ Trae、Qoder 冷却默认 60 秒,最长 24 小时。WorkBuddy 登录失效时刷新令牌并重试一次;国内版 11128 渠道校验错误仅重试一次,不暂停账号。
136
103
 
137
104
  ## 设置
138
105
 
139
- 以下键在插件页或 DSH 的设置页修改,保存后生效:
140
-
141
- | 键 | 默认(生效值) | 说明 |
142
- | --- | --- | --- |
143
- | `enabled` | `true` | 关闭后网关不启动 |
144
- | `sourceWorkbuddy` / `sourceTrae` / `sourceQoder` | `true` | 关闭后该来源不扫描、不发布、不请求 |
145
- | `distribution` | `priority` | WorkBuddy 池的发放方式:`priority` 先用一个账号,`round-robin` 均摊,`expiry` 优先消耗临期积分,`sticky` 同一对话固定 |
146
- | `sourceDistributions` | `{}` | Trae、Qoder 的分发方式:`priority` / `round-robin` / `expiry`;未设时按 `priority` |
147
- | `cooldownSeconds` | `60` | 限流冷却时长。上游报出重置时间时以它为准;没有重置时间时,连续限流会让它逐次翻倍,封顶 15 分钟(窗口本身超过 15 分钟时不再翻倍)。上游给出的重置时间最长按 2 小时计;余额耗尽或登录被上游拒绝另按 6 小时停用,额度耗尽的挂起在读到有余额时提前解除 |
148
- | `creditReserves` | `{}` | 按账号 id 设定的积分保底,余额不高于它的账号不参与分发 |
149
- | `authFile` | `""` | WorkBuddy 登录文件路径;扫描其所在目录的全部 `.info` 登录,留空则自动发现 |
150
- | `autoCheckin` | `{"enabled":false,"hours":[9]}` | 自动签到的开关与时点;`hours` 为北京时间整点,留空用 09:00 |
151
- | `showComposerPoints` | `false` | 在输入框工具栏显示当前账号积分 |
152
- | `disabledAccountIds` | `[]` | 面板中停用的账号 id |
153
- | `disabledRegions` | `[]` | 单独停用的 region,形如 `source:region` |
154
- | `modelSelection` | `{}` | 每个网关勾选哪些模型,以及显示名、上下文窗口等覆写 |
155
- | `preferredAccountIds` | `{}` | WorkBuddy 每个 region 的首选账号 |
156
- | `preferredSourceAccounts` | `{}` | Trae、Qoder 每个 region 的首选账号,键为 `source:region` |
157
- | `removedAccounts` | `[]` | 从池中移除的账号,标签与 region 一并保留,面板可据此提供恢复 |
158
-
159
- 默认列为生效值:`autoCheckin.hours` 存为空数组,运行时归一为 `[9]`;`authFile` 未设或留空即自动发现。
160
-
161
- 模型勾选与首选账号由面板保存。
106
+ 插件页或 DSH 设置页可修改来源开关、WorkBuddy 分发方式、限流冷却、自动签到和输入框积分显示。完整定义与默认值见 [设置源码](https://github.com/chengzhi-c/dsh-wtq-pool/blob/main/src/index.ts)。
162
107
 
163
108
  ## 端口
164
109
 
165
- ```
166
- WorkBuddy 42831 / 42841
167
- Trae 42851 / 42861
168
- Qoder 42871 / 42881
169
- ```
170
-
171
- 以上为首选端口。端口被占用时网关绑定系统分配的临时端口,运行时注册的 provider 使用本次实际地址,面板显示回退结果。
172
-
173
- PI-Desktop 版使用 41831 开头的独立端口,两版可以同时安装,设置和凭证分别保存,不会自动同步。若两版使用同一份 WorkBuddy 登录,上游轮换刷新令牌时可能使另一版的登录失效。出现「需重新登录」时,在对应版本重新添加账号,不要复制旧的 `signins/` 文件覆盖;两版显示的令牌到期时间可能不同。
110
+ | 来源 | 国内 | 国际 |
111
+ | --- | ---: | ---: |
112
+ | WorkBuddy | `42831` | `42841` |
113
+ | Trae | `42851` | `42861` |
114
+ | Qoder | `42871` | `42881` |
174
115
 
175
- 端口在预留与监听之间被其他进程占用时,该网关本次启动失败:其模型组被摘掉,连接检查报出失败原因,面板提示重新加载插件。重新加载后宿主重新读取声明,请求才会落到新地址。
116
+ 端口被占用时网关使用临时端口,运行时注册的模型组和面板会显示实际地址;端口在预留后、监听前被抢占时,本次不发布该模型组。PI-Desktop 版使用 `41831` 起始的独立端口范围;两版设置和凭证分开,共用 WorkBuddy 登录时刷新令牌轮换可能使另一版失效。
176
117
 
177
- ## 数据与出网
118
+ ## 隐私与数据
178
119
 
179
- 读取三家 App 的本机登录文件。provider 通过运行时注册接入,插件设置由宿主持久化至 profile。令牌由插件保管,只发往对应厂商的接口。网关监听 `127.0.0.1`,同机其他进程可调用并消耗账号额度;面板只接受本机回环请求。插件按单用户桌面环境设计,不区分本机其他系统用户;多人共用的机器应使用独立系统账户隔离。
120
+ 插件将对话内容发送给所选厂商,不保存本地会话历史。请求同时携带所选厂商的账号与设备标识(账号 UID、机器码、设备 ID),与厂商桌面客户端一致。macOS 读取 Qoder 登录时会访问登录钥匙串,系统可能请求授权。
180
121
 
181
- 插件自管数据目录 `~/.dsh/dsh-wtq-pool/`(设置了 `DSH_HOME` 时为 `$DSH_HOME/dsh-wtq-pool/`)包含四个文件(写归档或删除记录时会短暂出现对应的 `.lock` 文件;写入归档、删除记录或登录文件中断时可能留下临时文件:再次写入同一文件时会清理超过十分钟的残留,登录临时文件由扫描按同一时限清理;删除账号会连同该账号的临时文件一并清除)。`checkin-slots.json` 记录已领取的签到时段和待重试的 Qoder 时点,时段只保留三天。`doctor.txt` 是最近一次连接检查的报告,逐项记录通过与否,不列账号标签。`credentials-archive.json` 留存被切号覆盖的登录,含访问令牌、刷新令牌、账号标识(昵称、uin/uid、企业 ID)与本机登录文件路径;按令牌到期时间保留,到期后再过 30 天清除,没有到期时间的记录保留到该账号被删除。`deleted-signins.json` 记录已删除的登录,只存令牌摘要、该登录的签发时间、删除时间与一个随机记录标识,用来阻止扫描把桌面端遗留的同一份快照重新接管回来;桌面端重新登录该账号后(令牌不同且签发时间更新),下一次扫描会清除该记录;同一账号的多条删除记录若无法按签发时间排序,会一并保留,避免较早的删除覆盖较新的记录;1.2.3 写入的旧记录只按令牌摘要匹配,不会自动清除。上述文件未额外加密,访问权限由操作系统文件 ACL 决定;在 Windows 上数据目录会继承父目录的权限,请把它放在仅当前用户可写的位置。
122
+ 网关仅监听 `127.0.0.1`,但同机进程和系统用户仍可调用并消耗账号额度。登录文件和令牌归档未额外加密,依赖系统文件权限保护;Windows 下请限制插件数据目录 ACL。
182
123
 
183
- 插件写入的登录都在同目录的 `signins/`:面板添加的、接管桌面端快照的、续期后的副本。文件名带账号的计费身份,与桌面登录同等参与分发。这些文件同样未额外加密,访问权限由操作系统文件 ACL 决定。在面板中「删除」该账号会连同 `credentials-archive.json` 里的留档一起清除,桌面端遗留的同一份快照随之失效;重新登录该账号即解除。「移除」只是停用,可在「已移除的账号」中恢复。
124
+ 数据目录为 `~/.dsh/dsh-wtq-pool/`,或 `$DSH_HOME/dsh-wtq-pool/`(设置了 `DSH_HOME` 时)。`signins/` 与 `credentials-archive.json` 含可用登录令牌,登录文件名可能含账号计费身份;归档在访问或刷新令牌中较晚的到期时间后保留 30 天,未记录到期时间的归档在删除账号时清除。
184
125
 
185
- 插件只向三家厂商的接口发起请求;面板外链仅在用户点击时打开。登录页地址只接受厂商自己的域名。
186
-
187
- 令牌只会发往以下主机:
126
+ 面板「删除」会清除自管登录及归档,并阻止旧桌面快照重新加入;「移除」只将账号排除出分发。外链需点击后打开,登录页和令牌请求仅使用以下厂商主机:
188
127
 
189
128
  - WorkBuddy:`copilot.tencent.com`、`www.codebuddy.cn`、`www.codebuddy.ai`、`www.workbuddy.ai`
190
129
  - Trae:`api.trae.cn`、`solo.trae.cn`、`trae-api-cn.mchost.guru`、`coresg-normal.trae.ai`、`growsg-normal.trae.ai`
191
130
  - Qoder:`gateway.qoder.com.cn`、`openapi.qoder.com.cn`、`api3.qoder.sh`、`openapi.qoder.sh`
192
131
 
132
+ ## 预览
133
+
134
+ ![账号池](https://github.com/chengzhi-c/dsh-wtq-pool/raw/main/docs/preview-pool.png)
135
+
136
+ [在线预览](https://chengzhi-c.github.io/dsh-wtq-pool/) 使用实际面板代码和演示数据。
137
+
193
138
  ## 开发
194
139
 
195
140
  ```sh
196
141
  pnpm install
197
- pnpm run build # 产出 lib/(宿主半为 ESM,客户端半为 CJS)
198
- pnpm run typecheck # 入口、面板与客户端(src/host.ts 不在检查范围内)
142
+ pnpm run build
143
+ pnpm run typecheck
199
144
  pnpm run typecheck:client
200
- pnpm test # Node 自带测试,离线回归
145
+ pnpm test
201
146
  ```
202
147
 
203
- `src/host.ts` 是引擎(账号发现、池、网关、面板通道),`src/index.ts` 是 Cordis 入口(设置 schema、provider 注册、面板路由),`src/pi-compat.ts` 把宿主能力适配成引擎使用的调用形式。`renderer/` 是面板本体(`index.html`、`panel.js`、`panel.css`),原生 JS,无构建步骤,由 `src/web-panel.ts` 挂载到宿主的 web 服务上,以同源 iframe 提供给插件页卡片;`src/client/` 是 React 半:嵌入该 iframe 的插件页卡片(`index.tsx`)、其地址构造(`panel-url.ts`)与输入框工具栏读数(`composer.tsx`)。`lib/` 由 `tsdown` 产出,`package.json` 的 `files` 与版本库都包含它,修改 `src/` 后须重建并提交。
204
-
205
- 与宿主无关的核心模块:
206
-
207
- | 模块 | 职责 |
208
- | --- | --- |
209
- | `loopback.ts` | 回环端点的安全模型(Host 与 Origin 校验)、响应写入、流式中继与报错脱敏 |
210
- | `accounts.ts` | WorkBuddy 登录文件解析、账号池与冷却 |
211
- | `upstream.ts` | WorkBuddy 上游客户端、错误分类、限流重置解析 |
212
- | `catalog.ts` | 模型目录与静态兜底列表 |
213
- | `shim.ts` | WorkBuddy 网关的 OpenAI 兼容端点 |
214
- | `at-rest.ts` | 5.6+ 密封登录字段的解封 |
215
- | `promo.ts` | 促销窗口判定 |
216
- | `trae-*.ts` / `qoder-*.ts` | 两家的登录发现、协议客户端、SSE 解码与网关 |
148
+ `src/` 保存插件逻辑,`renderer/` 保存原生 JavaScript 面板,`lib/` 为 `tsdown` 生成的发布代码。修改 `src/` 后重建 `lib/`。`typecheck` 不覆盖 `src/host.ts`;`typecheck:client` 检查客户端代码。测试使用 Node 内置测试运行器,离线执行。
217
149
 
218
150
  ## 致谢
219
151
 
220
- 本插件的若干模块移植或参考自下列 MIT 项目:
152
+ | 项目 | 参考内容 |
153
+ | --- | --- |
154
+ | [XDTrees/dsh-xdpool](https://github.com/XDTrees/dsh-xdpool) | WorkBuddy 账号池及移植基础 |
155
+ | [corrinehu/dsh-workbuddy-connect](https://github.com/corrinehu/dsh-workbuddy-connect) | 回环端点安全模型 |
156
+ | [dingminhua/dsh-connect-workbuddy](https://github.com/dingminhua/dsh-connect-workbuddy) | WorkBuddy 接口与错误分类 |
157
+ | [dingminhua/dsh-connect-trae](https://github.com/dingminhua/dsh-connect-trae) | Trae 协议 |
158
+ | [eghrhegpe/dsh-connect-qoder](https://github.com/eghrhegpe/dsh-connect-qoder) | Qoder 协议 |
159
+ | [ardeyouxipianyi/workbuddy2api-hub](https://github.com/ardeyouxipianyi/workbuddy2api-hub) | 成长中心、多账号凭证留存与国际版活跃上报 |
221
160
 
222
- | 项目 | 版权 | 用于 |
223
- | --- | --- | --- |
224
- | [XDTrees/dsh-workbuddy-xdpool](https://github.com/XDTrees/dsh-workbuddy-xdpool) | (c) 2026 XDTrees | WorkBuddy 账号池与整体移植来源 |
225
- | [corrinehu/dsh-workbuddy-connect](https://github.com/corrinehu/dsh-workbuddy-connect) | (c) 2026 Corrine Hu | 回环端点的安全模型 |
226
- | [dingminhua/dsh-connect-workbuddy](https://github.com/dingminhua/dsh-connect-workbuddy) | (c) 2026 LaoDing | 上游接口与错误分类 |
227
- | [dingminhua/dsh-connect-trae](https://github.com/dingminhua/dsh-connect-trae) | (c) 2026 dingminhua | Trae 协议参考 |
228
- | [eghrhegpe/dsh-connect-qoder](https://github.com/eghrhegpe/dsh-connect-qoder) | (c) 2026 eghrhegpe | Qoder 协议参考 |
229
- | [ardeyouxipianyi/workbuddy2api-hub](https://github.com/ardeyouxipianyi/workbuddy2api-hub) | (c) 2026 ardeyouxipianyi | 成长中心与连登闭环(补签卡、礼包、补偿、抽奖)、多账号凭证留存、国际版活跃上报 |
161
+ 随包分发的移植代码版权与许可见 [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md)。其他项目仅列为参考。
230
162
 
231
163
  ## 许可
232
164
 
233
- MIT,见 [LICENSE](./LICENSE)。
165
+ 本项目采用 MIT 许可,见 [LICENSE](./LICENSE)。随包分发的第三方代码许可见 [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md)。
@@ -0,0 +1,47 @@
1
+ # Third-party notices
2
+
3
+ This plugin includes code ported from or adapted from the following MIT-licensed projects:
4
+
5
+ - XDTrees, `dsh-workbuddy-xdpool` (canonical repository: [XDTrees/dsh-xdpool](https://github.com/XDTrees/dsh-xdpool))
6
+ - Corrine Hu, `dsh-workbuddy-connect`, copyright notice preserved in the MIT license of [eric8bit/pi-desktop-workbuddy](https://github.com/eric8bit/pi-desktop-workbuddy)
7
+ - LaoDing, `dsh-connect-workbuddy`
8
+ - LaoDing, `dsh-connect-trae`
9
+ - eghrhegpe, `dsh-connect-qoder`
10
+
11
+ The MIT license notices for the ported code are reproduced below.
12
+
13
+ ## WorkBuddy account-pool and connection code
14
+
15
+ Copyright (c) 2026 XDTrees (dsh-workbuddy-xdpool)
16
+
17
+ Portions Copyright (c) 2026 Corrine Hu (dsh-workbuddy-connect)
18
+
19
+ Portions Copyright (c) 2026 LaoDing (dsh-connect-workbuddy)
20
+
21
+ ## Trae protocol code
22
+
23
+ Copyright (c) 2026 LaoDing (dsh-connect-trae)
24
+
25
+ ## Qoder protocol code
26
+
27
+ Copyright (c) 2026 eghrhegpe (dsh-connect-qoder)
28
+
29
+ ## MIT License
30
+
31
+ Permission is hereby granted, free of charge, to any person obtaining a copy
32
+ of this software and associated documentation files (the "Software"), to deal
33
+ in the Software without restriction, including without limitation the rights
34
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
35
+ copies of the Software, and to permit persons to whom the Software is
36
+ furnished to do so, subject to the following conditions:
37
+
38
+ The above copyright notice and this permission notice shall be included in all
39
+ copies or substantial portions of the Software.
40
+
41
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
42
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
43
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
44
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
45
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
46
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
47
+ SOFTWARE.