@xixka/dsh-hub 0.4.7 → 0.4.9-rc.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1085 -93
- package/docs/DETAIL.md +66 -0
- package/docs/DETAIL.zh.md +40 -0
- package/lib/accio-adapter.d.ts +30 -1
- package/lib/accio-adapter.d.ts.map +1 -1
- package/lib/accio-adapter.js +102 -15
- package/lib/accio-adapter.js.map +1 -1
- package/lib/account-pool.d.ts +61 -106
- package/lib/account-pool.d.ts.map +1 -1
- package/lib/account-pool.js +269 -275
- package/lib/account-pool.js.map +1 -1
- package/lib/account-probe.d.ts +5 -1
- package/lib/account-probe.d.ts.map +1 -1
- package/lib/account-probe.js +8 -5
- package/lib/account-probe.js.map +1 -1
- package/lib/aggregate-adapter.d.ts +0 -38
- package/lib/aggregate-adapter.d.ts.map +1 -1
- package/lib/aggregate-adapter.js +43 -138
- package/lib/aggregate-adapter.js.map +1 -1
- package/lib/aggregate-core.d.ts +50 -0
- package/lib/aggregate-core.d.ts.map +1 -1
- package/lib/aggregate-core.js +80 -0
- package/lib/aggregate-core.js.map +1 -1
- package/lib/aggregate-dispatch-context.d.ts +57 -0
- package/lib/aggregate-dispatch-context.d.ts.map +1 -0
- package/lib/aggregate-dispatch-context.js +77 -0
- package/lib/aggregate-dispatch-context.js.map +1 -0
- package/lib/aggregate-expiry.d.ts +1 -1
- package/lib/aggregate-expiry.js +1 -1
- package/lib/astudio-adapter.d.ts +34 -14
- package/lib/astudio-adapter.d.ts.map +1 -1
- package/lib/astudio-adapter.js +42 -25
- package/lib/astudio-adapter.js.map +1 -1
- package/lib/astudio-product.d.ts +60 -19
- package/lib/astudio-product.d.ts.map +1 -1
- package/lib/astudio-product.js +36 -18
- package/lib/astudio-product.js.map +1 -1
- package/lib/astudio.d.ts +68 -22
- package/lib/astudio.d.ts.map +1 -1
- package/lib/astudio.js +420 -28
- package/lib/astudio.js.map +1 -1
- package/lib/atomcode-adapter.d.ts.map +1 -1
- package/lib/atomcode-adapter.js +1 -2
- package/lib/atomcode-adapter.js.map +1 -1
- package/lib/auto-checkin.d.ts +15 -10
- package/lib/auto-checkin.d.ts.map +1 -1
- package/lib/auto-checkin.js +31 -30
- package/lib/auto-checkin.js.map +1 -1
- package/lib/autoclaw-adapter.d.ts +1 -1
- package/lib/autoclaw-adapter.d.ts.map +1 -1
- package/lib/autoclaw-adapter.js +4 -4
- package/lib/autoclaw-adapter.js.map +1 -1
- package/lib/backup.d.ts +2 -22
- package/lib/backup.d.ts.map +1 -1
- package/lib/backup.js +20 -43
- package/lib/backup.js.map +1 -1
- package/lib/baizhi-adapter.d.ts.map +1 -1
- package/lib/baizhi-adapter.js +1 -2
- package/lib/baizhi-adapter.js.map +1 -1
- package/lib/balance-cache.d.ts +0 -36
- package/lib/balance-cache.d.ts.map +1 -1
- package/lib/balance-cache.js +0 -23
- package/lib/balance-cache.js.map +1 -1
- package/lib/buddy-adapter.d.ts +11 -1
- package/lib/buddy-adapter.d.ts.map +1 -1
- package/lib/buddy-adapter.js +38 -7
- package/lib/buddy-adapter.js.map +1 -1
- package/lib/buddy-balance-rank.d.ts +67 -0
- package/lib/buddy-balance-rank.d.ts.map +1 -1
- package/lib/buddy-balance-rank.js +80 -0
- package/lib/buddy-balance-rank.js.map +1 -1
- package/lib/buddy-balance-selector.d.ts +19 -0
- package/lib/buddy-balance-selector.d.ts.map +1 -1
- package/lib/buddy-balance-selector.js +18 -2
- package/lib/buddy-balance-selector.js.map +1 -1
- package/lib/buddy-oauth.d.ts.map +1 -1
- package/lib/buddy-oauth.js +34 -1
- package/lib/buddy-oauth.js.map +1 -1
- package/lib/buddy.d.ts +42 -0
- package/lib/buddy.d.ts.map +1 -1
- package/lib/buddy.js +106 -4
- package/lib/buddy.js.map +1 -1
- package/lib/canonical-models.d.ts.map +1 -1
- package/lib/canonical-models.js +175 -7
- package/lib/canonical-models.js.map +1 -1
- package/lib/chromium-session.d.ts +29 -85
- package/lib/chromium-session.d.ts.map +1 -1
- package/lib/chromium-session.js +33 -236
- package/lib/chromium-session.js.map +1 -1
- package/lib/client/jet-hub.js +18452 -107
- package/lib/cline-adapter.d.ts +2 -10
- package/lib/cline-adapter.d.ts.map +1 -1
- package/lib/cline-adapter.js +7 -23
- package/lib/cline-adapter.js.map +1 -1
- package/lib/cline-models.d.ts +11 -13
- package/lib/cline-models.d.ts.map +1 -1
- package/lib/cline-models.js +9 -41
- package/lib/cline-models.js.map +1 -1
- package/lib/codearts-credits.d.ts.map +1 -1
- package/lib/codearts-credits.js +6 -7
- package/lib/codearts-credits.js.map +1 -1
- package/lib/codearts-identity.d.ts +109 -0
- package/lib/codearts-identity.d.ts.map +1 -0
- package/lib/codearts-identity.js +189 -0
- package/lib/codearts-identity.js.map +1 -0
- package/lib/codearts-vision.d.ts +8 -9
- package/lib/codearts-vision.d.ts.map +1 -1
- package/lib/codearts-vision.js +8 -10
- package/lib/codearts-vision.js.map +1 -1
- package/lib/codely-adapter.d.ts.map +1 -1
- package/lib/codely-adapter.js +2 -5
- package/lib/codely-adapter.js.map +1 -1
- package/lib/credential-resolver.d.ts +17 -1
- package/lib/credential-resolver.d.ts.map +1 -1
- package/lib/credential-resolver.js +96 -2
- package/lib/credential-resolver.js.map +1 -1
- package/lib/credits.d.ts +10 -0
- package/lib/credits.d.ts.map +1 -1
- package/lib/credits.js +65 -2
- package/lib/credits.js.map +1 -1
- package/lib/dead-model-store.d.ts.map +1 -1
- package/lib/dead-model-store.js +24 -2
- package/lib/dead-model-store.js.map +1 -1
- package/lib/doubao-credits.d.ts +52 -0
- package/lib/doubao-credits.d.ts.map +1 -0
- package/lib/doubao-credits.js +61 -0
- package/lib/doubao-credits.js.map +1 -0
- package/lib/doubao-login.d.ts +118 -0
- package/lib/doubao-login.d.ts.map +1 -0
- package/lib/doubao-login.js +438 -0
- package/lib/doubao-login.js.map +1 -0
- package/lib/doubao-signin.d.ts +58 -0
- package/lib/doubao-signin.d.ts.map +1 -0
- package/lib/doubao-signin.js +405 -0
- package/lib/doubao-signin.js.map +1 -0
- package/lib/doubao.d.ts +94 -0
- package/lib/doubao.d.ts.map +1 -0
- package/lib/doubao.js +186 -0
- package/lib/doubao.js.map +1 -0
- package/lib/gemini-adapter.d.ts +1 -1
- package/lib/gemini-adapter.d.ts.map +1 -1
- package/lib/gemini-adapter.js +4 -10
- package/lib/gemini-adapter.js.map +1 -1
- package/lib/image-budget.d.ts +11 -3
- package/lib/image-budget.d.ts.map +1 -1
- package/lib/image-budget.js +5 -43
- package/lib/image-budget.js.map +1 -1
- package/lib/index.d.ts +51 -0
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +237 -239
- package/lib/index.js.map +1 -1
- package/lib/jet-hub-rpc.d.ts +18 -89
- package/lib/jet-hub-rpc.d.ts.map +1 -1
- package/lib/jet-hub-rpc.js +1258 -366
- package/lib/jet-hub-rpc.js.map +1 -1
- package/lib/jet-hub-store.d.ts +110 -49
- package/lib/jet-hub-store.d.ts.map +1 -1
- package/lib/jet-hub-store.js +141 -36
- package/lib/jet-hub-store.js.map +1 -1
- package/lib/llm-adapter.d.ts +97 -33
- package/lib/llm-adapter.d.ts.map +1 -1
- package/lib/llm-adapter.js +191 -47
- package/lib/llm-adapter.js.map +1 -1
- package/lib/llm-register-compat.d.ts +0 -57
- package/lib/llm-register-compat.d.ts.map +1 -1
- package/lib/llm-register-compat.js +30 -91
- package/lib/llm-register-compat.js.map +1 -1
- package/lib/lobsterai-adapter.d.ts +1 -1
- package/lib/lobsterai-adapter.d.ts.map +1 -1
- package/lib/lobsterai-adapter.js +18 -57
- package/lib/lobsterai-adapter.js.map +1 -1
- package/lib/lobsterai-auth.d.ts.map +1 -1
- package/lib/lobsterai-auth.js +2 -1
- package/lib/lobsterai-auth.js.map +1 -1
- package/lib/login.d.ts +90 -5
- package/lib/login.d.ts.map +1 -1
- package/lib/login.js +297 -106
- package/lib/login.js.map +1 -1
- package/lib/loomy-adapter.d.ts +1 -4
- package/lib/loomy-adapter.d.ts.map +1 -1
- package/lib/loomy-adapter.js +9 -67
- package/lib/loomy-adapter.js.map +1 -1
- package/lib/marvis-adapter.d.ts +13 -3
- package/lib/marvis-adapter.d.ts.map +1 -1
- package/lib/marvis-adapter.js +105 -7
- package/lib/marvis-adapter.js.map +1 -1
- package/lib/marvis-identity.d.ts +106 -0
- package/lib/marvis-identity.d.ts.map +1 -0
- package/lib/marvis-identity.js +144 -0
- package/lib/marvis-identity.js.map +1 -0
- package/lib/marvis-messages.d.ts +65 -4
- package/lib/marvis-messages.d.ts.map +1 -1
- package/lib/marvis-messages.js +88 -8
- package/lib/marvis-messages.js.map +1 -1
- package/lib/marvis-product.d.ts +31 -6
- package/lib/marvis-product.d.ts.map +1 -1
- package/lib/marvis-product.js +60 -13
- package/lib/marvis-product.js.map +1 -1
- package/lib/marvis-slots.d.ts +43 -0
- package/lib/marvis-slots.d.ts.map +1 -0
- package/lib/marvis-slots.js +9 -0
- package/lib/marvis-slots.js.map +1 -0
- package/lib/minimax-adapter.d.ts +1 -6
- package/lib/minimax-adapter.d.ts.map +1 -1
- package/lib/minimax-adapter.js +4 -10
- package/lib/minimax-adapter.js.map +1 -1
- package/lib/minimax-auth.d.ts.map +1 -1
- package/lib/minimax-auth.js +2 -1
- package/lib/minimax-auth.js.map +1 -1
- package/lib/model-catalog.d.ts +19 -8
- package/lib/model-catalog.d.ts.map +1 -1
- package/lib/model-catalog.js +10 -127
- package/lib/model-catalog.js.map +1 -1
- package/lib/model-promotions.d.ts +377 -0
- package/lib/model-promotions.d.ts.map +1 -0
- package/lib/model-promotions.js +856 -0
- package/lib/model-promotions.js.map +1 -0
- package/lib/models-dev-cache.d.ts +0 -27
- package/lib/models-dev-cache.d.ts.map +1 -1
- package/lib/models-dev-cache.js +3 -48
- package/lib/models-dev-cache.js.map +1 -1
- package/lib/models.d.ts +17 -14
- package/lib/models.d.ts.map +1 -1
- package/lib/models.js +23 -47
- package/lib/models.js.map +1 -1
- package/lib/modelscope-adapter.d.ts +89 -0
- package/lib/modelscope-adapter.d.ts.map +1 -1
- package/lib/modelscope-adapter.js +167 -23
- package/lib/modelscope-adapter.js.map +1 -1
- package/lib/modelscope-checkin.d.ts +5 -0
- package/lib/modelscope-checkin.d.ts.map +1 -0
- package/lib/modelscope-checkin.js +265 -0
- package/lib/modelscope-checkin.js.map +1 -0
- package/lib/modelscope-credits.d.ts +1 -1
- package/lib/modelscope-credits.d.ts.map +1 -1
- package/lib/modelscope-credits.js +31 -12
- package/lib/modelscope-credits.js.map +1 -1
- package/lib/modelscope-messages.d.ts +9 -1
- package/lib/modelscope-messages.d.ts.map +1 -1
- package/lib/modelscope-messages.js +12 -3
- package/lib/modelscope-messages.js.map +1 -1
- package/lib/monkeycode-adapter.d.ts.map +1 -1
- package/lib/monkeycode-adapter.js +0 -3
- package/lib/monkeycode-adapter.js.map +1 -1
- package/lib/officeace-adapter.d.ts.map +1 -1
- package/lib/officeace-adapter.js +21 -147
- package/lib/officeace-adapter.js.map +1 -1
- package/lib/officeace-auth.d.ts +0 -15
- package/lib/officeace-auth.d.ts.map +1 -1
- package/lib/officeace-auth.js +12 -278
- package/lib/officeace-auth.js.map +1 -1
- package/lib/openai-compat.d.ts.map +1 -1
- package/lib/openai-compat.js +1 -18
- package/lib/openai-compat.js.map +1 -1
- package/lib/openai-gateway/config.d.ts +1 -0
- package/lib/openai-gateway/config.d.ts.map +1 -1
- package/lib/openai-gateway/config.js +20 -0
- package/lib/openai-gateway/config.js.map +1 -1
- package/lib/openai-gateway/models.d.ts +77 -1
- package/lib/openai-gateway/models.d.ts.map +1 -1
- package/lib/openai-gateway/models.js +110 -2
- package/lib/openai-gateway/models.js.map +1 -1
- package/lib/openai-gateway/server.d.ts.map +1 -1
- package/lib/openai-gateway/server.js +23 -17
- package/lib/openai-gateway/server.js.map +1 -1
- package/lib/openai-gateway/stream.d.ts.map +1 -1
- package/lib/openai-gateway/stream.js +24 -2
- package/lib/openai-gateway/stream.js.map +1 -1
- package/lib/openai-gateway/tencent-fingerprint.d.ts.map +1 -1
- package/lib/openai-gateway/tencent-fingerprint.js +14 -2
- package/lib/openai-gateway/tencent-fingerprint.js.map +1 -1
- package/lib/product.d.ts +17 -12
- package/lib/product.d.ts.map +1 -1
- package/lib/product.js +17 -12
- package/lib/product.js.map +1 -1
- package/lib/promotion-edge-broadcast.d.ts +76 -0
- package/lib/promotion-edge-broadcast.d.ts.map +1 -0
- package/lib/promotion-edge-broadcast.js +172 -0
- package/lib/promotion-edge-broadcast.js.map +1 -0
- package/lib/provider-credits.d.ts +6 -17
- package/lib/provider-credits.d.ts.map +1 -1
- package/lib/provider-credits.js +98 -65
- package/lib/provider-credits.js.map +1 -1
- package/lib/provider-registry.d.ts +19 -6
- package/lib/provider-registry.d.ts.map +1 -1
- package/lib/provider-registry.js +80 -29
- package/lib/provider-registry.js.map +1 -1
- package/lib/provider-runtime.d.ts +17 -3
- package/lib/provider-runtime.d.ts.map +1 -1
- package/lib/provider-runtime.js.map +1 -1
- package/lib/qiniu-messages.d.ts +4 -1
- package/lib/qiniu-messages.d.ts.map +1 -1
- package/lib/qiniu-messages.js +6 -3
- package/lib/qiniu-messages.js.map +1 -1
- package/lib/qoder-adapter.d.ts +113 -8
- package/lib/qoder-adapter.d.ts.map +1 -1
- package/lib/qoder-adapter.js +638 -231
- package/lib/qoder-adapter.js.map +1 -1
- package/lib/qoder-align.d.ts +104 -0
- package/lib/qoder-align.d.ts.map +1 -0
- package/lib/qoder-align.js +215 -0
- package/lib/qoder-align.js.map +1 -0
- package/lib/qoder-catalog.d.ts.map +1 -1
- package/lib/qoder-catalog.js +7 -0
- package/lib/qoder-catalog.js.map +1 -1
- package/lib/qoder-credits.d.ts.map +1 -1
- package/lib/qoder-credits.js +29 -5
- package/lib/qoder-credits.js.map +1 -1
- package/lib/qoder-machine.d.ts.map +1 -1
- package/lib/qoder-machine.js +0 -52
- package/lib/qoder-machine.js.map +1 -1
- package/lib/qoder-product.d.ts +20 -4
- package/lib/qoder-product.d.ts.map +1 -1
- package/lib/qoder-product.js.map +1 -1
- package/lib/qoder-rpc.d.ts +16 -1
- package/lib/qoder-rpc.d.ts.map +1 -1
- package/lib/qoder-rpc.js +56 -1
- package/lib/qoder-rpc.js.map +1 -1
- package/lib/qoder-traffic-guard.d.ts +6 -0
- package/lib/qoder-traffic-guard.d.ts.map +1 -0
- package/lib/qoder-traffic-guard.js +44 -0
- package/lib/qoder-traffic-guard.js.map +1 -0
- package/lib/qoder-web-usage.d.ts +165 -0
- package/lib/qoder-web-usage.d.ts.map +1 -0
- package/lib/qoder-web-usage.js +471 -0
- package/lib/qoder-web-usage.js.map +1 -0
- package/lib/raccoon-adapter.d.ts +3 -53
- package/lib/raccoon-adapter.d.ts.map +1 -1
- package/lib/raccoon-adapter.js +32 -151
- package/lib/raccoon-adapter.js.map +1 -1
- package/lib/raccoon-auth.d.ts +3 -2
- package/lib/raccoon-auth.d.ts.map +1 -1
- package/lib/raccoon-auth.js +6 -4
- package/lib/raccoon-auth.js.map +1 -1
- package/lib/raccoon-credits.d.ts +105 -40
- package/lib/raccoon-credits.d.ts.map +1 -1
- package/lib/raccoon-credits.js +250 -119
- package/lib/raccoon-credits.js.map +1 -1
- package/lib/raccoon-login-page.d.ts +10 -5
- package/lib/raccoon-login-page.d.ts.map +1 -1
- package/lib/raccoon-login-page.js +110 -23
- package/lib/raccoon-login-page.js.map +1 -1
- package/lib/raccoon-oauth.d.ts +67 -11
- package/lib/raccoon-oauth.d.ts.map +1 -1
- package/lib/raccoon-oauth.js +140 -16
- package/lib/raccoon-oauth.js.map +1 -1
- package/lib/raccoon.d.ts +98 -12
- package/lib/raccoon.d.ts.map +1 -1
- package/lib/raccoon.js +98 -12
- package/lib/raccoon.js.map +1 -1
- package/lib/reasoning-default.d.ts +207 -0
- package/lib/reasoning-default.d.ts.map +1 -0
- package/lib/reasoning-default.js +450 -0
- package/lib/reasoning-default.js.map +1 -0
- package/lib/reasoning-preferences.d.ts +86 -0
- package/lib/reasoning-preferences.d.ts.map +1 -0
- package/lib/reasoning-preferences.js +172 -0
- package/lib/reasoning-preferences.js.map +1 -0
- package/lib/service.d.ts +4 -9
- package/lib/service.d.ts.map +1 -1
- package/lib/service.js +12 -13
- package/lib/service.js.map +1 -1
- package/lib/session-balance.d.ts.map +1 -1
- package/lib/session-balance.js +14 -6
- package/lib/session-balance.js.map +1 -1
- package/lib/session-title.d.ts +3 -2
- package/lib/session-title.d.ts.map +1 -1
- package/lib/session-title.js +27 -3
- package/lib/session-title.js.map +1 -1
- package/lib/sync-apply.d.ts +97 -0
- package/lib/sync-apply.d.ts.map +1 -0
- package/lib/sync-apply.js +201 -0
- package/lib/sync-apply.js.map +1 -0
- package/lib/sync-rpc.d.ts +38 -0
- package/lib/sync-rpc.d.ts.map +1 -0
- package/lib/sync-rpc.js +144 -0
- package/lib/sync-rpc.js.map +1 -0
- package/lib/sync-service.d.ts +220 -0
- package/lib/sync-service.d.ts.map +1 -0
- package/lib/sync-service.js +434 -0
- package/lib/sync-service.js.map +1 -0
- package/lib/sync-targets.d.ts +184 -0
- package/lib/sync-targets.d.ts.map +1 -0
- package/lib/sync-targets.js +560 -0
- package/lib/sync-targets.js.map +1 -0
- package/lib/system-prompt-fold.d.ts +53 -0
- package/lib/system-prompt-fold.d.ts.map +1 -0
- package/lib/system-prompt-fold.js +66 -0
- package/lib/system-prompt-fold.js.map +1 -0
- package/lib/token-ledger-store.d.ts.map +1 -1
- package/lib/token-ledger-store.js +27 -121
- package/lib/token-ledger-store.js.map +1 -1
- package/lib/token-ledger.d.ts +13 -1
- package/lib/token-ledger.d.ts.map +1 -1
- package/lib/token-ledger.js.map +1 -1
- package/lib/trae-adapter.d.ts +1 -1
- package/lib/trae-adapter.d.ts.map +1 -1
- package/lib/trae-adapter.js +4 -6
- package/lib/trae-adapter.js.map +1 -1
- package/lib/trae-auth.d.ts +3 -1
- package/lib/trae-auth.d.ts.map +1 -1
- package/lib/trae-auth.js +12 -2
- package/lib/trae-auth.js.map +1 -1
- package/lib/trae-oauth.d.ts +27 -0
- package/lib/trae-oauth.d.ts.map +1 -1
- package/lib/trae-oauth.js +143 -0
- package/lib/trae-oauth.js.map +1 -1
- package/lib/types.d.ts +164 -154
- package/lib/types.d.ts.map +1 -1
- package/lib/types.js.map +1 -1
- package/lib/usage-badge.d.ts +2 -83
- package/lib/usage-badge.d.ts.map +1 -1
- package/lib/usage-badge.js +27 -227
- package/lib/usage-badge.js.map +1 -1
- package/lib/workbuddy-intl-activity.d.ts +112 -0
- package/lib/workbuddy-intl-activity.d.ts.map +1 -0
- package/lib/workbuddy-intl-activity.js +370 -0
- package/lib/workbuddy-intl-activity.js.map +1 -0
- package/lib/zcode-adapter.d.ts.map +1 -1
- package/lib/zcode-adapter.js +31 -112
- package/lib/zcode-adapter.js.map +1 -1
- package/lib/zcode-auth.d.ts.map +1 -1
- package/lib/zcode-auth.js +1 -8
- package/lib/zcode-auth.js.map +1 -1
- package/lib/zcode-login.d.ts.map +1 -1
- package/lib/zcode-login.js +3 -5
- package/lib/zcode-login.js.map +1 -1
- package/lib/zcode-transport.d.ts.map +1 -1
- package/lib/zcode-transport.js +1 -3
- package/lib/zcode-transport.js.map +1 -1
- package/lib/zcode-upstream.d.ts +0 -59
- package/lib/zcode-upstream.d.ts.map +1 -1
- package/lib/zcode-upstream.js +10 -156
- package/lib/zcode-upstream.js.map +1 -1
- package/locale/en.json +2 -1
- package/locale/zh.json +2 -1
- package/package.json +7 -11
- package/lib/image-data-cache.d.ts +0 -87
- package/lib/image-data-cache.d.ts.map +0 -1
- package/lib/image-data-cache.js +0 -144
- package/lib/image-data-cache.js.map +0 -1
- package/lib/provider-http-pool.d.ts +0 -134
- package/lib/provider-http-pool.d.ts.map +0 -1
- package/lib/provider-http-pool.js +0 -519
- package/lib/provider-http-pool.js.map +0 -1
- package/lib/qoder-umid.d.ts +0 -184
- package/lib/qoder-umid.d.ts.map +0 -1
- package/lib/qoder-umid.js +0 -503
- package/lib/qoder-umid.js.map +0 -1
- package/lib/webdav-auto-sync.d.ts +0 -101
- package/lib/webdav-auto-sync.d.ts.map +0 -1
- package/lib/webdav-auto-sync.js +0 -0
- package/lib/webdav-auto-sync.js.map +0 -1
- package/lib/webdav-rpc.d.ts +0 -13
- package/lib/webdav-rpc.d.ts.map +0 -1
- package/lib/webdav-rpc.js +0 -137
- package/lib/webdav-rpc.js.map +0 -1
- package/lib/webdav-sync-crypto.d.ts +0 -18
- package/lib/webdav-sync-crypto.d.ts.map +0 -1
- package/lib/webdav-sync-crypto.js +0 -72
- package/lib/webdav-sync-crypto.js.map +0 -1
- package/lib/webdav-sync-merge.d.ts +0 -31
- package/lib/webdav-sync-merge.d.ts.map +0 -1
- package/lib/webdav-sync-merge.js +0 -0
- package/lib/webdav-sync-merge.js.map +0 -1
- package/lib/webdav-sync.d.ts +0 -155
- package/lib/webdav-sync.d.ts.map +0 -1
- package/lib/webdav-sync.js +0 -412
- package/lib/webdav-sync.js.map +0 -1
- package/lib/workbuddy-keepalive.d.ts +0 -81
- package/lib/workbuddy-keepalive.d.ts.map +0 -1
- package/lib/workbuddy-keepalive.js +0 -218
- package/lib/workbuddy-keepalive.js.map +0 -1
package/README.md
CHANGED
|
@@ -1,38 +1,338 @@
|
|
|
1
1
|
# dsh-providers-hub
|
|
2
2
|
|
|
3
|
+
> **本包原名 `dsh-codearts-auth`**(`0.2.0-rc.11` 起改名)。老用户的 DSH profile 里
|
|
4
|
+
> 还锁着旧名时,**插件会加载失败并被自动禁用**(宿主报 `N entry did not activate`,
|
|
5
|
+
> 界面里也就看不到它)—— 升级前先看
|
|
6
|
+
> [⚠️ 从旧包名 `dsh-codearts-auth` 升级](#️-从旧包名-dsh-codearts-auth-升级)。
|
|
7
|
+
|
|
3
8
|
> **使用声明**:本项目仅供学习研究使用,请遵守各服务提供方的服务条款。
|
|
4
9
|
|
|
5
|
-
deepseek-harness
|
|
10
|
+
deepseek-harness 插件:统一管理多个 AI 编程服务的账号,并把它们的模型接进 DSH
|
|
11
|
+
的模型选择器。支持**多账号池**(同一服务登录多个账号,按可用性自动选号)与
|
|
12
|
+
**凭据静默续期**(到期前自动刷新,无需再次打开浏览器)。
|
|
6
13
|
|
|
7
14
|
- **30 个 provider 路由**,外加 1 个**聚合**路由(见下)
|
|
8
15
|
- 登录、状态、续期、积分领取**全部在 Jet Hub 设置页完成**,不注册任何斜杠命令
|
|
9
16
|
- 附带一个**本机 OpenAI 兼容网关**,供其它客户端复用已登录账号
|
|
10
17
|
|
|
11
|
-
> 各 provider
|
|
18
|
+
> 📌 **本 README 只写「怎么用」。** 各 provider 的协议、端点、登录流程、请求头
|
|
19
|
+
> 构造、实测数据与事故史等**实现细节**,统一记录在不入库的内部文档
|
|
20
|
+
> `docs/implementation-notes.md` 中。需要改动实现或排查协议问题时读它。
|
|
21
|
+
>
|
|
22
|
+
> ⚠️ **accio 的章节该文件里还没有**(`implementation-notes.md` 目前零处 accio)——
|
|
23
|
+
> 读它时**不要**以为 accio 没有实现笔记。accio 的实测结论与坑点当前登记在
|
|
24
|
+
> `docs/agent-notes/providers-accio.md`(含三条与参考实现相反的结论、两个真缺陷、
|
|
25
|
+
> 区域选择与接线陷阱),补写 `implementation-notes.md` 的 accio 章节是**独立任务**。
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## 目录
|
|
30
|
+
|
|
31
|
+
- [安装](#安装)
|
|
32
|
+
- [Windows 服务器部署(引导式 / 离线式)](#windows-服务器部署引导式--离线式)
|
|
33
|
+
- [用法](#用法)
|
|
34
|
+
- [支持的渠道](#支持的渠道)
|
|
35
|
+
- [聚合路由](#聚合路由aggregate)
|
|
36
|
+
- [本机 OpenAI 网关](#本机-openai-网关)
|
|
37
|
+
- [用量徽标与 Token 用量](#用量徽标与-token-用量)
|
|
38
|
+
- [模型选择器里的活动徽标](#模型选择器里的活动徽标)
|
|
39
|
+
- [配置项](#配置项)
|
|
40
|
+
- [开发](#开发)
|
|
41
|
+
|
|
42
|
+
---
|
|
12
43
|
|
|
13
44
|
## 安装
|
|
14
45
|
|
|
15
|
-
npm
|
|
46
|
+
该包尚未发布到 npm registry。提供两种安装方式。
|
|
47
|
+
|
|
48
|
+
### ⚠️ 从旧包名 `dsh-codearts-auth` 升级
|
|
49
|
+
|
|
50
|
+
本包在 `0.2.0-rc.11` 把包名从 `dsh-codearts-auth` 改成了 `dsh-providers-hub`。
|
|
51
|
+
**仓库里改完了不代表你的机器上改完了** —— DSH 是在 **profile** 里按**包名字符串**
|
|
52
|
+
寻址 bundle 的,而老 profile 两处都还写着旧名:
|
|
53
|
+
|
|
54
|
+
```jsonc
|
|
55
|
+
// ~/.dsh/profiles/<name>/package.json
|
|
56
|
+
{
|
|
57
|
+
"dependencies": { "dsh-codearts-auth": "link:…" }, // ← 旧键
|
|
58
|
+
"dsh": { "profile": { "bundles": [ …, "dsh-codearts-auth" ] } } // ← 旧项
|
|
59
|
+
}
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
**两处必须一起改**,缺一处就是静默失效 —— 而且**「两处都不改」同样会坏**,
|
|
63
|
+
只是坏的位置不同:
|
|
64
|
+
|
|
65
|
+
| profile 里的状态 | 后果 |
|
|
66
|
+
|---|---|
|
|
67
|
+
| **两处都是旧名**(老 profile 的现状) | bundle 目录**解析得到**(`node_modules/dsh-codearts-auth` 这个旧名别名还在),但包里 patch 的加载行写的是**新包名**,而宿主把加载行的解析基准设成 **profile 目录** ⇒ 新名在那里解析不到(本机实测 `MODULE_NOT_FOUND`)⇒ **该加载行 import 失败** ⇒ 宿主报 `N entry did not activate`,桌面端落进恢复模式并把插件**自动禁用**(Jet Hub 界面自然也不出现,即 issue IKLUME 的症状) |
|
|
68
|
+
| **只改 `dependencies`** | `dsh.profile.bundles[]` 里的旧名在 profile 里解析不到 ⇒ `resolveBundleDir()` 抛错 ⇒ 该 bundle 进 `skippedBundles` ⇒ **整个插件(连宿主侧)都不加载**,只在 stderr 留一行:无异常、无 UI 提示 |
|
|
69
|
+
| **只改 `dsh.profile.bundles`** | 与上一格同因:`node_modules/` 里只有旧名,`bundles[]` 里的新名解析不到 ⇒ 同样进 `skippedBundles` |
|
|
70
|
+
|
|
71
|
+
> **实测**(本机 `~/.dsh/profiles/web`):`require.resolve('dsh-codearts-auth/package.json')`
|
|
72
|
+
> 成功解析到仓库根,而 `require.resolve('@xixka/dsh-hub/package.json')` 报
|
|
73
|
+
> `MODULE_NOT_FOUND`。宿主把加载行的解析基准设成 **profile 目录**
|
|
74
|
+
> (`dsh-app-boot` 对 patch 行调 `prepareProfilePatches(…, pathToFileURL(dirname(absoluteConfigPath))…)`,
|
|
75
|
+
> 同一个值也是 `boot()` 里 `ctx.baseUrl` 的来源),所以「旧名能解析」与「新名解析不到」
|
|
76
|
+
> 会**同时**成立 —— 这正是第一格的判断依据是**按名字解析**、而不是「目录在不在」的原因。
|
|
77
|
+
>
|
|
78
|
+
> ⚠️ 第一格的落点**不在客户端**:宿主**不会**替用户把这种行摘掉 —— `preflight()`
|
|
79
|
+
> 只在「兼容性冲突」时 deny 一行,其余失败**保留 cordis Loader 自己的诊断**
|
|
80
|
+
> (源码注释:*every other failure keeps the Loader's own diagnosis*),于是该行走进
|
|
81
|
+
> Loader 并**在宿主这一侧导入失败**。所以排障的第一现场是宿主日志里的
|
|
82
|
+
> `N entry did not activate` 与「插件已被禁用」,不是「宿主一切照常、只是客户端
|
|
83
|
+
> entry 没建立」——后者会让排查方向整个偏到前端产物上去。
|
|
84
|
+
|
|
85
|
+
推荐做法是**不要手改**,直接用 `dsh plugin --profile <name>` 的 `remove` / `add`
|
|
86
|
+
各走一遍,让工具自己写这两处:
|
|
87
|
+
|
|
88
|
+
```sh
|
|
89
|
+
dsh plugin --profile <name> remove dsh-codearts-auth
|
|
90
|
+
dsh plugin --profile <name> add "https://gitee.com/iJetLi/deepseek-harness-codearts.git"
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
⚠️ `<name>` 要**逐个 profile 走一遍**:本机 `~/.dsh/profiles/` 下的 `desktop` /
|
|
94
|
+
`headless` / `tui` / `web` 四个 profile 的 `package.json` **都**还锁着旧名,且
|
|
95
|
+
`dsh.profile.bundles` 里也都有它。只有既无依赖项也无 `node_modules` 的 profile
|
|
96
|
+
(如 `default` / `rescue`)可以跳过。
|
|
97
|
+
|
|
98
|
+
⚠️ 老版本可能残留 `node_modules/dsh-codearts-auth` 与 `pnpm-lock.yaml` 里的同名
|
|
99
|
+
依赖项;`add` 之后确认 profile 里不再有旧名的依赖键。
|
|
100
|
+
|
|
101
|
+
### 方式一:从 git 仓库安装(推荐)
|
|
102
|
+
|
|
103
|
+
`add` 以 git 仓库方式安装(pnpm 内部走 `git+https:` 协议),会运行本包的 `prepare`
|
|
104
|
+
脚本自动构建 `lib/`,无需手动 `pnpm build`。
|
|
105
|
+
|
|
106
|
+
⚠️ `prepare` **不依赖任何包管理器**(它直接内联 `tsc` / `node`):pnpm 在 clone
|
|
107
|
+
目录里跑 `prepare` 时,**pnpm 10 / 11 不会把 npm 注入 PATH**(只有 pnpm ≥ 12 会)
|
|
108
|
+
⇒ 若 `prepare` 里写 `npm run …`,那两代上安装会直接失败。
|
|
109
|
+
|
|
110
|
+
⚠️ pnpm 10 起会拦截依赖的构建脚本,必须先在 profile 的 `pnpm-workspace.yaml`
|
|
111
|
+
(路径形如 `~/.dsh/profiles/<name>/pnpm-workspace.yaml`)里放行;而**放行键的写法
|
|
112
|
+
在 pnpm 10 与 pnpm 11 之间互不兼容**,写错就装不上。
|
|
113
|
+
|
|
114
|
+
**1. 先跑一次安装**(这一次必然失败,为的是让 pnpm 打印它期望的键):
|
|
16
115
|
|
|
17
116
|
```sh
|
|
18
117
|
dsh plugin --profile <name> add "https://gitee.com/iJetLi/deepseek-harness-codearts.git"
|
|
19
118
|
```
|
|
20
119
|
|
|
21
|
-
|
|
22
|
-
|
|
120
|
+
**2. 按第 1 步的报错选一种写法,写进 profile 的 `pnpm-workspace.yaml`。**
|
|
121
|
+
|
|
122
|
+
报 **`ERR_PNPM_INVALID_VERSION_UNION`** 的(**pnpm 10.x**)—— 只认**纯包名**键:
|
|
123
|
+
|
|
124
|
+
```yaml
|
|
125
|
+
allowBuilds:
|
|
126
|
+
dsh-providers-hub: true
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
报 **`ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED`** 的(**pnpm 11.x**)—— git 托管包
|
|
130
|
+
**不认**纯包名键,必须用第 1 步 pnpm 打印的**完整键(含 `#<commit>`)**:
|
|
23
131
|
|
|
24
|
-
|
|
132
|
+
```yaml
|
|
133
|
+
allowBuilds:
|
|
134
|
+
dsh-providers-hub@git+https://gitee.com/iJetLi/deepseek-harness-codearts.git#<第 1 步打印的 commit>: true
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
**两代通用(省事,但放宽了权限)**:
|
|
138
|
+
|
|
139
|
+
```yaml
|
|
140
|
+
dangerouslyAllowAllBuilds: true
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
它会放行该 profile 里**所有**依赖的构建脚本(不止本插件)。
|
|
144
|
+
|
|
145
|
+
**3. 重跑第 1 步的命令**:这次会拉取、构建并安装成功。之后每次升级重新 `add` 即可。
|
|
146
|
+
|
|
147
|
+
⚠️ **不要**写 `dsh-providers-hub@git+https://gitee.com/…`(不带 `#<commit>`)——
|
|
148
|
+
这个"看起来最自然"的键在两代 pnpm 上都不工作。
|
|
149
|
+
|
|
150
|
+
⚠️ pnpm 11.x 的精确键里带 commit,因此**升级(重新 `add` 拉到新 commit)后该键
|
|
151
|
+
失效**,按新报错里的键替换即可;用 `dangerouslyAllowAllBuilds` 则不必改。
|
|
152
|
+
|
|
153
|
+
### 方式二:从源码目录安装(本地开发)
|
|
154
|
+
|
|
155
|
+
先在本仓库中构建 `lib/`,再安装为 pnpm `link:` 依赖:
|
|
25
156
|
|
|
26
157
|
```sh
|
|
27
158
|
pnpm build:all
|
|
28
159
|
dsh plugin --profile <name> install <path-to-this-repo>
|
|
29
160
|
```
|
|
30
161
|
|
|
162
|
+
> `dsh plugin install` 以 `link:` 方式安装,pnpm 不会为 `link:` 依赖运行
|
|
163
|
+
> `prepare` 脚本,因此必须先手动执行 `pnpm build:all` 生成 `lib/`。
|
|
164
|
+
> 注意必须用 `build:all` 而非 `build`:后者只编译宿主侧,不产出
|
|
165
|
+
> `lib/client/jet-hub.js`。
|
|
166
|
+
|
|
167
|
+
每次修改 `src/` 或 `plugin-src/` 后都需要重新执行 `pnpm build:all` —— dsh 启动时
|
|
168
|
+
不会自动重建。
|
|
169
|
+
|
|
170
|
+
### 通用说明
|
|
171
|
+
|
|
172
|
+
该包声明了 `dsh.bundle` 补丁(`cordis.patch.yml`),因此 profile 的 layer 栈会
|
|
173
|
+
自动拾取 `codearts-auth` 行。插件注入由 dsh base 提供的 `credentials`、
|
|
174
|
+
`commands` 和 `llm` 服务。
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
178
|
+
## Windows 服务器部署(引导式 / 离线式)
|
|
179
|
+
|
|
180
|
+
`service.bat` 除了把程序注册成 Windows 服务外,还能打出两种部署产物:
|
|
181
|
+
|
|
182
|
+
| 模式 | 命令 | 体积 | 目标机要求 |
|
|
183
|
+
|---|---|---|---|
|
|
184
|
+
| **引导式**(推荐) | `package -Mode bootstrap` | **约 20 MB** | 能访问网络;首次执行 `install.cmd` 自动备好 Node 并下载依赖(约 730 MB) |
|
|
185
|
+
| 离线式 | `package -Mode standalone` | 约 800 MB | **无需 anything**:Node 与全部依赖都内置,可完全断网 |
|
|
186
|
+
|
|
187
|
+
两者都**不包含** profile 的账号与设置数据 —— 那部分用 Jet Hub 的「账号备份导入」恢复。
|
|
188
|
+
|
|
189
|
+
### 引导式产物(按需下载,约 20 MB)
|
|
190
|
+
|
|
191
|
+
```bat
|
|
192
|
+
service.bat package -Mode bootstrap
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
产物在 `dist\bootstrap\dsh-providers-hub-<版本>-win-x64\`,部署只需两条命令:
|
|
196
|
+
|
|
197
|
+
```bat
|
|
198
|
+
install.cmd :: 下载 DSH 宿主依赖 + 组装 profile(首次 1-3 分钟)
|
|
199
|
+
start.cmd :: 启动
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
产物结构:
|
|
203
|
+
|
|
204
|
+
```
|
|
205
|
+
dsh-providers-hub-<版本>-win-x64\
|
|
206
|
+
├─ MANIFEST.json 版本 / 依赖版本 / 关键文件 sha256
|
|
207
|
+
├─ README.txt 部署说明
|
|
208
|
+
├─ install.cmd / install.ps1 目标机安装(下载依赖 + 组装 profile)
|
|
209
|
+
├─ start.cmd / stop.cmd / stop.ps1
|
|
210
|
+
├─ service.bat 注册 Windows 服务(产物随附,目标机就地可跑)
|
|
211
|
+
├─ runtime\
|
|
212
|
+
│ ├─ service-runner.mjs 服务包装器
|
|
213
|
+
│ └─ node.exe ← 仅 --with-node 打包时存在(含 npm,+130 MB)
|
|
214
|
+
├─ plugin\ 插件本体(lib / locale / cordis.patch.yml / package.json)
|
|
215
|
+
│ └─ node_modules\ 插件生产依赖(4 个包;--thin 时改为目标机下载)
|
|
216
|
+
└─ host\
|
|
217
|
+
├─ package.json 宿主依赖声明
|
|
218
|
+
└─ package-lock.json 精确锁定 548 个包的版本与 integrity(install 用 npm ci)
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
`install.cmd` 做 8 件事:**备好 Node(缺则自动下载)** → 校验 npm → 从 lock 安装宿主依赖 →
|
|
222
|
+
**核验 peer 闭包**(`dsh` / `dsh-base` / `dsh-web-app` / `dsh-llm` / `cordis-plugin-loader`)→
|
|
223
|
+
建 profile 骨架 → 把插件拷进 profile → 核验 `.node` 是否当前平台 → 打印后续命令。
|
|
224
|
+
|
|
225
|
+
**Node 是怎么解决的**(三级回退,无需人工干预):
|
|
226
|
+
|
|
227
|
+
1. 产物内 `runtime\node.exe`(用 `--with-node` 打包时才有);
|
|
228
|
+
2. 系统 `PATH` 上的 `node.exe`;
|
|
229
|
+
3. **都没有 → 自动下载**官方 Node win-x64 zip(版本取打包机自身版本,约 35 MB,自带 npm),
|
|
230
|
+
解压到产物 `runtime\`。之后 `start.cmd` 与 `service.bat` 都会自动用这份 Node,
|
|
231
|
+
不再依赖系统 PATH。
|
|
232
|
+
|
|
233
|
+
> 下载源顺序:`-NodeMirror <基址>`(若给)→ `npmmirror.com` → `nodejs.org`。
|
|
234
|
+
> 内网无外网时用 `-SkipNodeDownload` 让它老实报错,或事先把 Node 装好。
|
|
235
|
+
|
|
236
|
+
可选参数:`install.cmd -Profile prod -Registry https://registry.npmmirror.com -Force -SkipVerify`、
|
|
237
|
+
`-NodeMirror https://npmmirror.com/mirrors/node -SkipNodeDownload -NodeVersion v24.13.0`。
|
|
238
|
+
|
|
239
|
+
需要产物自带 Node(目标机没装 Node)时:
|
|
240
|
+
|
|
241
|
+
```bat
|
|
242
|
+
node scripts\build-bootstrap.mjs --with-node
|
|
243
|
+
```
|
|
244
|
+
|
|
245
|
+
> ⚠️ **不能给 `npm install` 加 `--omit=peer`**:DSH 宿主的 peerDependencies 是它运行的一部分,
|
|
246
|
+
> 漏一个就 `ERR_MODULE_NOT_FOUND` 起不来。`install.ps1` 会在装完后显式核验这 5 个包。
|
|
247
|
+
|
|
248
|
+
### 离线式产物(完全自包含,约 800 MB)
|
|
249
|
+
|
|
250
|
+
目标机**不需要安装 Node / npm / pnpm,也无法联网**,解压即跑。
|
|
251
|
+
|
|
252
|
+
```bat
|
|
253
|
+
service.bat package -Mode standalone
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
产物落在 `dist\standalone\dsh-providers-hub-<版本>-win-x64\`,把它整个目录拷到服务器即可。
|
|
257
|
+
下面的目录结构说明针对离线式产物;引导式产物在 `install.cmd` 跑完后,`home\` 下的布局与它一致。
|
|
258
|
+
|
|
259
|
+
### 目录结构
|
|
260
|
+
|
|
261
|
+
```
|
|
262
|
+
dsh-providers-hub-<版本>-win-x64\
|
|
263
|
+
├─ MANIFEST.json 版本 / 依赖清单 / 原生二进制清单(可审计)
|
|
264
|
+
├─ README.txt 部署说明(目录结构、启动方式、限制)
|
|
265
|
+
├─ start.cmd 启动(前台,用内置 Node)
|
|
266
|
+
├─ stop.cmd / stop.ps1 停止
|
|
267
|
+
├─ service.bat 注册 Windows 服务(产物随附,目标机就地可跑)
|
|
268
|
+
├─ runtime\
|
|
269
|
+
│ ├─ node.exe 内置 Node 运行时(目标机无需装 Node)
|
|
270
|
+
│ └─ service-runner.mjs 服务包装器
|
|
271
|
+
└─ home\ == DSH_HOME
|
|
272
|
+
├─ cordis.patch.yml home 级 patch 层
|
|
273
|
+
└─ profiles\
|
|
274
|
+
├─ node_modules\
|
|
275
|
+
│ └─ @deepseek-ai\dsh\ DSH 宿主
|
|
276
|
+
│ ├─ lib\ package.json
|
|
277
|
+
│ └─ node_modules\ 宿主依赖闭包(548 个包,真实目录)
|
|
278
|
+
└─ prod\ 预置 profile(免 npm install)
|
|
279
|
+
├─ package.json dsh.profile.bundles
|
|
280
|
+
├─ cordis.patch.yml
|
|
281
|
+
└─ node_modules\
|
|
282
|
+
└─ dsh-providers-hub\ 本插件
|
|
283
|
+
├─ lib\ locale\ cordis.patch.yml
|
|
284
|
+
└─ node_modules\ 插件生产依赖(真实目录)
|
|
285
|
+
```
|
|
286
|
+
|
|
287
|
+
要点:
|
|
288
|
+
|
|
289
|
+
- **全部依赖以真实目录分发**(不是 junction),所以产物可以随意移动/复制,zip 也不会损坏。
|
|
290
|
+
宿主启动时若发现链接失效会**自动重建**。
|
|
291
|
+
- **原生模块按 Windows 平台收录**(如 `@img/sharp-win32-x64`、
|
|
292
|
+
`node-addon-require-builtin-win32-x64-msvc`),打包时逐个核验,缺失即中止。
|
|
293
|
+
- **预置 profile 里插件已就位**,目标机**不需要执行任何 `npm install` / `pnpm install`**,
|
|
294
|
+
也不需要联网。
|
|
295
|
+
- 插件与宿主共用的依赖会做**去重**(按 semver 判定),避免同一模块出现两个实例。
|
|
296
|
+
|
|
297
|
+
### 启动
|
|
298
|
+
|
|
299
|
+
```bat
|
|
300
|
+
start.cmd
|
|
301
|
+
```
|
|
302
|
+
|
|
303
|
+
| 环境变量 | 默认 | 说明 |
|
|
304
|
+
|---|---|---|
|
|
305
|
+
| `DSH_PROFILE` | `prod` | profile 名 |
|
|
306
|
+
| `DSH_HOST` | `127.0.0.1` | Web UI 监听地址 |
|
|
307
|
+
| `DSH_PORT` | `8123` | Web UI 端口 |
|
|
308
|
+
| `DSH_OPENAI_GATEWAY_PORT` | `8326` | 本机 OpenAI 网关端口 |
|
|
309
|
+
| `DSH_OPENAI_GATEWAY_HOST` | `127.0.0.1` | 网关监听地址 |
|
|
310
|
+
| `DSH_OPENAI_GATEWAY_PUBLIC_URL` | 未设置 | 客户端应当使用的**对外地址**(网关前面有反代 / 端口映射时填,如 `http://192.168.1.10:8080/v1`);设置页优先显示它。只接受 http(s),不得带口令或查询串 |
|
|
311
|
+
|
|
312
|
+
Web UI:`http://<DSH_HOST>:<DSH_PORT>`;网关:`http://<网关地址>:<端口>/v1`。
|
|
313
|
+
|
|
314
|
+
⚠️ 不要把监听地址改成 `0.0.0.0` / `::` —— 宿主与网关都会在启动前**显式拒绝**并报错退出;
|
|
315
|
+
要给内网访问请填**具体网卡 IP**,并务必设置 `DSH_OPENAI_GATEWAY_API_KEY`。
|
|
316
|
+
|
|
317
|
+
注册成 Windows 服务(需管理员 + NSSM;两种产物根目录都已随附 `service.bat`):
|
|
318
|
+
|
|
319
|
+
```bat
|
|
320
|
+
service.bat install -Mode standalone -BundleDir <产物目录> -Profile prod :: 离线式
|
|
321
|
+
service.bat install -Mode bootstrap -BundleDir <产物目录> -Profile prod :: 引导式(先跑过 install.cmd)
|
|
322
|
+
```
|
|
323
|
+
|
|
324
|
+
> ⚠️ 2026-10-31 审计(P1):新版 `service.bat` 检测到 `-BundleDir` 已是完整产物时
|
|
325
|
+
> **自动跳过打包**(打印一行提示),无需再加 `-NoPackage`;`-Force` 仍可强制重打包。
|
|
326
|
+
> 老版本(无自动检测的)必须显式加 `-NoPackage`,否则它会在目标机上尝试重新打包而失败。
|
|
327
|
+
|
|
328
|
+
> ⚠️ 账号登录仍需在浏览器里完成(Jet Hub 设置页);无浏览器环境请用「账号备份与迁移」里的
|
|
329
|
+
> 导出/导入把账号搬过去。
|
|
330
|
+
|
|
331
|
+
---
|
|
332
|
+
|
|
31
333
|
## 用法
|
|
32
334
|
|
|
33
|
-
|
|
34
|
-
2. 点「**+ 新建账号**」→ 浏览器完成授权登录;多账号重复此步(账号池自动选号,卡片顺序即优先级);
|
|
35
|
-
3. 回到模型选择器,选中该渠道的模型即可开始对话。
|
|
335
|
+
**登录入口:Jet Hub 设置页的对应 provider 面板。**
|
|
36
336
|
|
|
37
337
|
⚠️ **不注册任何斜杠命令** —— 登录、状态查看、续期与积分领取统一在 Jet Hub 完成。
|
|
38
338
|
|
|
@@ -87,27 +387,25 @@ dsh plugin --profile <name> install <path-to-this-repo>
|
|
|
87
387
|
|
|
88
388
|
---
|
|
89
389
|
|
|
90
|
-
|
|
390
|
+
## 支持的渠道
|
|
91
391
|
|
|
92
392
|
30 个 provider 路由(按协议源流分组排序),互不覆盖,可同时使用。
|
|
93
393
|
|
|
94
|
-
## 支持的渠道
|
|
95
|
-
|
|
96
394
|
| id | 渠道 | 登录方式 | 积分能力 |
|
|
97
395
|
|---|---|---|---|
|
|
98
396
|
| `codearts` | CodeArts(华为云) | 浏览器回调 | 余额 + 每日签到 |
|
|
99
397
|
| `buddy` | CodeBuddy(腾讯) | 浏览器授权 + 轮询 | 余额 + 每日签到 + 成长任务 + 锁定永久积分 |
|
|
100
|
-
| `workbuddy` | WorkBuddy(国际版) | 同上 | 余额 +
|
|
398
|
+
| `workbuddy` | WorkBuddy(国际版) | 同上 | 余额 + 每日签到(含活跃上报)+ 锁定永久积分 |
|
|
101
399
|
| `marvis` | 腾讯 Marvis(应用宝 AI 助手) | QQ / 微信 OAuth(隔离窗口 + 回调拦截) | 余额(钱包额度;**无签到**) |
|
|
102
400
|
| `atomcode` | AtomCode(AtomGit CodingPlan) | AtomGit OAuth(broker 轮询) | 余额(5h 窗口用量)+ 每日领取 |
|
|
103
401
|
| `lobsterai` | LobsterAI(有道) | 浏览器回调 | 余额 + 每日签到 |
|
|
104
|
-
| `qoder` | Qoder(阿里系) | 设备码轮询 | 余额 + 每日领取 |
|
|
105
|
-
| `qodercn` | Qoder 中国版 | 同上(共用实现) |
|
|
402
|
+
| `qoder` | Qoder(阿里系) | 设备码轮询 | 余额 + 每日领取 + **个人资源包逐笔到期**(可选:粘贴网页会话 Cookie 后读官网明细) |
|
|
403
|
+
| `qodercn` | Qoder 中国版 | 同上(共用实现) | 同上 |
|
|
106
404
|
| `trae` | TRAE(字节跳动) | 浏览器回调 | 余额 + 签到 |
|
|
107
405
|
| `cline` | Cline | WorkOS 设备码轮询 | 余额 |
|
|
108
406
|
| `loomy` | Loomy(讯飞) | 短信验证码 | 余额(两个池)+ 每日额度 + 新手任务 |
|
|
109
407
|
| `astudio` | AStudio(讯飞) | 本机导入 / 认证页扫码 | 余额 + 每日签到(含积分包 / 永久锁定) |
|
|
110
|
-
| `raccoon` | Raccoon Work(商汤) | 微信扫码 / 短信 | 余额 + 一次性登录奖励 |
|
|
408
|
+
| `raccoon` | Raccoon Work(商汤) | 微信扫码 / 短信 | 余额 + 每日签到 + 一次性登录奖励 |
|
|
111
409
|
| `magicrew` | 超级麦吉 | 本机浏览器导入 / 网页版登录 / 手机号+密码 | 余额 + 每日签到 + 新手任务 |
|
|
112
410
|
| `magicrewintl` | MagiCrew(国际版) | 同上(共用实现) | 余额 + 每日签到 + 新手任务 |
|
|
113
411
|
| `minimax` | MiniMax Code (中国版) | OAuth 设备码 + PKCE | 余额 + 每日签到 |
|
|
@@ -119,138 +417,832 @@ dsh plugin --profile <name> install <path-to-this-repo>
|
|
|
119
417
|
| `gemini` | Gemini Code Assist | 浏览器回调 | 余额 |
|
|
120
418
|
| `officeace` | OfficeAce(华为 MaaS / 果办) | 华为云 OAuth PKCE | 余额 + 自动领取(**无手动签到入口**) |
|
|
121
419
|
| `accio` | Accio(阿里) | 浏览器回调 | 余额(三类桶;**无签到**) |
|
|
122
|
-
| `modelscope` | ModelScope(魔搭) | 粘贴 API Key(长期静态 Key) |
|
|
420
|
+
| `modelscope` | ModelScope(魔搭) | 粘贴 API Key(长期静态 Key) | 魔粒余额 + 每日登录奖励(可关闭自动签到) |
|
|
123
421
|
| `qiniu` | Qiniu(七牛云) | 粘贴 API Key | **无**(用量只在控制台可见) |
|
|
124
422
|
| `codely` | Codely(Unity 团结引擎) | 设备码轮询 | 余额 + 每日签到 |
|
|
125
423
|
| `monkeycode` | MonkeyCode | 浏览器登录(备用:粘贴 Key + Signing Secret) | 余额 + 每日签到 |
|
|
126
424
|
| `monkeycodeintl` | MonkeyCode 国际站 | 同上(共用实现) | 余额 + 每日签到 |
|
|
127
425
|
| `baizhi` | 百智云 | 浏览器登录(备用:粘贴 Key) | 余额 + 每日签到 |
|
|
128
426
|
|
|
427
|
+
各渠道的能力与限制要点:
|
|
428
|
+
|
|
429
|
+
- **图片输入**:`buddy` / `workbuddy` / `trae`(逐模型)/ `minimax` / `minimaxintl`(部分模型)/
|
|
430
|
+
`accio`(逐模型)支持;`lobsterai`、`zcode` **不支持**;其余以模型声明为准。
|
|
431
|
+
⚠️ `accio` 的图片通路**已于 2026-10-14 实测接通**(issue IKLR7V,上游原生收图
|
|
432
|
+
`parts[].inline_data`,四色全对);但它的 `multimodal: false` 模型**不报错、而是静默
|
|
433
|
+
忽略图片**(会把答案**幻觉**出来),插件因此按**逐模型**声明模态(`false` 写 `['text']`),
|
|
434
|
+
把这类模型挡在选择器之外。
|
|
435
|
+
- **思考档位**:多数渠道支持,档位名按各渠道自己的定义下发;未声明的渠道不发送该字段。
|
|
436
|
+
- **`trae` 前缀缓存**:2026-10-26 起实测 `cache_read_input_tokens` 恒为 0(同前缀
|
|
437
|
+
连发两次、对照组 buddy 97.6%),插件侧请求形态无变化,判断为上游服务端变更。
|
|
438
|
+
影响是长上下文会话每一步都全量重算(实测单步可达数分钟),**不建议**把 `trae`
|
|
439
|
+
当长跑主力;目前**未找到**客户端修复:2026-11-03 e2e 已用原始 SSE 证实上游返回 0,且 `prompt_cache_key` 实测无效。
|
|
440
|
+
- **`qoder` 多账号同机**:上游有**物理单设备每日限领锁** —— 同一台机器上第一个
|
|
441
|
+
账号领完后,其余账号会收到 `SAME_PERSON_ALREADY_CLAIMED`(插件显示「同一设备
|
|
442
|
+
今日已由其它 Qoder 账号领取」)。这不是登录失效,重登也无法绕过;多账号请分设备。
|
|
443
|
+
- **`loomy`** 是唯一用**短信验证码**登录、且**不能自动续期**的渠道。
|
|
444
|
+
- **`zcode`** 的领取路径需要一次性验证参数,由本机浏览器环境产出(web 版需要
|
|
445
|
+
chromium,桌面版用自带内核)。
|
|
446
|
+
⚠ **推理(对话)路径是否也要它,由服务端开关决定**:官方 3.14.5 起
|
|
447
|
+
`GET /api/v1/client/configs` 会下发 `captcha.skip_model_request`
|
|
448
|
+
—— 当前实测是 `true`(**不校验**,故按最省的方式「先探后取」:
|
|
449
|
+
不带验证头先发一发,被 `3007` 拒了才产);一旦服务端翻成 `false`,
|
|
450
|
+
插件会**自动改为首发直接带上**,不再白吃那发注定失败的往返
|
|
451
|
+
(判据是三态:缺席 = 不知道 = 保持先探,见 `requiresCaptchaUpfront`)。
|
|
452
|
+
⚠️ **找不到浏览器时用 `ZCODE_CHROME_PATH` 指定**(Gitee issue IKQ4JN):
|
|
453
|
+
这是该链路**唯一**的人工出口,值是 chromium 内核浏览器的**绝对路径**
|
|
454
|
+
(如 `C:\Program Files\Google\Chrome\Application\chrome.exe`)。
|
|
455
|
+
候选链按优先级为 `ZCODE_CHROME_PATH` → `SCOOP` / `SCOOP_GLOBAL` →
|
|
456
|
+
**从 `PATH` 反推的 scoop 根** → `~/scoop` → 系统 Chrome / Chromium /
|
|
457
|
+
**Brave** / Edge。
|
|
458
|
+
⚠️ **设完必须重启 `dsh web`,且新进程要继承新环境** —— 从**旧终端**重启时
|
|
459
|
+
新进程继承的仍是旧 shell 的环境快照,变量实际为空。找不到浏览器时的报错
|
|
460
|
+
会回显「本进程看到的 `ZCODE_CHROME_PATH` = …」与**逐条候选路径**,
|
|
461
|
+
照着它能立刻分清「变量没生效」与「路径写错」。
|
|
462
|
+
⚠️ **scoop 装在非默认根时不必设变量**:从 `PATH` 的 `<root>\shims` 反推
|
|
463
|
+
已覆盖(用 `root_path` 把 scoop 挪到 D 盘的机器上 `SCOOP` 是空的,
|
|
464
|
+
旧版因此一个 chromium 都找不到)。
|
|
465
|
+
⚠️ **不支持两类「看着能用」的封装**:Chrome++ 之类**外层 exe 启动后自行退出**
|
|
466
|
+
(CDP 端口会正常起来,但退出码 0 被判为异常退出);以及
|
|
467
|
+
`chrome-headless-shell`(headless 一律 `F001`,必须 headful)。
|
|
468
|
+
- **`zcode` 的领取有「两个来源」,签到会同时查、一起去领**(2026-10-23):
|
|
469
|
+
① 每日赠送 —— `GET /api/v1/zcode-plan/billing/preview` 的 `plans`;
|
|
470
|
+
② **营销活动投放** —— `GET /api/v1/marketing/touch` 里横幅按钮的
|
|
471
|
+
`claim_zcode_plan`。后者就是官方客户端那类「限时可领取」横幅(如
|
|
472
|
+
**1024 程序员节 5 亿 token**),它**不在** `preview` 里 —— 只查 preview 时
|
|
473
|
+
它与「今天没有活动」在报文上**完全同形**(都是 `plans: []`)。
|
|
474
|
+
⚠️ **营销端点与领取端点都按客户端版本门控**:插件凭据里记的是自己的版本号
|
|
475
|
+
(如 `3.14.3`);用它查投放会拿到**空投放**,用它**领取**则回
|
|
476
|
+
`400 / code 1004 no permission`(官方文案:「当前账号或**客户端版本**不满足
|
|
477
|
+
领取条件」—— 极易被误读成「这个账号没资格」)。两条请求都会**按需抬到
|
|
478
|
+
`3.16.3`**(`ZCODE_VERSION_GATED_MIN_APP_VERSION`;实测同一账号、其余头完全相同,
|
|
479
|
+
只改这一个字段:查投放 `3.14.3` → `deliveries: []` / `3.16.3` → 有投放;
|
|
480
|
+
领取 `3.14.3` → `1004` / `3.16.2` → `code 0`)。该覆盖**只作用于这两条请求**,
|
|
481
|
+
不影响推理与额度两条已实测路径。
|
|
482
|
+
✅ **真机验收**(2026-10-23,走插件自己的生产路径):`{"kind":"claimed",
|
|
483
|
+
"credit":500000000,"unit":"token"}` —— 5 亿 token 领取成功。
|
|
484
|
+
⚠️ **「领取成功但额度仍是 0」是正常的**:活动的 `effective_at` 是 **23:00**
|
|
485
|
+
(UTC+8),而额度桶要等那个时刻才建(上游 `plans[].status:"active"` 里
|
|
486
|
+
额度已锁定,`balances` 仍是空的)。插件会把它单独显示成一个
|
|
487
|
+
「**待生效**」的包并带出生效时刻,**不并进当前可用额度** ——
|
|
488
|
+
并进去会让折算层在生效前就把 zcode 派发出去(必然失败)。
|
|
489
|
+
⚠️ **国际版(`zai`)账号同样能领到**(2026-10-23 实测:4 个账号含 2 个
|
|
490
|
+
国际版都拿到同一个 1024 计划)⇒ 服务端**不按 OAuth 渠道区分**;
|
|
491
|
+
「只有中国版有」是官方客户端**奖励中心分站**(`/cn/rewards` vs `/en/rewards`)
|
|
492
|
+
造成的**入口**差异,插件不做渠道特判。
|
|
493
|
+
⚠️ 领取成功后插件会回报一次 `POST /marketing/touch/action`(`confirm`),
|
|
494
|
+
否则服务端会**反复投放同一个活动** ⇒ 每轮签到白烧一个验证参数
|
|
495
|
+
(阿里云验证是**设备级**配额)。失败时**绝不**回报 —— 那会让用户白丢一次机会。
|
|
496
|
+
- **`qiniu`(七牛云 AI)** 登录方式是**粘贴 API Key**(无浏览器、无需回调):
|
|
497
|
+
在面板点「+ 新建账号」,把 `portal.qiniu.com/ai-inference/api-key` 创建的 Key 贴进去即可
|
|
498
|
+
(至少 16 位、无空白)。Key **长期有效、不需要续期**,同一条 Key 重复添加会**复用**
|
|
499
|
+
同一个账号(不会平白多出一个额度桶)。
|
|
500
|
+
⚠️ **面板不显示余额,也没有签到按钮** —— 七牛云 AI 的用量与计费只在它的 web 控制台
|
|
501
|
+
可见,没有可调用的余额接口。这不是「还没做」,是上游确实没有。
|
|
502
|
+
⚠️ 它的**模型 id 由平台动态下发**(形如 `deepseek-v3` 与 `moonshotai/kimi-k3` 两种写法
|
|
503
|
+
混排),插件**原样透传**、不做任何改写 —— 手填模型 id 时必须与七牛云模型广场的
|
|
504
|
+
「API model 参数」**逐字一致**,多写斜杠或少写斜杠都会 404。
|
|
505
|
+
⚠️ **图片输入与思考档位都未声明**:VL 系模型确实在目录里,但七牛云侧**未做读图实测**,
|
|
506
|
+
插件按「不支持」处理(宁可挡住也不让模型对着图片编答案);思考档位同理 —— 上游支持
|
|
507
|
+
`low|medium|high` 但目录不下发每个模型的支持情况,故不显示档位选择器。
|
|
508
|
+
⚠️ 额度耗尽后的冷却**对齐 UTC+8 当日 24:00**(七牛的额度按自然日重置),不会把账号
|
|
509
|
+
锁满 24 小时。
|
|
510
|
+
- **`qoder` / `qodercn`** 共用同一套实现,差异仅在产品配置。
|
|
511
|
+
- **`minimax` / `minimaxintl`** 共用同一套实现(**唯一**的 Anthropic Messages
|
|
512
|
+
协议族渠道),差异仅在产品配置。⚠️ 两站的**账号不互通、API 主机也不同**,
|
|
513
|
+
故它们是**两个独立面板** —— 各自在自己的面板里点「+ 新建账号」即可,
|
|
514
|
+
**无需选择站点**(`minimax` → `agent.minimax.cn`,`minimaxintl` → `agent.minimax.io`)。
|
|
515
|
+
✅ **国际版已完成真机验证**(2026-10-15):登录、账号管理、模型目录、**推理**、
|
|
516
|
+
**每日签到**、**积分查询**全部实测可用 —— 与国内站**协议同形**(认证同样只需
|
|
517
|
+
`Authorization: Bearer`)。核验入口见 `tests/e2e/README.md` 的
|
|
518
|
+
`test:e2e:minimaxintl`。
|
|
519
|
+
⚠️ 国际站的**目录端点当前是公开的**(无 token、垃圾 token 都 200)⇒
|
|
520
|
+
「能看到模型列表」**不代表**凭据有效(凭据证据看签到 / 积分 / 推理)。
|
|
521
|
+
⚠️ 若国际站各端点**同时**报 `token is required` / `invalid signature`,
|
|
522
|
+
请先怀疑**上游故障**而不是配置 —— 此时**官方 mcode 客户端也会同样失败**。
|
|
523
|
+
- **`gemini`(必须过墙,见「出不去墙外服务」一节)**:Google 的登录与接口全部
|
|
524
|
+
在墙外。⚠️ 症状极具误导性:**浏览器能打开授权页并点「同意」,面板里账号却一直
|
|
525
|
+
不出现** —— 因为**浏览器读系统代理、插件进程不读**。这不是 `client_secret` 或
|
|
526
|
+
`redirect_uri` 配错(那个 bug 已被修掉,token 端点强制校验客户端身份)。
|
|
527
|
+
- **`accio`** 登录走浏览器回调。⚠️ **新建账号时必须先选登录区域**(中国版 `www.accio-ai.com` / 国际版 `zh.accio.com`):两个区域的**登录页域名不同**,
|
|
528
|
+
而区域由服务端按账号下发、**登录前无法自动判断** ⇒ 选错会打开打不开的登录页,
|
|
529
|
+
**登录不会成功**。区域会写进凭据,续期与推理按它选域名。
|
|
530
|
+
⚠️ **它没有签到按钮** —— 每日积分由服务端在**登录时**发放(24 小时有效、
|
|
531
|
+
**不累积**,未登录的那天不补),没有可调用的领取接口。面板上的积分按服务端下发的
|
|
532
|
+
**三类桶**(每日 / 每月 / 推荐)分列显示,并给出每日额度的重置倒计时。
|
|
533
|
+
⚠️ **「刷新每日额度」入口尚未实现**:它本质是**重新登录既有账号**,
|
|
534
|
+
需要宿主侧新增一条 RPC(现有的「+ 新建账号」每次都会新造账号,拿它重登只会
|
|
535
|
+
多出一个空账号而原账号额度不变)。**当前要刷新请删除该账号后重新登录一次。**
|
|
536
|
+
⚠️ 模型**倍率跨度极大**(0.013 ~ 2.8,**215 倍**),故倍率直接写进模型展示名
|
|
537
|
+
(`模型名 · x倍率`),选型时看名字即可。
|
|
538
|
+
⚠️ **图片输入未实测**,面板会明确报「暂不支持图片输入」而不是静默丢掉。
|
|
539
|
+
⚠️ **该渠道不产生限流标记**(也不会被限流探针测出东西),故「重测 / 重置」这组
|
|
540
|
+
按钮对它**整组不渲染** —— 渲染出来只会是点不动的死控件。
|
|
541
|
+
- **`doubao`(豆包 / 字节)**:**只有扫码登录 + 每日签到 + 积分**,**没有模型调用**
|
|
542
|
+
(`channel: false` —— 没有适配器、也没有模型目录,故它不会出现在对话框的模型
|
|
543
|
+
选择器里)。点「+ 新建账号」会起一个**可见**的 Chrome 窗口打开豆包,用手机豆包
|
|
544
|
+
App 扫码后从该会话读 `sessionid` 落池;每日签到与积分查询也走同一个浏览器会话。
|
|
545
|
+
⚠️ **本机必须有 Chromium 内核浏览器**。候选链(Windows 专属项**只在 Windows 上**参与):
|
|
546
|
+
`DSH_DOUBAO_BROWSER_PATH` → `C:\Program Files\Google\Chrome\Application\chrome.exe`
|
|
547
|
+
→ `%ProgramFiles%\…\chrome.exe` → `%LOCALAPPDATA%\…\chrome.exe` →
|
|
548
|
+
`D:\Program File\Doubao\app\Doubao.exe`(豆包客户端内核)→ **跨平台自动探测**
|
|
549
|
+
(macOS 的 `/Applications` 与 `~/Applications` 下的 `.app` 包;Linux 的 `/usr/bin`、
|
|
550
|
+
`/opt` 与 snap/flatpak 的 `exports/bin/`;Windows 的 scoop / Edge / Chromium)。
|
|
551
|
+
⚠️ 只有**绝对路径**才算命中 —— 相对路径交给 `existsSync` 会以当前工作目录为准。
|
|
552
|
+
⚠️ 找不到时提示会**分平台**说人话、回显 `DSH_DOUBAO_BROWSER_PATH` 的当前值、
|
|
553
|
+
并逐条列出试过的路径(复用 `browserNotFoundMessage`,与其余五家一致)。
|
|
554
|
+
✅ **2026-11-13 修(Gitee issue IKV5HC)**:修复前候选链**全是 Windows 路径**
|
|
555
|
+
(`C:\Program Files\…\chrome.exe`、`D:\Program File\Doubao\…`),于是 macOS /
|
|
556
|
+
Linux 上**必然**报「豆包登录需要本机有 Chromium 内核浏览器…未找到可执行文件」,
|
|
557
|
+
而用户的 Mac 上 Chrome 装得好好的。登录与签到**两个**函数都已接上跨平台探测
|
|
558
|
+
(只修一个会变成「扫码能进、签到照样报错」)。
|
|
559
|
+
⚠️ 设备身份由 `accountKey`(= `sessionid`)**确定性派生**出 19 位数字设备号
|
|
560
|
+
⇒ 多账号各自独立,不共享「每设备每天一次」的签到配额。
|
|
561
|
+
⚠️ 自动点击页面上的「登录」按钮优先派发**受信任鼠标事件**
|
|
562
|
+
(CDP `Input.dispatchMouseEvent` 的 `mousePressed` + `mouseReleased`,
|
|
563
|
+
Chromium 会自行派生 `pointerdown` / `mousedown` / …);以下三种情形退回
|
|
564
|
+
**合成事件序列**(`pointerdown → mousedown → pointerup → mouseup → click`):
|
|
565
|
+
按钮拿不到可点盒子(`0×0`)、**被浮层盖住或在视口外**(`document.elementFromPoint`
|
|
566
|
+
命中的不是按钮 —— 受信任点击打在坐标上,会落到浮层上,按钮一个事件都收不到)、
|
|
567
|
+
按钮压根找不到。合成事件直接 `dispatchEvent` 到元素本身,能绕过遮挡。
|
|
568
|
+
⚠️ 为什么不能只发 `click()`:豆包的处理器挂在 `pointerdown` / `mousedown` 上,
|
|
569
|
+
而 `HTMLElement.click()` **只发 `click`**,自动点击会静默失效、用户得手动点。
|
|
570
|
+
|
|
571
|
+
### 一键领取积分
|
|
572
|
+
|
|
573
|
+
在对应面板标题栏点「**一键领取积分**」,插件会**顺序**处理该面板下的所有账号
|
|
574
|
+
(顺序执行以避免并发请求),并**逐账号显示结果与原因**。
|
|
575
|
+
|
|
576
|
+
⚠️ 汇总**按单位分列**,不跨量纲求和 —— `ZCode` 的额度单位是 **token**、其余渠道是
|
|
577
|
+
**积分**,两者不可折算,因此显示成 `+100.00MToken, +100积分` 而不是加成一个数。
|
|
578
|
+
|
|
579
|
+
魔搭默认参与全局自动签到。可在「渠道管理 → ModelScope(魔搭)」单独关闭魔搭自动签到,
|
|
580
|
+
保存后从下一轮调度起生效,手动领取仍可用。该功能通过网页登录触发发放,
|
|
581
|
+
使用前请查看[魔搭社区用户协议](https://modelscope.cn/protocol/用户协议)。
|
|
582
|
+
面板展示可用魔粒余额及日奖励批次的实际到期时间。根据[魔粒体系说明](https://modelscope.cn/docs/magicube/intro),
|
|
583
|
+
短期魔粒有效 24 小时,长期魔粒有效 90 天,均按发放时间起算。
|
|
584
|
+
|
|
585
|
+
|
|
586
|
+
### 模型列表开关
|
|
587
|
+
|
|
588
|
+
每个 provider 的面板都有「**显示列表**」按钮,可逐个开关模型,控制它是否出现在
|
|
589
|
+
对话框的模型选择器里(**黑名单制**,默认全部显示)。开关按 provider 隔离。
|
|
590
|
+
|
|
591
|
+
### 锁定永久积分
|
|
592
|
+
|
|
593
|
+
`buddy` / `workbuddy` / `loomy` 提供「**锁定永久积分**」按钮,用来保住不会马上
|
|
594
|
+
作废的积分。判定规则:距扣费截止不足 15 天的算**临时**(优先消耗),其余算永久。
|
|
595
|
+
锁定后只消耗临时积分,用完则明确报错而不是偷偷烧掉永久积分。
|
|
596
|
+
|
|
597
|
+
### 出不去墙外服务(`gemini`,以及任何需要代理的环境)
|
|
598
|
+
|
|
599
|
+
`gemini` 是本插件里**必须过墙**的渠道:令牌端点(`oauth2.googleapis.com/token`)、
|
|
600
|
+
userinfo、Cloud Code 的配额与推理端点(`cloudcode-pa.googleapis.com`)全部在墙外。
|
|
601
|
+
|
|
602
|
+
**典型症状**:浏览器**能**打开授权页并点「同意」,回到面板却一直失败、账号列表里
|
|
603
|
+
始终没有这个号;或账号在、但积分与对话全部失败。
|
|
604
|
+
|
|
605
|
+
**为什么浏览器能用、插件不能用**:浏览器读 **Windows 系统代理(WinINET)**,
|
|
606
|
+
而插件跑在 Node 的 `fetch`(undici)上,它**既不读系统代理、也不读
|
|
607
|
+
`HTTP(S)_PROXY`**。这条差异是全部症状的根源。
|
|
608
|
+
|
|
609
|
+
#### 两种配法(任选其一)
|
|
610
|
+
|
|
611
|
+
**① 给单个账号配出口代理(推荐)**
|
|
612
|
+
|
|
613
|
+
在 Gemini 面板的账号卡片上点「**代理**」→ 填地址(`http://127.0.0.1:7897` /
|
|
614
|
+
`socks5://…` / 带认证的 `http://user:pass@host:port`)→「测试连接」→ 保存。
|
|
615
|
+
|
|
616
|
+
- 「测试连接」**打的是 Google 自己的端点**(不是通用的出口 IP 查询服务):
|
|
617
|
+
代理能通 `ip-api` 却被 Google 拒的情况很常见,用后者会产生**假阳性**。
|
|
618
|
+
- 配好后该账号的**登录、续期、积分、对话**全部走这条出口,且**每个账号可以
|
|
619
|
+
配不同的代理**。
|
|
620
|
+
- ⚠️ 该配置只作用于 Gemini(与 `opencode` 的「代理」是**两份独立配置**,
|
|
621
|
+
清掉互不影响)。
|
|
622
|
+
|
|
623
|
+
**② 启动 dsh 之前导出环境变量**
|
|
129
624
|
|
|
130
|
-
|
|
625
|
+
```powershell
|
|
626
|
+
# PowerShell
|
|
627
|
+
$env:HTTPS_PROXY = 'http://127.0.0.1:7897'
|
|
628
|
+
$env:HTTP_PROXY = 'http://127.0.0.1:7897'
|
|
629
|
+
$env:NO_PROXY = 'localhost,127.0.0.1,::1'
|
|
630
|
+
dsh
|
|
631
|
+
```
|
|
632
|
+
|
|
633
|
+
⚠️ **必须「导出为环境变量」**。只打开系统代理开关(Windows 设置里的「使用代理
|
|
634
|
+
服务器」)**无效** —— 那正是浏览器能用、插件不能用的原因。
|
|
635
|
+
|
|
636
|
+
宿主 dsh 会在**第一个插件加载前**装一个全局代理分发器,所以这种配法对**插件的全部
|
|
637
|
+
请求**生效(不只 Gemini),也**不需要**额外设置 `NODE_USE_ENV_PROXY`。
|
|
638
|
+
|
|
639
|
+
#### Node 版本差异(2026-10-18 本机实测)
|
|
640
|
+
|
|
641
|
+
若走 ①(账号代理)不受此表影响 —— 它走插件自己的分发器,与 Node 版本无关。
|
|
642
|
+
下表说的是「裸 `fetch` 读环境变量」那条路:
|
|
643
|
+
|
|
644
|
+
| Node | 仅设 `HTTPS_PROXY` | 再加 `NODE_USE_ENV_PROXY=1` |
|
|
645
|
+
|---|---|---|
|
|
646
|
+
| 22.19 | ❌ 不读 | ❌ 不读 |
|
|
647
|
+
| 24.21 | ❌ 不读 | ⚠️ 读,但失败后会反复重试,界面长时间无响应 |
|
|
648
|
+
| 26.10 | ❌ 不读 | ✅ 可用 |
|
|
131
649
|
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
650
|
+
⇒ **结论**:这条「绕过」的路只在较新的 Node 上干净。优先用 ①。
|
|
651
|
+
|
|
652
|
+
#### 报错文案
|
|
653
|
+
|
|
654
|
+
连不上时,插件会明确提示「疑似需要代理」并带上根因码(如
|
|
655
|
+
`UND_ERR_CONNECT_TIMEOUT`),登录失败、续期失败、积分查询失败与对话失败四条腿
|
|
656
|
+
都会给同一句指路文案 —— 不再是一句无信息量的 `fetch failed`。
|
|
657
|
+
|
|
658
|
+
⚠️ 代理恢复后**无需重登**:凭据没被标成失效,后台续期会照常在下一轮把它接上。
|
|
659
|
+
|
|
660
|
+
---
|
|
142
661
|
|
|
143
662
|
## 聚合路由(`aggregate`)
|
|
144
663
|
|
|
145
|
-
|
|
664
|
+
同一个真实模型往往在**多个渠道**都能用(例如 DeepSeek V4.1 Flash 在 buddy、
|
|
665
|
+
codearts、cline 等都有)。聚合路由把「同一个真实模型」在各渠道的条目**归到一个
|
|
666
|
+
规范名下**,请求时自动挑一个渠道发出去。
|
|
667
|
+
|
|
668
|
+
**解决什么**:各家渠道送的免费额度**有到期时间**,用不完就作废。聚合层按
|
|
669
|
+
「**最快作废的额度优先用**」自动排序,把临期积分先烧掉。
|
|
670
|
+
|
|
671
|
+
**怎么用**:
|
|
672
|
+
|
|
673
|
+
1. 在模型选择器里选 **`aggregate`** 分组;
|
|
674
|
+
2. 想**不挑模型**就选该分组下的 **`auto`** —— 它用**所有参与轮换的渠道**的全部模型当
|
|
675
|
+
候选池(哪些渠道参与见下面「参与轮换的渠道」);
|
|
676
|
+
3. 想**指定模型**就选该分组下的**具体规范名**(如 `Deepseek-V4.1-Flash`)。
|
|
677
|
+
|
|
678
|
+
选中后模型名旁会附一个 **`· <渠道>`** 后缀,那是**首选渠道**(临期最早的那个)。
|
|
679
|
+
⚠️ 它**不是「本次实际发往的渠道」** —— 真实历史由**用量徽标**显示。
|
|
680
|
+
|
|
681
|
+
**自动切换**:某个渠道失败时会换下一个候选重试,但只在**还没吐出任何可见内容**
|
|
682
|
+
时才切换(已输出的内容收不回来,拼接会产生畸形回答)。
|
|
683
|
+
|
|
684
|
+
**参与轮换的渠道**:`buddy` / `workbuddy` / `loomy` / `codearts` / `zcode` /
|
|
685
|
+
`lobsterai` / `trae` / `accio` / `officeace` 九家。其余渠道**暂不参与**(插件对
|
|
686
|
+
它们的额度到期时刻没有可靠信息,宁可少一个候选,不可把未知当可用)—— 它们仍可
|
|
687
|
+
**直连**正常使用。
|
|
688
|
+
|
|
689
|
+
⚠️ **真正决定「某渠道在不在轮换里」的是一张编译期清单**
|
|
690
|
+
(`src/aggregate-expiry.ts` 的 `WIRED_EXPIRY_PROVIDERS`),**不是**
|
|
691
|
+
`src/aggregate-adapter.ts` 的 `AGGREGATE_CHANNELS`。上面这份名单就是按前者列的。
|
|
692
|
+
只加 `AGGREGATE_CHANNELS` 是**无效接线**,且症状**完全静默**(零报错、零日志)。
|
|
693
|
+
后果分两种,别只记住第一种:
|
|
694
|
+
|
|
695
|
+
| 该渠道的模型 | 会发生什么 |
|
|
696
|
+
|---|---|
|
|
697
|
+
| 与已接入渠道**共用规范名** | 它的候选**出现在聚合面板里**,但**默认不参与轮换**(标着「无临期积分 · 未参与」)⇒ 需要你**逐条手工打开** |
|
|
698
|
+
| 是**独有**模型 | 虚拟模型**也在目录里**(可被选中),同样默认不参与轮换、可逐条手工打开 |
|
|
699
|
+
|
|
700
|
+
⚠️ 上面第二行是 **2026-10-15 的行为变更**:升级前这类模型会被过滤掉、**连聚合目录都进不去**,
|
|
701
|
+
于是「手工打开候选」之后你在模型选择器里**仍然看不到它**(打开白做)。
|
|
702
|
+
现在改为**目录身份与你的开关无关**:模型始终在目录里,参不参与由每条候选自己的状态决定。
|
|
703
|
+
若你选了一个「没有任何候选在轮换」的模型,报错会**如实**告诉你这一点(并给出面板路径),
|
|
704
|
+
而不是把它藏起来。
|
|
705
|
+
|
|
706
|
+
(真正拦下**轮换候选**的是 `src/aggregate-expiry.ts` 里那句「未接入 ⇒ `UNUSABLE`」
|
|
707
|
+
短路,**不是**适配器自己那几处过滤 —— 后者管的是面板与元数据面。)
|
|
146
708
|
|
|
147
|
-
|
|
709
|
+
### Qoder 的例外:个人资源包能算出逐笔到期
|
|
148
710
|
|
|
149
|
-
|
|
150
|
-
-
|
|
151
|
-
|
|
711
|
+
`qoder` / `qodercn` 的**套餐额度**仍然没有到期时刻,但**个人资源包**(`addOnQuota`)
|
|
712
|
+
在 2026-11-14 之后有两条可得来源:
|
|
713
|
+
|
|
714
|
+
1. **官网明细**(首选,精确):在设置页对应账号上点「会话」,粘贴一次官网
|
|
715
|
+
`https://qoder.com/account/usage` 的 `Cookie`(或整条「复制为 cURL」)。插件会用
|
|
716
|
+
它读 `/api/v2/me/usages/big_model_credits`,按 `expires_at` 逐笔拆出到期日。
|
|
717
|
+
⚠️ 这个 Cookie **能登录你的官网账号** ⇒ 只存在本机凭据库的独立条目
|
|
718
|
+
(`<credentialRef>_web`,删账号时一并清理),**不下发客户端、不写日志**。
|
|
719
|
+
2. **领取记录推算**(兜底,近似):每日领取成功时把「这一笔多少、什么时候到期」记下来,
|
|
720
|
+
下次按「先到期先扣」推算。推算出来的包会标注**「按领取记录推算」**。
|
|
721
|
+
|
|
722
|
+
两条都没有时,那一整包仍显示**「到期未知」**(不是「永久」)—— 这是 Issue IKTLMX
|
|
723
|
+
定下的红线:**未知不许渲染成永久**。
|
|
724
|
+
|
|
725
|
+
### 没有临期信息的渠道:默认不参与,可逐条打开
|
|
726
|
+
|
|
727
|
+
对那 7 家**没有可靠到期时刻**的渠道(`qoder` / `qodercn` / `cline` / `raccoon` /
|
|
728
|
+
`minimax` / `gemini` / `opencode`),2026-10-15 起你可以在聚合面板里**逐条手工打开**
|
|
729
|
+
它们的候选,打开后它们**真的参与轮换**(排在所有能算出临期的候选**之后** ——
|
|
730
|
+
它们之间没有可比较的到期时间,那种混合顺序是**正常**的,不是缺陷)。
|
|
731
|
+
|
|
732
|
+
- **默认态是「不参与」**:插件对它们的配额一无所知,默认放行会把失败留给你;
|
|
733
|
+
- 顶部有 **「拒绝非临期」** 一键按钮,把所有没有临期折算的渠道**恢复成默认不参与**
|
|
734
|
+
(已接入的九家**不受影响** —— 它们的手工打开是有意义的);
|
|
735
|
+
- ⚠️ **没有「一键全部放行」**:配额未知的渠道被批量放行会把失败留给你,
|
|
736
|
+
故只提供逐条打开 + 一键恢复默认这一对操作。
|
|
737
|
+
|
|
738
|
+
⚠️ 同一个账号的额度到期信息**不会因为手工打开而变得可知** —— 打开只是允许插件去**尝试**它。
|
|
739
|
+
|
|
740
|
+
### 候选顺序:按临期排序 / 按手工排序
|
|
741
|
+
|
|
742
|
+
面板顶部有一个两段式开关:
|
|
743
|
+
|
|
744
|
+
| 模式 | 意思 | 会自动刷新吗 |
|
|
745
|
+
|---|---|---|
|
|
746
|
+
| **排序:按临期** | 按「积分最快作废」的顺序(默认) | ✅ 面板打开期间**每 2 分钟**自动重查一次;该模式也是探测按钮,点它立即重查 |
|
|
747
|
+
| **排序:按手工** | 按你拖出来的顺序 | ❌ 不自动重查(顺序由你决定) |
|
|
748
|
+
|
|
749
|
+
- 两种顺序**分别保存**:切到手工拖好、再切回临期,切回手工时你排的顺序**还在**;
|
|
750
|
+
- 手工模式下可**拖动**候选调整顺序(鼠标拖动手柄,**松手即保存** —— 不需要再点按钮);
|
|
751
|
+
- 手工序是**严格序**:你拖过的候选排在**全部**没拖过的之前,**即使它临期更晚** ——
|
|
752
|
+
否则你的拖动会被临期值静默覆盖;
|
|
753
|
+
- 没拖过的候选按「临期 ↑ → 倍率 ↑」追加在**后面**(新增的候选因此不会消失)。
|
|
754
|
+
|
|
755
|
+
⚠️ **「按临期」不是后台常驻定时刷新**:它只在**面板打开且处于该模式**时每 2 分钟查一次
|
|
756
|
+
(且标签页在后台时跳过)。关掉面板就不再查询 —— 插件没有为「排序展示」常驻的定时器。
|
|
757
|
+
若你在渠道侧改了配置想立刻看到,点一次「排序:按临期」即可。
|
|
758
|
+
|
|
759
|
+
同类陷阱已**多次**发生(`cline` 只进过 `AGGREGATE_CHANNELS`、**从未**进过白名单;
|
|
760
|
+
`accio`、`officeace` 是先进行、后补白名单)。接新渠道时**两处必须同改**,
|
|
761
|
+
另有第三处 `src/provider-expiry.ts` 的 `createProviderExpiry()` 一并跟进 ——
|
|
762
|
+
后两者的运行期一致性由 `tests/unit/expiry-runtime-parity.spec.ts` 锁住。
|
|
763
|
+
|
|
764
|
+
⚠️ **`zcode` 的额度是「按模型」分桶的**,故它的可用性是**逐模型**判定的:
|
|
765
|
+
赠送的 8M 实测分成 `GLM-5.3` 3M 与 `GLM-5.3-Flash` 5M 两个**专属桶**
|
|
766
|
+
(上游在余额接口里下发 `capabilities: ["model:<模型>"]`)。某个模型烧光而另一个
|
|
767
|
+
还有额度时,只会把**烧光的那个模型**在该账号上标记为当日用尽 ——
|
|
768
|
+
另一个模型照常可用,不会因为「账号整体还有额度」而误派发到已尽的模型上。
|
|
769
|
+
若账号另有**不限定模型**的通用赠送额度(如 1 亿 token),且它还有余额,
|
|
770
|
+
则两个模型都仍可用(通用额度能承接它们)。
|
|
771
|
+
|
|
772
|
+
**上下文窗口**:聚合模型声明的是**候选渠道里的最大值**。同一个模型在 buddy /
|
|
773
|
+
codearts 上都是 1M,那么 `aggregate` 下选它也声明 1M(与直连一致)。⚠️ 若某次
|
|
774
|
+
请求恰好被路由到窗口更小的候选,由**失败切换**兜住(上游报超长 ⇒ 换下一个候选)。
|
|
775
|
+
|
|
776
|
+
**思考档位**:声明各渠道档位的**并集**(官方中文名),默认 `high` —— 与你选的
|
|
777
|
+
档位会**逐候选翻译**到目标渠道(精确命中就原样下发,写法不同就就近落到同族,
|
|
778
|
+
目标没有这一族就**不下发**该字段让它走自己的默认)。
|
|
779
|
+
|
|
780
|
+
聚合有**自己的**设置面板(Jet Hub 左侧 rail 的「聚合」项),可逐条控制候选
|
|
781
|
+
「是否参与轮换」(三态:参与 / 已拒绝 / 无临期积分·默认不参与),并提供
|
|
782
|
+
「排序:按临期 / 按手工」开关与「拒绝非临期」一键恢复。它没有账号与凭据(复用各渠道的账号)。
|
|
783
|
+
|
|
784
|
+
### ⚠️ 模型选择器里为什么有**两个**「Auto」
|
|
785
|
+
|
|
786
|
+
选到「不挑模型」这一档时,选择器里会出现**两条**看起来同义的项:
|
|
787
|
+
|
|
788
|
+
| 选择器里显示为 | 真实路由 | 代码 |
|
|
789
|
+
|---|---|---|
|
|
790
|
+
| **`聚合(跨渠道临期优先)`** 组下的 `Auto(聚合 · 跨渠道)` | `aggregate` / `auto` | `src/aggregate-adapter.ts` |
|
|
791
|
+
| **`Jet Hub 自动(临期优先)`** 组下的 `Auto(临期优先 · 整池)` | `jet-hub-auto` / `auto` | `src/auto-adapter.ts` |
|
|
792
|
+
|
|
793
|
+
后者是**上一代实现**(2026-10-06),前者是随后的重写(2026-10-07,`ba10f4f`)
|
|
794
|
+
并**泛化**成「规范模型名 + 渠道候选 + auto」三者共用一套排序
|
|
795
|
+
(`aggregate-core.ts`)。⚠️ 旧 auto 的**路由注册从未下线** —— `registerAutoLlm`
|
|
796
|
+
在 `ba10f4f` 前后都在 `src/index.ts` 里;`ba10f4f` 删掉的是它的**用量徽标接线**
|
|
797
|
+
(`lastDispatch` / `lastExpiryAt` 等字段与 `usage.badge` 改写),由 `2b8867c`
|
|
798
|
+
(2026-10-08「恢复旧 auto 的用量徽标」)补回,**两代因此并存至今**。
|
|
799
|
+
`src/index.ts` 的接线注释里直接称它为「**旧 auto**」。
|
|
800
|
+
|
|
801
|
+
⚠️ **日常请优先用 `聚合(跨渠道临期优先)`** —— 它是活跃维护线,两者**至少有四处**实质差异:
|
|
802
|
+
|
|
803
|
+
| | `aggregate/auto` | `jet-hub-auto/auto` |
|
|
804
|
+
|---|---|---|
|
|
805
|
+
| 候选渠道 | **9 家**(`WIRED_EXPIRY_PROVIDERS`) | **5 家**(`AUTO_PROVIDERS` 硬编码:`codearts` / `loomy` / `zcode` / `buddy` / `workbuddy`) |
|
|
806
|
+
| 尊重「拒绝轮换」开关 | ✅ | ❌ 不读拒绝表 |
|
|
807
|
+
| 「收下请求却零输出」目标级冷却 | ❌ 无 | ✅ 有(`zero-output-guard.ts`,issue IKJW31) |
|
|
808
|
+
| **候选级失败切换** | ✅ 某渠道失败时按候选序**换下一个重试** | ❌ **不换**:上游报错即整轮失败(只对「零输出」这一种情形改道) |
|
|
809
|
+
|
|
810
|
+
⚠️ **模型黑名单关不掉旧 auto**:它的 `listModels()` 无条件返回这一个模型、不套用户黑名单
|
|
811
|
+
(黑名单针对的是各渠道的真实模型),且 `jet-hub-auto` **不在** `provider-registry.ts`
|
|
812
|
+
里 ⇒ 设置页里连它的面板都没有。**忽略它即可**,选聚合那条。
|
|
813
|
+
|
|
814
|
+
⚠️⚠️ 但这**不等于「无法隐藏」**:`jet-hub-auto` 的 `ctx.llm` 注册路由**参与「已失效模型
|
|
815
|
+
剔除」**(`auto-adapter.ts` 注册时没传 `pruning`,而缺省即参与 —— 见
|
|
816
|
+
`llm-register-compat.ts` / `dead-model-store.ts`;对照 `src/index.ts` 对 `aggregate`
|
|
817
|
+
与对 `jet-hub-auto` 的**设置页表项**都是显式 `{ enabled: false }`)。
|
|
818
|
+
一旦 `dead-models.json` 里出现 `jet-hub-auto/auto` 记录,它就会从模型选择器消失,
|
|
819
|
+
而清除入口 `model.clearDead` 位于**它没有的那个面板**里 ⇒ **没有界面能恢复**
|
|
820
|
+
(只能手改 `dead-models.json` 或等 TTL 过期)。
|
|
821
|
+
⚠️ 生产可达性**未证实**:已知写入口需在该路由迭代中抛出「模型已下架」类错误,
|
|
822
|
+
而 auto 自身不走那条路径(真实用户盘里也只有一条 `aggregate/m1` 历史记录)。
|
|
823
|
+
⇒ 机制真实、当下**侥幸**未触发,按「**脆弱的绿**」对待。
|
|
824
|
+
|
|
825
|
+
(`src/aggregate-adapter.ts` 模块头的分工表里,「渠道内选模型 = 按倍率挑最便宜」与
|
|
826
|
+
「用途 = 不挑模型,谁临期烧谁」两格写的是「同左」;⚠️ 但**「候选来源」那格并不相同**
|
|
827
|
+
—— 旧 auto 是「5 个渠道的所有模型」,聚合是「所有渠道的所有模型」。
|
|
828
|
+
上表列的是**最要紧**的四处,不是穷举:上下文窗口的声明口径、用量徽标的数据源、
|
|
829
|
+
候选粒度(聚合按 `(渠道, realId)` 且同渠道内可回落下一个模型,旧 auto 每渠道只挑一个)
|
|
830
|
+
也都不同。是否合并/下线旧 auto 涉及把 `zero-output-guard.ts` 移植过去,
|
|
831
|
+
**属行为变更**,留待维护者定夺。)
|
|
832
|
+
|
|
833
|
+
---
|
|
152
834
|
|
|
153
835
|
## 本机 OpenAI 网关
|
|
154
836
|
|
|
155
|
-
|
|
837
|
+
插件启动后会在 `127.0.0.1:8326` 提供**两套**标准 OpenAI 接口,供 Pi、Continue、
|
|
838
|
+
Cline、OpenCode、Codex 或其他兼容客户端使用。网关复用 Jet Hub 已登录账号和现有
|
|
839
|
+
provider 适配器,不把上游凭据复制到客户端。
|
|
840
|
+
|
|
841
|
+
```
|
|
842
|
+
GET http://127.0.0.1:8326/v1/models
|
|
843
|
+
GET http://127.0.0.1:8326/v1/reasoning-efforts ← 思考档位对照表
|
|
844
|
+
POST http://127.0.0.1:8326/v1/chat/completions ← OpenAI Chat Completions
|
|
845
|
+
POST http://127.0.0.1:8326/v1/responses ← OpenAI Responses API
|
|
846
|
+
```
|
|
847
|
+
|
|
848
|
+
⚠️ **两个端点同时可用,没有「格式开关」**:客户端用哪一套协议,由它自己请求的
|
|
849
|
+
路径决定。
|
|
850
|
+
|
|
851
|
+
⚠️ 上面那两个地址里的 **host 与端口都可被环境变量改掉**
|
|
852
|
+
(`DSH_OPENAI_GATEWAY_HOST` / `DSH_OPENAI_GATEWAY_PORT`);设置页里的
|
|
853
|
+
「API 请求地址」显示的是**实际监听地址**,照它抄即可。
|
|
156
854
|
|
|
855
|
+
### 容器化部署(Docker / Compose)
|
|
856
|
+
|
|
857
|
+
默认只绑 `127.0.0.1`,因此**端口映射对网关无效**:容器里 `curl 127.0.0.1:8326`
|
|
858
|
+
能通只是假象,docker-proxy 与同网络的其它容器走的是容器桥接 IP(`eth0`),
|
|
859
|
+
那个地址上没有监听,于是宿主侧看到 `Connection reset by peer`
|
|
860
|
+
(对照:Web 端口绑的是容器 IP,所以映射可用)。
|
|
861
|
+
|
|
862
|
+
修法是让网关绑**容器自身的接口地址**:
|
|
863
|
+
|
|
864
|
+
```yaml
|
|
865
|
+
environment:
|
|
866
|
+
- DSH_OPENAI_GATEWAY_ENABLED=1
|
|
867
|
+
- DSH_OPENAI_GATEWAY_HOST=172.21.0.8 # 容器自身 IP:hostname -i 或 ip -4 addr show eth0
|
|
868
|
+
- DSH_OPENAI_GATEWAY_PORT=8326
|
|
157
869
|
```
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
870
|
+
|
|
871
|
+
```console
|
|
872
|
+
$ docker exec dsh ss -tlnp | grep 8326
|
|
873
|
+
LISTEN 172.21.0.8:8326 # 绑上桥接 IP 后,端口映射才可达
|
|
162
874
|
```
|
|
163
875
|
|
|
164
|
-
|
|
876
|
+
⚠️ **不许填 `0.0.0.0` / `::` 这类通配地址**:会被显式拒绝并在启动前报错
|
|
877
|
+
(dsh 本体的 `--host` 也是同一姿态)。绑通配等于把网关暴露给整个网络,
|
|
878
|
+
真正的隔离只剩 API Key —— 而本网关承担的是「用你已登录的账号发请求」。
|
|
879
|
+
容器场景填容器自身 IP 即可。
|
|
880
|
+
|
|
881
|
+
⚠️ **暴露面不止「同一容器网络内的其它容器」,还包括宿主**:经端口映射(`-p`)
|
|
882
|
+
或 bridge 网关,宿主本身就能连到该端口。跨 bridge 网络的容器才被隔离。
|
|
883
|
+
设置页里绑了非回环地址时会显示这条提示;不打算对外提供时请保持默认
|
|
884
|
+
`127.0.0.1`(或删除该环境变量)。
|
|
885
|
+
|
|
886
|
+
### 拿到地址与密钥
|
|
887
|
+
|
|
888
|
+
鉴权使用 `Authorization: Bearer <网关 API Key>`。
|
|
889
|
+
|
|
890
|
+
⚠️ 因此**在浏览器地址栏直接打开这些地址会返回 401**(没有带 Bearer 头)——
|
|
891
|
+
这是预期行为,不是网关没启动。请用客户端或 `curl` 带上传头访问。
|
|
892
|
+
|
|
893
|
+
优先从 `DSH_OPENAI_GATEWAY_API_KEY` 读取;未设置时,插件首次启动会在 DSH home 的
|
|
894
|
+
`openai-gateway/api-key` 生成并持久化随机密钥,重启后保持不变。
|
|
895
|
+
|
|
896
|
+
设置页里的开关状态存在 `$DSH_HOME/jet-hub/state.json` 的 `gatewayEnabled` 字段
|
|
897
|
+
(缺省为启用)。它**不进**账号备份/恢复。
|
|
898
|
+
|
|
899
|
+
### Qoder 和 Qoder CN 的并发与排队
|
|
900
|
+
|
|
901
|
+
Qoder 和 Qoder CN 的「单账号限流」默认开启,可在 Jet Hub 的对应渠道页分别关闭。设置保存后对新请求立即生效。同一个进程内,每个渠道的同一账号**同时只允许一个请求占着名额**,两次发出请求至少间隔 400 毫秒。账号已忙时立即返回本地排队错误。⚠️ 进入上游排队等待(`10605`)的那一刻会**让出名额**:否则一个账号被平台排队,就会把同一账号的其余请求全部拒掉。让出后这个账号可能在「本地等间隔」与「上游排队」两处各有一个请求 —— 那是排队不是并发调用,平台侧允许。面板尚未保存设置时,可用 `DSH_QODER_TRAFFIC_GUARD=off` 关闭默认限流。
|
|
902
|
+
|
|
903
|
+
上游返回 `10605` 时,网关识别 HTTP 和 SSE 两种响应。响应体未提供等待时间时,使用 HTTP `Retry-After`,每次等待仍以 10 秒为上限。可用 `DSH_QODER_QUEUE_MAX_ATTEMPTS` 设置重试次数(默认 180,`0` 表示立即返回排队错误),用 `DSH_QODER_QUEUE_TIMEOUT_MS` 设置整次排队预算(默认 30 分钟)。
|
|
904
|
+
|
|
905
|
+
直连可通过 `DSH_QODER_QUEUE_WAIT_MODE=visible` 在流式 Chat Completions 响应中查看 `qoder_queue` 排队信息,或设为 `fast` 立即返回错误。日志会记录上游提供的模型、队列类型、人数和可用状态,供排查使用。账号级调用限制由上游平台处理。
|
|
906
|
+
|
|
907
|
+
### 关闭网关
|
|
908
|
+
|
|
909
|
+
网关是**旁路功能**:它启动失败或被关闭,都不影响插件其余功能(登录、积分、模型
|
|
910
|
+
目录照常)。三种关闭方式:
|
|
165
911
|
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
912
|
+
| 方式 | 做法 |
|
|
913
|
+
|---|---|
|
|
914
|
+
| 环境变量 | `DSH_OPENAI_GATEWAY_ENABLED=0`(**完全不启动**,连 API Key 文件都不生成)|
|
|
915
|
+
| 设置页开关 | 关掉后不再监听 |
|
|
916
|
+
| 改端口 | `DSH_OPENAI_GATEWAY_PORT` 填非法值会记录错误并跳过启动,**不会**静默改用其它端口 |
|
|
917
|
+
| 改地址 | `DSH_OPENAI_GATEWAY_HOST` 填通配地址(`0.0.0.0` / `::`)同样记录错误并跳过启动 —— **不会**静默绑到全部网卡 |
|
|
918
|
+
|
|
919
|
+
### 请求体上限与 keep-alive
|
|
920
|
+
|
|
921
|
+
| 项 | 值 | 超限时的行为 |
|
|
922
|
+
|---|---|---|
|
|
923
|
+
| 请求体 | **300 MiB** | `HTTP 413` + `invalid_request_error` / `request_too_large`,响应体里带上限值 |
|
|
924
|
+
| 空闲连接(keep-alive) | **120 秒** | 服务端发 FIN;此后复用该连接会得到 `Connection reset` |
|
|
925
|
+
|
|
926
|
+
⚠️ 每轮把全量历史重新回传的客户端(Codex 等),历史里并入大截图后可能撞上 413:
|
|
927
|
+
新建会话、或删掉那条带大图的回合即可恢复。
|
|
928
|
+
|
|
929
|
+
### 安全边界
|
|
930
|
+
|
|
931
|
+
- **默认**只绑定 `127.0.0.1`,且**拒绝**通配地址(`0.0.0.0` / `::`)。
|
|
932
|
+
只有容器/端口映射这类「客户端不在同一网络命名空间」的场景才需要改
|
|
933
|
+
`DSH_OPENAI_GATEWAY_HOST`,且应填**具体接口地址**(如容器自身 IP)而不是通配。
|
|
934
|
+
⚠️ 改了之后暴露面**包含宿主**(端口映射/bridge 网关都能连到),
|
|
935
|
+
同机与同容器网络的其它用户或进程也能连到该端口 —— 真正的隔离靠 API Key,
|
|
936
|
+
不要把它配置进任何浏览器端工具或扩展。
|
|
937
|
+
- 密钥以明文写在 `$DSH_HOME/openai-gateway/api-key`。POSIX 下的 `0600` 权限在
|
|
938
|
+
**Windows 上不生效**,多用户机器请改用 `DSH_OPENAI_GATEWAY_API_KEY` 环境变量。
|
|
939
|
+
|
|
940
|
+
---
|
|
169
941
|
|
|
170
942
|
## 用量徽标与 Token 用量
|
|
171
943
|
|
|
172
|
-
|
|
173
|
-
|
|
944
|
+
### 用量徽标
|
|
945
|
+
|
|
946
|
+
会话输入区右侧、模型选择器左边有一枚薄胶囊,显示**当前渠道一共有多少可用额度**;
|
|
947
|
+
点开是完整浮层(逐账号明细 / 订阅窗口 / 刷新 / 签到 / 显示偏好)。
|
|
948
|
+
只在选中本插件渠道的模型时渲染,非本插件的模型**不渲染、不发请求**。
|
|
949
|
+
|
|
950
|
+
折叠态按 **`渠道 • 读数`** 两段显示,例如:
|
|
951
|
+
|
|
952
|
+
```
|
|
953
|
+
CodeBuddy (腾讯) • 2434.96积分
|
|
954
|
+
CodeArts (华为云) • 9499.84积分
|
|
955
|
+
ZCode (智谱) • 94.54MToken
|
|
956
|
+
```
|
|
957
|
+
|
|
958
|
+
- **默认显示余额**(一共能用的额度);可在浮层里切换成「优先订阅」或「只看积分」。
|
|
959
|
+
- **多账号只显示一个数字**(所有启用账号的余额合计),不会变成一长串。
|
|
960
|
+
- 账号读不到时合计会**静默少报**,故胶囊会挂一个**警示角标**(`441.78积分 ⚠`)。
|
|
961
|
+
- 浮层里逐账号列表**按余额降序**,超过 5 个折叠成「展开其余 N 个」。
|
|
962
|
+
|
|
963
|
+
### Token 用量
|
|
174
964
|
|
|
175
|
-
|
|
965
|
+
点 Jet Hub 页头的「**Token 用量**」按钮查看。数据分两份:
|
|
966
|
+
|
|
967
|
+
| 数据 | 位置 | 回答的问题 | 重启后 |
|
|
968
|
+
|---|---|---|---|
|
|
969
|
+
| 实时明细 + 汇总树 | 进程内存(上限 500 条) | 每一笔长什么样、这次会话花了多少 | 清空 |
|
|
970
|
+
| 历史日聚合 | `~/.dsh/jet-hub/token-ledger.json` | 本周 / 本月用了多少 | **保留**(按 UTC+8 日界,90 天)|
|
|
971
|
+
|
|
972
|
+
在历史图表中点选某一天并展开,可删除该日的历史累计。删除前会二次确认,只移除该日聚合,不影响实时明细、其他日期或账号设置;之后该日的新请求会重新累计。
|
|
973
|
+
|
|
974
|
+
- **计数是 wire 口径**:上游 usage 报什么记什么,不做本地估算。
|
|
975
|
+
- **总处理量** = 未命中缓存输入 + 缓存命中输入 + 输出;输出已含思考 token,缓存写入另列且不重复计入。不同渠道价格不同,因此这里不把 token 数冒充账单金额。
|
|
976
|
+
- 没收到 usage(失败 / 中断)显示 `—`,与真实的 `0` **严格区分**。
|
|
977
|
+
- 输出速率(tok/s)的分子含思考 token;汇总显示算术均值及完整样本的 P50/P90 估值。
|
|
978
|
+
- 日聚合文件升级到 schema v2 增加 TPS 对数直方图;旧 v1 数据照常读取(计数全保留)。⚠️ **升级前已累计过「输出速率样本」的日期不会显示 P50/P90** —— 判据要求「直方图样本数 = 累计样本数」,而旧桶的 `tpsCount` 在升级前就已累加、直方图为空,两者之差恒定 ⇒ 该日期在 90 天保留期内一直无分位数(`avgTps` 均值仍照常显示)。完全在 v2 之后累计满样本的日期正常显示;升级前存在但**从未有过速率样本**的日期(如当天全是失败请求)也会正常显示。
|
|
979
|
+
|
|
980
|
+
---
|
|
981
|
+
|
|
982
|
+
## 模型选择器里的活动徽标
|
|
983
|
+
|
|
984
|
+
服务商的模型目录**自带**活动信息(「夜间折扣」「限时免费」「错峰 4 折」「订阅优先」)。
|
|
985
|
+
本插件把那句**上游自己的话**读出来,画成宿主模型选择器里名字旁边的一枚胶囊:
|
|
986
|
+
|
|
987
|
+
- 徽标是**此刻**的函数,不是取目录那一刻的快照:活动一过期就不再出现;
|
|
988
|
+
上游标了「只在活动期内显示」(`activeOnly`)的那一类,窗口一关也跟着消失;
|
|
989
|
+
而「夜间折扣」这种上游**故意成对下发**的(夜里那条带折扣、白天另发一条只带同一个
|
|
990
|
+
角标),徽标按上游语义全天挂着、**折扣价只在窗口内给** —— 与官方客户端一致,
|
|
991
|
+
不是「过期了还挂着」;
|
|
992
|
+
- 跨零点的时段按**上游声明的时区**判断(23:00 说的是 Asia/Shanghai 的 23:00,不是你本地的);
|
|
993
|
+
- 一个模型命中多条活动时只画一条,规则是**先看「此刻在跑」、再比优先级**(一条在跑的 priority 0 会压掉一条常驻的 priority 200 —— 这是刻意的:详见 issue #101 的讨论);上游没给文案的条目**一律不画**,插件不编;
|
|
994
|
+
- 颜色由上游给,就近映射成宿主的四档语义色(绿=优惠、蓝=会员、暖色=先看一眼、其余中性)。
|
|
995
|
+
|
|
996
|
+
**它只是提示,不改变模型行为**:计费仍按上游当时的价格。名字里的倍率后缀
|
|
997
|
+
(例如 GLM-5.2 · x0.79→x0.50)讲的是「现在多少钱」,徽标讲的是「上游说这是一条活动」,
|
|
998
|
+
两条腿读**同一份目录文档**,因此不额外发任何请求。
|
|
999
|
+
|
|
1000
|
+
覆盖渠道:buddy / workbuddy(/v3/config 的 modelPromotions 与 modelTiers)、
|
|
1001
|
+
qoder / qodercn(模型目录每行自带的 promotion)。
|
|
1002
|
+
|
|
1003
|
+
> **前提:宿主 ≥ 0.2.2。** 徽标靠宿主目录条目上的 `LlmModelInfo.badge` 字段渲染,
|
|
1004
|
+
> 那是 `@deepseek-ai/dsh-llm` 0.2.2 才有的(`types.d.ts` 的 `LlmModelBadge`)。
|
|
1005
|
+
> 更低的宿主上本功能**静默无效果** —— 插件照常下发 `badge`,但宿主不认识这个键,
|
|
1006
|
+
> 选择器一行都不会变。这是宿主版本门槛,不是配置开关。
|
|
1007
|
+
|
|
1008
|
+
⚠️ 上游按**客户端身份**裁剪这份文档:实测同一个 URL、同一套凭据,App 身份回
|
|
1009
|
+
「限时免费 + 订阅优先」(两个数组都在),纯 CLI 身份**两个数组都不在**(data 只剩 5 个键)。
|
|
1010
|
+
所以「目录里读不到活动」可能是身份问题而不是上游问题 —— 排查时先对照官方客户端。
|
|
1011
|
+
|
|
1012
|
+
窗口开关的那一刻由插件**主动播报**一次目录变更(本地事件,零上游请求),
|
|
1013
|
+
因此徽标不必等 20 分钟的目录刷新周期。
|
|
1014
|
+
|
|
1015
|
+
### 与「用量徽标」的区别
|
|
1016
|
+
|
|
1017
|
+
上面那节讲的是会话输入区右侧那枚**额度**胶囊(本插件自己渲染,走插槽)。
|
|
1018
|
+
本节讲的是模型选择器**每一行**上的活动胶囊(宿主按目录里的 badge 字段渲染)。
|
|
1019
|
+
两者不是同一条通路,数据面与渲染面都不同。
|
|
1020
|
+
|
|
1021
|
+
---
|
|
1022
|
+
|
|
1023
|
+
## 配置项
|
|
1024
|
+
|
|
1025
|
+
| 项 | 位置 | 说明 |
|
|
1026
|
+
|---|---|---|
|
|
1027
|
+
| 账号池 | `$DSH_HOME/jet-hub/state.json` | 账号、有效期、限流标记、模型黑名单、provider 顺序 |
|
|
1028
|
+
| 网关开关 | 同上,`gatewayEnabled` | 缺省启用 |
|
|
1029
|
+
| 供应商显示顺序 | 同上,`providerOrder` | 纯展示偏好,拖动行调整 |
|
|
1030
|
+
| 永久积分锁定 | `$DSH_HOME/jet-hub/*.json`(独立文档)| **不与账号池同放** —— 避免多 profile 互相覆盖 |
|
|
1031
|
+
| Token 账本 | `~/.dsh/jet-hub/token-ledger.json` | 历史日聚合 |
|
|
1032
|
+
|
|
1033
|
+
### 常见环境变量
|
|
176
1034
|
|
|
177
1035
|
| 变量 | 默认 | 说明 |
|
|
178
1036
|
|---|---|---|
|
|
179
|
-
| `DSH_HIDE_MODELS_WITHOUT_ACCOUNT` | 关闭 |
|
|
180
|
-
| `DSH_OPENAI_GATEWAY_ENABLED` | `1` | 设为 `0` / `false`
|
|
181
|
-
| `DSH_OPENAI_GATEWAY_HOST` | `127.0.0.1` |
|
|
1037
|
+
| `DSH_HIDE_MODELS_WITHOUT_ACCOUNT` | 关闭 | 设为真值时,**没有已登录账号的渠道**在模型选择器里整体隐藏 |
|
|
1038
|
+
| `DSH_OPENAI_GATEWAY_ENABLED` | `1` | 设为 `0` / `false` / `off` / `no` 时完全不启动网关 |
|
|
1039
|
+
| `DSH_OPENAI_GATEWAY_HOST` | `127.0.0.1` | 网关监听地址。容器/端口映射场景填**容器自身 IP**(`hostname -i`);填 `0.0.0.0` / `::` 等通配地址会被拒绝并跳过启动 |
|
|
182
1040
|
| `DSH_OPENAI_GATEWAY_PORT` | `8326` | 网关监听端口 |
|
|
183
1041
|
| `DSH_OPENAI_GATEWAY_API_KEY` | 自动生成 | 网关 Bearer 密钥 |
|
|
184
|
-
| `
|
|
185
|
-
| `
|
|
186
|
-
| `
|
|
187
|
-
| `
|
|
188
|
-
| `DSH_CREDITS_STATUS_JITTER_MS` | `50` | 上述查询 worker 启动错峰窗口毫秒(`0` 关闭;上界 `2000`) |
|
|
1042
|
+
| `DSH_REASONING_LOOP_GUARD` | 开启 | 思考死循环守卫总开关 |
|
|
1043
|
+
| `DSH_REASONING_LOOP_AUTO_RESUME` | 开启 | 中止后是否自动补一句「继续」并重跑 |
|
|
1044
|
+
| `DSH_REASONING_LOOP_AUTO_RESUME_MAX` | `2` | 连续自动续跑上限(最大 `10`)|| `DSH_TRAE_CHANNELS` | `solo_work_lite,solo_agent_remote` | TRAE 要拉取的通道,**顺序即优先级** |
|
|
1045
|
+
| `DSH_TRAE_MAX_COMPLETION_TOKENS` | `64000` | TRAE 单次输出上限(设 `0` 关闭收敛)|
|
|
189
1046
|
|
|
190
|
-
|
|
1047
|
+
更多 provider 专属变量(如 `DSH_ZCODE_INTERNAL_CARRIER`、
|
|
1048
|
+
`DSH_TRAE_ROTATE_MACHINE_ID` 等)见内部文档。
|
|
1049
|
+
|
|
1050
|
+
---
|
|
191
1051
|
|
|
192
|
-
|
|
193
|
-
(zcode 余额 / 签到 / WebDAV 同步等接口,同一命令过一会儿又好了)。
|
|
1052
|
+
## 账号备份与迁移
|
|
194
1053
|
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
连接校验必挂。
|
|
1054
|
+
Jet Hub 设置页底部的**备份**区提供导出 / 导入,用于两种情况:**换 DSH 版本时整体迁移**,
|
|
1055
|
+
以及**从别处单独搬一个账号进来**。
|
|
198
1056
|
|
|
199
|
-
|
|
200
|
-
扩宽为「内置根 ∪ Windows 系统证书库」(等价于环境变量 `NODE_USE_SYSTEM_CA=1`
|
|
201
|
-
的语义,但零环境要求、对插件全部出站连接生效)。如果你还看到这个报错:
|
|
1057
|
+
备份文件是**自包含**的 JSON(账号索引 + 凭据原文 + 模型黑名单 + 永久积分锁定表)。
|
|
202
1058
|
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
1059
|
+
> ⚠️ **Qoder 的网页会话 Cookie 也在里面**(`<credentialRef>_web` 是独立凭据条目,
|
|
1060
|
+
> 随账号一起导出)。它**能登录你的官网账号** ⇒ 分享备份文件之前先想清楚;只想迁移
|
|
1061
|
+
> 模型与积分的话,先在设置页点「清除会话」再导出。
|
|
1062
|
+
与 DSH 版本无关 —— 导入时按**当前版本**的存储契约重建,因此天然跨版本。
|
|
206
1063
|
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
1064
|
+
- **加密在浏览器侧完成**(PBKDF2 + AES-GCM),RPC 只收发明文载荷,明文与口令
|
|
1065
|
+
都不经过宿主持久化与日志。可选加密,不勾选即导出明文。
|
|
1066
|
+
- 账号凭据、`refresh_token` 都在文件里,**等同于明文密钥**,请自行妥善保管。
|
|
1067
|
+
- ⚠️ **不含的就是本机偏好**:备份只搬账号与凭据,**不搬**本机 OpenAI 网关开关、
|
|
1068
|
+
用量徽标偏好、自动签到记账等本机状态(导入时它们保持当前值,不会被备份覆盖)。
|
|
1069
|
+
账号条目上的字段(含 OpenCode 的 `opencodeProxy` / 指纹代次,以及 Gemini 的
|
|
1070
|
+
`geminiProxy`)则原样随快照往返。
|
|
211
1071
|
|
|
212
|
-
|
|
213
|
-
[Environment]::SetEnvironmentVariable('NODE_USE_SYSTEM_CA', '1', 'User')
|
|
214
|
-
```
|
|
1072
|
+
### 导出:可以只导出选中的账号
|
|
215
1073
|
|
|
216
|
-
|
|
217
|
-
|
|
1074
|
+
导出弹窗列出当前账号池并可**逐个勾选**(`backup.export` 的 `accountIds`),
|
|
1075
|
+
默认「全部账号」。只导一个账号时文件名会带上该账号 id(`dsh-codearts-backup-buddy-xxxx-日期.json`),
|
|
1076
|
+
避免被误当成整份备份收着。
|
|
218
1077
|
|
|
219
|
-
|
|
1078
|
+
⚠️ **过滤只作用于 `accounts` 与 `credentials` 两个字段**:模型黑名单与永久积分锁定表
|
|
1079
|
+
仍按**全量**写出。这样「只导一个账号」的产物依旧是**一份可整体还原的自包含快照** ——
|
|
1080
|
+
让过滤只承担一种语义,两条路径就不会互相污染。
|
|
220
1081
|
|
|
221
|
-
|
|
1082
|
+
### 导入:两种模式(`replace` / `merge`)
|
|
222
1083
|
|
|
223
|
-
|
|
1084
|
+
| 模式 | 语义 | 用于 |
|
|
1085
|
+
|---|---|---|
|
|
1086
|
+
| `replace`(默认) | **整体替换**账号池与模型黑名单,还原快照 | 「恢复」按钮、换 DSH 版本后整体迁移 |
|
|
1087
|
+
| `merge` | **只追加**:已存在的账号一律跳过,**不碰**模型黑名单与锁定表 | 「单独导入一个账号」、从别人的备份里挑账号 |
|
|
224
1088
|
|
|
225
|
-
|
|
1089
|
+
导入弹窗可勾选要落地哪些账号,并选择模式。
|
|
226
1090
|
|
|
227
|
-
|
|
1091
|
+
⚠️ **`merge` 下裁剪发生在发请求之前**(`plugin-src/client/backup-payload.js`)。
|
|
1092
|
+
判重虽然在后端,但后端只知道「这份载荷里有哪些账号」,不知道用户勾了哪几个;
|
|
1093
|
+
不先裁剪的话,从整份备份里只勾一个账号,其余账号仍会被追加,更糟的是备份里那些
|
|
1094
|
+
**不在勾选范围内**的 `credentialRef` 可能已被本机现有账号占用,写进去等于
|
|
1095
|
+
**覆盖现有账号的凭据**,与「只增加不覆盖」的承诺相反。故裁剪必须同时裁掉
|
|
1096
|
+
`accounts`、`credentials` 与 `disabledModels` 三处。
|
|
228
1097
|
|
|
229
|
-
|
|
1098
|
+
### ⚠️ 合并导入判重的三层口径(缺一层就会堆出重复账号)
|
|
230
1099
|
|
|
231
|
-
|
|
232
|
-
- **没装桌面端**(典型:Linux / NAS / 纯插件用户):插件会在**首次签到 / 查积分**时自动从官方 npm 包 `@qoder-ai/qodercli`(Apache-2.0)提取本机架构的 UMID 生成器,缓存到 `~/.dsh/jet-hub/qoder-umid/` 后生成身份。下载经 npm sha512 完整性校验 + 提取后试运行验收,失败时静默降级(积分查询照常,只是可能看不到可领取活动);
|
|
233
|
-
- 身份值缓存 **50 分钟**后自动重新生成;官方 CLI 上游有新版本时会在后台自动更新组件(24 小时内最多检查一次)。
|
|
1100
|
+
`src/backup.ts` 的 `importBackup({ mode: 'merge' })` 依次判:
|
|
234
1101
|
|
|
235
|
-
|
|
1102
|
+
1. **池里已有的 `id`** —— 账号的唯一键;
|
|
1103
|
+
2. **池里已有的身份**(`provider:` + 凭据里的身份字段,见下表);
|
|
1104
|
+
3. **备份文件内部重复的 `id`** —— 同一份文件手工编辑后可能出现两条同 id。
|
|
236
1105
|
|
|
237
|
-
|
|
1106
|
+
⚠️ **只按 `id` 判重是不够的,第 2 层才是关键**:插件自己登录时 `id` 由 `shortId()`
|
|
1107
|
+
**随机**生成(`buddy-a1b2c3d4`),而从第三方文件转换来的 id 是**确定性哈希**
|
|
1108
|
+
(见下节)。同一个人因此有两套 id,只比 id 会把他重复加进池里 —— 而用户在
|
|
1109
|
+
「从别人的备份里挑账号」时,最常见的情形恰恰是「这个号我已经手登过了」。
|
|
238
1110
|
|
|
239
|
-
|
|
1111
|
+
⚠️ **身份字段逐 provider 对齐**(漏一个字段,那个 provider 的「同一个号我已手登过」
|
|
1112
|
+
场景就**必然**多一条重复账号):
|
|
240
1113
|
|
|
241
|
-
|
|
|
242
|
-
|
|
243
|
-
|
|
|
244
|
-
|
|
|
1114
|
+
| 字段 | 哪些 provider 的凭据里有 |
|
|
1115
|
+
|---|---|
|
|
1116
|
+
| `user_id` | CodeBuddy / WorkBuddy / LobsterAI / Raccoon / ZCode |
|
|
1117
|
+
| `uid` | Qoder(含中国版)/ TRAE |
|
|
1118
|
+
| `userid` | Loomy |
|
|
1119
|
+
| `account_id` | Cline / MiniMax |
|
|
1120
|
+
| `sub` | Gemini(OIDC `sub`;**不取 `email`** —— 它会随改邮箱而变) |
|
|
1121
|
+
| `api_key` | OpenCode(**仅账号槽**) |
|
|
1122
|
+
|
|
1123
|
+
⚠️ **Gemini 只认 `sub`,不认 `email`**:两者都在它的凭据里,但 `sub` 是 OIDC 的
|
|
1124
|
+
**稳定主体标识**(换邮箱、改昵称都不变,上游就拿它当账号 id),而 `email` 会随用户
|
|
1125
|
+
改邮箱而变 —— 拿它判重会让同一个账号在改邮箱后多出一条重复账号。
|
|
1126
|
+
|
|
1127
|
+
⚠️ **OpenCode 的匿名通道要排除**:它的凭据只有 `api_key`,而匿名通道的 `api_key`
|
|
1128
|
+
恒为字面量 `public` —— 全部匿名槽共用一个值。若拿它当身份,用户刻意添加的
|
|
1129
|
+
**第二条匿名通道会被判成「已存在」而拒绝导入**(「多条匿名通道各走各的出口」
|
|
1130
|
+
是上游明确提供的能力)。故匿名槽不产生身份,退回按 `id` 判重。
|
|
1131
|
+
|
|
1132
|
+
⚠️ **轮换令牌(`access_token` / `refresh_token`)不能当身份**:它们每次续期都会变,
|
|
1133
|
+
拿来判重会让续期后的同一账号被判成新账号。
|
|
1134
|
+
|
|
1135
|
+
⚠️ **`id` 与身份都可能判不出来**:凭据缺失/损坏时按「无法判断」跳过该条,
|
|
1136
|
+
不让一次判重失败阻断整体导入。
|
|
1137
|
+
|
|
1138
|
+
### ⚠️ 第三方账号列表可以直接导入(自动转换)
|
|
1139
|
+
|
|
1140
|
+
很多用户手上的是**别的工具**(账号池 / 卡号池脚本、IDE 本地缓存导出)产生的
|
|
1141
|
+
CodeBuddy 账号列表,而不是本插件备份。两者结构完全不同:
|
|
1142
|
+
|
|
1143
|
+
| | 第三方账号列表 | 本插件备份 |
|
|
1144
|
+
|---|---|---|
|
|
1145
|
+
| 顶层 | **裸数组** `[ {...} ]`(或 `{ accounts / data / items / list: [...] }`) | 对象 `{ format, version, ... }` |
|
|
1146
|
+
| 格式标记 | 无 | `format: 'dsh-codearts-auth/backup'` |
|
|
1147
|
+
| 凭据 | 账号对象里**直接带** `access_token` / `refresh_token` | 独立 `credentials` 字典(ref → 凭据 JSON **原文字符串**) |
|
|
1148
|
+
| 账号索引 | `id` 是 uid 或工具自己的编号 | `accounts[]`,`id` 形如 `buddy-a1b2c3d4` |
|
|
1149
|
+
|
|
1150
|
+
直接把它丢给「恢复」只会得到「该备份文件里没有账号」—— 因为取不到 `accounts`。
|
|
1151
|
+
故选中这类文件时会**自动识别并转换**(`plugin-src/client/backup-convert.js`),
|
|
1152
|
+
转换结果显示在弹窗里供核对,并**默认落到 `merge` 模式**(别人的新号,避免误覆盖本机账号)。
|
|
1153
|
+
|
|
1154
|
+
⚠️ **转换只改结构,不改写令牌**:`access_token` / `refresh_token` 原样搬运。
|
|
1155
|
+
其余字段以「本机一个真实可用的 CodeBuddy 凭据」为基准对齐:
|
|
1156
|
+
|
|
1157
|
+
| 字段 | 来源 |
|
|
1158
|
+
|---|---|
|
|
1159
|
+
| `expires_at` | 原值(**毫秒**时间戳),统一成字符串毫秒 |
|
|
1160
|
+
| `refresh_expires_at` | 优先 `auth_raw` 的 `refreshExpiresIn - expiresIn` 差值补算,退回 refresh_token 的 JWT `exp` |
|
|
1161
|
+
| `domain` | **access_token 的 JWT `iss` 主机名**(它会被当作 `X-Domain` 头发出去) |
|
|
1162
|
+
| `user_id` | access_token 的 JWT `sub` |
|
|
1163
|
+
| `token_type` / `account_type` | 原值,缺省 `Bearer` / `personal` |
|
|
1164
|
+
| `enterprise_id` | 缺省 `''`(个人版为空串,与真实凭据一致) |
|
|
1165
|
+
|
|
1166
|
+
⚠️ **provider 按 JWT `iss` 的主机名分派**:含 `workbuddy` → 国际版,否则 → `buddy`。
|
|
1167
|
+
两套 provider 是**不同路由**,认错会让凭据发到错误的端点。
|
|
1168
|
+
|
|
1169
|
+
⚠️ **账号 id 由 uid 经 FNV-1a 哈希确定性生成**(`stableShortId`),与插件自己登录
|
|
1170
|
+
生成的形式一致。这样**同一份文件导入两次,第二次会全部被判为「已存在」而跳过**,
|
|
1171
|
+
而不是堆出两份账号。但 id 判重挡不住「同一个人的账号已用随机 id 登录在本机」——
|
|
1172
|
+
那正是靠上文第 2 层的身份字段判重。
|
|
1173
|
+
|
|
1174
|
+
⚠️ **不写 `scope`**:真实凭据里有它,但插件**从不读取** `scope` 发请求
|
|
1175
|
+
(只在续期时原样带回),而第三方文件里也没有 —— 与其猜一个可能不准的值,不如省略。
|
|
245
1176
|
|
|
246
|
-
|
|
1177
|
+
### ⚠️ 合并导入只写「真正要新增的账号」的凭据
|
|
1178
|
+
|
|
1179
|
+
`merge` 模式下**绝不回写备份里其余凭据**(含各 provider 的默认单凭据 ref)。
|
|
1180
|
+
`replace` 模式才按字典逐条写入 —— 备份文件里可能含账号池之外的独立凭据 ref,
|
|
1181
|
+
导出时一并纳入,导入时同样还原。
|
|
1182
|
+
|
|
1183
|
+
⚠️ 写入顺序是**先凭据、后账号池**:账号池写入成功后门控(`hasLoggedInAccount`)
|
|
1184
|
+
与黑名单立即反映新状态;凭据写入中途失败(非法 ref 等)只跳过该条、不中断整体。
|
|
1185
|
+
|
|
1186
|
+
⚠️ **模式必须取白名单**(`req?.mode === 'merge' ? 'merge' : 'replace'`),
|
|
1187
|
+
不能把请求里的任意字符串透传下去:未知值会被 `?? 'replace'` 静默当成整体替换 ——
|
|
1188
|
+
那时用户以为只是「加一个账号」,实际账号池被清空,属于**不可逆的数据损失**。
|
|
1189
|
+
|
|
1190
|
+
### 测试
|
|
1191
|
+
|
|
1192
|
+
- `tests/unit/backup.spec.ts`(44 条)—— 选择性导出、合并导入三层判重、
|
|
1193
|
+
`merge` 不回写其余凭据、`replace` 兼容旧行为、各 provider 的身份字段覆盖度;
|
|
1194
|
+
- `tests/unit/backup-payload.spec.ts`(13 条)—— 载荷裁剪与账号摘要;
|
|
1195
|
+
- `tests/unit/backup-convert.spec.ts`(28 条)—— 第三方列表识别与转换;
|
|
1196
|
+
- `tests/unit/account-pool.spec.ts` 的 `mergeAccounts` 段(6 条)—— 只追加、
|
|
1197
|
+
不改黑名单与锁定、坏条目归一化、文件内重复 id。
|
|
1198
|
+
|
|
1199
|
+
### ⚠️ 与上游同步(2026-10-02)
|
|
1200
|
+
|
|
1201
|
+
本章功能已随上游 62 个提交(新增 OpenCode provider、本机 OpenAI 网关、用量徽标、
|
|
1202
|
+
自动签到、供应商开关)重新落地:只有 `plugin-src/client/jet-hub.js` 的 import 块
|
|
1203
|
+
需要手工合并,`BackupPanel` 与 `src/backup.ts` 上游未改动。唯一的适配点是
|
|
1204
|
+
**OpenCode 的身份字段**(见上表与匿名槽说明)。细节与反向验证记录见 `AGENTS.md`
|
|
1205
|
+
的「上游同步记录」一节。
|
|
1206
|
+
|
|
1207
|
+
⚠️ 已做**反向验证**(2026-09-30):禁用身份判重 → 1 条变红;让 `merge` 回写全部
|
|
1208
|
+
凭据 → 3 条变红;`mergeAccounts` 去掉文件内去重 → 1 条变红。
|
|
247
1209
|
|
|
248
1210
|
## 开发
|
|
249
1211
|
|
|
250
1212
|
```sh
|
|
251
|
-
pnpm test #
|
|
1213
|
+
pnpm test # 单元测试(快速,无网络,全部 mock)
|
|
252
1214
|
pnpm typecheck # 只做类型检查
|
|
253
1215
|
pnpm build:all # 完整构建(宿主 tsc + 资源拷贝 + 客户端 esbuild)
|
|
254
1216
|
```
|
|
255
1217
|
|
|
256
|
-
|
|
1218
|
+
### 构建
|
|
1219
|
+
|
|
1220
|
+
- `pnpm build` — 用 tsc 将 `src/` 编译到 `lib/`。插件**宿主侧**入口是 `lib/index.js`。
|
|
1221
|
+
- `pnpm build:client` — 用 esbuild 将 `plugin-src/client/` 打包为
|
|
1222
|
+
`lib/client/jet-hub.js`(Jet Hub 设置页的客户端 bundle)。
|
|
1223
|
+
- `pnpm build:all` — 依次执行上述步骤,是完整的构建。
|
|
1224
|
+
- `pnpm typecheck` — 只做类型检查,不产出文件。
|
|
1225
|
+
|
|
1226
|
+
`lib/` 已被 gitignore,因此构建是安装或运行前的必需步骤。
|
|
1227
|
+
|
|
1228
|
+
### E2E 测试
|
|
1229
|
+
|
|
1230
|
+
E2E 探针**按 provider 分列**(如 `pnpm test:e2e:codearts`、`pnpm test:e2e:buddy`、
|
|
1231
|
+
`pnpm test:e2e:loomy`),**均有闸门、默认全部跳过** —— 需要显式设置对应环境变量
|
|
1232
|
+
(部分还需 `..._CONFIRM=yes`)才会真正发出请求。详见 `tests/e2e/README.md`。
|
|
1233
|
+
|
|
1234
|
+
⚠️ 带 `-claim` / `-chat` / `-tools` 后缀的探针会**真实消耗额度或领取机会**;
|
|
1235
|
+
带 `-refresh` 后缀的会**真实轮换一次凭据**(如 `accio-refresh`)。运行前请确认。
|
|
1236
|
+
|
|
1237
|
+
### 项目结构
|
|
1238
|
+
|
|
1239
|
+
| 路径 | 说明 |
|
|
1240
|
+
|---|---|
|
|
1241
|
+
| `src/` | TypeScript 源码(宿主侧) |
|
|
1242
|
+
| `plugin-src/client/` | Jet Hub 客户端源码(esbuild 打包) |
|
|
1243
|
+
| `lib/` | 编译产物(已 gitignore) |
|
|
1244
|
+
| `tests/unit/` | 单元测试 |
|
|
1245
|
+
| `tests/e2e/` | 端到端测试(默认跳过) |
|
|
1246
|
+
| `docs/agent-notes/` | 逐 provider 的事故史与约定(开发向) |
|
|
1247
|
+
| `docs/implementation-notes.md` | **全部实现细节与协议笔记(不入库)**。⚠️ **目前没有 accio 章节** —— accio 的实测笔记在 `docs/agent-notes/providers-accio.md`,补写该章节是独立任务 |
|
|
1248
|
+
| `cordis.patch.yml` | DSH bundle 补丁 |
|