@xixka/dsh-hub 0.2.1-rc.8 → 0.2.2
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 +60 -854
- package/lib/accio-adapter.d.ts.map +1 -1
- package/lib/accio-adapter.js +3 -1
- package/lib/accio-adapter.js.map +1 -1
- package/lib/account-pool.d.ts +162 -1
- package/lib/account-pool.d.ts.map +1 -1
- package/lib/account-pool.js +322 -15
- package/lib/account-pool.js.map +1 -1
- package/lib/aggregate-adapter.d.ts +38 -0
- package/lib/aggregate-adapter.d.ts.map +1 -1
- package/lib/aggregate-adapter.js +145 -12
- package/lib/aggregate-adapter.js.map +1 -1
- package/lib/aggregate-expiry.d.ts.map +1 -1
- package/lib/aggregate-expiry.js +4 -0
- package/lib/aggregate-expiry.js.map +1 -1
- package/lib/analyze-image.d.ts.map +1 -1
- package/lib/analyze-image.js.map +1 -1
- package/lib/astudio-adapter.d.ts.map +1 -1
- package/lib/astudio-adapter.js +3 -1
- package/lib/astudio-adapter.js.map +1 -1
- package/lib/buddy-adapter.d.ts.map +1 -1
- package/lib/buddy-adapter.js +22 -4
- package/lib/buddy-adapter.js.map +1 -1
- package/lib/buddy.d.ts +7 -2
- package/lib/buddy.d.ts.map +1 -1
- package/lib/buddy.js +7 -2
- package/lib/buddy.js.map +1 -1
- package/lib/canonical-models.d.ts.map +1 -1
- package/lib/canonical-models.js +20 -0
- package/lib/canonical-models.js.map +1 -1
- package/lib/chromium-session.d.ts +174 -0
- package/lib/chromium-session.d.ts.map +1 -1
- package/lib/chromium-session.js +418 -1
- package/lib/chromium-session.js.map +1 -1
- package/lib/client/jet-hub.js +287 -13303
- package/lib/codearts-credits.d.ts +123 -13
- package/lib/codearts-credits.d.ts.map +1 -1
- package/lib/codearts-credits.js +168 -25
- package/lib/codearts-credits.js.map +1 -1
- package/lib/codearts-vision.d.ts +95 -4
- package/lib/codearts-vision.d.ts.map +1 -1
- package/lib/codearts-vision.js +136 -5
- package/lib/codearts-vision.js.map +1 -1
- package/lib/codely-adapter.d.ts +36 -3
- package/lib/codely-adapter.d.ts.map +1 -1
- package/lib/codely-adapter.js +252 -11
- package/lib/codely-adapter.js.map +1 -1
- package/lib/codely-auth-service.d.ts +17 -0
- package/lib/codely-auth-service.d.ts.map +1 -1
- package/lib/codely-auth-service.js +40 -3
- package/lib/codely-auth-service.js.map +1 -1
- package/lib/codely-auth.d.ts.map +1 -1
- package/lib/codely-auth.js +23 -0
- package/lib/codely-auth.js.map +1 -1
- package/lib/codely-credits.d.ts.map +1 -1
- package/lib/codely-credits.js +18 -1
- package/lib/codely-credits.js.map +1 -1
- package/lib/codely-product.d.ts +10 -5
- package/lib/codely-product.d.ts.map +1 -1
- package/lib/codely-product.js +4 -2
- package/lib/codely-product.js.map +1 -1
- package/lib/credential-resolver.d.ts +41 -1
- package/lib/credential-resolver.d.ts.map +1 -1
- package/lib/credential-resolver.js +31 -6
- package/lib/credential-resolver.js.map +1 -1
- package/lib/image-budget.d.ts +3 -11
- package/lib/image-budget.d.ts.map +1 -1
- package/lib/image-budget.js +43 -5
- package/lib/image-budget.js.map +1 -1
- package/lib/image-data-cache.d.ts +87 -0
- package/lib/image-data-cache.d.ts.map +1 -0
- package/lib/image-data-cache.js +144 -0
- package/lib/image-data-cache.js.map +1 -0
- package/lib/index.d.ts +0 -51
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +290 -164
- package/lib/index.js.map +1 -1
- package/lib/jet-hub-rpc.d.ts +14 -17
- package/lib/jet-hub-rpc.d.ts.map +1 -1
- package/lib/jet-hub-rpc.js +812 -328
- package/lib/jet-hub-rpc.js.map +1 -1
- package/lib/jet-hub-store.d.ts +74 -1
- package/lib/jet-hub-store.d.ts.map +1 -1
- package/lib/jet-hub-store.js +72 -4
- package/lib/jet-hub-store.js.map +1 -1
- package/lib/llm-adapter.d.ts +96 -5
- package/lib/llm-adapter.d.ts.map +1 -1
- package/lib/llm-adapter.js +742 -62
- package/lib/llm-adapter.js.map +1 -1
- package/lib/lobsterai-adapter.d.ts.map +1 -1
- package/lib/lobsterai-adapter.js +54 -15
- package/lib/lobsterai-adapter.js.map +1 -1
- package/lib/login.d.ts +5 -13
- package/lib/login.d.ts.map +1 -1
- package/lib/login.js +75 -14
- package/lib/login.js.map +1 -1
- package/lib/loomy-adapter.d.ts +3 -0
- package/lib/loomy-adapter.d.ts.map +1 -1
- package/lib/loomy-adapter.js +11 -3
- package/lib/loomy-adapter.js.map +1 -1
- package/lib/loomy-auth.d.ts +51 -0
- package/lib/loomy-auth.d.ts.map +1 -1
- package/lib/loomy-auth.js +149 -2
- package/lib/loomy-auth.js.map +1 -1
- package/lib/loomy-oauth.d.ts +44 -0
- package/lib/loomy-oauth.d.ts.map +1 -1
- package/lib/loomy-oauth.js +48 -1
- package/lib/loomy-oauth.js.map +1 -1
- package/lib/loomy-sms-login.d.ts +61 -0
- package/lib/loomy-sms-login.d.ts.map +1 -0
- package/lib/loomy-sms-login.js +330 -0
- package/lib/loomy-sms-login.js.map +1 -0
- package/lib/loomy.d.ts +22 -0
- package/lib/loomy.d.ts.map +1 -1
- package/lib/loomy.js +10 -0
- package/lib/loomy.js.map +1 -1
- package/lib/magicrew-adapter.d.ts +201 -0
- package/lib/magicrew-adapter.d.ts.map +1 -0
- package/lib/magicrew-adapter.js +595 -0
- package/lib/magicrew-adapter.js.map +1 -0
- package/lib/magicrew-auth.d.ts +494 -0
- package/lib/magicrew-auth.d.ts.map +1 -0
- package/lib/magicrew-auth.js +951 -0
- package/lib/magicrew-auth.js.map +1 -0
- package/lib/magicrew-browser-login.d.ts +333 -0
- package/lib/magicrew-browser-login.d.ts.map +1 -0
- package/lib/magicrew-browser-login.js +740 -0
- package/lib/magicrew-browser-login.js.map +1 -0
- package/lib/magicrew-catalog.d.ts +19 -0
- package/lib/magicrew-catalog.d.ts.map +1 -0
- package/lib/magicrew-catalog.js +80 -0
- package/lib/magicrew-catalog.js.map +1 -0
- package/lib/magicrew-credits.d.ts +112 -0
- package/lib/magicrew-credits.d.ts.map +1 -0
- package/lib/magicrew-credits.js +319 -0
- package/lib/magicrew-credits.js.map +1 -0
- package/lib/magicrew-local-browser.d.ts +123 -0
- package/lib/magicrew-local-browser.d.ts.map +1 -0
- package/lib/magicrew-local-browser.js +321 -0
- package/lib/magicrew-local-browser.js.map +1 -0
- package/lib/magicrew-product.d.ts +127 -0
- package/lib/magicrew-product.d.ts.map +1 -0
- package/lib/magicrew-product.js +159 -0
- package/lib/magicrew-product.js.map +1 -0
- package/lib/magicrew-profile.d.ts +74 -0
- package/lib/magicrew-profile.d.ts.map +1 -0
- package/lib/magicrew-profile.js +148 -0
- package/lib/magicrew-profile.js.map +1 -0
- package/lib/magicrew.d.ts +185 -0
- package/lib/magicrew.d.ts.map +1 -0
- package/lib/magicrew.js +215 -0
- package/lib/magicrew.js.map +1 -0
- package/lib/model-catalog.d.ts +8 -0
- package/lib/model-catalog.d.ts.map +1 -1
- package/lib/model-catalog.js +127 -5
- package/lib/model-catalog.js.map +1 -1
- package/lib/models.d.ts +216 -32
- package/lib/models.d.ts.map +1 -1
- package/lib/models.js +500 -47
- package/lib/models.js.map +1 -1
- package/lib/modelscope-adapter.d.ts.map +1 -1
- package/lib/modelscope-adapter.js +7 -2
- package/lib/modelscope-adapter.js.map +1 -1
- package/lib/modelscope-product.d.ts +44 -6
- package/lib/modelscope-product.d.ts.map +1 -1
- package/lib/modelscope-product.js +98 -9
- package/lib/modelscope-product.js.map +1 -1
- package/lib/officeace-adapter.d.ts.map +1 -1
- package/lib/officeace-adapter.js +147 -21
- package/lib/officeace-adapter.js.map +1 -1
- package/lib/officeace-auth.d.ts +15 -0
- package/lib/officeace-auth.d.ts.map +1 -1
- package/lib/officeace-auth.js +99 -2
- package/lib/officeace-auth.js.map +1 -1
- package/lib/openai-gateway/tencent-fingerprint.d.ts.map +1 -1
- package/lib/openai-gateway/tencent-fingerprint.js +28 -3
- package/lib/openai-gateway/tencent-fingerprint.js.map +1 -1
- package/lib/opencode-adapter.d.ts +27 -0
- package/lib/opencode-adapter.d.ts.map +1 -1
- package/lib/opencode-adapter.js +57 -8
- package/lib/opencode-adapter.js.map +1 -1
- package/lib/opencode-bun-tls.d.ts +103 -0
- package/lib/opencode-bun-tls.d.ts.map +1 -0
- package/lib/opencode-bun-tls.js +212 -0
- package/lib/opencode-bun-tls.js.map +1 -0
- package/lib/opencode-messages.d.ts +0 -19
- package/lib/opencode-messages.d.ts.map +1 -1
- package/lib/opencode-messages.js +30 -33
- package/lib/opencode-messages.js.map +1 -1
- package/lib/opencode-official-prompt.d.ts +62 -0
- package/lib/opencode-official-prompt.d.ts.map +1 -0
- package/lib/opencode-official-prompt.js +119 -0
- package/lib/opencode-official-prompt.js.map +1 -0
- package/lib/opencode-official-tools.d.ts +27 -0
- package/lib/opencode-official-tools.d.ts.map +1 -0
- package/lib/opencode-official-tools.js +340 -0
- package/lib/opencode-official-tools.js.map +1 -0
- package/lib/opencode-product.d.ts.map +1 -1
- package/lib/opencode-product.js +3 -2
- package/lib/opencode-product.js.map +1 -1
- package/lib/opencode-stream.d.ts.map +1 -1
- package/lib/opencode-stream.js +8 -7
- package/lib/opencode-stream.js.map +1 -1
- package/lib/product.d.ts +15 -3
- package/lib/product.d.ts.map +1 -1
- package/lib/product.js +44 -11
- package/lib/product.js.map +1 -1
- package/lib/provider-credits.d.ts +2 -0
- package/lib/provider-credits.d.ts.map +1 -1
- package/lib/provider-credits.js +46 -17
- package/lib/provider-credits.js.map +1 -1
- package/lib/provider-expiry.d.ts.map +1 -1
- package/lib/provider-expiry.js +29 -0
- package/lib/provider-expiry.js.map +1 -1
- package/lib/provider-http-pool.d.ts +85 -0
- package/lib/provider-http-pool.d.ts.map +1 -0
- package/lib/provider-http-pool.js +224 -0
- package/lib/provider-http-pool.js.map +1 -0
- package/lib/provider-registry.d.ts.map +1 -1
- package/lib/provider-registry.js +73 -39
- package/lib/provider-registry.js.map +1 -1
- package/lib/qiniu-adapter.d.ts +276 -0
- package/lib/qiniu-adapter.d.ts.map +1 -0
- package/lib/qiniu-adapter.js +689 -0
- package/lib/qiniu-adapter.js.map +1 -0
- package/lib/qiniu-auth.d.ts +130 -0
- package/lib/qiniu-auth.d.ts.map +1 -0
- package/lib/qiniu-auth.js +234 -0
- package/lib/qiniu-auth.js.map +1 -0
- package/lib/qiniu-messages.d.ts +96 -0
- package/lib/qiniu-messages.d.ts.map +1 -0
- package/lib/qiniu-messages.js +97 -0
- package/lib/qiniu-messages.js.map +1 -0
- package/lib/qiniu-product.d.ts +126 -0
- package/lib/qiniu-product.d.ts.map +1 -0
- package/lib/qiniu-product.js +269 -0
- package/lib/qiniu-product.js.map +1 -0
- package/lib/qiniu-rpc.d.ts +119 -0
- package/lib/qiniu-rpc.d.ts.map +1 -0
- package/lib/qiniu-rpc.js +214 -0
- package/lib/qiniu-rpc.js.map +1 -0
- package/lib/qiniu.d.ts +145 -0
- package/lib/qiniu.d.ts.map +1 -0
- package/lib/qiniu.js +164 -0
- package/lib/qiniu.js.map +1 -0
- package/lib/raccoon-adapter.d.ts +18 -2
- package/lib/raccoon-adapter.d.ts.map +1 -1
- package/lib/raccoon-adapter.js +154 -21
- package/lib/raccoon-adapter.js.map +1 -1
- package/lib/raccoon-auth.d.ts +6 -0
- package/lib/raccoon-auth.d.ts.map +1 -1
- package/lib/raccoon-auth.js +9 -1
- package/lib/raccoon-auth.js.map +1 -1
- package/lib/raccoon-credits.d.ts +38 -5
- package/lib/raccoon-credits.d.ts.map +1 -1
- package/lib/raccoon-credits.js +127 -6
- package/lib/raccoon-credits.js.map +1 -1
- package/lib/raccoon.d.ts +14 -2
- package/lib/raccoon.d.ts.map +1 -1
- package/lib/raccoon.js +14 -2
- package/lib/raccoon.js.map +1 -1
- package/lib/service.d.ts +46 -6
- package/lib/service.d.ts.map +1 -1
- package/lib/service.js +104 -16
- package/lib/service.js.map +1 -1
- package/lib/session-balance.d.ts +203 -0
- package/lib/session-balance.d.ts.map +1 -0
- package/lib/session-balance.js +279 -0
- package/lib/session-balance.js.map +1 -0
- package/lib/sign.d.ts +97 -1
- package/lib/sign.d.ts.map +1 -1
- package/lib/sign.js +174 -2
- package/lib/sign.js.map +1 -1
- package/lib/token-ledger-store.d.ts.map +1 -1
- package/lib/token-ledger-store.js +121 -27
- package/lib/token-ledger-store.js.map +1 -1
- package/lib/trae-adapter.d.ts.map +1 -1
- package/lib/trae-adapter.js +3 -1
- package/lib/trae-adapter.js.map +1 -1
- package/lib/types.d.ts +165 -13
- package/lib/types.d.ts.map +1 -1
- package/lib/types.js.map +1 -1
- package/lib/usage-badge.d.ts +77 -7
- package/lib/usage-badge.d.ts.map +1 -1
- package/lib/usage-badge.js +190 -28
- package/lib/usage-badge.js.map +1 -1
- package/lib/webdav-auto-sync.d.ts +96 -0
- package/lib/webdav-auto-sync.d.ts.map +1 -0
- package/lib/webdav-auto-sync.js +0 -0
- package/lib/webdav-auto-sync.js.map +1 -0
- package/lib/webdav-sync-crypto.d.ts +18 -0
- package/lib/webdav-sync-crypto.d.ts.map +1 -0
- package/lib/webdav-sync-crypto.js +72 -0
- package/lib/webdav-sync-crypto.js.map +1 -0
- package/lib/webdav-sync-merge.d.ts +31 -0
- package/lib/webdav-sync-merge.d.ts.map +1 -0
- package/lib/webdav-sync-merge.js +0 -0
- package/lib/webdav-sync-merge.js.map +1 -0
- package/lib/webdav-sync.d.ts +155 -0
- package/lib/webdav-sync.d.ts.map +1 -0
- package/lib/webdav-sync.js +412 -0
- package/lib/webdav-sync.js.map +1 -0
- package/lib/zcode-adapter.d.ts +4 -2
- package/lib/zcode-adapter.d.ts.map +1 -1
- package/lib/zcode-adapter.js +132 -37
- package/lib/zcode-adapter.js.map +1 -1
- package/lib/zcode-upstream.d.ts +59 -0
- package/lib/zcode-upstream.d.ts.map +1 -1
- package/lib/zcode-upstream.js +137 -2
- package/lib/zcode-upstream.js.map +1 -1
- package/package.json +5 -4
- package/lib/stepcode-adapter.d.ts +0 -158
- package/lib/stepcode-adapter.d.ts.map +0 -1
- package/lib/stepcode-adapter.js +0 -318
- package/lib/stepcode-adapter.js.map +0 -1
- package/lib/stepcode-auth.d.ts +0 -154
- package/lib/stepcode-auth.d.ts.map +0 -1
- package/lib/stepcode-auth.js +0 -287
- package/lib/stepcode-auth.js.map +0 -1
- package/lib/stepcode-oauth.d.ts +0 -194
- package/lib/stepcode-oauth.d.ts.map +0 -1
- package/lib/stepcode-oauth.js +0 -496
- package/lib/stepcode-oauth.js.map +0 -1
- package/lib/stepcode-product.d.ts +0 -255
- package/lib/stepcode-product.d.ts.map +0 -1
- package/lib/stepcode-product.js +0 -256
- package/lib/stepcode-product.js.map +0 -1
- package/lib/stepcode.d.ts +0 -230
- package/lib/stepcode.d.ts.map +0 -1
- package/lib/stepcode.js +0 -300
- package/lib/stepcode.js.map +0 -1
- package/lib/teleagent-adapter.d.ts +0 -116
- package/lib/teleagent-adapter.d.ts.map +0 -1
- package/lib/teleagent-adapter.js +0 -293
- package/lib/teleagent-adapter.js.map +0 -1
- package/lib/teleagent-auth.d.ts +0 -279
- package/lib/teleagent-auth.d.ts.map +0 -1
- package/lib/teleagent-auth.js +0 -512
- package/lib/teleagent-auth.js.map +0 -1
- package/lib/teleagent-cdp-login.d.ts +0 -100
- package/lib/teleagent-cdp-login.d.ts.map +0 -1
- package/lib/teleagent-cdp-login.js +0 -402
- package/lib/teleagent-cdp-login.js.map +0 -1
- package/lib/teleagent-credits.d.ts +0 -120
- package/lib/teleagent-credits.d.ts.map +0 -1
- package/lib/teleagent-credits.js +0 -288
- package/lib/teleagent-credits.js.map +0 -1
- package/lib/teleagent-product.d.ts +0 -196
- package/lib/teleagent-product.d.ts.map +0 -1
- package/lib/teleagent-product.js +0 -212
- package/lib/teleagent-product.js.map +0 -1
- package/lib/teleagent.d.ts +0 -288
- package/lib/teleagent.d.ts.map +0 -1
- package/lib/teleagent.js +0 -450
- package/lib/teleagent.js.map +0 -1
|
@@ -0,0 +1,740 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 超级麦吉(magicrew)**网页版登录**:开一个**独立 profile** 的浏览器窗口、让用户在里面
|
|
3
|
+
* 完成登录,再从那个 profile 的 localStorage 里把凭据读回来。
|
|
4
|
+
*
|
|
5
|
+
* ## 三条登录路径里的第 ② 条
|
|
6
|
+
*
|
|
7
|
+
* | # | 路径 | 门槛 | 实现 |
|
|
8
|
+
* |---|---|---|---|
|
|
9
|
+
* | ① | 从本机浏览器已登录态导入(免开窗) | 零(用户日常浏览器里已登过) | `magicrew-local-browser.ts` |
|
|
10
|
+
* | ② | **网页版登录(本文件)** | 低(开一个干净窗口,用户扫码/输密码) | `startMagicrewBrowserLogin` |
|
|
11
|
+
* | ③ | 手机号 + 密码(宿主侧直接调上游) | 中(要密码,且上游有风控) | `loginMagicrew` |
|
|
12
|
+
*
|
|
13
|
+
* ②存在的原因:①在「用户从没在本机浏览器登过这个站」「用户用的是另一个 profile」
|
|
14
|
+
* 两种情形下**读不到**(且那两种情况与「没登录」在结果上同形);③要用户把密码交给插件。
|
|
15
|
+
* ②是唯一「用户自己看着官方页面登录、凭据自然落盘」的路径。
|
|
16
|
+
*
|
|
17
|
+
* ## ⚠️⚠️ 为什么必须有**独立 profile**(不是复用用户真实浏览器)
|
|
18
|
+
*
|
|
19
|
+
* 两个理由,各自都踩过:
|
|
20
|
+
*
|
|
21
|
+
* 1. **不能碰用户的 profile**:真实 profile 里有用户的全部 cookie / 会话 / 书签,
|
|
22
|
+
* 且**已被用户自己的浏览器进程独占**(`SingletonLock`)—— 拿它起第二个实例,
|
|
23
|
+
* Chromium 会把 URL 转交给已存在的实例、自己退出(CDP 端口永远不就绪)。
|
|
24
|
+
* 2. **独立 profile 让「读到的凭据只可能是本次登录写进去的」**:一次性目录从空开始,
|
|
25
|
+
* 于是「读到凭据」这件事本身就能当登录完成的判据。⚠️ 参考实现
|
|
26
|
+
* (`magpie-magicrew-auth/src/browser-login.mjs` 的 `newProfileDir` 注释)记录过
|
|
27
|
+
* 复用目录的后果:第二个账号登录时一秒内读到**上一个账号**的 jwt ⇒ 建不出新账号
|
|
28
|
+
* (同一个 accountId/uid 被按契约判成「替换旧账号」)。
|
|
29
|
+
*
|
|
30
|
+
* ## ⚠️⚠️ 打开的是**网页域** `product.webOrigin`,不是 API 子域 `product.host`
|
|
31
|
+
*
|
|
32
|
+
* magicrew 的网页在 `https://www.letsmagic.cn`、API 在
|
|
33
|
+
* `https://i-magic-service.letsmagic.cn`(`product.host`)。localStorage 的 key 是
|
|
34
|
+
* `_https://<origin>\x00\x01<name>`,而**用户只会、也只能在网页域上登录** ——
|
|
35
|
+
* 打开 API 子域会得到一个没有页面的域名(用户当场就懵),按它去扫 localStorage
|
|
36
|
+
* 则**恒读不到**且完全静默。这两格都真实发生过(上一个任务踩过第一个)。
|
|
37
|
+
*
|
|
38
|
+
* ## 读凭据:复用 `magicrew-local-browser.ts`,**不要**重写一份配对逻辑
|
|
39
|
+
*
|
|
40
|
+
* 凭据的配对判据(`"key":"authorization"` × `"key":"organizationCode"`、按 origin
|
|
41
|
+
* 截断窗口、每把 jwt 配**它自己后面**最近的组织码)是**上游错配 ⇒ HTTP 200 +
|
|
42
|
+
* `code:403`** 换来的,只允许有一份实现。⇒ 本文件只做三件事:把
|
|
43
|
+
* `readMagicrewLocalCreds` 的 `roots` 指到**本次的临时 profile 目录**、通过 CDP 读
|
|
44
|
+
* **实时** localStorage、以及轮询。
|
|
45
|
+
*
|
|
46
|
+
* ## ⚠️⚠️ 必须「CDP 实时优先、磁盘兜底」——**只读磁盘是本模块曾经的真缺陷**
|
|
47
|
+
*
|
|
48
|
+
* 真机报障(2026-10-29):用户在这个窗口里**登录成功**了,插件仍显示「尚未配置账号」,
|
|
49
|
+
* 「网页版登录」白转 4 分钟。根因不是路径错、不是匹配逻辑错:
|
|
50
|
+
*
|
|
51
|
+
* - Chromium 把 localStorage **缓在内存**,只有关窗(或批量提交)才刷到
|
|
52
|
+
* `<profileDir>/Default/Local Storage/leveldb` ⇒ 「登录完那一刻」磁盘里**还没有**
|
|
53
|
+
* ⇒ 每 500ms 读一次永远是 `undefined` ⇒ 4 分钟超时。实测可复现:我们起的 profile
|
|
54
|
+
* 目录路径是对的(`Default/Local Storage/leveldb` 存在)、用户真实浏览器里的
|
|
55
|
+
* leveldb 里两个 key 确实相邻(匹配逻辑没问题),但**那一刻**我们这份 leveldb
|
|
56
|
+
* 是空的。
|
|
57
|
+
* - CDP 通路实测可用:`Target.getTargets` → `Target.attachToTarget { flatten: true }`
|
|
58
|
+
* → `Runtime.evaluate`(带 `sessionId`)能读到页面里的实时 `localStorage`。
|
|
59
|
+
*
|
|
60
|
+
* ⇒ 读凭据的**主路径**是 {@link readCredentialViaCdp}(实时),
|
|
61
|
+
* {@link createProfileCredentialReader}(磁盘)降级为**兜底**(老 Chromium /
|
|
62
|
+
* `--remote-allow-origins` 限制下 CDP 可能不可用)。⚠️ **两腿都要留**:删掉磁盘那条腿
|
|
63
|
+
* 会让「CDP 不可用」的机器变成必然失败;删掉 CDP 那条腿就退回本次报障。
|
|
64
|
+
*
|
|
65
|
+
* ## 浏览器基础设施:全部来自 `chromium-session.ts`
|
|
66
|
+
*
|
|
67
|
+
* 起 chromium / 挑空闲调试端口 / 校验应答端口 / 监听 `'error'` / `taskkill /T` /
|
|
68
|
+
* profile 目录退避重试删除 —— 每一条都是真实缺陷换来的(见该模块头那张表)。
|
|
69
|
+
* 这里**不重写**任何一条,只组合 {@link ChromiumSession}。
|
|
70
|
+
*/
|
|
71
|
+
import { isAbsolute } from 'node:path';
|
|
72
|
+
import { BrowserDeploymentError, ChromiumSession, browserCandidates, browserNotFoundMessage, findBrowserExecutable, sleep as defaultSleep, } from './chromium-session.js';
|
|
73
|
+
import { readMagicrewLocalCreds, } from './magicrew-local-browser.js';
|
|
74
|
+
import { MAGICREW } from './magicrew-product.js';
|
|
75
|
+
/**
|
|
76
|
+
* 默认等待用户完成登录的上限(**4 分钟**)。
|
|
77
|
+
*
|
|
78
|
+
* ## ⚠️ 为什么是 4 分钟而不是 5 分钟
|
|
79
|
+
*
|
|
80
|
+
* 客户端的登录轮询上限是 **5 分钟**(`plugin-src/client/jet-hub.js` 的
|
|
81
|
+
* `deadline = Date.now() + 300000`,是客户端自己的表、不是服务端超时)。
|
|
82
|
+
* 两边的上限若相同,宿主给出的终态(「等超时了」)会与客户端收表**几乎同时**发生,
|
|
83
|
+
* 用户大概率只看到「登录超时」那句泛化文案、看不到真正的终态原因。
|
|
84
|
+
* ⇒ 宿主必须**早于**客户端收口,留一分钟余量把原因送到眼前。
|
|
85
|
+
*
|
|
86
|
+
* ⚠️ 同时它也是「用户实际需要多久」的实测区间上限(扫码/输密码 2–5 分钟)。
|
|
87
|
+
*/
|
|
88
|
+
export const MAGICREW_BROWSER_LOGIN_TIMEOUT_MS = 240_000;
|
|
89
|
+
/** 轮询间隔(毫秒)。 */
|
|
90
|
+
export const MAGICREW_BROWSER_LOGIN_POLL_MS = 500;
|
|
91
|
+
/** 把任意外部传入的超时收成「一个合法的非负毫秒数」。 */
|
|
92
|
+
function normalizeTimeoutMs(value) {
|
|
93
|
+
if (value === undefined || !Number.isFinite(value) || value <= 0) {
|
|
94
|
+
return MAGICREW_BROWSER_LOGIN_TIMEOUT_MS;
|
|
95
|
+
}
|
|
96
|
+
return Math.floor(value);
|
|
97
|
+
}
|
|
98
|
+
/** 轮询间隔:非法值回落缺省(`0` / 负数会让下面的循环空转)。 */
|
|
99
|
+
function normalizePollMs(value) {
|
|
100
|
+
if (value === undefined || !Number.isFinite(value) || value <= 0) {
|
|
101
|
+
return MAGICREW_BROWSER_LOGIN_POLL_MS;
|
|
102
|
+
}
|
|
103
|
+
return Math.max(1, Math.floor(value));
|
|
104
|
+
}
|
|
105
|
+
/** 从 URL 取 hostname;非法 URL ⇒ 空串(**不猜**)。 */
|
|
106
|
+
function hostnameOf(url) {
|
|
107
|
+
try {
|
|
108
|
+
return new URL(url).hostname.toLowerCase();
|
|
109
|
+
}
|
|
110
|
+
catch {
|
|
111
|
+
return '';
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
// ════════════════════════════════════════════════════════════════════════
|
|
115
|
+
// CDP 实时读凭据(**主路径**,见文件头「必须 CDP 实时优先」)
|
|
116
|
+
// ════════════════════════════════════════════════════════════════════════
|
|
117
|
+
/**
|
|
118
|
+
* 页面里的取值表达式。
|
|
119
|
+
*
|
|
120
|
+
* ⚠️ 四个值一次取完(**不是**四次 `Runtime.evaluate`):来回四次会让「读到 jwt 之后、
|
|
121
|
+
* 读组织码之前用户换了账号」这种情况出现窗口,而错配的 jwt × org 在上游是
|
|
122
|
+
* HTTP 200 + `code:403`(见 `magicrew-local-browser.ts` 头部的配对纪律)。
|
|
123
|
+
*
|
|
124
|
+
* `n` 是 `localStorage.length`:**空 = 还没登完**(见下面的判据)。
|
|
125
|
+
*/
|
|
126
|
+
const CDP_CREDENTIAL_EXPRESSION = `JSON.stringify({
|
|
127
|
+
a: localStorage.getItem('authorization'),
|
|
128
|
+
o: localStorage.getItem('organizationCode'),
|
|
129
|
+
t: localStorage.getItem('teamshareOrganizationCode'),
|
|
130
|
+
n: localStorage.length,
|
|
131
|
+
})`;
|
|
132
|
+
/**
|
|
133
|
+
* 单条 CDP 命令的上限。
|
|
134
|
+
*
|
|
135
|
+
* ⚠️ **不能**用 `CdpConnection.send` 的 30 秒缺省:外层轮询是 500ms 一拍,
|
|
136
|
+
* 一条卡死的命令会把整轮等待预算(4 分钟)吃掉一小半,且期间磁盘兜底也不会被读到。
|
|
137
|
+
*/
|
|
138
|
+
const CDP_CREDENTIAL_TIMEOUT_MS = 3_000;
|
|
139
|
+
/**
|
|
140
|
+
* `Page.navigate` 的上限。
|
|
141
|
+
*
|
|
142
|
+
* ⚠️ **不能**复用 {@link CDP_CREDENTIAL_TIMEOUT_MS}(3 秒)
|
|
143
|
+
* (2026-10-30 四路审计 P3-1 修):真机实测把页面导航到**黑洞地址**时,
|
|
144
|
+
* `Page.navigate` **15 秒都没返回** ⇒ 3 秒超时会让用户看到
|
|
145
|
+
* 「CDP Page.navigate 超时(3000ms)」这种**内部超时文案**(而不是
|
|
146
|
+
* 「登录页打不开」这种能指路的文案)。
|
|
147
|
+
*
|
|
148
|
+
* ⇒ 导航是**一次性**动作(不是 500ms 一拍的轮询)⇒ 给它更宽的预算。
|
|
149
|
+
*/
|
|
150
|
+
const CDP_NAVIGATE_TIMEOUT_MS = 30_000;
|
|
151
|
+
/** `eyJ…` 三段(JWT 形状)。⚠️ 形状对 ≠ 有效,但形状不对**一定**不是 jwt。 */
|
|
152
|
+
function isJwtShaped(value) {
|
|
153
|
+
if (!value.startsWith('eyJ'))
|
|
154
|
+
return false;
|
|
155
|
+
const parts = value.split('.');
|
|
156
|
+
return parts.length === 3 && parts.every((part) => /^[A-Za-z0-9_\-+/=]+$/.test(part));
|
|
157
|
+
}
|
|
158
|
+
/** 两个 host 是否同一个站点(`www.letsmagic.cn` 与 `letsmagic.cn` 视作同一个)。 */
|
|
159
|
+
function sameSite(left, right) {
|
|
160
|
+
const bare = (host) => host.toLowerCase().replace(/^www\./, '');
|
|
161
|
+
return left.length > 0 && right.length > 0 && bare(left) === bare(right);
|
|
162
|
+
}
|
|
163
|
+
/**
|
|
164
|
+
* 一个 host 的全部写法(`www.letsmagic.cn` / `letsmagic.cn`,去重、保持顺序)。
|
|
165
|
+
*
|
|
166
|
+
* ⚠️ 与 `magicrew-local-browser.ts` 的同名内部辅助**刻意为同一口径**:磁盘那条腿
|
|
167
|
+
* 用的是它,两条腿对「同一个站点」的判断必须一致,否则会出现「磁盘读到了、CDP 说
|
|
168
|
+
* 没有这个页面」这种自相矛盾的诊断。
|
|
169
|
+
*/
|
|
170
|
+
function siteHostnames(hostname) {
|
|
171
|
+
const host = String(hostname ?? '').trim().toLowerCase();
|
|
172
|
+
if (host.length === 0)
|
|
173
|
+
return [];
|
|
174
|
+
const bare = host.replace(/^www\./, '');
|
|
175
|
+
const hosts = [host, bare, `www.${bare}`];
|
|
176
|
+
return hosts.filter((value, index) => value.length > 0 && hosts.indexOf(value) === index);
|
|
177
|
+
}
|
|
178
|
+
/** 在 `Target.getTargets` 的结果里找**命中站点**的那个 page target。 */
|
|
179
|
+
function pickPageTarget(targets, hostnames) {
|
|
180
|
+
const infos = targets?.targetInfos;
|
|
181
|
+
if (!Array.isArray(infos))
|
|
182
|
+
return undefined;
|
|
183
|
+
for (const raw of infos) {
|
|
184
|
+
const info = raw;
|
|
185
|
+
if (info.type !== 'page')
|
|
186
|
+
continue;
|
|
187
|
+
if (typeof info.url !== 'string' || typeof info.targetId !== 'string')
|
|
188
|
+
continue;
|
|
189
|
+
const host = hostnameOf(info.url);
|
|
190
|
+
if (!hostnames.some((candidate) => sameSite(host, candidate)))
|
|
191
|
+
continue;
|
|
192
|
+
return { targetId: info.targetId, url: info.url };
|
|
193
|
+
}
|
|
194
|
+
return undefined;
|
|
195
|
+
}
|
|
196
|
+
/** 解析 `Runtime.evaluate` 的返回值(`{ result: { value } }`)⇒ 读到的凭据。 */
|
|
197
|
+
function parseEvaluatedCredential(value) {
|
|
198
|
+
if (typeof value !== 'string' || value.length === 0)
|
|
199
|
+
return undefined;
|
|
200
|
+
let parsed;
|
|
201
|
+
try {
|
|
202
|
+
parsed = JSON.parse(value);
|
|
203
|
+
}
|
|
204
|
+
catch {
|
|
205
|
+
return undefined;
|
|
206
|
+
}
|
|
207
|
+
/**
|
|
208
|
+
* ⚠️⚠️ **`localStorage` 为空要当「还没登完」返回 `undefined`,不要抛**:
|
|
209
|
+
* 用户刚点开窗口那一刻必然是空的,而这条路径每 500ms 走一次。
|
|
210
|
+
*/
|
|
211
|
+
if (parsed.n === 0)
|
|
212
|
+
return undefined;
|
|
213
|
+
const authorization = typeof parsed.a === 'string' ? parsed.a : '';
|
|
214
|
+
if (!isJwtShaped(authorization))
|
|
215
|
+
return undefined;
|
|
216
|
+
const organization = typeof parsed.o === 'string' && parsed.o.length > 0
|
|
217
|
+
? parsed.o
|
|
218
|
+
: typeof parsed.t === 'string' && parsed.t.length > 0 ? parsed.t : '';
|
|
219
|
+
// ⚠️ 缺组织码 ⇒ `undefined`(**不造假**):空 org 配 jwt 在上游是 HTTP 200 + code:403。
|
|
220
|
+
if (organization.length === 0)
|
|
221
|
+
return undefined;
|
|
222
|
+
return { jwt: authorization, organizationCode: organization };
|
|
223
|
+
}
|
|
224
|
+
/**
|
|
225
|
+
* 尝试**一次**通过 CDP 读实时凭据(并把失败原因带出来)。
|
|
226
|
+
*
|
|
227
|
+
* ## ⚠️ 调用序列是实测跑通的,不要改顺序
|
|
228
|
+
*
|
|
229
|
+
* `Target.getTargets` → `Target.attachToTarget { flatten: true }` →
|
|
230
|
+
* `Runtime.evaluate`(**带 `sessionId`**)。少一步 `flatten` 或漏传 `sessionId`,
|
|
231
|
+
* 页面级命令会落在浏览器端点上并回一句含糊的 `-32601 'Runtime.evaluate' wasn't found`
|
|
232
|
+
* —— 看起来像「API 不存在」,实际是「你没说要发给哪个页面」(该实测记录见
|
|
233
|
+
* `chromium-session.ts` 的 `CdpConnection.send` 注释)。
|
|
234
|
+
*
|
|
235
|
+
* ## ⚠️ 每轮都重新 attach(**不要缓存 sessionId**)
|
|
236
|
+
*
|
|
237
|
+
* 页面在登录过程中会导航(`/login` → `/global/super/workspace/…`),导航会让
|
|
238
|
+
* 旧 `sessionId` 失效。缓存它 ⇒ 用户「登录成功那一秒恰好导航」之后整条等待**永不恢复**。
|
|
239
|
+
*
|
|
240
|
+
* ## ⚠️ 任何一步失败都**返回**(不抛),下一轮自然重试
|
|
241
|
+
*
|
|
242
|
+
* 失败原因只用于**超时那一行诊断**(见 {@link createMagicrewCredentialWaiter}):
|
|
243
|
+
* 下次报障时它直接区分「用户没登」与「我们读的方式坏了」。
|
|
244
|
+
*/
|
|
245
|
+
async function attemptCredentialViaCdp(session, hostnames) {
|
|
246
|
+
const cdp = session?.cdp;
|
|
247
|
+
if (cdp === undefined)
|
|
248
|
+
return { failure: 'CDP 通道未就绪(浏览器未启动或已收窗)' };
|
|
249
|
+
const hosts = hostnames.map((host) => host.trim()).filter((host) => host.length > 0);
|
|
250
|
+
if (hosts.length === 0)
|
|
251
|
+
return { failure: '没有可匹配的 hostname' };
|
|
252
|
+
let sessionId;
|
|
253
|
+
try {
|
|
254
|
+
const targets = await cdp.send('Target.getTargets', {}, CDP_CREDENTIAL_TIMEOUT_MS);
|
|
255
|
+
const target = pickPageTarget(targets, hosts);
|
|
256
|
+
if (target === undefined) {
|
|
257
|
+
return { failure: `${hosts.join(' / ')} 的页面还没出现(用户可能还在加载登录页)` };
|
|
258
|
+
}
|
|
259
|
+
const attached = await cdp.send('Target.attachToTarget', { targetId: target.targetId, flatten: true }, CDP_CREDENTIAL_TIMEOUT_MS);
|
|
260
|
+
const attachedId = typeof attached?.sessionId === 'string' ? attached.sessionId : '';
|
|
261
|
+
if (attachedId.length === 0)
|
|
262
|
+
return { failure: 'Target.attachToTarget 没给出 sessionId' };
|
|
263
|
+
sessionId = attachedId;
|
|
264
|
+
const evaluated = await cdp.send('Runtime.evaluate', { expression: CDP_CREDENTIAL_EXPRESSION, returnByValue: true }, CDP_CREDENTIAL_TIMEOUT_MS, attachedId);
|
|
265
|
+
if (evaluated?.exceptionDetails !== undefined) {
|
|
266
|
+
return { failure: 'Runtime.evaluate 在页面里抛错(页面可能正在导航)' };
|
|
267
|
+
}
|
|
268
|
+
const credential = parseEvaluatedCredential(evaluated?.result?.value);
|
|
269
|
+
// ⚠️ 没读到 = 「用户还没登完」这种**正常**未完成态 ⇒ 不记 failure。
|
|
270
|
+
return credential === undefined ? {} : { credential };
|
|
271
|
+
}
|
|
272
|
+
catch (error) {
|
|
273
|
+
return { failure: `CDP 调用失败:${String(error)}` };
|
|
274
|
+
}
|
|
275
|
+
finally {
|
|
276
|
+
/**
|
|
277
|
+
* ⚠️ attach 会留下 session ⇒ **尽力** detach。
|
|
278
|
+
*
|
|
279
|
+
* 与 `Storage.getCookies` 那条既有口径一致(`chromium-session.ts`):能 detach 就
|
|
280
|
+
* detach,**不可用或失败都不因此失败** —— 有的 Chromium 版本/调试后端没有
|
|
281
|
+
* `Target.detachFromTarget`,为它抛错会让「已经读到凭据」变成读不到。
|
|
282
|
+
*/
|
|
283
|
+
if (sessionId !== undefined) {
|
|
284
|
+
try {
|
|
285
|
+
await cdp.send('Target.detachFromTarget', { sessionId }, CDP_CREDENTIAL_TIMEOUT_MS);
|
|
286
|
+
}
|
|
287
|
+
catch {
|
|
288
|
+
// 尽力而为:收窗时整条通道一起关掉,残留 session 随之消失。
|
|
289
|
+
}
|
|
290
|
+
}
|
|
291
|
+
}
|
|
292
|
+
}
|
|
293
|
+
/**
|
|
294
|
+
* 通过 CDP 读**实时** localStorage。
|
|
295
|
+
*
|
|
296
|
+
* ⚠️ **必须走它而不是读磁盘**:Chromium 把 localStorage 缓在内存,不关浏览器不落盘
|
|
297
|
+
* (真机报障 2026-10-29 —— 磁盘读取的 4 分钟等待里永远是 undefined)。
|
|
298
|
+
*
|
|
299
|
+
* @param session 带 `cdp` 通道的会话(`ChromiumSession` 即可)。
|
|
300
|
+
* @param hostnames 站点 host(**网页域**,例如 `www.letsmagic.cn`;`www.` 前后互认)。
|
|
301
|
+
* @returns 读到 ⇒ 凭据;未登完 / CDP 不可用 ⇒ `undefined`(**绝不抛**,下一轮重试)。
|
|
302
|
+
*/
|
|
303
|
+
export async function readCredentialViaCdp(session, hostnames) {
|
|
304
|
+
return (await attemptCredentialViaCdp(session, hostnames)).credential;
|
|
305
|
+
}
|
|
306
|
+
/**
|
|
307
|
+
* 同 {@link readCredentialViaCdp},但把**失败原因**一并带出来。
|
|
308
|
+
*
|
|
309
|
+
* ⚠️ 存在的理由只有一个:那条「放弃等待」的诊断(见
|
|
310
|
+
* {@link createMagicrewCredentialWaiter} 的 `log`)要能说清「CDP 为什么没读到」。
|
|
311
|
+
* 生产接线用的就是它(把 `failure` 交给等待循环),单测也用它断言「`n === 0`
|
|
312
|
+
* 是正常未完成态、**不是**读失败」—— 这两件事在 `credential` 上同形(都
|
|
313
|
+
* `undefined`),只有 `failure` 能分开。
|
|
314
|
+
*/
|
|
315
|
+
export async function readCredentialViaCdpDetailed(session, hostnames) {
|
|
316
|
+
return await attemptCredentialViaCdp(session, hostnames);
|
|
317
|
+
}
|
|
318
|
+
/**
|
|
319
|
+
* 造一个「从**本次临时 profile**里读 magicrew 凭据」的读函数。
|
|
320
|
+
*
|
|
321
|
+
* ## ⚠️⚠️ 这就是本模块与「本机浏览器导入」的**唯一**实质差异
|
|
322
|
+
*
|
|
323
|
+
* `readMagicrewLocalCreds` 缺省会扫**用户真实浏览器**的 User Data 根目录
|
|
324
|
+
* (`magicrewBrowserRoots()`)。而网页版登录用的是 `mkdtempSync` 出来的临时目录,
|
|
325
|
+
* 真实目录里**永远是空的**(用户在日常浏览器里登过也不在临时 profile 里)
|
|
326
|
+
* ⇒ 不把 `roots` 指过去,`waitForCredential` 会**恒等到超时**,且完全静默。
|
|
327
|
+
*
|
|
328
|
+
* ⚠️ 注入 `roots: [profileDir]` 也让本函数在单测里可断言:给一个临时目录、
|
|
329
|
+
* 里面写一段 leveldb 文本,就能验证「读得到」与「读的是哪个 origin」。
|
|
330
|
+
*
|
|
331
|
+
* @param profileDir 本次会话的 `--user-data-dir`(`ChromiumSession.userDataDir`)。
|
|
332
|
+
* @param hostname 站点 host(**网页域**,见文件头)。
|
|
333
|
+
*/
|
|
334
|
+
export function createProfileCredentialReader(profileDir, hostname, deps = {}) {
|
|
335
|
+
const readCreds = deps.readCreds ?? readMagicrewLocalCreds;
|
|
336
|
+
return () => {
|
|
337
|
+
if (profileDir.length === 0 || hostname.length === 0)
|
|
338
|
+
return undefined;
|
|
339
|
+
let found;
|
|
340
|
+
try {
|
|
341
|
+
found = readCreds(hostname, { roots: [profileDir] });
|
|
342
|
+
}
|
|
343
|
+
catch {
|
|
344
|
+
// ⚠️ 读盘失败(文件被浏览器独占 / 权限)**不是**「用户没登录」——
|
|
345
|
+
// 但也不能抛错(那是正常路径,见接口头):下一轮再试即可。
|
|
346
|
+
return undefined;
|
|
347
|
+
}
|
|
348
|
+
if (found === undefined)
|
|
349
|
+
return undefined;
|
|
350
|
+
// ⚠️ 只搬两个字段:`expiresAt` 不在 `MagicrewCredential` 里(三层凭证的到期
|
|
351
|
+
// 时刻由 `apiKeyExpiresAt` 表达,网页 jwt 自己带 30 天)。
|
|
352
|
+
return { jwt: found.jwt, organizationCode: found.organizationCode };
|
|
353
|
+
};
|
|
354
|
+
}
|
|
355
|
+
/**
|
|
356
|
+
* 轮询等待凭据 —— **本模块唯一的等待逻辑**(会话类与单测共用它,不写第二份)。
|
|
357
|
+
*
|
|
358
|
+
* 语义(每条都有用例钉住):
|
|
359
|
+
* 1. **先读一次再判停止/超时**:`timeoutMs = 0` 时也要给一次机会(否则「刚登完就
|
|
360
|
+
* 超时」这种边界会被判成没登录);同理,用户登完顺手关窗那一刻凭据已在磁盘上,
|
|
361
|
+
* 停止判据必须**后于**读取(详见循环里的注释)。
|
|
362
|
+
* 2. **每轮先实时(CDP)、再磁盘(兜底)**:顺序是语义,不是风格 —— 见文件头
|
|
363
|
+
* 「必须 CDP 实时优先」。⚠️ 磁盘那条腿**不许删**(CDP 不可用的机器上它是唯一出路)。
|
|
364
|
+
* 3. 到点返回 `undefined`,**不抛错**(见 {@link MagicrewBrowserLogin} 接口头)。
|
|
365
|
+
* 4. 已收窗 / 浏览器已退出 ⇒ 立刻 `undefined`(不必耗满预算)。
|
|
366
|
+
* 5. 每轮最多睡到**剩余预算**为止(不越过 deadline 多睡一格)。
|
|
367
|
+
*/
|
|
368
|
+
export function createMagicrewCredentialWaiter(deps) {
|
|
369
|
+
const now = deps.now ?? (() => Date.now());
|
|
370
|
+
const sleep = deps.sleep ?? defaultSleep;
|
|
371
|
+
const interval = normalizePollMs(deps.pollIntervalMs);
|
|
372
|
+
const isStopped = deps.isStopped ?? (() => false);
|
|
373
|
+
const readRealtime = deps.readRealtime;
|
|
374
|
+
/** 实时读尝试了几次 / 最后一次的失败原因(只用于放弃时那一行诊断)。 */
|
|
375
|
+
let realtimeAttempts = 0;
|
|
376
|
+
let lastRealtimeFailure;
|
|
377
|
+
/** 读一拍:**实时优先、磁盘兜底**。 */
|
|
378
|
+
const readOnce = async () => {
|
|
379
|
+
if (readRealtime !== undefined) {
|
|
380
|
+
realtimeAttempts += 1;
|
|
381
|
+
let realtime;
|
|
382
|
+
try {
|
|
383
|
+
realtime = await readRealtime();
|
|
384
|
+
}
|
|
385
|
+
catch (error) {
|
|
386
|
+
// ⚠️ 实时读**绝不许**把等待变成失败:它自己要抛也只是「这拍没读到」。
|
|
387
|
+
realtime = { failure: String(error) };
|
|
388
|
+
}
|
|
389
|
+
if (realtime.credential !== undefined)
|
|
390
|
+
return realtime.credential;
|
|
391
|
+
// 只有**失败**才覆盖原因:`{}` = 「读通了但用户还没登完」,那是正常路径,
|
|
392
|
+
// 拿它盖掉真故障会让放弃时那一行说不出任何有用的话。
|
|
393
|
+
if (realtime.failure !== undefined)
|
|
394
|
+
lastRealtimeFailure = realtime.failure;
|
|
395
|
+
}
|
|
396
|
+
try {
|
|
397
|
+
return await deps.read();
|
|
398
|
+
}
|
|
399
|
+
catch {
|
|
400
|
+
// ⚠️ 读盘失败(文件被浏览器独占 / 权限)**不是**「用户没登录」——
|
|
401
|
+
// 但也不能抛错(那是正常路径):下一轮再试即可。
|
|
402
|
+
return undefined;
|
|
403
|
+
}
|
|
404
|
+
};
|
|
405
|
+
return async (timeoutMs) => {
|
|
406
|
+
const budget = Number.isFinite(timeoutMs) && timeoutMs > 0 ? Math.floor(timeoutMs) : 0;
|
|
407
|
+
const deadline = now() + budget;
|
|
408
|
+
for (;;) {
|
|
409
|
+
/**
|
|
410
|
+
* ① **先读、再判「已收窗」**(顺序是语义,不是风格):用户登完那一刻可能顺手
|
|
411
|
+
* 关掉了窗口,此时 `isStopped()` 为真而凭据**已经**在(实时或磁盘上)—— 先把
|
|
412
|
+
* 停止判据放在读取之前,就会把一次**已成功的登录**误报成 `undefined`。
|
|
413
|
+
*/
|
|
414
|
+
const found = await readOnce();
|
|
415
|
+
if (found !== undefined)
|
|
416
|
+
return found;
|
|
417
|
+
if (isStopped())
|
|
418
|
+
return undefined;
|
|
419
|
+
const remaining = deadline - now();
|
|
420
|
+
if (remaining <= 0)
|
|
421
|
+
break;
|
|
422
|
+
await sleep(Math.max(1, Math.min(interval, remaining)));
|
|
423
|
+
}
|
|
424
|
+
/**
|
|
425
|
+
* ⚠️ 放弃等待时**必须**留一行诊断(真机报障 2026-10-29 的直接教训):
|
|
426
|
+
* 「用户没登」与「我们读的方式坏了」在用户那里同形,只有这一行能分开。
|
|
427
|
+
*/
|
|
428
|
+
if (deps.log !== undefined) {
|
|
429
|
+
deps.log(`[magicrew] CDP 与磁盘都没读到凭据(CDP 尝试 ${realtimeAttempts} 次 / `
|
|
430
|
+
+ `最后一次 CDP 失败原因:${lastRealtimeFailure ?? '(无;说明页面在,只是 localStorage 里还没有凭据 —— 用户没登完)'})`);
|
|
431
|
+
}
|
|
432
|
+
return undefined;
|
|
433
|
+
};
|
|
434
|
+
}
|
|
435
|
+
/**
|
|
436
|
+
* 「**空白/新标签页**」的 URL 形态集合。
|
|
437
|
+
*
|
|
438
|
+
* ⚠️⚠️ **`chrome://newtab/` 不算 `about:blank`**(2026-10-30 四路审计 P1 D-05 修):
|
|
439
|
+
* 实测 `new URL('chrome://newtab/').hostname` = **`'newtab'``**(**非空**)⇒
|
|
440
|
+
* `sameSite('newtab', 'www.letsmagic.cn')` = false ⇒ 旧实现会把它当成
|
|
441
|
+
* 「一个普通页面」⇒ 兜底 `pages[0]` 被导航 ⇒ **冲掉用户正在看的标签页**。
|
|
442
|
+
*
|
|
443
|
+
* ⚠️ 真机实测(2026-10-30 正向审计):带 URL 启动时 CDP 就绪那刻 page URL
|
|
444
|
+
* **已经是**目标 URL;不带 URL 时是 **`chrome://newtab/`**(**不是**
|
|
445
|
+
* `about:blank`)⇒ 「about:blank 竞态」这条 PR 声称的前提**真机未复现**。
|
|
446
|
+
* ⇒ 但**空白页总得处理**:本集合把三种「空白」形态一视同仁。
|
|
447
|
+
*
|
|
448
|
+
* ⚠️⚠️ **判据必须用「前缀」而不是「全等」**(2026-10-30 第二轮审计 P3-1 修):
|
|
449
|
+
* 真机实测的空白页形态**远不止三种**(第二轮审计实测出 5 种漏网):
|
|
450
|
+
* ```
|
|
451
|
+
* chrome://new-tab-page-third-party/ ← 第三方新标签页
|
|
452
|
+
* chrome-search://local-ntp/... ← 本地搜索新标签页
|
|
453
|
+
* edge://newtab/ ← Edge 的新标签页
|
|
454
|
+
* chrome://new-tab-page/?foo=1 ← 带查询串
|
|
455
|
+
* about:blank#x ← 带 fragment
|
|
456
|
+
* ```
|
|
457
|
+
* ⇒ 全等判据 ⇒ 这些**漏掉** ⇒ 用户面对空白首屏、且插件**不导航**。
|
|
458
|
+
* ⇒ 改为「**前缀匹配**」:`about:blank` 走前缀、`chrome://new-tab-page` 与
|
|
459
|
+
* `chrome-search://local-ntp` 与 `edge://newtab` 走前缀。
|
|
460
|
+
*/
|
|
461
|
+
const BLANK_PAGE_URL_PREFIXES = [
|
|
462
|
+
'about:blank',
|
|
463
|
+
'chrome://newtab',
|
|
464
|
+
'chrome://new-tab-page',
|
|
465
|
+
'chrome-search://local-ntp',
|
|
466
|
+
'edge://newtab',
|
|
467
|
+
'brave://newtab',
|
|
468
|
+
'vivaldi://newtab',
|
|
469
|
+
];
|
|
470
|
+
/** 这个 URL 是不是「空白页 / 新标签页」(⇒ 可以安全地导航它)。 */
|
|
471
|
+
export function isBlankPageUrl(url) {
|
|
472
|
+
return BLANK_PAGE_URL_PREFIXES.some((prefix) => url.startsWith(prefix));
|
|
473
|
+
}
|
|
474
|
+
/**
|
|
475
|
+
* 把「初始仍是空白页」的窗口导航到登录页。
|
|
476
|
+
*
|
|
477
|
+
* CDP 就绪早于首屏导航时,启动参数里的 URL 可能尚未落到 page target。
|
|
478
|
+
* 此时不能让用户面对空白页;已有同站点页面则不重复导航。
|
|
479
|
+
*
|
|
480
|
+
* ⚠️⚠️ **失败不抛**(2026-10-30 四路审计 P1 D-06 修):
|
|
481
|
+
* 旧实现抛错 ⇒ 冒泡到 `createChromiumMagicrewLogin` 的 catch ⇒
|
|
482
|
+
* `session.dispose()` ⇒ `loginViaBrowser` 抛 ⇒ RPC 层 `failLogin` ⇒
|
|
483
|
+
* **占位账号被删、整条登录腿失败** —— 而此时**窗口还开着**、用户完全可以
|
|
484
|
+
* 自己操作 ⇒ 用户看到「登录失败」却明明有个窗口在。
|
|
485
|
+
*
|
|
486
|
+
* ⇒ 现在改成:**导航失败只记一条 warn,登录流程继续**(窗口留着,用户可以
|
|
487
|
+
* 自己在里面登录;凭据等待循环照样能读到)。
|
|
488
|
+
* ⚠️ 与同文件既有纪律同口径:`attemptCredentialViaCdp` 是「任何一步失败都
|
|
489
|
+
* **返回**不抛」。
|
|
490
|
+
* ⚠️ **唯一的例外**:`cdp === undefined`(通道压根没就绪)仍然抛 —— 那时连
|
|
491
|
+
* 「窗口开着」都不成立。
|
|
492
|
+
*
|
|
493
|
+
* @param url - 登录页 URL。
|
|
494
|
+
* @param log - 诊断出口(缺省不记)。
|
|
495
|
+
*/
|
|
496
|
+
export async function ensureMagicrewLoginPage(session, url, log) {
|
|
497
|
+
const cdp = session.cdp;
|
|
498
|
+
if (cdp === undefined)
|
|
499
|
+
throw new Error('超级麦吉: 浏览器调试通道未就绪,无法打开登录页');
|
|
500
|
+
let targets;
|
|
501
|
+
try {
|
|
502
|
+
targets = await cdp.send('Target.getTargets', {}, CDP_CREDENTIAL_TIMEOUT_MS);
|
|
503
|
+
}
|
|
504
|
+
catch (error) {
|
|
505
|
+
// ⚠️ 同上:**不抛**(窗口开着,用户可自己操作)。
|
|
506
|
+
log?.(`[magicrew] 读取浏览器页面列表失败,登录页未自动打开:${String(error)}`);
|
|
507
|
+
return;
|
|
508
|
+
}
|
|
509
|
+
const pages = (targets.targetInfos ?? []).filter((info) => (info.type === 'page' && typeof info.targetId === 'string' && typeof info.url === 'string'));
|
|
510
|
+
if (pages.some((page) => sameSite(hostnameOf(page.url), hostnameOf(url))))
|
|
511
|
+
return;
|
|
512
|
+
// ⚠️⚠️ **只导航「空白页」**(2026-10-30 审计 P1 D-05 修):
|
|
513
|
+
// 旧实现是 `pages.find(about:blank) ?? pages[0]` ⇒ 兜底会**抢走用户正在看
|
|
514
|
+
// 的标签页**(实测 `chrome://newtab/` 的 hostname 是 `'newtab'`、非空 ⇒
|
|
515
|
+
// 它既不是 `about:blank`、也不是同站点 ⇒ 落到 `pages[0]` 被导航)。
|
|
516
|
+
// ⇒ 现在**只**导航三种空白形态;**没有空白页就不导航**(宁可让用户自己
|
|
517
|
+
// 切到登录页,也不冲掉他的标签页)。
|
|
518
|
+
const blank = pages.find((page) => isBlankPageUrl(page.url));
|
|
519
|
+
if (blank === undefined) {
|
|
520
|
+
log?.('[magicrew] 没有找到空白页,未自动打开登录页(请手动切换到登录页)');
|
|
521
|
+
return;
|
|
522
|
+
}
|
|
523
|
+
let attached;
|
|
524
|
+
try {
|
|
525
|
+
attached = await cdp.send('Target.attachToTarget', { targetId: blank.targetId, flatten: true }, CDP_CREDENTIAL_TIMEOUT_MS);
|
|
526
|
+
}
|
|
527
|
+
catch (error) {
|
|
528
|
+
log?.(`[magicrew] 连接登录页面失败,登录页未自动打开:${String(error)}`);
|
|
529
|
+
return;
|
|
530
|
+
}
|
|
531
|
+
if (typeof attached.sessionId !== 'string' || attached.sessionId.length === 0) {
|
|
532
|
+
log?.('[magicrew] 无法连接登录页面,登录页未自动打开');
|
|
533
|
+
return;
|
|
534
|
+
}
|
|
535
|
+
const sessionId = attached.sessionId;
|
|
536
|
+
try {
|
|
537
|
+
const navigated = await cdp.send('Page.navigate', { url }, CDP_NAVIGATE_TIMEOUT_MS, sessionId);
|
|
538
|
+
if (typeof navigated.errorText === 'string' && navigated.errorText.length > 0) {
|
|
539
|
+
// ⚠️ **不抛**(同本函数头部注释)—— 只记一条诊断。
|
|
540
|
+
log?.(`[magicrew] 打开登录页失败(${navigated.errorText}),窗口仍开着,可手动操作`);
|
|
541
|
+
}
|
|
542
|
+
}
|
|
543
|
+
catch (error) {
|
|
544
|
+
// ⚠️ **不抛**(同本函数头部注释)。
|
|
545
|
+
log?.(`[magicrew] 打开登录页失败,窗口仍开着,可手动操作:${String(error)}`);
|
|
546
|
+
}
|
|
547
|
+
finally {
|
|
548
|
+
try {
|
|
549
|
+
await cdp.send('Target.detachFromTarget', { sessionId }, CDP_CREDENTIAL_TIMEOUT_MS);
|
|
550
|
+
}
|
|
551
|
+
catch {
|
|
552
|
+
// 会话关闭时连接可能已断开;导航结果不能被清理错误覆盖。
|
|
553
|
+
}
|
|
554
|
+
}
|
|
555
|
+
}
|
|
556
|
+
/** 一个已起好浏览器的网页登录会话(实现 {@link MagicrewBrowserLogin})。 */
|
|
557
|
+
class ChromiumProfileLogin {
|
|
558
|
+
session;
|
|
559
|
+
closed = false;
|
|
560
|
+
wait;
|
|
561
|
+
defaultTimeoutMs;
|
|
562
|
+
constructor(session, deps, defaultTimeoutMs) {
|
|
563
|
+
this.session = session;
|
|
564
|
+
this.defaultTimeoutMs = defaultTimeoutMs;
|
|
565
|
+
// ⚠️ `isStopped` 由**本类**提供(而不是让调用方再传一次):收窗后必须立刻放弃
|
|
566
|
+
// 等待,否则 `close()` 之后 `waitForCredential` 还会空转到超时。
|
|
567
|
+
this.wait = createMagicrewCredentialWaiter({
|
|
568
|
+
...deps,
|
|
569
|
+
isStopped: () => this.closed || session.exited,
|
|
570
|
+
});
|
|
571
|
+
}
|
|
572
|
+
/**
|
|
573
|
+
* 收掉浏览器(**幂等**)。
|
|
574
|
+
*
|
|
575
|
+
* ⚠️ 走 `ChromiumSession.dispose()`:它内部是 `kill()`(`taskkill /T /F`,同步等它
|
|
576
|
+
* 退干净)+ 临时 profile 的**退避重试删除**。不要在别处自己 `rmSync` ——
|
|
577
|
+
* 那些「每条都是真实缺陷换来的」纪律就在那里(见 `chromium-session.ts` 模块头)。
|
|
578
|
+
* ⚠️ 收尾失败**不抛**:调用点在 `finally`,抛错会盖掉真正的登录结果。
|
|
579
|
+
*/
|
|
580
|
+
close() {
|
|
581
|
+
if (this.closed)
|
|
582
|
+
return;
|
|
583
|
+
this.closed = true;
|
|
584
|
+
try {
|
|
585
|
+
this.session.dispose();
|
|
586
|
+
}
|
|
587
|
+
catch {
|
|
588
|
+
// 尽力而为:窗口/进程/目录各自都有兜底(系统会回收临时目录)。
|
|
589
|
+
}
|
|
590
|
+
}
|
|
591
|
+
async waitForCredential(timeoutMs = this.defaultTimeoutMs) {
|
|
592
|
+
return await this.wait(timeoutMs);
|
|
593
|
+
}
|
|
594
|
+
}
|
|
595
|
+
/**
|
|
596
|
+
* 起浏览器并打开 magicrew 网页登录页(**独立 profile、可见窗口**)。
|
|
597
|
+
*
|
|
598
|
+
* 找不到浏览器 ⇒ 抛 {@link BrowserDeploymentError}(`deployKind: 'browser-not-found'`),
|
|
599
|
+
* 文案里带 {@link browserNotFoundMessage} 的分平台提示与本次**真的尝试过**的候选清单。
|
|
600
|
+
*
|
|
601
|
+
* ⚠️ 这是**唯一**会 `spawn` 浏览器的函数;单测只允许以
|
|
602
|
+
* `resolveBrowser: () => undefined`(测找不到那条路)或干脆不调它。
|
|
603
|
+
*/
|
|
604
|
+
export async function createChromiumMagicrewLogin(url, deps = {}) {
|
|
605
|
+
const hostname = hostnameOf(url);
|
|
606
|
+
if (hostname.length === 0) {
|
|
607
|
+
// ⚠️ 非法 origin 必须**立刻**报错,不能起一个浏览器然后永远等不到凭据
|
|
608
|
+
// (那两件事在用户眼里同形,而原因完全不同)。
|
|
609
|
+
throw new Error(`超级麦吉: 网页登录地址非法(${JSON.stringify(url)})—— 无法定位 localStorage`);
|
|
610
|
+
}
|
|
611
|
+
/** 两种站点写法(`www.` 前后),CDP 与磁盘两条腿共用同一口径。 */
|
|
612
|
+
const hostnames = siteHostnames(hostname);
|
|
613
|
+
const executable = deps.executablePath ?? (deps.resolveBrowser ?? findBrowserExecutable)();
|
|
614
|
+
if (executable === undefined || executable.length === 0) {
|
|
615
|
+
/**
|
|
616
|
+
* ⚠️⚠️ 文案**必须**由 {@link browserNotFoundMessage} 生成(不自己编):
|
|
617
|
+
* 它按平台说人话(macOS 上没有 scoop、`chrome.exe` 也不是那个文件名),
|
|
618
|
+
* 并回显「本进程看到的候选清单」——那是用户唯一能自查的东西。
|
|
619
|
+
*
|
|
620
|
+
* ⚠️ `tried` 只列**真的会被尝试**的候选(绝对路径 + 非空):`findBrowserExecutable`
|
|
621
|
+
* 会跳过相对路径(空环境变量会拼出 `Google\Chrome\Application\chrome.exe`),
|
|
622
|
+
* 而 `browserCandidates()` 原样返回它们 ⇒ 不过滤就会宣称「已尝试 N 条」
|
|
623
|
+
* 而其中有几条根本没试过(该纪律的取证见 `chromium-session.ts` 同名注释)。
|
|
624
|
+
*
|
|
625
|
+
* ⚠️ 环境变量名用宿主共享的那个(`ZCODE_CHROME_PATH`):`browserCandidates`
|
|
626
|
+
* **只读它**,换一个名字写文案等于骗用户去设一个不会被读的变量。
|
|
627
|
+
*/
|
|
628
|
+
throw new BrowserDeploymentError('超级麦吉: 找不到可用的浏览器(网页版登录需要本机有一个 Chromium 内核浏览器)。'
|
|
629
|
+
+ browserNotFoundMessage(deps.platform ?? process.platform, 'ZCODE_CHROME_PATH', {
|
|
630
|
+
tried: browserCandidates({ platform: deps.platform })
|
|
631
|
+
.filter((candidate) => candidate.length > 0 && isAbsolute(candidate)),
|
|
632
|
+
overrideValue: process.env.ZCODE_CHROME_PATH,
|
|
633
|
+
}), 'browser-not-found');
|
|
634
|
+
}
|
|
635
|
+
const session = new ChromiumSession({
|
|
636
|
+
executablePath: executable,
|
|
637
|
+
/**
|
|
638
|
+
* ⚠️⚠️ **窗口必须可见**(`hideWindow: false`):用户要在这个窗口里自己登录。
|
|
639
|
+
* 缺省是 `true`(把窗口移出屏幕 / 进不了任务栏)—— 那是给 captcha 用的,
|
|
640
|
+
* 用在这里等于「点了没反应」。
|
|
641
|
+
*/
|
|
642
|
+
hideWindow: false,
|
|
643
|
+
windowSize: '1024,800',
|
|
644
|
+
// 每次登录一个**一次性** profile(理由见文件头)。
|
|
645
|
+
profilePrefix: 'magicrew-login-',
|
|
646
|
+
initialUrl: url,
|
|
647
|
+
...deps.readyTimeoutMs === undefined ? {} : { readyTimeoutMs: deps.readyTimeoutMs },
|
|
648
|
+
label: '超级麦吉',
|
|
649
|
+
notFoundHint: '(网页版登录需要本机有一个 Chromium 内核浏览器)',
|
|
650
|
+
...deps.log === undefined ? {} : { log: deps.log },
|
|
651
|
+
});
|
|
652
|
+
try {
|
|
653
|
+
await session.start();
|
|
654
|
+
// ⚠️⚠️ **导航失败不阻断登录**(2026-10-30 四路审计 P1 D-06 修):
|
|
655
|
+
// 旧实现在这里抛错 ⇒ catch ⇒ dispose ⇒ `loginViaBrowser` 抛 ⇒ RPC 层
|
|
656
|
+
// `failLogin` ⇒ **占位账号被删**;而此时**窗口还开着**、用户完全可以
|
|
657
|
+
// 自己登录 ⇒ 用户看到「登录失败」却明明有个窗口在。
|
|
658
|
+
// ⇒ `ensureMagicrewLoginPage` 现在**自己**吞掉导航失败(只记 warn),
|
|
659
|
+
// 这里只保留一个**兜底 try**(防未来实现变回抛错时又删号)。
|
|
660
|
+
try {
|
|
661
|
+
await (deps.ensureLoginPage ?? ensureMagicrewLoginPage)(session, url, deps.log);
|
|
662
|
+
}
|
|
663
|
+
catch (error) {
|
|
664
|
+
deps.log?.(`[magicrew] 登录页未自动打开,窗口仍开着可手动操作:${String(error)}`);
|
|
665
|
+
}
|
|
666
|
+
}
|
|
667
|
+
catch (error) {
|
|
668
|
+
/**
|
|
669
|
+
* ⚠️ 起不来时**必须** dispose:`launch()` 失败路径只 `kill()` 进程树,
|
|
670
|
+
* 临时 profile 目录由 `dispose()` 才删(它内部有退避重试)。
|
|
671
|
+
* 不调就会在 `%TEMP%` 里留下一个 `magicrew-login-*` 目录(每次失败一个)。
|
|
672
|
+
*/
|
|
673
|
+
session.dispose();
|
|
674
|
+
throw error;
|
|
675
|
+
}
|
|
676
|
+
const profileDir = session.userDataDir ?? '';
|
|
677
|
+
const read = createProfileCredentialReader(profileDir, hostname, {
|
|
678
|
+
...deps.readCreds === undefined ? {} : { readCreds: deps.readCreds },
|
|
679
|
+
});
|
|
680
|
+
/**
|
|
681
|
+
* ⚠️⚠️ **实时(CDP)是主路径,磁盘是兜底**(见文件头「必须 CDP 实时优先」):
|
|
682
|
+
* 只读磁盘会出现「用户明明登录成功、插件白转 4 分钟」——Chromium 不关窗不落盘。
|
|
683
|
+
*
|
|
684
|
+
* `hostnames` 给两种写法(`www.letsmagic.cn` / `letsmagic.cn`),命中判据是
|
|
685
|
+
* **同站点**而不是全串等值:登录成功后 URL 会变成
|
|
686
|
+
* `/global/super/workspace/…`(用户截图里的真实形态)。
|
|
687
|
+
*/
|
|
688
|
+
const readRealtime = deps.readRealtime
|
|
689
|
+
?? ((target) => readCredentialViaCdpDetailed(target, hostnames));
|
|
690
|
+
return new ChromiumProfileLogin(session, {
|
|
691
|
+
read,
|
|
692
|
+
readRealtime: () => readRealtime(session),
|
|
693
|
+
...deps.now === undefined ? {} : { now: deps.now },
|
|
694
|
+
...deps.sleep === undefined ? {} : { sleep: deps.sleep },
|
|
695
|
+
...deps.pollIntervalMs === undefined ? {} : { pollIntervalMs: deps.pollIntervalMs },
|
|
696
|
+
...deps.log === undefined ? {} : { log: deps.log },
|
|
697
|
+
}, normalizeTimeoutMs(deps.timeoutMs));
|
|
698
|
+
}
|
|
699
|
+
/**
|
|
700
|
+
* 起浏览器打开 magicrew 登录页(独立 profile),返回一个「等用户登完」的会话。
|
|
701
|
+
*
|
|
702
|
+
* ## ⚠️ 打开的 URL 是 `product.webOrigin`,**不是** `product.host`
|
|
703
|
+
*
|
|
704
|
+
* 理由见文件头第二段(API 子域上用户根本没法登录)。这一条有单测钉住
|
|
705
|
+
* (断言注入的 `sessionFactory` 收到的就是 `webOrigin`),因为写错了**不会报错**、
|
|
706
|
+
* 只会永远等不到凭据。
|
|
707
|
+
*
|
|
708
|
+
* @example
|
|
709
|
+
* ```ts
|
|
710
|
+
* const login = await startMagicrewBrowserLogin({ product: MAGICREW })
|
|
711
|
+
* try {
|
|
712
|
+
* const credential = await login.waitForCredential(120_000)
|
|
713
|
+
* } finally {
|
|
714
|
+
* login.close() // ⚠️ 必须:否则窗口与进程残留
|
|
715
|
+
* }
|
|
716
|
+
* ```
|
|
717
|
+
*/
|
|
718
|
+
export async function startMagicrewBrowserLogin(options = {}) {
|
|
719
|
+
const product = options.product ?? MAGICREW;
|
|
720
|
+
const timeoutMs = normalizeTimeoutMs(options.timeoutMs);
|
|
721
|
+
/**
|
|
722
|
+
* ⚠️⚠️ **网页域 + `/login` 路径**(见文件头)。两个都要对:
|
|
723
|
+
* - `product.host` 是 API 子域 `i-magic-service.letsmagic.cn` —— 用户不会在那上面
|
|
724
|
+
* 登录,localStorage 也不会在那个 origin 下有条目;
|
|
725
|
+
* - **光有裸域是首页、不是登录页**(2026-10-29 用户实测报障:弹出
|
|
726
|
+
* `https://www.letsmagic.cn/` 而参考实现弹的是 `/login?...`,用户在那页上
|
|
727
|
+
* 找不到登录框)。
|
|
728
|
+
* ⚠️ **不带邀请码**(用户 2026-10-29 明确要求):`?invitation=` 会把新注册的号
|
|
729
|
+
* 挂在某个邀请码下。本插件不代用户决定属于谁 —— 要带就由他自己在网页里填。
|
|
730
|
+
*/
|
|
731
|
+
const url = `${product.webOrigin}/login`;
|
|
732
|
+
const factory = options.sessionFactory
|
|
733
|
+
?? ((target) => createChromiumMagicrewLogin(target, {
|
|
734
|
+
product,
|
|
735
|
+
timeoutMs,
|
|
736
|
+
...options.log === undefined ? {} : { log: options.log },
|
|
737
|
+
}));
|
|
738
|
+
return await factory(url);
|
|
739
|
+
}
|
|
740
|
+
//# sourceMappingURL=magicrew-browser-login.js.map
|