@xixka/dsh-hub 0.4.10 → 0.4.12
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/lib/atomcode-auth.js +3 -3
- package/lib/atomcode-auth.js.map +1 -1
- package/lib/atomcode-credits.js +3 -3
- package/lib/atomcode-credits.js.map +1 -1
- package/lib/atomcode-product.d.ts +8 -0
- package/lib/atomcode-product.d.ts.map +1 -1
- package/lib/atomcode-product.js +10 -0
- package/lib/atomcode-product.js.map +1 -1
- package/lib/chromium-session.d.ts +109 -1
- package/lib/chromium-session.d.ts.map +1 -1
- package/lib/chromium-session.js +362 -23
- package/lib/chromium-session.js.map +1 -1
- package/lib/doubao-login.d.ts.map +1 -1
- package/lib/doubao-login.js +46 -53
- package/lib/doubao-login.js.map +1 -1
- package/lib/doubao-signin.d.ts.map +1 -1
- package/lib/doubao-signin.js +23 -38
- package/lib/doubao-signin.js.map +1 -1
- package/lib/index.d.ts +1 -0
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +5 -0
- package/lib/index.js.map +1 -1
- package/lib/llm-register-compat.d.ts +50 -0
- package/lib/llm-register-compat.d.ts.map +1 -1
- package/lib/llm-register-compat.js +78 -1
- package/lib/llm-register-compat.js.map +1 -1
- package/lib/login.d.ts +6 -13
- package/lib/login.d.ts.map +1 -1
- package/lib/login.js +8 -61
- package/lib/login.js.map +1 -1
- package/lib/loomy-adapter.d.ts.map +1 -1
- package/lib/loomy-adapter.js +73 -4
- package/lib/loomy-adapter.js.map +1 -1
- package/lib/openai-compat.d.ts.map +1 -1
- package/lib/openai-compat.js +6 -0
- package/lib/openai-compat.js.map +1 -1
- package/lib/raccoon-account-queue.d.ts +15 -0
- package/lib/raccoon-account-queue.d.ts.map +1 -0
- package/lib/raccoon-account-queue.js +59 -0
- package/lib/raccoon-account-queue.js.map +1 -0
- package/lib/raccoon-adapter.d.ts +9 -0
- package/lib/raccoon-adapter.d.ts.map +1 -1
- package/lib/raccoon-adapter.js +269 -190
- package/lib/raccoon-adapter.js.map +1 -1
- package/lib/system-ca-trust.d.ts +6 -0
- package/lib/system-ca-trust.d.ts.map +1 -0
- package/lib/system-ca-trust.js +88 -0
- package/lib/system-ca-trust.js.map +1 -0
- package/package.json +1 -1
package/lib/chromium-session.js
CHANGED
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
* ⚠️ 浏览器**发现**({@link browserCandidates} 一族)与**窗口隐藏**也在这里:
|
|
29
29
|
* 它们回答的是「哪个 chromium 可用」「怎么让它别打扰用户」,同属浏览器设施。
|
|
30
30
|
*/
|
|
31
|
-
import { spawn, spawnSync } from 'node:child_process';
|
|
31
|
+
import { spawn, spawnSync, execFileSync } from 'node:child_process';
|
|
32
32
|
import { existsSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
|
|
33
33
|
import { createServer } from 'node:net';
|
|
34
34
|
import { homedir, tmpdir } from 'node:os';
|
|
@@ -554,8 +554,23 @@ function windowsBrowserCandidates(env, home,
|
|
|
554
554
|
*/
|
|
555
555
|
exists = existsSync) {
|
|
556
556
|
const localAppData = env.LOCALAPPDATA ?? '';
|
|
557
|
-
|
|
558
|
-
|
|
557
|
+
/**
|
|
558
|
+
* ⚠️ PROGRAMFILES / PROGRAMFILES(X86) 缺失时给**标准默认值**(PR-A 随豆包收编补):
|
|
559
|
+
*
|
|
560
|
+
* 旧实现 `env.PROGRAMFILES ?? ''` 会在变量被清掉(沙箱 / 被改写的异常环境)时
|
|
561
|
+
* 拼出 `Google\Chrome\Application\chrome.exe` 这种**相对路径** —— isAbsolute
|
|
562
|
+
* 过滤后这条腿**恒不可能命中**。豆包收编前它的私有链一直是
|
|
563
|
+
* `env['ProgramFiles'] ?? 'C:\\Program Files'`(带默认值),收编后这份语义
|
|
564
|
+
* 必须进共享链,否则「env 缺失 + Chrome 装在标准位置」的机器上豆包的
|
|
565
|
+
* 解析结果会从 legacy 漂成 undefined(存量契约,见
|
|
566
|
+
* `tests/unit/doubao-browser-discovery.spec.ts`「存量候选链逐字节不变」)。
|
|
567
|
+
*
|
|
568
|
+
* ⚠️ `localAppData` **刻意不给默认值**:`browserCandidates` 头部「坑 1」的
|
|
569
|
+
* 回归判据(`zcode-browser-detection.spec.ts`「相对路径候选确实存在」)
|
|
570
|
+
* 靠它锁住「空环境 ⇒ 相对路径 ⇒ 被 isAbsolute 挡掉」这条防线。
|
|
571
|
+
*/
|
|
572
|
+
const programFiles = env.PROGRAMFILES ?? 'C:\\Program Files';
|
|
573
|
+
const programFilesX86 = env['PROGRAMFILES(X86)'] ?? 'C:\\Program Files (x86)';
|
|
559
574
|
const scoopRoot = scoopRootFromPath(env, exists);
|
|
560
575
|
const defaultScoopRoot = join(home, 'scoop');
|
|
561
576
|
/**
|
|
@@ -700,6 +715,119 @@ function linuxBrowserCandidates(home) {
|
|
|
700
715
|
posix.join(home, '.local', 'share', 'flatpak', 'exports', 'bin', 'org.chromium.Chromium'),
|
|
701
716
|
];
|
|
702
717
|
}
|
|
718
|
+
/**
|
|
719
|
+
* 从 Windows 注册表取**系统默认浏览器**的可执行文件路径(一处定义,多方复用)。
|
|
720
|
+
*
|
|
721
|
+
* ## 为什么搬到共享层(PR-A,2026-11-18)
|
|
722
|
+
*
|
|
723
|
+
* 原实现长在 `src/login.ts`(无痕开窗用);后来「浏览器登录候选链」这条线
|
|
724
|
+
*(`browserCandidates`,六个登录模块共用)发现一个缺口:**用户默认浏览器
|
|
725
|
+
* 不在候选链里**(360 / QQ / 便携 Chrome 等),最后落到的反而是 Edge 兜底。
|
|
726
|
+
* 注册表是默认浏览器的唯一真相源 ⇒ 这份读取必须在共享层**只定义一次**
|
|
727
|
+
*(`login.ts` 的无痕开窗与本候选链共用同一份,不再抄第二份 ——
|
|
728
|
+
* 「一文件两套同义判据」的反模式见 `docs/agent-notes/misc.md`)。
|
|
729
|
+
*
|
|
730
|
+
* 读法:`UrlAssociations\https\UserChoice` 拿 ProgId,再读该 ProgId 的
|
|
731
|
+
* `shell\open\command`(ProgId 可能注册在 HKCR / HKCU / HKLM 三处,逐个试)。
|
|
732
|
+
*
|
|
733
|
+
* @returns 可执行文件路径;非 Windows / 读不到 / 文件不存在时 `undefined`
|
|
734
|
+
*(调用方静默落回后续候选,**不报错**)。
|
|
735
|
+
*/
|
|
736
|
+
let defaultBrowserExecutableCache = null;
|
|
737
|
+
export function defaultBrowserExecutable() {
|
|
738
|
+
if (process.platform !== 'win32')
|
|
739
|
+
return undefined;
|
|
740
|
+
// ⚠️ 进程内 memo:注册表在进程生命周期内不会漂;`browserCandidates()`
|
|
741
|
+
// 每次解析都会走到这里,不能让每次都付两次 `reg query` 的子进程成本。
|
|
742
|
+
if (defaultBrowserExecutableCache !== null)
|
|
743
|
+
return defaultBrowserExecutableCache;
|
|
744
|
+
const resolved = queryDefaultBrowserExecutable();
|
|
745
|
+
defaultBrowserExecutableCache = resolved ?? null;
|
|
746
|
+
return resolved;
|
|
747
|
+
}
|
|
748
|
+
function queryDefaultBrowserExecutable() {
|
|
749
|
+
// ⚠️ 只用 `reg.exe` 而不引第三方依赖:注册表读取是本功能唯一的平台相关调用,
|
|
750
|
+
// 为它加一个 native 依赖不划算(且本插件的 peer 约束不允许)。
|
|
751
|
+
const query = (key, value) => {
|
|
752
|
+
try {
|
|
753
|
+
const out = execFileSync('reg', ['query', key, '/v', value], {
|
|
754
|
+
encoding: 'utf8', timeout: 5000, windowsHide: true,
|
|
755
|
+
});
|
|
756
|
+
// 形如:` ProgId REG_SZ 360ChromeXURL`
|
|
757
|
+
const m = /REG_SZ\s+(.+?)\s*$/m.exec(out);
|
|
758
|
+
return m?.[1]?.trim();
|
|
759
|
+
}
|
|
760
|
+
catch {
|
|
761
|
+
return undefined;
|
|
762
|
+
}
|
|
763
|
+
};
|
|
764
|
+
const progId = query('HKCU\\SOFTWARE\\Microsoft\\Windows\\Shell\\Associations\\UrlAssociations\\https\\UserChoice', 'ProgId');
|
|
765
|
+
if (progId === undefined || progId.length === 0)
|
|
766
|
+
return undefined;
|
|
767
|
+
// ⚠️ 三个位置都要试:`UserChoice` 的 ProgId 可能只注册在 HKCR(合并视图)
|
|
768
|
+
// 或 HKCU\Software\Classes(用户级安装,本机 360 就是这种)。
|
|
769
|
+
for (const root of [
|
|
770
|
+
`HKCR\\${progId}\\shell\\open\\command`,
|
|
771
|
+
`HKCU\\SOFTWARE\\Classes\\${progId}\\shell\\open\\command`,
|
|
772
|
+
`HKLM\\SOFTWARE\\Classes\\${progId}\\shell\\open\\command`,
|
|
773
|
+
]) {
|
|
774
|
+
try {
|
|
775
|
+
const out = execFileSync('reg', ['query', root, '/ve'], {
|
|
776
|
+
encoding: 'utf8', timeout: 5000, windowsHide: true,
|
|
777
|
+
});
|
|
778
|
+
// 形如:` (Default) REG_SZ "C:\...\360ChromeX.exe" -- "%1"`
|
|
779
|
+
const m = /REG_SZ\s+(.+?)\s*$/m.exec(out);
|
|
780
|
+
const raw = m?.[1];
|
|
781
|
+
if (raw === undefined)
|
|
782
|
+
continue;
|
|
783
|
+
// 取命令行里的**第一个**被引号包裹的路径;没有引号则取到第一个空格前。
|
|
784
|
+
const quoted = /^"([^"]+)"/.exec(raw);
|
|
785
|
+
const exe = quoted?.[1] ?? raw.split(' ')[0];
|
|
786
|
+
if (exe !== undefined && exe.length > 0 && existsSync(exe))
|
|
787
|
+
return exe;
|
|
788
|
+
}
|
|
789
|
+
catch { /* 试下一个位置 */ }
|
|
790
|
+
}
|
|
791
|
+
return undefined;
|
|
792
|
+
}
|
|
793
|
+
/**
|
|
794
|
+
* 「系统默认浏览器」档的 **chromium 内核判据**(静态,零成本)。
|
|
795
|
+
*
|
|
796
|
+
* ⚠️⚠️ 为什么是**allowlist(白名单)而不是 denylist**:
|
|
797
|
+
*
|
|
798
|
+
* - 默认浏览器可能是 Firefox(Gecko)/ Waterfox 乃至任何壳。把未知名字当
|
|
799
|
+
* chromium 收进候选 ⇒ spawn 一个不吃 chromium 参数的进程,失败形态更迷惑。
|
|
800
|
+
* - 反方向(把 360Chrome 误判成非 chromium ⇒ 跳过该档)只是**落回现状**
|
|
801
|
+
* (Edge 兜底),零回归。
|
|
802
|
+
* - 任务约束「优先静态判据」:spawn `--version` 探测有启动成本(且对
|
|
803
|
+
* Chrome++ 这类中继 launcher 还会得到**误导性**应答),只在名字确实认不出
|
|
804
|
+
* 时才值得 —— 而本判据的语义正是「认不出就跳过」。
|
|
805
|
+
*
|
|
806
|
+
* 判据用 `basename`(大小写不敏感):对 `Microsoft\Edge\…`、scoop 布局、
|
|
807
|
+
* 便携版目录都成立;macOS 的无扩展名二进制(`Google Chrome` / `Microsoft Edge`)
|
|
808
|
+
* 也一并覆盖(与 {@link isEdgeExecutable} 的命名口径一致)。
|
|
809
|
+
*/
|
|
810
|
+
const CHROMIUM_FAMILY_EXECUTABLE_BASENAMES = new Set([
|
|
811
|
+
'chrome.exe',
|
|
812
|
+
'new_chrome.exe',
|
|
813
|
+
'chromium.exe',
|
|
814
|
+
'msedge.exe',
|
|
815
|
+
'brave.exe',
|
|
816
|
+
'vivaldi.exe',
|
|
817
|
+
'opera.exe',
|
|
818
|
+
'google chrome',
|
|
819
|
+
'chromium',
|
|
820
|
+
'microsoft edge',
|
|
821
|
+
'brave browser',
|
|
822
|
+
// 国内第三方 chromium 内核(Chrome++ 生态的常见宿主)。
|
|
823
|
+
'360chrome.exe',
|
|
824
|
+
'360chromex.exe',
|
|
825
|
+
'360chromeenterprise.exe',
|
|
826
|
+
'qqbrowser.exe',
|
|
827
|
+
]);
|
|
828
|
+
export function isChromiumFamilyExecutable(executable) {
|
|
829
|
+
return CHROMIUM_FAMILY_EXECUTABLE_BASENAMES.has(basename(executable).toLowerCase());
|
|
830
|
+
}
|
|
703
831
|
/**
|
|
704
832
|
* 浏览器可执行文件的**候选链**(按优先级,`ZCODE_CHROME_PATH` 恒排第一)。
|
|
705
833
|
*
|
|
@@ -740,6 +868,22 @@ export function browserCandidates(input = {}) {
|
|
|
740
868
|
const platform = input.platform ?? process.platform;
|
|
741
869
|
const env = input.env ?? process.env;
|
|
742
870
|
const home = input.home ?? homedir();
|
|
871
|
+
/**
|
|
872
|
+
* ★ 「系统默认浏览器」档(PR-A):只参与 **win32** 分支。
|
|
873
|
+
*
|
|
874
|
+
* - 默认浏览器是 Windows 注册表概念;macOS / Linux 各自的「默认浏览器」
|
|
875
|
+
* 机制(LaunchServices / xdg-settings)不共享这份读取,也不在本档范围。
|
|
876
|
+
* - 注册表读不到 / 非 chromium 内核(Firefox 等)⇒ 静默落回后续候选,
|
|
877
|
+
* 零行为变化。
|
|
878
|
+
* - ⚠️ 内核判据在 {@link isChromiumFamilyExecutable}(静态白名单,一处定义)。
|
|
879
|
+
*/
|
|
880
|
+
const defaultBrowserTier = [];
|
|
881
|
+
if (platform === 'win32') {
|
|
882
|
+
const resolved = (input.defaultBrowser ?? defaultBrowserExecutable)();
|
|
883
|
+
if (resolved !== undefined && resolved.length > 0 && isChromiumFamilyExecutable(resolved)) {
|
|
884
|
+
defaultBrowserTier.push(resolved);
|
|
885
|
+
}
|
|
886
|
+
}
|
|
743
887
|
let candidates;
|
|
744
888
|
if (platform === 'darwin') {
|
|
745
889
|
candidates = macBrowserCandidates(home);
|
|
@@ -749,8 +893,32 @@ export function browserCandidates(input = {}) {
|
|
|
749
893
|
}
|
|
750
894
|
else {
|
|
751
895
|
candidates = windowsBrowserCandidates(env, home, input.exists ?? existsSync);
|
|
896
|
+
/**
|
|
897
|
+
* 插入位置:**Brave 之后、Edge 兜底之前**(定位用 `isEdgeExecutable`,
|
|
898
|
+
* Edge 三条是链尾 ⑦ 档)。位置语义:Edge 是最后一道兜底,而「默认浏览器」
|
|
899
|
+
* 是用户亲口指定的意愿,理应压过 Edge;但任何**已知的通用 chromium 安装
|
|
900
|
+
* 位置**(scoop / Chrome / Chromium / Brave 的标准位置)都比「用户碰巧把
|
|
901
|
+
* 默认设成了什么」更可预期,不该被它压过 —— 这正是本缺陷(默认浏览器
|
|
902
|
+
* 不被认、落到 Edge)要修的那一格。
|
|
903
|
+
*
|
|
904
|
+
* ⚠️ 去重:默认浏览器可能就是链里已有的那条(最常见:默认 = Edge)。
|
|
905
|
+
* 重复入链不会改变解析结果(先到先得),只会让「已尝试」清单把同一条
|
|
906
|
+
* 路径**列两遍** —— 用户以为扫了两个地方(IKQ4JN 文案审计的同型问题)。
|
|
907
|
+
*/
|
|
908
|
+
const tier = defaultBrowserTier[0];
|
|
909
|
+
if (tier !== undefined && !candidates.some((c) => winPathEquals(c, tier))) {
|
|
910
|
+
const firstEdge = candidates.findIndex((c) => isEdgeExecutable(c));
|
|
911
|
+
candidates.splice(firstEdge === -1 ? candidates.length : firstEdge, 0, tier);
|
|
912
|
+
}
|
|
752
913
|
}
|
|
753
|
-
|
|
914
|
+
/**
|
|
915
|
+
* ⚠️ 渠道专属候选排在环境变量覆盖**之后**、通用链之前(顺序契约见
|
|
916
|
+
* `channelCandidates` 入口注释);多条时保持调用方给定的相对顺序。
|
|
917
|
+
*/
|
|
918
|
+
const channelCandidates = (input.channelCandidates ?? []).filter((channel) => channel.length > 0);
|
|
919
|
+
if (channelCandidates.length > 0)
|
|
920
|
+
candidates.unshift(...channelCandidates);
|
|
921
|
+
const override = env[input.overrideEnvName ?? 'ZCODE_CHROME_PATH'];
|
|
754
922
|
if (typeof override === 'string' && override.trim().length > 0) {
|
|
755
923
|
candidates.unshift(override.trim());
|
|
756
924
|
}
|
|
@@ -1512,6 +1680,29 @@ export class ChromiumSession {
|
|
|
1512
1680
|
* 否则「浏览器秒退」要白等满 `readyTimeoutMs`(默认 30 秒)才报错。
|
|
1513
1681
|
*/
|
|
1514
1682
|
spawnFailure;
|
|
1683
|
+
/**
|
|
1684
|
+
* ★ 中继形态(Chrome++ 等,PR-B / 旧仓 P25):spawn 的外层 exe 已以
|
|
1685
|
+
* `code=0` 自行退出,但它拉起的真实 chromium 可能仍在 `--remote-debugging-port`
|
|
1686
|
+
* 上就绪(见 `'exit'` 监听处的时序说明)。
|
|
1687
|
+
*
|
|
1688
|
+
* `true` = 已观察到外层 exe 的 code=0 退出 ⇒ 会话的生死**不再**以外层 exe
|
|
1689
|
+
* 为准,改为以「接续的真实例」为准(`relayGone` / `relayPid`)。
|
|
1690
|
+
*/
|
|
1691
|
+
relayExit = false;
|
|
1692
|
+
/**
|
|
1693
|
+
* 接续的真实例也没了(CDP ws 关闭/出错,或主动 `kill()`)。
|
|
1694
|
+
*
|
|
1695
|
+
* ⚠️ 只在 `relayExit` 时参与 {@link exited} 判据 —— 正常形态下 `child` 的
|
|
1696
|
+
* `'exit'` 事件就是唯一判据,再挂 ws 监听就成了「一套性质两处判据」。
|
|
1697
|
+
*/
|
|
1698
|
+
relayGone = false;
|
|
1699
|
+
/**
|
|
1700
|
+
* 接续的真实例主进程 pid(尽力而为捕获:`System.getProcessInfo`)。
|
|
1701
|
+
*
|
|
1702
|
+
* 外层 exe 已死 ⇒ `killProcessTree()` 对 `this.child` 打空;清理真实例
|
|
1703
|
+
* 要靠这个 pid(`taskkill /T /F` / 进程组),拿不到时退回 `Browser.close`。
|
|
1704
|
+
*/
|
|
1705
|
+
relayPid;
|
|
1515
1706
|
log;
|
|
1516
1707
|
constructor(options = {}) {
|
|
1517
1708
|
this.options = options;
|
|
@@ -1525,9 +1716,14 @@ export class ChromiumSession {
|
|
|
1525
1716
|
get debugPort() {
|
|
1526
1717
|
return this.port;
|
|
1527
1718
|
}
|
|
1528
|
-
/**
|
|
1719
|
+
/**
|
|
1720
|
+
* 浏览器主进程 pid(清理与诊断用)。
|
|
1721
|
+
*
|
|
1722
|
+
* ⚠️ 中继形态下 `child` 已死:回落到捕获到的 `relayPid`(可能仍是
|
|
1723
|
+
* `undefined` —— `System.getProcessInfo` 是异步尽力而为)。
|
|
1724
|
+
*/
|
|
1529
1725
|
get pid() {
|
|
1530
|
-
return this.child?.pid;
|
|
1726
|
+
return this.child?.pid ?? this.relayPid;
|
|
1531
1727
|
}
|
|
1532
1728
|
/**
|
|
1533
1729
|
* 本次会话的临时 profile 目录(即传给 chromium 的 `--user-data-dir`)。
|
|
@@ -1551,10 +1747,17 @@ export class ChromiumSession {
|
|
|
1551
1747
|
* 监听只在**它自己**退出时同时满足这两条(主动 `kill()` 会先把 `child` 置空,
|
|
1552
1748
|
* 那一刻 `spawnFailure` 仍是 `undefined`;启动前两者也都为空)。
|
|
1553
1749
|
*
|
|
1750
|
+
* ⚠️ **中继形态(PR-B / P25)**:外层 exe 本来就会 code=0 秒退,它的生死
|
|
1751
|
+
* 不再是会话的生死 ⇒ 改判「接续的真实例也没了」(`relayGone`:CDP ws
|
|
1752
|
+
* 关闭/出错,含用户自己关掉真实浏览器窗口)。用户关窗时真实例进程树
|
|
1753
|
+
* 退出,CDP ws 随之断开 —— 两个事件近同时发生,判据等价。
|
|
1754
|
+
*
|
|
1554
1755
|
* 用途:登录类流程(`magicrew-browser-login.ts`)据它**提前**结束等待 ——
|
|
1555
1756
|
* 用户关窗后若还耗满 4 分钟预算,用户看到的是「明明关掉了却还在转圈」。
|
|
1556
1757
|
*/
|
|
1557
1758
|
get exited() {
|
|
1759
|
+
if (this.relayExit)
|
|
1760
|
+
return this.relayGone;
|
|
1558
1761
|
return this.child === undefined && this.spawnFailure !== undefined;
|
|
1559
1762
|
}
|
|
1560
1763
|
/**
|
|
@@ -1644,8 +1847,14 @@ export class ChromiumSession {
|
|
|
1644
1847
|
/**
|
|
1645
1848
|
* 每次启动都是一次全新的尝试:上一次的失败原因必须清掉,
|
|
1646
1849
|
* 否则上一轮「浏览器起不来」会让后续**所有**轮次秒失败。
|
|
1850
|
+
*
|
|
1851
|
+
* ⚠️ 中继形态的三个标记同样要清(PR-B):上一轮的 code=0 退出
|
|
1852
|
+
* 不许影响这一轮的判死路径。
|
|
1647
1853
|
*/
|
|
1648
1854
|
this.spawnFailure = undefined;
|
|
1855
|
+
this.relayExit = false;
|
|
1856
|
+
this.relayGone = false;
|
|
1857
|
+
this.relayPid = undefined;
|
|
1649
1858
|
this.profileDir = mkdtempSync(join(tmpdir(), this.options.profilePrefix ?? 'chromium-session-'));
|
|
1650
1859
|
/**
|
|
1651
1860
|
* ★ **必须挑一个确实空闲的端口**(真实缺陷)。
|
|
@@ -1666,7 +1875,13 @@ export class ChromiumSession {
|
|
|
1666
1875
|
*/
|
|
1667
1876
|
this.port = this.options.debugPort ?? await pickFreePort();
|
|
1668
1877
|
const hide = this.options.hideWindow !== false;
|
|
1669
|
-
|
|
1878
|
+
/**
|
|
1879
|
+
* ⚠️ 经 `spawnImpl` 注入口起进程(PR-B):缺省就是 `spawn`,行为逐字不变;
|
|
1880
|
+
* spec 用它注入假 `ChildProcess` 驱动真实 `launch()` 流程(见
|
|
1881
|
+
* `ChromiumSessionOptions.spawnImpl` 的注释)。
|
|
1882
|
+
*/
|
|
1883
|
+
const spawnBrowser = this.options.spawnImpl ?? spawn;
|
|
1884
|
+
this.child = spawnBrowser(executable, [
|
|
1670
1885
|
`--remote-debugging-port=${this.port}`,
|
|
1671
1886
|
`--user-data-dir=${this.profileDir}`,
|
|
1672
1887
|
'--no-first-run',
|
|
@@ -1758,25 +1973,53 @@ export class ChromiumSession {
|
|
|
1758
1973
|
? `signal=${signal}`
|
|
1759
1974
|
: `code=${String(code)}`;
|
|
1760
1975
|
/**
|
|
1761
|
-
* ## ⚠️⚠️ `code=0`
|
|
1976
|
+
* ## ⚠️⚠️ `code=0` 的双面性(Gitee issue IKQ4JN 实测 → PR-B / 旧仓 P25 修)
|
|
1762
1977
|
*
|
|
1763
1978
|
* 有人用 **Chrome++ 之类的封装 exe**(如 `D:\…\Chrome\App\Chrome.exe`):
|
|
1764
|
-
* 外层 exe 会**在 9ms 内以 exit code 0
|
|
1979
|
+
* 外层 exe 会**在 9ms 内以 exit code 0 正常退出**,然后拉起一个独立进程
|
|
1980
|
+
*(真实 chromium,带着我们传的 `--remote-debugging-port` 与
|
|
1981
|
+
* `--user-data-dir`)。实测表象极具误导性:CDP `/json/version`
|
|
1982
|
+
* **517ms 就绪、端口完全正常**,而这里判 `code=0`。
|
|
1983
|
+
*
|
|
1984
|
+
* 原实现「判失败」的理由(保留在此,作为权衡记录):继续用一个
|
|
1985
|
+
* **已经死了的** `this.child` 会让 `killProcessTree` 打空、真实例泄漏。
|
|
1986
|
+
* 但代价是**浏览器明明跑着却被判死** —— 用户看到
|
|
1987
|
+
* 「浏览器进程异常退出(code=0)」(超级麦吉扫码登录的真实报障形态),
|
|
1988
|
+
* 而 CDP 马上就会就绪。
|
|
1765
1989
|
*
|
|
1766
|
-
*
|
|
1767
|
-
*
|
|
1768
|
-
*
|
|
1769
|
-
*
|
|
1990
|
+
* ⇒ PR-B 的修法:**code=0 不再立刻判死**,改为「在 `readyTimeoutMs` 内
|
|
1991
|
+
* 等真实例」:
|
|
1992
|
+
* - 端口出现真实例(且端口校验通过)→ **接续**:会话改以 CDP 通道为准
|
|
1993
|
+
* (`captureRelayPid` 捕获真实主进程 pid,`kill()` 用它 + `Browser.close`
|
|
1994
|
+
* 清理 —— 打空/泄漏的原顾虑由这两处专门兜住);
|
|
1995
|
+
* - 超时仍无真实例 → 失败,文案沿用 `spawnFailure`(就是用户看到的那句,
|
|
1996
|
+
* 含「如 Chrome++」的括注);
|
|
1997
|
+
* - **非 0 退出**(含 signal)→ 仍然立刻失败(下面的轮询循环每轮先查
|
|
1998
|
+
* `spawnFailure`,`relayExit` 不拦它)。
|
|
1770
1999
|
*
|
|
1771
|
-
*
|
|
1772
|
-
*
|
|
1773
|
-
* 为什么它属于**部署错误**(换浏览器就能好,重试没用)。
|
|
2000
|
+
* ⚠️ 这是把「立刻失败」**放宽**为「等真实例、超时才失败」,不是删保护:
|
|
2001
|
+
* 三条路径由 `tests/unit/chromium-relay-continuation.spec.ts` 锁死。
|
|
1774
2002
|
*/
|
|
1775
2003
|
this.spawnFailure ??= new BrowserDeploymentError(`${label}: 浏览器进程异常退出(${executable},${how})` +
|
|
1776
2004
|
`。请重试,或用 ${envName} 指定其它 chromium 内核浏览器。` +
|
|
1777
2005
|
(code === 0
|
|
1778
2006
|
? '(退出码 0 = 该 exe 启动了别的进程后自行退出,属不支持的封装形态,如 Chrome++)'
|
|
1779
2007
|
: ''), 'browser-spawn-failed');
|
|
2008
|
+
if (code === 0 && signal === null) {
|
|
2009
|
+
/**
|
|
2010
|
+
* ★ 中继形态:先记 `spawnFailure`(它同时是**超时路径**的文案),
|
|
2011
|
+
* 再翻 `relayExit` —— 轮询循环看到 `relayExit` 会**跳过**「每轮先查
|
|
2012
|
+
* spawnFailure」的立刻失败,继续等 CDP;`exited` 也改为以真实例为准。
|
|
2013
|
+
*/
|
|
2014
|
+
this.relayExit = true;
|
|
2015
|
+
/**
|
|
2016
|
+
* 真实例可能**已经**在了(轮询循环早于 exit 事件连上的情形)——
|
|
2017
|
+
* 若是,立刻挂上「真实例没了」的监听(`exited` 判据)。
|
|
2018
|
+
*/
|
|
2019
|
+
this.watchRelayDeath();
|
|
2020
|
+
return;
|
|
2021
|
+
}
|
|
2022
|
+
// 非 0 退出:spawnFailure 已就位,轮询循环下一轮立刻失败。
|
|
1780
2023
|
});
|
|
1781
2024
|
const timeoutMs = this.options.readyTimeoutMs ?? 30_000;
|
|
1782
2025
|
const deadline = Date.now() + timeoutMs;
|
|
@@ -1786,8 +2029,12 @@ export class ChromiumSession {
|
|
|
1786
2029
|
* ⚠️ **每轮先看 `spawnFailure`**:浏览器起不来 / 秒退时立刻失败,
|
|
1787
2030
|
* 而不是白等满 `readyTimeoutMs`(默认 30 秒)才报一个含糊的「超时」。
|
|
1788
2031
|
* 旧实现的用户体感就是「签到卡住半分钟然后失败」—— 根因就在这里。
|
|
2032
|
+
*
|
|
2033
|
+
* ⚠️ **中继形态(PR-B)例外**:`code=0` 退出时 `spawnFailure` 已就位
|
|
2034
|
+
*(那是超时路径的文案),但真实例可能还在路上 —— 跳过立刻失败,
|
|
2035
|
+
* 继续轮询;超时后由循环外的 `throw this.spawnFailure` 兜底。
|
|
1789
2036
|
*/
|
|
1790
|
-
if (this.spawnFailure !== undefined) {
|
|
2037
|
+
if (this.spawnFailure !== undefined && !this.relayExit) {
|
|
1791
2038
|
const failure = this.spawnFailure;
|
|
1792
2039
|
this.kill();
|
|
1793
2040
|
throw failure;
|
|
@@ -1842,6 +2089,22 @@ export class ChromiumSession {
|
|
|
1842
2089
|
});
|
|
1843
2090
|
this.ws = ws;
|
|
1844
2091
|
this.cdp = new CdpConnection(ws);
|
|
2092
|
+
/**
|
|
2093
|
+
* ★ 中继形态的「接续」收尾(PR-B / P25):走到这里 = 真实例已在我们的
|
|
2094
|
+
* 端口上应答且端口校验通过 ⇒ **接续成功**。还差两件事:
|
|
2095
|
+
*
|
|
2096
|
+
* 1. `watchRelayDeath()`:真实例没了(ws close/error)要把 `exited` 翻真
|
|
2097
|
+
* —— magicrew 靠它「用户自己关了窗就别再等 4 分钟」。
|
|
2098
|
+
* (`exit` 监听里也调过它 —— 两种时序都覆盖:exit 先于 ws 建立 /
|
|
2099
|
+
* ws 先于 exit 建立。)
|
|
2100
|
+
* 2. `captureRelayPid()`:尽力捕获真实例主进程 pid(`System.getProcessInfo`),
|
|
2101
|
+
* `kill()` 才能杀到它(外层 exe 已死,`this.child` 打空)。不 await:
|
|
2102
|
+
* 失败不阻断接续(拿不到 pid 就靠 `Browser.close` + 目录重试兜底)。
|
|
2103
|
+
*/
|
|
2104
|
+
if (this.relayExit) {
|
|
2105
|
+
this.watchRelayDeath();
|
|
2106
|
+
void this.captureRelayPid();
|
|
2107
|
+
}
|
|
1845
2108
|
/**
|
|
1846
2109
|
* ★ **把窗口从任务栏移除**(Windows / Linux / macOS 各一条路)。
|
|
1847
2110
|
*
|
|
@@ -1852,10 +2115,47 @@ export class ChromiumSession {
|
|
|
1852
2115
|
* (库库AI 的登录要让用户看见并自己操作)。
|
|
1853
2116
|
*
|
|
1854
2117
|
* ⚠ 不 await:这是装饰性优化,失败要静默,不能拖慢启动。
|
|
2118
|
+
*
|
|
2119
|
+
* ⚠ **中继形态下会跳过**(PR-B):`this.child` 是已死的外层 exe,
|
|
2120
|
+
* 它的 pid 藏不了真实例的窗口;`relayPid` 是异步尽力捕获的,此刻
|
|
2121
|
+
* 多半还没就位。代价只是任务栏图标可能闪一下(窗口本身仍被
|
|
2122
|
+
* `--window-position` 移到屏幕外 —— 参数传给了真实例)。
|
|
1855
2123
|
*/
|
|
1856
2124
|
if (hide && this.child?.pid !== undefined)
|
|
1857
2125
|
hideWindowFromTaskbar(this.child.pid, this.log);
|
|
1858
2126
|
}
|
|
2127
|
+
/**
|
|
2128
|
+
* 中继形态:把「接续的真实例也没了」接到 {@link exited}。
|
|
2129
|
+
*
|
|
2130
|
+
* ⚠️ 只在 `relayExit` 时挂监听:正常形态下 `child` 的 `'exit'` 事件就是
|
|
2131
|
+
* `exited` 的唯一判据,再挂 ws 监听就成了「一套性质两处判据」。
|
|
2132
|
+
* 两个调用时机(都调,时序谁先都覆盖):`'exit'` 监听内(真实例可能
|
|
2133
|
+
* 已先就绪)、ws 建立后(exit 可能先发生)。
|
|
2134
|
+
*/
|
|
2135
|
+
watchRelayDeath() {
|
|
2136
|
+
if (!this.relayExit || this.relayGone || this.ws === undefined)
|
|
2137
|
+
return;
|
|
2138
|
+
const onGone = () => { this.relayGone = true; };
|
|
2139
|
+
this.ws.addEventListener('close', onGone, { once: true });
|
|
2140
|
+
this.ws.addEventListener('error', onGone, { once: true });
|
|
2141
|
+
}
|
|
2142
|
+
/**
|
|
2143
|
+
* 中继形态:尽力捕获真实例主进程 pid(CDP `System.getProcessInfo`)。
|
|
2144
|
+
*
|
|
2145
|
+
* 拿到 pid ⇒ `kill()` 的 `killProcessTree()` 能对真实例整棵树
|
|
2146
|
+
* `taskkill /T /F` / `kill(-pid)`;拿不到 ⇒ 退回 `Browser.close`(kill 里
|
|
2147
|
+
* 已先行发出)+ `dispose()` 的目录删除重试。失败一律吞掉 ——
|
|
2148
|
+
* 接续会话不能因诊断性探测失败而中断。
|
|
2149
|
+
*/
|
|
2150
|
+
async captureRelayPid() {
|
|
2151
|
+
try {
|
|
2152
|
+
const info = await this.cdp?.send('System.getProcessInfo');
|
|
2153
|
+
const browser = info?.processInfo?.find((process) => process.type === 'browser');
|
|
2154
|
+
if (typeof browser?.pid === 'number')
|
|
2155
|
+
this.relayPid = browser.pid;
|
|
2156
|
+
}
|
|
2157
|
+
catch { /* 尽力而为:真实例不答 System 域就靠 Browser.close 兜底 */ }
|
|
2158
|
+
}
|
|
1859
2159
|
/**
|
|
1860
2160
|
* 终止浏览器进程**树**并清理所有 CDP 连接(**保留**临时 profile)。
|
|
1861
2161
|
*
|
|
@@ -1880,6 +2180,24 @@ export class ChromiumSession {
|
|
|
1880
2180
|
* Windows 用 `taskkill /T /F`(`/T` = 含子进程树)。
|
|
1881
2181
|
*/
|
|
1882
2182
|
kill() {
|
|
2183
|
+
/**
|
|
2184
|
+
* ★ 中继形态的清理(PR-B / P25):外层 exe 已死,`killProcessTree()`
|
|
2185
|
+
* 对 `this.child` 打空 —— 真实例按优先级两路收:
|
|
2186
|
+
*
|
|
2187
|
+
* 1. **`relayPid`(权威路径)**:`captureRelayPid()` 捕获的真实主进程
|
|
2188
|
+
* pid,下面的 `killProcessTree()` 会对它整棵树 `taskkill /T /F` /
|
|
2189
|
+
* `kill(-pid)`(确定性:返回即已终止)。
|
|
2190
|
+
* 2. **CDP `Browser.close`(优雅路径,fire-and-forget)**:请真实例自己
|
|
2191
|
+
* 退出。随后的 `ws.close()` 可能让它发不出去 —— 所以 1 才是权威路径,
|
|
2192
|
+
* 这条只是 pid 捕获失败时的兜底(外加 `dispose()` 的目录删除重试)。
|
|
2193
|
+
*/
|
|
2194
|
+
if (this.relayExit) {
|
|
2195
|
+
this.relayGone = true;
|
|
2196
|
+
try {
|
|
2197
|
+
void this.cdp?.send('Browser.close').catch(() => { });
|
|
2198
|
+
}
|
|
2199
|
+
catch { /* cdp 已关 */ }
|
|
2200
|
+
}
|
|
1883
2201
|
try {
|
|
1884
2202
|
this.cdp?.close();
|
|
1885
2203
|
}
|
|
@@ -1912,9 +2230,29 @@ export class ChromiumSession {
|
|
|
1912
2230
|
killProcessTree() {
|
|
1913
2231
|
const child = this.child;
|
|
1914
2232
|
this.child = undefined;
|
|
1915
|
-
if (child === undefined || child.pid === undefined)
|
|
2233
|
+
if (child === undefined || child.pid === undefined) {
|
|
2234
|
+
/**
|
|
2235
|
+
* ★ 中继形态(PR-B / P25):外层 exe 已死,但接续的真实例还活着 ——
|
|
2236
|
+
* 用 `captureRelayPid()` 捕获的 `relayPid` 杀它的**整棵树**。
|
|
2237
|
+
* 拿不到 pid(真实例不答 System 域)⇒ 这里静默跳过,由 kill() 里已
|
|
2238
|
+
* 发出的 `Browser.close` + `dispose()` 的目录删除重试兜底。
|
|
2239
|
+
*/
|
|
2240
|
+
const relayPid = this.relayPid;
|
|
2241
|
+
if (relayPid !== undefined)
|
|
2242
|
+
this.killPidTree(relayPid);
|
|
1916
2243
|
return;
|
|
1917
|
-
|
|
2244
|
+
}
|
|
2245
|
+
this.killPidTree(child.pid, child);
|
|
2246
|
+
}
|
|
2247
|
+
/**
|
|
2248
|
+
* 按 pid 终止浏览器及其**全部子进程**(树)。
|
|
2249
|
+
*
|
|
2250
|
+
* ⚠ 从 {@link killProcessTree} 抽出(PR-B):中继形态的 `relayPid` 与正常
|
|
2251
|
+
* 形态的 `child.pid` 需要**同一份**杀树判据 —— 抄两份必然分叉(方向恒定
|
|
2252
|
+
* 是「漏修的那份」,见本文件头部的缺陷表)。行为逐字沿用原实现:
|
|
2253
|
+
* `spawnSync`(同步)、`/T /F`、超时 10 秒、POSIX 进程组。
|
|
2254
|
+
*/
|
|
2255
|
+
killPidTree(pid, child) {
|
|
1918
2256
|
if (process.platform === 'win32') {
|
|
1919
2257
|
/**
|
|
1920
2258
|
* ⚠ Windows 没有进程组信号,用 `taskkill /T`(树)+ `/F`(强制)。
|
|
@@ -1930,23 +2268,24 @@ export class ChromiumSession {
|
|
|
1930
2268
|
});
|
|
1931
2269
|
}
|
|
1932
2270
|
catch { /* 尽力而为 */ }
|
|
1933
|
-
// 兜底:万一 taskkill
|
|
2271
|
+
// 兜底:万一 taskkill 不可用,至少杀掉主进程(中继形态无 child,跳过)。
|
|
1934
2272
|
try {
|
|
1935
|
-
child
|
|
2273
|
+
child?.kill();
|
|
1936
2274
|
}
|
|
1937
2275
|
catch { /* 已退出 */ }
|
|
1938
2276
|
return;
|
|
1939
2277
|
}
|
|
1940
2278
|
/**
|
|
1941
2279
|
* POSIX:`detached: true` 时子进程自成进程组,负 pid 即整组。
|
|
1942
|
-
* ⚠ 失败(ESRCH 等)就退回单进程 kill
|
|
2280
|
+
* ⚠ 失败(ESRCH 等)就退回单进程 kill(中继形态无 child,跳过 ——
|
|
2281
|
+
* 真实例不是我们拉起的进程组成员,-pid 不成即视为已退出)。
|
|
1943
2282
|
*/
|
|
1944
2283
|
try {
|
|
1945
2284
|
process.kill(-pid, 'SIGKILL');
|
|
1946
2285
|
}
|
|
1947
2286
|
catch {
|
|
1948
2287
|
try {
|
|
1949
|
-
child
|
|
2288
|
+
child?.kill('SIGKILL');
|
|
1950
2289
|
}
|
|
1951
2290
|
catch { /* 已退出 */ }
|
|
1952
2291
|
}
|