@goodandready/dsh-subscriptions

中文文档
0.8.1发布于 2026/11/17MITES Module近 30 天下载 2.4万

使用 ChatGPT Codex, Claude, Grok, Antigravity, Kimi, GLM, Cursor, Kiro, 副驾驶, Quen, ERNIE, Spark, JetBrains, Persplexity, Replit, 以及 Cody 订阅作为 DeepSeek Harness LLM 供应商通过 OAuth 提供.

中文使用文档
文档目录37 节
  1. DeepSeek Harness 个人 AI 订阅桥接、多账号池轮换与零泄漏 OAuth 插件
  2. ⚡ 插件概览
  3. ✨ 核心功能
  4. 支持的 16 个内置订阅供应商
  5. 多账号轮换与限流保护
  6. 安全与无头登录
  7. 账号级代理
  8. 本地 Ollama 网关与无缝回退
  9. Effort、Verbosity 与 Fast Mode
  10. 按模型家族的冷却与模型过滤
  11. 隐私模式与诊断报告
  12. 隔离管理、动态额度重置倒计时与应用内弹窗提醒
  13. 🩺 服务商鉴权诊断、网络延迟 RTT 指标、动态模型同步与客户端轻量化
  14. 🛡️ 弹性容灾、故障诊断与跨服务商回退
  15. Antigravity 分档思考模型、工具回放哨兵与流式自愈
  16. xAI Grok RFC 8628 设备码授权流支持
  17. Claude 账户级计费归因隔离与动态轮次索引
  18. Antigravity 客户端密钥架构与无感 CLI 令牌刷新
  19. HTTP API 路由
  20. 📦 安装指南
  21. ⚙️ 配置参考( settings.yaml )
  22. 自定义供应商与主机信任
  23. 🧠 Claude 自适应思考与推理深度控制
  24. 🌐 完整双语支持 (EN / ZH) 与单账户健康探活
  25. 🚀 一键插件自更新与稳定性强化
  26. 🛡️ Token 用量规范化与会话投影修复
  27. 🔒 OAuth Client ID 校验保护与控制台地址更新
  28. 🛡️ 稳定性与代码质量强化
  29. 🔌 HTTP API
  30. 核心与状态
  31. 账号、轮换与推理
  32. 统计分析、经济价值与并发
  33. OAuth 与设备码授权
  34. 加密保管库与同步
  35. 诊断与实用工具
  36. 🌐 本地化
  37. 📄 开源协议

📦 @goodandready/dsh-subscriptions

DeepSeek Harness 个人 AI 订阅桥接、多账号池轮换与零泄漏 OAuth 插件

npm version license DSH Plugin Node version

作者全部项目

🇬🇧 English • 🇷🇺 Русский • 🇨🇳 中文说明


⚡ 插件概览

dsh-subscriptions 将您现有的付费个人 AI 订阅无缝接入 DeepSeek Harness,作为第一类模型服务商。

无需为日常智能体任务支付昂贵的 API 按量计费。本插件支持标准 OAuth PKCE 鉴权、单服务商多账号池动态轮换(遭遇 429 限流时自动秒切可用账号)、前置配额平滑切换,并通过进程内 Cordis 服务 (ctx.subscriptions) 赋能 dsh-image-gen 与 dsh-grok-xsearch 等插件,实现 Token 零网络泄漏。

