@bokutake/dsh-connect-qoder 0.0.0-stage → 1.28.0
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/CHANGELOG.md +4860 -0
- package/LICENSE +21 -0
- package/LICENSE-MODIFICATIONS.md +60 -0
- package/README.en.md +492 -0
- package/README.md +498 -2
- package/THIRD_PARTY_NOTICES.md +60 -0
- package/cordis.patch.yml +12 -0
- package/docs/DESIGN.md +249 -0
- package/docs/DSH-0.2.1-RC1-FOLLOWUP.md +348 -0
- package/docs/DSH-0.2.2-RC1-FOLLOWUP.md +328 -0
- package/docs/DSH-0.2.2-RC2-FOLLOWUP.md +342 -0
- package/docs/DSH-0.2.2-RC3-FOLLOWUP.md +317 -0
- package/docs/DSH-0.2.2-RC5-FOLLOWUP.md +219 -0
- package/docs/PAT.md +191 -0
- package/docs/PRIVACY.md +109 -0
- package/docs/PROMO_BADGE.md +293 -0
- package/docs/assets/dsh-connect-qoder-composer-credits.png +0 -0
- package/docs/assets/dsh-connect-qoder-model-management.png +0 -0
- package/docs/assets/dsh-connect-qoder-model-picker.png +0 -0
- package/docs/assets/dsh-connect-qoder-promo-badge.png +0 -0
- package/docs/assets/dsh-connect-qoder-settings-page.png +0 -0
- package/docs/assets/dsh-connect-qoder-usage-card.png +0 -0
- package/docs/issues/magpie-330-billing-count.md +91 -0
- package/icons/dsh-connect-qoder-128.png +0 -0
- package/icons/dsh-connect-qoder-64.png +0 -0
- package/lib/bin.d.ts +26 -0
- package/lib/bin.js +219 -0
- package/lib/client.js +9252 -0
- package/lib/host-heartbeat-Daj8rZV0.js +4497 -0
- package/lib/index.d.ts +872 -0
- package/lib/index.js +6567 -0
- package/lib/transfer-pMn4lOHy.js +171 -0
- package/package.json +151 -4
- package/screenshots.json +8 -0
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# 第三方开源声明(Third-Party Notices)
|
|
2
|
+
|
|
3
|
+
> 本文件记录本项目在设计、实现与外观上参考或借鉴的开源项目,以及各自的许可证与合规要求。
|
|
4
|
+
>
|
|
5
|
+
> 通用平台与构建依赖(`@deepseek-ai/*`、`react`、`typescript`、`tsdown`、`vitest` 等)的许可证随各自 npm 包自动携带,不属于本文档范围。
|
|
6
|
+
>
|
|
7
|
+
> 若你对本文件的完整性有疑问或发现遗漏,请提交 issue 或 PR。
|
|
8
|
+
|
|
9
|
+
## 一、项目缘起
|
|
10
|
+
|
|
11
|
+
本项目是把 **Qoder(通义灵码国际 / 国内)模型接入 DeepSeek Harness(DSH)** 的独立实现:DSH 官方不提供 Qoder 的 OpenAI 兼容端点,官方 SDK 只是 agent 启动器,因此本项目直接实现 cosy 协议的最小客户端(自定义 Base64、MD5 签名、RSA/AES 会话、指纹派生、jobToken 交换、SSE 增量解析),并参照同作者的 workbuddy 插件工程组织 host↔client 结构。
|
|
12
|
+
|
|
13
|
+
## 二、参考项目清单
|
|
14
|
+
|
|
15
|
+
### 与 Qoder / cosy 接入直接相关
|
|
16
|
+
|
|
17
|
+
| 项目 | 仓库 | 参考内容 | 许可证 |
|
|
18
|
+
| --- | --- | --- | --- |
|
|
19
|
+
| `qoder2api`(Go) | <https://github.com/Zhengyuuuui/qoder2api> | cosy 协议 wire behavior 的参照实现:自定义 Base64 编码与重排、MD5 签名(`cosy&<SECRET>&<date>`)、RSA/AES 会话封装、指纹派生、jobToken 交换、SSE 信封与增量形状、错误分类。本项目**未复制其源码**,按其文档与运行行为独立实现为 TypeScript(`src/cosy.ts` / `src/upstream.ts`) | 仓库未附独立 LICENSE,README 声明其源自 `wangtufly/QCCG`(**GPL-3.0**,见下) |
|
|
20
|
+
| `QCCG`(qoder2api 的上游) | <https://github.com/wangtufly/QCCG> | qoder2api 声明的协议源头。本项目仅经 qoder2api 了解协议行为,未接触其源码 | **GPL-3.0** |
|
|
21
|
+
| `Qoder-Daily`(青龙脚本) | <https://github.com/L0NE-6/Qoder-Daily> | **每日签到**的协议参照:`sash/api/v1/me/campaigns` 拉活动 + `…/{campaignId}/claim` 领取的请求形状、`jt-` 令牌与 `cosy-clienttype` 头、幂等判定(`CLAIMED` / 409 / `replayed`),以及国际版所需设备风控三件套(`Cosy-MachineToken` / `MachineCode` / `MachineType`)由本机 UMID 组件产出的思路。本项目**未复制其源码**,按其文档与本机实测行为独立实现为 TypeScript(`src/upstream.ts` 的签到部分 / `src/device-risk.ts`),并补了它没有的两点:逐账号「先查后领」的幂等,以及取不到设备身份时**如实报错**而不是静默降级成「今天没有活动」 | **MIT** |
|
|
22
|
+
| Qoder 官方 SDK(agent 启动器) | 厂商随 IDE 分发的 TypeScript 类型定义(本地 `/tmp/sdk`) | 仅用于**类型核对**(usage 形状、cosy 头字段名),未复制其实现 | 厂商内部许可(不随本项目分发) |
|
|
23
|
+
|
|
24
|
+
> **GPL-3.0 合规说明**:本项目与 `QCCG`(GPL-3.0)之间**没有源码级衍生关系**——cosy 协议是公开的请求/响应行为(可通过抓包与文档观察),本项目按该行为**独立实现**全部加解密、签名与会话逻辑,不复制、不修改、不链接其任何源码。GPL 的传染性不适用于「仅参照协议行为、clean-room 独立实现」的作品;本项目自身以 MIT 发布,与之不存在再分发冲突。若你对这一判断有异议或发现任何源码级相似,请提交 issue。
|
|
25
|
+
|
|
26
|
+
### 与 DSH 插件结构 / 外观相关
|
|
27
|
+
|
|
28
|
+
| 项目 | 仓库 | 参考内容 | 许可证 |
|
|
29
|
+
| --- | --- | --- | --- |
|
|
30
|
+
| `dsh-connect-workbuddy` | <https://github.com/dingminhua/dsh-connect-workbuddy> | 插件工程结构的基准:host↔client 路由形态、设置卡片交互模型(区域 tab / 模型勾选 / 用量 / 探测)、loopback shim 模式、`web-status.ts` 路由、npm 发布工程(package.json / RELEASING / README 结构 / dsh-line 测试) | **MIT**(Copyright (c) 2026 LaoDing) |
|
|
31
|
+
| `dsh-connect-trae` | <https://github.com/dingminhua/dsh-connect-trae> | 经 `dsh-connect-workbuddy` 转引的 DSH 插件卡片外观与发布工程基准 | **MIT**(Copyright (c) 2026 LaoDing) |
|
|
32
|
+
| `dsh-codex-connect` | <https://github.com/franksong2702/dsh-codex-connect> | DSH 插件结构与 pi-ai provider 注册的参照(经 `dsh-connect-workbuddy` 转引) | **Apache-2.0** |
|
|
33
|
+
|
|
34
|
+
## 三、Apache-2.0 特别说明
|
|
35
|
+
|
|
36
|
+
`dsh-codex-connect` 采用 **Apache License 2.0**。本项目对它的参考是**间接的**:经由 `dsh-connect-workbuddy` 转引其 DSH 插件结构与 provider 注册思路。即便如此,本项目仍遵守 Apache-2.0 第 4 条的要求:
|
|
37
|
+
|
|
38
|
+
- **保留声明**:在该项目条目中标注其许可证为 Apache-2.0,并注明「经 `dsh-connect-workbuddy` 转引」的事实路径。
|
|
39
|
+
- **NOTICE 文件**:`dsh-codex-connect` 未随其仓库提供独立的 `NOTICE` 文本文件;若上游后续补充,本项目将同步将其内容纳入本文件。
|
|
40
|
+
- **改动声明**:本项目**未修改** `dsh-codex-connect` 的源码;适配器装配与插件注册为独立实现。
|
|
41
|
+
- **专利与商标**:本项目不主张 `dsh-codex-connect` 作者的任何专利许可或商标权利。
|
|
42
|
+
|
|
43
|
+
## 四、本项目的使用方式
|
|
44
|
+
|
|
45
|
+
- **借鉴设计思路 + 独立实现**:关键模块均为本项目独立编写(cosy 加解密、签名、会话、shim、适配器装配),并在各源文件头部注释中标注所参考的具体项目与模式。
|
|
46
|
+
- **不复制源码**:全部参考项目均只借鉴设计思路或协议行为,未复制、修改或再分发其源文件(含 GPL-3.0 的 `QCCG` 与无独立 LICENSE 的 `qoder2api`)。
|
|
47
|
+
- **版权声明保留**:所有参考项目的版权归各自作者所有。
|
|
48
|
+
- **后续引入依赖时**:引入任何新的 Qoder 相关外部依赖、或复用其他项目代码时,必须同步更新本文件,并遵守对应许可证的署名与声明要求。
|
|
49
|
+
|
|
50
|
+
## 五、图标来源与商标说明
|
|
51
|
+
|
|
52
|
+
本项目的插件图标(`icons/dsh-connect-qoder-128.png`、`icons/dsh-connect-qoder-64.png`,以及 `src/client/icon.ts` 中内联的 base64 副本)是 **LaoDing 插件家族通用的 LD 品牌标**(蓝紫渐变圆角磁贴 + 白色字标),与 `dsh-connect-trae` / `dsh-connect-workbuddy` 的图标**字节一致**——家族约定:图标标识「这是同一家族的插件」,产品区分由卡片标题、描述与配色承载。该美术作品由本作者原创,随本项目 MIT 许可分发。
|
|
53
|
+
|
|
54
|
+
- **0.2.0 曾用过 Qoder 桌面客户端的应用图标本体**(从 `/Applications/Qoder.app/…/application-icons/qoder-dark.png` 降采样),属**指示性使用**;0.3.0 起已改回家族 LD 标,**不再随包分发任何第三方美术作品**。
|
|
55
|
+
- **商标**:`Qoder`、`通义灵码` 名称与各自图标是厂商的商标,本项目仅在描述兼容关系的意义上使用其名称,不表示 Qoder 官方出品、背书或授权;相关权利归各自所有。
|
|
56
|
+
- **可替换性**:替换图标只需重新生成 `icons/` 下两个 PNG 并同步 `src/client/icon.ts` 的 data URI(见该文件头部注释),不影响任何代码逻辑。
|
|
57
|
+
|
|
58
|
+
## 六、随包分发
|
|
59
|
+
|
|
60
|
+
本文件已列入 `package.json` 的 `files` 白名单,随 npm 包一同分发,确保最终用户在安装包内即可看到完整的第三方声明。README(中英双语)中的「致谢」章节与本文件互为索引。
|
package/cordis.patch.yml
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# Register the Qoder provider without changing the profile's default model.
|
|
2
|
+
# PAT is configured in the plugin's settings card (or via environment
|
|
3
|
+
# variable); no OAuth flow is started by the plugin itself.
|
|
4
|
+
#
|
|
5
|
+
# `id` deliberately stays the unscoped `dsh-connect-qoder`: it is the entry id,
|
|
6
|
+
# the settings namespace (`settingsNamespaceOf`), and the `/plugins/<id>/…`
|
|
7
|
+
# route prefix. Renaming it would silently orphan every existing install's
|
|
8
|
+
# saved config. Only `name` — the package resolved through the profile's
|
|
9
|
+
# node_modules — carries the npm scope.
|
|
10
|
+
- insert:
|
|
11
|
+
- id: dsh-connect-qoder
|
|
12
|
+
name: '@dmh2002/dsh-connect-qoder'
|
package/docs/DESIGN.md
ADDED
|
@@ -0,0 +1,249 @@
|
|
|
1
|
+
# 设计方案:dsh-connect-qoder
|
|
2
|
+
|
|
3
|
+
> **目标**:把 Qoder(通义灵码国际 / 国内)接入 DeepSeek Harness(DSH)。
|
|
4
|
+
> **表现形式**:与插件家族一致(`dsm-*` 卡片外观),基准实现为
|
|
5
|
+
> [`dsh-connect-workbuddy`](https://github.com/dingminhua/dsh-connect-workbuddy)。
|
|
6
|
+
> **内核**:DSH 官方不提供 Qoder 的 OpenAI 兼容端点,官方 SDK 只是 agent 启动器,
|
|
7
|
+
> 因此本项目直接实现 cosy 网关协议的最小客户端。
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## 一、边界:不做什么
|
|
12
|
+
|
|
13
|
+
**不做插件之间的联动。** 本插件只对 DSH 宿主负责:自己的 provider、自己的凭据、
|
|
14
|
+
自己的账号池、自己的读数。它不探测、不读写其他插件的配置 / 落盘 / 内存状态,不
|
|
15
|
+
订阅或替别的插件发事件,也不参与需要两方约定协议的协作——「联合面板」「统一账号池」
|
|
16
|
+
「跨插件的会话路由」这类活一律不做。
|
|
17
|
+
|
|
18
|
+
理由不是能力问题,而是三条边界一旦跨过就回不来:
|
|
19
|
+
|
|
20
|
+
- **凭据边界**:账号池里的 PAT 是本插件保管的东西。任何跨插件共享都意味着它要离开
|
|
21
|
+
这个边界,而对方怎么存、怎么落盘、会不会写进日志,不在本插件的控制里。
|
|
22
|
+
- **故障归因**:联动出问题时,用户看到的是「装了这个就不对」,两边日志各说各话。
|
|
23
|
+
不联动,每次失败就只有一个可能的责任方。
|
|
24
|
+
- **版本耦合**:联动的两端必须一起发版、一起测、一起修,而两个插件的宿主基线、
|
|
25
|
+
发版节奏本来就不必相同。
|
|
26
|
+
|
|
27
|
+
第一个被这条边界裁掉的功能,是 1.10.0 引入、1.12.0 移除的**跨连接器余额对比**
|
|
28
|
+
(issue #14):别的连接器的模型被选中时,本区域也把积分胶囊画出来。它让本插件去
|
|
29
|
+
解释另一个插件的存在,读数还出现在一个根本不经过 Qoder 计费的会话里;要对比两边
|
|
30
|
+
余额,切一下模型即可,不需要两个插件就「同时显示」达成一致。
|
|
31
|
+
|
|
32
|
+
**共享插槽**上的占位冲突同理:`conversation.input.right` 是 list 插槽,另一个插件
|
|
33
|
+
停在那里可能把读数挤到看不见。本插件的回答是给自己多留一个可选席位
|
|
34
|
+
(`creditPosition`:输入框工具栏 / 输入框下方),由用户换位置,而不是去和对方协商
|
|
35
|
+
谁先谁后。
|
|
36
|
+
|
|
37
|
+
与「不联动」不矛盾的三件事,划在这里免得被读成同一类:
|
|
38
|
+
|
|
39
|
+
- **读宿主的公开投影**(`modelSelection`)不算联动——那是宿主对所有插件公开的契约,
|
|
40
|
+
不是插件之间的私约。本插件据此判断「当前会话是不是在用我的模型」,仅此而已。
|
|
41
|
+
- **同族借鉴**(卡片外观、已修缺陷的教训,见第二节)是**源码级**的,不是运行期
|
|
42
|
+
的:两个插件装在同一台机器上也互不感知、互不调用。
|
|
43
|
+
- **单槽的委托渲染**——宿主槽位机制下的降级策略,见下一段。它不读对方状态、不约定
|
|
44
|
+
私有事件,换谁来当邻居都一样。
|
|
45
|
+
- **复现宿主的目录字段**(`model.badge`)——宿主把每个模型自带的胶囊当普通数据下发,
|
|
46
|
+
我们只把它画出来,不知道也不关心是谁填的,代码里没有任何 `if (某个插件装了)`。
|
|
47
|
+
|
|
48
|
+
### 唯一的例外:模型选择器标签槽的委托
|
|
49
|
+
|
|
50
|
+
会调用到别的插件代码的地方只有一处:宿主的模型选择器标签槽
|
|
51
|
+
(`conversation.input.model.label`,见 `src/client/QoderModelLabel.tsx`)。
|
|
52
|
+
|
|
53
|
+
它是 **single 槽**——priority 升序、最低者渲染,一个槽只容一个占位者。本插件用
|
|
54
|
+
`-101` 占住它之后,**所有** provider 的模型行都交给它来画。对不属于本插件的行,
|
|
55
|
+
`foreign` 分支先看槽位账本:取下一个注册项(跳过自己),把宿主的 ownerProps 四项原样
|
|
56
|
+
转给它、并渲染成**子元素**。
|
|
57
|
+
|
|
58
|
+
**交不出去的时候**(账本里没有别人、拿不到 locale 面、对方命名空间的 `t` 绑不出来),
|
|
59
|
+
退路是 `ForeignModelLabel`:**名字 + 该模型自带的 `model.badge`**,顺序按宿主的
|
|
60
|
+
fallback(`trigger` 位胶囊在前,`menu` / `option` 在后)。不是裸名字 —— 见下一段。
|
|
61
|
+
|
|
62
|
+
这不是「联动」,而是**不抢占**:single 槽只有一个占位者,本插件占了槽却只画自己的
|
|
63
|
+
东西,别家插件的徽标就会在用户眼前消失——那比「不合作」更糟。委托只经过宿主公开的
|
|
64
|
+
槽位账本与 ownerProps 契约:不按名字找某个插件,不读它的配置 / 落盘 / 内存,也不与它
|
|
65
|
+
约定事件。账本里是谁就委托给谁。
|
|
66
|
+
|
|
67
|
+
`model.badge` 那一支同理,**并且和数据来自哪里无关**:它是宿主目录里的字段
|
|
68
|
+
(`LlmModelInfo.badge` → 选择器的 `props.model.badge`),我们不知道也不关心是谁填的,
|
|
69
|
+
代码里没有任何「某个插件在场」的判断。规则见 dsh-connect-workbuddy 的
|
|
70
|
+
`docs/MODEL-LABEL-SPEC.md` §4(同族共用的一套做法)。
|
|
71
|
+
|
|
72
|
+
`tests/model-label.spec.tsx` 的「外来 provider 的委托」一节把这两条钉住:被委托的组件
|
|
73
|
+
必须作为子元素渲染(它有自己的 hooks;直接函数调用会把两边的 hook 序列混在一起);
|
|
74
|
+
交不出去时画的是「名字 + 胶囊」而不是裸名字;那一支**不发请求、不抛**。
|
|
75
|
+
|
|
76
|
+
### 同一件事的另一半:胶囊作为目录数据
|
|
77
|
+
|
|
78
|
+
本插件自己的行上那枚促销胶囊,走的是**数据**而不是组件:`src/model-badge.ts` 判定,
|
|
79
|
+
`adapter.listModels()` 用展开写法挂进 `LlmModelInfo.badge`。这是 0.2.2 起宿主给的通道,
|
|
80
|
+
与「谁赢了标签槽」无关——赢了画得更多,输了也还有这枚胶囊。
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## 二、与 workbuddy 的分工
|
|
85
|
+
|
|
86
|
+
| 层 | 来源 | 取什么 |
|
|
87
|
+
|---|---|---|
|
|
88
|
+
| 插件外壳 / 外观 | `dsh-connect-workbuddy` | 卡片结构、`dsm-*` CSS、`settingsScope` 配置回写、路由形态、发布工程、CI |
|
|
89
|
+
| 连接内核 | 自行实现(`src/cosy.ts` / `src/upstream.ts`) | Qoder 的 cosy 协议:自定义 Base64、MD5 签名、RSA/AES 会话、指纹派生、jobToken 交换、SSE 增量解析 |
|
|
90
|
+
| 已修缺陷的教训 | `dsh-connect-workbuddy` | 「平台标记 ≠ 模型原生能力」「声明可关闭思考不等于真的能关」等已踩过的坑(见第六节) |
|
|
91
|
+
|
|
92
|
+
关键差异(**合理**差异,非缺口):
|
|
93
|
+
|
|
94
|
+
- **凭据**:workbuddy 读桌面端本地加密凭据(`auth.ts` / `at-rest.ts` / `oauth.ts`);
|
|
95
|
+
本插件用用户自备的 PAT(`credentials.ts`)+ 本地 vault(`accounts.ts`)。
|
|
96
|
+
- **签到**:两边都有每日签到,但端点不同——WorkBuddy 有专用 checkin 端点,Qoder
|
|
97
|
+
的签到藏在 `sash/api/v1/me/campaigns`(活动/权益)+ `…/{campaignId}/claim` 里,
|
|
98
|
+
名字没有「签到」二字,照 checkin / signin / reward 猜路径一律 404(早期据此
|
|
99
|
+
误判为「没有签到」,已修正)。国际版的活动只下发给带设备风控头的请求,
|
|
100
|
+
三件套由 `device-risk.ts` 读本机 Qoder 客户端的 UMID 组件产出。
|
|
101
|
+
- **工具调用恢复**:workbuddy 需要 `dsml-recovery.ts` / `markup-diagnosis.ts`,
|
|
102
|
+
因为其上游**不**发原生 tool_calls;Qoder 上游**原生**发 `delta.tool_calls`
|
|
103
|
+
(见 `src/upstream.ts` 的解析与 `src/shim.ts` 的直写),故不需要这两个模块。
|
|
104
|
+
|
|
105
|
+
---
|
|
106
|
+
|
|
107
|
+
## 三、模块结构
|
|
108
|
+
|
|
109
|
+
```text
|
|
110
|
+
DSH PiAiAdapter(qoder / qoder-global 各一套)
|
|
111
|
+
-> 安全 loopback shim(每区域一个随机端口 + 进程内随机 secret)
|
|
112
|
+
-> QoderUpstreamClient(cosy 协议最小客户端)
|
|
113
|
+
-> https://gateway.qoder.com.cn/algo/api/v2/... (国内)
|
|
114
|
+
-> https://api1.qoder.sh/algo/api/v2/... (国际)
|
|
115
|
+
-> Qoder SSE(OpenAI 形状增量)
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
| 模块 | 职责 |
|
|
119
|
+
|---|---|
|
|
120
|
+
| `status-paths.ts` | node-free 契约中心:路由常量、DTO、区域/动作 helper |
|
|
121
|
+
| `cosy.ts` | 协议层:自定义 Base64、`n/3` 重排、签名、RSA/AES 会话、指纹 |
|
|
122
|
+
| `upstream.ts` | `exchangeJobToken` / `fetchModels` / `chatStream` / `fetchUsage` / `fetchCampaignFeed`;错误分类 |
|
|
123
|
+
| `credentials.ts` | PAT 校验、`qoderAccountId`(sha256 前 16 位)、掩码 |
|
|
124
|
+
| `accounts.ts` | 本地 vault(`$DSH_HOME/.qoder-accounts.<region>.json`,0600),三源去重合并 |
|
|
125
|
+
| `account-pool.ts` / `-store.ts` / `-run.ts` | 账号池排序(`rankPool`)、测量落盘、批量测试 |
|
|
126
|
+
| `off-thinking.ts` | 「可关闭思考」的校正表与种子(见第六节) |
|
|
127
|
+
| `native-modality.ts` | 模型原生多模态表与图片默认值(见第六节) |
|
|
128
|
+
| `shim.ts` | loopback 服务:入站校验、SSE 翻译、首字节前故障转移 |
|
|
129
|
+
| `adapter.ts` | pi-ai 装配:代际门控、思考档位映射、模型描述符 |
|
|
130
|
+
| `web-status.ts` | 浏览器路由:usage / account-credits / campaigns / accounts / pool / transfer / probe / `__save` |
|
|
131
|
+
| `index.ts` | 装配中枢:双区域栈、配置 schema、目录管注册 |
|
|
132
|
+
| `bin.ts` | CLI:`doctor` / `status` / `logout` |
|
|
133
|
+
|
|
134
|
+
---
|
|
135
|
+
|
|
136
|
+
## 四、凭据与账号池
|
|
137
|
+
|
|
138
|
+
三源按 **settings → env → vault** 优先级去重合并(同一个 PAT 只在最高优先级
|
|
139
|
+
来源里列出一次,id 由 PAT 本身派生,故重复项必然精确相同):
|
|
140
|
+
|
|
141
|
+
| 来源 | 位置 | 说明 |
|
|
142
|
+
|---|---|---|
|
|
143
|
+
| settings | `regions.<region>.pat` | 卡片填写,优先 |
|
|
144
|
+
| env | `QODERCN_PERSONAL_ACCESS_TOKEN` / `QODER_PERSONAL_ACCESS_TOKEN` | 无 UI 场景 |
|
|
145
|
+
| vault | `$DSH_HOME/.qoder-accounts.<region>.json` | 多账号池,0600 |
|
|
146
|
+
|
|
147
|
+
账号池「实测优先」:`test` 批量对每个成员发真实探测,结果落
|
|
148
|
+
`$DSH_HOME/.qoder-pool.<region>.json`;聊天流在**首字节之前**按 `rankPool`
|
|
149
|
+
(可用性 → 临期积分 → 用户手排顺序 → 积分到期最近 → 积分高 → id)自动换账号。
|
|
150
|
+
首字节之后绝不换账号(那会让用户看到两个人拼出来的回答)。
|
|
151
|
+
|
|
152
|
+
> 「积分到期」与「套餐到期」是**两件事**(issue #31):前者来自签到批次的
|
|
153
|
+
> `validity.days`(`credit-expiry.ts`,悲观上界),进排序;后者是上游
|
|
154
|
+
> `qoderUsage.expiresAt`(`planExpiresAtMs`,账号级试用/套餐),**不进排序** ——
|
|
155
|
+
> 拿它当临期紧急度会让刚过试用期的号永远排在最前面,而它的分不会过期。
|
|
156
|
+
> 签到批次与当日窗口时刻都落在同一个池文件里(`credits` / `windows` 两键),
|
|
157
|
+
> 所以进程重启不会让「30 天后作废」与「约 N 小时后解禁」一起丢失(issue #32)。
|
|
158
|
+
|
|
159
|
+
**每日签到已接通**(CN 与国际版),所以池的批量动作是 `checkin` / `test` 两个,
|
|
160
|
+
另有逐账号的 `remove`。签到**先查状态再领取**(幂等),且只在你点按钮时执行——
|
|
161
|
+
不提供自动签到。
|
|
162
|
+
|
|
163
|
+
---
|
|
164
|
+
|
|
165
|
+
## 五、推理与上下文
|
|
166
|
+
|
|
167
|
+
- **推理**:Qoder 的推理线上量是**布尔** `model_config.is_reasoning`,不是 effort
|
|
168
|
+
档位。所以 `qoderThinkingLevelMap` 只能表达 `off`(且仅
|
|
169
|
+
`canDisableThinking` 的模型提供),所有 effort 档位映射 `null`。
|
|
170
|
+
- **上下文档位**:从上游 `context_config` 解析模型**声明的**档位
|
|
171
|
+
(`contextTiers`),用户按档选择;预算只在该档位确实被声明时生效,否则回落
|
|
172
|
+
原生值(`applyContextBudgets`)——不发明一个上游不认的值。
|
|
173
|
+
|
|
174
|
+
---
|
|
175
|
+
|
|
176
|
+
## 六、从 workbuddy 继承的「已修缺陷」教训(重点)
|
|
177
|
+
|
|
178
|
+
这三条是同一个形状的问题:**上游的声明字段不可全信**。解法也相同:按**精确
|
|
179
|
+
model id** 键控的人工核对表 + 只在有依据时才给默认值,其余留 `unknown`(宁可
|
|
180
|
+
少给,也不要每次都失败/撒谎)。
|
|
181
|
+
|
|
182
|
+
### 6.1 平台标记 ≠ 模型原生能力(`native-modality.ts`)
|
|
183
|
+
|
|
184
|
+
上游目录的 `supportsImages`(Qoder 的 `is_vl`)是**平台**的图片输入声明,不是
|
|
185
|
+
**模型**的原生能力,且它对几乎每个模型都是 `true`。直接采信等于让一个上游字段
|
|
186
|
+
替本插件下能力结论——它在某个模型上猜错时,用户按下去请求必失败。所以本插件不
|
|
187
|
+
拿它当答案,只认一张按**精确 model id** 键控的核对表,表外一律 `unknown`
|
|
188
|
+
(不预勾选)。
|
|
189
|
+
|
|
190
|
+
**这张表本身也被上游打脸过,这才是本节真正的教训。** 旧表按厂商命名推断,把
|
|
191
|
+
`kimi-k2.7-code` 标成 `text`,并断言 DeepSeek-V4-Pro / GLM-5.2 是纯文本。
|
|
192
|
+
2026-10-29 实测(发一张画着数字 `7` 的 PNG,问「图片里是哪一个数字」——读不到
|
|
193
|
+
图的模型答不出 7):**两区域目录并集里的 14 个模型全部答对**,包括上述几条。
|
|
194
|
+
所以当前目录里**没有**纯文本模型,旧结论是从名字推的、没有实测支撑。
|
|
195
|
+
|
|
196
|
+
于是登记依据改为**厂商文档 + 真机实测**,主键换成**内部短 id**:显示名会随
|
|
197
|
+
模型迭代改名(`Qwen3.7-Max` → `Qwen3.8-Max` 真实发生过),旧表四个 `qwen3.x`
|
|
198
|
+
键因此全部失配——按短 id 键控才不会在上游改名时悄悄失效,厂商名保留为别名键。
|
|
199
|
+
|
|
200
|
+
解法不变:`NATIVE_MODALITY_BY_MODEL_ID` + `imageDefaultFor`(只有确认
|
|
201
|
+
`multimodal` 才预勾选;`supportsImages:false` 仍可否决),**不虚构**条目。
|
|
202
|
+
**与 workbuddy 的差异**:对方面向已核对过的数据源,本项目没有同等来源,于是用
|
|
203
|
+
真机实测自建依据——但结论必须是**测出来的**,不是从模型名字推出来的。
|
|
204
|
+
|
|
205
|
+
**同轮的另一条教训**:`mmodel` 起初在这轮实测里每次都失败,症状正是「纯文本
|
|
206
|
+
模型」;追下去真因是上游投递 `body: "null"` 空帧把 `parseStreamDelta` 打成
|
|
207
|
+
TypeError。**「测出来失败」要先排除「是我们的代码在失败」**,否则一个解析崩溃
|
|
208
|
+
会被登记成一条模型能力事实,而错误的事实比 unknown 更糟。
|
|
209
|
+
|
|
210
|
+
### 6.2 声明「可关闭思考」≠ 真的能关(`off-thinking.ts`)
|
|
211
|
+
|
|
212
|
+
workbuddy 实测:声明可关闭的模型里有一部分对 `reasoning_effort:"off"` 回 400,
|
|
213
|
+
且错误体不点名参数。由于该档位写进运行时描述符,失败会在**此后每一次请求**上
|
|
214
|
+
重演,用户读到的是「这个模型坏了」。
|
|
215
|
+
|
|
216
|
+
解法:`REFUSES_OFF_MODEL_IDS` + `offDefaultFor` + `defaultOffModelIds`(首读种子)
|
|
217
|
+
+ `withEffectiveOff`(把用户选择盖印到运行时目录)。**差异**:本项目暂无实测拒绝
|
|
218
|
+
样本,故拒绝集**留空而非虚构**——默认行为等同 0.1.0(不倒退),一旦实测到只需
|
|
219
|
+
加一行即可开始隐藏。代价不对称是这里的取舍依据:提供一个必然失败的档位,代价是
|
|
220
|
+
用户该模型的每一次请求;藏起一个本可用的档位,代价只是一个选项。
|
|
221
|
+
|
|
222
|
+
### 6.3 图片勾选必须独立持久(`imageModelKeys`)
|
|
223
|
+
|
|
224
|
+
workbuddy 用独立的 `imageModelIds`;本项目早期把图片勾选**耦合进** `lastCatalog`
|
|
225
|
+
快照,目录一被重写就可能连带改变某个模型的图像答案。现改为独立集合
|
|
226
|
+
(`regions.<region>.imageModelKeys`),运行时只从它派生图像能力。
|
|
227
|
+
|
|
228
|
+
---
|
|
229
|
+
|
|
230
|
+
## 七、安全
|
|
231
|
+
|
|
232
|
+
- **PAT 不出进程**:pi-ai 只与本地 shim 对话;shim 用 cosy 会话做上游请求。
|
|
233
|
+
- **shim 入站校验**:先查 Host / Origin(仅接受 `127.0.0.1`)/ Content-Type,
|
|
234
|
+
再做 `timingSafeEqual` bearer 比对;body 有大小上限。
|
|
235
|
+
- **脱敏**:任何上游文本在落盘/回传前经 `redactUpstreamText`
|
|
236
|
+
(`key=secret` 保留键名抹值;裸 `pt-` token 整段替换)。
|
|
237
|
+
- **vault 权限**:`0600`(目录 `0700`),写入走原子替换 + 文件锁。
|
|
238
|
+
- **不读桌面端登录文件**:与 workbuddy 不同,本插件不接触、不修改 Qoder 桌面端
|
|
239
|
+
的任何本地凭据。
|
|
240
|
+
|
|
241
|
+
---
|
|
242
|
+
|
|
243
|
+
## 八、源头与致谢
|
|
244
|
+
|
|
245
|
+
- 外观与工程骨架:[`dsh-connect-workbuddy`](https://github.com/dingminhua/dsh-connect-workbuddy)(MIT)—— 各源文件头部均带标注。
|
|
246
|
+
- cosy 协议行为参照:[`qoder2api`](https://github.com/Zhengyuuuui/qoder2api) / `QCCG`(其声明为 GPL-3.0)。
|
|
247
|
+
本项目**未复制其源码**,按其文档与运行行为独立实现为 TypeScript。
|
|
248
|
+
合规细节见 [`THIRD_PARTY_NOTICES.md`](../THIRD_PARTY_NOTICES.md)。
|
|
249
|
+
- 商标:Qoder 名称是厂商商标,此处仅用于标识本插件所连接的服务;插件图标沿用 LaoDing 插件家族通用的 LD 品牌标(与 dsh-connect-trae / dsh-connect-workbuddy 字节一致),不使用厂商商标图形。
|