# 已知问题 / 待修清单 **从上往下修**。每条都写清「现象 → 根因 → 已改了什么 → 还差什么」， 换一台机器也能直接接着干，不用重新调研。 状态图例： | 标记 | 含义 | |---|---| | 🔴 | 有真机复现，**还没修好**（代码可能已经改了，但没验证过，不算修好） | | 🟡 | 代码已改，只跑过单测/预览，**没在真机上确认** | | 🟢 | 真机确认过 | --- ## 🟢 #0z Qoder 国际版：积分显示 0 / 签到看起来一直不生效（2026-11-02） **现象**：国际版账号的积分显示不出来；每日签到也一直没到账。 **根因 A（积分）**：`getQuota()` 只读 `addOnQuota.remaining`。这对外卖/试用账号是对的 （实测 `userQuota` 恒 0），但**付费账号的月度额度在 `userQuota` 里、`addOnQuota` 可能是 0** —— 只看一个桶就把「有 1500 积分」显示成 0。现在改成 `qoderTotalRemaining()` 把 `userQuota` / `addOnQuota` / `dedicatedResourcePackages` **全部相加**； 只有单桶有余额时仍标原来源，多桶时标「全部资源包之和」。 **根因 B（签到）**：签到 job 的默认 schedule 是 `every:86400`，从**插件启动时刻**起算。 Qoder 的活动每日 **10:00（UTC+8）** 才刷新 —— 用户恰好装在一个早于 10:00 的时刻， 就会**每天都早一步**：每次都是 `coversToday:false`（「尚未刷新」）， 而 `CheckInResult.coversToday` 的文档写着「当天稍晚会自动重试」， **但代码里根本没有这个重试**，于是下一次是 24 小时后同一时刻，永远领不到。 **改法**： - `CheckInResult` 新增 `retryAfterMs`（适配器告诉宿主「什么时候补」）； - Qoder 在「尚未刷新」的两条分支上都给出 `10:00 + 2 分钟缓冲`（`core/time.ts` 新增 `msUntilUtc8Hour()`，纯 UTC+8 算术，不看本机时区）； - `runtime` 兑现它：同一天补一次（同一个 key 只留一个定时器，上限 12 小时， `dispose()` 时清理）。补签走的是同一条 `tasks.checkIn()`，幂等由上游 `replayed` 保证。 **验证**：单测钉住「两桶相加」「`retryAfterMs > 0` / 已刷新时不带」「`msUntilUtc8Hour` 跨日」；本机国际版真机复测 `getQuota.remaining=200`、`checkIn → 今天已领取`。 --- ## 🟢 #0y Qoder / Qoder CN 只能存在一个账号：登录按标签认号，标签又永远是默认值（2026-11-02） **现象**：再登录一个 Qoder 账号，列表里还是只有一条 —— 后一个把前一个顶掉了。 **根因**（两层叠在一起）： 1. `runtime.persistLogin()` 只按 **label** 找已有账号，找到就 `setCredentials` 覆盖（这是「重新登录换凭证」的设计）； 2. Qoder 的 `pollLogin()` 把 `user_name` 当标签，而**设备码响应里没有 `user_name`** （`src/vendor/qoder/qoder.ts` 实测注释：四个账号的昵称全缺）⇒ 标签永远落到默认的 「Qoder 账号」⇒ 第二个账号必然命中第一条记录。 **改法**： - `LoginPollResult` 新增 **`accountKey`**（稳定身份）。Qoder 用 `user_id`（`payload.uid`）， Buddy 用 `credentials.uid`（昵称可能重名，不能当身份）； - `persistLogin()` 改成**身份优先、标签兜底**：有 `accountKey` 就按凭证里的 `uid` / `account` 找；找不到再按标签找；都没有才新建； - 新建时标签撞名自动编号（`Qoder 账号 (2)`），不再因为 `accounts.add()` 拒绝重名而退化。 **验证**：新增 3 条用例 —— Qoder 有/无 `user_name` 两种响应都要带 `accountKey`； 真 `GatewayRuntime` 里两次不同 uid 登录必须建出两个账号（标签 `(2)`）； 同一个 uid 再登录仍然只有一条且凭证被更新。 --- ## 🟢 #0x issue #9：Trae 登录入口点进去必然失败 —— 整条下架（2026-11-02） **现象**：点「登录 Trae」→ 弹「获取授权链接失败」。 **根因**：`TraeAdapter` **没有实现** `beginLogin` / `pollLogin`（见 `src/adapters/trae.ts` 文件头：OAuth 那套 32KB 不在本期范围），而账号页对**每个 visible 平台**都画「登录」按钮 ⇒ `runtime.startLogin()` 抛「「Trae」适配器没有实现登录」；界面又不提供手工填 token 的入口 （所有账号都走登录流程）⇒ 用户是死路。 **改法**：产品层面下架，而不是 `visible: false`（那只是默认值，用户显式打开还会看到）： - `src/config.ts` 新增 `RETIRED_AGENTS = ['trae']`； - 从 `AGENT_ORDER`（`src/adapters/index.ts`）、`client.js` 的 `AGENTS`、config schema 的 `agents` 键、`plugin.json` 的 `contributes.llmProviders` 四处一起移除； - `runtime.isAgentExposed()` 对它恒为 `false` —— 就算有人手工把 `visible: true` 写回去也没用。 适配器代码与 `test/adapters/trae.test.mjs` 保留（协议层能跑），将来补上 OAuth 再解除。 README 平台表加了一条「不支持 Trae」。 --- ## 🟢 #0w issue #8：缓存命中率显示成一半 —— `inputTokens` 用了「完整 prompt」（2026-11-02） **现象**：界面会话统计显示缓存命中 **49%**，按上游原始数字算却是 **99%**。 **根因**：DSH 的 `TokenUsage.inputTokens` 契约是**未缓存**那一桶 —— `dsh-token-meter/lib/index.js` 里 `uncachedInputTokens: usage.inputTokens`， 聊天界面再用 `billedInputTokens = uncached + cacheRead + cacheWrite` 把缓存加回去。 而 `normalizeUsage()` 把 OpenAI 风格的 `prompt_tokens`（**含**命中部分）原样塞进去 ⇒ `cacheRead` 被算两遍，显示值 = 真实值 / (1 + 真实值)。 **改法**：按**字段来源**区分，不搞一刀切 —— | 上游风格 | 字段 | 要不要减 | |---|---|---| | OpenAI | `prompt_tokens_details.cached_tokens` / `prompt_cache_hit_tokens` | **减**（`prompt_tokens` 含缓存） | | Anthropic | `cache_read_input_tokens` | **不减**（`input_tokens` 本来就不含缓存） | `src/core/sse.ts` 与 `src/vendor/trae/trae-sse.ts` 同口径；请求日志新增 `inputSemantics: 'uncached'`，界面据此选分母（新记录 `input + cacheRead`， 老记录仍用 `input`）—— 不区分的话历史数据会集体「腰斩」。 **验证**：单测钉住四种形态（OpenAI / Anthropic / 冷启动无缓存 / 读到比输入还大）， 客户端用例钉住新旧两种分母。 --- ## 🟢 #0v GitHub issue #2–#7 批量修复（2026-10-30） 同一作者连着开了 6 个 issue，逐条核对后 **5 个是真 bug、1 个是复核报告**。本次一并修掉。 | Issue | 结论 | 修法 | |---|---|---| | #2 国内版前缀缓存 0% | ✅ 成立 | CN 补会话三件套 + 请求日志记 cacheRead/Write | | #3 11-128 复核 | ✅ 报告属实，不是 bug | 只补「相邻句对」回归用例 | | #4 回退表丢 reasoning | ✅ 成立 | 内置表补实测档位 + 回退不覆盖落盘缓存 + 日志升到 warn | | #5 11-128 被归成 risk_control | ✅ 成立，最危险 | 新增 `channel_reject`：不换号、不记账、不冷却 | | #6 不解析 Retry-After / 重置时刻 / requestId | ✅ 成立 | 头 + 体两条都读，6004 归 `rate_limit` | | #7 `router.execute` 没有 AbortSignal | ✅ 成立 | signal 贯穿 + `aborted` 独立 kind | ### #2 会话三件套（前缀缓存 key） `BUDDY_CN` 原先 `requiresConversationHeaders: false` 且无 `chatIdentity`，`buddyChatHeaders()` 在 596 行提前返回、没把 session 传下去 ⇒ 三个头一个都不发 ⇒ 每轮都是全新会话。 实测（issue 作者 + 本机复核）：三头齐发后同一前缀命中率 **0% → 95.5%**，费用差约 17 倍。 2026-10-30 本机独立复现（换到能直连 CN 的网络）：`hy4-preview` 同前缀 4 轮 `prompt=3511`， 前 3 轮 `cacheRead=3392`（≈96.6%），第 4 轮 0 —— 上游缓存**按节点 / TTL 生效，不是每轮必中**。 新增 `sendConversationHeaders` 产品开关（**与国际版那三个渠道校验头不是一回事**）， CN 打开；`buddyChatHeaders()` 提前返回时把 `{sessionId, messageId, rootRequestId}` 传进 `buddyHeaders()`。顺带把 `cacheReadTokens` / `cacheWriteTokens` 记进请求日志 —— 原先 `Usage` 解析出来了却没落盘，用户报「缓存没命中」时根本没有数据可查。 ### #4 回退表也要带档位 `FALLBACK_MODELS` 补上**实测过的** `efforts`（CN `hy4-preview: ["high"]`；INTL 的 `hy4-preview` / `hy3` / `deepseek-v4.1-flash*`），回退映射把它映射成 `reasoningEfforts`。 没测过的模型留空，不照同族猜。 另加 `AgentAdapter.modelListSource()`：`'fallback'` 时运行时**不用它覆盖落盘缓存**， 有缓存就先用缓存 —— 否则一次网络抖动就会把 21 条真实目录（带档位）换成 11 条内置表。 ### #5 `channel_reject` `errors.ts` 的 `/请求被拦截/` 会把 11-128 判成 `risk_control` ⇒ 换号 + 30 分钟冷却 + `failures >= degradeAfterFailures*2` 判死。新增判据（文案 + 业务码，连字符用字符类兼容 U+2010–U+2015 与全角），命中即 `channel_reject`，排在所有状态码分支之前： - `shouldSwitchAccount` / `isRetryable` 都不含它； - 路由层不 `markFailure`、不冷却、不换号，直接返回。 ### #6 退避与 requestId `buddy.ts` 错误分支补 `retryAfterMs`（头优先，读不到再用新加的 `parseResetAtFromBody()` 解析报文里的「将在 … UTC+8 重置」，**按报文声明的时区换算**） 与 `requestId`（头优先，再取 body）。`classify()` 增加 `code: 6004` → `rate_limit`， 不再依赖「限流/频繁」关键词。 2026-10-30 真机补丁：限流器还会把恢复时间写成**相对时长** —— 实测小浣熊 `[200103] limiter_request_error：request exceed max time, retry after:0s`。 `parseResetAtFromBody()` 现在也认 `retry after:12s` / `250ms` / `15 秒后重试`； `0s` **抬到 1 秒**（否则 `penaltyMsFor` 算出 0 冷却 ⇒ 下一轮立刻又选中同一账号，变热循环）； `raccoon.ts` 补上「头里没有就读报文」这条兜底（它走裸 fetch，原先只读头）。 ### #7 取消信号 `RouteOptions` 新增 `signal`，`execute()` 每轮开头检查、退避等待可被打断； `AbortError` 在 Buddy / SSE 两处都归成 `aborted`（不再混进 `network`）。 取消不记账、不换号、不冷却。 ### 验证 - 宿主 **698/698**、客户端 **86/86**、冒烟通过； - 新增用例：11-128 归类与连字符变体、6004、`parseResetAtFromBody`（UTC+8 / Z / 无时区 / 相对时长）、 `isAbortError`、`execute` 取消不发起尝试、CN 会话三件套与稳定性、回退表 reasoning、 429 头/体两种退避、相邻句对。 --- ## 🟢 #0u 图片从来没发给上游：`toOpenAiMessages()` 只拼文本块（2026-10-29） ### 现象 用户反馈小浣熊 `DeepSeek-V4.1-Flash-1017`（`sn-deepseek-v4-1-flash-1017`）「不能识别图片」， 怀疑插件没把图片发过去。 ### 根因 `src/llm/adapter.ts` 的 `toOpenAiMessages()` 只把 `type === 'text'` 的块拼进 `content`， `ImageBlock` **整块丢掉**。七家平台共用这一个出口 ⇒ 不是小浣熊一家，是**全部**。 当时没有任何 provider 真的发图，所以连 `imageRequestPricing()` 都按「视觉 token 恒 0」写死。 ### 证据 - 宿主的类型声明就是 `ImageBlock { type:'image'; attachment: ImageAttachmentRef }` —— 它**确实**把图交给了插件； - 单测复现：输入 `[text, image]` → 出站只剩 text，`image_url` / `attachmentId` 都不在； - 上游能力：直接给 `sn-deepseek-v4-1-flash-1017` 发 240×120 红底 + 黄色圆形的 PNG， 思维链准确说出「背景红色、前景黄色圆形」⇒ **模型与上游接口都没问题，问题在中间这一层**。 ### 已改（0.3.5） - `toOpenAiMessages()` 改 async，接 `resolveImage`：`ImageBlock` → `{type:'image_url', image_url:{url:'data:;base64,…'}}`； - `src/index.ts` 用 `ctx.get('attachments')` 接宿主附件服务（`readImageRequest()`）； - 只在模型 `inputModalities` 含 `image` 时解析；`offloaded` / 解析失败 / 没有附件服务 → **退回纯文本**（老行为）； - 压缩：长边 1568 px、单张 1 MiB（`requestImageTarget()`），小图不放大； - 计价仍报 0（产品决定：倍率表只按文本 token 计），注释已改，别按「没发图」理解。 ### 验证 - 单测：文本 + 图保序、无解析器 / offloaded / 失败降级、纯文本仍是字符串、尺寸上限； - 真机：`toOpenAiMessages` 产出的 messages 直接打小浣熊 → 200，思维链正确描述红底黄圆。 --- ## 🟢 #0t 元数据请求带着插件名与版本号出门，比官方客户端更醒目（2026-10-27） ### 现象 用户问「插件发的指纹和客户端一样吗」。抓包对比后发现**不一样**， 而且不一致的方向是**更糟**的那个： | 请求 | 官方客户端 | 插件（修之前） | |---|---|---| | 对话（裸 `fetch`） | `user-agent: node` | `user-agent: node` ✅ | | 额度 / 目录 / 签到 / 测活（`ctx.http`） | `user-agent: node` | **`user-agent: dsh-multi-agent-gateway/0.2.2`** | 等于向网关点名「我是一个第三方反代工具，版本 0.2.2」。 ### 根因 两条 HTTP 路径的默认 UA **不一样**： - 对话走 `ctx.fetch ?? fetch`（undici）⇒ 没给 UA 时补字面量 `node`； - 其余走 `core/http.ts`，它有一行 `if (headers['user-agent'] === undefined) headers['user-agent'] = \`dsh-multi-agent-gateway/${pluginVersion()}\``。 这个默认值本身没错（自家排查有用），错在**小浣熊这条链路上客户端发的是 `node`**， 所以它在这里变成了负资产。 ### 为什么读代码差点得出错误结论 只看适配器的 `headersOf()` 会以为「我们什么都不发，那两边都是 `node`」—— **这只对了一半**。另一半（`ctx.http` 的默认值）在另一个文件里。 只抓一条请求也会漏：抓对话是 `node`，抓额度才发现是插件名。 判据：**要判断「实际发出去什么」，只能抓包，而且要按路径分别抓。** ### 怎么确认客户端到底发什么 不是看它的代码，是用**它自己安装目录里的那个 exe** 发一次： ```powershell # <安装目录> = 开始菜单里那个快捷方式指向的目录（含 商汤小浣熊.exe 与 resources\app.asar） $env:ELECTRON_RUN_AS_NODE = '1' & '<安装目录>\商汤小浣熊.exe' .scratch\capture-from-client.mjs ``` 本地 HTTP 服务器抓到的就是它主进程全局 `fetch`（Node 24 / Electron 41 的 undici） 真实发出的头：`user-agent: node` + `sec-fetch-mode: cors` + `accept-encoding: gzip, deflate`。 ### 改了什么 1. `RACCOON_USER_AGENT = 'node'`：适配器**所有**请求显式设这个 UA， 盖掉 `core/http.ts` 的默认值。 2. `RACCOON_GRANT_HEADERS`：`X-Client-Platform` / `X-Client-Version` **只在签到这一个接口**上发 —— 因为全仓查实际使用点，客户端只在 `login/points/grant`（网页端）、内容检测与手机互联上带这套头， 模型目录与积分余额用的 `fetchWithAuth` **不带**。 「为了像客户端就把四件套全发出去」恰恰不像客户端。 3. 单测三条钉住（元数据 UA、只有签到带 X-Client-*、常量取值）， 并做了反向验证：撤掉修复后正好这 3 条变红，其余 37 条不受影响。 ### 还差什么（**别把这当成「已经不会被风控」**） - **官方客户端的对话请求不是 Electron 发的**，是 `box-agent-acp.exe` （PyInstaller 的 Python 包，`httpx` + OpenAI/Anthropic SDK）。 它的 UA 与 `x-stainless-*` **没抓到样本** ⇒ 「对话与官方逐字节相同」不成立。 - 结构性的那一条改不掉：**插件与客户端共用同一个 token、同一个出口 IP**。 同时用就是「一个账号、两套 HTTP 栈交错发请求」。 - 真正决定风控的是**行为**（节奏、并发、上下文形态、消费曲线）， `rateLimitPerMinute` / `maxConcurrentRequests` 比头重要得多。 --- ## 🟢 #0r 商汤小浣熊的 usage 帧比 finish 晚 0.5–3.7 秒，token 统计永久为空（2026-10-27） ### 现象 新接入的商汤小浣熊平台，日志里「输入 / 输出 / 速度」三列**恒为 `—`**， 倍率却是对的。同样的症状用户以前报过（#0g 那条「速度/输入/输出为 —」）。 ### 根因 `src/llm/adapter.ts` 的 `USAGE_DRAIN_MS` 是**全局常量 250ms**。这个值是按 Qoder 调的 —— Qoder 的 usage 帧比 finish 晚 **17ms**，250ms 有十几倍余量。 但小浣熊在网关侧要等计费算完才补这一帧，本机 8 次采样： | 间隔 | 样本 | |---|---| | finish → usage | 472 / 1421 / 1970 / 2315 / 2515 / 3418 / 3709 / 3744 ms | 最小 472ms、最大 3744ms、**均值 ≈ 2.4s** —— 全在 250ms 窗口之外， 所以这一帧**永远收不到**，`settle()` 拼采样时 `usage` 仍是 `undefined`， `inputTokens` / `outputTokens` / `tps` 三个键根本不出现。 ### 为什么不能直接把常量调大 调到 5s 的话，Qoder 这类只晚 17ms 的平台**每一轮**收尾都要多挂最多 5 秒 （用户看到的：字都出完了还在转圈）。这是**每一轮**的代价，不是偶发。 ### 改了什么 1. `AgentCapabilities` 新增 `usageDrainMs?: number`（`src/core/types.ts`）—— 窗口是**平台事实**，由适配器声明，核心层照办。不填 = 用默认 250ms。 2. `pump()` 改读 `adapter.capabilities?.usageDrainMs ?? USAGE_DRAIN_MS` （`src/llm/adapter.ts`）。**可选链是必须的**：第三方运行期注册的鸭子类型 适配器可能真没有 `capabilities`，少一层就是 `TypeError` 打断整轮对话。 3. 商汤小浣熊适配器声明 `usageDrainMs: 5000`（实测最大值 + 三成余量）。 ### 怎么验证的 - 单测 `test/request-log-sampling.test.mjs` 三条：慢平台收得到、快平台不被拖、 缺 `capabilities` 不崩； - 真机 `test/live-raccoon.mjs`：经 DSH LLM 适配器装配跑一轮，断言 `usage` 透到 DSH、采样里 `outputTokens > 0`、`tps` 有值。 实测结果：修复前 `in/out=undefined/undefined tps=—`， 修复后 `in/out=32/47 tps=9.4`。 ### 还差什么 无。真机确认过（2026-10-27）。 --- ## 🟡 #0s 商汤小浣熊：视觉能力只按实测标了 1 个模型（2026-10-27） ### 现状 目录里 `tags` 含 `vision` 的模型有 6 个，但本适配器只给 `sn-deepseek-v4-1-flash-1017` 标了 `inputModalities: ['text','image']`。 理由是实测结果不一致： | 模型 | 发 1×1 PNG data URI | |---|---| | `sn-deepseek-v4-1-flash-1017` | 200 | | `sn-glm-5-3`（tags 里有 `vision`） | **400** `rejected by an internal MaaS component` | 所以**没有按 tag 猜**。`inputModalities` 缺省 = 只有文本，这是安全的缺省 （DSH 不会把图片塞进一个不收图片的模型）。 ### 还差什么 另外 8 个模型没测过视觉。要放开的话，得逐个真发一张图片看状态码， 再往 `src/adapters/raccoon.ts` 的 `VISION_CAPABLE` 里加。**别拿 tags 当依据**。 --- ## 🟡 #0q 请求日志把「每条失败」都记成「免账号」，原因只藏在悬停里（2026-10-27） > 用户原话：「有的用户用插件出现了这个错误，是授权过期了吗？」 > （附一张请求日志截图：11 行失败，账号列全是「免账号」，结果列全是「失败」） ### 现象 用户拿一张日志截图来问「是不是授权过期」。**这张图无法回答这个问题**， 而且不是用户截得不好 —— 是界面把该有的信息全抹掉了： | 该看到 | 实际看到 | |---|---| | 是哪个号失败了 | 「免账号」 | | 是鉴权失效 / 限流 / 风控 / 额度 | 只有「失败」两个字 | | 上游原话 | 只在 `title` 里 —— **截图带不出来** | 后果最坏的一层：截图里的「免账号」看起来像「这些平台压根没配账号」， 于是排查方向被引到「重新登录」上去，而真实原因可能是限流。 ### 三个根因 **① 宿主把每条失败都记成 `accountId: null`（真 bug）** `src/llm/adapter.ts` 里 `accountId` 只在**成功之后**才赋值： ```ts let accountId: string | null = null // 先声明 null if (!outcome.ok) { failureMessage = ...; settle(false); return } // ← 这里就结算了 accountId = outcome.accountId ?? null // 成功才走到 ``` `settle()` 读 `accountId` 时失败路径**永远还没走到赋值那行**，于是恒为 `null`。 本机 654 条真实日志实测：`ok=false` 的 23 条里 22 条 `accountId === null`； 唯一有值的那条是「路由成功后才断流」（`读取上游流失败：terminated`）—— 它反证了上面的判断：**先成功赋值、后断流**，账号就记下来了。 **② 界面把 `null` 无条件翻成「免账号」** ```js const accountText = (id) => (id === null || id === undefined ? '免账号' : ...) ``` `null` 在这个字段上其实有**两种**含义（免账号通道 / 根本没记）， 被压成一句话。而「免账号」这个措辞会主动误导：它说的是「不需要账号」。 **③ 原因只放进 `title`** ```js + `${badge('失败','err')}` ``` 悬停才可见 = **截图里不存在**。用户能提供的证据通常就是一张截图。 ### 已改 | 位置 | 改法 | |---|---| | `src/core/request-log.ts` | `RequestLogEntry` 新增 `errorKind?: ErrorKind`；`accountId` 注释写明两种 `null` | | `src/llm/adapter.ts` | 失败分支 `accountId = outcome.attempts.at(-1)?.accountId ?? null`；新增 `failureKind` 并在 `settle()` 里写 `errorKind`；流中途报错也记 `errorKind` | | `client/client.js` | 新增 `accountCellHTML()`（三态）与 `resultCellHTML()`（分类徽标 + 内联原因）；新增 `FAILURE_TONE` 映射；「最近失败」卡也换成这两格，并加「结果」列 | | `client/client.js` | 删掉 `overviewHTML` 里那份重复的 `accountText` —— 它是「一律免账号」的第二处来源 | | `client/client.js` | CSS 新增 `.mag-fail-cell` / `.mag-fail-why`；表头说明改成「原因直接写在结果格里」 | 三态判定（`accountCellHTML`）： | 条件 | 显示 | 含义 | |---|---|---| | 有 id | 账号标签 | 确定是哪个号 | | `null` + `FREE_ONLY[agentId]` | 「免账号」 | 真的不需要账号（OpenCode） | | 其它 `null` | 「未记录」+ 悬停解释 | 老记录，或请求在选到账号前就失败 | 分类色调（`FAILURE_TONE`）—— 按**用户要做什么**分，不按严重程度分： | 分类 | 色调 | 用户要做什么 | |---|---|---| | `auth` / `quota` / `risk_control` | 红 | 重新登录 / 充值 / 换号 | | `rate_limit` / `server` / `network` / `unknown` | 黄 | 等一会儿 | | `bad_request` / `not_found` / `unsupported` | 中性 | 换号也没用 | ### 验证 - **604 宿主 + 81 客户端**全绿（新增 5 条宿主 + 3 条客户端）。 - **反向验证**： - 把 `accountId = outcome.attempts.at(-1)…` 改回 `null` → 「失败时也要记下哪个账号」红 1 条； - 从 `settle()` 删掉 `errorKind` → 「失败分类必须进采样」「流中途报错」红 2 条； - 把 `accountCellHTML` 的第三态改回 `'免账号'` → 「账号列三态」红 1 条。 - **真实日志回放**（把本机 `requests.jsonl` 的失败行喂进新的渲染函数）： ``` workbuddy-intl => 账号: 未记录 结果: 失败 | 连接上游失败：fetch failed qoder => 账号: qoder-账号 结果: 触发限流 | 上游排队中（p3 队列），约 30 秒后重试 opencode => 账号: 免账号 结果: 失败 | boom qoder-cn => 账号: qoder-cn:主号 结果: 鉴权失效 | 凭证缺少 uid，加密通道无法签名 ``` 第二条正是本次要解决的形态：以前它是「免账号 / 失败」， 现在能直接读出「qoder-账号被限流了，等 30 秒」。 ### 还差 1. **老记录补不回来** —— 已经写进 `requests.jsonl` 的失败行仍然是 `accountId: null`。 界面显示「未记录」而不是瞎猜，这是有意的。要清掉旧记录用日志页的「清空」。 2. **`errorKind` 只在本次改动之后才有** —— 老记录退回「失败」两个字。 3. **没在真机上看过新表格的排版** —— 原因内联后「结果」列变宽， 窄屏下会不会把表格挤坏，要真机确认（`max-width:260px` + 省略号是兜底）。 4. 顺带记一笔：`requests.jsonl` 里 `accountId: null` 的行**不代表**平台没配账号。 判断「有没有配账号」要看账号页或 `state.json`，不要从日志推。 --- ## 🟡 #0p 账号被风控后不会自动换号（2026-10-27） > 用户原话：「现在这个做的有账号如果被风控以后，自动切换其他账号吗？」 ### 现象 会换，但**只覆盖一半**。实测（改之前）： | 上游返回 | 判定 | 换号 | |---|---|---| | 429 限流 / 排队 | `rate_limit` | ✅ | | 403 风控 | `auth` | ✅（但文案被覆盖，见下） | | 401 / 402 / 403 额度 | `auth` / `quota` | ✅ | | **400 风控** | `bad_request` | ❌ **不换** | 八个常见 400 风控文案**全部**落到 `bad_request`： ``` 400 "risk control" -> bad_request ❌ 400 "abnormal request" -> bad_request ❌ 400 "verification required" -> bad_request ❌ 400 "device fingerprint mismatch" -> bad_request ❌ 400 "your account has been banned" -> bad_request ❌ 400 "account suspended" -> bad_request ❌ 400 "suspicious activity" -> bad_request ❌ 400 "please complete the captcha" -> bad_request ❌ ``` `bad_request` 的语义是「请求本身有问题，换号也一样错」⇒ 直接放弃。但风控恰恰是**账号维度**的问题，换号是对的。 ### 三个根因 **① `errors.ts` 的 400 分支没有风控这一类** 只兜了额度 / 鉴权 / 限流三类文案，风控不在其中。 **② 风控不能复用 `auth` —— DSH 会覆盖文案** DSH 的 `failureMessage()`（`app.asar` 内实测）： ```js function failureMessage(message, code, t) { if (code === "QUOTA" || code === "ACCOUNT_QUOTA") return t("message.failure.quota"); return code === "AUTH" ? t("message.failure.auth") : message; } ``` 只要 kind 报成 `auth`，上游那句「检测到异常请求，请完成验证」会被**整句丢掉**， 用户永远看到「API 密钥无效」—— 跟密钥一点关系都没有，用户会跑去重新登录、重贴 token。 所以风控必须有**自己的** kind：既能换号，又能让上游原话透到界面上。 **③ 流式路径完全没认风控，还有静默吞帧** - 流式走 `classifyStreamError()`，与非流式的 `classify()` **各自独立**。风控落在流里仍判 `server` ⇒ 白重试 5 次 + **账号不降权** ⇒ 下次还挑中它。 - `translateChunk()` 对「既无 `choices` 也无 `error`」的帧直接丢弃。实测： ``` {"error":{"code":"risk_control",...}} -> error/server {"code":"RISK_CONTROL","message":"..."} -> error/server {"code":"RISK_CONTROL","data":{...}} -> （空，被吞掉） ``` 第三条只要上游换个字段名，整帧就凭空消失，用户看到「回复是空的」。 ### 已改 - 新增 `ErrorKind: 'risk_control'`；`shouldSwitchAccount` 纳入它，**`isRetryable` 刻意排除它**（同号重试会把临时风控升级成封禁）。 - `errors.ts` 新增 `RISK_CONTROL_PATTERNS`（中英双语，含 `flagged for abuse`、`账号已被限制` 等），并导出 `looksLikeRiskControl()` 供流式路径复用同一套表。 - `classify()` 在 **401 / 403 / 429 / 400 / 2xx** 五个分支都认风控，且一律排在额度之后、auth 与 bad_request 之前。 - `penaltyMsFor`：风控冷却下限 `RISK_CONTROL_COOLDOWN_MS = 30 分钟`（比鉴权 10 分钟更长）；上游给了 `Retry-After` 仍听上游的，并受 `RETRY_AFTER_CAP_MS` 封顶。 - `router.ts`：风控计入降权；连续触发达 `degradeAfterFailures × 2` 直接 `markInvalid`，让界面明确显示「已失效 · 触发风控」。 - `sse.ts`：`classifyStreamError` 新增风控分支；`describeRiskControl()` 把上游原话带进文案；`translateChunk` 补兜底 —— 认不出的帧只要文案像风控就报错，不再静默吞掉。 - `llm/adapter.ts`：`providerRetryPolicy().retryableCodes` **不含** `RISK_CONTROL`（内部已换完号，再让 DSH 重试是重复撞墙）。 - `client.js`：`FAILURE_TEXT` 补 `risk_control: '触发风控'`，徽标显示成「降权中 · 触发风控（1 次）」。 ### 验证 - 端到端实测：3 个号，主号返回风控 → **自动切到第三个号成功**，主号 `state=degraded / 冷却 30m / lastError=risk_control`。 - 8 条新用例，**反向验证过**：成对回退 `errors.ts + sse.ts` → 4 条红；回退 `types.ts` → 1 条红。 - 误伤检查：`invalid parameter` / `model not found` / `context length exceeded` / `content filtered` 全部仍判 `bad_request`，未被误判成风控。 ### 有意不认的形态 Cloudflare 的 `Access denied` / `error code: 1020` / `Attention Required!` 保持 `auth` 不动 —— 那是按 **IP/ASN** 封的，换号**无效**，判成风控会让每个号都被降权 30 分钟， 误导用户以为号都坏了。这类只能换出口 IP。 ### 还差 - 没在真机上确认（要重启 DSH 才能加载新 `lib/`）。 - 风控文案表是**经验性的**：上游若用完全没见过的措辞，仍会落到 `bad_request`（不换号）。 宁可漏判也不误伤 —— 误判会让好号被无谓锁 30 分钟。遇到新的真实文案时往 `RISK_CONTROL_PATTERNS` 里补一条即可。 --- ## 🟡 #0o 多账号分不清「哪个号被限流」、也分不清「哪个开关是不让它参与选号」（2026-10-27） > 用户原话：「现在同一个平台多账号，假如有一个账号被限流了，不能明确知道哪个账号被限流。同时不知道账号对应的那些按钮，哪个是启用账户，哪个是把账户不参与选号。」 ### 现象 同一平台下挂 3 个号，其中一个被上游限流。界面上： 1. **看不出是哪个号**。账号行只画「降权中（2 次失败）」，「触发限流」「额度耗尽」「鉴权失效」三种原因在屏幕上**长得一模一样** —— 而处置办法完全不同：限流等一会儿就好，额度耗尽要换号或充值，鉴权失效必须重新登录。 2. **看不出为什么**。`AccountHealth.lastError.kind` 与 `penaltyUntil` **一直都在快照里**，界面从来没读过。 3. **看不出什么时候恢复**，只能反复点「测活」猜。 4. **「启用」按钮根本不存在**。账号行只有「对话 / 签到 / 任务」三个开关，`enabled` 没有对应按钮 —— 想「先别用这个号」只能删号，而删号会连带清掉健康与额度缓存，还得重新登录。 5. **「对话」这个标签太含糊**，看不出它其实是「不参与选号」。 ### 根因 不是数据缺失，是**渲染层从来没消费这些字段**。三处漏点： | 漏点 | 位置 | 后果 | |---|---|---| | `healthView()` 不读 `lastError` / `penaltyUntil` | `client/client.js` | 降权原因与恢复时间全丢 | | 账号行没有 `enabled` 开关 | `accountCard()` | 只能靠删号表达「先别用」 | | 「最近失败」表没有账号列 | `overviewHTML()` | 看到「触发限流」却不知道是哪个号 | 第三处尤其隐蔽：`RequestLogEntry.accountId` 一直都有，日志页也画了账号列，**只有总览的「最近失败」表漏了**。 ### 已改 - `healthView()` 新增 `FAILURE_TEXT` 映射（与宿主 `ERROR_LABELS` 同口径），徽标直接写原因：`降权中 · 触发限流（2 次）`；悬停给出完整证据链（原因 / 上游原话 / 发生时间 / 恢复时间 / 上次成功）。 - **冷却已过但失败计数没清** → 说「已恢复」，不再画成「降权中」。`accounts.available()` 只看 `penaltyUntil`，冷却一过这个号就在正常接请求了，继续画「降权中」会让用户白等。 - 账号行补 `enabled` 总开关，文案改为「启用」；`routeChat` 文案从「对话」改成「参与对话」并加悬停说明。两者层次写进卡片头：总开关 → 只关选号 → 单件事开关。 - 停用账号整行压暗（`data-off`）+ 单独「已停用」徽标。 - 平台页签直接标出「N 限流 / N 失效 / N 停用」，不用挨个点进去找。新增 `.mag-tag-warn` 样式。 - 「最近失败」表补「账号」列，`accountId` 翻译成标签；`null` 显示「免账号」。`accountLabelMap()` 提到模块作用域，与日志页共用同一映射。 ### 验证 - 7 条新用例。**已确认它们在旧代码上全红、在新代码上全绿**（`git stash push -- client/client.js` 后重跑，7 条全 `not ok`）。 - 宿主 591 / 客户端 78 / 冒烟全通过。 ### 还差 - 没在真机上确认（要重启 DSH 才能加载新 `lib/`）。 - `client.js` 里没有周期重绘：冷却到期后徽标**不会自动**从「降权中」变成「已恢复」，要等下一次 `refresh()`（切页 / 点刷新）。当前靠悬停里的绝对时间兜底，够用但不完美。 --- ## 🟡 #0n 压缩对话崩在 `imageRequestPricing is not a function`（2026-10-27） > 用户原话：「压缩对话时提示 `compact this.adapters.get(...)?.adapter.imageRequestPricing is not a function`」 ### 现象 DSH 0.2.1 下点「压缩对话」（或触发自动压力压缩）直接失败，报错里带着宿主的源码片段： ``` compact this.adapters.get(...)?.adapter.imageRequestPricing is not a function ``` ### 根因（我们少实现了两个方法） DSH 0.2.1 给 `LlmAdapter` 加了两个**图片相关**的方法： | 方法 | 宿主怎么调 | 缺了会怎样 | |---|---|---| | `imageRequestPricing(provider, model)` | `dsh-token-meter` 的 `measure()` → `_routeImagePricing()` → `this.adapters.get(provider)?.adapter.imageRequestPricing(...)` | 抛 `is not a function` | | `imageRequestTarget(provider, model, image)` | `this.registration(provider).adapter.imageRequestTarget(...)`，截图类调用方用 | 抛 `is not a function` | ⚠️ **宿主用的是鸭子类型**：`registerAdapter()` 只校验 `providerInfo()`，其余方法一个都不验。 所以缺方法**装载期完全不报错**，一路跑到真正调用时才炸 —— 而「真正调用」的第一现场就是 压缩对话（token meter 要按路由给图片计价）。 ⚠️ **这是「结构化实现」的固有代价**：`createLlmAdapter()` 刻意不 `extends LlmAdapter` （见 `src/llm/adapter.ts` 头注释），好处是版本漂移不会变成 `ERR_MODULE_NOT_FOUND`， 代价就是**宿主加方法时我们收不到任何信号**。同类坑 2026-10-20 已经踩过一次 （`providerRetryPolicy` 那次是静默退回默认值，没崩）。 ### 已改 - `src/llm/adapter.ts` 补上 `imageRequestPricing()` 与 `imageRequestTarget()`； - `imageRequestPricing` 返回 `{ priceImages(images) }`，**每次出现一条价**（宿主的 `priceSurface` 会断言条数严格相等，少一条直接抛），且： - `visualTokens: 0` —— 本网关出站**从不发图**（`toOpenAiMessages()` 只拼 `type === 'text'`， 图片块整块丢掉），收视觉费是凭空多算； - `text: ''` —— 出站也不写占位文本，写了就是给计量凭空加几十 token； - `imageRequestTarget` 原样返回 DSH 归一化后的宽高与字节数（本网关不缩放，与基类默认一致）； - `test/unit.test.mjs` 新增 3 条回归断言：**宿主会调用的 8 个方法一个都不能缺**、 图片计价条数与取值、尺寸原样返回。 ### 验证 - `node --test`（10 个套件 571 项）+ `test/client.test.mjs`（71 项）+ `test/smoke.mjs` 全绿； - 用宿主**真实的** `dsh-token-meter/lib/types/route-pricing.js` 的 `priceSurface()` 跑通， 带图节点不再按结构体积收费（结构价 40 → 只剩空文本块固定开销 4）； - 复现脚本留在 `.scratch/repro-image-pricing.mjs`、`.scratch/repro-price-surface.mjs`。 ### 还差 真机点一次「压缩对话」确认（`lib/` 已重建，插件目录是符号链接指向本仓库， 重启 DSH 即生效）。 ### ⚠️ 一条要一起改的地方（别只改一半） 将来真要让上游看图，必须**两处一起改**：`toOpenAiMessages()` 产出 `image_url` 数组 + `imageRequestPricing()` 按上游视觉规则算 token。只改一处 → token 计量与实际请求对不上。 --- ## 🟢 #0k 六个平台的签到 / 额度 / 模型调用按参考实现对齐（2026-10-19） > 用户原话：「把我们所有平台的实现方案，均参考 dsh-our-free-model 来实现， > 这个是一个已经跑通的插件，可以直接参考。尤其是签到，模型调用等等」 参考实现在 `E:\AIProject\DeepSeekPlugin\.scratch\dsh-our-free-model`（仓库外，MIT）， 真正源码在 `vendor/channel-pack/src/*.ts`（144 个文件）。**它把「踩过的坑和为什么」 写在模块头注释里 —— 那是它最有价值的部分，本轮几乎所有结论都出自那些注释 + 真上游验证。** ### 本轮补齐的能力（之前全是 `supported: false`） | 平台 | 签到 | 额度 | 说明 | |---|---|---|---| | Qoder / Qoder CN | ✅ 新增 | ✅ 新增 | `/sash/api/v1/me/campaigns` + `/sash/api/v2/me/usage` | | WorkBuddy（国内） | ✅ 新增 | ✅ 新增 | 国内有签到；国际版**没有**签到接口 | | WorkBuddy Intl | 按上游如实 false | ✅ 新增 | 余额两个版本都有，别因为「没签到」推断没余额 | | Trae | ✅ 新增 | ✅ 新增 | 从骨架升级为真实现 | | OpenCode | 本就是真实现 | 本就是真实现 | 官方 Console 没有签到接口（探测到才升级） | ### ★ 三条与参考实现说法**不符**的实机结论（以实机为准） 1. **Qoder 的 machine 头不是必需的。** 参考实现声称必须带 `Cosy-MachineToken` + `Cosy-MachineType`，否则只回 1 条 `VIEW_DETAILS`。本机实测（真实账号）： 仅 `Cosy-ClientType: '10'` 就回 2 条含 `CLAIM_BENEFIT`；加了 machine 头结果**完全相同**。 ⇒ 不实现 machine 头（本机那个身份来自 `runtime-info.exe`，与账号无关，加了只增加失败面）。 但 `Cosy-ClientType` 必须是 `'10'`：用 `'5'` 时 `campaigns` 恒为空。 2. **Qoder「回放响应不含 benefit」是错的。** 参考实现说 `replayed:true` 时不含 `benefit`。 本机真实响应**含**（`replayed:true` + 完整 `benefit` + 旧的 `claimedAt`）。 这条危险在它恰好让两个"看起来对"的写法都变错： 「有 benefit 就算成功」→ 每次谎报 +100；「没 benefit 就算回放」→ 本机永远不成立。 ⇒ **判据只能是 `replayed` 布尔字段本身。** 3. **`VIEW_DETAILS` 纯展示活动也带 `claimStatus:"CLAIMED"`。** 所以「先按 `actionType === 'CLAIM_BENEFIT'` 过滤」是**承重的** —— 不先过滤，会在从没有过每日领取的账号上谎报「已领」。 ### 本轮修掉的真实缺陷（都不是新功能，是错的） | 缺陷 | 后果 | |---|---| | 签到幂等键用 **UTC 日**而非 UTC+8 业务日 | 每天 00:00–08:00（UTC+8）算成两天 ⇒ **跨零点重复领取** | | 「今天已签」被当成「今天已处理」 | Qoder 活动 10:00（UTC+8）才刷新，上午看到的 CLAIMED 属昨天 ⇒ **每天静默漏领 100 积分** | | 额度耗尽的冷却 30 分钟（参考 24 小时） | 空钱包账号被反复选中、反复 402 | | `retry-after` 没有封顶 | 上游给 12 小时就锁 12 小时，UI 分不清「在等」与「卡死」 | | `retry-after` 负数被 `Date.parse` 当 ISO 年份 | 抹成 0 = 「立即解除」⇒ 刚落限流的账号马上被重选，**无限空转** | | 思考档位选择器写死 4 档（`off` 在主流档位表上是非法值） | 用户一选就 **400**，整轮对话不可用 | | `reasoningEffort` 声明了却从不写进 payload | 用户选了档位，请求里**根本不带** ⇒ 静默丢弃 | | OpenCode 额度错误按状态码判 | `FreeUsageLimitError` 带 403 时误判成 `auth` ⇒ 报「密钥无效」而账号其实好的 | ### ★ 一条新增的契约（`CheckInResult.coversToday`） 「今天已领」这句话**天然有歧义**：它只说明「服务端现在认为没有可领的了」。 在**活动按日定时刷新**的平台上，刷新前看到的「已领」属于**昨天那一轮**。 修法**不是**在核心层配一张「各平台刷新时刻表」（必然漂移），而是让**看得见该平台 刷新语义的那一层**自己回答 —— 新增 `coversToday`（缺省 `true`）与 `actionRequired`： - `coversToday === false` ⇒ 记账层**故意不记**，当天稍晚会自动重试； - `actionRequired === true` ⇒ 「你得先去别处操作」（如未开通每日领取），重试无用， UI 必须**单独、醒目**地展示，且判的是**布尔字段**不是 message 文案。 ### 验证 - **真上游**：Qoder CN 额度读到真值 `remaining: 858`（取自 `addOnQuota`， `userQuota` 实测恒为 0 的占位）、签到正确识别「今天已领取」且**没误报 +100**、 对话通（`dfmodel` → 「你好」，思维链也透出）；OpenCode 免费层零凭证实测通。 - **单测**：127（核心）+ 38（客户端）+ 227（各适配器/推理/记账）+ 冒烟，全绿。 - ⚠️ **WorkBuddy 与 Trae 没有真上游验证**（本机没有这两家的账号）—— 它们的解析规则只用参考实现里的**真实样本**做 fixture，尚未对过真上游。 ### 思考档位这条链（第二轮补齐，2026-10-19） 「模型调用」不只是把请求转发出去 —— **用户能不能调思考强度**也在这条线上。 第二轮发现并修掉了三处断点，它们各自都能让档位「看起来有、其实没用」： | 断点 | 后果 | |---|---| | 适配器从不把目录里的 `thinking_config.enabled.efforts` 报进 `ModelMeta` | 选择器里**一个档位行都没有**（参考实现把这记为用户报障） | | 核心层写 `payload.reasoning_effort`，Qoder 只读 `payload.reasoning` | 用户选了档位，**请求里根本不带**，静默按默认档跑 | | 档位行被包在 `if (meta.reasoning === true)` 里 | `is_reasoning:false` 但有档位的模型（CN 的 `performance`）**档位行被吞掉** | 还有一处**保真度**问题：目录里逐条抄了官方客户端的 `is_default`（`dfmodel` 是 `max`）， 但没上报给核心层，于是核心层用启发式猜了一个 `low` —— 同一个模型在插件里「想得更少」， 而用户完全看不出差别。现在规则是**上游声明的默认优先于启发式**。 **TRAE 也有同型的两处**（第三轮补齐）： | 断点 | 后果 | |---|---| | 目录解析早读出了 `reasoning_effort_config`（连合并规则都实现了），但适配器只压成 `reasoning: true` | 档位本身**从没进过 `ModelMeta`**，选择器里没有档位行 | | `buildOpenAiBody` 把 `reasoning_effort` 丢掉了（注释还写着「由 DSH 下发」，但没有任何地方在下发） | 用户选了档位，**请求里根本不带** | ⚠️ TRAE 的档位是**私有 wire 值**（`light` / `high` / `extra_high`）， 而 OpenAI 客户端只会说那 8 个规范名 —— 这正是 `core/reasoning.ts` 那张强度序表 存在的理由：**网关承担翻译**，适配器如实报 wire 值，核心层负责换算。 真上游验证（`.scratch/verify-effort-chain.mjs`，同一模型带档位 vs 不带）： ``` dfmodel 选择器行=[none,low,high,max] defaultEffort=max ← 与目录声明一致 qmodel_38max 选择器行=[none,low,medium,xhigh] defaultEffort=xhigh performance 选择器行=[none,low,medium,high,xhigh,max] defaultEffort=medium ← 曾被吞掉 带档位 → 加密请求体 1320 字节，思维链 30 字 不带档位 → 加密请求体 1256 字节，思维链 135 字 （字节数不同 = 档位真的进了加密请求；思维链长度不同 = 上游真的按档位跑了） ``` --- ## 🟡 #0i Qoder 对话报「解不出 user_id」—— uid 从没被存下来 > 报障原话：现在对话还是不可以，提示「本轮运行失败 API 密钥无效」。 > （修完 #0f 后真实报错露出来了：`token 里解不出 user_id，无法生成签名`。） ### 根因 Qoder 设备码登录给的是 **`dt-...` 这样的不透明设备令牌，不是 JWT**。 而加密推理要用 `uid` 派生 `encrypt_user_info` —— 这个 `uid` **不在 token 里**， 它在**登录响应的 `user_id` 字段**里（参考实现 `dsh-our-free-model` 的 `parseQoderTokenPayload` 读的就是它）。 我们的 `pollLogin()` 只存了 `token` / `refreshToken` / `expiresAt`， **把 `user_id` 丢了**；`clientFor()` 于是拿设备令牌去当 JWT 解，永远解不出 uid。 > 值得记一笔：`dsh-our-free-model` 的 `ensureUid()` 在缺 uid 时**明确报错** > 而不是发一个必然失败的请求 —— 它的注释写着「否则服务端回 > `Signature invalid (101)`，用户看到的是『签名错误』而非『凭证不完整』，极难定位」。 > 我们这边是把错误露出了，但根因同样在「凭证不完整」。 ### 已改的地方 | 文件 | 改动 | |---|---| | `src/adapters/qoder.ts` | `pollLogin()` 把响应的 `user_id` 存成 `credentials.uid`。 | | `src/adapters/qoder.ts` | 新增 `uidOf()`：**优先用凭证里存的 uid**，其次才尝试 JWT 解析（手工粘贴 JWT 的老路径仍然可用）。 | | `src/adapters/qoder.ts` | 新增 `resolveUid()`：老账号（早期版本漏存）**不用重新登录** —— 问一次不需要 WASM 签名的用量接口把 uid 补回来，并通过 `ctx.onCredentialsRefreshed` **回写**，下次直接命中。 | | `src/adapters/qoder.ts` | 新增 `findUserId()`：按 `userId` / `user_id` / `uid` 递归找（两个端点的形状不同）。 | | `test/unit.test.mjs` | +2 条：登录响应里的 `user_id` 必须存成 uid；`findUserId` 对两种真实形状都认。 | ### 补 uid 用的是哪个端点（实测 2026-10-19） 两个都**只认 `Bearer `，不需要 WASM 签名**，返回的 uid 一致： ``` 200 https://openapi.qoder.com.cn/sash/api/v2/me/usage → .qoderUsage.userId 200 https://openapi.qoder.com.cn/sash/api/v1/me/campaigns → .uid ``` 真机验证（`.scratch/verify-uid-backfill.mjs`）： ``` 账号 qoder-cn:qoder-cn-账号：token=dt-EXAMPLE-NOT-A-… uid=null 200 /sash/api/v2/me/usage → uid="00000000-0000-4000-8000-000000000001" 回写后账号里的 uid："00000000-0000-4000-8000-000000000001" 回写后校验：ok=true ✓ 老账号的 uid 能靠上游补齐并回写，不需要用户重新登录 ``` --- ## 🟡 #0j Qwen3.8-Max 的倍率不对：应是 ×0.5，显示成 ×0.2 > 报障原话：Qwen3.8-Max 倍率不对，正确倍率是 x0.5。 ### 根因 `price_factor` 是**采集那一刻的生效价**，会随错峰窗口变化。`Qwen3.8-Max` 的 `promotion` 是「22:00–08:00、4 折、原价 0.5」——目录里存的 `0.2` 是**窗口内的折后价**； **窗口外（白天）正确倍率是原价 ×0.5**。 上一轮我把 `price_factor` 直接当倍率显示，白天就显示成了 ×0.2。 ### 参考实现怎么算（`dsh-our-free-model` 的 `qoderDisplayName` / `promotionActiveNow`） ``` 窗口内：beforePromotionPriceFactor × discountFactor （折后价） 窗口外：beforePromotionPriceFactor （原价） 无促销：priceFactor ``` 并且**不采信目录的 `promotion.active`**（那是下发时刻的快照，客户端不重启就会过期）， 而是按 `windowStart`/`windowEnd` **本地推算**（UTC+8，支持跨零点）。 ### 已改的地方 | 文件 | 改动 | |---|---| | `src/adapters/qoder.ts` | 新增 `promotionActiveNow()`（逐字对齐参考实现）、`isPromotionActive()`、`effectiveMultiplier()`；`getModelMetaList()` 改用 `effectiveMultiplier()`。 | | `src/adapters/qoder.ts` | 折扣生效时在 `description` 里写清「原价 ×0.5 → 现价 ×0.2」。 | | `test/unit.test.mjs` | +1 条：窗口内 0.2 / 窗口外 0.5 / 跨零点窗口 / 无促销模型不受影响。 | ### 验证 ``` 现在 UTC+8：17:44 Qwen3.8-Max：窗口内=false 倍率=×0.5（期望：白天窗口外 ×0.5）✓ 22:00 UTC+8 → 0.2 ；10:00 UTC+8 → 0.5 ``` --- ## 🟡 #0f 选了 Qoder 模型对话报「API 密钥无效」 > 报障原话：我选择了 Qoder CN 的 deepseek 模型保存后，使用此模型进行对话，提示「本轮运行失败 API 密钥无效」。 ### 根因（两处，缺一不可） 1. **账号的「对话」开关是关的**。`requests.jsonl` 里两条记录写着 `「qoder-cn」下没有可用账号`。查账号文件：那个账号 `routeChat: false`， 而 `accounts.routable()` 的判据是 `routeChat !== false` → 直接被排除在对话路由之外。 2. **错误被归成 `auth`**，DSH 把 `code === 'AUTH'` 直接渲染成「**API 密钥无效**」 （`dsh-client-ui-chat` 的 `message.failure.auth`）—— 用户明明刚登录成功， 却被指向「密钥」这个完全错误的方向。 ### 为什么「对话」开关会变成关的 `publicAccount()` 原来把 `routeChat` **原样透传**：登录新建的账号这个字段是 `undefined`，界面 `toggle('对话', 'routeChat', account.routeChat)` 判的是 `on === true` → **画成「关」**。 但路由的真实语义是 `!== false` → **参与对话**。 > 界面显示的正好是真实行为的**反面**。用户看到「对话」是关的，本能地去点它 —— > 点一下把 `undefined` 写成 `true`（其实没变），再点一下写成 `false`（真关上了）。 > 于是「本来能用」变成「不能用」，而且报错还说成密钥无效。 ### 已改的地方 | 文件 | 改动 | |---|---| | `src/runtime.ts` | `publicAccount()` 里三个开关全部返回**生效值**：`routeChat: record.routeChat !== false`、`autoCheckIn: tasks.checkInEnabledFor(record)`、`autoTasks: tasks.enabledFor(record)`。界面从此和路由同口径。 | | `src/core/router.ts` | 新增 `describeNoCandidate()`：按现状分情况给话术（还没有账号 / 全被停用 / 对话开关是关的 / 凭证失效 / 已无其它号可换），每种都点名去哪儿点哪个开关。 | | `src/core/router.ts` | 归类 `auth` → **`unsupported`**：配置没就绪不是凭证无效，DSH 会原样显示我们的话术而不是「API 密钥无效」。 | | `test/unit.test.mjs` | +3 条：对话开关关掉时的归类与话术、停用/失效各自的话术、账号快照给生效值。 | ### 验证（真机已过） `.scratch/verify-round3.mjs`（读**真实账号文件** + 真实上游）： ``` 账号文件：解密成功，共 1 个 - qoder-cn / Qoder CN 账号：routeChat 存储=true → 生效=true qoder-cn 对话候选：1 个 qoder-cn:qoder-cn-账号 「有账号但停用」的结论：kind=unsupported message=「qoder-cn」的 1 个账号都被停用了 —— 到「账号」页重新启用 ``` --- ## 🟡 #0g Qwen3.8-Max 被标成「免费」 > 报障原话：Qoder CN 账户添加进来以后，为什么 Qwen3.8-Max 模型也显示免费。 **根因**：把目录里的 `is_free` 直接当成「免费」用了。 `is_free` 的真实含义是「**免费额度模型**」—— 它**照样按倍率扣积分**，只是额度由免费档供给。 真正零成本的只有 `qfmodel`（Qwen3.8-Flash，`price_factor: 0`）。 **已改**：`src/adapters/qoder.ts` 的免费判据改成**只有 `multiplier === 0`**； `is_free` 的信息不丢，写进 `description`（「免费额度模型（仍按倍率扣积分）」）。 **验证**：Qoder CN 17 个模型里只有 `qfmodel(×0)` 标免费，且 17 个模型**全都有倍率**。 > ⚠️ 本条当时写的「`Qwen3.8-Max` 该显示 `×0.2`」是**错的**（那是窗口内折后价）—— > 正确倍率随错峰窗口变化，白天是 `×0.5`。见 **#0j**。 --- ## 🟡 #0h 打开浏览器后弹框偏移太厉害 > 报障原话：浏览器网址打开后，弹框位置偏移太厉害。 **根因**：上一轮按原型给「已打开浏览器」的状态加了左移 （`.mag-overlay[data-side="1"]{justify-content:flex-start;padding-left:6%}`）。 原型里那是为了别压住浏览器窗口，但真机上 DSH 是全屏窗口 —— 在 1920 宽的屏上左移 6% 等于把弹框甩到最左边，看起来就是「跑偏了」。 **已改**：**去掉左移**，弹框永远居中（`data-side` 属性与对应样式一并删除）。 居中是可预期的，别再为「让位」动位置。 --- ## 🟡 #0 勾选模型后保存按钮一直灰着（勾选根本没写进草稿） > 报障原话：模型列表，勾选模型后，未出现保存按钮。 > （补充确认：保存条在，但按钮一直是灰的、点不动。） **状态**：根因已定位并修好，单测覆盖了，**等一次真机刷新确认**。 ### 根因 `87b0e0a` 把界面从「React JSX 渲染」改成「投影 → HTML 字符串 → `ROOT.innerHTML`」， 但事件还挂在 React 的 jsx 属性上（`
`）。 `innerHTML` 生成的节点**没有 React fiber**，React 会把事件目标解析成最近的有 fiber 的祖先 —— 也就是根 div。这对 `click`、`input` 没问题（普通事件插件会把 监听派发到根节点上）；但 **`onChange` 走的是 `ChangeEventPlugin`**，它只在 「解析出的目标节点是 input / select / textarea」时才派发。目标变成 div 之后， **一次都不派发** —— 勾选框的 change 永远到不了 `toggleModel`。 于是： 1. 勾选框被浏览器原生勾上（视觉上「勾住了」）； 2. 草稿 `drafts` 里什么都没写； 3. `ops()` 为空 → `shell.dirty === false` → 保存按钮保持 `disabled`； 4. 用户看到的正是「勾选模型后没有保存按钮」。 同一个根因还带走了「只看免费」勾选框和上下文长度输入框。 ### 已经用真浏览器验证过这条根因 `.scratch/react-onchange/index.html` 用 React 18.3.1 的最小复现页验证了三点 （同一形状：React 渲染的 div + `ref.current.innerHTML` 写入的复选框）： | 写法 | 结果 | |---|---| | 只挂 React 的 `onChange`（旧写法） | **onChange 触发 0 次**；onClick 触发 1 次；复选框视觉上是勾上的 | | 同一面板再挂原生 `addEventListener('change')` | 触发 1 次 —— 说明事件本身有、也冒泡，是 React 不派发 | | 同一个 div 改用原生监听（新写法） | 触发 1 次 ✓ | ### 已改的地方 | 文件 | 改动 | |---|---| | `client/client.js` | 根节点改成**原生监听**：`ROOT.addEventListener('click' / 'change' / 'input')`，effect 清理时摘掉；jsx 上不再挂 `onClick/onChange/onInput`（否则合成事件 + 原生监听会把开关翻两次）。 | | `test/client.test.mjs` | 新增回归测试：根节点不许再有 React 合成事件、三个原生监听必须齐全、模拟 change 后 `shell.dirty` 必须变 true、卸载后监听摘干净。 | | `docs/MODELS.md` §6.5 | 记下「为什么必须用原生监听」，免得下次重写又踩。 | ### 验证 1. 刷新页面（客户端半边随页面重载；宿主侧改动要重启 DSH 才生效）； 2. 设置 → Free Token → **账号** → 勾一个模型； 3. 保存条应立刻变成「**1 项改动未保存**」，右侧「保存并生效」变蓝可点； 4. 点保存 → 变「已保存」，对话框模型下拉里出现该模型。 --- ## 🟡 #0b OpenCode 只拉免费模型 / 去掉「按推荐预选」 同一轮的两个行为变更（不是 bug）： - **宿主侧过滤**：`src/adapters/opencode.ts` 的 `getModelMetaList()` 只返回免费模型 （判据：价格算出来是 0，或 id 以 `-free` 结尾；没价又不带 free 的按付费过滤）。 免费判定的兜底不能在「价格源挂了」时把列表清空 —— 单测覆盖了这条。 - **客户端**：「按推荐预选 N 个」按钮已删除（`preselectModels` 一并删掉）， 「只看免费」勾选框只在平台真有付费模型时出现。 ⚠️ 宿主侧过滤要**重启 DSH** 才生效（`lib/adapters/opencode.js` 是宿主进程里已加载的模块）。 --- ## 🟡 #0c 没登录就把模型列出来，倍率全是「未知倍率」 > 报障原话：为什么 Qoder 等平台，还没登录账号就拉取到了模型，但是倍率是未知呢？太不友好了。 ### 根因 两件事叠在一起： 1. **目录提前可见**。Qoder / WorkBuddy 的 `getModelMetaList()` 用的是**产品级兜底目录** （内置在插件里的 17 / 11 条），跟账号无关；而 `runtime.modelsOf()` 在没有账号时会 拿一个**匿名占位记录**去调适配器 —— 于是没登录也照样拉出一张表。 2. **倍率没人填**。两个适配器返回 `ModelMeta` 时都没写 `multiplier`， 界面显示的就是「未知倍率」。Qoder 的兜底目录里其实**有** `price_factor`（倍率） 和 `is_free`，只是没用上。 ### 已改的地方 | 文件 | 改动 | |---|---| | `src/adapters/qoder.ts` | token 为空（= 没登录）直接返回 `[]`；有 token 时用目录的 `price_factor` 当倍率、`is_free` / `price_factor === 0` 标免费，`multiplierSource: 'qoder:catalog'`。 | | `src/adapters/buddy.ts` | 一样：token 为空直接返回 `[]`（登录前一个都调不动）。 | | `client/client.js` | 新增 `needsAccountFor()`：非免账号平台且没有账号时，模型卡片只给「先登录」引导（不拉、不列、不显示「拉取模型」）；`loadModelsIfNeeded()` 跳过这类平台，并把**账号数**放进防抖 key —— 登录成功后自动重拉。 | | `test/unit.test.mjs` | +3 条：Qoder 没 token 返回空、有 token 时倍率与免费标记正确、WorkBuddy 没 token 返回空。 | | `test/client.test.mjs` | +1 条：没登录的平台渲染「登录后自动拉取」引导，不出现模型行 / 测一次 / 拉取模型。 | ### 验证 1. **重启 DSH**（宿主侧适配器改了）； 2. 设置 → Free Token → **账号** → 切到 Qoder / WorkBuddy： 模型卡片显示「**未登录 · 登录后自动拉取**」，没有模型行、没有「拉取模型」按钮； 3. 登录（或给账号填 token）后：模型自动出现，倍率是 `×0.5` / `×0.08` / `免费` 这种， 不再是「未知倍率」。 --- ## 🟡 #0d 「测一次」没有进行中状态；免账号平台压根没开始探 > 报障原话：opencode 测试模型的可用度，点完以后，没有状态显示正在测试，用户不知道有没有测试。 ### 根因（两条，各自独立） 1. **没有行内反馈**：探测是**一次真实上游请求**（8 token、等首帧），十几秒很正常。 客户端只在页面顶部画一行 `busy` 提示，模型表格里没有任何变化 —— 用户点完看不出发生了什么，以为按钮没反应。 2. **免账号平台直接失败**：`runtime.probeModels()` 先用 `router.candidates(agentId)` 选账号，一个账号都没有就 `return { ok: false, error: '…没有可用账号' }`。OpenCode 是**免账号通道**，本来就没有账号 —— 所以「测一次」在 OpenCode 上**从来没有真正跑过**。 ### 已改的地方 | 文件 | 改动 | |---|---| | `src/runtime.ts` | `probeModels()` 选账号时**补匿名占位**（和 `modelsOf()` 同一套规则：路由账号 → 降权账号 → 匿名占位）。匿名记录会被适配器按 `freeTierMode` 自动补上免费层头。 | | `client/client.js` | 控制器新增 `this.probing`（投影里是 `probing: [...]`）：探测中该行状态列显示「测试中」、按钮变禁用的「测试中…」；工具栏显示「正在测试 N 个模型…」；同一时间只跑一轮，其余行的「测一次」一并禁掉。 | | `test/client.test.mjs` | +1 条：探测中渲染「测试中…」与进度说明、其余按钮禁用；没探测时每行都有「测一次」。 | ### 验证 1. **重启 DSH**； 2. 设置 → Free Token → 账号 → 模型表格点任意一行「测一次」； 3. 该行立刻变成「**测试中**」徽章 + 禁用的「**测试中…**」按钮，工具栏出现进度说明； 4. 几秒后变成「可用 · 612 ms」/「地区受限」/「不可用」（结论落 `probes.json`，刷新页面还在）。 --- ## 🟡 #0e 登录弹框排版重做（挤成一团 → 一屏一件事） > 报障原话：登录账号这个页面排版太丑了，优化一下。 ### 之前为什么丑 上一版把**步骤、授权链接、主按钮、状态**全塞进 `padding:13px` 的弹框里， 而且链接框和主按钮**并排**： - 主按钮「在浏览器打开」和说明「打不开？复制链接到手机…」挤在同一行， 470px 宽的弹框里换行错位，按钮显得又小又重； - URL 是 11px 等宽字塞在 `4px` 的内边距里，一行截断看不出重点； - 状态区两行小字（「有效期 5 分钟」/「每 5 秒自动检查一次」）没有层次； - 设备码（OpenCode 的 userCode）只作为一个小字塞在状态行里，用户根本注意不到。 ### 这一版的排布 从上到下一条线，每块之间 14px： 1. **标题**：`● 登录 Qoder CN` + 平台类型标签 + 右上 ✕； 2. **引导语**：一句话说清「在浏览器里完成登录，本窗口自动检查」； 3. **步骤**：两条，圆圈 + 竖连接线，完成的那步变绿勾； 4. **设备码**（只有设备码登录才有）：单独一块、16px 等宽大字 + 独立「复制」按钮； 5. **授权链接**：框外有「授权链接」小标签，框内是等宽链接 + 复制； 6. **主按钮整行**：`在浏览器打开 ↗`，说明放在按钮正下方居中； 7. **状态卡**：主状态 + **剩余 m:ss** + 一条 3px 倒计时进度条 + 次要说明； 8. **页脚**：取消在左，主/次动作在右。 弹框本身：470 → **520px**、圆角 10 → 12px、内边距 13 → 16/18px、 `max-height:calc(100vh - 48px)` + 内部滚动（小窗口不被裁）。 两处顺手的行为修正： - **倒计时是真的在走**：控制器在等授权时多存一个 `expiresAt`（绝对时刻）， 弹框每秒只更新「剩余时间 + 进度条」两个节点 —— **不整块重画**， 否则每秒重建一次按钮，点击会丢、hover 会断； - **打开浏览器后弹框左移**（`data-side="1"` → `justify-content:flex-start`）， 别压住浏览器窗口。这个行为原型里就有，但上一版只写了 `data-side` 没写样式， 等于没生效。 ### 已改的地方 | 文件 | 改动 | |---|---| | `client/client.js` | 重写登录弹框的 CSS 段与 `loginModalHTML()`；新增 `mag-field / mag-codebox / mag-cta / mag-btn-block / mag-bar / mag-step-t`；`copyText()` 抽出（链接与设备码共用）；新增 `login-copy-code` 动作；`portalTick` 秒级只更新两个节点；`paintPortal` 内容没变就不重写 innerHTML。 | | `src/login` 侧 | 无需改；`expiresAt` 由客户端在 `startLogin` 时按 `expiresInSec` 算出。 | | `test/client.test.mjs` | +2 条：主按钮整行 / 倒计时绑定 / 终态不画等待区；设备码只在该形态出现（含独立复制按钮）。 | ### 验证 1. 刷新页面（只改了客户端半边）； 2. 账号页 → 任意平台「登录」：弹框应是 **520px 宽、纵向一条线**， 主按钮占满一行，底部状态卡有倒计时和进度条； 3. OpenCode 的登录弹框应多出一块**设备码**（大字 + 复制按钮）； 4. 点「在浏览器打开」后，弹框应**左移**，不再压在浏览器窗口上。 > 几何自检（预览页 `preview/login-*.html`，用浏览器量到的真实盒子）： > 弹框 522px、主按钮 520×38、进度条 492px、无横向溢出、两步、Qoder 无设备码块。 --- ## 🔴 #1 对话框模型选择器里出现「没勾选、也没保存过」的模型 > 报障原话：很多模型我并没有选择并保存，但是现在在对话框选择模型的地方， > 渲染的有这些平台的模型。 **状态**：根因已定位、代码已改，但**真机未验证** —— 而且这次改的是宿主侧 schema 默认值，**必须重启 DSH 才会加载**。所以仍按「未修好」记。 明天第一件事就是按下面「验证」那节跑一遍。 ### 现象 - DSH 的模型选择器里出现 OpenCode 之外的平台模型（WorkBuddy / Qoder / 国际版的免费模型）； - 插件设置页「账号」里这些平台却显示 `已勾选 0 / 共 10` —— 界面和下拉对不上； - 「总览」KPI 的数字比下拉里实际能看到的条数多。 ### 根因（两处独立缺陷） 1. **默认值太宽松**：`ModelPolicySchema.mode` 默认 `'free'`，含义是「免费模型自动上报」。 用户 yml 里只给 `opencode` 写了 `models` 块，其它平台没有 `models` 块 → 走默认值 → 免费模型**自动**进选择器。用户从没勾过、也没保存过，模型却出现了。 2. **连续勾选互相覆盖**：`toggleModel` 以「宿主已保存的 `selectedIds`」为基线， 连续勾/取消多个时后一次把前一次覆盖掉 —— 勾 5 个保存后只剩 1 个。这条会让 用户以为「保存没生效」，进而反复点保存，把更多平台写进配置。 ### 已改的地方 | 文件 | 改动 | |---|---| | `src/config.ts:203-216` | `mode` 默认 `'free'` → **`'selected'`**；`selected` 默认 `''`。即「**不勾不报**」。 | | `src/runtime.ts:1224-1228` | 快照新增 `exposedCount` = 上游拉回来的 ∩ 上报策略；`exposeModels !== true` 时为 `0`。 | | `client/client.js` | `toggleModel` 基线改为**草稿优先**（draft → 宿主 `selectedIds` → `modelSelection()`）；~~新增 `preselectModels(ids)` 与「按推荐预选 N 个」按钮~~（后来按用户要求删掉了，见 #0b）；总览 KPI 与平台健康表改读 `exposedCount`。 | | `test/client.test.mjs` | 新增 4 条断言：schema 默认必须是 `selected`、默认勾选必须为空、连续取消不互相覆盖、~~`preselectModels` 只写草稿~~（该功能已删除，见 #0b）。 | | `docs/MODELS.md` §6.5 | 上报规则表按「不勾不报」重写。 | ### 验证（明天按顺序做） 1. **重启 DSH**（不是刷新页面）。schema 默认值在宿主进程启动时解析， 刷新页面只重载 client 半边，拿不到新默认值。 2. 设置 → 插件 → Free Token → **账号**。没配过 `models` 的平台 （Qoder / WorkBuddy / WorkBuddy 国际版）应显示 `已勾选 0 / 共 N`。 3. 回对话框展开模型下拉：**只应出现 OpenCode 已保存的那两个** —— `deepseek-v4.1-flash-free`、`glm-5.3-flash-free`。 > 参考：这份配置在 `~/.dsh/profiles/desktop/cordis.patch.yml`，当前只有 > `opencode.models`（`mode: selected` + 两个模型）和 `qoder.tasks.enabled`， > 其它平台**没有任何 `models` 块** —— 所以默认值就是唯一的开关。 ### 如果重启后还复现，按这个顺序查 1. **yml 被写脏了**（最可能）。翻 `cordis.patch.yml` 对应平台的 `models:` 块： 如果**显式**写了 `mode: free`（早期点过「保存并生效」就会被写进去）， 改 schema 默认值完全不管用 —— 需要改配置，或者加一段迁移把 「显式 free + 用户没真正勾过」收敛掉。**先看这一步再动代码。** 2. **`exposeModels: false` 但 provider 还注册着**。`src/runtime.ts` 里 `exposeModels !== true` 时应完全不注册 provider；若仍能看到该平台， 说明注册没跟着配置走。 3. **DSH 自己的模型缓存**。宿主的模型目录可能按 provider 缓存，重启后仍留旧条目。 试：清 `~/.dsh/profiles/desktop` 下与模型相关的缓存，或整目录重装一次。 4. **选择器不走 `exposedCount`**。界面已经改了，但如果 DSH 原生选择器的 模型列表有别的来源，去查 `src/llm/adapter.ts` 的 `listModels`。 ### 教训 **不要用「默认上报」当默认值。** 任何会自动出现在用户界面上的东西， 默认都必须是不出现，由用户显式打开。 --- ## 🟡 #2 登录弹框的遮罩把整个屏幕遮住了 - **原因**：拿 `--dsw-alias-bg-overlay` 当遮罩用。这个 token 是**不透明的浮层表面**， 不是半透明蒙版，铺满全屏就变成一块死板。 - **已改**：`.mag-overlay` 改用 `rgba(0,0,0,.45)`；点遮罩空白处 / ✕ / 取消 / Esc 都走同一个 `closeLoginModal()`。登录弹框本身的排版在 #0e 里又重做了一遍。 - **还差**：真机看一眼遮罩下面能不能看到页面。弹框本身在 `document.body` 的 portal 里 （`z-index: 1000`），因为设置页祖先有 `transform`/`overflow`，`position: fixed` 会被裁。 --- ## 🟡 #0s 账号删光后平台仍留在模型选择器里（2026-10-21，已修待真机） > 用户原话：「当某个平台的账号被全部移除后，则在对话框的模型选择列表中， > 不要再显示该平台的模型」 ### 现场（Lead 复现，本机当时恰好 0 个账号） ``` opencode 账号=0 活跃=true 进选择器=true ← 这个是对的（免账号通道） qoder 账号=0 活跃=true 进选择器=true ← ✗ qoder-cn 账号=0 活跃=true 进选择器=true ← ✗ workbuddy 账号=0 活跃=true 进选择器=true ← ✗ workbuddy-intl 账号=0 活跃=true 进选择器=true ← ✗ ``` ### 两个根因，**缺一个就只是「半修」** **A. 判据里根本没有「有没有账号」这一条。** `isAgentActive()` 只看 `enabled && visible`；`exposedAgentIds()` 只看它 + `exposeModels`， 而 `allModels()`（上报给 DSH 的那份）就是靠它拼的 ⇒ 零账号的平台照样上报。 **B. 删账号不会通知 DSH 重读模型目录。** `removeAccount()` 只调 `refreshSchedule()`（那只重建定时任务）。 DSH 的下拉**只在收到 `llm/adapters-updated` 时**才重读，而那个事件原先**只由改配置那条路**踢。 ⇒ 就算修好 A，用户删完账号**不重启还是看到旧清单**。 ### 修法 - **A**：新增纯函数 `accountGateDecision({ accountFree, routableAccounts })` → `{ exposed, reason }`，以及 `agentAccountGate()` / `isAgentExposed()`。 `exposedAgentIds()` 与 `index.ts` 的 `registerRoutes()` **读同一个判据**， 所以「选择器里不显示了」与「路由真被摘掉」必然同步 —— 两处各写一套过滤会出现「分组没了、路由还挂着」的错位。 - **B**：runtime 加 `setAccountsChangedHook()`（与既有 `setDirtyHook` 同款，避免 runtime→index 成环）； `index.ts` 注册的回调执行 `registerRoutes() → notifyModelsChanged()`。 **顺序不能反**（先决定该有哪些路由，再通知宿主重读）。 4 处账号写操作（增 / 改 / 删 / OAuth 登录建号）全走它。 回调抛错**不影响账号操作本身**（账号已删，不该因为通知 UI 失败而报错），只记日志。 ### ⚠️ 三条不能违反的设计约束 **1. 免账号平台必须保留。** `opencode` 零账号也能用（匿名免费层，README 的「Free Token」）， 一起砍掉就把主场景弄没了。判据落在**适配器声明的 `capabilities.accountFree`** 上 （唯一 `opencode` 声明 `true`），**不是写死平台名数组** —— 客户端已有一份 `FREE_ONLY` 硬编码，宿主侧再复制一份迟早漂移。 缺省（不声明）= **必须有账号**：新平台忘了声明只会「少显示一个分组」（看得见、好修）， 不会静默上报一堆调不动的模型。 > 曾考虑复用 `upstream.freeTierMode`，**实测否掉**：六个平台解析出来**全都是 undefined** > （生产 schema 默认 `'auto'` ⇒ 所有平台都会被判成免账号，等于没修）； > 且它是**用户可改的配置项**，拿它当结构判据会让「用户设成 never」意外抹掉平台。 **2. 账号门不能并进 `isAgentActive()`。** 该函数还被 `snapshotRouting().active` 与 `snapshotState().agents[].enabled` 用着， 而客户端把 `enabled === false` 渲染成**「已停用」**、另有专门的**「未配置」**文案 （`client.js:2063-2067`）。并进去 ⇒ 「你没配账号」会被误报成「你关掉了这个平台」。 所以拆成两个判据：`isAgentActive()` = **配置语义**（保持原样、继续喂 UI）， `isAgentExposed()` = **上报语义**（配置 + 账号门，只喂选择器/路由）。 **3. 「有没有账号」用 `routable()` 口径**（`enabled && routeChat !== false`），不是 `byAgent()`。 问题等价于「用户从这个分组挑个模型，发出去能成吗」—— `routable()` 就是路由器自己的候选口径，两处一致才不会出现 「看得见、点了必然报没有可用账号」。代价（可逆且看得见）： **停用账号**或**关掉对话路由**也会让分组消失，但账号记录仍在账号页，用户能立刻改回来。 ### 顺手修掉一个会以新形式复发的旧 bug `exposedCount` 的注释写着「**实际会进 DSH 选择器**的模型数」，并记录了历史 bug （「显示 22 个模型进选择器、下拉里空空如也」）。账号门会让它**以新形式复发** （显示 N 个、下拉一个没有），所以让它也过 `isAgentExposed()`（被门掉时返回 0）。 **`modelCount` 故意不动** —— 它的语义是「上游拉回来多少个」，与是否上报无关。 ### 验证 | 项 | 结果 | |---|---| | 真实零账号现场（`.scratch/verify-account-gate.mjs`） | ✅ 只剩 `opencode`（`reason=account-free`） | | 完整周期「加号 → 出现 → 删光 → 消失 → 再加 → 又出现」（`.scratch/verify-account-gate-cycle.mjs`） | ✅ 全过 | | 边界：停用账号 / 关掉对话路由 / 设置页仍列出该平台 | ✅ 全过 | | 新增用例 | ✅ `test/account-gate.test.mjs` **22 条** | | 全量回归 | ✅ **500 宿主 + 63 客户端 + 冒烟** | | **变异测试** | ✅ 4 个变异体：去掉账号门 → 16 条失败；**天真写法「零账号就砍」→ 9 条失败**（证明「免账号保留」不是白过的）；A/B 各自失效 → 恰好对应 3 条失败 | | 真机确认「DSH 下拉真的刷新了」 | ⏳ 需装上去点一次（根因 B 的测试用的是假 `registerAdapter`） | --- ## 🟢 #0r WorkBuddy 的思考档位：19 个模型被我们吃掉（2026-10-20，已修并真机验证） > 用户问：「为什么 workbuddy 的 deepseek 模型不能调整思考等级呢？ qoder 的就可以呢」 **答案是两件事叠在一起**：一个是我们的 bug（影响 **19 个**模型）， 一个是用户恰好试到了上游**本来就锁死单档**的那两条。 ### ① 真 bug：我们从没给 WorkBuddy 报过 `reasoningEfforts` 核心层（`src/llm/adapter.ts:258-268`）出不出档位行，**只**取决于一个字段： ```ts const declared = Array.isArray(meta.reasoningEfforts) ? meta.reasoningEfforts : [] if (reasoningEffortsForDeclared(declared).length > 0) { out.reasoning = … } ``` 而 `src/adapters/buddy.ts` **从头到尾没设置过 `reasoningEfforts`** （它只设过 `reasoning: true`，那只表示「会吐思维链」，**不是档位列表**）。 对比 Qoder：`qoderEffortsOf()` 报了它 ⇒ 有档位行。 **所以这不是上游差异，是我们漏了这个字段。** ### 上游其实**有**档位信息（Lead 真打 `/v3/config`，HTTP 200） 字段路径：**`data.models[].reasoning.supportedEfforts`**（可能带 `reasoning.defaultEffort`）。 **19 条模型带它**（`hy3: [low,high]`、`gpt-5.6-sol: 5 档`、`glm-5.2: [high,xhigh]`…）， 而 `parseModelsFromConfig()` **完全没碰 `reasoning` 对象**（只读了窗口/图片/名字/倍率）。 ### ② 不是 bug：DeepSeek 那两条上游**明确**只给一个固定值 ```json "reasoning": { "effort": "high", "summary": "auto" }, "onlyReasoning": true, ← 连「关掉思考」都不允许 ← 注意：**没有** supportedEfforts ``` 参考实现注释（原文）：`supportedEfforts` 是**可枚举**的等级列表， **只在模型真正支持多等级时下发**；只有单一默认 effort 的模型此处缺省、**不暴露等级选择器**。 ⇒ **没有 `supportedEfforts` 就必须继续没有档位行。** 给它编一组就是**谎报能力**：用户选了、上游 400，而他无从知道是插件编的。 （Qoder 的 DeepSeek 有 4 档含「关闭」，是因为 Qoder 目录**下发了** `efforts` —— 同一模型在不同平台能力不同，属正常。） ### 请求侧的两条实测结论（照参考实现 `buddy-adapter.ts:1395-1418`） - `reasoning_effort` **只发上游声明过的值**，否则服务端 400； - ⚠️ **DeepSeek 系模型必须同时带 `thinking: { type: 'enabled' }`**： 实测三站点一致 —— **只带 `thinking` 不生效**、**只带 `reasoning_effort` 才是真开关**， 两者**都带**才返回思考。没选档位时要**补一个**（默认档 → `high` → 最低支持档）， 否则上游按「不思考」应答。 ### ⚠️ 一个只有「真 wire」才抓得到的坑 请求体是 `{ ...payload, ... }` 拼的，而核心层在**拿不到我们的档位声明**时会 **原样放行**用户请求的档位 ⇒ `payload.reasoning_effort` 里可能有个该模型不支持的值。 适配器重算后若只写 `...(effort === undefined ? {} : {...})`， **spread 不会删掉旧键** —— 非法值会留在 body 里、上游 400。 必须显式 `delete body.reasoning_effort`。已修并用 wire 用例钉住。 ### 兜底表：**故意不补**静态档位 参考实现那张 `REASONING_EFFORTS` 表写着 `deepseek-v4.1-flash: [low,high,max]`， 而**上游今天根本没给这条模型档位** —— 正好证明静态表会漂移。 `FALLBACK_MODELS` 一行没动。 ### 验证 | 项 | 结果 | |---|---| | 有档位的模型数 | ✅ **0 → 19**（独立探针 `.scratch/verify-buddy-efforts.mjs`） | | DeepSeek 那两条 | ✅ **仍然没有档位行**（上游锁死单档，正确行为） | | `hy3` / `gpt-5.6-sol` 档位逐条对照上游声明 | ✅ `[low,high]` / 5 档 | | 没有任何模型拿到空数组档位 | ✅（空数组 = 谎报） | | wire 请求体 8 个 case（含 `hy3+max` 被拦下、DeepSeek 补 `high`+`thinking`） | ✅ | | 全量回归 | ✅ **478 宿主 + 63 客户端 + 冒烟** | ⚠️ 国内版仍只有单测（TLS 被劫持，非插件问题）。 ⚠️ **没复测**：`reasoning_effort` 是否真的改变上游 `reasoning_content` 长度 —— 那是参考实现的三站点实测结论，本轮未复验。 --- ## 🟢 #0q WorkBuddy 11128 渠道校验 + 倍率缺失（2026-10-20，已修并真机验证） > 用户原话：「1.使用workbuddy国际版调用模型失败 '本轮运行失败{"code":11128, > "msg":"request illegal",…"displayMsg":{…"zh":"请求被拦截，请重新发送"…}, > "displayTips":{…"This call failed channel verification, possibly because it was not > sent from an offici'… 2.workbuddy和国际版拉取到的模型，倍率全是未知」 ### 缺陷 A：11128 —— **错误文案是骗人的，两个子原因，第一个掩盖第二个** **① 缺三个会话头**（Lead 用真实账号做 A/B，只差请求头）： | 请求头 | 结果 | |---|---| | 我们原有的 10 个身份头 | ✗ 400 `code=11128` | | ＋`X-Conversation-ID` | ✗ 400 `code=11128` | | ＋**三个** conversation 头 | ✓ **200** | 必须**同时**带齐（缺任一都不行）： `X-Conversation-ID` / `X-Conversation-Message-ID` / `X-Conversation-Request-ID`。 参考实现 `buddy-adapter.ts:1792-1796`，**只对国际版加**。我们一个都没有。 **② 首条消息必须是 `system`**（同样只有国际版强制）。 ⚠️ **这一条在修好①之前根本看不出来** —— 修头前，所有情况都报同一句笼统的 `"Request blocked…(channel verification)"`，分不出原因；修头后 `msg` 才变具体： | 消息形态（headers 已齐） | 结果 | |---|---| | 首条是 `user` | ✗ `11128` msg=**"first message is not system prompt"** | | 首条是 `system`（中性 / 空串 / DSH 真实提示词） | ✓ 200 | | system 里含内容指纹句 | ✗ `11128` msg=**"Illegal API invocation from an unapproved channel"** | | 指纹句放在 `user` 里 | ✓ 200（印证参考实现：只拦 system） | `src/llm/adapter.ts` 的 `toOpenAiMessages()` **只在 `options.system` 非空时才 unshift system**， 所以 system 为空时首条就是 `user` ⇒ 必踩②。已在国际版的 `requestChatStream` 里兜一层 （首条不是 system 就补一句最小可用的），**已有 system 原样保留、只对国际版做**。 **★ 本节最值得记的一条**：**同一个错误码在修掉第一层之前会掩盖第二层。** 而且参考实现里确实存在两个真·内容级机制（`account-probe.ts` 的首条 system 要求、 `tencent-fingerprint.ts` 的 system 模板句），特别容易误判 —— Lead 一开始就把「首条必须是 system」当成**已排除**（因为修头前测它也是 400）， 是修完头之后再测才发现它其实**也是真的**。 > ⚠️ 内容指纹那条**我们当时判断错了**（2026-10-29 更正）：本机的 `dsh-system-prompt` 被 > `dsh-purge` 改过（`includeHarnessIdentity` 默认 `false`、身份句清空），所以「DSH 真实 > system 返回 200」是在**少了三条指纹**的 prompt 上测出来的。原版 DSH 的 system 带 **12 条** > 指纹，国内版必挂 —— 见 `docs/WORKBUDDY-CHANNEL-CHECK.md` §12 与 GitHub issue #1。 > **这段不要再当成「不需要处理」的依据。** **为什么必须是那三个头**：文本里写着 *"not sent from an official channel"*， 是**渠道校验**（请求头身份），不是内容审核。 ### 缺陷 B：倍率全是「未知」——根本没读 `credits` 上游 `/v3/config` 的 `data.models` **28 条，每条都有 `credits`**： ``` default-model credits="" ← 空串 = 未知（上游就没给） fast-model credits="x0.34 credits" ← 带单位后缀 deepseek-v4.1-flash credits="x0.00" ← 0 = 免费（合法值） hy4-preview credits="x0.29" ``` `parseModelsFromConfig()` **压根没读这个字段**，`FALLBACK_MODELS` 也没有倍率 ⇒ 核心层拿不到 `multiplier` ⇒ 全显示「未知倍率」。 已照参考实现补齐 `normalizeCreditsRate` / `normalizeDiscountedRate` / `normalizeRate` （**两套相反写法**：模型的 `credits` 是 `x` **在前**、促销的 `discountedCredits` 是 `x` **在后**， **不能共用一个正则**，早期版本只认前缀导致促销价全部静默丢失）。 真上游读数：国际版 **28 条里 27 条有倍率**（唯一未知的 `default-model` 上游本就没给）， 范围 `×0.03` ~ `×6.67`。 **三条硬要求**（都落进单测）： - 解析不出 → `undefined`，**绝不回退成 `x1`**（编造倍率比不显示更糟）；单测断言 **不能是 1、也不能是 0**； - `"x0.00"` / `"0x"` → `0` + `free: true`（免费是合法值，不是缺失）； - `credits=""` / 字段缺失 → **连 `multiplier` 键都不放**。 顺带修掉一个**只有真数据才暴露**的坑：`hy3` / `deepseek-v4.1-flash` 等 `credits` 本来就是 `x0.00`，活动又给 `factor: 0` ⇒ 拼出「免费→免费」这种零信息文案。 改成只在促销**真的改变了价格**时才写 description。 ### `sessionId` 为什么不用随机值 `X-Conversation-ID` 同时是**前缀缓存的 key**（参考实现实测：同一段 8k 前缀， 不带它 `prompt_cache_hit_tokens=0`、`credit=0.34`；带上 `hit_tokens=7808`、`credit=0.02` —— **费用差约 17 倍**）。所以**绝不能每次请求新值**。 参考实现「进程启动一次 UUID」在它那里够用（一进程一凭据）， 我们一个适配器实例服务**多账号**，照抄会让不同账号共用一个 key ⇒ 改为**按账号确定性派生**（`sha256('buddy::')` 前 32 位十六进制， 与既有 `machineIdOf` 同款）：跨重启仍命中缓存、账号间天然隔离、且不用落盘。 ### 验证 | 项 | 结果 | |---|---| | 走**适配器**真跑完整 chat（国际版） | ✅ 正文「收到」，三个头都在 | | 不带 system（真实触发场景） | ✅ 守卫补上后 200（修前是 400） | | 已有 system | ✅ 原样保留、未被覆盖 | | 倍率真上游 | ✅ 28 条里 27 条有倍率；`default-model` 正确留在「未知」 | | 反证：headers 齐但仍不带 system | ✅ 400 `"first message is not system prompt"` —— 证明守卫不是空动作 | | 全量回归 | ✅ **452 宿主 + 63 客户端 + 冒烟** | ⚠️ **国内版全部只有单测**：`copilot.tencent.com` 在本机 TLS 握手失败 （`ERR_SSL_PACKET_LENGTH_TOO_LONG`；`curl.exe` 也失败 `SEC_E_INVALID_TOKEN`）， 域名被解析到 `123.6.x` 的 `share.dnse5.com` —— **本机网络 / DNS 劫持，不是插件 bug，不要去「修」它**。 因此国内版拉不到真模型，走**兜底表**，而兜底表**故意不带倍率** （编一个就是骗用户）⇒ 国内版显示「未知倍率」是**当前正确行为**。 --- ## 🟡 #0p 隐藏 Trae / 排除非厂商模型 / WorkBuddy 登录（2026-10-20） > 用户原话：「1. Sonus、Auto这些不是厂商的模型，直接排除掉 > 2. workbuddy授权登录后，并没有加入账号进来 WorkBuddy International也是同样的问题 > 3. trae没有实现，把trae直接隐藏掉」 ### ① Trae 隐藏（✅ 已改） - `src/config.ts` 的 `DEFAULT_VISIBLE_AGENTS` 去掉 `'trae'`。 - **隐藏 ≠ 删除**：`TraeAdapter` 仍在注册表里、`IMPLEMENTED_IDS` 里也仍有它， 只是默认 `visible=false` + `enabled=false`，于是 `isAgentActive()` 为假 ⇒ 不注册 provider、不进模型选择器、设置页不露出。将来真机验证过， 把 `'trae'` 加回那一行即可。 - `visible` 是 volatile 字段，**显式配置优先于默认值** —— 用户若在 `cordis.patch.yml` 里写了 `agents.trae.visible: true` 仍会显示 （「默认值」与「强制值」是两件事）。已用测试钉住这条边界。 - 验证：`.scratch/verify-trae-hidden.mjs` 14/14；`test/unit.test.mjs` 新增一条回归 （同时钉「默认隐藏」「其余 5 个不受连累」「协议层仍在」「显式配置可覆盖」）。 ### ② 排除非厂商模型（✅ 已改） - 排除了 6 条：`auto`(Auto)、`ultimate`(Ultimate)、`performance`(Performance)、 `efficient`(Efficient)、`smodel`(Sonus)、`cmodel`(Cantus)。 这些是 Qoder 自己的**档位 / 路由名**，不是厂商模型。 - **依据是官方的，不是靠名字猜的**：Qoder 官方文档把两者分成两张表， 标题原文就是「Choose a **tier**」与「Select a specific model」， 且官方档位倍率与本表 `priceFactor` **逐条精确命中** （Auto ~0.5×/0.5、Ultimate ~2.0×/2、Fast 原 Performance 1.1×/1.1、Efficient ~0.3×/0.3）。 另有官方公告《Qoder Tier Upgrade: Performance Becomes Fast》， 正文写明 *"A tier lets Qoder **route by policy**"* —— 路由语义，不是具体模型。 - **实现是「不上报」而不是「删除」**：新增 `QODER_NON_VENDOR_MODEL_IDS` + `isVendorModel()`，在 `getModelMetaList()` 里一行 `.filter()`。 底层条目一条没删（协议层照旧认识它们）， 按 id 查表的 `effectiveMultiplier` / `qoderEffortsOf` 对 6 个 id 仍正常 —— 否则「用户以前勾选过 `smodel`」会变成**悬空引用**。 - 选常量集合而非逐条加标记，是因为**未登记 id 默认放行**： 将来上游新增厂商模型会默认显示，而不是被静默隐藏（隐藏新模型用户根本发现不了）。 - 验证：两个产品现在都恰好上报 **11 条厂商模型**、零档位泄漏 （`.scratch/probe-picker-ids.mjs`）；`test/adapters/qoder.test.mjs` 42 → 51 条。 ### ③ WorkBuddy 登录（🟡 buddy-dev 在处理） - **登录是四步，我们只做了两步**。参考实现 `runBuddyLoginFlow`： `fetchAuthState → decorateLoginUrl → loopGetToken → getAccount → buildCredential`， 我们缺 `decorateLoginUrl` 与 `getAccount`。 - `getAccount`（参考 `buddy-oauth.ts:231-290`）： `GET {endpoint}/v2/plugin/login/account?state=` —— **账号信息（uid / 企业 / 域）在这一步才拿到**。 - `decorateLoginUrl`：国际版必须给登录 URL 追加 `version` + `loginSessionId`， 国内版不追加；**只追加参数、不得重建 URL**。 我们全仓没有这个逻辑 ⇒ 极可能就是「授权完仍是 pending」的直接原因。 - ⚠️ **国内版在本机打不通**（实测）：`copilot.tencent.com` 的 TLS 握手失败 （`ERR_SSL_PACKET_LENGTH_TOO_LONG`；`curl.exe` 同样失败 `SEC_E_INVALID_TOKEN`）。 该域名被解析到 `123.6.x` 的 `share.dnse5.com` —— **本机网络 / DNS 劫持，不是我们的 bug，不要去「修」它**。国内版只能单测。 国际版 `auth/state` 实测可用（HTTP 200）。 - ⚠️ 上游用 **`HTTP 200 + body.code`** 报「还没好」： `{"code":11217,"msg":"11217:login ing..."}`。 现有代码只在**非 200** 时读 `code === 11217`，靠 `unwrapData` 返回 null 这个**副作用**恰好判对 —— **行为对但很脆**，已要求改成显式判 `body.code`。 ### ④ ★ 顺带发现一个既有接线缺陷（未修，待用户决定） `src/adapters/qoder.ts` 的 `QODER_CN = { ...QODER, … }` 摊开的是**国际版**产品对象， 所以 **`qoder-cn` 实际用的是国际版那 17 条表**，`vendor/qoder/qoder-product.ts` 里 那份**真正的 CN 表（14 条）从来没被用上**。 Lead 独立复核（读构建产物）： ``` vendor 国际版表条数: 17 vendor CN 表条数 : 14 适配器 QODER_CN 实际用的表条数: 17 适配器 CN 用的是不是国际版那份？ true CN 独有、国际版没有的 id: [ 'q37fmodel', 'gm51model' ] ``` 后果：CN 独有的 `q37fmodel`(Qwen3.7-Flash) 与 `gm51model`(GLM-5.2) 用户**看不到**； `mmodel` 显示成国际版的 **MiniMax-M3**，而 CN 实测是 **MiniMax-M2.7**； 两个产品上报的列表**逐条相同**（各 11 条）—— 这就是最直接的证据。 **没有擅自修**：修它会**改变用户可见的模型列表**（CN 多出 2 条、`mmodel` 改名）， 属于产品决策，等用户拍板。 --- ## 🟢 #0o 请求日志缺「业务路由字段」+ 日志显示上游目录 key（2026-10-20，已修并真机验证） > 用户原话（同时纠正了上一轮的误判）： > 「1. 请求日志的模型名全部都是 'qfmodel'，并不是真实选中的模型名称。 > 2. **上游没问题，我在 Qoder CN 客户端中使用这两个模型就没问题**」 ### ★ 用户是对的，我上一轮判断错了 上一轮我把 `qfmodel` / `dfmodel` 的 `[FAIL]…Execution failed` 归因为 **「这两个模型在上游本身就是坏的」**（#0n 的「遗留」一节就是这么写的）。 **这个结论是错的。** 用户用官方客户端实测这两个模型完全正常， 而抓包与源码都指向同一个被漏掉的字段。 **真因：请求体缺 `business`。** 服务端按 `business.type` 选路由池（源码 `MPi(A) { return A === 'sec_scan' ? 'security' : 'default' }`）， **缺字段会走异常分支** —— 把请求路由到故障节点 `oa_qwen-plus-2025-04-28`， 回 `[FAIL]node:… msg:Execution failed`。 三个「极易误判成上游故障」的假象： | 假象 | 真相 | |---|---| | 报错里的节点是 **`qwen-plus`**，与我们发的 `qfmodel` 对不上 | 那正是「**被路由到了别的节点**」的指纹，不是「这个模型坏了」 | | 只有 `qfmodel` / `dfmodel` 踩中，`auto` / `qmodel_38max` 恰好正常 | 换池路由对**部分模型**恰好无害，于是看起来像个别模型的服务端故障 | | 官方 IDE / 客户端里同一模型完全正常 | 官方客户端**带了** `business`，我们没带 | ⚠️ 参考实现的注释里**早就写明了这一条**，而且连现象描述都一样 （「`qfmodel` 曾因此被误判为『服务端故障』（而 IDE 里同一模型完全正常）」）。 我们移植时漏了这个字段 —— **「上游报错」不等于「上游有问题」， 先确认自己发的东西和官方客户端一致。** **修法**：`prepareInfer({ …, business: { type: 'agent' } })`（与参考实现一致）。 一行修复，`qfmodel` / `dfmodel` / `auto` 三个模型真机全部出正文。 ### 缺陷 B：日志显示的是上游目录 key，不是用户看到的名字 - **用户看到**：选择器里写着 `Qwen3.8-Flash`，日志里却全是 `qfmodel`。 - **真相**：记录**没错** —— `qfmodel` 就是目录 key、也正是发上游的值。 问题是它**在界面上不可见**，两套词汇对不上，用户自然认为记错了。 （已验证：17 个模型的 id 全部唯一、`encode/decode` 往返一致、 日志忠实记录 DSH 传进来的值 —— 所以这不是「记错了」，是「读不懂」。） - **修法**：采样**同时记两个字段** —— `model`（目录 key，排查时看的仍然是它）+ `modelName`（展示名，与选择器一致）； 界面优先显示 `modelName`，把 key 放进 `title`； 取不到展示名时**不写**这个键、退回显示 id —— **绝不拿 id 冒充名字**。 ### 验证 | 项 | 结果 | |---|---| | `qoder-cn/qfmodel` 真机 | ✅ 出正文「你好」（修前是 `Execution failed`） | | `qoder-cn/dfmodel` 真机 | ✅ 出正文 | | `qoder-cn/auto` 真机 | ✅ 出正文（没被改坏） | | 变量对照（`.scratch/probe-qfmodel-vars.mjs`） | ✅ 加 `business` 前后 8 个组合全部由 ✗ 转 ✓ | | 日志 id ↔ 展示名 | ✅ `.scratch/probe-logged-model.mjs` `modelName=Qwen3.8-Flash` | | 选择器 id 唯一性与往返 | ✅ 17/17 唯一、`encode→decode→encode` 全部一致 | | 全量回归 | ✅ **387 宿主 + 63 客户端 + 冒烟** | ### 一条方法教训 **「上游报错」≠「上游有问题」。** 判断前必须先证明 「我们发的东西与官方客户端一致」。本轮两个假象（节点名对不上、只有部分模型失败） 都被我当成了「上游故障」的证据，其实它们恰恰是「我们漏了字段」的证据。 **参考实现注释里已经写过的坑，移植时要逐条对照，不能只抄正常路径。** --- ## 🔴 #0n Qoder CN 的模型「没有回复，直接显示已完成」（2026-10-20 —— **根因见 #0o**） > ⚠️ **本节的现象描述仍然有效，但「上游侧遗留」那个结论已被 #0o 推翻。** > 真正的原因是**请求体缺 `business`**，不是上游模型坏了。修在 #0o。 > 用户原话：「此对话选择 Qoder CN 的模型，发送消息后，没有显示收到回复， > 直接显示了已完成。Qoder 平台下的模型就没问题」 ### 现象与定位 - `qoder-cn` + `qfmodel` / `dfmodel` 发消息 → **界面显示「已完成」但一个字都没有**； 同一账号的 `qoder`（国际版）正常，`qoder-cn` 的 `auto` 也正常。 `requests.jsonl` 里那几行是 `ok:true` **且没有 `ttftMs` / token** —— 「成功但零正文」的指纹。 - 抓原始帧（`.scratch/probe-raw-frames.mjs`，包一层 `ctx.fetch`）看到上游在 **HTTP 200** 的流里回业务错误： ``` {"code":"400","message":"[FAIL]node:oa_qwen-plus-main msg:Execution failed: null", "statusCodeValue":400,"statusCode":"BAD_REQUEST"} ``` 也就是说 **`qfmodel` / `dfmodel` 这两个模型在上游侧本身就是坏的**。 ### 根因（我们的缺陷：把错误静默丢掉了） `unwrapQoderEnvelopeStream` 把这帧**保真**转成 `{code, message, type:'model_error'}`（这一步是对的）， 但 `src/core/sse.ts` 的 `translateChunk` **只认 `parsed.error`**： - 没有 `error` 字段 → 不命中； - 没有 `choices` → 也不命中； - 于是整帧被当成「**合法但空的 chunk**」丢掉，流随后照常 `finish(stop)`。 DSH 收到「成功 + 零正文」⇒ 界面上就是「已完成，没有回复」。 **这比直接报错危害大得多**：报错用户至少知道要重试， **静默成功会被当成模型真没话说**。 ### 为什么移植时会漏 参考实现（`.scratch/dsh-our-free-model/.../openai-compat.ts`）对同一形态**有显式分支**， 注释里写着： > 若只判 `statusCodeValue >= 400`，**整帧会被静默丢弃** >（真实缺陷：网关形态的排队错误因此既不被识别、连报错都没有） 即参考实现早就踩过这个坑并修好了，我们移植 `translateChunk` 时**漏了那条判据**。 ### 已改 `translateChunk` 增加「网关形态 / 信封剥离后」的错误分支，判据覆盖两种来源： - `type === 'model_error'`（**信封剥离后 `statusCodeValue` 已被吃掉**，只判状态码会漏）； - `statusCodeValue >= 400` 或带 `stackTrace`（直连网关时的形态）。 同时把 `message` / `statusCodeValue` / `stackTrace` / `type` 加进 `OpenAiChunk` （它们不在 OpenAI 协议里，是这条链路自己的形状，声明出来免得到处 `as` 强转）。 ### 顺带修掉一个既有的会崩的边界 `translateChunk('null')` 原先**直接抛** `Cannot read properties of null (reading 'error')` —— `JSON.parse('null')` 得到 `null`， 而后面每处都读 `parsed.xxx`。 这条路径**真的会走到**：Qoder 信封里 `body: null` 的心跳帧经 `JSON.stringify` 就是 字符串 `'null'`。目前没炸只是因为 `classifyInner` 在**上游**把心跳提前丢了 —— 但 `translateChunk` 是导出给所有适配器用的通用函数， 任何人直接喂它一帧 `null` 就会抛，而异常会一路冒到流消费处， 把「跳过一帧」升级成「整轮对话失败」。 **通用解析器不该依赖调用方替它挡住非对象 JSON**。已加一道非对象短路。 ### ⚠️ 防过度修正 新分支必须**只**认真正的错误帧，否则正常对话会被中断。已钉住边界： - 正常 `choices` 帧 → 照常出正文； - 只有 `message`、既无状态码也无 `type`/`stackTrace` 的帧 → **不算错误**（返回空数组）； - 心跳帧（`null` / `{}`）→ 仍返回空数组（**issue IKJOZ8 不能回归**）。 ### 验证 | 项 | 结果 | |---|---| | 端到端（真实信封字节 → `unwrapQoderEnvelopeStream` → `iterateSse`） | ✅ `.scratch/verify-envelope-error.mjs` 7/7 | | `qoder-cn/qfmodel` 真机复打 | ✅ 现在**报出上游原文**而不是静默成功 | | `qoder-cn/auto` 真机复打 | ✅ 正常出正文（没被误判成错误） | | 全量回归 | ✅ **383 宿主 + 62 客户端 + 冒烟** | | 真机界面 | ⏳ 待重启 DSH 后确认「报错文案真的显示出来了」 | ### ~~遗留（上游侧，不是我们的 bug）~~ —— **此结论已作废，见 #0o** > ⚠️ 我原先在这里写「`qfmodel` / `dfmodel` 在上游本身就是坏的」， > **这是错的**。用户用官方客户端实测这两个模型完全正常。 > 真因是**我们的请求体缺 `business` 字段**，导致请求被路由到故障节点。 > **一行修复即可，不需要等上游。** 保留这段是为了记住这个误判。 ~~`qfmodel` / `dfmodel` 在上游**本身就是坏的**（`Execution failed: null`）。 我们现在的正确行为是**把上游原文如实报出来**。用户若想用这两个模型， 得等上游修；换 `auto` / `qmodel_38max` / `cmodel` 是好的。~~ 本节的另一部分（**错误帧不能被静默丢掉**）**仍然有效且已修** —— 它保证的是「以后任何上游错误都会如实报出来」，与根因是什么无关。 --- ## 🟡 #0m 第四轮真机反馈：提示不消失 / 任务流水 NaN / 日志三列空 / 侧栏入口（2026-10-20，代码全改完待真机） > 用户原话（重启 DSH 后实测，三条已修的先确认有效：开关画对了、额度 900 积分、 > 签到成功）： > 「1. 切换选项卡后，这个提示在顶部一直存在。2. 任务中 时间为 NaN。3. 日志中 速度， > 输入，输出为 - 倍率为未知。4. 能否参考我现在已经安装的插件市场的这个插件， > 在上面有个提示，是否添加到左侧导航栏进行管理，如果添加后，像这个插件市场一样， > 直接加到此处」 ### 缺陷 A：动作提示跟着用户跑到别的页面（✅ 已改） - **现象**：点「刷新额度」后顶出一条「1 个账号额度已更新…」，切到「任务」页它还在。 - **根因**：`actionMessage` 是**一次性**反馈（「刚才那一下干了什么」），属于触发它的那一页； 但 `setPage()` 没清它，`noteHTML()` 又无条件渲染。 - **已改**：`setPage()` 里清掉 `actionMessage`。 - **验证**：`test/client.test.mjs` 有回归用例（走真实 `run` → 切页 → 断言消失）。 ### 缺陷 B：任务流水的时间画成「NaN:NaN:NaN」（✅ 已改，两个叠加的原因） - **根因一（字段名读错）**：宿主 `TaskLogRecord`（`src/core/tasks.ts:42`）写进 task-log 的 字段是 **`at` / `message` / `credits`**，而客户端读的是 **`ts` / `detail` / `error`** —— 三个全错。于是时间取到 `undefined`、详情列永远空白。 - **根因二（兜底是假的）**：`clockText()` 只 `try/catch`，但 **`new Date(undefined)` 与 `new Date(NaN)` 都不抛异常** —— 它们产出 Invalid Date， `getHours()` 返回 `NaN`，于是「兜底」根本没兜住，直接画成 `NaN:NaN:NaN`。 - **已改**：读 `job.at`（保留 `ts` 兼容）；`clockText` 先判 `Number.isFinite(ts) && ts > 0` 再判 `Number.isNaN(d.getTime())`，取不到就画「—」；详情读 `message` 并把 `credits` 标成 `+100`。 - **验证**：回归用例用**从本机真实 `task-log.jsonl` 抄下来的行**做 fixture； 另有一条专门喂 7 种非法时间戳（`undefined`/`null`/`NaN`/`0`/`-1`/`'abc'`/`{}`）断言不出现 NaN。 ### 缺陷 C：日志页「速度 / 输入 / 输出」为 —、「倍率」未知（✅ 已改） - **根因（宿主侧，三处，比最初判断的更靠后一层）**： 1. **`settle()` 根本没放 `multiplier` / `free`** —— `RequestLogEntry` 有这两个字段、 客户端也在读，但采样时从来没写过。 2. **`startedAt` 取晚了**：原先它在 `router.execute` **之后**取，于是 `ttftMs` 恒为 **0**、「等首字」那整段被排除在计时外，`durationMs` 只算 「首字之后」（实测 679ms vs 真实 2044ms）。这一条决定了「速度」列。 3. **usage 帧排在 `finish` 之后** —— 实测帧序 `… #16 text → #17 finish(stop) → #18 usage{input:15, output:54}`， usage 比 finish **晚 17ms**；而 `case 'finish'` 里 `settle()` 后直接 `return`， 那一帧**永远读不到** ⇒ `inputTokens` / `outputTokens` / `tps` 恒缺。 - ⚠️ **我最初的判断是错的，记在这里免得后人重走**：我以为是「Qoder 没请求 `stream_options.include_usage`」。**真打上游 5 个模型对照后否掉了**—— Qoder **本就会**下发 usage 末帧，带不带这个字段都一样（带上一律 200、 没有一次 400，但**完全是多余的**）。所以**故意没加**它，理由与实测表写在 `src/adapters/qoder.ts` 的注释里。**别再回头加这个字段。** - **已改**：`settle()` 补倍率（三态：有倍率 → 两键都写；没倍率但上游标免费 → 只写 `free:true`；**都没有 → 两键都不写**，绝不拿 0 冒充未知）； `startedAt` 前移到 `router.execute` 之前；`finish` 改成「**收尾但不结束**」 （关块 + 最多再等 `USAGE_DRAIN_MS = 250ms` 只为收那一帧 usage，然后才 `settle()` 并补发 usage chunk）；抽出**幂等**的 `closeBlocks()` 给三条收尾路径共用 （否则 finish 后 drain 窗口内又来 error 会关两次块，第二个空正文的 `block-end` 正好又踩「覆盖式赋值冲掉正文」那条老坑）。 - **顺带修**：「上游断流没给 finish」原先**块根本不关**（正文丢一截）。 - **真实落盘对照**（字段数 7 → 14）： ```json {"agentId":"qoder-cn","model":"auto","ok":true,"durationMs":2431,"ttftMs":2030, "inputTokens":15,"outputTokens":37,"reasoningTokens":34,"multiplier":0.5, "free":false,"tps":92.3} ``` - **延迟代价已量化**（真上游跑 3 次）：最后一个 block-end → 流真正结束， 推迟仅 **11 / 2 / 16 ms**，用户感觉不到。 - ⚠️ **超时判据必须在 `iterator.next()` 那一层用 `Promise.race`**， 不能写成循环体里的 `if (Date.now() > drainUntil)` —— `for await` 卡在 `next()` 上时循环体根本不执行，那种写法对着 「发完 finish 就挂住连接」的上游会**永远等下去**。已用「永久挂住的假适配器」 钉了一条回归（实测 259ms 收尾）。 ### 缺陷 D：入口加进左侧导航栏（✅ 已改） - 参考用户已装的 `dshmarket`（v1.66.42，截图里那个插件市场）。 **两个槽位必须成对注册、共用同一个 id**： `main`（keyed，key = 面板 id）= 点侧栏后右侧显示什么； `sidebar.panellist`（list，id = **同一个字符串**）= 左侧那一行。 宿主靠这两个值相等把「点了哪一行」与「渲染哪个面板」对上；不等就是 「侧栏多一行、点了没反应」**且不报错**。 - **三态语义**：`chosen`（用户表过态没有）与 `enabled`（他要不要）是两件事。 「没回答过」≠「选了关」—— 只存一个布尔的话，「默认显示」永远做不到。 默认值口径：**没回答过时，只有当侧栏是唯一入口才显示**（设置页入口在时不抢那一行）。 坏数据 / localStorage 抛异常一律退化成「从没回答过」—— 误判成「选了关」会让入口**永久消失**且用户不知道自己何时关过。 - **防竞态用 `epoch`**：慢的初始 load 回来时对不上号就整个丢掉。 - **持久化用 localStorage**，没加配置字段（加 volatile 要改宿主并重建 `lib/`）。 - **优雅退化**：`ctx.slots.inject('sidebar.panellist', …)` 的契约是「等这个槽位被声明」， 旧宿主上**一次都不执行** → 两个槽位一个都不注册、不抛错，设置页入口照旧， 设置页那张卡片画出 disabled 开关 + 诚实说明缺哪个槽位。 - **`order: 20`** = 排在宿主自带的「插件」(0) 与「定时任务」(10) 之后。 - ⚠️ 侧栏**视觉观感**（图标位置/配色）没在真机核对 —— 图标是自绘 SVG （require 宿主图标集要改 `package.json` 的 externals）。需要刷页面看一眼。 ### 缺陷 E：`test/adapters/opencode.test.mjs` 的假 router 形状是错的（✅ 已改） 这一条是**修 C 时被顶出来的既有假通过**，值得单独记： - 该测试的假 `router.execute` 写的是 `value: await run(…)` —— 把 `run()` 的 **整个返回对象**（`{ok, value:{events}}`）又塞回 `value`，于是 `outcome.value.events` 是 `undefined`。真 router 是 `return { ok: true, value: outcome.value, … }`（`src/core/router.ts:305`）， **要解开一层**。 - 它一直没暴露，是因为旧 `pump` 把「取迭代器」放在 `try` 里，那个 TypeError 被 catch 当成「上游报错」，而测试只断言「发出了什么 effort」、不看结果 —— **假通过**。 修 C 把迭代器挪到 `try` 外，才把它顶出来（5 条档位用例一起红）。 - **定位方法**（可复用）：开一个 `git worktree` 到 HEAD 跑一遍确认干净 → 把工作区的 `lib/llm/adapter.js` 注入进去 → 5 条复现 ⇒ 锁定是那个文件。 - 已按真 router 的形状修好 fixture，并把这段经过写进测试注释。 ### 本轮的验证强度（诚实记录） | 项 | 手段 | 结果 | |---|---|---| | 全量回归 | `npm test` | ✅ **382 宿主 + 62 客户端 + 冒烟** | | 构建一致性 | `build --check` / `client.js` vs `lib/client.js` hash | ✅ exit 0 / identical | | 采样与倍率 | 真上游落盘 `requests.jsonl`（7 → 14 字段） | ✅ 见上 | | `stream_options` 假设 | 真打 5 个模型做带/不带对照 | ✅ **假设被否掉，故意不加** | | drain 延迟 | 真上游 3 次量化 | ✅ 11 / 2 / 16 ms | | 侧栏槽位成对注册 | 独立探针 `.scratch/verify-sidebar.mjs` | ✅ 7/7 | | 侧栏三态 + 防竞态 | 同上（直接驱动控制器） | ✅ 5/5 | | 旧宿主退化 | 同上 | ✅ 3/3 | | localStorage 坏掉 | 同上（4 种坏输入） | ✅ 4/4 | | NaN / 提示不消失 | 独立探针 `.scratch/verify-round6.mjs` | ✅ 7/7 | | 侧栏**视觉观感** | **未做** —— 需刷页面人工看 | ⏳ | ### 一条方法上的教训（第二次了，写下来） **「全绿」不等于「测到了」**，本轮又抓到一类新花样：**假 fixture**。 `opencode.test.mjs` 的假 router 形状不对，而旧代码用 `try` 把异常吞了， 于是测试**一直是绿的**、测的却不是真东西。三个 teammate 合计跑了 **12 组变异测试**（4 + 8），另有多次「真打上游对照」把**我自己写错的根因判断** 否掉（`stream_options` 那条）。 **结论**：凡要证明「某条链路修好了」，用例必须**从头走到尾** （真实入口 → 真实派发 → 真实结果），且**假替身必须复刻真契约的形状** —— 形状错了不报错，只会静默地测错东西。 ## 🟡 #0l 任务页两个开关「不生效」+ 额度没有手动刷新入口（2026-10-20） > 用户原话：「1.任务列表下的 每日签到 和 活动任务按钮不生效 > 2.账号的额度未拉取，能否加个按钮，手动可以刷新额度」 ### 缺陷 A：任务页的开关恒画成关闭（🟡 已改，待真机确认） - **现象**：切到「任务」页，「每日签到」「活动任务」两个开关**永远画成关闭**、 徽标永远「已关闭」；点它们也看不出效果。同一个页面的 4 个 kv（签到时间 / 轮询间隔 / 并发上限 / 失败暂停）也**永远显示兜底默认值**，与真实配置不符。 - **根因**：`tasksHTML()` 里的 `valueOf()` 读 `hit.state?.value`，但 `GatewayPanel.fieldState()` 给的是 **bool → `{checked, changed}`、 其它 → `{text, changed}`**，两种都没有 `.value`。于是 `textOf(undefined) === ''`， `onOf()` 恒为 `false`。**全文件 grep `.state?.value` 只有这一处** —— 设置页（`fieldRowHTML`）早就用对了形状，任务页漏改。 - **真实回路（比「开关坏了」更准确）**：`onSwitchClick` 的取反依据是 `hit.state?.checked`（**形状本来就是对的**），而坏的只有渲染。所以交互方向 正确交替，但**界面画的值与真实值相反**。后果是：配置里本来开着的签到， 用户看到的是「已关闭」，照着界面点一下反而把它**悄悄改成关**；再点一下才回来。 用户感知就是「点了没生效」。 ⚠️ 早期把这条误判成「取反依据也坏了、永远算成 true」，是错的 —— `onSwitchClick` 从来没读错形状，别再照那个错版本去改。 - **已改**：`tasksHTML` 按真实形状取值（`stateOf` / `onOf` / `valueOf` 三个小函数）， 口径与 `fieldRowHTML` 完全一致。 - **顺带修掉的一条既有缺陷**：`inject().run` 只声明了 **3 个形参** `(label, method, input)`，而调用方一直按 4 个实参写 （`props.run(label, method, input, describeXxx)`）—— 第 4 个被**静默吞掉**， `run()` 里 `typeof describe === 'function'` 永远为 false。 也就是说 **`describeCheckIn` 从写出来那天起就没生效过**，签到一直只显示 「签到 完成」，用户分不清「领到了」与「今天已领」。现已转发 `describe`。 - **还差**：真机确认开关翻面、徽标与 kv 显示真实值。 ### 缺陷 B：额度只能等定时拉取，没有手动入口（🟡 已改，待真机确认） - **现象**：账号页「额度」列一直是「未拉取」，用户没有地方可以主动拉一次。 - **根因（两层）**： 1. 宿主的 `refreshQuota` 端点**早就存在**，客户端的 `ENDPOINTS` 数组里也有， 但**整个客户端没有任何按钮、也没有 click 分支调用它** —— 纯粹是入口漏了。 2. `quotaView()` 把三种截然不同的情形画得几乎一样：`remaining: 0` 给**绿色 ok** 语气、`quota.error` 塞进大多数调用点根本不渲染的 `hint` 里、 上游真的会下发的 `extra.isQuotaExceeded` 从没露过面。于是「没拉到」 「拉到了真的是 0」「已用尽」在界面上分不开。 - **实测依据**（2026-10-20，本机真实 qoder 账号，探针 `.scratch/probe-quota-shape.mjs`）： `GET https://openapi.qoder.sh/sash/api/v2/me/usage` → 200， `userQuota = {total:0, used:0, remaining:0}`、**`addOnQuota` 字段不存在**、 `isQuotaExceeded: true`、`displayMode: "qoder"`。 也就是说这个账号回的就是 **0**，我们**没有读错层** —— 但 `isQuotaExceeded: true` 这条上游判定以前完全没显示出来。 （CN 账号的余额在 `addOnQuota`，见 #0k；两个产品的响应形状不同，别互相套用。） - **已改**： - 宿主 `refreshQuotas()` 支持按**单账号**刷新：`{ accountId }` 优先且 **不过滤 `enabled`**（用户点名要刷就刷；不存在则返回空数组、不抛错）； `{ agentId }` → 该平台启用账号；都缺省 → 全部启用账号。 返回项字段是**冻结契约**（客户端按它渲染），逐字段钉在 `test/quota-refresh.test.mjs`。 - 客户端账号页加两个入口：卡片头「刷新额度」（不带 `data-id` → 刷本平台全部）、 每个账号行「刷新额度」（带 `data-id` → 只刷那一个）； 新增 `describeQuotaRefresh()` 把结果翻成「N 个账号额度已更新：主号 858 积分、 小号 0 积分（已用尽）。第一个失败原因：…」。 - `quotaView()` 分四种状态且都给 tone，hint 一律带「上次拉取 <时间>」； 账号行的额度挂 `title`，悬停能看原因。 - **额度的 tone 以前是「死的」**：`quotaView` 早就算好了 tone，但调用点只取 `.text`，于是「已用尽（warn）」和「一切正常（ok）」在屏幕上**长得一模一样** —— 用户报的「分不清」正是这么来的。现改用 `quotaBadge()` 把 tone 真正画出来 （`quotaText()` 已无引用，一并删掉）。 - **还差**：真机点一次按钮，确认账号表里额度从「未拉取」变成具体数字、 且提示语说清了是「0（已用尽）」还是「拉取失败：<原因>」。 ### 本轮的验证强度（诚实记录） | 项 | 手段 | 结果 | |---|---|---| | 宿主筛选语义 | 从**构建产物** `lib/` 走真实 `GatewayRuntime`，6 项断言 | ✅ 全过 | | 宿主返回形状 | 逐字段断言 + 变异测试（4 个变异体各自被抓） | ✅ 全过 | | 客户端渲染 | 独立探针 `.scratch/verify-tasks-switch.mjs` | ✅ 全过 | | 客户端修复 | 8 组变异测试（每处单独改回坏的样子） | ✅ 8/8 被抓 | | 全量回归 | `npm test` | ✅ 368 宿主 + 49 客户端 + 冒烟 | | 真上游额度 | `multiagent_quota refresh=true`（本机 qoder 账号） | ✅ 形状与冻结契约一致 | | 真机界面 | **未做** —— 需要重启 DSH 后人工点一次 | ⏳ | ### 一条方法上的教训（值得留着） 「全绿」不等于「测到了」。本轮有三个用例一开始是**假通过**，都是靠**变异测试** （把修复单独改回坏的样子，看用例是否真的变红）才发现的： 1. 「点击分发」那条用 `panel.toggle()` 直接调控制器，**绕过了 `onSwitchClick` 与根节点 click 监听** —— 而缺陷的原发地正是那条派发路径； 2. `run.length >= 4` 只证明**形参个数**，证明不了 `describe` 真的流到 `actionMessage`（bug 恰在转发那一层）； 3. `description` 里的两个「锚点」在原文里根本不存在（记错了）， 照抄描述写出来的断言测的不是真东西。 **结论**：凡是要证明「某条链路修好了」，用例必须**从头走到尾**（真实入口 → 真实派发 → 真实结果），不能从中间某层接进去。 --- ## 🟡 #3 设置页所有「开启 / 关闭」开关点了没反应 - **原因**：`fieldRowHTML` 读 `fieldState.value`，但宿主的真实形状是 布尔字段 `{checked, changed}`、文本字段 `{text, changed}`。读不到 → 开关永远渲染成 `aria-checked="false"`；而点击时算出的「设成 true」对本来就 true 的字段是空操作。 - **已改**：渲染和 `onSwitchClick`（读 `hit.state?.checked`）都按真实形状取值。 - **还差**：真机确认开关会翻面，且翻面后顶部出现「保存并生效」（保存栏由 `shell.dirty` / `dirtyCount` 驱动，开关**不会**即时写入配置）。 --- ## 🟡 #4 外链登录的自动轮询没有真机验证 `startLogin` 现在对**设备码**和**外链**两种形态都排每 3～5 秒一次的轮询（原型要求）。 代价是 WorkBuddy / Qoder 的 `/auth/token?state=` 会被一直问到过期。需要一次真人登录确认： 1. 授权完成后 3～5 秒内界面自己变绿（不用点「手动刷新」）； 2. 过期后停在 `expired`（灰），**不会**再变绿 —— 早期这里掉进 `else` 分支， 过期反而渲染成绿色的「已添加账号」。 --- ## 🟡 #5 深色主题只有近似色，没在真机核对 `scripts/preview.mjs` 用固定的 14 个 token 浅色值渲染成 `preview/*.html`， 深色用的是近似调色板。真实设备上的深色值没核对过，检查清单：边框、 次要文字、「浅色底 + 状态色」的徽章。 --- ## 其它已知边界（不是 bug，别再查一遍） - **Trae 适配器是骨架**，`visible: false`，界面看不到。实现后把 `trae` 加进 `src/config.ts` 的 `DEFAULT_VISIBLE_AGENTS` 即可。 - **宿主端 `addAccount` / `setCredentials` 端点仍在**（`src/index.ts`）， 但界面已没有手动填 token / cookie 的入口 —— 保留给脚本用。 - **WorkBuddy 的签到 / 额度**上游没有公开接口，明确回报「不支持」。 - 改完 `src/` **必须先跑 `node scripts/build.mjs`** 再提交：`lib/` 是提交进仓库的 构建产物，安装时不重新构建。`node scripts/build.mjs --check` 校验是否漂移。