graph LR
    subgraph DSHCore [DeepSeek Harness 对话流]
        Agent[🤖 智能体任务执行] --> Router{服务商路由器}
    end

    subgraph SubscriptionsCore [dsh-subscriptions 调度核心]
        Router --> Pool{多账号负载池}
        Pool -->|账号 1| Acc1[👤 主账号: 活跃中]
        Pool -->|账号 2| Acc2[👤 副账号: 待命中]
        Pool -->|账号 3| Acc3[👤 备用账号: 冷却中]
        Acc1 -->|HTTP 429 / 配额耗尽| Rotate[智能配额与冷却轮换器]
        Rotate -->|流量平滑切换| Acc2
    end

    subgraph VendorBridges [4 大服务商桥接适配]
        Acc1 --> B1[ChatGPT / Codex 后端]
        Acc1 --> B2[Claude Pro / Max 协议]
        Acc1 --> B3[xAI / Grok 订阅]
        Acc1 --> B4[Google Cloud Code Assist / Antigravity]
    end

    subgraph EcosystemBridge [Cordis 进程内共享: ctx.subscriptions]
        Pool --> ImgGen[dsh-image-gen: 订阅零成本生图]
        Pool --> XSearch[dsh-grok-xsearch: X 社交搜索]
    end

    style DSHCore fill:#1e1e2e,stroke:#89b4fa,stroke-width:2px,color:#cdd6f4
    style SubscriptionsCore fill:#181825,stroke:#cba6f7,stroke-width:2px,color:#cdd6f4
    style VendorBridges fill:#11111b,stroke:#a6e3a1,stroke-width:2px,color:#cdd6f4
    style EcosystemBridge fill:#181825,stroke:#f38ba8,stroke-width:2px,color:#cdd6f4

✨ 核心功能

支持的 16 个内置订阅供应商

供应商订阅级别协议
codexChatGPT Plus / Pro流式响应、工具调用、图像生成
claudeClaude Pro / Max原生 Messages 协议、用量跟踪
grokxAI / X Premium实时推理、计费检查
antigravityGoogle Cloud Code Assist流式生成
kimiMoonshot KimiOAuth Device Flow 登录(auth.kimi.com)、OpenAI 兼容聊天
glmZ.ai GLM Coding PlanGLM 编码端点(api.z.ai)、实时配额监控
cursorCursorCursor 后端(api2.cursor.sh)、用量面板解析
kiroAWS KiroKiro 桌面 OAuth(app.kiro.dev)、流式输出
copilotGitHub CopilotGitHub Device Flow 登录、Copilot 聊天补全
qwen阿里 Qwen(DashScope)OpenAI 兼容端点、API Key 认证
ernie百度 ERNIE(千帆)OAuth2 令牌刷新(API Key + Secret Key)
spark讯飞星火OpenAI 兼容 HTTP API
jetbrainsJetBrains AI AssistantJetBrains AI 中继(api.jetbrains.ai)
perplexityPerplexity ProSonar 模型目录(api.perplexity.ai)
replitReplit CoreReplit AI API、connect-token 认证
codySourcegraph Cody ProSourcegraph API、access-token 认证

