dsh-mobile-ios 0.2.16 → 0.2.18

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/cordis.patch.yml CHANGED
@@ -1,20 +1,20 @@
1
- # dsh-mobile-ios bundle patch(X1 安装路径:desktop profile 的 bundle 列表 + 本文件)。
2
- # 安全模型(2026-11-16 起):局域网监听**默认开**(手机连电脑是产品核心路径);
3
- # 安全边界在管理面——配对码生成/桌面摘要/撤销永远回环-only(rest.mjs LOOPBACK 门)
4
- # + 配对码一次性 + 设备 Bearer。此处的 allowLan:true 与插件默认值一致,显式写出便于发现。
5
- - insert:
6
- - id: dsh-mobile-ios
7
- name: 'dsh-mobile-ios'
8
- config:
9
- # 端口被占用时自动顺延(R12:插件不能因端口冲突带崩宿主)
10
- port: 3081
11
- # 局域网监听:绑定 0.0.0.0,手机经 LAN IP 直连(网关日志会打印「手机端填这个地址」)
12
- allowLan: true
13
- # 设备注册表落盘:配对跨宿主重启保留,手机不用反复重配。
14
- # 不写则插件默认落 ~/.dsh/mobile-access/dsh-mobile-ios-devices.json(推荐)
15
- # pairingFile: /绝对路径/可选/.dsh/mobile-access/dsh-mobile-ios-devices.json
16
- # 隧道意外退出后自动重拉(插件形态默认已开,false 可关闭)
17
- # autoRestart: true
18
- # 宿主形态(X2 闭环):显式 mux——进程内直取宿主 cordis 服务
19
- # (sessionController/agents/llm…),真数据进手机;mock 需显式 config.host='mock'
20
- host: mux
1
+ # dsh-mobile-ios bundle patch(X1 安装路径:desktop profile 的 bundle 列表 + 本文件)。
2
+ # 安全模型(2026-11-16 起):局域网监听**默认开**(手机连电脑是产品核心路径);
3
+ # 安全边界在管理面——配对码生成/桌面摘要/撤销永远回环-only(rest.mjs LOOPBACK 门)
4
+ # + 配对码一次性 + 设备 Bearer。此处的 allowLan:true 与插件默认值一致,显式写出便于发现。
5
+ - insert:
6
+ - id: dsh-mobile-ios
7
+ name: 'dsh-mobile-ios'
8
+ config:
9
+ # 端口被占用时自动顺延(R12:插件不能因端口冲突带崩宿主)
10
+ port: 3081
11
+ # 局域网监听:绑定 0.0.0.0,手机经 LAN IP 直连(网关日志会打印「手机端填这个地址」)
12
+ allowLan: true
13
+ # 设备注册表落盘:配对跨宿主重启保留,手机不用反复重配。
14
+ # 不写则插件默认落 ~/.dsh/mobile-access/dsh-mobile-ios-devices.json(推荐)
15
+ # pairingFile: /绝对路径/可选/.dsh/mobile-access/dsh-mobile-ios-devices.json
16
+ # 隧道意外退出后自动重拉(插件形态默认已开,false 可关闭)
17
+ # autoRestart: true
18
+ # 宿主形态(X2 闭环):显式 mux——进程内直取宿主 cordis 服务
19
+ # (sessionController/agents/llm…),真数据进手机;mock 需显式 config.host='mock'
20
+ host: mux
@@ -1,223 +1,197 @@
1
- // entries/plugin.mjs — DSH 插件入口(决策 D1 / ADR-08)
2
- // 三条纪律:
3
- // 1. apply() 永不向外抛异常(R12:插件跑在宿主进程内,抛出去可能带崩宿主);
4
- // 2. 端口冲突自动顺延,已由 server.mjs 兜底;
5
- // 3. 宿主卸载插件时必须彻底释放 socket / 定时器,不留孤儿监听。
6
-
7
- import os from 'node:os';
8
- import fs from 'node:fs';
9
- import path from 'node:path';
10
- import { createGateway } from '../src/server.mjs';
11
- import { createFileLog } from '../src/file-log.mjs';
12
- import { findCloudflared, sweepOrphanTunnels } from '../src/tunnel.mjs';
13
- import { createMockHost } from '../src/adapter/mock-host.mjs';
14
- import { createMuxHost } from '../src/adapter/mux-host.mjs';
15
- import { createCordisHost } from '../src/adapter/cordis-host.mjs';
16
- import { createProvisioner } from '../src/cloudflare.mjs';
17
- import { PLUGIN_VERSION } from '../src/version.mjs';
18
-
19
- export const name = 'dsh-mobile-ios';
20
- export const version = PLUGIN_VERSION;
21
-
22
- /**
23
- * 本机 cloudflared 发现链统一在 src/tunnel.mjs 的 findCloudflared:
24
- * config.tunnelBin → env CLOUDFLARED_BIN → 组件目录(~/.dsh/mobile-access/components/cloudflared/<版本>/)
25
- * → PATH。这里不再自己扫一遍目录 —— 两份实现曾经对 .exe 后缀的判断不一致,
26
- * 直接导致「装好了但开通器找不到」。
27
- */
28
- function resolveCloudflared(config = {}) {
29
- return config.tunnelBin || findCloudflared('auto') || 'auto';
30
- }
31
-
32
- /** 兼容 Cordis 的两种清理注册方式;都不可用时退化为 no-op 并明确记录 */
33
- function onCleanup(ctx, fn) {
34
- if (typeof ctx.effect === 'function') {
35
- ctx.effect(() => fn, 'dsh-mobile-ios:dispose');
36
- return 'ctx.effect';
37
- }
38
- if (typeof ctx.on === 'function') {
39
- ctx.on('dispose', fn);
40
- return "ctx.on('dispose')";
41
- }
42
- return 'none';
43
- }
44
-
45
- export function apply(ctx = {}, config = {}) {
46
- const steps = [];
47
- const record = (step, ok, detail = '') => {
48
- steps.push({ step, ok, detail });
49
- return ok;
50
- };
51
-
52
- const logger = ctx?.logger;
53
- const toHost = (msg) => {
54
- if (logger?.info) logger.info(`[dsh-mobile] ${msg}`);
55
- else if (typeof logger === 'function') logger(msg);
56
- else console.log(`[dsh-mobile] ${msg}`);
57
- };
58
- // 双写:宿主 logger(开发态看控制台)+ 自己的落盘文件。
59
- // 之所以必须落盘:宿主 logger 的输出在用户机器上取不到,出问题只能靠猜。
60
- const log = createFileLog({ mirror: toHost, file: config.logFile || undefined });
61
-
62
- const handle = {
63
- ok: false,
64
- steps,
65
- gateway: null,
66
- address: null,
67
- error: null,
68
- };
69
-
70
- try {
71
- record('cordis.ctx', Boolean(ctx && typeof ctx === 'object' && (ctx.effect || ctx.on || ctx.logger)), 'ctx 可用');
72
-
73
- // host 形态:
74
- // · mux/cordis —— **进程内直取宿主 cordis 服务**(默认:真宿主内的产品路径;
75
- // X2 闭环:sessionController 等 service 向上解析,owner 信任级);
76
- // · mock —— 契约夹具回放(联调/截图基线),需显式 config.host='mock' 或 env;
77
- // · 'http' —— 探测式 HTTP 宿主(考古确认 /api/remote.mux 不存在,仅保留 probe 诊断)。
78
- const hostKind = config.host || process.env.DSH_MOBILE_HOST || 'mux';
79
- log(`boot version=${version} hostKind=${hostKind} port=${config.port || process.env.DSH_MOBILE_PORT || 3081}`);
80
- const host =
81
- hostKind === 'mux' || hostKind === 'cordis'
82
- ? createCordisHost({ ctx, log, hostname: config.hostName })
83
- : hostKind === 'http'
84
- ? createMuxHost({ baseUrl: config.muxUrl || process.env.DSH_MUX_URL, token: config.muxToken, log })
85
- : createMockHost({ log, autoPlay: Boolean(config.autoPlay) });
86
- record('adapter', true, `kind=${host.kind}`);
87
-
88
- // 启动是异步的,但 apply 必须同步返回;用 then/catch 兜住,
89
- // 宿主立刻卸载时 stop() 也能在 server 起来之后生效。
90
- // 启动前清扫孤儿隧道(见 tunnel.mjs sweepOrphanTunnels):dsh web 每次重启
91
- // 会泄漏指向死端口的 cloudflared,同一组件目录二进制,顺手治好。
92
- const componentDir = path.join(os.homedir(), '.dsh', 'mobile-access', 'components', 'cloudflared');
93
- sweepOrphanTunnels({ componentDir, log })
94
- .then((r) => { if (r.killed > 0) log(`tunnel sweep: 清理 ${r.killed} 个孤儿隧道`); })
95
- .catch(() => { /* 清扫失败不挡启动 */ });
96
-
97
- /**
98
- * Pro 固定地址开通器。按「已经能用的证据」排序,谁先齐备用谁:
99
- * 1. config.tunnel.provisioner(显式指定,尊重运营决定)
100
- * 2. Cloudflare API(config 或 env 里有 accountId + apiToken)
101
- * 3. 开通服务(endpoint + enrollToken,产品形态;zone 权限留在服务端)
102
- * 4. 本地管理型(~/.cloudflared/cert.pem 存在,说明跑过 tunnel login)
103
- * 5. 只读状态(以前开通过,日常启动不该再要 zone 凭据)
104
- * 都没有就保持 Quick Tunnel——免费层行为一字不改。
105
- */
106
- const tunnelCfg = config.tunnel || {};
107
- const tunnelStateFile = tunnelCfg.stateFile || path.join(os.homedir(), '.dsh', 'mobile-access', 'tunnel-named.json');
108
- const baseDomain = tunnelCfg.baseDomain || process.env.DSH_TUNNEL_BASE_DOMAIN || 'matrixboard.cn';
109
- const cloudflareBin = resolveCloudflared(config);
110
- const common = {
111
- baseDomain,
112
- prefix: tunnelCfg.prefix || 'dsh',
113
- // 没找到就留 'auto':让发现链在真正要用的那一刻再解析一次(自动安装发生在启动之后)
114
- executable: cloudflareBin,
115
- };
116
- const explicit = tunnelCfg.provisioner ? String(tunnelCfg.provisioner) : null;
117
- const apiToken = tunnelCfg.apiToken || process.env.DSH_CF_API_TOKEN;
118
- const accountId = tunnelCfg.accountId || process.env.DSH_CF_ACCOUNT_ID;
119
- const endpoint = tunnelCfg.endpoint || process.env.DSH_TUNNEL_ENDPOINT;
120
-
121
- let provisioner = null;
122
- if (explicit === 'state') {
123
- provisioner = createProvisioner({ ...common, provisioner: 'state' }, { log, stateFile: tunnelStateFile });
124
- if (provisioner && !provisioner.configured) provisioner = null;
125
- } else if (explicit === 'local') {
126
- provisioner = createProvisioner({ ...common, provisioner: 'local' }, { log, stateFile: tunnelStateFile });
127
- if (provisioner && !provisioner.configured) provisioner = null;
128
- } else if (explicit === 'hosted' || (!explicit && endpoint)) {
129
- provisioner = createProvisioner(
130
- { ...common, provisioner: 'hosted', endpoint, enrollToken: tunnelCfg.enrollToken || process.env.DSH_TUNNEL_ENROLL_TOKEN },
131
- { log, stateFile: tunnelStateFile, hostId: 'host_cordis' },
132
- );
133
- } else {
134
- provisioner = createProvisioner(
135
- { ...common, provisioner: 'cloudflare', apiToken, accountId, zoneId: tunnelCfg.zoneId || process.env.DSH_CF_ZONE_ID },
136
- { log, stateFile: tunnelStateFile },
137
- );
138
- if (!provisioner) {
139
- const local = createProvisioner({ ...common, provisioner: 'local' }, { log, stateFile: tunnelStateFile });
140
- if (local?.configured) provisioner = local;
141
- }
142
- }
143
-
144
- // 没有开通凭据,但这台机器以前开通过:用只读状态继续跑固定地址。
145
- // 日常启动不该依赖 zone 级凭据——token 就在 0600 状态文件里。
146
- if (!provisioner && fs.existsSync(tunnelStateFile)) {
147
- const fromState = createProvisioner({ provisioner: 'state', baseDomain }, { log, stateFile: tunnelStateFile });
148
- if (fromState?.configured) {
149
- provisioner = fromState;
150
- log('tunnel 复用已开通的固定地址(只读状态,无 zone 凭据)');
151
- }
152
- }
153
- if (provisioner) log(`tunnel 固定地址开通器=${provisioner.kind} 域名=${provisioner.baseDomain}`);
154
-
155
- const booting = createGateway({
156
- host,
157
- port: Number(config.port || process.env.DSH_MOBILE_PORT || 3081),
158
- dev: Boolean(config.dev),
159
- // 局域网监听默认开:手机连电脑是产品核心路径。
160
- // 安全边界不靠监听面,靠管理面回环-only(summary/pairing-code/revoke,见 rest.mjs)
161
- // + 配对码一次性 + 设备 Bearer。显式 config.allowLan=false 可关。
162
- allowLan: config.allowLan !== undefined ? Boolean(config.allowLan) : true,
163
- hostSuffixes: config.hostSuffixes || ['trycloudflare.com'],
164
- // 借鉴 dsh-plugin-mobile-gateway 的 gatewayStateFile:设备注册表落盘后
165
- // 配对跨宿主重启保留,手机不用反复重配。分发形态给默认落盘路径
166
- // (显式 config.pairingFile / 环境变量仍优先;测试与临时实例传 null 走内存)。
167
- pairingFile: config.pairingFile
168
- || process.env.DSH_MOBILE_PAIRING_FILE
169
- || path.join(os.homedir(), '.dsh', 'mobile-access', 'dsh-mobile-ios-devices.json'),
170
- // 插件形态默认开隧道自动重拉(sidecar/dev 形态不开,避免测试时空转)
171
- tunnelAutoRestart: config.autoRestart !== undefined ? Boolean(config.autoRestart) : true,
172
- // 隧道可执行文件发现链(见 resolveCloudflared);显式 config.tunnelBin 优先
173
- tunnelExecutable: cloudflareBin,
174
- tunnelProvisioner: provisioner,
175
- log,
176
- })
177
- .then(async (gw) => {
178
- handle.gateway = gw;
179
- const addr = await gw.start();
180
- handle.address = addr;
181
- handle.ok = true;
182
- log(`ready ${addr.address}:${addr.port} ${JSON.stringify(addr)}`);
183
- if (host.kind === 'mock' && config.printPairingCode !== false) {
184
- const issued = gw.pairing.issueCode({ deviceName: 'plugin-mock' });
185
- log(`配对码 ${issued.code}(仅 mock 适配器;真实宿主下由桌面端界面展示)`);
186
- }
187
- return gw;
188
- })
189
- .catch((err) => {
190
- handle.error = err.message;
191
- record('listen', false, err.message);
192
- log(`启动失败:${err.message}`);
193
- return null;
194
- });
195
-
196
- record('listen', true, '异步绑定中(见 handle.address)');
197
-
198
- const cleanupVia = onCleanup(ctx, () =>
199
- booting
200
- .then((gw) => gw?.stop())
201
- .catch((err) => log(`清理异常:${err.message}`))
202
- );
203
- record('lifecycle', cleanupVia !== 'none', cleanupVia);
204
-
205
- // 注意:cordis 的 ctx 是受控代理,**不允许**直接挂新属性(会抛
206
- // `cannot set property ... without provide`)。之前这行在 apply 末尾抛出,
207
- // 被 catch 吞掉后只能靠日志发现——顺手去掉,handle 由 apply 的返回值给出。
208
- handle.ready = booting;
209
- return handle;
210
- } catch (err) {
211
- // 绝不外抛:记录后让宿主继续跑
212
- handle.error = err.message;
213
- record('apply', false, err.message);
214
- try {
215
- log(`apply 异常已吞掉(防带崩宿主):${err.stack || err.message}`);
216
- } catch {
217
- /* logger 本身坏掉时也不能抛 */
218
- }
219
- return handle;
220
- }
221
- }
222
-
223
- export default { name, version, apply };
1
+ // entries/plugin.mjs — DSH 插件入口(决策 D1 / ADR-08)
2
+ // 三条纪律:
3
+ // 1. apply() 永不向外抛异常(R12:插件跑在宿主进程内,抛出去可能带崩宿主);
4
+ // 2. 端口冲突自动顺延,已由 server.mjs 兜底;
5
+ // 3. 宿主卸载插件时必须彻底释放 socket / 定时器,不留孤儿监听。
6
+
7
+ import os from 'node:os';
8
+ import path from 'node:path';
9
+ import { createGateway } from '../src/server.mjs';
10
+ import { createFileLog } from '../src/file-log.mjs';
11
+ import { findCloudflared, sweepOrphanTunnels } from '../src/tunnel.mjs';
12
+ import { createMockHost } from '../src/adapter/mock-host.mjs';
13
+ import { createMuxHost } from '../src/adapter/mux-host.mjs';
14
+ import { createCordisHost } from '../src/adapter/cordis-host.mjs';
15
+ import { resolveProvisioner, defaultTunnelStateFile } from '../src/provision-select.mjs';
16
+ import { PLUGIN_VERSION } from '../src/version.mjs';
17
+
18
+ export const name = 'dsh-mobile-ios';
19
+ export const version = PLUGIN_VERSION;
20
+
21
+ /**
22
+ * 本机 cloudflared 发现链统一在 src/tunnel.mjs 的 findCloudflared:
23
+ * config.tunnelBin → env CLOUDFLARED_BIN → 组件目录(~/.dsh/mobile-access/components/cloudflared/<版本>/)
24
+ * → PATH。这里不再自己扫一遍目录 —— 两份实现曾经对 .exe 后缀的判断不一致,
25
+ * 直接导致「装好了但开通器找不到」。
26
+ */
27
+ function resolveCloudflared(config = {}) {
28
+ return config.tunnelBin || findCloudflared('auto') || 'auto';
29
+ }
30
+
31
+ /** 兼容 Cordis 的两种清理注册方式;都不可用时退化为 no-op 并明确记录 */
32
+ function onCleanup(ctx, fn) {
33
+ if (typeof ctx.effect === 'function') {
34
+ ctx.effect(() => fn, 'dsh-mobile-ios:dispose');
35
+ return 'ctx.effect';
36
+ }
37
+ if (typeof ctx.on === 'function') {
38
+ ctx.on('dispose', fn);
39
+ return "ctx.on('dispose')";
40
+ }
41
+ return 'none';
42
+ }
43
+
44
+ export function apply(ctx = {}, config = {}) {
45
+ const steps = [];
46
+ const record = (step, ok, detail = '') => {
47
+ steps.push({ step, ok, detail });
48
+ return ok;
49
+ };
50
+
51
+ const logger = ctx?.logger;
52
+ const toHost = (msg) => {
53
+ if (logger?.info) logger.info(`[dsh-mobile] ${msg}`);
54
+ else if (typeof logger === 'function') logger(msg);
55
+ else console.log(`[dsh-mobile] ${msg}`);
56
+ };
57
+ // 双写:宿主 logger(开发态看控制台)+ 自己的落盘文件。
58
+ // 之所以必须落盘:宿主 logger 的输出在用户机器上取不到,出问题只能靠猜。
59
+ const log = createFileLog({ mirror: toHost, file: config.logFile || undefined });
60
+
61
+ const handle = {
62
+ ok: false,
63
+ steps,
64
+ gateway: null,
65
+ address: null,
66
+ error: null,
67
+ };
68
+
69
+ try {
70
+ record('cordis.ctx', Boolean(ctx && typeof ctx === 'object' && (ctx.effect || ctx.on || ctx.logger)), 'ctx 可用');
71
+
72
+ // host 形态:
73
+ // · mux/cordis —— **进程内直取宿主 cordis 服务**(默认:真宿主内的产品路径;
74
+ // X2 闭环:sessionController 等 service 向上解析,owner 信任级);
75
+ // · mock —— 契约夹具回放(联调/截图基线),需显式 config.host='mock' 或 env;
76
+ // · 'http' —— 探测式 HTTP 宿主(考古确认 /api/remote.mux 不存在,仅保留 probe 诊断)。
77
+ const hostKind = config.host || process.env.DSH_MOBILE_HOST || 'mux';
78
+ log(`boot version=${version} hostKind=${hostKind} port=${config.port || process.env.DSH_MOBILE_PORT || 3081}`);
79
+ const host =
80
+ hostKind === 'mux' || hostKind === 'cordis'
81
+ ? createCordisHost({ ctx, log, hostname: config.hostName })
82
+ : hostKind === 'http'
83
+ ? createMuxHost({ baseUrl: config.muxUrl || process.env.DSH_MUX_URL, token: config.muxToken, log })
84
+ : createMockHost({ log, autoPlay: Boolean(config.autoPlay) });
85
+ record('adapter', true, `kind=${host.kind}`);
86
+
87
+ // 启动是异步的,但 apply 必须同步返回;用 then/catch 兜住,
88
+ // 宿主立刻卸载时 stop() 也能在 server 起来之后生效。
89
+ // 启动前清扫孤儿隧道(见 tunnel.mjs sweepOrphanTunnels):dsh web 每次重启
90
+ // 会泄漏指向死端口的 cloudflared,同一组件目录二进制,顺手治好。
91
+ const componentDir = path.join(os.homedir(), '.dsh', 'mobile-access', 'components', 'cloudflared');
92
+ sweepOrphanTunnels({ componentDir, log })
93
+ .then((r) => { if (r.killed > 0) log(`tunnel sweep: 清理 ${r.killed} 个孤儿隧道`); })
94
+ .catch(() => { /* 清扫失败不挡启动 */ });
95
+
96
+ /**
97
+ * Pro 固定地址开通器。判定统一在 resolveProvisioner(与 sidecar 同一套顺序):
98
+ * 1. config.tunnel.provisioner(显式指定,尊重运营决定)
99
+ * 2. 开通服务(endpoint + enrollToken,产品形态;zone 权限留在服务端)
100
+ * 3. Cloudflare API(config 或 env 里有 accountId + apiToken)
101
+ * 4. 本地管理型(~/.cloudflared/cert.pem 存在,说明跑过 tunnel login)
102
+ * 5. 只读状态(以前开通过,日常启动不该再要 zone 凭据;token 或本地 ingress 两种形态)
103
+ * 都没有就保持 Quick Tunnel——免费层行为一字不改。
104
+ *
105
+ * 两个入口共用同一个判定,是为了避免「同一台机器换个启动方式就换一种结论」:
106
+ * 那会让固定地址时有时无,用户只会觉得插件坏了。
107
+ */
108
+ const tunnelCfg = config.tunnel || {};
109
+ const tunnelStateFile = tunnelCfg.stateFile || defaultTunnelStateFile();
110
+ const cloudflareBin = resolveCloudflared(config);
111
+
112
+ const provisioner = resolveProvisioner({
113
+ tunnelCfg: {
114
+ ...tunnelCfg,
115
+ // 环境变量兜底:与 sidecar 一致,避免只在某个入口生效
116
+ apiToken: tunnelCfg.apiToken || process.env.DSH_CF_API_TOKEN,
117
+ accountId: tunnelCfg.accountId || process.env.DSH_CF_ACCOUNT_ID,
118
+ zoneId: tunnelCfg.zoneId || process.env.DSH_CF_ZONE_ID,
119
+ endpoint: tunnelCfg.endpoint || process.env.DSH_TUNNEL_ENDPOINT,
120
+ enrollToken: tunnelCfg.enrollToken || process.env.DSH_TUNNEL_ENROLL_TOKEN,
121
+ baseDomain: tunnelCfg.baseDomain || process.env.DSH_TUNNEL_BASE_DOMAIN || 'matrixboard.cn',
122
+ executable: cloudflareBin,
123
+ },
124
+ stateFile: tunnelStateFile,
125
+ hostId: 'host_cordis',
126
+ log,
127
+ });
128
+
129
+ const booting = createGateway({
130
+ host,
131
+ port: Number(config.port || process.env.DSH_MOBILE_PORT || 3081),
132
+ dev: Boolean(config.dev),
133
+ // 局域网监听默认开:手机连电脑是产品核心路径。
134
+ // 安全边界不靠监听面,靠管理面回环-only(summary/pairing-code/revoke,见 rest.mjs)
135
+ // + 配对码一次性 + 设备 Bearer。显式 config.allowLan=false 可关。
136
+ allowLan: config.allowLan !== undefined ? Boolean(config.allowLan) : true,
137
+ hostSuffixes: config.hostSuffixes || ['trycloudflare.com'],
138
+ // 借鉴 dsh-plugin-mobile-gateway 的 gatewayStateFile:设备注册表落盘后
139
+ // 配对跨宿主重启保留,手机不用反复重配。分发形态给默认落盘路径
140
+ // (显式 config.pairingFile / 环境变量仍优先;测试与临时实例传 null 走内存)。
141
+ pairingFile: config.pairingFile
142
+ || process.env.DSH_MOBILE_PAIRING_FILE
143
+ || path.join(os.homedir(), '.dsh', 'mobile-access', 'dsh-mobile-ios-devices.json'),
144
+ // 插件形态默认开隧道自动重拉(sidecar/dev 形态不开,避免测试时空转)
145
+ tunnelAutoRestart: config.autoRestart !== undefined ? Boolean(config.autoRestart) : true,
146
+ // 隧道可执行文件发现链(见 resolveCloudflared);显式 config.tunnelBin 优先
147
+ tunnelExecutable: cloudflareBin,
148
+ tunnelProvisioner: provisioner,
149
+ log,
150
+ })
151
+ .then(async (gw) => {
152
+ handle.gateway = gw;
153
+ const addr = await gw.start();
154
+ handle.address = addr;
155
+ handle.ok = true;
156
+ log(`ready ${addr.address}:${addr.port} ${JSON.stringify(addr)}`);
157
+ if (host.kind === 'mock' && config.printPairingCode !== false) {
158
+ const issued = gw.pairing.issueCode({ deviceName: 'plugin-mock' });
159
+ log(`配对码 ${issued.code}(仅 mock 适配器;真实宿主下由桌面端界面展示)`);
160
+ }
161
+ return gw;
162
+ })
163
+ .catch((err) => {
164
+ handle.error = err.message;
165
+ record('listen', false, err.message);
166
+ log(`启动失败:${err.message}`);
167
+ return null;
168
+ });
169
+
170
+ record('listen', true, '异步绑定中(见 handle.address)');
171
+
172
+ const cleanupVia = onCleanup(ctx, () =>
173
+ booting
174
+ .then((gw) => gw?.stop())
175
+ .catch((err) => log(`清理异常:${err.message}`))
176
+ );
177
+ record('lifecycle', cleanupVia !== 'none', cleanupVia);
178
+
179
+ // 注意:cordis 的 ctx 是受控代理,**不允许**直接挂新属性(会抛
180
+ // `cannot set property ... without provide`)。之前这行在 apply 末尾抛出,
181
+ // 被 catch 吞掉后只能靠日志发现——顺手去掉,handle 由 apply 的返回值给出。
182
+ handle.ready = booting;
183
+ return handle;
184
+ } catch (err) {
185
+ // 绝不外抛:记录后让宿主继续跑
186
+ handle.error = err.message;
187
+ record('apply', false, err.message);
188
+ try {
189
+ log(`apply 异常已吞掉(防带崩宿主):${err.stack || err.message}`);
190
+ } catch {
191
+ /* logger 本身坏掉时也不能抛 */
192
+ }
193
+ return handle;
194
+ }
195
+ }
196
+
197
+ export default { name, version, apply };