@xixka/dsh-hub 0.4.8 → 0.4.9
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 +239 -283
- 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
|
@@ -0,0 +1,856 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 上游**活动信息**的解析与「此刻该画哪一枚徽标」(GitHub issue #101)。
|
|
3
|
+
*
|
|
4
|
+
* ## 它解决什么
|
|
5
|
+
*
|
|
6
|
+
* 服务商的模型目录**自带**活动字段(限时免费 / 夜间折扣 / 错峰折扣 / 订阅优先)。
|
|
7
|
+
* 本插件此前只把**倍率**抄进模型展示名(形如 GLM-5.2 · x0.79→x0.50),而那个箭头是
|
|
8
|
+
* **取目录那一刻**算出来的字符串 —— 活动一过期,名字里的折扣还在,用户按优惠期
|
|
9
|
+
* 选择模型却被按原价计费。issue #101 要的正是让「活动过期而用户仍按优惠期选择」
|
|
10
|
+
* 这件事可被避免。
|
|
11
|
+
*
|
|
12
|
+
* 本模块补的是**徽标**这条腿:把上游的活动声明读成一份**未决**(不预先挑定)的候选表,
|
|
13
|
+
* 由目录在**被读取的那一刻**按当前时钟挑一枚,画成宿主官方的 LlmModelInfo.badge ——
|
|
14
|
+
* DSH 0.2.2 起模型选择器自己会渲染它(宿主 ModelSelect 的 renderModelLabel 回落分支
|
|
15
|
+
* 就是 Tag{tone: badge.tone} + 名字;宿主 LlmRuntime.listModels 与 buildModelCatalog
|
|
16
|
+
* 都把 badge 逐字透传,实测于本机 app.asar)。
|
|
17
|
+
*
|
|
18
|
+
* ## 移植来源(两条腿各取一家,判据不重写)
|
|
19
|
+
*
|
|
20
|
+
* - dsh-connect-workbuddy(src/promo.ts + docs/PROMO_BADGE.md):腾讯系 /v3/config 的
|
|
21
|
+
* data.modelPromotions / data.modelTiers 形状,以及六条判据 —— running 优先于 standing、
|
|
22
|
+
* dailyUnusable 不许当成全天、validUntil 端点不含、display activeOnly、
|
|
23
|
+
* 同分时活动先于等级标记、无颜色即 neutral。
|
|
24
|
+
* - dsh-connect-qoder(src/promo.ts):Qoder 目录 promotion 的形状,以及两条判据 ——
|
|
25
|
+
* 有窗口时窗口说了算(active 只是无窗口时的回退)、**声明了窗口但读不懂**
|
|
26
|
+
* ⇒ 整条不画,既不当全天也不退回 active。
|
|
27
|
+
*
|
|
28
|
+
* ## ⚠️ 四条不能改的取舍
|
|
29
|
+
*
|
|
30
|
+
* 1. **判定放在读取时刻,不放在解析时刻**。一次目录读取会被宿主缓存很久
|
|
31
|
+
* (本仓后台刷新器 20 分钟一轮)。在解析时把徽标定死,等于「22:59 读到的
|
|
32
|
+
* 夜间折扣,第二天 08:00 还挂在行上」—— 那正是本 issue 要修的形态。
|
|
33
|
+
* ⇒ 解析保留**全部候选**(parseModelsFromConfig 把它们挂在每条模型的 promos 上),
|
|
34
|
+
* 挑选一枚发生在 toCatalogEntry 里。
|
|
35
|
+
* 2. **不替上游说话**。文案一律是上游自己的 badge.label / badge.zh / badge.en,
|
|
36
|
+
* 插件不翻译、不改写、不从 discount_factor 反推措辞。上游没给任何可显示的文案
|
|
37
|
+
* (无 badge)⇒ **整条丢弃**:腾讯的 modelPromotions 数组里混着
|
|
38
|
+
* hy-image-3.5 / kling-video-v3 这类**非促销**条目(只有 tags / videoGeneration),
|
|
39
|
+
* 「无 badge 即丢弃」正是把它们挡在界面外的那道闸。
|
|
40
|
+
* 3. **徽标只是提示,不改任何行为**。本模块不改写请求体、不改价格链路:倍率后缀继续走
|
|
41
|
+
* 既有 parsePromotions + formatCreditsRate 那条已实测的路(src/buddy.ts,含
|
|
42
|
+
* 「x 前后缀两套写法」「factor 0 = 免费」「无窗口 0x 视为占位」等判据,一律不动)。
|
|
43
|
+
* 两条腿读的是**同一份上游文档** ⇒ **零新增请求**(这就是 issue 里
|
|
44
|
+
* 「信息来自你获取模型的端点,不用担心时效性」那句的依据)。
|
|
45
|
+
* 4. **窗口外不画「还没到点」**。参考实现的**卡片**可以画一枚降饱和胶囊并在悬停里写
|
|
46
|
+
* 「几点生效」;宿主徽标契约**只有 text + tone、没有悬停位** ⇒ 窗口外把同一句
|
|
47
|
+
* 「错峰 4 折」画出来就是在说一件没发生的事。所以那一家只画「此刻成立」,
|
|
48
|
+
* 窗口外什么都没有(行上的原价后缀已经把「现在按原价」讲明白)。
|
|
49
|
+
* 这是与参考实现**刻意不同**的一处,不是漏接。见 ModelPromotion.standingEligible。
|
|
50
|
+
*
|
|
51
|
+
* ## ⚠️ 时区兜底必须与**价格腿**同判据
|
|
52
|
+
*
|
|
53
|
+
* 上游没写 timezone 时,本仓价格腿(src/buddy.ts 的 zonedMinutes、
|
|
54
|
+
* src/qoder-adapter.ts 的 promotionActiveNow)都按 **UTC+8** 算。徽标腿若默认 UTC,
|
|
55
|
+
* 同一个窗口就会差 8 小时 —— 那是「一文件两套同义判据」的复发形态。
|
|
56
|
+
* ⇒ 两个入口都**必须**传入与价格腿一致的 fallbackTimeZone,不许各猜一个。
|
|
57
|
+
*
|
|
58
|
+
* ## 与「用量徽标」的区别
|
|
59
|
+
*
|
|
60
|
+
* plugin-src/client/badge-model.js 与 usage-badge.js 是**本插件自己的**用量徽标
|
|
61
|
+
* (挂在 conversation.input.right),与这里的「上游活动徽标」(数据面 = 宿主目录
|
|
62
|
+
* badge 字段、渲染面 = 选择器每一行)不是同一条通路,别混为一谈。
|
|
63
|
+
*
|
|
64
|
+
* @module src/model-promotions
|
|
65
|
+
*/
|
|
66
|
+
/** 记录型值的窄化:非对象(含 null 与数组)返回 undefined。 */
|
|
67
|
+
function asRecord(value) {
|
|
68
|
+
return typeof value === 'object' && value !== null && !Array.isArray(value)
|
|
69
|
+
? value
|
|
70
|
+
: undefined;
|
|
71
|
+
}
|
|
72
|
+
/** 去空白的非空字符串。 */
|
|
73
|
+
function asText(value) {
|
|
74
|
+
return typeof value === 'string' && value.trim() !== '' ? value.trim() : undefined;
|
|
75
|
+
}
|
|
76
|
+
/** 有限数(不要求非负:上游 priority 可以是负权重)。 */
|
|
77
|
+
function asFiniteNumber(value) {
|
|
78
|
+
return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* 'HH:mm' → 当日分钟数;读不懂返回 undefined。
|
|
82
|
+
*
|
|
83
|
+
* 24:00 只作为**终点**接受(「到当天结束」),映射成 1440;作为**起点**拒绝 ——
|
|
84
|
+
* 24:00 开始的「今天」是明天,那是另一句话。
|
|
85
|
+
*
|
|
86
|
+
* ⚠️ **第一行的类型闸门是承重的,不是装饰**(dsh-connect-workbuddy issue #139)。
|
|
87
|
+
* 上游给的是字符串,看起来后面的正则已经挡住了数字 —— 但**落盘缓存**是这个函数的
|
|
88
|
+
* 第二个入口,那条路上没有任何东西做类型检查:{ start: 1380 } 会一路走到这里。
|
|
89
|
+
* 一旦让非字符串碰到 .trim() 就是**渲染期**抛 value.trim is not a function,
|
|
90
|
+
* 而调用点在目录装配里 ⇒ 整条渠道的模型列表消失,症状与「上游挂了」逐字同形。
|
|
91
|
+
*/
|
|
92
|
+
function clockMinute(value, role) {
|
|
93
|
+
if (typeof value !== 'string')
|
|
94
|
+
return undefined;
|
|
95
|
+
const match = /^(\d{1,2}):(\d{2})$/u.exec(value.trim());
|
|
96
|
+
if (match === null)
|
|
97
|
+
return undefined;
|
|
98
|
+
const hour = Number(match[1]);
|
|
99
|
+
const minute = Number(match[2]);
|
|
100
|
+
if (!Number.isInteger(hour) || !Number.isInteger(minute))
|
|
101
|
+
return undefined;
|
|
102
|
+
if (minute > 59 || hour > 24)
|
|
103
|
+
return undefined;
|
|
104
|
+
if (hour === 24)
|
|
105
|
+
return role === 'end' && minute === 0 ? 24 * 60 : undefined;
|
|
106
|
+
return hour * 60 + minute;
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
* ISO 时刻 → epoch 毫秒。**数字刻意拒绝**:秒与毫秒是两种含义
|
|
110
|
+
* (本仓 accio 的 expires_at 就踩过秒/毫秒混淆),猜错方向会把活动判成
|
|
111
|
+
* 「还没开始」或「三年前就结束了」。
|
|
112
|
+
*/
|
|
113
|
+
function instantMs(value) {
|
|
114
|
+
const raw = asText(value);
|
|
115
|
+
if (raw === undefined)
|
|
116
|
+
return undefined;
|
|
117
|
+
const ms = Date.parse(raw);
|
|
118
|
+
return Number.isNaN(ms) ? undefined : ms;
|
|
119
|
+
}
|
|
120
|
+
/** 上游 modelIds → 去重后的 id 列表;空列表返回 undefined(= 非活动条目)。 */
|
|
121
|
+
function parseModelIds(value) {
|
|
122
|
+
if (!Array.isArray(value))
|
|
123
|
+
return undefined;
|
|
124
|
+
const ids = [];
|
|
125
|
+
for (const entry of value) {
|
|
126
|
+
const id = asText(entry);
|
|
127
|
+
if (id !== undefined && !ids.includes(id))
|
|
128
|
+
ids.push(id);
|
|
129
|
+
}
|
|
130
|
+
return ids.length === 0 ? undefined : ids;
|
|
131
|
+
}
|
|
132
|
+
/** 上游 badge → 本模块形状;没有可显示文案 ⇒ undefined(整条丢弃)。 */
|
|
133
|
+
function parseBadge(value) {
|
|
134
|
+
const raw = asRecord(value);
|
|
135
|
+
if (raw === undefined)
|
|
136
|
+
return undefined;
|
|
137
|
+
const label = asText(raw.label) ?? asText(raw.labelEn)
|
|
138
|
+
?? asText(raw.shortLabel) ?? asText(raw.shortLabelEn)
|
|
139
|
+
?? asText(raw.zh) ?? asText(raw.en);
|
|
140
|
+
if (label === undefined)
|
|
141
|
+
return undefined;
|
|
142
|
+
const labelEn = asText(raw.labelEn) ?? asText(raw.en);
|
|
143
|
+
const color = asText(raw.color);
|
|
144
|
+
return {
|
|
145
|
+
label,
|
|
146
|
+
...labelEn === undefined ? {} : { labelEn },
|
|
147
|
+
...color === undefined ? {} : { color },
|
|
148
|
+
...(raw.display === 'activeOnly' ? { display: 'activeOnly' } : {}),
|
|
149
|
+
};
|
|
150
|
+
}
|
|
151
|
+
/** 上游 hover(腾讯)/ description(Qoder)双语字段 → 共用形状。 */
|
|
152
|
+
function parseCopy(value) {
|
|
153
|
+
const raw = asRecord(value);
|
|
154
|
+
if (raw === undefined)
|
|
155
|
+
return undefined;
|
|
156
|
+
const zh = asText(raw.textZh) ?? asText(raw.zh);
|
|
157
|
+
const en = asText(raw.textEn) ?? asText(raw.en);
|
|
158
|
+
if (zh === undefined && en === undefined)
|
|
159
|
+
return undefined;
|
|
160
|
+
return { ...zh === undefined ? {} : { zh }, ...en === undefined ? {} : { en } };
|
|
161
|
+
}
|
|
162
|
+
/**
|
|
163
|
+
* 上游 daily → 可求值的时段集合。
|
|
164
|
+
*
|
|
165
|
+
* 读不懂的时段**丢弃**而不是猜:一份错的窗口会把一个真实活动画成另一个样子。
|
|
166
|
+
* 「下发了但一条都没活下来」由 parseTencentSchedule 标成 dailyUnusable。
|
|
167
|
+
*
|
|
168
|
+
* ⚠️ 本函数**不打日志**:日志留在解析入口(每家每次目录读取一条)。判定路径
|
|
169
|
+
* 每次渲染都跑,在那里打日志会变成刷屏。
|
|
170
|
+
*/
|
|
171
|
+
function parseDailyWindows(value) {
|
|
172
|
+
if (!Array.isArray(value))
|
|
173
|
+
return undefined;
|
|
174
|
+
const windows = [];
|
|
175
|
+
for (const entry of value) {
|
|
176
|
+
const raw = asRecord(entry);
|
|
177
|
+
if (raw === undefined)
|
|
178
|
+
continue;
|
|
179
|
+
const start = asText(raw.start);
|
|
180
|
+
const end = asText(raw.end);
|
|
181
|
+
if (start === undefined || end === undefined)
|
|
182
|
+
continue;
|
|
183
|
+
if (clockMinute(start, 'start') === undefined)
|
|
184
|
+
continue;
|
|
185
|
+
if (clockMinute(end, 'end') === undefined)
|
|
186
|
+
continue;
|
|
187
|
+
windows.push({ start, end });
|
|
188
|
+
}
|
|
189
|
+
return windows.length === 0 ? undefined : windows;
|
|
190
|
+
}
|
|
191
|
+
/**
|
|
192
|
+
* Intl.DateTimeFormat 的两份缓存(按小时读数 / 按日历日读数)。
|
|
193
|
+
*
|
|
194
|
+
* ## 为什么必须有它(实测 2026-11-17,本机 Node)
|
|
195
|
+
*
|
|
196
|
+
* 判定路径**每次 listModels 都按模型跑一遍**,而 new Intl.DateTimeFormat 实测
|
|
197
|
+
* **约 119µs/次** —— 比它要做的实际计算贵两个量级;460 条规模的渠道单趟就是
|
|
198
|
+
* 50ms+。本仓有过一次同形状的事故(cline 目录 O(N²):471 条实测 312ms ⇒ 1.5ms,
|
|
199
|
+
* 见 docs/agent-notes/providers-cline.md),而 listModels 是宿主 buildModelCatalog
|
|
200
|
+
* 反复调的那条路(catalog-prewarm.ts 的头注就记着「首屏加载模型巨长」)。
|
|
201
|
+
* 缓存后同一时区只剩 formatToParts 本身的成本。
|
|
202
|
+
*
|
|
203
|
+
* ⚠️ **上限必须有**:zone 是**上游字符串**,无上限缓存等于让一个乱发的 feed
|
|
204
|
+
* 把我们的内存当它的字典。超出上限就退回「现造一个不入缓存」—— 行为完全不变,
|
|
205
|
+
* 只是不省时间;**绝不**因为缓存满而让判定失败(那会把性能优化变成新的失效方向)。
|
|
206
|
+
*/
|
|
207
|
+
const MAX_ZONE_FORMATTERS = 16;
|
|
208
|
+
const minuteFormatters = new Map();
|
|
209
|
+
const dayFormatters = new Map();
|
|
210
|
+
/** 取(或造)一个 formatter;缓存满时现造一个**不入缓存**。构造失败照旧抛出。 */
|
|
211
|
+
function cachedFormatter(cache, zone, build) {
|
|
212
|
+
const hit = cache.get(zone);
|
|
213
|
+
if (hit !== undefined)
|
|
214
|
+
return hit;
|
|
215
|
+
const formatter = build();
|
|
216
|
+
if (cache.size < MAX_ZONE_FORMATTERS)
|
|
217
|
+
cache.set(zone, formatter);
|
|
218
|
+
return formatter;
|
|
219
|
+
}
|
|
220
|
+
/**
|
|
221
|
+
* 某时刻在指定时区里的当日分钟数;时区读不懂返回 undefined(= 不画)。
|
|
222
|
+
*
|
|
223
|
+
* ⚠️ **绝不静默退回本地时区**:那会让一个跨零点窗口在别的时区错位几小时,比不画
|
|
224
|
+
* 更糟(dsh-connect-qoder/promo.ts 同判据)。zone 为 undefined 时按**调用方传入的**
|
|
225
|
+
* 兜底时区算 —— 兜底值必须与价格腿一致,见模块头那条「时区兜底」警告。
|
|
226
|
+
*/
|
|
227
|
+
function zonedMinute(nowMs, timeZone) {
|
|
228
|
+
const zone = timeZone === undefined || timeZone === '' ? 'UTC' : timeZone;
|
|
229
|
+
try {
|
|
230
|
+
// hourCycle 'h23' 是刻意的:部分引擎在 hour12 false 下把午夜报成 24,
|
|
231
|
+
// 那会让 22:00–08:00 在 00:00 判定失败。
|
|
232
|
+
const parts = cachedFormatter(minuteFormatters, zone, () => new Intl.DateTimeFormat('en-US', {
|
|
233
|
+
timeZone: zone,
|
|
234
|
+
hour: '2-digit',
|
|
235
|
+
minute: '2-digit',
|
|
236
|
+
hourCycle: 'h23',
|
|
237
|
+
})).formatToParts(new Date(nowMs));
|
|
238
|
+
const read = (type) => {
|
|
239
|
+
const item = parts.find((part) => part.type === type)?.value;
|
|
240
|
+
if (item === undefined)
|
|
241
|
+
return undefined;
|
|
242
|
+
const value = Number(item);
|
|
243
|
+
return Number.isFinite(value) ? value : undefined;
|
|
244
|
+
};
|
|
245
|
+
const hour = read('hour');
|
|
246
|
+
const minute = read('minute');
|
|
247
|
+
if (hour === undefined || minute === undefined)
|
|
248
|
+
return undefined;
|
|
249
|
+
return (hour % 24) * 60 + minute;
|
|
250
|
+
}
|
|
251
|
+
catch {
|
|
252
|
+
return undefined;
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
/** nowMinutes 是否落在时段集合里的某一段。 */
|
|
256
|
+
function withinDailyWindows(windows, nowMinutes) {
|
|
257
|
+
return windows.some((window) => {
|
|
258
|
+
const start = clockMinute(window.start, 'start');
|
|
259
|
+
const end = clockMinute(window.end, 'end');
|
|
260
|
+
if (start === undefined || end === undefined)
|
|
261
|
+
return false;
|
|
262
|
+
// ⚠️ 同钟点 = **空区间**(半开区间 `[x, x)` 没有成员),**不是**「全天」。
|
|
263
|
+
// 原先这里写 `return true`(注释还声称「同一时刻即覆盖整日」),而价格腿
|
|
264
|
+
// `src/qoder-adapter.ts` 的 `promotionActiveNow` 对同一输入给
|
|
265
|
+
// `minutes >= start && minutes < end` ⇒ 恒 false ⇒ **两条腿反向**:
|
|
266
|
+
// 上游发「零长度窗口」时徽标全天挂「限时免费」而价格按原价,
|
|
267
|
+
// 正是 issue #101 要修的形态。
|
|
268
|
+
// 真正的「全天」有专门表示:`daily` 缺省 / 空数组(见 `promotionWithinDailyWindow`),
|
|
269
|
+
// 或 `00:00–24:00`。零长度窗口是**上游数据异常**,按本仓纪律
|
|
270
|
+
// 「读不懂的时段不能替上游背书」取**不成立**(与价格腿一致)。
|
|
271
|
+
if (start === end)
|
|
272
|
+
return false;
|
|
273
|
+
if (end > start)
|
|
274
|
+
return nowMinutes >= start && nowMinutes < end;
|
|
275
|
+
return nowMinutes >= start || nowMinutes < end;
|
|
276
|
+
});
|
|
277
|
+
}
|
|
278
|
+
/**
|
|
279
|
+
* 活动的**绝对有效期**在 nowMs 是否成立。
|
|
280
|
+
*
|
|
281
|
+
* 它单独就是一道闸:一条已经结束的活动不该继续自我宣传,无论它的每日时段怎么说。
|
|
282
|
+
* 常驻徽标同样受它约束(见 promotionStandingAt)—— 这是「活动过期而徽标还在」
|
|
283
|
+
* 最直接的成因,也是 issue #101 点名的形态。
|
|
284
|
+
*/
|
|
285
|
+
export function promotionWithinAbsoluteWindow(promotion, nowMs = Date.now()) {
|
|
286
|
+
const schedule = promotion.schedule;
|
|
287
|
+
if (schedule === undefined)
|
|
288
|
+
return true;
|
|
289
|
+
// ⚠️ **界值存在却不是有限数 ⇒ 判「不在窗口内」**(不画),而不是让它穿过闸门。
|
|
290
|
+
// 这不是假想:`nowMs < '2026-11-16T00:00:00+08:00'` 两边都是 NaN 比较 ⇒ 恒 false,
|
|
291
|
+
// 于是「已经过期」会读成「没过期」—— 一个结束的活动继续自我宣传,正是
|
|
292
|
+
// issue #101 点名的事故形态;而本函数的**全部**意义就是挡住它。
|
|
293
|
+
// 生产路径上 parseTencentSchedule 只会写 number,所以这是给第二个入口
|
|
294
|
+
// (持久化往返 / 别的调用方直接构造)准备的闸门,与 clockMinute 第一行同规。
|
|
295
|
+
if (schedule.validFrom !== undefined) {
|
|
296
|
+
if (typeof schedule.validFrom !== 'number' || !Number.isFinite(schedule.validFrom))
|
|
297
|
+
return false;
|
|
298
|
+
if (nowMs < schedule.validFrom)
|
|
299
|
+
return false;
|
|
300
|
+
}
|
|
301
|
+
if (schedule.validUntil !== undefined) {
|
|
302
|
+
if (typeof schedule.validUntil !== 'number' || !Number.isFinite(schedule.validUntil))
|
|
303
|
+
return false;
|
|
304
|
+
if (nowMs >= schedule.validUntil)
|
|
305
|
+
return false;
|
|
306
|
+
}
|
|
307
|
+
return true;
|
|
308
|
+
}
|
|
309
|
+
/** 活动的**每日时段**(含上游声明的时区)在 nowMs 是否成立。 */
|
|
310
|
+
export function promotionWithinDailyWindow(promotion, nowMs = Date.now()) {
|
|
311
|
+
const schedule = promotion.schedule;
|
|
312
|
+
if (schedule === undefined)
|
|
313
|
+
return true;
|
|
314
|
+
// 说了有时段却读不懂 ⇒ 永不成立(不许退化成「全天」)。
|
|
315
|
+
if (schedule.dailyUnusable === true)
|
|
316
|
+
return false;
|
|
317
|
+
if (schedule.daily === undefined || schedule.daily.length === 0)
|
|
318
|
+
return true;
|
|
319
|
+
const minutes = zonedMinute(nowMs, schedule.timezone);
|
|
320
|
+
if (minutes === undefined)
|
|
321
|
+
return false;
|
|
322
|
+
return withinDailyWindows(schedule.daily, minutes);
|
|
323
|
+
}
|
|
324
|
+
/** 绝对有效期 ∧ 每日时段。**不**含「上游是否声明了时间」这道闸。 */
|
|
325
|
+
export function promotionActiveAt(promotion, nowMs = Date.now()) {
|
|
326
|
+
return promotionWithinAbsoluteWindow(promotion, nowMs)
|
|
327
|
+
&& promotionWithinDailyWindow(promotion, nowMs);
|
|
328
|
+
}
|
|
329
|
+
/**
|
|
330
|
+
* 这条活动在 nowMs **正在跑**吗(可画实心徽标)。三条分支缺一不可:
|
|
331
|
+
*
|
|
332
|
+
* 1. 上游**声明了**时间(窗口或有效期)⇒ 按 nowMs 现算,**不看** snapshotActive。
|
|
333
|
+
* 目录是缓存的快照,active 会过期;而窗口是「此刻」的纯函数,快照多旧都不会说错话。
|
|
334
|
+
* 若把 active 也当成门,白天启动的进程会拿着 16:00 的 active false 一直到退出 ——
|
|
335
|
+
* 22:00 窗口开了也不画,这个功能对「一直开着 DSH」的用户等于不存在。
|
|
336
|
+
* 2. 上游没声明时间、只给了 active 快照(Qoder 的 { active: true } 无窗口形态)
|
|
337
|
+
* ⇒ 只能信快照:那是上游对「常驻活动此刻开不开」的唯一表态。
|
|
338
|
+
* 3. 上游既没声明时间也没有快照(腾讯 modelTiers)⇒ **不算在跑**,它只可能「常驻」。
|
|
339
|
+
* 否则一个高优先级的等级标记会压掉一个真的在跑的低价活动
|
|
340
|
+
* (参考实现里的 hasSchedule 就是为此存在)。
|
|
341
|
+
*/
|
|
342
|
+
export function promotionRunningAt(promotion, nowMs = Date.now()) {
|
|
343
|
+
if (promotion.timeDeclared)
|
|
344
|
+
return promotionActiveAt(promotion, nowMs);
|
|
345
|
+
return promotion.schedule?.snapshotActive === true;
|
|
346
|
+
}
|
|
347
|
+
/**
|
|
348
|
+
* 此刻不在窗口内时,这条活动能否画成**常驻**徽标。
|
|
349
|
+
*
|
|
350
|
+
* - badge.display 是 activeOnly ⇒ 不可以:那是「只在活动期内出现」的徽标;
|
|
351
|
+
* - standingEligible false ⇒ 不可以:取舍 4(Qoder 没有悬停位可说「还没到点」);
|
|
352
|
+
* - dailyUnusable ⇒ 不可以:读不懂的时段不能替上游背书;
|
|
353
|
+
* - 其余 ⇒ 只受**绝对有效期**约束:一条过期活动的常驻徽标同样不许挂。
|
|
354
|
+
*/
|
|
355
|
+
export function promotionStandingAt(promotion, nowMs = Date.now()) {
|
|
356
|
+
if (promotion.badge.display === 'activeOnly')
|
|
357
|
+
return false;
|
|
358
|
+
if (!promotion.standingEligible)
|
|
359
|
+
return false;
|
|
360
|
+
if (promotion.schedule?.dailyUnusable === true)
|
|
361
|
+
return false;
|
|
362
|
+
return promotionWithinAbsoluteWindow(promotion, nowMs);
|
|
363
|
+
}
|
|
364
|
+
/**
|
|
365
|
+
* priority 降序;同分时**活动先于等级标记**。
|
|
366
|
+
*
|
|
367
|
+
* 上游把两者都标成 200(实测 2026-10-21),而一句「Free now / 限时免费」比一句
|
|
368
|
+
* 「Pro Only / 订阅优先」对用户更有行动价值。同分不能靠数组顺序碰运气 ——
|
|
369
|
+
* 比较器显式覆盖它,调用方因此不必依赖 Array#sort 的稳定性。
|
|
370
|
+
*/
|
|
371
|
+
export function sortPromotions(promotions) {
|
|
372
|
+
return [...promotions].sort((a, b) => b.priority - a.priority
|
|
373
|
+
|| (a.source === b.source ? 0 : a.source === 'promotion' ? -1 : 1));
|
|
374
|
+
}
|
|
375
|
+
/**
|
|
376
|
+
* 此刻该画的那一条活动,或 undefined(不画)。
|
|
377
|
+
*
|
|
378
|
+
* 两步顺序就是全部要点:
|
|
379
|
+
* 1. **正在跑的**赢(promotionRunningAt);
|
|
380
|
+
* 2. 否则取**常驻**徽标(promotionStandingAt)。
|
|
381
|
+
*
|
|
382
|
+
* 每个模型**只画一枚**:选择器一行只有一条宽度,两枚会把模型名挤出去。
|
|
383
|
+
*
|
|
384
|
+
* ⚠️ 调用方**不得**在解析时刻调它并把结果存进缓存 —— 那等于把「此刻」冻进目录,
|
|
385
|
+
* 正是本模块存在的理由要修的事(取舍 1)。
|
|
386
|
+
*/
|
|
387
|
+
export function selectPromotionAt(promotions, nowMs = Date.now()) {
|
|
388
|
+
if (promotions === undefined || promotions.length === 0)
|
|
389
|
+
return undefined;
|
|
390
|
+
const sorted = sortPromotions(promotions);
|
|
391
|
+
const running = sorted.find((promotion) => promotionRunningAt(promotion, nowMs));
|
|
392
|
+
if (running !== undefined)
|
|
393
|
+
return running;
|
|
394
|
+
return sorted.find((promotion) => promotionStandingAt(promotion, nowMs));
|
|
395
|
+
}
|
|
396
|
+
/**
|
|
397
|
+
* 只接受 hex(#RGB / #RRGGBB)。
|
|
398
|
+
*
|
|
399
|
+
* ⚠️ 值最终会进样式,而上游只发 hex。其它写法一律拒绝,由展示侧回落语义色。
|
|
400
|
+
* **不要**在这里放行 rgb() 或 CSS 变量 —— 那不是上游会发的东西,放行等于把
|
|
401
|
+
* 未校验字符串送进样式属性。
|
|
402
|
+
*/
|
|
403
|
+
export function promotionBadgeColor(promotion) {
|
|
404
|
+
const color = promotion.badge.color;
|
|
405
|
+
if (color === undefined)
|
|
406
|
+
return undefined;
|
|
407
|
+
return /^#(?:[0-9a-f]{3}|[0-9a-f]{6})$/iu.test(color) ? color : undefined;
|
|
408
|
+
}
|
|
409
|
+
/**
|
|
410
|
+
* 上游 hex 颜色 → 宿主语义档。
|
|
411
|
+
*
|
|
412
|
+
* ## 为什么映射而不是原样送颜色
|
|
413
|
+
*
|
|
414
|
+
* 宿主的 badge 只认 tone(四档),由主题 token 上色,从而在每个主题下都保证可读;
|
|
415
|
+
* 任意 hex 做不到这件事。所以就近映射:绿色(CN 每个「免费/折扣」活动用的都是它)
|
|
416
|
+
* → success;蓝 → info;暖色(琥珀/红)→ warning;**其余 neutral,不替上游发明含义**。
|
|
417
|
+
*
|
|
418
|
+
* 上游没给颜色(Qoder promotion、腾讯 modelTiers)同样落 neutral —— 实测如此,不是兜底。
|
|
419
|
+
*/
|
|
420
|
+
export function promotionTone(promotion) {
|
|
421
|
+
const color = promotionBadgeColor(promotion);
|
|
422
|
+
if (color === undefined)
|
|
423
|
+
return 'neutral';
|
|
424
|
+
const raw = color.slice(1);
|
|
425
|
+
// ⚠️ `promotionBadgeColor` 的契约是「`#RGB` 或 `#RRGGBB` 都放行」,而这里
|
|
426
|
+
// 原先写 `if (hex.length !== 6) return 'neutral'` ⇒ **3 位 hex 永远落 neutral**
|
|
427
|
+
// (上游的绿 `#0f0` 被画成灰,与上面「绿色 → success」的规则自相矛盾)。
|
|
428
|
+
// 把 3 位按 CSS 语义展开成 6 位(`#abc` ≡ `#aabbcc`)再算。
|
|
429
|
+
const hex = raw.length === 3
|
|
430
|
+
? raw[0] + raw[0] + raw[1] + raw[1] + raw[2] + raw[2]
|
|
431
|
+
: raw;
|
|
432
|
+
if (!/^[0-9a-f]{6}$/iu.test(hex))
|
|
433
|
+
return 'neutral';
|
|
434
|
+
const r = Number.parseInt(hex.slice(0, 2), 16);
|
|
435
|
+
const g = Number.parseInt(hex.slice(2, 4), 16);
|
|
436
|
+
const b = Number.parseInt(hex.slice(4, 6), 16);
|
|
437
|
+
if (!Number.isFinite(r) || !Number.isFinite(g) || !Number.isFinite(b))
|
|
438
|
+
return 'neutral';
|
|
439
|
+
// 绿色明显最强时是「免费/折扣」绿,不能被读成警告。
|
|
440
|
+
if (g > r + 24 && g > b + 24)
|
|
441
|
+
return 'success';
|
|
442
|
+
// 蓝色是「成员专属 / 等级」类标记,不是价格事件。
|
|
443
|
+
if (b > r + 24 && b > g + 8)
|
|
444
|
+
return 'info';
|
|
445
|
+
// 暖色(琥珀/红)意思是「选之前先看看这句」。
|
|
446
|
+
if (r > b + 24)
|
|
447
|
+
return 'warning';
|
|
448
|
+
return 'neutral';
|
|
449
|
+
}
|
|
450
|
+
/**
|
|
451
|
+
* 候选表 → 宿主 badge 值(此刻该画的那一枚),不成立时 undefined。
|
|
452
|
+
*
|
|
453
|
+
* ## 为什么出「表」形态
|
|
454
|
+
*
|
|
455
|
+
* 宿主按**读者**的语言解析 badge.text,而本函数跑在宿主进程里,看不到浏览器语言。
|
|
456
|
+
* 给一张表让宿主自己挑;给一个裸字符串就是把一种语言强加给所有用户。
|
|
457
|
+
*
|
|
458
|
+
* ## 什么时候塌成裸字符串
|
|
459
|
+
*
|
|
460
|
+
* CN 大多数活动**只发中文**,于是 en 就是那句中文,两端相同 ⇒ 塌成字符串。
|
|
461
|
+
* 这是刻意的:**编造英文文案比给英文读者看上游自己的中文更糟**(取舍 2)。
|
|
462
|
+
*/
|
|
463
|
+
export function promotionBadgeFor(promotions, nowMs = Date.now()) {
|
|
464
|
+
const selected = selectPromotionAt(promotions, nowMs);
|
|
465
|
+
if (selected === undefined)
|
|
466
|
+
return undefined;
|
|
467
|
+
const en = selected.badge.labelEn ?? selected.badge.label;
|
|
468
|
+
return {
|
|
469
|
+
text: selected.badge.label === en ? en : { en, zh: selected.badge.label },
|
|
470
|
+
tone: promotionTone(selected),
|
|
471
|
+
};
|
|
472
|
+
}
|
|
473
|
+
/** 日志**不该**让解析失败:宿主 logger 可能没绑定或自己抛。 */
|
|
474
|
+
function safeWarn(warn, message) {
|
|
475
|
+
if (warn === undefined)
|
|
476
|
+
return;
|
|
477
|
+
try {
|
|
478
|
+
warn(message);
|
|
479
|
+
}
|
|
480
|
+
catch { /* 丢弃 */ }
|
|
481
|
+
}
|
|
482
|
+
/** 上游是否在这条 schedule 里**说了**它有时间。 */
|
|
483
|
+
function tencentScheduleDeclaredTime(schedule) {
|
|
484
|
+
if (schedule === undefined)
|
|
485
|
+
return false;
|
|
486
|
+
return schedule.dailyUnusable === true
|
|
487
|
+
|| (schedule.daily !== undefined && schedule.daily.length > 0)
|
|
488
|
+
|| schedule.validFrom !== undefined
|
|
489
|
+
|| schedule.validUntil !== undefined;
|
|
490
|
+
}
|
|
491
|
+
/**
|
|
492
|
+
* 腾讯 schedule → 本模块形状。
|
|
493
|
+
*
|
|
494
|
+
* @returns undefined = 上游这一项里**什么时间声明都没有**(不等于解析失败:
|
|
495
|
+
* 那种情形由 dailyUnusable 表达)。
|
|
496
|
+
*/
|
|
497
|
+
function parseTencentSchedule(value, id, warn) {
|
|
498
|
+
const raw = asRecord(value);
|
|
499
|
+
if (raw === undefined)
|
|
500
|
+
return undefined;
|
|
501
|
+
const timezone = asText(raw.timezone);
|
|
502
|
+
const validFrom = instantMs(raw.validFrom);
|
|
503
|
+
const validUntil = instantMs(raw.validUntil);
|
|
504
|
+
const daily = parseDailyWindows(raw.daily);
|
|
505
|
+
// ⚠️⚠️ **「声明过」按「键存在」判定,不按类型判定**(PR #104 正向审计 P1-1)。
|
|
506
|
+
//
|
|
507
|
+
// 原判据是 `daily === undefined && Array.isArray(raw.daily) && length > 0` ——
|
|
508
|
+
// 只认「数组但全读不懂」这一种。于是上游**类型漂移**时会静默 fail-open:
|
|
509
|
+
//
|
|
510
|
+
// - `daily: '23:00-07:50'`(字符串而非数组)⇒ `Array.isArray` 为假 ⇒
|
|
511
|
+
// `dailyUnusable` 为假、`daily` 为 undefined ⇒ 整条 schedule 只剩
|
|
512
|
+
// `{ timezone }` ⇒ `timeDeclared: false` ⇒ **徽标天天挂**;
|
|
513
|
+
// - `validUntil: 1794931200`(epoch 数字)/ `{}` / `'soon'` ⇒ `instantMs`
|
|
514
|
+
// 返回 undefined ⇒ **绝对窗口被静默丢弃** ⇒ 到 2030 年还在挂 badge。
|
|
515
|
+
//
|
|
516
|
+
// 两者都是 issue #101 的原始症状(「活动过期而用户仍按优惠期选择」),
|
|
517
|
+
// 也正是本模块自述最该防的方向(「dailyUnusable 是唯一会夸大上游声明的方向」)。
|
|
518
|
+
// ⇒ 统一收敛到 **fail-closed**:只要**声明过**任何时间字段却读不懂,
|
|
519
|
+
// 就标 `dailyUnusable`(= 永不成立),并留一条日志。
|
|
520
|
+
// ⚠️ `daily: []`(空数组)在既有契约里是「**没声明**时段」= 全天活动,
|
|
521
|
+
// 不能算「声明了却读不懂」(否则会把一条全天活动判死)。只有**非空**声明
|
|
522
|
+
// 才算声明过。
|
|
523
|
+
const declaredDaily = raw.daily !== undefined
|
|
524
|
+
&& !(Array.isArray(raw.daily) && raw.daily.length === 0);
|
|
525
|
+
const declaredFrom = raw.validFrom !== undefined;
|
|
526
|
+
const declaredUntil = raw.validUntil !== undefined;
|
|
527
|
+
const dailyUnusable = (declaredDaily && daily === undefined)
|
|
528
|
+
|| (declaredFrom && validFrom === undefined)
|
|
529
|
+
|| (declaredUntil && validUntil === undefined);
|
|
530
|
+
if (dailyUnusable) {
|
|
531
|
+
// 日志留在**宿主侧、解析路径**上:每次上游文档只跑一遍,而判定路径每次渲染都跑。
|
|
532
|
+
// 缺了这条,徽标只是消失、全仓零日志(dsh-connect-workbuddy issue #139 的症状)。
|
|
533
|
+
safeWarn(warn, 'promotion "' + id + '": declared time is unreadable '
|
|
534
|
+
+ '(daily: ' + (declaredDaily ? 'present' : 'absent')
|
|
535
|
+
+ ', validFrom: ' + (declaredFrom ? 'present' : 'absent')
|
|
536
|
+
+ ', validUntil: ' + (declaredUntil ? 'present' : 'absent')
|
|
537
|
+
+ '), badge stays hidden — the upstream may have changed the time format');
|
|
538
|
+
}
|
|
539
|
+
if (timezone === undefined && validFrom === undefined && validUntil === undefined
|
|
540
|
+
&& daily === undefined && !dailyUnusable)
|
|
541
|
+
return undefined;
|
|
542
|
+
return {
|
|
543
|
+
...timezone === undefined ? {} : { timezone },
|
|
544
|
+
...validFrom === undefined ? {} : { validFrom },
|
|
545
|
+
...validUntil === undefined ? {} : { validUntil },
|
|
546
|
+
...daily === undefined ? {} : { daily },
|
|
547
|
+
...dailyUnusable ? { dailyUnusable: true } : {},
|
|
548
|
+
};
|
|
549
|
+
}
|
|
550
|
+
/**
|
|
551
|
+
* 腾讯系 /v3/config:data.modelPromotions + data.modelTiers → 候选表。
|
|
552
|
+
*
|
|
553
|
+
* 真实形态(docs/PROMO_BADGE.md 留档;2026-10-21 实测 CN 站 8 条促销 + 1 条等级标记),
|
|
554
|
+
* 一条促销条目原文(截断):
|
|
555
|
+
*
|
|
556
|
+
* { "id": "hy3-free-trial-202608", "kind": "discount", "enabled": true,
|
|
557
|
+
* "priority": 200, "modelIds": ["hy3"],
|
|
558
|
+
* "badge": { "label": "限时免费", "color": "#009273", "display": "activeOnly" },
|
|
559
|
+
* "discount": { "discountedCredits": "0x", "displayMode": "replace", "factor": 0 },
|
|
560
|
+
* "hover": { "textZh": "7月6日–10月31日,每日赠送免费额度。" },
|
|
561
|
+
* "schedule": { "timezone": "Asia/Shanghai",
|
|
562
|
+
* "validFrom": "2026-07-06T00:00:00+08:00",
|
|
563
|
+
* "validUntil": "2026-11-01T00:00:00+08:00",
|
|
564
|
+
* "daily": [{ "start": "23:00", "end": "7:50" }] } }
|
|
565
|
+
*
|
|
566
|
+
* modelTiers 同形但**没有** schedule / badge.color,多一个 requiredUserType。
|
|
567
|
+
*
|
|
568
|
+
* 三条丢弃判据(都在解析层做完,下游可假定每条都画得出来):
|
|
569
|
+
* - enabled === false(**缺省即启用**:上游只在关掉时才写这个字段);
|
|
570
|
+
* - 无 modelIds —— 数组里混着图片/视频模型的**非促销**条目;
|
|
571
|
+
* - 无 badge 文案 —— 没有可显示的话,插件不该自己编。
|
|
572
|
+
*
|
|
573
|
+
* ⚠️ **折扣价不在这里算**(取舍 3):腾讯的促销价继续走 src/buddy.ts 的 parsePromotions。
|
|
574
|
+
* 同一份文档读两套判据,**请求仍只有一次**。
|
|
575
|
+
*
|
|
576
|
+
* ⚠️ fallbackTimeZone 必须与价格腿一致(见模块头):腾讯价格腿用 Asia/Shanghai。
|
|
577
|
+
*
|
|
578
|
+
* @param rawPromotions - 上游 data.modelPromotions。
|
|
579
|
+
* @param rawTiers - 上游 data.modelTiers。
|
|
580
|
+
* @param fallbackTimeZone - 上游未写 timezone 时用的时区(与价格腿同值)。
|
|
581
|
+
* @param warn - 可选日志出口(时段读不懂时点名到条目)。
|
|
582
|
+
*/
|
|
583
|
+
export function parseTencentPromotions(rawPromotions, rawTiers, fallbackTimeZone = 'Asia/Shanghai', warn) {
|
|
584
|
+
const promotions = [];
|
|
585
|
+
for (const entry of Array.isArray(rawPromotions) ? rawPromotions : []) {
|
|
586
|
+
const promotion = parseTencentEntry(entry, 'promotion', fallbackTimeZone, warn);
|
|
587
|
+
if (promotion !== undefined)
|
|
588
|
+
promotions.push(promotion);
|
|
589
|
+
}
|
|
590
|
+
for (const entry of Array.isArray(rawTiers) ? rawTiers : []) {
|
|
591
|
+
const promotion = parseTencentEntry(entry, 'tier', fallbackTimeZone, warn);
|
|
592
|
+
if (promotion !== undefined)
|
|
593
|
+
promotions.push(promotion);
|
|
594
|
+
}
|
|
595
|
+
return promotions;
|
|
596
|
+
}
|
|
597
|
+
/** 上游一条 modelPromotions / modelTiers 条目 → 候选;不是活动则 undefined。 */
|
|
598
|
+
function parseTencentEntry(value, source, fallbackTimeZone, warn) {
|
|
599
|
+
const raw = asRecord(value);
|
|
600
|
+
if (raw === undefined)
|
|
601
|
+
return undefined;
|
|
602
|
+
if (raw.enabled === false)
|
|
603
|
+
return undefined;
|
|
604
|
+
const modelIds = parseModelIds(raw.modelIds);
|
|
605
|
+
if (modelIds === undefined)
|
|
606
|
+
return undefined;
|
|
607
|
+
const badge = parseBadge(raw.badge);
|
|
608
|
+
if (badge === undefined)
|
|
609
|
+
return undefined;
|
|
610
|
+
// id 先算出来,好让「读不懂的时段」能在日志里点名到条目
|
|
611
|
+
// (parseTencentSchedule 自己读不到 id,它在上一层)。
|
|
612
|
+
const id = asText(raw.id) ?? source + ':' + modelIds.join(',');
|
|
613
|
+
const schedule = parseTencentSchedule(raw.schedule, id, warn);
|
|
614
|
+
if (schedule !== undefined && schedule.timezone === undefined) {
|
|
615
|
+
schedule.timezone = fallbackTimeZone;
|
|
616
|
+
}
|
|
617
|
+
const hover = parseCopy(raw.hover);
|
|
618
|
+
const priority = asFiniteNumber(raw.priority);
|
|
619
|
+
return {
|
|
620
|
+
id,
|
|
621
|
+
source,
|
|
622
|
+
modelIds,
|
|
623
|
+
badge,
|
|
624
|
+
...hover === undefined ? {} : { hover },
|
|
625
|
+
...schedule === undefined ? {} : { schedule },
|
|
626
|
+
timeDeclared: tencentScheduleDeclaredTime(schedule),
|
|
627
|
+
standingEligible: true,
|
|
628
|
+
priority: priority ?? 0,
|
|
629
|
+
};
|
|
630
|
+
}
|
|
631
|
+
/**
|
|
632
|
+
* 本仓 Qoder 目录条目的 promotion(错峰折扣)→ **一条**候选(只挂它自己那一行)。
|
|
633
|
+
*
|
|
634
|
+
* ⚠️ 输入是 src/qoder-product.ts 的**已解析**形状(camelCase),不是上游的 snake_case:
|
|
635
|
+
* 本仓 qoder-catalog.ts 已把远端条目归一成与编译期兜底表同形的结构,远端与兜底表
|
|
636
|
+
* 因此**走完全同一条展示链路**。若在这里再写一份 snake_case 解析,就是同一个 schema
|
|
637
|
+
* 的两套判据 —— 本仓的反复出缺陷形态。
|
|
638
|
+
*
|
|
639
|
+
* 三个必须处理的形态,与参考实现 dsh-connect-qoder/promo.ts 逐条同口径:
|
|
640
|
+
* 1. **窗口读得懂** ⇒ timeDeclared true + daily,窗口说了算(active 完全不参与);
|
|
641
|
+
* 2. **窗口声明了但读不懂**(24:30、只给一端、非 HH:mm)⇒ dailyUnusable ⇒ 既不当全天
|
|
642
|
+
* 也不退回 active(running 与 standing 两道闸都拒);
|
|
643
|
+
* 3. **完全没给窗口** ⇒ timeDeclared false + snapshotActive,由 promotionRunningAt
|
|
644
|
+
* 第 2 支读快照。
|
|
645
|
+
*
|
|
646
|
+
* ⚠️ badge.zh 与 badge.en 都没有 ⇒ 返回 undefined:没有可显示的话就不该画(取舍 2)。
|
|
647
|
+
* 此时**折扣价照旧**由 qoderDisplayName 的箭头承载,两条腿互不依赖。
|
|
648
|
+
*
|
|
649
|
+
* ⚠️ fallbackTimeZone 必须与价格腿一致:qoder-adapter.ts 的 promotionActiveNow 按
|
|
650
|
+
* UTC+8 硬算(目录时区与用户一致),故这里传 Asia/Shanghai。
|
|
651
|
+
*/
|
|
652
|
+
export function qoderPromotionCandidate(promotion, modelId, fallbackTimeZone = 'Asia/Shanghai', warn) {
|
|
653
|
+
if (promotion === undefined)
|
|
654
|
+
return undefined;
|
|
655
|
+
if (typeof modelId !== 'string' || modelId.length === 0)
|
|
656
|
+
return undefined;
|
|
657
|
+
const label = promotion.badgeZh ?? promotion.badgeEn;
|
|
658
|
+
if (label === undefined)
|
|
659
|
+
return undefined;
|
|
660
|
+
const labelEn = promotion.badgeEn;
|
|
661
|
+
const windowStart = promotion.windowStart;
|
|
662
|
+
const windowEnd = promotion.windowEnd;
|
|
663
|
+
// 「声明」与「读得懂」是两件事,必须分开算(见 dailyUnusable 的说明)。
|
|
664
|
+
const declaredWindow = windowStart !== undefined || windowEnd !== undefined;
|
|
665
|
+
const usableWindow = windowStart !== undefined && windowEnd !== undefined
|
|
666
|
+
&& clockMinute(windowStart, 'start') !== undefined
|
|
667
|
+
&& clockMinute(windowEnd, 'end') !== undefined;
|
|
668
|
+
if (declaredWindow && !usableWindow) {
|
|
669
|
+
safeWarn(warn, 'qoder promotion on "' + modelId + '": window is unreadable (start: '
|
|
670
|
+
+ (windowStart ?? 'absent') + ', end: ' + (windowEnd ?? 'absent')
|
|
671
|
+
+ '), badge stays hidden');
|
|
672
|
+
}
|
|
673
|
+
const schedule = {
|
|
674
|
+
// ⚠️⚠️ **刻意忽略 `promotion.timezone`,一律用 `fallbackTimeZone`**(两个调用点
|
|
675
|
+
// 都传 `'Asia/Shanghai'`,= UTC+8 且无夏令时 = 价格腿的硬编码 +8)。
|
|
676
|
+
// 原因:qoder 价格腿 `promotionActiveNow`(`src/qoder-adapter.ts`)**根本不读**
|
|
677
|
+
// `promotion.timezone`,它用 `now.getTime() + 8h` 手算 UTC+8。若徽标腿听
|
|
678
|
+
// `promotion.timezone`,上游一旦下发 `Asia/Tokyo` 这类非 UTC+8 的合法时区,
|
|
679
|
+
// 两条腿就会**方向相反**(PR #104 正向审计 P2-3,实测 `Asia/Tokyo` +
|
|
680
|
+
// 窗口 `22:30–07:50` + `23:10Z` ⇒ price=true / badge=false)。
|
|
681
|
+
// 本仓纪律:新腿对齐老腿,不改老腿的既有行为(改价格腿要连 `nowImpl` 与时区
|
|
682
|
+
// 语义一起审,属独立 PR)。文档 §5「时区兜底必须与价格腿同值」由此真的成立。
|
|
683
|
+
timezone: fallbackTimeZone,
|
|
684
|
+
...usableWindow ? { daily: [{ start: windowStart, end: windowEnd }] } : {},
|
|
685
|
+
...(declaredWindow && !usableWindow ? { dailyUnusable: true } : {}),
|
|
686
|
+
...promotion.active === true ? { snapshotActive: true } : {},
|
|
687
|
+
};
|
|
688
|
+
return {
|
|
689
|
+
id: promotion.ruleId ?? 'promotion:' + modelId,
|
|
690
|
+
source: 'promotion',
|
|
691
|
+
modelIds: [modelId],
|
|
692
|
+
badge: { label, ...labelEn === undefined ? {} : { labelEn } },
|
|
693
|
+
timeDeclared: declaredWindow,
|
|
694
|
+
// 取舍 4:宿主徽标没有悬停位,窗口外不画「还没到点」。
|
|
695
|
+
standingEligible: false,
|
|
696
|
+
priority: 100,
|
|
697
|
+
schedule,
|
|
698
|
+
};
|
|
699
|
+
}
|
|
700
|
+
// ── 保鲜:下一个会改变徽标的时刻 ────────────────────────────────────────────────
|
|
701
|
+
/** 边界查找的默认上界(一年):超出即认为「没有排定的边界」,不排定时器。 */
|
|
702
|
+
const PROMOTION_EDGE_HORIZON_MS = 365 * 24 * 3_600_000;
|
|
703
|
+
/**
|
|
704
|
+
* 候选表里**下一个**会改变徽标的时刻(epoch 毫秒);找不到返回 undefined。
|
|
705
|
+
*
|
|
706
|
+
* ## 为什么需要它
|
|
707
|
+
*
|
|
708
|
+
* 徽标是「此刻」的函数,而宿主缓存的是**一次目录读取**的结果(本仓后台刷新器
|
|
709
|
+
* 20 分钟一轮)。于是 23:00 开的窗口要靠用户恰好在那一分钟打开菜单才会出现,
|
|
710
|
+
* 而 7:50 关的窗口会在那之后最长 20 分钟里继续挂着 —— 后者正是 issue #101
|
|
711
|
+
* 点名的「活动过期而用户仍按优惠期选择」。
|
|
712
|
+
*
|
|
713
|
+
* ⇒ 边界到了必须**主动播报**一次目录变更,让客户端重读。本函数是它的排程依据。
|
|
714
|
+
*
|
|
715
|
+
* ⚠️ **播报不等于重打上游**:重读走 loadCatalog,而 ensureRemoteModels 的
|
|
716
|
+
* 20 分钟新鲜度判据会短路 ⇒ 边界时刻只是**用新时钟重算一遍候选表**,
|
|
717
|
+
* 零网络请求。这条是「徽标自己会消失」能常驻开启的前提。
|
|
718
|
+
*
|
|
719
|
+
* 会改变徽标的时刻有四类:validFrom、validUntil,以及每条 daily 的两端
|
|
720
|
+
* (后者按**每日重复**取「下一次」)。
|
|
721
|
+
*
|
|
722
|
+
* ⚠️ 全部按上游声明的时区算,而不是本地时区:23:00 说的是 Asia/Shanghai 的
|
|
723
|
+
* 23:00,用户人在 UTC+0 时也一样。
|
|
724
|
+
*
|
|
725
|
+
* @param promotions - 全部候选(**不要**先筛过:读不懂的条目本来就没有边界)。
|
|
726
|
+
* @param nowMs - 起算时刻。
|
|
727
|
+
* @returns 严格大于 nowMs 的最近边界;一年内没有则 undefined。
|
|
728
|
+
*/
|
|
729
|
+
export function nextPromotionEdgeMs(promotions, nowMs = Date.now()) {
|
|
730
|
+
let best;
|
|
731
|
+
const consider = (candidate) => {
|
|
732
|
+
if (candidate === undefined || candidate <= nowMs)
|
|
733
|
+
return;
|
|
734
|
+
if (candidate - nowMs > PROMOTION_EDGE_HORIZON_MS)
|
|
735
|
+
return;
|
|
736
|
+
if (best === undefined || candidate < best)
|
|
737
|
+
best = candidate;
|
|
738
|
+
};
|
|
739
|
+
for (const promotion of promotions) {
|
|
740
|
+
const schedule = promotion.schedule;
|
|
741
|
+
if (schedule === undefined)
|
|
742
|
+
continue;
|
|
743
|
+
consider(schedule.validFrom);
|
|
744
|
+
consider(schedule.validUntil);
|
|
745
|
+
if (schedule.daily === undefined)
|
|
746
|
+
continue;
|
|
747
|
+
for (const window of schedule.daily) {
|
|
748
|
+
consider(nextClockInstantMs(window.start, schedule.timezone, nowMs));
|
|
749
|
+
consider(nextClockInstantMs(window.end, schedule.timezone, nowMs));
|
|
750
|
+
}
|
|
751
|
+
}
|
|
752
|
+
return best;
|
|
753
|
+
}
|
|
754
|
+
/**
|
|
755
|
+
* HH:mm 在指定时区的**下一次**出现时刻。
|
|
756
|
+
*
|
|
757
|
+
* 实现把「下一次」拆成「今天 / 明天 / 后天 / 大后天」四个候选日历日(按**该时区**
|
|
758
|
+
* 的日历日取),逐个求出该时区墙上钟点 hh:mm 对应的 epoch 时刻,
|
|
759
|
+
* 取第一个严格大于 nowMs 的。四天足够覆盖夏令时切换的极端;
|
|
760
|
+
* 读不懂(时间或时区)返回 undefined —— 与判定路径同一个方向:
|
|
761
|
+
* **不知道就不排**,绝不排一个猜出来的时刻。
|
|
762
|
+
*/
|
|
763
|
+
function nextClockInstantMs(hhmm, timeZone, nowMs) {
|
|
764
|
+
const minute = clockMinute(hhmm, 'end');
|
|
765
|
+
if (minute === undefined)
|
|
766
|
+
return undefined;
|
|
767
|
+
for (let dayShift = 0; dayShift <= 3; dayShift += 1) {
|
|
768
|
+
const reference = nowMs + dayShift * 24 * 3_600_000;
|
|
769
|
+
const day = zoneCalendarDay(reference, timeZone ?? 'UTC');
|
|
770
|
+
if (day === undefined)
|
|
771
|
+
return undefined;
|
|
772
|
+
// 24:00 = 「当天结束」= 次日 00:00:把日历日往前挪一天再落 0 分。
|
|
773
|
+
const target = minute === 1440
|
|
774
|
+
? { day: { year: day.year, month: day.month, day: day.day }, minute: 0, nextDay: true }
|
|
775
|
+
: { day, minute, nextDay: false };
|
|
776
|
+
const instant = zonedLocalInstantMs(target.day.year, target.day.month, target.day.day, target.nextDay ? 0 : target.minute, timeZone ?? 'UTC', target.nextDay);
|
|
777
|
+
if (instant !== undefined && instant > nowMs)
|
|
778
|
+
return instant;
|
|
779
|
+
}
|
|
780
|
+
return undefined;
|
|
781
|
+
}
|
|
782
|
+
/** 该时区把 ms 读成哪个日历日(读不懂返回 undefined)。 */
|
|
783
|
+
function zoneCalendarDay(ms, timeZone) {
|
|
784
|
+
try {
|
|
785
|
+
const parts = cachedFormatter(dayFormatters, timeZone, () => new Intl.DateTimeFormat('en-CA', {
|
|
786
|
+
timeZone,
|
|
787
|
+
year: 'numeric',
|
|
788
|
+
month: '2-digit',
|
|
789
|
+
day: '2-digit',
|
|
790
|
+
})).formatToParts(new Date(ms));
|
|
791
|
+
const read = (type) => {
|
|
792
|
+
const value = parts.find((part) => part.type === type)?.value;
|
|
793
|
+
if (value === undefined)
|
|
794
|
+
return undefined;
|
|
795
|
+
const parsed = Number(value);
|
|
796
|
+
return Number.isFinite(parsed) ? parsed : undefined;
|
|
797
|
+
};
|
|
798
|
+
const year = read('year');
|
|
799
|
+
const month = read('month');
|
|
800
|
+
const day = read('day');
|
|
801
|
+
if (year === undefined || month === undefined || day === undefined)
|
|
802
|
+
return undefined;
|
|
803
|
+
return { year, month, day };
|
|
804
|
+
}
|
|
805
|
+
catch {
|
|
806
|
+
return undefined;
|
|
807
|
+
}
|
|
808
|
+
}
|
|
809
|
+
/**
|
|
810
|
+
* 求「timeZone 的日历日 year-month-day(nextDay 时为**次日**)的墙上第 minuteOfDay
|
|
811
|
+
* 分钟」对应的 epoch 时刻;求不出 ⇒ undefined(**不排**,与判定路径同方向)。
|
|
812
|
+
*
|
|
813
|
+
* 做法:先按「当地墙上时间 == UTC 字面量」造一个候选,再用该时区在候选处的墙上
|
|
814
|
+
* 读数把它往目标拉回,迭代三次收敛。最后**校验**候选确实被该时区读成目标日 +
|
|
815
|
+
* 目标分钟 —— 不成立就返回 undefined。这一步不是防御性装饰:夏令时「春天跳过、
|
|
816
|
+
* 秋天重复」的那一类本地时刻**根本不存在/不唯一**(部分时区恰好在午夜切换,
|
|
817
|
+
* 24:00 与 0:00 会撞在同一天),收敛不到目标读数时宁可**没有边界**,也绝不
|
|
818
|
+
* 排一个说错话的时刻。
|
|
819
|
+
*/
|
|
820
|
+
function zonedLocalInstantMs(year, month, day, minuteOfDay, timeZone, nextDay) {
|
|
821
|
+
// nextDay:先做**日历**加一天(UTC 空间的纯日历运算,与时区无关),
|
|
822
|
+
// 再按那个新日历日求墙上时刻。
|
|
823
|
+
let targetYear = year;
|
|
824
|
+
let targetMonth = month;
|
|
825
|
+
let targetDay = day;
|
|
826
|
+
if (nextDay) {
|
|
827
|
+
const shifted = new Date(Date.UTC(year, month - 1, day) + 24 * 3_600_000);
|
|
828
|
+
targetYear = shifted.getUTCFullYear();
|
|
829
|
+
targetMonth = shifted.getUTCMonth() + 1;
|
|
830
|
+
targetDay = shifted.getUTCDate();
|
|
831
|
+
}
|
|
832
|
+
const targetDayStartUtc = Date.UTC(targetYear, targetMonth - 1, targetDay);
|
|
833
|
+
let candidate = targetDayStartUtc + minuteOfDay * 60_000;
|
|
834
|
+
for (let i = 0; i < 3; i += 1) {
|
|
835
|
+
const actualMinute = zonedMinute(candidate, timeZone);
|
|
836
|
+
const actualDay = zoneCalendarDay(candidate, timeZone);
|
|
837
|
+
if (actualMinute === undefined || actualDay === undefined)
|
|
838
|
+
return undefined;
|
|
839
|
+
const readDayStartUtc = Date.UTC(actualDay.year, actualDay.month - 1, actualDay.day);
|
|
840
|
+
// 「墙上读数 − 目标」换算成需要回拉的分钟数(含跨日的整数天差)。
|
|
841
|
+
const dayDiffMinutes = (targetDayStartUtc - readDayStartUtc) / 60_000;
|
|
842
|
+
const delta = minuteOfDay - actualMinute + dayDiffMinutes;
|
|
843
|
+
if (delta === 0)
|
|
844
|
+
break;
|
|
845
|
+
candidate += delta * 60_000;
|
|
846
|
+
}
|
|
847
|
+
const finalMinute = zonedMinute(candidate, timeZone);
|
|
848
|
+
const finalDay = zoneCalendarDay(candidate, timeZone);
|
|
849
|
+
if (finalMinute === undefined || finalDay === undefined)
|
|
850
|
+
return undefined;
|
|
851
|
+
const dayMatches = finalDay.year === targetYear
|
|
852
|
+
&& finalDay.month === targetMonth
|
|
853
|
+
&& finalDay.day === targetDay;
|
|
854
|
+
return dayMatches && finalMinute === minuteOfDay ? candidate : undefined;
|
|
855
|
+
}
|
|
856
|
+
//# sourceMappingURL=model-promotions.js.map
|