多账号轮换与限流保护

  • 每个供应商可挂多个账号(如 CODEX_OAUTH_1、CODEX_OAUTH_2)。
  • 遇到 429/配额耗尽自动切换到下一个健康账号;支持按剩余量提前切换和动态冷却恢复。
  • 轮换决策追踪与路由解释 (#517):实时同步记录账号选择、轮换切换、失败原因与级联回退的完整决策链路(无需事后推导),并在 WebUI 遥测与诊断报告中可视化展示。
  • 动态模型目录与配额可用性 (#507):基于账号池计算模型综合可用性(单个账号隔离不影响具备可用账号的模型),展示上下文窗口、能力标签(视觉、工具、推理、编码、快速)及动态配额倒计时。

安全与无头登录

  • OAuth 令牌绝不通过 HTTP API 返回,也不在 Web 界面渲染;仅存放于宿主加密凭据存储。
  • 回环自动回调 (autoLoopback):供应商重定向为回环地址(如 Codex :1455)时,插件自动启动临时本地服务器接收回调,无需手动粘贴链接。
  • 设备码登录:完全无浏览器的主机上,点击 Device login,在任意设备打开 https://auth.openai.com/codex/device 输入短码即可完成 PKCE 授权。

账号级代理

  • 每个账号可配置独立代理(http://、https://、socks5://);令牌刷新、供应商检查、模型请求均走该代理。
  • 账号卡片内的 Check proxy 按钮一键检测代理延迟。

本地 Ollama 网关与无缝回退

  • 原生 provider (ollama):本地 Ollama 可达时(ollamaBaseUrl,默认 http://127.0.0.1:11434),自动出现在 DSH 原生模型选择器中(模型来自 /api/tags),无需密钥。
  • 无缝配额回退 (ollamaFallback,默认开启):某供应商的所有账号耗尽或不可达且尚未输出任何内容时,对话自动切换到本地模型(ollamaFallbackModel 或 /api/tags 第一个模型),并记录到请求历史(kind: fallback)。
  • 免费($0)应急通道:无网络、无配额也能用。

Effort、Verbosity 与 Fast Mode

  • 推理力度 (Effort):Codex 模型从实时目录上报支持的力度等级,原生选择器校验后以 reasoning.effort 传入 /responses 协议;Grok 按自身目录过滤转发。
  • 详略程度 (codexVerbosity):low/medium/high 以 text.verbosity 传给 Codex 推理模型;留空为协议默认。
  • Fast Mode (codexFastMode):每次 Codex 请求携带 service_tier: priority(1.5x 速度计费档);启用时活动订阅芯片显示 ⚡。

按模型家族的冷却与模型过滤

  • Reasoning 与 Standard 分离:推理模型(claude *thinking*、grok *reasoning*、全部 codex 模型)触发 429 时,只冷却该账号的 reasoning 家族——同账号的 standard 模型立即可用;旧版冷却仍按整账号生效。
  • 隐藏过时模型 (hideDeprecatedModels):从原生选择器中过滤 test/preview/dev/alpha/beta/legacy 模型 id(同时作用于实时目录与静态回退)。

隐私模式与诊断报告

  • privacyMask:一个开关即可在整个界面隐藏个人数据(邮箱显示为 j***[email protected]),服务端遮蔽,适合屏幕共享。
  • 匿名诊断报告:设置卡片内一键生成(插件/运行时版本、系统、各供应商健康状态、HTTP 状态聚合、最近错误与耗时、非敏感配置)并自动复制到剪贴板;令牌、邮箱、凭据名与代理地址严格排除。
  • 同区块提供问题追踪器链接,便于提交 issue。

隔离管理、动态额度重置倒计时与应用内弹窗提醒

  • 手动隔离管理(暂停与预热探测):支持在设置面板的账户卡片中一键暂停隔离活跃账户(POST /dsh-subscriptions/quarantine/park),或立即触发真实上游预热微探测(probeWarmup)并在验证成功后即时解除隔离(POST /dsh-subscriptions/quarantine/probe)。
  • 动态额度重置倒计时:在顶部会话栏 SubsPill 和账户卡片中秒级动态更新,精准展示滚动配额窗口(five_hour、seven_day、primary_window)的剩余解锁时间。
  • 应用内即时弹窗提醒(Toast):当账户进入隔离、健康恢复解除隔离或额度达到预警线时,在聊天界面弹出轻量级浮动提醒。通过 enableToasts: true 控制。 enableQueue: true # 账户并发请求排队与限流 accountMaxConcurrency: 2 # 单账户最大并行活跃流 maxQueueSize: 20 # 队列最大等待深度 queueTimeoutMs: 30000 # 队列最大等待超时时间(毫秒)
  • 自动化 Webhook 告警集成:通过 notifyQuarantineEntered 与 notifyQuarantineReleased 自动向外部通知系统派发隔离生命周期事件。

🩺 服务商鉴权诊断、网络延迟 RTT 指标、动态模型同步与客户端轻量化

  • 服务商错误诊断系统 (#543): 智能分析与解读服务商连接和鉴权失败原因(Cloudflare 403 / 地区限制、令牌过期、会话失效、模型权限不足、用量配额耗尽),并在卡片中直接展示修复建议。
  • 延迟 RTT 指标与快速 Ping 测试 (#542): 实时测量至服务商 API 的网络往返时间,支持色彩标记状态徽章(🟢 <250ms, 🟡 <750ms, 🔴 >750ms)及独立 POST /dsh-subscriptions/ping 接口。
  • 动态模型列表同步 (#541): 账户卡片一键「同步模型」按钮,直接从服务商 /v1/models 接口获取最新及账号专享模型,无需等待插件版本更新。
  • 客户端包体积优化 (#540): 将 lib/client.js 体积从 217.3 KiB 缩减至 199 KiB 以下(距离 256 KiB DSH Store 门禁阈值预留超 57 KiB 安全冗余空间)。

🛡️ 弹性容灾、故障诊断与跨服务商回退

  • 跨服务商级联故障转移与优先级排序 (#536): 支持自定义跨服务商回退顺序,可在 WebUI 中通过 ▲/▼ 交互调整优先级。
  • 一键链路测试与延迟检测 (#536): 在账户列表或状态弹窗中一键发起探活并显示往返延迟。
  • 冷却倒计时与就绪通知 (#536): 实时展示受限账户恢复倒计时,解除冷却时自动弹出就绪通知。
  • 主动 OAuth 令牌心跳 (#536): 提前预刷即将过期的访问令牌,避免用户请求时产生额外等待。
  • 最近错误环形日志审查 (#536): 内存保存最近 20 条已脱敏的运行错误,支持在 Diagnostics 中查看与清空。

Antigravity 分档思考模型、工具回放哨兵与流式自愈

  • Gemini 3 工具回放哨兵 (#534):在重建的工具调用中注入 thoughtSignature: 'skip_thought_signature_validator',彻底解决多轮工具调用历史重放时 Gemini 3 的校验失败问题。
  • 分档 Flash 模型与思考档位 (#534):将 gemini-3.8-flash-tiered 与 3.7 自动解析展开为 High/Medium/Low 档位选择,并在调用时自动组装 thinkingConfig.thinkingLevel。
  • 流式空响应自愈与账号轮换 (#534):引入 30 秒 SSE 空闲超时保护与空响应检测,在未输出前自动重试一次,失败时通过 EMPTY_RESPONSE / TIMEOUT 自动轮换至下一个可用账号。

xAI Grok RFC 8628 设备码授权流支持

  • RFC 8628 设备码授权流 (GH #17, #532):为 xAI Grok 新增原生设备码登录授权支持。彻底解决 xAI 针对 CLI 客户端标识返回 Grok Build 验证码页面且不触发回环重定向回调导致的死锁问题。直接在槽位卡片展示用户授权码,并自动在后台轮询兑换会话令牌。

Claude 账户级计费归因隔离与动态轮次索引

  • 按账户隔离 cc_turn_index 与 cch (#530):将 Claude Code 计费归因状态(会话哈希 cch 与递增轮次 cc_turn_index)按 accountId 隔离在有界模块级映射表中,彻底消除 globalThis 跨订阅账户状态混用问题。
  • 动态计算 cc_prompt_index 与禁用开关:根据多轮对话消息历史自动计算从 0 开始的 cc_prompt_index,并支持通过环境变量 CLAUDE_CODE_ATTRIBUTION_HEADER=0 或 disableBillingHeader: true 禁用归因头注入。

Antigravity 客户端密钥架构与无感 CLI 令牌刷新

  • 配置架构密钥字段 (antigravityClientSecret):支持用户在设置中自定义配置 Google Cloud OAuth 客户端密钥(Client Secret),公共接口自动脱敏掩码 (••••••),彻底解决机密型 OAuth 客户端刷新令牌被拒的问题。
  • CLI 令牌零配置平滑刷新:内置官方 Gemini / Antigravity CLI 客户端的公共应用凭据 (Google Gemini CLI Client ID / Google Gemini CLI Client Secret),使通过 📥 从 CLI 导入 的会话能够持久无限刷新,不再出现 1 小时后失效问题。
  • Windows 凭据管理器自动发现:原生支持在 win32 系统下自动检测 Windows 凭据管理器中的 gemini:antigravity 目标,直接完成 CLI 会话导入。
  • 清晰明确的错误指引:在缺少密钥或上游凭据异常时抛出指引性错误,替代原始的 HTTP 400 提示。

HTTP API 路由

路由方法用途
/dsh-subscriptions/diagnosticsGET匿名诊断报告(无密钥、无令牌、无代理地址)
/dsh-subscriptions/proxy-checkPOST检测槽位代理到供应商基础地址的延迟
/dsh-subscriptions/oauth/device/startPOST发起 Codex 设备码登录(返回用户码与验证地址)
/dsh-subscriptions/oauth/device/pollPOST轮询设备码授权状态
/dsh-subscriptions/quarantine/parkPOST将指定账户临时暂停隔离(支持 durationMs 与 reason)
/dsh-subscriptions/quarantine/probePOST立即执行健康预热探测或提前解除账户隔离
/dsh-subscriptions/alertsGET获取近期应用内告警与通知列表

📦 安装指南

dsh plugin --profile web add @goodandready/dsh-subscriptions

⚙️ 配置参考(settings.yaml)

dsh-subscriptions:
  switchAtRemaining: 1
  cooldownMs: 60000
  autoLoopback: true        # 自动监听本地回调端口并捕获 OAuth 令牌
  privacyMask: false        # 在 Web UI 中脱敏邮箱和账号标识符
  ollamaBaseUrl: http://127.0.0.1:11434  # 本地 Ollama 网关地址
  ollamaFallback: true      # 订阅全部耗尽时无缝降级到本地模型
  ollamaFallbackModel: ''   # 降级模型(为空默认使用 /api/tags 中的第一个)
  hideDeprecatedModels: false # 过滤测试/预览/废弃模型
  codexVerbosity: ''        # low | medium | high
  codexFastMode: false      # 优先使用 1.5x 速率服务档位
  composerQuota: 'off'      # 输入框配额指示器: off | percent | bar | forecast
  composerQuotaDisplay: 'hidden' # 状态栏配额范围: current | hidden
  sidebarQuotaDisplay: 'off' # 侧边栏底部配额显示: off | auto | always
  showSpeedToggle: false    # 在输入栏显示 Codex 极速模式按钮
  showSubsPill: false       # 在对话标题栏显示 SUBS 订阅胶囊
  enableToasts: true        # 隔离与配额事件的实时弹窗通知
  enableQueue: true         # 有界并发队列,防止瞬时并发触发 429
  accountMaxConcurrency: 2  # 单账号最大并发活动请求数
  maxQueueSize: 20          # 队列最大等待深度
  queueTimeoutMs: 30000     # 队列等待超时时间(毫秒)
  accounts:
    codex:
      - ref: CODEX_OAUTH_1
        label: "Work Pro Account"
      - ref: CODEX_OAUTH_2
        label: "Personal Plus Account"
    claude:
      - ref: CLAUDE_OAUTH_1
        label: "Claude Max"
    grok:
      - ref: GROK_OAUTH_1
        label: "X Premium"

自定义供应商与主机信任

  • customVendors.authUrl、tokenUrl 和 baseUrl 必须使用 https://。明文 http:// 仅允许用于回环主机(localhost、127.0.0.1、::1)。
  • Grok baseUrl 覆盖只能指向 api.x.ai、grok.com / *.grok.com 或回环主机;其他主机会以 GROK_UNTRUSTED_HOST 拒绝,避免 bearer 令牌离开可信的 xAI 基础设施。
  • Antigravity CLI 导入必须配置 antigravityClientSecret;内置默认值已移除。
  • copilotCliPath 必须指向 copilot、github-copilot-cli 或 copilot-cli 可执行文件;自定义包装器请重命名。
  • 凭据备份使用 /dsh-subscriptions/vault/export 和 /vault/import;旧路由 /export、/import、/export-backup、/import-backup 已移除。
  • 错误缓冲区和诊断报告会在存储或返回前脱敏 bearer 令牌、API 密钥、JWT 和 key=value 凭据。

🧠 Claude 自适应思考与推理深度控制

支持 Anthropic 自适应思考 (thinking: { type: "adaptive" }) 及推理深度调节 (output_config: { effort }):

  • 模型支持: 针对 Opus 4.6+、Opus 4.7+、Opus 5 (low, medium, high, xhigh, max) 及 Sonnet 4.6+、Sonnet 5 (low, medium, high) 自动提供对应推理级别。
  • 安全降级: 不支持自适应思考的模型(如 Haiku、Fable、4.5 及更早版本)保持原始请求,防止出现 400 Bad Request 错误。
  • 动态目录: 模型列表自动暴露 reasoning.efforts,供 DeepSeek Harness 界面选择。

🌐 完整双语支持 (EN / ZH) 与单账户健康探活

  • 原生双语支持: 内置 UI 字典全面提供英语 (en) 与简体中文 (zh) 翻译,所有服务商获取令牌指引均具备中英双语版。
  • 解耦外部翻译: 俄语等其他语种由独立语言包插件(如 dsh-russian-lang)在运行时翻译,插件源码保持纯净零硬编码。
  • 单账户实时探活与延迟测量: 槽位中的“检测”按钮实时测量对应订阅账户的双向响应延迟 (latencyMs) 与健康状态。

🚀 一键插件自更新与稳定性强化

  • 宿主端一键更新: 挂载于 /dsh-subscriptions/update 的就地更新机制,自动对比 npm registry 最新版本并通过宿主 DSH CLI 执行单飞安装 (dsh plugin add)。
  • 安全与来源防护: 更新接口严格校验环回地址(支持 IPv4 127.0.0.1、IPv6 ::1、localhost)、x-dsh-plugin-update 请求头及同源策略,阻断未授权跨站调用。
  • 状态栏徽章与更新按钮: 设置面板顶部状态栏显示当前插件版本,有新版本时提示告警徽章并提供一键更新按钮与重启提示。
  • 网络超时熔断: 配额检测与冒烟测试增加 15 秒超时信号保护 (AbortSignal.timeout(15_000)),防止外部服务商接口故障导致请求挂起。
  • 参数容错与逻辑去重: 状态接口兼容 provider || vendor 与 index || accountIndex 参数别名,并消除 lib/accounts.js 中的重复配额通知循环。


🛡️ Token 用量规范化与会话投影修复

  • 会话投影崩溃修复 (GitHub #4):修复了使用 ChatGPT Codex 及其他流式模型时,首次回复后会话损坏、刷新页面报错 received NaN, expected number on uncachedInputTokens and outputTokens 且无法加载的问题。
  • 全格式通用 TokenUsage 转换:在所有流式传输通道(codexResponsesStream、openaiChatStream、anthropicStream、googleStream)中引入统一的 toTokenUsage() 转换逻辑,将各服务商的原始用量数据标准化为 DSH 规范的 TokenUsage 接口(inputTokens、outputTokens、cacheReadTokens、cacheWriteTokens、reasoningTokens、totalTokens)。
  • 严格非负整数保底与独立缓存计算:对所有 token 计数实施严格的非负整数约束(保底为 0,杜绝 NaN 与 undefined)。针对将缓存合并计入总 prompt 的供应商自动执行拆分,确保输入 token 数的准确性。
  • 适配器层纵深防御:在 SubscriptionAdapter 中新增用量数据过滤与净化机制,从根源上阻止异常用量流入 DSH 会话持久化与状态恢复流程。

🔒 OAuth Client ID 校验保护与控制台地址更新

  • Google OAuth Client ID 校验保护 (GitHub #2):uildAuthorizeUrl 和 ntigravity.authorizeUrl 严格要求非空 clientId。未配置时服务端返回明确的 HTTP 400 (missing_client_id),前端界面提示用户在插件设置中填写 ntigravityClientId 或使用“📥 从 CLI 导入”,避免浏览器跳转至 Google OAuth 400 报错页面。
  • 配置架构新增密钥项:在插件 Config 架构中新增 ntigravityClientSecret,方便用户在设置中配置客户端密钥,并在公共接口中自动脱敏脱密。
  • 智谱 GLM 控制台地址迁移 (GitHub #3):将智谱 GLM 授权与 API Key 获取链接更新为最新控制台有效路由 (https://bigmodel.cn/usercenter/proj-mgmt/apikeys),彻底解决因服务商控制台路由调整导致的 404 错误。

🛡️ 稳定性与代码质量强化

  • 结构化异常降级: 全面移除运行时空 catch 块,统一采用带诊断日志的 bestEffort 安全兜底机制。
  • 原生上下文日志: 所有日志统一接入 Cordis 规范子系统 ctx.logger('subscriptions')。
  • 外部网络超时保护: 为所有模型商 API 网络调用(listModels、fetchFor、quotaFetch、jsonTokenRequest)建立 fetchWithTimeout 与 AbortSignal.timeout 超时熔断保护。
  • 设计系统主题对齐: 将 client.js 中的静态样式硬编码替换为 DeepSeek Harness 原生 CSS 主题令牌(--dsw-alias-*、color-mix),彻底消除独立的 rgba 颜色。
  • 客户端依赖注入显式化: 在 package.json 清单中显式声明前端所需平台注入项(@deepseek-ai/dsh-client-locale 与 @deepseek-ai/dsh-client-ui-slots)。
  • 公开仓库卫生规范: 将内部研发指令与计划文件移出 Git 跟踪并加入 .gitignore,确保公开版本干净无私有残余。

🔌 HTTP API

插件在 DSH Web 服务器上注册以下 55 个精确路由。除特别说明外,接受同源或 loopback 请求;写入操作必须携带与 Host 匹配的 Origin 或 Referer(#782)。响应均为 JSON(除非另有说明)。

核心与状态

方法路径用途
GET/dsh-subscriptions/status全局状态、配置的槽位、活跃用量与额度
GET/dsh-subscriptions/health供监控使用的深度健康检查报告(#745);公开 GET
GET/dsh-subscriptions/metricsPrometheus 文本指标(#744);仅 loopback 或同源
GET/dsh-subscriptions/models当前活跃订阅的增强模型目录
POST/dsh-subscriptions/heartbeat/run触发一次额度与健康状态刷新;返回 {ok, refreshed}(#968)
GET/dsh-subscriptions/subscriptions仅限 localhost 的自适应 HTML 订阅概览表格(#1021)
GET/dsh-subscriptions/telemetry请求计数聚合、平均延迟与成功率
GET/dsh-subscriptions/usage面向外部配额插件的额度快照与调用账本(#687)
POST/dsh-subscriptions/smoke针对活跃供应商发起合成连通性测试请求
GET/dsh-subscriptions/ping轻量级往返网络延迟检测
GET/dsh-subscriptions/instructions动态供应商连接操作指引(#540)
GET/dsh-subscriptions/alerts应用内近期警报与通知列表

账号、轮换与推理

方法路径用途
GET/PUT/dsh-subscriptions/config配置架构读取与原子化更新
POST/dsh-subscriptions/check校验账号凭据并从供应商 API 获取最新配额
POST/dsh-subscriptions/logout断开指定账号槽位并清除存储的凭据
GET/dsh-subscriptions/discover-local扫描发现宿主机上已登录的本地 CLI 会话
POST/dsh-subscriptions/import-local将发现的本地 CLI 凭据导入账号槽位
POST/dsh-subscriptions/import-token手动导入刷新令牌或 API 密钥
POST/dsh-subscriptions/accounts/sync-models从上游供应商拉取并同步可用模型列表
POST/dsh-subscriptions/accounts/switch-organization为 Codex 账号切换活跃组织
POST/dsh-subscriptions/quarantine/park手动将账号置入隔离状态(支持 durationMs 与 reason)
POST/dsh-subscriptions/quarantine/probe执行预热探测或立即解除账号隔离
GET/POST/dsh-subscriptions/reset-credits查看、准备并消费 Codex 额度重置信用点
GET/dsh-subscriptions/routing/trace实时路由决策审计日志与原因统计(#1028)
GET/POST/DEL/dsh-subscriptions/session-reasoning会话级推理思考预算与档位覆盖管理
GET/POST/dsh-subscriptions/speed会话级 Codex 极速模式(fast-tier)开关

统计分析、经济价值与并发

方法路径用途
GET/dsh-subscriptions/analytics缓存命中率、24小时请求分桶、热力图与额度耗尽预测
GET/dsh-subscriptions/analytics/savings交付价值估算、提示词缓存节省费用与多周期 ROI 报告(#1029)
GET/dsh-subscriptions/queue实时并发队列深度与活跃并发请求监控(#518)
GET/dsh-subscriptions/history历史请求明细与耗时账本

OAuth 与设备码授权

方法路径用途
GET/dsh-subscriptions/oauth/start发起浏览器 OAuth 授权登录流程
GET/dsh-subscriptions/oauth/callbackOAuth 本地回环端口回调监听服务(#1019)
POST/dsh-subscriptions/oauth/complete提交重定向 URL 或授权码完成登录绑定
POST/dsh-subscriptions/oauth/device/start发起 RFC 8628 设备码授权(Codex、Grok、Copilot)
POST/dsh-subscriptions/oauth/device/poll轮询设备码授权确认状态
GET/dsh-subscriptions/oauth/headless-info无头服务器远程连接所需的 SSH 隧道命令与 SVG 二维码
GET/dsh-subscriptions/oauth/headless-redirect引导浏览器直连上游供应商授权登录页

加密保管库与同步

方法路径用途
GET/POST/dsh-subscriptions/vault/snapshots查看或手动创建本地加密拉取前快照(#734)
POST/dsh-subscriptions/vault/snapshots/restore从快照安全恢复账号凭据,支持失败自动回滚(#1003, #1022)
POST/dsh-subscriptions/vault/export导出可移植加密备份归档文件
POST/dsh-subscriptions/vault/import导入并解密便携式备份归档文件
GET/dsh-subscriptions/vault/sync/status远程 Git 保管库同步状态检查
POST/dsh-subscriptions/vault/sync/push将本地加密快照推送到远程保管库
POST/dsh-subscriptions/vault/sync/pull从远程保管库拉取并应用快照

诊断与实用工具

方法路径用途
GET/dsh-subscriptions/diagnostics匿名化系统与健康诊断报告(严格排除所有私密凭据)
POST/dsh-subscriptions/diagnostics/errors/clear清理近期错误缓冲区
POST/dsh-subscriptions/diagnostic-wizard自动化故障排查向导
POST/dsh-subscriptions/webhook/test测试向配置的 Webhook 发送探活事件
POST/dsh-subscriptions/proxy-check检测代理到供应商上游网关的连接延迟
GET/dsh-subscriptions/sources列出活跃上下文源与集成状态
POST/dsh-subscriptions/provider-packs/validate校验第三方自定义供应商扩展包规范

🌐 本地化

插件源语言仅为英语。俄语及其他翻译由独立的语言插件(如俄化插件)在运行时对注册的本地化键进行翻译,包本身不内置翻译(Changed in 0.6.1)。


📄 开源协议

MIT © GooDAnDReaDY

版本与发布记录

@goodandready/dsh-subscriptions 共发布 224 个版本,首次发布于 2026/08/21;过去 12 个月发布了 224 个版本。

版本发布日期距今
0.8.1latest2026/11/17今天
0.8.02026/11/151 天前
0.7.892026/11/151 天前
0.7.882026/11/152 天前
0.7.872026/11/152 天前
0.7.862026/11/152 天前

关于 @goodandready/dsh-subscriptions 的常见问题

@goodandready/dsh-subscriptions 是什么?

使用 ChatGPT Codex, Claude, Grok, Antigravity, Kimi, GLM, Cursor, Kiro, 副驾驶, Quen, ERNIE, Spark, JetBrains, Persplexity, Replit, 以及 Cody 订阅作为 DeepSeek Harness LLM 供应商通过 OAuth 提供.

如何安装 @goodandready/dsh-subscriptions?

在项目目录运行 npm install @goodandready/dsh-subscriptions,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@deepseek-ai/cordis(^4.0.1)、@deepseek-ai/dsh-llm(^0.1.7-rc.2 || ^0.2.0-rc.1)、@deepseek-ai/schemastery(^3.18.4)、@deepseek-ai/dsh-settings(^0.1.7-rc.2 || ^0.2.0-rc.1)、@deepseek-ai/dsh-credentials(^0.1.7-rc.2 || ^0.2.0-rc.1)、@deepseek-ai/dsh-host-webserver(^0.1.7-rc.2 || ^0.2.0-rc.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 dsh-subscriptions,可以用 npx dsh-subscriptions 直接运行。

@goodandready/dsh-subscriptions 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/goodandready__dsh-subscriptions 是否存在。

@goodandready/dsh-subscriptions 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@goodandready/dsh-subscriptions 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.19.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@goodandready/dsh-subscriptions 可以商用吗?

@goodandready/dsh-subscriptions 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@goodandready/dsh-subscriptions 的下载量有多少?

根据 npm 官方下载统计,@goodandready/dsh-subscriptions 在 2026/10/17 – 2026/11/15 这 30 天内被下载 23,935 次,日均约 798 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@goodandready/dsh-subscriptions 还在维护吗?

最新版本 0.8.1 发布于 2026/11/17(今天);至今共发布 224 个版本,其中过去 12 个月发布了 224 个;首次发布于 2026/08/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。