dsh-free-egg-credits

LIMITATIONS

Known limitations

- 积分为折算值：上游限免时段实际扣费可能更低，所以界面统一带 `≈`。 - WorkBuddy 的分类型单价来自本机实测，缓存命中价远低于未命中输入；如果上游调价，用 `tokenRates` 覆盖。没有分类型单价的模型仍按 `model_costs` 混合单价估算，缓存比例变化时会有偏差。 - 账号归属来自网关**请求完成后的回写**：流式生成期间不会变，要等这一轮结束才更新（通常数秒内）。归属按会话固定，两个并发会话各记各的账号；但如果首轮归属就匹配错（两个会话的请求完成时刻太接近），该会话会一直沿用第一次结果——这是「不来回切」的取舍。 - WorkBuddy 的「当日消耗」需要先有余额基线：新版 Host 在某个账号上第一次看到余额后开始累计，首次运行当天可能只从运行时算起（网关没有按日积分接口）；账本落盘后重启 DSH 不会清零。Qoder 的当日消耗来自用量台账，可从当天 0 点起精确重算。 - 只有 free-egg provider（默认 `free-egg` / `workbuddy` / `qoder` / `new-api`）的对话计积分；其他 provider（如 DeepSeek 官方账号）只显示 token、积分为 `—`，底栏也不显示。 - 未实测模型的单价是**倍率折算的估算值**：两台网关各自用本机实测数据校准，换模型 / 上游调价后可能有偏差；配置 `creditsPer1k` 可精确覆盖。 - Qoder 实测单价包含缓存命中的折扣（本项目实测一度有 98% 输入命中缓存），是「该模型近期实际平均」；同一模型换用法（缓存比例变化）会带来偏差。 - free-egg 聚合别名的自动匹配按「去版本号归一」进行，跨网关同名家族（如 DeepSeek-Flash / deepseek-v4.1-flash）能对上；若有歧义，用 `creditsPer1k` 显式指定。 - 签到状态以网关为准：WorkBuddy 来自一次幂等签到调用的返回，Qoder 来自网关 `/tasks` 的 `daily_checkin`（回落面板 `lastCheckin`）；「已签到」不代表当天奖励积分一定已到账 （见上文「已签到 ≠ 当天积分已到账」）。关闭 `autoCheckin` 后 WorkBuddy 状态可能为「未知」。 - Qoder 积分为上游 registered 口径（`credits_remain` / `credits_size`），签到或消费后由网关写回； 退化账本（`isQuotaExceeded` 且 size/remain 为 null）显示「—」而不是 0——余额未知和「一分没有」是两回事。 快照缓存 60 秒，设置页点刷新可强制重拉。 - 每日积分预算的**强制**在网关侧：插件只读展示，不参与选号或拦截。旧网关没有预算字段、或 Qoder 面板 `/accounts` 不可用时，界面回到 1.3.0 的「今日消耗」样式（Qoder 沿用上次成功值）； Qoder 面板 `/accounts` 默认只返回当前域的账号，插件已显式带 `?realm=all`；网关不支持该参数时 跨域账号仍可能拿不到预算数据。 - 「积分优先消耗」的切换改的是 new-api 渠道优先级，需要管理员 access token；token 轮换/失效后 切换会失败并在设置页提示（更新 `accessTokenFile` 即可，Host 会按文件 mtime 重读）。如果 new-api 里两个渠道 id 不是默认的 13/12，需要按实际配置 `channels`。渠道优先级被别的进程改过时， 界面会显示「选择与实际不一致」，以实际状态为准。若某渠道被 new-api 自动禁用，插件只改优先级、 不会替你启用渠道，需要到 new-api 控制台手动启用。 - 契合最新 DSH 的 `slots` / `webServer` / `session/event` 机制；DSH 大版本改动后可能需要跟进适配。 - 「积分优先消耗」是 1.5.0 新增的 Host 能力：升级后需要**重启 DSH** 才出现（只刷新页面的话 UI 会 随 `routing` 字段缺失自动隐藏）。