@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
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 「同步到外部工具」的**磁盘层**:备份 → 写入 → 复读校验 → 失败回滚。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么备份和回滚必须在这里,而不是交给调用方
|
|
5
|
+
*
|
|
6
|
+
* 目标文件是**别人的应用配置**(pi 的 models.json、ZCode 的 provider_config.json)。
|
|
7
|
+
* 写坏它们等于砸掉用户另外两个工具的模型列表。所以:
|
|
8
|
+
* - 写之前先把原字节存成备份(回滚的唯一依据);
|
|
9
|
+
* - 写完立刻复读校验,失败就用原字节整体还原;
|
|
10
|
+
* - 回滚发生时**备份仍保留**,用户可人工比对。
|
|
11
|
+
*
|
|
12
|
+
* ## 与 ZCode 侧 skill 的一致性
|
|
13
|
+
*
|
|
14
|
+
* 备份目录沿用 `backups/before-*-<时间戳>/` 的既有约定与 `indent 2 + 末尾换行` 的
|
|
15
|
+
* 书写格式,使两处产出的文件字节风格一致。
|
|
16
|
+
*
|
|
17
|
+
* @module src/sync-apply.ts
|
|
18
|
+
*/
|
|
19
|
+
import { randomBytes } from 'node:crypto';
|
|
20
|
+
import { copyFileSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
|
|
21
|
+
import { homedir } from 'node:os';
|
|
22
|
+
import { basename, dirname, join } from 'node:path';
|
|
23
|
+
/** 磁盘层失败(读不到、写不了、格式不认识)。 */
|
|
24
|
+
export class SyncApplyError extends Error {
|
|
25
|
+
constructor(message) {
|
|
26
|
+
super(message);
|
|
27
|
+
this.name = 'SyncApplyError';
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
/** 展开用户家目录前缀(env 里允许写 `~/...`,Node 不认)。 */
|
|
31
|
+
function expandHome(path, home) {
|
|
32
|
+
if (path === '~')
|
|
33
|
+
return home;
|
|
34
|
+
if (path.startsWith('~/') || path.startsWith('~\\'))
|
|
35
|
+
return join(home, path.slice(2));
|
|
36
|
+
return path;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* 解析两个目标文件的路径。
|
|
40
|
+
*
|
|
41
|
+
* ## 为什么必须读环境变量,而不是只按 `homedir()` 拼
|
|
42
|
+
*
|
|
43
|
+
* 两个目标都有**官方支持**的目录覆盖点,写死默认路径会在用户设了它们之后
|
|
44
|
+
* 悄悄写错文件(表现是「同步成功但目标里什么都没变」):
|
|
45
|
+
*
|
|
46
|
+
* | 目标 | 覆盖变量 | 默认 |
|
|
47
|
+
* |---|---|---|
|
|
48
|
+
* | pi | `PI_CODING_AGENT_DIR`(pi 官方文档 environment-variables 明列) | `~/.pi/agent` |
|
|
49
|
+
* | ZCode | `ZCODE_PERSONAL_PROVIDER_CONFIG_FILE`(官方 CLI 启动脚本自己就在设) | `~/.zcode/v2/provider_config.json` |
|
|
50
|
+
*
|
|
51
|
+
* `homedir()` 是**运行时**取的,所以换机器、换用户名都能用;这里只补上
|
|
52
|
+
* 「同一个用户在别处覆盖过」这条路径。
|
|
53
|
+
*
|
|
54
|
+
* @param home 家目录(单测注入)
|
|
55
|
+
* @param env 环境变量来源(默认 `process.env`)
|
|
56
|
+
*/
|
|
57
|
+
export function resolveSyncPaths(home = homedir(), env = process.env) {
|
|
58
|
+
const piDirRaw = env.PI_CODING_AGENT_DIR?.trim();
|
|
59
|
+
const piDir = piDirRaw ? expandHome(piDirRaw, home) : join(home, '.pi', 'agent');
|
|
60
|
+
const zcodeRaw = env.ZCODE_PERSONAL_PROVIDER_CONFIG_FILE?.trim();
|
|
61
|
+
const zcodeProviderConfig = zcodeRaw
|
|
62
|
+
? expandHome(zcodeRaw, home)
|
|
63
|
+
: join(home, '.zcode', 'v2', 'provider_config.json');
|
|
64
|
+
return { piModels: join(piDir, 'models.json'), zcodeProviderConfig };
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* 读取目标 JSON 配置。
|
|
68
|
+
*
|
|
69
|
+
* 用 `utf-8` 解码后手工剥掉 BOM:Windows 上被记事本/VS Code 保存过的文件常带 BOM,
|
|
70
|
+
* `JSON.parse` 遇到它会直接抛「Unexpected token」。
|
|
71
|
+
*/
|
|
72
|
+
export function readJsonConfig(path) {
|
|
73
|
+
if (!existsSync(path)) {
|
|
74
|
+
throw new SyncApplyError(`找不到配置文件:${path}`);
|
|
75
|
+
}
|
|
76
|
+
let text;
|
|
77
|
+
try {
|
|
78
|
+
text = readFileSync(path, 'utf-8');
|
|
79
|
+
}
|
|
80
|
+
catch (error) {
|
|
81
|
+
throw new SyncApplyError(`读不了配置文件:${path}(${error.message})`);
|
|
82
|
+
}
|
|
83
|
+
const cleaned = text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
|
|
84
|
+
try {
|
|
85
|
+
return JSON.parse(cleaned);
|
|
86
|
+
}
|
|
87
|
+
catch (error) {
|
|
88
|
+
throw new SyncApplyError(`配置文件不是合法 JSON:${path}(${error.message})`);
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* 备份目录用的时间戳:秒级 + 毫秒 + 2 字节随机后缀。
|
|
93
|
+
*
|
|
94
|
+
* ⚠️ 只到毫秒不够:同一毫秒的两次同步(连点两次 / 脚本并发)会拿到同一个目录名,
|
|
95
|
+
* 而 `mkdirSync({recursive:true})` 不报错、`copyFileSync` 直接覆盖上一份备份
|
|
96
|
+
* ⇒ 用户以为有两个还原点,实际只有一个。
|
|
97
|
+
*/
|
|
98
|
+
function stamp() {
|
|
99
|
+
const now = new Date();
|
|
100
|
+
const pad = (value, width = 2) => String(value).padStart(width, '0');
|
|
101
|
+
return [
|
|
102
|
+
now.getFullYear(),
|
|
103
|
+
pad(now.getMonth() + 1),
|
|
104
|
+
pad(now.getDate()),
|
|
105
|
+
'-',
|
|
106
|
+
pad(now.getHours()),
|
|
107
|
+
pad(now.getMinutes()),
|
|
108
|
+
pad(now.getSeconds()),
|
|
109
|
+
'-',
|
|
110
|
+
pad(now.getMilliseconds(), 3),
|
|
111
|
+
].join('') + '-' + randomBytes(2).toString('hex');
|
|
112
|
+
}
|
|
113
|
+
/** 从原文件的原始字节里读出书写风格。 */
|
|
114
|
+
export function detectJsonFileStyle(original) {
|
|
115
|
+
const bom = original.length >= 3 && original[0] === 0xef && original[1] === 0xbb && original[2] === 0xbf;
|
|
116
|
+
return { bom, eol: original.includes(0x0d) ? '\r\n' : '\n' };
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
* 按给定风格把 `config` 编码回字节。
|
|
120
|
+
*
|
|
121
|
+
* `JSON.stringify` 产出的换行符只可能是 `\n`(字符串值里的换行会被转义成字面量
|
|
122
|
+
* `\n`),所以整体替换是安全的。
|
|
123
|
+
*/
|
|
124
|
+
export function encodeJsonConfig(config, style) {
|
|
125
|
+
const body = JSON.stringify(config, null, 2) + '\n';
|
|
126
|
+
const withEol = style.eol === '\r\n' ? body.replace(/\n/g, '\r\n') : body;
|
|
127
|
+
return Buffer.from((style.bom ? '\ufeff' : '') + withEol, 'utf-8');
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* 把 `config` 写入 `path`,并保证可回滚。
|
|
131
|
+
*
|
|
132
|
+
* @param validate 写入后的复读校验;抛错即触发回滚。缺省只验证「能解析回对象」。
|
|
133
|
+
* @returns `backupDir`:本次备份目录(UI 要把它显示给用户);
|
|
134
|
+
* `original`:写入前的原始字节(跨目标事务回滚用)
|
|
135
|
+
*/
|
|
136
|
+
export async function applyJsonPlan(path, config, validate) {
|
|
137
|
+
if (!existsSync(path)) {
|
|
138
|
+
throw new SyncApplyError(`目标文件不存在,拒绝创建:${path}`);
|
|
139
|
+
}
|
|
140
|
+
const original = readFileSync(path);
|
|
141
|
+
// 1) 先备份成独立目录:目录名不重样,历史备份不会被覆盖
|
|
142
|
+
let backupDir = '';
|
|
143
|
+
let backupFile = '';
|
|
144
|
+
try {
|
|
145
|
+
backupDir = join(dirname(path), 'backups', `before-jethub-sync-${stamp()}`);
|
|
146
|
+
mkdirSync(backupDir, { recursive: true });
|
|
147
|
+
backupFile = join(backupDir, basename(path));
|
|
148
|
+
copyFileSync(path, backupFile);
|
|
149
|
+
}
|
|
150
|
+
catch (error) {
|
|
151
|
+
// fail-closed:没有备份就不写,否则「写坏了也没法还原」
|
|
152
|
+
throw new SyncApplyError(`备份失败,已放弃同步(目标文件未改动):${path}(${error.message})`);
|
|
153
|
+
}
|
|
154
|
+
// 2) 写入:先写同目录临时文件再 rename —— 原子替换。
|
|
155
|
+
// ⚠️ 旧实现直接 `writeFileSync(path, …)` 且在 try 外:实测磁盘满时
|
|
156
|
+
// 71 字节的目标文件被截成 0 字节,而「回滚」根本没机会执行。
|
|
157
|
+
//
|
|
158
|
+
// ⚠️ 编码必须**沿用原文件的 BOM 与换行符**(见 `JsonFileStyle`):
|
|
159
|
+
// 整文件重写时用 `JSON.stringify(...) + '\n'` 会静默吞掉 BOM、把 CRLF 抹成 LF。
|
|
160
|
+
const encoded = encodeJsonConfig(config, detectJsonFileStyle(original));
|
|
161
|
+
const tempFile = join(dirname(path), `.${basename(path)}.${randomBytes(4).toString('hex')}.tmp`);
|
|
162
|
+
let replaced = false;
|
|
163
|
+
try {
|
|
164
|
+
writeFileSync(tempFile, encoded);
|
|
165
|
+
renameSync(tempFile, path);
|
|
166
|
+
replaced = true;
|
|
167
|
+
// 3) 复读校验:失败一律整体回滚到原字节
|
|
168
|
+
readJsonConfig(path);
|
|
169
|
+
if (validate)
|
|
170
|
+
await validate(path);
|
|
171
|
+
}
|
|
172
|
+
catch (error) {
|
|
173
|
+
// 走到这里有两种可能:
|
|
174
|
+
// ① 还没 rename(临时文件写失败)⇒ 目标文件原封不动,不需要回滚;
|
|
175
|
+
// ② 已经 rename(校验失败)⇒ 必须用原字节还原。
|
|
176
|
+
if (replaced) {
|
|
177
|
+
try {
|
|
178
|
+
writeFileSync(path, original);
|
|
179
|
+
}
|
|
180
|
+
catch (rollbackError) {
|
|
181
|
+
// ⚠️ 回滚失败**绝不能吞掉原始错误**(旧实现会在 catch 里再写一次,
|
|
182
|
+
// 回滚失败时抛的是回滚的错误,用户看到的原因完全错位)。
|
|
183
|
+
throw new SyncApplyError(`${error.message}\n`
|
|
184
|
+
+ `⚠️ 自动回滚也失败(${rollbackError.message}),目标文件可能处于不一致状态:`
|
|
185
|
+
+ `${path}(备份:${backupFile})`);
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
throw error;
|
|
189
|
+
}
|
|
190
|
+
finally {
|
|
191
|
+
// 临时文件没被 rename 走就清掉,不在别人的配置目录里留垃圾
|
|
192
|
+
try {
|
|
193
|
+
rmSync(tempFile, { force: true });
|
|
194
|
+
}
|
|
195
|
+
catch {
|
|
196
|
+
// 清理失败不影响主流程
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
return { backupDir, backupFile, original };
|
|
200
|
+
}
|
|
201
|
+
//# sourceMappingURL=sync-apply.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sync-apply.js","sourceRoot":"","sources":["../src/sync-apply.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 「同步模型到外部工具」的 RPC 方法处理函数(**不是自注册端点**)。
|
|
3
|
+
*
|
|
4
|
+
* ## ⚠️ 为什么是被主 switch 调用,而不是自己 `rpc.register`
|
|
5
|
+
*
|
|
6
|
+
* 与 `opencode-rpc.ts` 完全同因(见那里的模块头与 2026-10-02 真实事故):
|
|
7
|
+
* Jet Hub 只有一条 RPC 通道,`jet-hub-rpc.ts` 的 `handleMethod` 用穷举 `switch`
|
|
8
|
+
* 分发,`default` 直接回 `unknown method` 且**不让路**。自己注册的路径从来收不到请求。
|
|
9
|
+
*
|
|
10
|
+
* ⇒ 本文件只导出 {@link handleSyncRpc},由 `handleMethod` 在 `switch` **之前**按
|
|
11
|
+
* `sync.` 前缀调用;对不认识的方法返回 `undefined` 让主 switch 继续匹配。
|
|
12
|
+
*
|
|
13
|
+
* ## 返回约定
|
|
14
|
+
*
|
|
15
|
+
* 与 `opencode-rpc.ts` 一致:成功 `{ ok: true, value }`,失败 `{ ok: false, error }`。
|
|
16
|
+
* 失败**一律不抛**:同步涉及"写别人的配置文件",把异常留给上层会丢掉具体原因
|
|
17
|
+
* (哪个目标、为什么),而用户需要的正是这句话。
|
|
18
|
+
*
|
|
19
|
+
* @module src/sync-rpc.ts
|
|
20
|
+
*/
|
|
21
|
+
import type { Context } from '@deepseek-ai/cordis';
|
|
22
|
+
import { type SyncOptions } from './sync-service.js';
|
|
23
|
+
/**
|
|
24
|
+
* 可注入的同步选项。
|
|
25
|
+
*
|
|
26
|
+
* 生产调用(`jet-hub-rpc.ts` 的前缀改道)**不传**,走 `resolveSyncPaths()` 的默认路径;
|
|
27
|
+
* 单测传 `{ home }` 把两个目标指到临时目录 —— 否则用例会读写用户真实的
|
|
28
|
+
* `~/.pi` 与 `~/.zcode`。这层注入是刻意的:隐藏的全局 home 依赖会让
|
|
29
|
+
* 「测试通过但删了用户配置」这种事变得可能。
|
|
30
|
+
*/
|
|
31
|
+
export type SyncRpcOptions = SyncOptions;
|
|
32
|
+
/**
|
|
33
|
+
* 处理 `sync.*` 方法。
|
|
34
|
+
*
|
|
35
|
+
* @returns 处理结果;**方法不属于本前缀时返回 `undefined`**(交给主 switch)
|
|
36
|
+
*/
|
|
37
|
+
export declare function handleSyncRpc(ctx: Context, method: string, payload: unknown, options?: SyncRpcOptions): Promise<unknown>;
|
|
38
|
+
//# sourceMappingURL=sync-rpc.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sync-rpc.d.ts","sourceRoot":"","sources":["../src/sync-rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAgD,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AA6DlG;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,CAAA;AAkBxC;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAoClB"}
|
package/lib/sync-rpc.js
ADDED
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 「同步模型到外部工具」的 RPC 方法处理函数(**不是自注册端点**)。
|
|
3
|
+
*
|
|
4
|
+
* ## ⚠️ 为什么是被主 switch 调用,而不是自己 `rpc.register`
|
|
5
|
+
*
|
|
6
|
+
* 与 `opencode-rpc.ts` 完全同因(见那里的模块头与 2026-10-02 真实事故):
|
|
7
|
+
* Jet Hub 只有一条 RPC 通道,`jet-hub-rpc.ts` 的 `handleMethod` 用穷举 `switch`
|
|
8
|
+
* 分发,`default` 直接回 `unknown method` 且**不让路**。自己注册的路径从来收不到请求。
|
|
9
|
+
*
|
|
10
|
+
* ⇒ 本文件只导出 {@link handleSyncRpc},由 `handleMethod` 在 `switch` **之前**按
|
|
11
|
+
* `sync.` 前缀调用;对不认识的方法返回 `undefined` 让主 switch 继续匹配。
|
|
12
|
+
*
|
|
13
|
+
* ## 返回约定
|
|
14
|
+
*
|
|
15
|
+
* 与 `opencode-rpc.ts` 一致:成功 `{ ok: true, value }`,失败 `{ ok: false, error }`。
|
|
16
|
+
* 失败**一律不抛**:同步涉及"写别人的配置文件",把异常留给上层会丢掉具体原因
|
|
17
|
+
* (哪个目标、为什么),而用户需要的正是这句话。
|
|
18
|
+
*
|
|
19
|
+
* @module src/sync-rpc.ts
|
|
20
|
+
*/
|
|
21
|
+
import { applySync, previewSync } from './sync-service.js';
|
|
22
|
+
/**
|
|
23
|
+
* 从 payload 里读渠道白名单。
|
|
24
|
+
*
|
|
25
|
+
* 三态语义(**缺省与空数组不同**,见 `SyncOptions.providers`):
|
|
26
|
+
* - 字段不存在 → `undefined`(全部渠道)
|
|
27
|
+
* - `[]` → 一个都没选(计划层会拒绝,避免清空目标)
|
|
28
|
+
* - 非字符串数组 → 报错,不猜
|
|
29
|
+
*/
|
|
30
|
+
function readProviders(payload) {
|
|
31
|
+
if (payload === null || typeof payload !== 'object')
|
|
32
|
+
return { ok: true };
|
|
33
|
+
const raw = payload.providers;
|
|
34
|
+
if (raw === undefined)
|
|
35
|
+
return { ok: true };
|
|
36
|
+
if (!Array.isArray(raw) || raw.some(item => typeof item !== 'string')) {
|
|
37
|
+
return { ok: false, message: 'providers 必须是字符串数组' };
|
|
38
|
+
}
|
|
39
|
+
return { ok: true, value: raw };
|
|
40
|
+
}
|
|
41
|
+
/** 合法的目标 agent 取值。新增目标时必须同步这里。 */
|
|
42
|
+
const SYNC_TARGET_IDS = ['pi', 'zcode'];
|
|
43
|
+
/**
|
|
44
|
+
* 从 payload 里读目标 agent 白名单。
|
|
45
|
+
*
|
|
46
|
+
* 三态语义与 {@link readProviders} 一致:字段不存在 = 全部;`[]` = 一个都没选
|
|
47
|
+
*(计划层会拒绝);非字符串数组或含未知目标名 ⇒ 报错而不猜。
|
|
48
|
+
*
|
|
49
|
+
* ⚠️ 未知目标名必须报错:默写拼错时静默当成「全部」会把用户不想动的 agent 写掉。
|
|
50
|
+
*/
|
|
51
|
+
function readTargets(payload) {
|
|
52
|
+
if (payload === null || typeof payload !== 'object')
|
|
53
|
+
return { ok: true };
|
|
54
|
+
const raw = payload.targets;
|
|
55
|
+
if (raw === undefined)
|
|
56
|
+
return { ok: true };
|
|
57
|
+
if (!Array.isArray(raw) || raw.some(item => typeof item !== 'string')) {
|
|
58
|
+
return { ok: false, message: 'targets 必须是字符串数组' };
|
|
59
|
+
}
|
|
60
|
+
const unknown = raw.filter(item => !SYNC_TARGET_IDS.includes(item));
|
|
61
|
+
if (unknown.length > 0) {
|
|
62
|
+
return { ok: false, message: `不认识的 target:${unknown.join('、')}(可选:${SYNC_TARGET_IDS.join('、')})` };
|
|
63
|
+
}
|
|
64
|
+
return { ok: true, value: raw };
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* 从 payload 里读「强制重新采集目录」标志。
|
|
68
|
+
*
|
|
69
|
+
* ⚠️ **只有 `sync.preview` 认它**(UI 的「刷新」按钮)。`sync.apply` 必须命中
|
|
70
|
+
* 同一份 30 秒缓存,否则「预览看到的目录」与「落盘用的目录」不是同一个快照
|
|
71
|
+
* ⇒ `failedProviders` 一变,保护集就漂移(旧缺陷:预览说保留、落盘却删除)。
|
|
72
|
+
*
|
|
73
|
+
* 非 `true` 一律当 `false`:这是「要不要多打一次上游」的开关,
|
|
74
|
+
* 拼错的取值静默当成「不刷新」比当成「刷新」安全。
|
|
75
|
+
*/
|
|
76
|
+
function readForce(payload) {
|
|
77
|
+
if (payload === null || typeof payload !== 'object')
|
|
78
|
+
return false;
|
|
79
|
+
return payload.force === true;
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* 取 `ctx.llm`。
|
|
83
|
+
*
|
|
84
|
+
* ⚠️ 与 `jet-hub-rpc.ts` 的 `llmServiceOf` 同口径:**优先属性访问**,`ctx.get` 只作回退。
|
|
85
|
+
* 在 connection 上下文里后者可能拿不到 `listProviders`,表现为「目录恒为空」
|
|
86
|
+
* (正是网关面板踩过的坑)。
|
|
87
|
+
*/
|
|
88
|
+
function llmOf(ctx) {
|
|
89
|
+
const direct = ctx.llm;
|
|
90
|
+
if (direct !== undefined && direct !== null)
|
|
91
|
+
return direct;
|
|
92
|
+
// `ctx.get` 不一定存在(精简 ctx、connection 上下文的某些形态)⇒ 先判函数再调
|
|
93
|
+
const getter = ctx.get;
|
|
94
|
+
if (typeof getter !== 'function')
|
|
95
|
+
return undefined;
|
|
96
|
+
return getter.call(ctx, 'llm');
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
99
|
+
* 处理 `sync.*` 方法。
|
|
100
|
+
*
|
|
101
|
+
* @returns 处理结果;**方法不属于本前缀时返回 `undefined`**(交给主 switch)
|
|
102
|
+
*/
|
|
103
|
+
export async function handleSyncRpc(ctx, method, payload, options = {}) {
|
|
104
|
+
const fail = (message, code = 'bad-request') => ({ ok: false, error: { code, message } });
|
|
105
|
+
const done = (value) => ({ ok: true, value });
|
|
106
|
+
try {
|
|
107
|
+
switch (method) {
|
|
108
|
+
case 'sync.preview':
|
|
109
|
+
case 'sync.apply': {
|
|
110
|
+
const llm = llmOf(ctx);
|
|
111
|
+
if (!llm)
|
|
112
|
+
return fail('llm 服务不可用,读不到网关模型目录', 'unavailable');
|
|
113
|
+
const parsed = readProviders(payload);
|
|
114
|
+
if (!parsed.ok)
|
|
115
|
+
return fail(parsed.message);
|
|
116
|
+
const parsedTargets = readTargets(payload);
|
|
117
|
+
if (!parsedTargets.ok)
|
|
118
|
+
return fail(parsedTargets.message);
|
|
119
|
+
// 渠道白名单与目标白名单来自本次请求;路径等注入项仍走 options(测试用)
|
|
120
|
+
//
|
|
121
|
+
// ⚠️ `force` 只对 preview 生效(见 readForce 的注释):apply 必须复用
|
|
122
|
+
// 同一份目录快照,否则保护集会漂移。
|
|
123
|
+
const force = options.force === true || (method === 'sync.preview' && readForce(payload));
|
|
124
|
+
const merged = { ...options, providers: parsed.value, targets: parsedTargets.value, force };
|
|
125
|
+
/**
|
|
126
|
+
* 打印收到的白名单。
|
|
127
|
+
*
|
|
128
|
+
* ⚠️ 真实排障时「前端显示已选 19/19,后端却报没勾选」这种情况,
|
|
129
|
+
* 光看两边代码无法收敛 —— 必须有一条「服务端到底收到了什么」的记录。
|
|
130
|
+
* 只打数量与前几个 id,避免刷屏(不涉密钥)。
|
|
131
|
+
*/
|
|
132
|
+
const received = parsed.value === undefined ? '全部(未指定)' : `${parsed.value.length} 个: ${parsed.value.slice(0, 6).join(', ')}${parsed.value.length > 6 ? ' ...' : ''}`;
|
|
133
|
+
ctx.logger?.info?.(`[jet-hub] ${method} 收到渠道白名单 = ${received}`);
|
|
134
|
+
return done(method === 'sync.preview' ? await previewSync(llm, merged) : await applySync(llm, merged));
|
|
135
|
+
}
|
|
136
|
+
default:
|
|
137
|
+
return undefined;
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
catch (error) {
|
|
141
|
+
return fail(error?.message ?? String(error), 'sync-failed');
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
//# sourceMappingURL=sync-rpc.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sync-rpc.js","sourceRoot":"","sources":["../src/sync-rpc.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,220 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 「一键同步模型到 pi / ZCode」的**服务层**:目录采集 → 计划 → 落盘。
|
|
3
|
+
*
|
|
4
|
+
* ## 分层(为什么拆三个文件)
|
|
5
|
+
*
|
|
6
|
+
* | 文件 | 职责 | 是否碰磁盘 |
|
|
7
|
+
* |---|---|---|
|
|
8
|
+
* | `sync-targets.ts` | 纯计划:算新配置 + diff | 否 |
|
|
9
|
+
* | `sync-apply.ts` | 备份 / 写入 / 复读校验 / 回滚 | 是 |
|
|
10
|
+
* | 本文件 | 组装:取网关目录、逐目标兜错、编排 preview 与 apply | 是(经由上面两层) |
|
|
11
|
+
*
|
|
12
|
+
* ## 两条硬约定(沿用网关目录的既有口径)
|
|
13
|
+
*
|
|
14
|
+
* 1. **逐目标兜错**:一个目标解析失败(文件不存在、格式不认识)不能让另一个目标
|
|
15
|
+
* 也报错——用户需要看到的正是「哪个目标有问题、为什么」。
|
|
16
|
+
* 2. **不搬运密钥**:本模块只刷新模型列表与能力规则,`apiKey` 由 `plan*` 原样保留。
|
|
17
|
+
*
|
|
18
|
+
* @module src/sync-service.ts
|
|
19
|
+
*/
|
|
20
|
+
import { type GatewayModelSource } from './openai-gateway/models.js';
|
|
21
|
+
import { type SyncPaths } from './sync-apply.js';
|
|
22
|
+
import { type SyncDiff, type SyncModel, type SyncPlanOptions, type SyncTargetId } from './sync-targets.js';
|
|
23
|
+
/** 供本模块使用的最小 llm 形态(与网关目录采集接口同源,便于单测替身)。 */
|
|
24
|
+
export type SyncModelSource = GatewayModelSource;
|
|
25
|
+
/**
|
|
26
|
+
* 外部工具实际要填的本机网关地址。
|
|
27
|
+
*
|
|
28
|
+
* ⚠️ 用 `127.0.0.1` 而**不是**网关的监听地址:开了「允许局域网访问」时监听地址是
|
|
29
|
+
* `0.0.0.0`,但外部工具在本机连接必须写回环地址。端口仍跟随解析结果,
|
|
30
|
+
* 避免用户改过端口后同步到旧端口。
|
|
31
|
+
*/
|
|
32
|
+
export declare function localGatewayBaseUrl(env?: NodeJS.ProcessEnv): string;
|
|
33
|
+
/**
|
|
34
|
+
* 采集网关当前对外暴露的模型目录,归一成 {@link SyncModel}。
|
|
35
|
+
*
|
|
36
|
+
* id 采用 `<provider>/<model>` 形式:与 `/v1/models` 输出、以及 pi / ZCode 里
|
|
37
|
+
* 现有条目的写法**逐字一致**(否则同步会造出一份对不上的新列表)。
|
|
38
|
+
*/
|
|
39
|
+
export declare function collectSyncModels(llm: SyncModelSource): Promise<SyncModel[]>;
|
|
40
|
+
/** 目录采集结果:模型 + 本次**读失败**的渠道。 */
|
|
41
|
+
export interface SyncCatalog {
|
|
42
|
+
models: SyncModel[];
|
|
43
|
+
/**
|
|
44
|
+
* 本次 `listModels` 抛错的 provider。
|
|
45
|
+
*
|
|
46
|
+
* ⚠️ 必须一路透传到计划层:这些渠道的模型会从目录里消失,若照常判「已删除」,
|
|
47
|
+
* **一次 token 过期就会把用户另外两个工具的该渠道模型全删掉**。
|
|
48
|
+
*/
|
|
49
|
+
failedProviders: string[];
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* 采集网关目录并记录失败渠道。
|
|
53
|
+
*
|
|
54
|
+
* ## ⚠️ 走 30 秒缓存,不要在这里裸采集
|
|
55
|
+
*
|
|
56
|
+
* `collectGatewayCatalogSnapshot` 是全链路唯一的采集入口(`/v1/models`、
|
|
57
|
+
* `/v1/reasoning-efforts`、设置页 `gateway.getEnabled`、本模块四个调用点共用)。
|
|
58
|
+
* 不缓存时一次采集 = 12 个 `listModels` + **每个模型**一次 `resolveModelInfo`
|
|
59
|
+
* (实测 369 次)—— 而打开一次「同步模型」面板,组件挂载就连发两次 preview
|
|
60
|
+
* ⇒ 738 次。
|
|
61
|
+
*
|
|
62
|
+
* 缓存对**保护集**尤其重要:`failedProviders` 与目录必须是同一份快照,
|
|
63
|
+
* 否则 `previewSync` 与 `applySync` 各采一次、两次之间目录一变,
|
|
64
|
+
* 保护集就漂移(旧缺陷:预览说「保留」、落盘却「删除」)。
|
|
65
|
+
*
|
|
66
|
+
* ## ⚠️⚠️ 必须补全 contextWindow(2026-11-11 真实报障)
|
|
67
|
+
*
|
|
68
|
+
* `llm.listModels()` 只保证返回 `{ id, name }` —— `contextWindow` 不在其中。
|
|
69
|
+
* 网关的 `/v1/models` 之所以能给出 `context_window`,是因为它额外走了
|
|
70
|
+
* `collectGatewayModelDetails()`(逐个 `resolveModelInfo`)+ `applyGatewayContextWindows()`。
|
|
71
|
+
* 初版直接拿 `listModels` 的裸结果,于是 361 个模型**全部缺 contextWindow**
|
|
72
|
+
* ⇒ 全被判为「不可写」⇒ 用户看到「已勾选 19/19」却「本次同步 0 个模型」。
|
|
73
|
+
* 这里复用与网关**完全相同**的那条补全路径,两边才不会漂。
|
|
74
|
+
*
|
|
75
|
+
* ⚠️ 逐模型解析失败**不算渠道级失败**(渠道本身是好的,只是某几个模型
|
|
76
|
+
* 拿不到窗口):这些模型只会缺 `contextWindow` → 被下游判为 `skipped`,而
|
|
77
|
+
* 「skipped 的模型如果目标里已有就必须保留」由 `planPiSync` / `planZcodeSync`
|
|
78
|
+
* 负责(见 `src/sync-targets.ts` 的 skip 分支,保护粒度 = **单个模型**)。
|
|
79
|
+
* 若把整条渠道塞进 `failedProviders`,一个模型抖动会冻结整条渠道
|
|
80
|
+
* (新模型也进不来),反而更差。
|
|
81
|
+
*
|
|
82
|
+
* @param options.force 强制重新采集。⚠️ UI 的「刷新」按钮**必须**传 `true`,
|
|
83
|
+
* 否则点刷新会命中缓存、看起来「没反应」。
|
|
84
|
+
*/
|
|
85
|
+
export declare function collectSyncCatalog(llm: SyncModelSource, options?: {
|
|
86
|
+
readonly force?: boolean;
|
|
87
|
+
}): Promise<SyncCatalog>;
|
|
88
|
+
/** 单个目标的预览结果。 */
|
|
89
|
+
export interface SyncTargetPreview {
|
|
90
|
+
target: SyncTargetId;
|
|
91
|
+
path: string;
|
|
92
|
+
/** 目标是否可用(文件存在且结构认得)。 */
|
|
93
|
+
ok: boolean;
|
|
94
|
+
/** `ok: false` 时的原因(直接展示给用户)。 */
|
|
95
|
+
error?: string;
|
|
96
|
+
diff?: SyncDiff;
|
|
97
|
+
}
|
|
98
|
+
/** 网关侧一个渠道的概况(UI 用它渲染「同步哪些渠道」的勾选列表)。 */
|
|
99
|
+
export interface SyncProviderInfo {
|
|
100
|
+
id: string;
|
|
101
|
+
/** 该渠道在网关目录里的模型数。 */
|
|
102
|
+
modelCount: number;
|
|
103
|
+
/** 该渠道的模型是否已出现在各目标里(决定默认勾选状态)。 */
|
|
104
|
+
inTargets: Record<SyncTargetId, boolean>;
|
|
105
|
+
}
|
|
106
|
+
/** 预览结果(UI 据此渲染「将新增/移除/更新哪些模型」)。 */
|
|
107
|
+
export interface SyncPreviewResult {
|
|
108
|
+
gatewayBaseUrl: string;
|
|
109
|
+
/** 本次参与同步的模型数(已按 `providers` 过滤)。 */
|
|
110
|
+
modelCount: number;
|
|
111
|
+
/**
|
|
112
|
+
* 其中**真正可写入**的模型数(contextWindow 齐全)。
|
|
113
|
+
*
|
|
114
|
+
* ⚠️ 与 `modelCount` 分开暴露是刻意的:两者不等时,说明目录里有一批模型
|
|
115
|
+
* 因能力值缺失被跳过,而不是「没勾选渠道」—— 两者用一个数字表达,用户对着
|
|
116
|
+
* 「已选 19/19、本次同步 0 个」完全无从判断到底哪里出了问题。
|
|
117
|
+
*/
|
|
118
|
+
usableModelCount: number;
|
|
119
|
+
/** 网关目录里的模型总数(未过滤,用于告诉用户「你只选了 30 / 369」)。 */
|
|
120
|
+
totalModelCount: number;
|
|
121
|
+
/** 本次请求实际收到的渠道白名单(未提供时为 `undefined`)。用于自证「勾了却匹配不到」。 */
|
|
122
|
+
requestedProviders?: readonly string[];
|
|
123
|
+
/** 网关侧全部渠道(**不受** `providers` 过滤,供 UI 勾选)。 */
|
|
124
|
+
providers: SyncProviderInfo[];
|
|
125
|
+
/** 本次采集失败的渠道(UI 必须显示:它们的模型是被保留而非"确认仍存在")。 */
|
|
126
|
+
failedProviders: string[];
|
|
127
|
+
targets: SyncTargetPreview[];
|
|
128
|
+
}
|
|
129
|
+
/** 同步选项(单测用 home / env 覆盖,生产走默认)。 */
|
|
130
|
+
export interface SyncOptions {
|
|
131
|
+
paths?: SyncPaths;
|
|
132
|
+
home?: string;
|
|
133
|
+
env?: NodeJS.ProcessEnv;
|
|
134
|
+
/**
|
|
135
|
+
* 强制重新采集网关目录(忽略 30 秒缓存)。
|
|
136
|
+
*
|
|
137
|
+
* ⚠️ 只有 UI 的「刷新」按钮该传 `true`。`sync.preview` 与 `sync.apply`
|
|
138
|
+
* **必须看到同一份**目录,否则保护集会漂移(一个是 30 秒前的快照、
|
|
139
|
+
* 一个是现在的,`failedProviders` 一变就「预览说保留、落盘却删除」)。
|
|
140
|
+
*/
|
|
141
|
+
force?: boolean;
|
|
142
|
+
/**
|
|
143
|
+
* 只同步这些渠道(provider id)。缺省 = 目录里的全部渠道。
|
|
144
|
+
*
|
|
145
|
+
* ⚠️ 空数组表示「一个都没选」,与缺省**语义不同**:空数组会被当成
|
|
146
|
+
* 「没有可写入的模型」而拒绝同步(否则等于把目标清空)。
|
|
147
|
+
*/
|
|
148
|
+
providers?: readonly string[];
|
|
149
|
+
/**
|
|
150
|
+
* 只处理这些目标 agent。缺省 = 全部(pi 与 ZCode 都写)。
|
|
151
|
+
*
|
|
152
|
+
* ⚠️ 空数组与缺省**语义不同**:空数组 = 一个目标都没选,会被拒绝
|
|
153
|
+
*(否则按钮看起来「成功」但什么都没发生)。
|
|
154
|
+
*/
|
|
155
|
+
targets?: readonly SyncTargetId[];
|
|
156
|
+
}
|
|
157
|
+
/**
|
|
158
|
+
* 计算预览:读取两个目标的当前配置,算出各自的 diff。
|
|
159
|
+
*
|
|
160
|
+
* **不写任何文件**。每个目标独立兜错:某个文件缺失只标记该目标 `ok:false`。
|
|
161
|
+
*/
|
|
162
|
+
export declare function previewSync(llm: SyncModelSource, options?: SyncOptions): Promise<SyncPreviewResult>;
|
|
163
|
+
/** 单个目标的落盘结果。 */
|
|
164
|
+
export interface SyncApplyEntry {
|
|
165
|
+
target: SyncTargetId;
|
|
166
|
+
path: string;
|
|
167
|
+
/** 备份目录(回滚用,UI 必须显示给用户)。 */
|
|
168
|
+
backupDir: string;
|
|
169
|
+
diff: SyncDiff;
|
|
170
|
+
}
|
|
171
|
+
/** 落盘结果。 */
|
|
172
|
+
export interface SyncApplyResult {
|
|
173
|
+
gatewayBaseUrl: string;
|
|
174
|
+
modelCount: number;
|
|
175
|
+
applied: SyncApplyEntry[];
|
|
176
|
+
/** 未落盘的目标及原因(无变更 / 预览失败)。这些不是错误,但要说清楚。 */
|
|
177
|
+
skipped: {
|
|
178
|
+
target: SyncTargetId;
|
|
179
|
+
path: string;
|
|
180
|
+
reason: string;
|
|
181
|
+
}[];
|
|
182
|
+
}
|
|
183
|
+
/**
|
|
184
|
+
* `applySync` 的选项:在 `SyncOptions` 之上加两个**单测注入点**。
|
|
185
|
+
*
|
|
186
|
+
* 两个注入点都不是「为测试而存在」的抽象 —— 它们各自对应一条**无法从外部观测**
|
|
187
|
+
* 的防御(写后幂等复算、写入失败回滚),只能靠替换协作者来证明它真的会拦。
|
|
188
|
+
*/
|
|
189
|
+
export interface SyncApplyOptions extends SyncOptions {
|
|
190
|
+
/** 注入点:写入后的复读校验;生产用缺省幂等复算;单测可注入必失败函数验证回滚。 */
|
|
191
|
+
validate?: (target: SyncTargetId, path: string) => void | Promise<void>;
|
|
192
|
+
/**
|
|
193
|
+
* 注入点:替换「目标 → 计划器」的装配。
|
|
194
|
+
*
|
|
195
|
+
* 生产用缺省。单测可以包一层,让 `plan` 在**第二次**调用(写后幂等复算)
|
|
196
|
+
* 时返回非空 diff —— 这是唯一能验证那条防御真的生效的方式:正常实现下
|
|
197
|
+
* `plan` 对刚写入的配置必然返回空 diff,删掉复算也不会影响任何用例(审计 M09)。
|
|
198
|
+
*/
|
|
199
|
+
targetOps?: (target: SyncTargetId, paths: SyncPaths, models: readonly SyncModel[], gatewayBaseUrl: string) => {
|
|
200
|
+
path: string;
|
|
201
|
+
plan: (config: any, options?: SyncPlanOptions) => {
|
|
202
|
+
config: any;
|
|
203
|
+
diff: SyncDiff;
|
|
204
|
+
};
|
|
205
|
+
};
|
|
206
|
+
}
|
|
207
|
+
/**
|
|
208
|
+
* 执行同步:逐目标重新读盘 → 重新算计划 → 备份 → 写入 → 复读校验。
|
|
209
|
+
*
|
|
210
|
+
* ⚠️ **不复用 preview 的结果**:preview 与 apply 之间用户可能手改过配置文件,
|
|
211
|
+
* 用旧计划落盘会覆盖掉那次手改。这里重新读、重新算。
|
|
212
|
+
*
|
|
213
|
+
* ⚠️ diff 为空的目标**不写文件**:否则每次点按钮都会产生一份无意义的备份目录。
|
|
214
|
+
*
|
|
215
|
+
* ⚠️ **多目标是「全有或全无」**:任一目标写入失败,前面已写成功的目标会被
|
|
216
|
+
* 逐个还原到原字节。用户点一次「同步」是一个原子意图,留下半改状态比失败更糟
|
|
217
|
+
* (见 `written` 的注释)。
|
|
218
|
+
*/
|
|
219
|
+
export declare function applySync(llm: SyncModelSource, options?: SyncApplyOptions): Promise<SyncApplyResult>;
|
|
220
|
+
//# sourceMappingURL=sync-service.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sync-service.d.ts","sourceRoot":"","sources":["../src/sync-service.ts"],"names":[],"mappings":"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"}
|