dsh-mobile-ios 0.2.6 → 0.2.8
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/LICENSE +21 -21
- package/README.md +284 -284
- package/cordis.patch.yml +20 -20
- package/entries/plugin.mjs +246 -246
- package/entries/sidecar.mjs +111 -111
- package/lib/client.js +1294 -1193
- package/lib/vendor/qrcode-generator.cjs +2297 -2297
- package/lib/vendor/qrcode-utf8.cjs +26 -26
- package/package.json +53 -53
- package/src/adapter/artifacts.mjs +235 -235
- package/src/adapter/cordis-host.mjs +1225 -1225
- package/src/adapter/mock-host.mjs +437 -437
- package/src/adapter/mux-host.mjs +99 -99
- package/src/adapter/session-history.mjs +241 -241
- package/src/cloudflare.mjs +628 -628
- package/src/cloudflared-install.mjs +139 -0
- package/src/dns-label.mjs +32 -32
- package/src/dns-probe.mjs +90 -90
- package/src/file-log.mjs +68 -68
- package/src/gateway.mjs +285 -285
- package/src/pairing.mjs +300 -300
- package/src/protocol.mjs +59 -59
- package/src/provision-local.mjs +309 -309
- package/src/rest.mjs +812 -786
- package/src/ring.mjs +148 -148
- package/src/server.mjs +219 -219
- package/src/tunnel.mjs +523 -504
- package/src/version.mjs +24 -24
- package/src/ws.mjs +332 -332
package/src/rest.mjs
CHANGED
|
@@ -1,786 +1,812 @@
|
|
|
1
|
-
// rest.mjs — 一元接口(/mobile/v1/*)
|
|
2
|
-
// 只做三件事:鉴权、参数校验、把请求交给 host 适配器。业务判断一律不在这里。
|
|
3
|
-
|
|
4
|
-
import { fail, ERRORS, newId } from './protocol.mjs';
|
|
5
|
-
import { translateRecords } from './adapter/session-history.mjs';
|
|
6
|
-
import { createRequire } from 'node:module';
|
|
7
|
-
import { PLUGIN_VERSION } from './version.mjs';
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
//
|
|
11
|
-
|
|
12
|
-
const
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
qr
|
|
19
|
-
qr.
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
//
|
|
28
|
-
|
|
29
|
-
const
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
*
|
|
38
|
-
*
|
|
39
|
-
*
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
*
|
|
51
|
-
*
|
|
52
|
-
*
|
|
53
|
-
*
|
|
54
|
-
*
|
|
55
|
-
*
|
|
56
|
-
*
|
|
57
|
-
*
|
|
58
|
-
* Origin
|
|
59
|
-
*
|
|
60
|
-
*
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
if (origin
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
}
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
*
|
|
79
|
-
*
|
|
80
|
-
*
|
|
81
|
-
* -
|
|
82
|
-
* -
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
'Access-Control-Allow-
|
|
87
|
-
'Access-Control-Allow-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
/^\/mobile\/v1\/
|
|
93
|
-
/^\/mobile\/v1\/
|
|
94
|
-
|
|
95
|
-
//
|
|
96
|
-
|
|
97
|
-
/^\/mobile\/v1\/tunnel\/
|
|
98
|
-
/^\/mobile\/v1\/tunnel\/
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
}
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
'
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
}
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
const
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
*
|
|
151
|
-
*
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
const
|
|
157
|
-
const
|
|
158
|
-
const
|
|
159
|
-
|
|
160
|
-
const
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
{ name: '
|
|
164
|
-
{ name: '
|
|
165
|
-
{ name: '
|
|
166
|
-
{
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
''
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
*
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
//
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
const
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
const
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
//
|
|
306
|
-
|
|
307
|
-
//
|
|
308
|
-
//
|
|
309
|
-
|
|
310
|
-
const
|
|
311
|
-
//
|
|
312
|
-
//
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
const
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
const
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
});
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
const
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
{ name: '
|
|
427
|
-
{
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
},
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
}
|
|
472
|
-
|
|
473
|
-
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
})
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
|
|
545
|
-
const
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
549
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
|
|
561
|
-
|
|
562
|
-
|
|
563
|
-
|
|
564
|
-
|
|
565
|
-
|
|
566
|
-
|
|
567
|
-
route('GET', /^\/mobile\/v1\/tasks\/([^/]+)\/
|
|
568
|
-
auth(ctx.req);
|
|
569
|
-
const
|
|
570
|
-
|
|
571
|
-
|
|
572
|
-
|
|
573
|
-
|
|
574
|
-
|
|
575
|
-
|
|
576
|
-
//
|
|
577
|
-
//
|
|
578
|
-
|
|
579
|
-
|
|
580
|
-
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
|
|
590
|
-
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
|
|
596
|
-
|
|
597
|
-
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
|
|
603
|
-
|
|
604
|
-
const
|
|
605
|
-
const
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
609
|
-
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
const
|
|
620
|
-
|
|
621
|
-
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
|
|
639
|
-
|
|
640
|
-
|
|
641
|
-
|
|
642
|
-
|
|
643
|
-
|
|
644
|
-
|
|
645
|
-
|
|
646
|
-
|
|
647
|
-
|
|
648
|
-
|
|
649
|
-
//
|
|
650
|
-
//
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
const
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
const
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
667
|
-
|
|
668
|
-
|
|
669
|
-
|
|
670
|
-
const
|
|
671
|
-
|
|
672
|
-
|
|
673
|
-
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
const
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
|
|
683
|
-
|
|
684
|
-
|
|
685
|
-
|
|
686
|
-
|
|
687
|
-
|
|
688
|
-
const
|
|
689
|
-
const result = await
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
|
|
693
|
-
|
|
694
|
-
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
|
|
706
|
-
|
|
707
|
-
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
);
|
|
714
|
-
|
|
715
|
-
|
|
716
|
-
|
|
717
|
-
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
726
|
-
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
const
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
|
|
734
|
-
|
|
735
|
-
|
|
736
|
-
|
|
737
|
-
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
748
|
-
|
|
749
|
-
|
|
750
|
-
|
|
751
|
-
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
757
|
-
|
|
758
|
-
|
|
759
|
-
|
|
760
|
-
|
|
761
|
-
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
|
|
772
|
-
|
|
773
|
-
|
|
774
|
-
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
|
|
778
|
-
|
|
779
|
-
}
|
|
780
|
-
|
|
781
|
-
|
|
782
|
-
const
|
|
783
|
-
|
|
784
|
-
|
|
785
|
-
|
|
786
|
-
|
|
1
|
+
// rest.mjs — 一元接口(/mobile/v1/*)
|
|
2
|
+
// 只做三件事:鉴权、参数校验、把请求交给 host 适配器。业务判断一律不在这里。
|
|
3
|
+
|
|
4
|
+
import { fail, ERRORS, newId } from './protocol.mjs';
|
|
5
|
+
import { translateRecords } from './adapter/session-history.mjs';
|
|
6
|
+
import { createRequire } from 'node:module';
|
|
7
|
+
import { PLUGIN_VERSION } from './version.mjs';
|
|
8
|
+
import { ensureCloudflared, resolveAsset } from './cloudflared-install.mjs';
|
|
9
|
+
|
|
10
|
+
// QR 编码(vendor:qrcode-generator 1.4.4,MIT,零依赖;见 lib/vendor/,
|
|
11
|
+
// .cjs 后缀:包为 type:module,require 需显式 CommonJS)
|
|
12
|
+
const require = createRequire(import.meta.url);
|
|
13
|
+
const qrEncoder = require('../lib/vendor/qrcode-generator.cjs');
|
|
14
|
+
|
|
15
|
+
/** 配对二维码 SVG(服务端生成,借鉴 dsh-mobile:QR 在响应里随码下发)。 */
|
|
16
|
+
function pairQrSvg(payload) {
|
|
17
|
+
try {
|
|
18
|
+
const qr = qrEncoder(0, 'M');
|
|
19
|
+
qr.addData(payload);
|
|
20
|
+
qr.make();
|
|
21
|
+
return qr.createSvgTag({ cellSize: 4, margin: 2, scalable: true });
|
|
22
|
+
} catch {
|
|
23
|
+
return null;
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
// 图片/文件附件以 base64 随请求上送(膨胀约 33%),1MB 会挡住正常照片。
|
|
28
|
+
// 25MB 与宿主产物读取上限同档;再大的文件让用户在电脑端处理。
|
|
29
|
+
const BODY_LIMIT = 25 * 1024 * 1024;
|
|
30
|
+
const LOOPBACK = new Set(['127.0.0.1', '::1', '::ffff:127.0.0.1']);
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* 管理面「是不是主机本机」的判据。
|
|
34
|
+
*
|
|
35
|
+
* 坑在隧道:cloudflared 就跑在本机,它转发进来的请求 socket 地址同样是
|
|
36
|
+
* 127.0.0.1。只用 remoteAddress 判断,等于让公网上的任何人拿到管理面
|
|
37
|
+
* (重新生成配对码 / 撤销全部设备 / 开关隧道)。Cloudflare 一定会在边缘
|
|
38
|
+
* 打上 CF-Connecting-IP / CF-Ray,见到这些头就不再是本机用户。
|
|
39
|
+
*
|
|
40
|
+
* 这不是「防自己人」的校验,而是防止隧道把本机特权面复制到公网。
|
|
41
|
+
*/
|
|
42
|
+
const EDGE_HEADERS = ['cf-connecting-ip', 'cf-ray', 'cf-visitor', 'cf-ipcountry'];
|
|
43
|
+
|
|
44
|
+
function isLoopbackRequest(req) {
|
|
45
|
+
if (!LOOPBACK.has(req.socket.remoteAddress)) return false;
|
|
46
|
+
return !EDGE_HEADERS.some((name) => req.headers[name] !== undefined);
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* 管理面请求的另一个门:发起方必须是本机页面。
|
|
51
|
+
*
|
|
52
|
+
* 浏览器里任何一个网页都能向 127.0.0.1 发 POST(CORS 只挡读响应,不挡执行),
|
|
53
|
+
* 而隧道开通会真消耗 Cloudflare 配额。桌面面板来自本机(回环 host、file:// 的
|
|
54
|
+
* null origin、或宿主 Electron 的自有 scheme),所以有 Origin 时只认这三种;
|
|
55
|
+
* curl / Node 工具没有 Origin,放行。
|
|
56
|
+
*
|
|
57
|
+
* 宿主页面源是自定义 scheme(实测 dsh-app://app)。这类 scheme 只能出现在
|
|
58
|
+
* 特权本机上下文里:公网网页的 Origin 永远是 http(s),且 fetch 无法伪造
|
|
59
|
+
* Origin 头(那是浏览器保护的请求头)。叠加 isLoopbackRequest 的回环
|
|
60
|
+
* socket + 无边缘头两个前置条件,局域网与隧道进来的请求拿不到放行资格,
|
|
61
|
+
* 攻击面没有扩大。
|
|
62
|
+
*/
|
|
63
|
+
function isSameMachineOrigin(req) {
|
|
64
|
+
const origin = req.headers.origin;
|
|
65
|
+
if (!origin) return true;
|
|
66
|
+
if (origin === 'null') return true;
|
|
67
|
+
try {
|
|
68
|
+
const u = new URL(origin);
|
|
69
|
+
if (u.protocol !== 'http:' && u.protocol !== 'https:') return true;
|
|
70
|
+
const host = u.hostname.toLowerCase();
|
|
71
|
+
return LOOPBACK.has(host) || host === 'localhost';
|
|
72
|
+
} catch {
|
|
73
|
+
return false;
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* 桌面端 banner(lib/client.js 注入宿主 web app)跨源读取的端点白名单。
|
|
79
|
+
*
|
|
80
|
+
* 边界:
|
|
81
|
+
* - health 本来就公开(无敏感信息);desktop/summary 走回环门(LAN 模式下外部拿不到);
|
|
82
|
+
* - pairing/code 本就回环-only,开放 CORS 只是把「本机浏览器」也纳入合法调用方;
|
|
83
|
+
* - 白名单之外的路由一律不发 CORS 头——手机走的同源/原生 fetch 不需要它。
|
|
84
|
+
*/
|
|
85
|
+
const DESKTOP_CORS = {
|
|
86
|
+
'Access-Control-Allow-Origin': '*',
|
|
87
|
+
'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
|
|
88
|
+
'Access-Control-Allow-Headers': 'content-type, authorization',
|
|
89
|
+
};
|
|
90
|
+
|
|
91
|
+
const DESKTOP_CORS_PATHS = [
|
|
92
|
+
/^\/mobile\/v1\/health$/,
|
|
93
|
+
/^\/mobile\/v1\/desktop\/summary$/,
|
|
94
|
+
/^\/mobile\/v1\/pairing\/code$/,
|
|
95
|
+
// 桌面面板的隧道按钮原本就在调这两个端点,但没进白名单:请求其实发出去了,
|
|
96
|
+
// 只是响应被浏览器拦下,面板只能显示「操作失败」——隧道其实已经起来了。
|
|
97
|
+
/^\/mobile\/v1\/tunnel\/start$/,
|
|
98
|
+
/^\/mobile\/v1\/tunnel\/stop$/,
|
|
99
|
+
/^\/mobile\/v1\/tunnel\/provision$/,
|
|
100
|
+
/^\/mobile\/v1\/tunnel\/install-cloudflared$/,
|
|
101
|
+
];
|
|
102
|
+
|
|
103
|
+
// 面板「插件版本」与更新检查的「当前版本」都取这里;必须与 npm 包版本同源。
|
|
104
|
+
const GATEWAY_VERSION = PLUGIN_VERSION;
|
|
105
|
+
|
|
106
|
+
function readJson(req) {
|
|
107
|
+
return new Promise((resolve, reject) => {
|
|
108
|
+
let size = 0;
|
|
109
|
+
const chunks = [];
|
|
110
|
+
req.on('data', (c) => {
|
|
111
|
+
size += c.length;
|
|
112
|
+
if (size > BODY_LIMIT) {
|
|
113
|
+
reject(fail(4400, '请求体过大'));
|
|
114
|
+
req.destroy();
|
|
115
|
+
return;
|
|
116
|
+
}
|
|
117
|
+
chunks.push(c);
|
|
118
|
+
});
|
|
119
|
+
req.on('end', () => {
|
|
120
|
+
const raw = Buffer.concat(chunks).toString('utf8');
|
|
121
|
+
if (!raw) return resolve({});
|
|
122
|
+
try {
|
|
123
|
+
resolve(JSON.parse(raw));
|
|
124
|
+
} catch {
|
|
125
|
+
reject(fail(4400, '请求体不是合法 JSON'));
|
|
126
|
+
}
|
|
127
|
+
});
|
|
128
|
+
req.on('error', reject);
|
|
129
|
+
});
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
function send(res, status, body, headers = {}) {
|
|
133
|
+
const payload = body === undefined ? '' : JSON.stringify(body);
|
|
134
|
+
res.writeHead(status, {
|
|
135
|
+
'Content-Type': 'application/json; charset=utf-8',
|
|
136
|
+
'Content-Length': Buffer.byteLength(payload),
|
|
137
|
+
'Cache-Control': 'no-store',
|
|
138
|
+
...headers,
|
|
139
|
+
});
|
|
140
|
+
res.end(payload);
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
export function createRestRouter({ core, pairing, host, tickets, config = {}, log = () => {} }) {
|
|
144
|
+
const { dev = false, clock = () => new Date() } = config;
|
|
145
|
+
|
|
146
|
+
const routes = [];
|
|
147
|
+
const route = (method, pattern, handler) => routes.push({ method, pattern, handler });
|
|
148
|
+
|
|
149
|
+
/**
|
|
150
|
+
* 诊断包(GW-9)。
|
|
151
|
+
*
|
|
152
|
+
* 取舍:宁可少给信息也不外发隐私 —— 不含设备 token、绝对路径、prompt 正文、产物内容。
|
|
153
|
+
* 同时附一份 `text`,用户可以长按复制直接发给支持人员,不必解释 JSON 结构。
|
|
154
|
+
*/
|
|
155
|
+
const buildDiagBundle = () => {
|
|
156
|
+
const info = host.info();
|
|
157
|
+
const stats = core.stats();
|
|
158
|
+
const ws = config.wsStats?.() ?? null;
|
|
159
|
+
const tunnel = config.tunnel?.status?.() ?? { state: 'disabled', executable: 'unknown' };
|
|
160
|
+
const generatedAt = clock().toISOString();
|
|
161
|
+
|
|
162
|
+
const stages = [
|
|
163
|
+
{ name: 'network', state: 'ok' },
|
|
164
|
+
{ name: 'transport', state: 'ok' },
|
|
165
|
+
{ name: 'auth', state: stats.pairing.activeDevices > 0 ? 'ok' : 'idle' },
|
|
166
|
+
{ name: 'identity', state: 'ok' },
|
|
167
|
+
{ name: 'handshake', state: stats.readySessions > 0 ? 'ok' : 'idle' },
|
|
168
|
+
{
|
|
169
|
+
name: 'tunnel',
|
|
170
|
+
state: tunnel.state === 'running' ? 'ok' : tunnel.state === 'failed' ? 'error' : 'idle',
|
|
171
|
+
},
|
|
172
|
+
];
|
|
173
|
+
|
|
174
|
+
const text = [
|
|
175
|
+
'DSH-mobile 诊断包',
|
|
176
|
+
`生成时间:${generatedAt}`,
|
|
177
|
+
`网关:${GATEWAY_VERSION}(adapter=${config.adapterKind || 'unknown'})`,
|
|
178
|
+
`宿主:${info.hostName} v${info.hostVersion} ${info.platform || ''}`.trim(),
|
|
179
|
+
'协议:1.0',
|
|
180
|
+
`运行时长:${stats.uptimeSec}s`,
|
|
181
|
+
`已配对设备:${stats.pairing.activeDevices}`,
|
|
182
|
+
`就绪会话:${stats.readySessions}`,
|
|
183
|
+
`WS:连接 ${ws?.connections ?? '?'} / 握手 ${ws?.handshakes ?? '?'} / 拒绝 ${ws?.rejects ?? '?'}`,
|
|
184
|
+
`隧道:${tunnel.state}${tunnel.url ? `(${tunnel.url})` : ''},可执行文件=${tunnel.executable}`,
|
|
185
|
+
'',
|
|
186
|
+
'脱敏说明:不含设备 token、绝对路径、prompt 正文与产物内容',
|
|
187
|
+
].join('\n');
|
|
188
|
+
|
|
189
|
+
return {
|
|
190
|
+
generatedAt,
|
|
191
|
+
gateway: {
|
|
192
|
+
version: GATEWAY_VERSION,
|
|
193
|
+
adapter: config.adapterKind || 'unknown',
|
|
194
|
+
protocolVersion: '1.0',
|
|
195
|
+
uptimeSec: stats.uptimeSec,
|
|
196
|
+
},
|
|
197
|
+
host: {
|
|
198
|
+
hostId: info.hostId,
|
|
199
|
+
hostName: info.hostName,
|
|
200
|
+
hostVersion: info.hostVersion,
|
|
201
|
+
platform: info.platform,
|
|
202
|
+
caps: info.caps,
|
|
203
|
+
},
|
|
204
|
+
stages,
|
|
205
|
+
transport: { lan: config.lanAddr?.() ?? config.addrs?.lan ?? null, tunnel, ws },
|
|
206
|
+
stats,
|
|
207
|
+
redaction: '已移除设备 token、绝对路径、prompt 正文与产物内容',
|
|
208
|
+
text,
|
|
209
|
+
};
|
|
210
|
+
};
|
|
211
|
+
|
|
212
|
+
const auth = (req) => {
|
|
213
|
+
const raw = req.headers.authorization || '';
|
|
214
|
+
if (!raw) throw fail(4001);
|
|
215
|
+
return pairing.verify(String(raw).replace(/^Bearer\s+/i, ''));
|
|
216
|
+
};
|
|
217
|
+
|
|
218
|
+
/**
|
|
219
|
+
* 隧道状态 = 进程态 + 开通态。两者必须一起看:
|
|
220
|
+
* · 进程 running 但没开通 → 只可能是 Quick Tunnel;
|
|
221
|
+
* · 已开通但进程 stopped → 地址是固定的,但此刻连不上,二维码不能写它。
|
|
222
|
+
*/
|
|
223
|
+
const tunnelSnapshot = () => {
|
|
224
|
+
const base = config.tunnel?.status?.() ?? { state: 'disabled', url: null, mode: 'disabled' };
|
|
225
|
+
const prov = config.tunnelProvisioner?.status?.() ?? null;
|
|
226
|
+
return {
|
|
227
|
+
...base,
|
|
228
|
+
mode: prov ? 'named' : (base.mode || 'quick'),
|
|
229
|
+
provisioned: Boolean(prov?.provisioned),
|
|
230
|
+
hostname: base.hostname ?? prov?.hostname ?? null,
|
|
231
|
+
provisionerKind: prov?.kind ?? null,
|
|
232
|
+
// 固定地址即使进程停了也照实给出来:桌面面板要能显示「地址是这个,当前未开启」
|
|
233
|
+
fixedUrl: prov?.url ?? null,
|
|
234
|
+
// 域名在公网上解析得到吗。false 时地址虽在、扫码却连不上(zone pending / NS 没指过来),
|
|
235
|
+
// 面板与二维码都要据此避开它,而不是让用户拿一个必然失败的地址去扫。
|
|
236
|
+
dnsOk: prov?.dnsOk ?? null,
|
|
237
|
+
warning: prov?.warning ?? null,
|
|
238
|
+
// 面板据此决定是否显示「自动安装 cloudflared」入口:仅在缺失且有官方构建时为 true。
|
|
239
|
+
canAutoInstall: base.executable === 'missing' && !!resolveAsset({}),
|
|
240
|
+
};
|
|
241
|
+
};
|
|
242
|
+
|
|
243
|
+
route('GET', /^\/mobile\/v1\/health$/, async (ctx) =>
|
|
244
|
+
send(ctx.res, 200, { ok: true, version: GATEWAY_VERSION, serverTime: clock().toISOString() }, DESKTOP_CORS)
|
|
245
|
+
);
|
|
246
|
+
|
|
247
|
+
/**
|
|
248
|
+
* 桌面端侧栏 banner 的状态摘要(lib/client.js 消费)。
|
|
249
|
+
*
|
|
250
|
+
* 回环-only + 无鉴权:监听面默认 127.0.0.1,LAN 模式下外部也拿不到(4003);
|
|
251
|
+
* 字段只含展示信息(版本 / 适配器 / 设备数 / 隧道态),绝不含 token、路径、prompt。
|
|
252
|
+
*/
|
|
253
|
+
route('GET', /^\/mobile\/v1\/desktop\/summary$/, async (ctx) => {
|
|
254
|
+
if (!isLoopbackRequest(ctx.req) || !isSameMachineOrigin(ctx.req)) {
|
|
255
|
+
throw fail(4003, '桌面端摘要只允许在主机本机读取');
|
|
256
|
+
}
|
|
257
|
+
const info = host.info();
|
|
258
|
+
const stats = core.stats();
|
|
259
|
+
const tunnel = tunnelSnapshot();
|
|
260
|
+
const connected = new Set(typeof core.connectedDeviceIds === 'function' ? core.connectedDeviceIds() : []);
|
|
261
|
+
// 面板要能点开看设备名并逐台下线:这里只给展示字段,绝不带凭证哈希/installId。
|
|
262
|
+
const devices = pairing.listDevices().map((d) => ({ ...d, online: connected.has(d.deviceId) }));
|
|
263
|
+
return send(ctx.res, 200, {
|
|
264
|
+
ok: true,
|
|
265
|
+
version: GATEWAY_VERSION,
|
|
266
|
+
adapter: config.adapterKind || 'unknown',
|
|
267
|
+
hostName: info.hostName,
|
|
268
|
+
// 手机端应填的局域网地址(IP:port);null 表示网关未绑公网/私网面或未就绪
|
|
269
|
+
lan: config.lanAddr?.() ?? null,
|
|
270
|
+
pairing: {
|
|
271
|
+
activeDevices: stats.pairing.activeDevices,
|
|
272
|
+
maxDevices: pairing.maxDevices,
|
|
273
|
+
onlineDevices: connected.size,
|
|
274
|
+
devices,
|
|
275
|
+
},
|
|
276
|
+
sessions: { ready: stats.readySessions },
|
|
277
|
+
tunnel,
|
|
278
|
+
uptimeSec: stats.uptimeSec,
|
|
279
|
+
serverTime: clock().toISOString(),
|
|
280
|
+
}, DESKTOP_CORS);
|
|
281
|
+
});
|
|
282
|
+
|
|
283
|
+
route('GET', /^\/mobile\/v1\/meta\/contract$/, async (ctx) =>
|
|
284
|
+
send(ctx.res, 200, {
|
|
285
|
+
contract: 'DSH-mobile gateway contract v0',
|
|
286
|
+
version: '0.2.0',
|
|
287
|
+
websocket: '/ws/mobile',
|
|
288
|
+
protocolVersion: '1.0',
|
|
289
|
+
capabilities: host.info().caps,
|
|
290
|
+
generatedAt: clock().toISOString(),
|
|
291
|
+
})
|
|
292
|
+
);
|
|
293
|
+
|
|
294
|
+
// 配对码只允许在回环地址生成:防止同网段任意设备刷码
|
|
295
|
+
route('POST', /^\/mobile\/v1\/pairing\/code$/, async (ctx) => {
|
|
296
|
+
if (!isLoopbackRequest(ctx.req) || !isSameMachineOrigin(ctx.req)) throw fail(4003, '配对码只允许在主机本机生成');
|
|
297
|
+
const body = await readJson(ctx.req);
|
|
298
|
+
// route 显式选路:面板双 banner(局域网 / 远程通道)各自出码。
|
|
299
|
+
// 缺省 auto——沿用「此刻最可能连通」的易用性原则,老客户端不受影响。
|
|
300
|
+
const route = body.route === undefined ? 'auto' : body.route;
|
|
301
|
+
if (!['auto', 'lan', 'tunnel'].includes(route)) throw fail(4400, `route 只支持 auto/lan/tunnel,收到 ${body.route}`);
|
|
302
|
+
const issued = pairing.issueCode({ deviceName: body.deviceName });
|
|
303
|
+
const info = host.info();
|
|
304
|
+
const lan = config.lanAddr?.() ?? null;
|
|
305
|
+
//
|
|
306
|
+
// 易用性原则:用户不该知道「局域网 / 隧道 / Mesh」这些词。二维码里放的是
|
|
307
|
+
// **此刻最可能连通的地址**——在家是同 Wi-Fi 的局域网 IP,出门前开了隧道
|
|
308
|
+
// 就是那个公网域名,扫码即连,不需要在手机上做任何选择。
|
|
309
|
+
// lan=True 时额外把局域网地址一并写进载荷,"addr" 始终是首选。
|
|
310
|
+
const tunnel = tunnelSnapshot();
|
|
311
|
+
// dnsOk === false 表示域名在公网解析不到:隧道进程可能确实连上了边缘,
|
|
312
|
+
// 但手机走这个域名必然是错误页。此时宁可退回局域网地址,也不要给一个假的可达地址。
|
|
313
|
+
const tunnelUsable = tunnel.dnsOk !== false;
|
|
314
|
+
const tunnelUrl = tunnel.state === 'running' && tunnelUsable ? tunnel.url : null;
|
|
315
|
+
// 显式 route 是面板按钮的语义承诺:点了「远程通道出码」就不能给一个局域网地址,
|
|
316
|
+
// 反之亦然。前置条件不满足就明说原因(4021, action=hideControl),别静默换路。
|
|
317
|
+
if (route === 'lan' && !lan) throw fail(4021, '未检测到局域网地址,请确认电脑已连上 Wi-Fi');
|
|
318
|
+
if (route === 'tunnel') {
|
|
319
|
+
if (!config.tunnel) throw fail(4021, '这台主机没有启用远程通道');
|
|
320
|
+
if (!tunnel.provisioned) throw fail(4021, '远程通道未开通,请先开通固定地址');
|
|
321
|
+
if (tunnel.state !== 'running') throw fail(4021, '远程通道未开启,请先点「开启远程」');
|
|
322
|
+
if (!tunnelUsable) throw fail(4021, '固定域名尚未在公网生效,暂时连不上,请稍后再试');
|
|
323
|
+
}
|
|
324
|
+
const primary = route === 'lan' ? lan : route === 'tunnel' ? tunnelUrl : (tunnelUrl ?? lan);
|
|
325
|
+
const parts = [];
|
|
326
|
+
if (primary) parts.push(`addr=${encodeURIComponent(primary)}`);
|
|
327
|
+
if (tunnelUrl && lan) parts.push(`lan=${encodeURIComponent(lan)}`);
|
|
328
|
+
parts.push(`c=${issued.code}`, `h=${info.hostId}`, `m=${tunnelUrl && primary === tunnelUrl ? 'tunnel' : lan ? 'lan' : 'none'}`);
|
|
329
|
+
const qrPayload = `dshm://pair?${parts.join('&')}`;
|
|
330
|
+
return send(ctx.res, 201, {
|
|
331
|
+
...issued,
|
|
332
|
+
qrPayload,
|
|
333
|
+
qrSvg: pairQrSvg(qrPayload),
|
|
334
|
+
// 桌面面板据此显示「手机扫码后走哪条路」,不再让用户自己猜
|
|
335
|
+
route: tunnelUrl && primary === tunnelUrl ? 'tunnel' : lan ? 'lan' : 'unknown',
|
|
336
|
+
// 面板要能解释「为什么有固定地址却给了局域网地址」
|
|
337
|
+
tunnelWarning: tunnel.warning ?? null,
|
|
338
|
+
address: primary,
|
|
339
|
+
host: { hostId: info.hostId, hostName: info.hostName, hostVersion: info.hostVersion },
|
|
340
|
+
}, DESKTOP_CORS);
|
|
341
|
+
});
|
|
342
|
+
|
|
343
|
+
route('POST', /^\/mobile\/v1\/pairing\/redeem$/, async (ctx) => {
|
|
344
|
+
const body = await readJson(ctx.req);
|
|
345
|
+
const device = pairing.redeem(body);
|
|
346
|
+
const info = host.info();
|
|
347
|
+
return send(ctx.res, 200, {
|
|
348
|
+
...device,
|
|
349
|
+
host: {
|
|
350
|
+
hostId: info.hostId,
|
|
351
|
+
hostName: info.hostName,
|
|
352
|
+
hostVersion: info.hostVersion,
|
|
353
|
+
platform: info.platform,
|
|
354
|
+
protocolVersion: '1.0',
|
|
355
|
+
caps: info.caps,
|
|
356
|
+
},
|
|
357
|
+
protocolVersion: '1.0',
|
|
358
|
+
caps: info.caps,
|
|
359
|
+
});
|
|
360
|
+
});
|
|
361
|
+
|
|
362
|
+
/**
|
|
363
|
+
* 单设备下线(桌面面板「已配对设备」里逐台操作)。
|
|
364
|
+
* 与全量 revoke 同样的管理面约束:只允许本机回环 + 同机 Origin;
|
|
365
|
+
* 面板没有 Bearer,所以不调 auth()——防的是同网段设备,不是本机用户。
|
|
366
|
+
* 撤销同时掐断该设备的 WS,避免旧连接在会话存活期间继续读任务数据。
|
|
367
|
+
*/
|
|
368
|
+
route('POST', /^\/mobile\/v1\/pairing\/revoke-device$/, async (ctx) => {
|
|
369
|
+
if (!isLoopbackRequest(ctx.req) || !isSameMachineOrigin(ctx.req)) {
|
|
370
|
+
throw fail(4003, '下线设备只允许在主机本机操作');
|
|
371
|
+
}
|
|
372
|
+
const body = await readJson(ctx.req);
|
|
373
|
+
const deviceId = String(body.deviceId || '');
|
|
374
|
+
if (!deviceId) throw fail(4400, '缺少 deviceId');
|
|
375
|
+
const revoked = pairing.revokeDevice(deviceId);
|
|
376
|
+
const droppedSessions = typeof core.dropSessionsByDevice === 'function'
|
|
377
|
+
? core.dropSessionsByDevice(deviceId) : 0;
|
|
378
|
+
log(`rest revoke device=${deviceId} revoked=${revoked} sessions=${droppedSessions}`);
|
|
379
|
+
return send(ctx.res, 200, {
|
|
380
|
+
revoked, droppedSessions, deviceId, allDevices: false, at: clock().toISOString(),
|
|
381
|
+
}, DESKTOP_CORS);
|
|
382
|
+
});
|
|
383
|
+
|
|
384
|
+
route('POST', /^\/mobile\/v1\/pairing\/revoke$/, async (ctx) => {
|
|
385
|
+
// 仅本机(借鉴 dsh-plugin-mobile-gateway:pair/revoke 管理面不暴露给局域网)。
|
|
386
|
+
// 撤销是全设备级动作,Bearer 只证明「是某台已配对设备」,
|
|
387
|
+
// 局域网内被攻陷的手机不该能把自己的同伴一起炸掉。
|
|
388
|
+
if (!isLoopbackRequest(ctx.req) || !isSameMachineOrigin(ctx.req)) throw fail(4003, '撤销设备只允许在主机本机操作');
|
|
389
|
+
auth(ctx.req);
|
|
390
|
+
const n = pairing.revokeAll();
|
|
391
|
+
log(`rest revoke all devices n=${n}`);
|
|
392
|
+
return send(ctx.res, 200, { revoked: n, allDevices: true, at: clock().toISOString() });
|
|
393
|
+
});
|
|
394
|
+
|
|
395
|
+
// WS 一次性票据(契约 v0.2 扩展,能力名 ws.ticket;宿主未声明该能力时客户端用 Bearer 降级)
|
|
396
|
+
route('POST', /^\/mobile\/v1\/ws-ticket$/, async (ctx) => {
|
|
397
|
+
const device = auth(ctx.req);
|
|
398
|
+
return send(ctx.res, 201, tickets.issue(device.deviceId));
|
|
399
|
+
});
|
|
400
|
+
|
|
401
|
+
route('GET', /^\/mobile\/v1\/host$/, async (ctx) => {
|
|
402
|
+
auth(ctx.req);
|
|
403
|
+
const info = host.info();
|
|
404
|
+
return send(ctx.res, 200, {
|
|
405
|
+
...info,
|
|
406
|
+
serverTime: clock().toISOString(),
|
|
407
|
+
addrs: config.addrs || { lan: null, tunnel: null },
|
|
408
|
+
});
|
|
409
|
+
});
|
|
410
|
+
|
|
411
|
+
route('GET', /^\/mobile\/v1\/diag$/, async (ctx) => {
|
|
412
|
+
auth(ctx.req);
|
|
413
|
+
const info = host.info();
|
|
414
|
+
const stats = core.stats();
|
|
415
|
+
const tunnelState = config.tunnel?.status?.().state ?? 'disabled';
|
|
416
|
+
// 宿主适配器自诊断(cordis:服务可见性 + 方法面取证;mock:无则省略)
|
|
417
|
+
const hostDiag = typeof host.diag === 'function' ? await host.diag().catch(() => null) : null;
|
|
418
|
+
return send(ctx.res, 200, {
|
|
419
|
+
gatewayVersion: GATEWAY_VERSION,
|
|
420
|
+
adapter: config.adapterKind || 'unknown',
|
|
421
|
+
hostVersion: info.hostVersion,
|
|
422
|
+
protocolVersion: '1.0',
|
|
423
|
+
uptimeSec: stats.uptimeSec,
|
|
424
|
+
...(hostDiag ? { hostDiag } : {}),
|
|
425
|
+
stages: [
|
|
426
|
+
{ name: 'network', state: 'ok' },
|
|
427
|
+
{ name: 'transport', state: 'ok' },
|
|
428
|
+
{ name: 'auth', state: stats.pairing.activeDevices > 0 ? 'ok' : 'idle' },
|
|
429
|
+
{ name: 'identity', state: 'ok' },
|
|
430
|
+
{ name: 'handshake', state: stats.readySessions > 0 ? 'ok' : 'idle' },
|
|
431
|
+
{
|
|
432
|
+
name: 'tunnel',
|
|
433
|
+
state: tunnelState === 'running' ? 'ok' : tunnelState === 'failed' ? 'error' : 'idle',
|
|
434
|
+
},
|
|
435
|
+
],
|
|
436
|
+
addr: { lan: config.lanAddr?.() ?? config.addrs?.lan ?? null, tunnel: config.tunnel?.status?.().url ?? null },
|
|
437
|
+
stats,
|
|
438
|
+
note: '地址与凭证已脱敏;导出日志不含 token、绝对路径、prompt 正文',
|
|
439
|
+
});
|
|
440
|
+
});
|
|
441
|
+
|
|
442
|
+
// 隧道(GW-8):Quick Tunnel 的启停与状态;named 模式额外支持开通固定地址。
|
|
443
|
+
// 启停是**管理面动作**:回环-only 且免设备凭证(桌面侧栏面板没有设备 token,
|
|
444
|
+
// 与配对码生成同模型)。未安装 cloudflared 时返回 4021 而不是 500——客户端据此隐藏入口。
|
|
445
|
+
const loopbackOnly = (ctx, message) => {
|
|
446
|
+
if (!isLoopbackRequest(ctx.req) || !isSameMachineOrigin(ctx.req)) throw fail(4003, message);
|
|
447
|
+
};
|
|
448
|
+
|
|
449
|
+
route('GET', /^\/mobile\/v1\/tunnel$/, async (ctx) => {
|
|
450
|
+
auth(ctx.req);
|
|
451
|
+
if (!config.tunnel) throw fail(4021, '隧道能力未启用', { method: 'tunnel.status' });
|
|
452
|
+
return send(ctx.res, 200, tunnelSnapshot());
|
|
453
|
+
});
|
|
454
|
+
|
|
455
|
+
/**
|
|
456
|
+
* 开通固定地址(Pro):一个 tunnel + 一个子域 + 一份 token。
|
|
457
|
+
*
|
|
458
|
+
* 幂等,可反复点:已开通且端口未变时直接返回既有地址,不再打 Cloudflare API。
|
|
459
|
+
* **绝不返回 token**——它只留在主机上给 cloudflared 用。
|
|
460
|
+
*/
|
|
461
|
+
route('POST', /^\/mobile\/v1\/tunnel\/provision$/, async (ctx) => {
|
|
462
|
+
loopbackOnly(ctx, '开通固定地址只允许在主机本机操作');
|
|
463
|
+
const provisioner = config.tunnelProvisioner;
|
|
464
|
+
if (!provisioner) {
|
|
465
|
+
throw fail(4021, '当前主机没有可用的固定地址开通器', {
|
|
466
|
+
detail: '配置 tunnel.provisioner=cloudflare(accountId + API Token)或 hosted(endpoint + enrollToken)',
|
|
467
|
+
});
|
|
468
|
+
}
|
|
469
|
+
const port = config.tunnel?.port;
|
|
470
|
+
const result = await provisioner.ensure({ port });
|
|
471
|
+
log(`rest tunnel provision ${result.hostname} (${result.created ? 'created' : 'reused'})`);
|
|
472
|
+
return send(ctx.res, 200, {
|
|
473
|
+
...result,
|
|
474
|
+
status: tunnelSnapshot(),
|
|
475
|
+
}, DESKTOP_CORS);
|
|
476
|
+
});
|
|
477
|
+
|
|
478
|
+
route('POST', /^\/mobile\/v1\/tunnel\/start$/, async (ctx) => {
|
|
479
|
+
loopbackOnly(ctx, '隧道启动只允许在主机本机操作');
|
|
480
|
+
if (!config.tunnel) throw fail(4021, '隧道能力未启用', { method: 'tunnel.start' });
|
|
481
|
+
// named 模式在这里顺带完成开通:桌面面板只有一个「开启远程」按钮,
|
|
482
|
+
// 不该让用户先点一次「开通」再点一次「启动」。
|
|
483
|
+
const status = await config.tunnel.start();
|
|
484
|
+
log(`rest tunnel start → ${status.state}${status.url ? ` ${status.url}` : ''}`);
|
|
485
|
+
return send(ctx.res, 200, { ...status, ...tunnelSnapshot() });
|
|
486
|
+
});
|
|
487
|
+
|
|
488
|
+
route('POST', /^\/mobile\/v1\/tunnel\/stop$/, async (ctx) => {
|
|
489
|
+
loopbackOnly(ctx, '隧道停止只允许在主机本机操作');
|
|
490
|
+
if (!config.tunnel) throw fail(4021, '隧道能力未启用', { method: 'tunnel.stop' });
|
|
491
|
+
const result = await config.tunnel.stop();
|
|
492
|
+
return send(ctx.res, 200, { ...tunnelSnapshot(), ...result });
|
|
493
|
+
|
|
494
|
+
});
|
|
495
|
+
|
|
496
|
+
/**
|
|
497
|
+
* 自举安装 cloudflared(每机首次开启远程)。回环-only:只有主机本机能触发下载执行。
|
|
498
|
+
* 面板必须先弹窗得到用户同意才调用此端点;服务端不做静默后台安装。
|
|
499
|
+
* 下载源固定为 Cloudflare 官方 Release,落点私有组件目录,不改系统 PATH。
|
|
500
|
+
*/
|
|
501
|
+
route('POST', /^\/mobile\/v1\/tunnel\/install-cloudflared$/, async (ctx) => {
|
|
502
|
+
loopbackOnly(ctx, '安装 cloudflared 只允许在主机本机操作');
|
|
503
|
+
if (!config.tunnel) throw fail(4021, '隧道能力未启用', { method: 'tunnel.installCloudflared' });
|
|
504
|
+
let result;
|
|
505
|
+
try {
|
|
506
|
+
result = await ensureCloudflared({ destDir: config.cloudflaredDir || undefined });
|
|
507
|
+
} catch (err) {
|
|
508
|
+
log(`rest tunnel install-cloudflared 失败 ${err?.code || ''} ${err?.message || err}`);
|
|
509
|
+
throw fail(4500, err?.message || '自动安装 cloudflared 失败', {
|
|
510
|
+
code: err?.code || 'INSTALL_FAILED',
|
|
511
|
+
});
|
|
512
|
+
}
|
|
513
|
+
log(`rest tunnel install-cloudflared ${result.reused ? '复用' : '已装'} ${result.executable}`);
|
|
514
|
+
// 立即重取状态:findCloudflared 已把组件目录纳入发现链,装完应马上从 missing 变 found。
|
|
515
|
+
return send(ctx.res, 200, { ...result, status: tunnelSnapshot() }, DESKTOP_CORS);
|
|
516
|
+
});
|
|
517
|
+
|
|
518
|
+
// 诊断包(GW-9):一次拿到可直接粘贴给支持人员的东西。
|
|
519
|
+
route('GET', /^\/mobile\/v1\/diag\/bundle$/, async (ctx) => {
|
|
520
|
+
auth(ctx.req);
|
|
521
|
+
return send(ctx.res, 200, buildDiagBundle());
|
|
522
|
+
});
|
|
523
|
+
|
|
524
|
+
route('GET', /^\/mobile\/v1\/tasks$/, async (ctx) => {
|
|
525
|
+
auth(ctx.req);
|
|
526
|
+
// includeArchived=1 切到「已归档」视图:与桌面端 archivedOnly 同口径,
|
|
527
|
+
// 只返回归档项。默认(false)与桌面端 sidebar 一致,归档项不占任务条。
|
|
528
|
+
const body = await host.listTasks({
|
|
529
|
+
status: ctx.url.searchParams.get('status') || undefined,
|
|
530
|
+
limit: Number(ctx.url.searchParams.get('limit')) || 50,
|
|
531
|
+
includeArchived: /^(1|true)$/i.test(ctx.url.searchParams.get('includeArchived') || ''),
|
|
532
|
+
});
|
|
533
|
+
// lastSeq 属于**网关的事件空间**(每任务独立自增),宿主并不掌握它。
|
|
534
|
+
// 宿主返回 0 会让客户端把这份快照判成「比事件旧」而拒用(实测:任务永远停在占位行,
|
|
535
|
+
// 标题与预算都补不上)。真相在环缓冲里,这里补齐。
|
|
536
|
+
body.items = body.items.map((item) => ({
|
|
537
|
+
...item,
|
|
538
|
+
lastSeq: Math.max(Number(item.lastSeq) || 0, core.events.maxSeq(item.taskId)),
|
|
539
|
+
}));
|
|
540
|
+
return send(ctx.res, 200, body);
|
|
541
|
+
});
|
|
542
|
+
|
|
543
|
+
route('POST', /^\/mobile\/v1\/tasks$/, async (ctx) => {
|
|
544
|
+
auth(ctx.req);
|
|
545
|
+
const body = await readJson(ctx.req);
|
|
546
|
+
const hasAttachments = Array.isArray(body.attachments) && body.attachments.length > 0;
|
|
547
|
+
if ((!body.prompt || String(body.prompt).trim().length === 0) && !hasAttachments) {
|
|
548
|
+
throw fail(4400, 'prompt 不能为空');
|
|
549
|
+
}
|
|
550
|
+
const key = body.submissionId || ctx.req.headers['idempotency-key'];
|
|
551
|
+
const result = await core.idempotent(key, () => host.createTask(body));
|
|
552
|
+
return send(ctx.res, 202, result);
|
|
553
|
+
});
|
|
554
|
+
|
|
555
|
+
route('GET', /^\/mobile\/v1\/tasks\/([^/]+)$/, async (ctx) => {
|
|
556
|
+
auth(ctx.req);
|
|
557
|
+
const body = await host.getTask(ctx.params[0]);
|
|
558
|
+
// 同上:seq 是网关的事实,不是宿主的。两处都补,避免一处真一处假。
|
|
559
|
+
const seq = core.events.maxSeq(body.task.taskId);
|
|
560
|
+
body.lastSeq = Math.max(Number(body.lastSeq) || 0, seq);
|
|
561
|
+
body.task.lastSeq = Math.max(Number(body.task.lastSeq) || 0, seq);
|
|
562
|
+
return send(ctx.res, 200, body);
|
|
563
|
+
});
|
|
564
|
+
|
|
565
|
+
// 会话历史页(FR-CHAT-01):宿主冷启动历史由 session/events 提供,
|
|
566
|
+
// 手机端「尚未收到数据」的根因就是这条缺失(此前只有 WS 增量、无历史)。
|
|
567
|
+
route('GET', /^\/mobile\/v1\/tasks\/([^/]+)\/events$/, async (ctx) => {
|
|
568
|
+
auth(ctx.req);
|
|
569
|
+
const beforeSeq = Number(ctx.url.searchParams.get('beforeSeq'));
|
|
570
|
+
const limit = Number(ctx.url.searchParams.get('limit')) || 60;
|
|
571
|
+
const page = await host.events(ctx.params[0], {
|
|
572
|
+
beforeSeq: Number.isFinite(beforeSeq) && beforeSeq > 0 ? beforeSeq : undefined,
|
|
573
|
+
limit: Math.min(Math.max(limit, 1), 200),
|
|
574
|
+
});
|
|
575
|
+
const translated = translateRecords(page.records);
|
|
576
|
+
// lastSeq 必须是**网关事件空间**的水位,不是宿主 seq 的水位。
|
|
577
|
+
//
|
|
578
|
+
// 历史条目的 seq 来自宿主(每个会话自己的计数,可能到几百),而实时帧用的是
|
|
579
|
+
// 网关环形缓冲的 seq(从 1 起)。两者混在同一个 `lastSeq` 里,客户端就会把
|
|
580
|
+
// 后续实时帧当成「重复的旧事件」全部丢掉——真机表现是「发消息没反应,
|
|
581
|
+
// 时间线一动不动」(2026-11-17 实测:历史 lastSeq=5,实时帧 seq=1..9 全被拒)。
|
|
582
|
+
//
|
|
583
|
+
// 所以:条目里的 seq 只用于客户端**排序**,水位一律取环缓冲当前最大值。
|
|
584
|
+
return send(ctx.res, 200, {
|
|
585
|
+
taskId: page.taskId,
|
|
586
|
+
items: translated.items,
|
|
587
|
+
lastSeq: core.events.maxSeq(page.taskId),
|
|
588
|
+
nextBeforeSeq: translated.nextBeforeSeq,
|
|
589
|
+
hasMore: page.hasMore,
|
|
590
|
+
});
|
|
591
|
+
});
|
|
592
|
+
|
|
593
|
+
route('GET', /^\/mobile\/v1\/tasks\/([^/]+)\/artifacts$/, async (ctx) => {
|
|
594
|
+
auth(ctx.req);
|
|
595
|
+
const body = await host.listArtifacts(ctx.params[0]);
|
|
596
|
+
return send(ctx.res, 200, body);
|
|
597
|
+
});
|
|
598
|
+
|
|
599
|
+
route('GET', /^\/mobile\/v1\/tasks\/([^/]+)\/artifacts\/([^/]+)$/, async (ctx) => {
|
|
600
|
+
auth(ctx.req);
|
|
601
|
+
// 文件字节由宿主适配器读出(它才掌握 cwd 与路径收边),网关只负责搬运。
|
|
602
|
+
// 不解 base64、不包 JSON:产物的常见用途是「在手机上直接看」,
|
|
603
|
+
// 包一层信封就得让客户端先落盘再解一次,图什么。
|
|
604
|
+
const file = await host.readArtifact(ctx.params[0], ctx.params[1]);
|
|
605
|
+
const data = file?.data ?? Buffer.alloc(0);
|
|
606
|
+
ctx.res.writeHead(200, {
|
|
607
|
+
'Content-Type': file?.mime ?? 'application/octet-stream',
|
|
608
|
+
'Content-Length': data.length,
|
|
609
|
+
'Cache-Control': 'no-store',
|
|
610
|
+
// inline:客户端(QuickLook / 浏览器)直接预览,不当附件下载
|
|
611
|
+
'Content-Disposition': `inline; filename*=UTF-8''${encodeURIComponent(file?.name ?? 'artifact')}`,
|
|
612
|
+
});
|
|
613
|
+
ctx.res.end(data);
|
|
614
|
+
});
|
|
615
|
+
|
|
616
|
+
route('POST', /^\/mobile\/v1\/tasks\/([^/]+)\/messages$/, async (ctx) => {
|
|
617
|
+
auth(ctx.req);
|
|
618
|
+
const body = await readJson(ctx.req);
|
|
619
|
+
const hasAttachments = Array.isArray(body.attachments) && body.attachments.length > 0;
|
|
620
|
+
if ((!body.text || !String(body.text).trim()) && !hasAttachments) {
|
|
621
|
+
throw fail(4400, 'text 不能为空');
|
|
622
|
+
}
|
|
623
|
+
// 纯附件消息允许 text 为空;宿主 content 只要求「非空文本或附件」。
|
|
624
|
+
const result = await core.idempotent(body.submissionId, () => host.appendMessage(ctx.params[0], body));
|
|
625
|
+
return send(ctx.res, 202, result);
|
|
626
|
+
});
|
|
627
|
+
|
|
628
|
+
route('POST', /^\/mobile\/v1\/tasks\/([^/]+)\/cancel$/, async (ctx) => {
|
|
629
|
+
auth(ctx.req);
|
|
630
|
+
const body = await readJson(ctx.req).catch(() => ({}));
|
|
631
|
+
const result = await core.idempotent(body.submissionId, () => host.cancelTask(ctx.params[0], body));
|
|
632
|
+
return send(ctx.res, 202, result);
|
|
633
|
+
});
|
|
634
|
+
|
|
635
|
+
// 保留位:用来验证"能力缺失应隐藏入口",而不是让客户端弹错
|
|
636
|
+
route('POST', /^\/mobile\/v1\/tasks\/([^/]+)\/rollback$/, async (ctx) => {
|
|
637
|
+
auth(ctx.req);
|
|
638
|
+
throw fail(4021, '回滚能力未实现', { method: 'tasks.rollback' });
|
|
639
|
+
});
|
|
640
|
+
|
|
641
|
+
route('POST', /^\/mobile\/v1\/tasks\/([^/]+)\/todos\/([^/]+)\/answer$/, async (ctx) => {
|
|
642
|
+
auth(ctx.req);
|
|
643
|
+
const body = await readJson(ctx.req);
|
|
644
|
+
if (!body.decision) throw fail(4400, 'decision 不能为空');
|
|
645
|
+
const result = await host.answerTodo(ctx.params[0], ctx.params[1], body);
|
|
646
|
+
return send(ctx.res, 200, result);
|
|
647
|
+
});
|
|
648
|
+
|
|
649
|
+
// 会话设置同步(2026-11-17):工作区权限与模型选择,与桌面端同源。
|
|
650
|
+
// 读 = 权限目录 + 当前值 + 模型目录一次拿全;写 = 两条直改端点。
|
|
651
|
+
// 宿主侧哪个面缺失由适配器降级 supported:false,网关不吞、也不替它编数据。
|
|
652
|
+
route('GET', /^\/mobile\/v1\/tasks\/([^/]+)\/settings$/, async (ctx) => {
|
|
653
|
+
auth(ctx.req);
|
|
654
|
+
const body = await host.sessionSettings(ctx.params[0]);
|
|
655
|
+
return send(ctx.res, 200, body);
|
|
656
|
+
});
|
|
657
|
+
|
|
658
|
+
route('POST', /^\/mobile\/v1\/tasks\/([^/]+)\/settings\/permission$/, async (ctx) => {
|
|
659
|
+
auth(ctx.req);
|
|
660
|
+
const body = await readJson(ctx.req);
|
|
661
|
+
if (!body.preset) throw fail(4400, 'preset 不能为空');
|
|
662
|
+
const result = await host.setPermission(ctx.params[0], body);
|
|
663
|
+
return send(ctx.res, 200, result);
|
|
664
|
+
});
|
|
665
|
+
|
|
666
|
+
route('POST', /^\/mobile\/v1\/tasks\/([^/]+)\/settings\/model$/, async (ctx) => {
|
|
667
|
+
auth(ctx.req);
|
|
668
|
+
const body = await readJson(ctx.req);
|
|
669
|
+
if (!body.provider || !body.model) throw fail(4400, 'provider 与 model 不能为空');
|
|
670
|
+
const result = await host.selectModel(ctx.params[0], body);
|
|
671
|
+
return send(ctx.res, 200, result);
|
|
672
|
+
});
|
|
673
|
+
|
|
674
|
+
// 会话动作(2026-11-18):与桌面端 Session 右键菜单同源。
|
|
675
|
+
// 置顶/归档/重命名/分叉都是即时生效的管理动作(非消息写队列),200 同步回执;
|
|
676
|
+
// 但带 submissionId 幂等,防手抖重复 fork 出两个会话。复制 ID 纯客户端,无路由。
|
|
677
|
+
route('POST', /^\/mobile\/v1\/tasks\/([^/]+)\/pin$/, async (ctx) => {
|
|
678
|
+
auth(ctx.req);
|
|
679
|
+
const body = await readJson(ctx.req).catch(() => ({}));
|
|
680
|
+
const pinned = body.pinned === undefined ? true : body.pinned === true;
|
|
681
|
+
const result = await core.idempotent(body.submissionId, () => host.pinTask(ctx.params[0], { pinned }));
|
|
682
|
+
return send(ctx.res, 200, result);
|
|
683
|
+
});
|
|
684
|
+
|
|
685
|
+
route('POST', /^\/mobile\/v1\/tasks\/([^/]+)\/archive$/, async (ctx) => {
|
|
686
|
+
auth(ctx.req);
|
|
687
|
+
const body = await readJson(ctx.req).catch(() => ({}));
|
|
688
|
+
const archived = body.archived === undefined ? true : body.archived === true;
|
|
689
|
+
const result = await core.idempotent(body.submissionId, () =>
|
|
690
|
+
host.archiveTask(ctx.params[0], { archived, stopActivity: body.stopActivity === true }));
|
|
691
|
+
return send(ctx.res, 200, result);
|
|
692
|
+
});
|
|
693
|
+
|
|
694
|
+
route('POST', /^\/mobile\/v1\/tasks\/([^/]+)\/rename$/, async (ctx) => {
|
|
695
|
+
auth(ctx.req);
|
|
696
|
+
const body = await readJson(ctx.req);
|
|
697
|
+
if (!body.title || !String(body.title).trim()) throw fail(4400, 'title 不能为空');
|
|
698
|
+
const result = await core.idempotent(body.submissionId, () => host.renameTask(ctx.params[0], body));
|
|
699
|
+
return send(ctx.res, 200, result);
|
|
700
|
+
});
|
|
701
|
+
|
|
702
|
+
route('POST', /^\/mobile\/v1\/tasks\/([^/]+)\/fork$/, async (ctx) => {
|
|
703
|
+
auth(ctx.req);
|
|
704
|
+
const body = await readJson(ctx.req).catch(() => ({}));
|
|
705
|
+
const result = await core.idempotent(body.submissionId, () => host.forkTask(ctx.params[0], body));
|
|
706
|
+
return send(ctx.res, 200, result);
|
|
707
|
+
});
|
|
708
|
+
|
|
709
|
+
// 提示词增强(2026-11-18):真调宿主模型,不绑定任务——新建页也能用。
|
|
710
|
+
// 刻意不做幂等缓存:模型输出非确定性,缓存反而会让「再增强一次」拿到旧结果。
|
|
711
|
+
// 防重复点击由客户端 loading 态负责。
|
|
712
|
+
route('POST', /^\/mobile\/v1\/prompt\/enhance$/, async (ctx) => {
|
|
713
|
+
auth(ctx.req);
|
|
714
|
+
const body = await readJson(ctx.req);
|
|
715
|
+
const result = await host.enhancePrompt({
|
|
716
|
+
text: body.text,
|
|
717
|
+
provider: body.provider,
|
|
718
|
+
model: body.model,
|
|
719
|
+
});
|
|
720
|
+
return send(ctx.res, 200, result);
|
|
721
|
+
});
|
|
722
|
+
|
|
723
|
+
if (dev) {
|
|
724
|
+
route('POST', /^\/__mock\/emit$/, async (ctx) => {
|
|
725
|
+
const body = await readJson(ctx.req);
|
|
726
|
+
// dev 注入的帧同时落进 mock 宿主的历史记录:否则 events() 与 WS 看到的
|
|
727
|
+
// 是两个世界(手机冷启动拉不到刚注入的时间线,实测 2026-11-18)。
|
|
728
|
+
host.ingestExternal?.(body.taskId, body.kind || 'log', body.data ?? {}, body.at);
|
|
729
|
+
const frame = core.publish({
|
|
730
|
+
taskId: body.taskId,
|
|
731
|
+
kind: body.kind || 'log',
|
|
732
|
+
data: body.data ?? { line: 'synthetic' },
|
|
733
|
+
at: body.at,
|
|
734
|
+
});
|
|
735
|
+
return send(ctx.res, 201, { emitted: frame });
|
|
736
|
+
});
|
|
737
|
+
route('GET', /^\/__mock\/state$/, async (ctx) =>
|
|
738
|
+
send(ctx.res, 200, { ...core.stats(), ws: config.wsStats?.() ?? null })
|
|
739
|
+
);
|
|
740
|
+
|
|
741
|
+
// 故障注入(S-1):三类必须可编程复现的失败
|
|
742
|
+
// 1) 宿主重启:换 gen + 清环 + 推 gateway 事件 + 1012 断开
|
|
743
|
+
route('POST', /^\/__mock\/restart-host$/, async (ctx) => {
|
|
744
|
+
const body = await readJson(ctx.req).catch(() => ({}));
|
|
745
|
+
return send(ctx.res, 200, core.restartHost(body?.reason || 'manual'));
|
|
746
|
+
});
|
|
747
|
+
// 2) seq 缺口:裁掉旧帧,让客户端游标早于环下界
|
|
748
|
+
route('POST', /^\/__mock\/gap$/, async (ctx) => {
|
|
749
|
+
const body = await readJson(ctx.req).catch(() => ({}));
|
|
750
|
+
if (!body?.taskId) return send(ctx.res, 400, { code: 4400, message: 'taskId 必填' });
|
|
751
|
+
return send(ctx.res, 200, core.injectGap(body.taskId, Number(body.keep) || 0));
|
|
752
|
+
});
|
|
753
|
+
// 3) 链路中断:不发 close 帧,直接断 socket
|
|
754
|
+
route('POST', /^\/__mock\/drop$/, async (ctx) => {
|
|
755
|
+
const n = config.dropAll?.() ?? 0;
|
|
756
|
+
log(`mock drop ${n} connection(s)`);
|
|
757
|
+
return send(ctx.res, 200, { dropped: n });
|
|
758
|
+
});
|
|
759
|
+
}
|
|
760
|
+
|
|
761
|
+
return async function handle(req, res) {
|
|
762
|
+
const traceId = newId('tr');
|
|
763
|
+
const url = new URL(req.url, 'http://127.0.0.1');
|
|
764
|
+
const ctxBase = { req, res, url, traceId };
|
|
765
|
+
|
|
766
|
+
try {
|
|
767
|
+
// 桌面端 banner 预检:JSON POST 会触发 preflight,白名单路径内直接应答。
|
|
768
|
+
if (req.method === 'OPTIONS' && DESKTOP_CORS_PATHS.some((p) => p.test(url.pathname))) {
|
|
769
|
+
res.writeHead(204, { ...DESKTOP_CORS, 'Access-Control-Max-Age': '600' });
|
|
770
|
+
return res.end();
|
|
771
|
+
}
|
|
772
|
+
for (const r of routes) {
|
|
773
|
+
if (r.method !== req.method) continue;
|
|
774
|
+
const m = r.pattern.exec(url.pathname);
|
|
775
|
+
if (!m) continue;
|
|
776
|
+
await r.handler({ ...ctxBase, params: m.slice(1) });
|
|
777
|
+
if (req.method !== 'GET') log(`rest ${req.method} ${url.pathname} ${res.statusCode}`);
|
|
778
|
+
return;
|
|
779
|
+
}
|
|
780
|
+
throw fail(4404);
|
|
781
|
+
} catch (err) {
|
|
782
|
+
const code = err.code && ERRORS[err.code] ? err.code : 4500;
|
|
783
|
+
const meta = ERRORS[code];
|
|
784
|
+
if (code === 4500) log(`rest ERR ${req.method} ${url.pathname} ${err.stack || err}`);
|
|
785
|
+
// 4xx 也要留痕:手机端「发不出去」在过去只能靠猜,因为业务拒绝(4400/4011/
|
|
786
|
+
// 4021/4007…)全是静默返回,日志里只有 500。一行就够定位。
|
|
787
|
+
else if (code === 4003) {
|
|
788
|
+
// 管理面拒绝要能区分「真公网/局域网请求」和「宿主 webview 被误伤」:
|
|
789
|
+
// 回环地址、无边缘头、同机 Origin 三个条件哪个没过,看一眼就知道。
|
|
790
|
+
const edgeHit = EDGE_HEADERS.filter((h) => req.headers[h] !== undefined);
|
|
791
|
+
log(`rest deny ${req.method} ${url.pathname} ${code} ${err.message || ''}`
|
|
792
|
+
+ ` src=${req.socket.remoteAddress}`
|
|
793
|
+
+ ` origin=${req.headers.origin ?? '-'}`
|
|
794
|
+
+ ` edge=${edgeHit.join('|') || '-'}`);
|
|
795
|
+
} else log(`rest deny ${req.method} ${url.pathname} ${code} ${err.message || ''}`);
|
|
796
|
+
const body = {
|
|
797
|
+
error: {
|
|
798
|
+
code,
|
|
799
|
+
message: err.message || meta.message,
|
|
800
|
+
...(err.extra?.detail ? { detail: err.extra.detail } : {}),
|
|
801
|
+
traceId,
|
|
802
|
+
...(err.extra?.retryAfterMs ? { retryAfterMs: err.extra.retryAfterMs } : {}),
|
|
803
|
+
...(err.extra?.attemptsRemaining !== undefined ? { retryAfterMs: err.extra.retryAfterMs, attemptsRemaining: err.extra.attemptsRemaining } : {}),
|
|
804
|
+
},
|
|
805
|
+
};
|
|
806
|
+
if (res.headersSent) return res.end();
|
|
807
|
+
// 白名单路径的错误响应也带 CORS——浏览器端要能读到 4003 等语义化错误
|
|
808
|
+
const headers = DESKTOP_CORS_PATHS.some((p) => p.test(url.pathname)) ? DESKTOP_CORS : {};
|
|
809
|
+
return send(res, meta.http, body, headers);
|
|
810
|
+
}
|
|
811
|
+
};
|
|
812
|
+
}
|