@bingine/cemem 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (138) hide show
  1. package/PORT-SCOPE.md +169 -0
  2. package/README.md +451 -2
  3. package/dist/cjs/addr/expression.js +650 -0
  4. package/dist/cjs/addr/expression.js.map +1 -0
  5. package/dist/cjs/addresslist/memory-record.js +612 -0
  6. package/dist/cjs/addresslist/memory-record.js.map +1 -0
  7. package/dist/cjs/asm/assembler.js +354 -0
  8. package/dist/cjs/asm/assembler.js.map +1 -0
  9. package/dist/cjs/asm/autoassembler-directives.js +362 -0
  10. package/dist/cjs/asm/autoassembler-directives.js.map +1 -0
  11. package/dist/cjs/asm/autoassembler.js +2163 -0
  12. package/dist/cjs/asm/autoassembler.js.map +1 -0
  13. package/dist/cjs/asm/backend.js +394 -0
  14. package/dist/cjs/asm/backend.js.map +1 -0
  15. package/dist/cjs/asm/disassembler.js +715 -0
  16. package/dist/cjs/asm/disassembler.js.map +1 -0
  17. package/dist/cjs/backend/dbk-backend.js +683 -0
  18. package/dist/cjs/backend/dbk-backend.js.map +1 -0
  19. package/dist/cjs/backend/native-ce-backend.js +667 -0
  20. package/dist/cjs/backend/native-ce-backend.js.map +1 -0
  21. package/dist/cjs/backend/self-backend.js +449 -0
  22. package/dist/cjs/backend/self-backend.js.map +1 -0
  23. package/dist/cjs/backend/types.js +48 -0
  24. package/dist/cjs/backend/types.js.map +1 -0
  25. package/dist/cjs/cheattable/ct-format.js +533 -0
  26. package/dist/cjs/cheattable/ct-format.js.map +1 -0
  27. package/dist/cjs/index.js +219 -0
  28. package/dist/cjs/index.js.map +1 -0
  29. package/dist/cjs/lua/aa.js +230 -0
  30. package/dist/cjs/lua/aa.js.map +1 -0
  31. package/dist/cjs/lua/addressing.js +118 -0
  32. package/dist/cjs/lua/addressing.js.map +1 -0
  33. package/dist/cjs/lua/api.js +736 -0
  34. package/dist/cjs/lua/api.js.map +1 -0
  35. package/dist/cjs/lua/asm.js +220 -0
  36. package/dist/cjs/lua/asm.js.map +1 -0
  37. package/dist/cjs/lua/bridge.js +526 -0
  38. package/dist/cjs/lua/bridge.js.map +1 -0
  39. package/dist/cjs/lua/marshal.js +562 -0
  40. package/dist/cjs/lua/marshal.js.map +1 -0
  41. package/dist/cjs/lua/memory.js +213 -0
  42. package/dist/cjs/lua/memory.js.map +1 -0
  43. package/dist/cjs/lua/objects.js +1070 -0
  44. package/dist/cjs/lua/objects.js.map +1 -0
  45. package/dist/cjs/lua/scan.js +543 -0
  46. package/dist/cjs/lua/scan.js.map +1 -0
  47. package/dist/cjs/lua/types.js +103 -0
  48. package/dist/cjs/lua/types.js.map +1 -0
  49. package/dist/cjs/scanner/matcher.js +781 -0
  50. package/dist/cjs/scanner/matcher.js.map +1 -0
  51. package/dist/cjs/scanner/pointer-scan.js +546 -0
  52. package/dist/cjs/scanner/pointer-scan.js.map +1 -0
  53. package/dist/cjs/scanner/scanner.js +513 -0
  54. package/dist/cjs/scanner/scanner.js.map +1 -0
  55. package/dist/cjs/scanner/shared-layout.js +207 -0
  56. package/dist/cjs/scanner/shared-layout.js.map +1 -0
  57. package/dist/cjs/types.js +190 -0
  58. package/dist/cjs/types.js.map +1 -0
  59. package/dist/cjs/value-codec.js +515 -0
  60. package/dist/cjs/value-codec.js.map +1 -0
  61. package/dist/cjs/win/process.js +475 -0
  62. package/dist/cjs/win/process.js.map +1 -0
  63. package/dist/cjs/win/scan-worker.js +84 -0
  64. package/dist/cjs/win/scan-worker.js.map +1 -0
  65. package/dist/cjs/win/winapi.js +403 -0
  66. package/dist/cjs/win/winapi.js.map +1 -0
  67. package/dist/types/addr/expression.d.ts +98 -0
  68. package/dist/types/addr/expression.d.ts.map +1 -0
  69. package/dist/types/addresslist/memory-record.d.ts +218 -0
  70. package/dist/types/addresslist/memory-record.d.ts.map +1 -0
  71. package/dist/types/asm/assembler.d.ts +106 -0
  72. package/dist/types/asm/assembler.d.ts.map +1 -0
  73. package/dist/types/asm/autoassembler-directives.d.ts +118 -0
  74. package/dist/types/asm/autoassembler-directives.d.ts.map +1 -0
  75. package/dist/types/asm/autoassembler.d.ts +434 -0
  76. package/dist/types/asm/autoassembler.d.ts.map +1 -0
  77. package/dist/types/asm/backend.d.ts +167 -0
  78. package/dist/types/asm/backend.d.ts.map +1 -0
  79. package/dist/types/asm/disassembler.d.ts +194 -0
  80. package/dist/types/asm/disassembler.d.ts.map +1 -0
  81. package/dist/types/backend/dbk-backend.d.ts +353 -0
  82. package/dist/types/backend/dbk-backend.d.ts.map +1 -0
  83. package/dist/types/backend/native-ce-backend.d.ts +213 -0
  84. package/dist/types/backend/native-ce-backend.d.ts.map +1 -0
  85. package/dist/types/backend/self-backend.d.ts +64 -0
  86. package/dist/types/backend/self-backend.d.ts.map +1 -0
  87. package/dist/types/backend/types.d.ts +176 -0
  88. package/dist/types/backend/types.d.ts.map +1 -0
  89. package/dist/types/cheattable/ct-format.d.ts +100 -0
  90. package/dist/types/cheattable/ct-format.d.ts.map +1 -0
  91. package/dist/types/index.d.ts +54 -0
  92. package/dist/types/index.d.ts.map +1 -0
  93. package/dist/types/lua/aa.d.ts +107 -0
  94. package/dist/types/lua/aa.d.ts.map +1 -0
  95. package/dist/types/lua/addressing.d.ts +41 -0
  96. package/dist/types/lua/addressing.d.ts.map +1 -0
  97. package/dist/types/lua/api.d.ts +46 -0
  98. package/dist/types/lua/api.d.ts.map +1 -0
  99. package/dist/types/lua/asm.d.ts +42 -0
  100. package/dist/types/lua/asm.d.ts.map +1 -0
  101. package/dist/types/lua/bridge.d.ts +129 -0
  102. package/dist/types/lua/bridge.d.ts.map +1 -0
  103. package/dist/types/lua/marshal.d.ts +244 -0
  104. package/dist/types/lua/marshal.d.ts.map +1 -0
  105. package/dist/types/lua/memory.d.ts +61 -0
  106. package/dist/types/lua/memory.d.ts.map +1 -0
  107. package/dist/types/lua/objects.d.ts +210 -0
  108. package/dist/types/lua/objects.d.ts.map +1 -0
  109. package/dist/types/lua/scan.d.ts +106 -0
  110. package/dist/types/lua/scan.d.ts.map +1 -0
  111. package/dist/types/lua/types.d.ts +146 -0
  112. package/dist/types/lua/types.d.ts.map +1 -0
  113. package/dist/types/scanner/matcher.d.ts +122 -0
  114. package/dist/types/scanner/matcher.d.ts.map +1 -0
  115. package/dist/types/scanner/pointer-scan.d.ts +187 -0
  116. package/dist/types/scanner/pointer-scan.d.ts.map +1 -0
  117. package/dist/types/scanner/scanner.d.ts +150 -0
  118. package/dist/types/scanner/scanner.d.ts.map +1 -0
  119. package/dist/types/scanner/shared-layout.d.ts +96 -0
  120. package/dist/types/scanner/shared-layout.d.ts.map +1 -0
  121. package/dist/types/types.d.ts +239 -0
  122. package/dist/types/types.d.ts.map +1 -0
  123. package/dist/types/value-codec.d.ts +134 -0
  124. package/dist/types/value-codec.d.ts.map +1 -0
  125. package/dist/types/win/process.d.ts +190 -0
  126. package/dist/types/win/process.d.ts.map +1 -0
  127. package/dist/types/win/scan-worker.d.ts +51 -0
  128. package/dist/types/win/scan-worker.d.ts.map +1 -0
  129. package/dist/types/win/winapi.d.ts +144 -0
  130. package/dist/types/win/winapi.d.ts.map +1 -0
  131. package/docs/assembler.md +371 -0
  132. package/docs/autoassembler.md +423 -0
  133. package/docs/backend-dbk.md +305 -0
  134. package/docs/backends.md +273 -0
  135. package/docs/evidence/atomics-wait-io.js +20 -0
  136. package/docs/evidence/mini-repro.js +98 -0
  137. package/docs/lua-api.md +718 -0
  138. package/package.json +60 -4
@@ -0,0 +1,513 @@
1
+ "use strict";
2
+ /**
3
+ * 扫描会话 —— 对齐 Cheat Engine `memscan.pas` 的 TMemScan / TScanController。
4
+ *
5
+ * 一次会话的典型生命周期(与 CE 界面操作一一对应):
6
+ * const scan = new ScanSession(process);
7
+ * scan.firstScan(cfg); // 首次扫描(对应 CE「首次扫描」)
8
+ * scan.nextScan({ ...cfg, scanOption: ScanOption.DecreasedValue }); // 再次扫描
9
+ * scan.results // bigint[] 结果地址
10
+ *
11
+ * 关键状态:
12
+ * - chunks:本会话实际读过的内存块(地址、长度)—— 对齐 CE 的 MemoryRegions 副本;
13
+ * - addressMap:块内偏移 → 结果地址 的换算依据;
14
+ * - snapshot:块原始内存副本 —— 对齐 CE 的 SecondaryAddressBuffer 机制,
15
+ * next scan 的「旧值」就来自这里。
16
+ *
17
+ * 性能:默认使用 worker 线程并行读取+比较(对齐 CE 的多线程扫描),
18
+ * 实测本机 ReadProcessMemory 约 1.9 GB/s。
19
+ */
20
+ Object.defineProperty(exports, "__esModule", { value: true });
21
+ exports.ScanSession = void 0;
22
+ const node_fs_1 = require("node:fs");
23
+ const node_fs_2 = require("node:fs");
24
+ const node_os_1 = require("node:os");
25
+ const node_path_1 = require("node:path");
26
+ /**
27
+ * 并行扫描路径的**取证日志**(默认关闭)。
28
+ *
29
+ * ## 为什么存在
30
+ *
31
+ * 并行扫描(worker 线程 + `Atomics.wait`)在并发跑多个测试文件时,**偶发**
32
+ * 会让进程**静默死亡**:退出码 1、stderr 为空、`'test failed'`、末尾若干用例
33
+ * 根本没跑到。已排除的原因:JS 异常(`uncaughtException` / `beforeExit` /
34
+ * 信号处理器全都不触发)、测试夹具(30 遍跟踪无泄漏)、进程隔离。
35
+ *
36
+ * 剩下的可能都指向**原生层**(worker 里的 koffi / WASM),而原生崩溃不给你
37
+ * 任何 JS 痕迹。所以这里留下一条"死在哪个点"的证据链。
38
+ *
39
+ * ## 用法
40
+ *
41
+ * 设 `CE_SCAN_DIAG=<文件路径>` 后,每次并行扫描会把
42
+ * create / postMessage / waitAll 开始结束 / terminate 逐点写入该文件。
43
+ * **刻意用 `appendFileSync`**:进程静默死亡时 stdout 的缓冲会丢,
44
+ * 同步落盘才能保住最后一行——**最后一行就是死点**。
45
+ *
46
+ * 默认(未设该环境变量)完全不做任何 I/O 与计时。
47
+ */
48
+ function diag(message) {
49
+ const file = process.env.CE_SCAN_DIAG;
50
+ if (file === undefined || file === '')
51
+ return;
52
+ try {
53
+ (0, node_fs_2.appendFileSync)(file, `${Date.now()} pid=${process.pid} ${message}\n`, 'utf8');
54
+ }
55
+ catch {
56
+ /* 取证失败绝不影响扫描 */
57
+ }
58
+ }
59
+ const node_worker_threads_1 = require("node:worker_threads");
60
+ const matcher_1 = require("./matcher");
61
+ const types_1 = require("../types");
62
+ const shared_layout_1 = require("./shared-layout");
63
+ /**
64
+ * 一个进程上的扫描会话。
65
+ *
66
+ * 与 CE 的差异说明:CE 的 TMemScan 与 GUI 强耦合(进度窗口、保存扫描结果文件),
67
+ * 这里保持纯数据/纯流程,进度通过回调暴露。
68
+ */
69
+ class ScanSession {
70
+ /** 本会话读过的内存块 */
71
+ chunks = [];
72
+ proc;
73
+ opts;
74
+ compiled = null;
75
+ config = null;
76
+ resultAddresses = [];
77
+ snapshotBytes = 0;
78
+ lastStats = null;
79
+ /** 是否有可比较的旧值(决定 next scan 的可用选项) */
80
+ hasOldValues = false;
81
+ /** 是否在下次扫描时忽略对齐(内部用) */
82
+ truncatedChunks = 0;
83
+ /** 并行路径中由主线程补扫的块数(worker 启动失败时 > 0) */
84
+ fallbackChunks = 0;
85
+ /** 并行路径被证明不可用时置位,后续扫描退化到单线程 */
86
+ parallelDisabled = false;
87
+ /** worker 池(惰性创建,跨扫描复用) */
88
+ workers = [];
89
+ workerReady = [];
90
+ constructor(process, options = {}) {
91
+ if (!process.isOpen)
92
+ throw new Error('扫描会话需要一个已打开的进程');
93
+ this.proc = process;
94
+ this.opts = {
95
+ blockSize: options.blockSize ?? 4 * 1024 * 1024,
96
+ parallel: options.parallel !== false,
97
+ workerCount: options.workerCount ?? Math.min(8, Math.max(1, (0, node_os_1.availableParallelism)() - 1)),
98
+ parallelMinBytes: options.parallelMinBytes ?? 96 * 1024 * 1024,
99
+ maxSnapshotBytes: options.maxSnapshotBytes ?? 1.5 * 1024 * 1024 * 1024,
100
+ onProgress: options.onProgress,
101
+ };
102
+ if (this.opts.blockSize <= 0)
103
+ throw new RangeError('blockSize 必须为正数');
104
+ }
105
+ get process() {
106
+ return this.proc;
107
+ }
108
+ /** 结果地址列表 */
109
+ get results() {
110
+ return this.resultAddresses;
111
+ }
112
+ /** 结果数量 */
113
+ get resultCount() {
114
+ return this.resultAddresses.length;
115
+ }
116
+ /** 上一次扫描的统计信息 */
117
+ get stats() {
118
+ return this.lastStats;
119
+ }
120
+ /** 是否可以继续 next scan(CE 里显示为「再次扫描」是否可用) */
121
+ get canNextScan() {
122
+ return this.compiled !== null && this.resultAddresses.length > 0;
123
+ }
124
+ /** 把扫描区域切成块,尽量与区域边界对齐。 */
125
+ buildChunks(regions, blockSize) {
126
+ const chunks = [];
127
+ for (const r of regions) {
128
+ let addr = r.baseAddress;
129
+ let remaining = r.memorySize;
130
+ while (remaining > 0n) {
131
+ const take = remaining > BigInt(blockSize) ? BigInt(blockSize) : remaining;
132
+ chunks.push({
133
+ address: addr,
134
+ size: Number(take),
135
+ snapshot: null,
136
+ offsets: [],
137
+ matches: null,
138
+ });
139
+ addr += take;
140
+ remaining -= take;
141
+ }
142
+ }
143
+ return chunks;
144
+ }
145
+ /* ---------------------------------------------------------------- *
146
+ * 首次扫描
147
+ * ---------------------------------------------------------------- */
148
+ /**
149
+ * 首次扫描。对应 CE 的 TMemScan.firstScan。
150
+ *
151
+ * @param config 扫描配置
152
+ */
153
+ firstScan(config) {
154
+ const started = Date.now();
155
+ const cc = (0, matcher_1.compileConfig)(config);
156
+ this.compiled = cc;
157
+ this.config = config;
158
+ // 1) 选区域
159
+ const maxAddress = config.is32Bit ? 0xffffffffn : undefined;
160
+ const regions = this.proc.scannableRegions({
161
+ writableOnly: config.writableOnly,
162
+ executableOnly: config.executableOnly,
163
+ includeImage: config.includeImage,
164
+ includeMapped: config.includeMapped,
165
+ includePrivate: config.includePrivate,
166
+ includeGuard: config.includeGuard,
167
+ maxAddress,
168
+ });
169
+ // 2) 切块
170
+ this.chunks.length = 0;
171
+ const newChunks = this.buildChunks(regions, this.opts.blockSize);
172
+ this.chunks.push(...newChunks);
173
+ // 3) 是否需要保留快照:只要后续可能做「旧值」比较就尽量保留
174
+ const keepSnapshot = true;
175
+ const totalBytes = this.chunks.reduce((a, c) => a + c.size, 0);
176
+ const canSnapshot = BigInt(totalBytes) <= BigInt(this.opts.maxSnapshotBytes);
177
+ // 4) 执行
178
+ const workersUsed = this.runScan(cc, this.chunks, keepSnapshot && canSnapshot);
179
+ this.snapshotBytes = this.chunks.reduce((a, c) => a + (c.snapshot ? c.size : 0), 0);
180
+ this.hasOldValues = this.snapshotBytes > 0;
181
+ this.collectResults();
182
+ const elapsedMs = Date.now() - started;
183
+ this.lastStats = {
184
+ regionsScanned: regions.length,
185
+ bytesScanned: BigInt(totalBytes),
186
+ elapsedMs,
187
+ resultCount: this.resultAddresses.length,
188
+ hasSnapshot: this.hasOldValues,
189
+ workersUsed,
190
+ };
191
+ return this.lastStats;
192
+ }
193
+ /* ---------------------------------------------------------------- *
194
+ * 再次扫描
195
+ * ---------------------------------------------------------------- */
196
+ /**
197
+ * 再次扫描。对应 CE 的 TMemScan.nextScan。
198
+ *
199
+ * 重要语义:nextScan 只在上一次的结果地址范围内重新比较,
200
+ * 因此需要上一次快照提供的「旧值」。若首次扫描时因内存上限未保留快照,
201
+ * 则只支持不需要旧值的选项(精确值/区间/大于/小于)。
202
+ */
203
+ nextScan(config) {
204
+ if (!this.compiled || !this.config) {
205
+ throw new Error('请先执行首次扫描');
206
+ }
207
+ if (this.resultAddresses.length === 0) {
208
+ throw new Error('上一次扫描没有结果,无法继续筛选');
209
+ }
210
+ const started = Date.now();
211
+ const cc = (0, matcher_1.compileConfig)(config);
212
+ const needsOld = (0, matcher_1.optionNeedsOldValue)(cc.option);
213
+ if (needsOld && !this.hasOldValues) {
214
+ throw new Error('该扫描选项需要上一次扫描的旧值,但本次会话没有保留内存快照(可能超过了 maxSnapshotBytes)。请改用精确值/区间类选项,或提高 maxSnapshotBytes 后重新首次扫描。');
215
+ }
216
+ // 对每个块重新读取内存并按块内偏移比较
217
+ const aliveChunks = this.chunks.filter((c) => c.offsets.length > 0);
218
+ if (aliveChunks.length === 0) {
219
+ throw new Error('上一次扫描没有结果,无法继续筛选');
220
+ }
221
+ this.runNextScan(cc, aliveChunks, needsOld);
222
+ this.compiled = cc;
223
+ this.config = config;
224
+ this.collectResults();
225
+ const elapsedMs = Date.now() - started;
226
+ this.lastStats = {
227
+ regionsScanned: aliveChunks.length,
228
+ bytesScanned: BigInt(aliveChunks.reduce((a, c) => a + c.size, 0)),
229
+ elapsedMs,
230
+ resultCount: this.resultAddresses.length,
231
+ hasSnapshot: this.hasOldValues,
232
+ workersUsed: 1,
233
+ };
234
+ return this.lastStats;
235
+ }
236
+ /* ---------------------------------------------------------------- *
237
+ * 内部实现
238
+ * ---------------------------------------------------------------- */
239
+ /** 首次扫描:单线程或 worker 并行。 */
240
+ runScan(cc, chunks, keepSnapshot) {
241
+ const snapshotLimit = this.opts.maxSnapshotBytes;
242
+ const totalBytes = chunks.reduce((a, c) => a + c.size, 0);
243
+ if (!this.opts.parallel ||
244
+ this.parallelDisabled ||
245
+ chunks.length < 4 ||
246
+ totalBytes < this.opts.parallelMinBytes) {
247
+ // 单线程路径:小扫描场景下 worker 启动开销(实测约 80ms/8 线程)
248
+ // 会盖过并行收益,因此只有足够大的扫描才走并行。
249
+ this.progressLoop(chunks, (chunk) => this.scanChunkSingle(cc, chunk, keepSnapshot));
250
+ return 1;
251
+ }
252
+ return this.runParallel(cc, chunks, keepSnapshot, snapshotLimit);
253
+ }
254
+ /** worker 并行路径:每个 worker 一个独立共享段,Atomics 同步等待。 */
255
+ runParallel(cc, chunks, keepSnapshot, snapshotLimit) {
256
+ const workerCount = Math.min(this.opts.workerCount, chunks.length);
257
+ if (workerCount <= 1) {
258
+ this.progressLoop(chunks, (chunk) => this.scanChunkSingle(cc, chunk, keepSnapshot));
259
+ return 1;
260
+ }
261
+ // scan-worker 编译产物位于 dist/cjs/win/,与 worker 源文件同目录
262
+ const workerPath = (0, node_path_1.join)(__dirname, '..', 'win', 'scan-worker.js');
263
+ if (!(0, node_fs_1.existsSync)(workerPath)) {
264
+ // 未编译时(例如 ts-node 直跑源码)退回单线程
265
+ this.progressLoop(chunks, (chunk) => this.scanChunkSingle(cc, chunk, keepSnapshot));
266
+ return 1;
267
+ }
268
+ const chunkCount = chunks.length;
269
+ // 轮转分配任务,尽量均衡
270
+ const batches = Array.from({ length: workerCount }, () => []);
271
+ chunks.forEach((c, i) => {
272
+ batches[i % workerCount].push({ index: i, address: c.address.toString(), size: c.size });
273
+ });
274
+ // 每批次的共享段:槽容量按"块大小/1"估计(最坏情况每字节都命中),
275
+ // 但受 DEFAULT_SLOT_CAPACITY 上限约束(超出则标记截断,由主线程补扫兜底)。
276
+ // 快照区按批次实际需要的内存上限分配。
277
+ const batches2 = batches.filter((b) => b.length > 0);
278
+ const prepared = batches2.map((batch) => {
279
+ const batchBytes = batch.reduce((a, j) => a + j.size, 0);
280
+ const arenaCapacity = keepSnapshot
281
+ ? Math.min(batchBytes, Math.floor((1_000_000_000 - 64 * 1024 * 1024) / Math.max(1, batches2.length)))
282
+ : 0;
283
+ const layout = (0, shared_layout_1.createBatchLayout)(batch.length, shared_layout_1.DEFAULT_SLOT_CAPACITY, Math.max(0, arenaCapacity));
284
+ return { batch, layout };
285
+ });
286
+ const workers = prepared.map(({ batch, layout }, workerIndex) => {
287
+ diag(`worker[${workerIndex}] create`);
288
+ const worker = new node_worker_threads_1.Worker(workerPath);
289
+ const req = {
290
+ type: 'scan',
291
+ pid: this.proc.pid,
292
+ config: this.config,
293
+ jobs: batch,
294
+ keepSnapshot,
295
+ shared: layout.buffer,
296
+ layoutParams: {
297
+ jobCount: batch.length,
298
+ slotCapacity: layout.slotCapacity,
299
+ arenaCapacity: layout.arenaCapacity,
300
+ },
301
+ };
302
+ worker.postMessage(req);
303
+ diag(`worker[${workerIndex}] postMessage(${batch.length} 个块)`);
304
+ return worker;
305
+ });
306
+ // 同步等待(Atomics.wait 会阻塞事件循环,正是这里需要的语义)
307
+ let allOk = true;
308
+ for (let i = 0; i < prepared.length; i += 1) {
309
+ const { layout } = prepared[i];
310
+ diag(`waitAll[${i}] 开始`);
311
+ if (!(0, shared_layout_1.waitAll)(layout, 0))
312
+ allOk = false;
313
+ diag(`waitAll[${i}] 结束`);
314
+ }
315
+ for (const [i, w] of workers.entries()) {
316
+ diag(`terminate[${i}]`);
317
+ void w.terminate();
318
+ }
319
+ diag(`runParallel 完成 allOk=${allOk}`);
320
+ if (!allOk) {
321
+ throw new Error('并行扫描超时未完成,请降低 blockSize 或关闭 parallel 后重试');
322
+ }
323
+ // 回收结果。worker 可能启动失败(目标进程在 worker 中打不开句柄等),
324
+ // 此时其块从未被处理,槽位会一直是"0 个命中",会静默丢结果。
325
+ // 因此逐块校验 handled 标记,未处理的块由主线程补扫。
326
+ let truncatedChunks = 0;
327
+ let fallbackChunks = 0;
328
+ prepared.forEach(({ batch, layout }, wi) => {
329
+ void wi;
330
+ batch.forEach((job, localIndex) => {
331
+ const chunk = chunks[job.index];
332
+ const handled = Atomics.load(layout.handled, localIndex) === 1;
333
+ if (!handled) {
334
+ this.scanChunkSingle(cc, chunk, keepSnapshot);
335
+ fallbackChunks++;
336
+ return;
337
+ }
338
+ const { offsets, truncated } = (0, shared_layout_1.readSlot)(layout, localIndex);
339
+ chunk.offsets = offsets;
340
+ chunk.matches = null;
341
+ if (truncated)
342
+ truncatedChunks++;
343
+ if (keepSnapshot) {
344
+ chunk.snapshot = (0, shared_layout_1.readSnapshot)(layout, localIndex, chunk.size);
345
+ }
346
+ });
347
+ });
348
+ this.truncatedChunks = truncatedChunks;
349
+ this.fallbackChunks = fallbackChunks;
350
+ // 若绝大多数块都由主线程补扫,说明并行不可用,后续退化到单线程
351
+ if (fallbackChunks > chunkCount / 2)
352
+ this.parallelDisabled = true;
353
+ const totalBytes = chunks.reduce((a, c) => a + c.size, 0);
354
+ this.opts.onProgress?.(BigInt(totalBytes), BigInt(totalBytes), BigInt(chunkCount));
355
+ return workerCount;
356
+ }
357
+ /** 单块扫描(单线程路径)。 */
358
+ scanChunkSingle(cc, chunk, keepSnapshot) {
359
+ const buf = this.proc.readMemory(chunk.address, chunk.size);
360
+ if (buf.length === 0) {
361
+ chunk.offsets = [];
362
+ chunk.matches = null;
363
+ return;
364
+ }
365
+ const offsets = [];
366
+ const perRule = cc.isAll ? [] : undefined;
367
+ (0, matcher_1.scanBlock)(cc, buf, null, offsets, perRule);
368
+ chunk.offsets = offsets;
369
+ chunk.matches = perRule ?? null;
370
+ if (keepSnapshot && offsets.length > 0) {
371
+ chunk.snapshot = Buffer.from(buf);
372
+ }
373
+ }
374
+ /** 单线程扫描循环,带进度回调。 */
375
+ progressLoop(chunks, fn) {
376
+ const total = chunks.reduce((a, c) => a + c.size, 0);
377
+ let scanned = 0;
378
+ chunks.forEach((c, i) => {
379
+ fn(c);
380
+ scanned += c.size;
381
+ this.opts.onProgress?.(BigInt(total), BigInt(scanned), BigInt(i + 1));
382
+ });
383
+ }
384
+ /** next scan:只在存活块的旧偏移上比较。 */
385
+ runNextScan(cc, chunks, needsOld) {
386
+ const totalBytes = chunks.reduce((a, c) => a + c.size, 0);
387
+ let scanned = 0;
388
+ for (const chunk of chunks) {
389
+ const buf = this.proc.readMemory(chunk.address, chunk.size);
390
+ scanned += chunk.size;
391
+ if (buf.length === 0) {
392
+ chunk.offsets = [];
393
+ chunk.matches = null;
394
+ this.opts.onProgress?.(BigInt(totalBytes), BigInt(scanned), BigInt(1));
395
+ continue;
396
+ }
397
+ const prev = needsOld ? chunk.snapshot : null;
398
+ const keptOffsets = [];
399
+ const keptMatches = cc.isAll ? [] : null;
400
+ for (const off of chunk.offsets) {
401
+ // 逐点比较:复用 scanBlock 的逻辑需要块级接口,
402
+ // 这里直接构造单点窗口,语义与 CE 的"只检查存活地址"一致。
403
+ const got = this.compareSingle(cc, buf, prev, off);
404
+ if (got !== null) {
405
+ keptOffsets.push(off);
406
+ if (keptMatches)
407
+ keptMatches.push(got);
408
+ }
409
+ }
410
+ chunk.offsets = keptOffsets;
411
+ chunk.matches = keptMatches;
412
+ // 更新快照,使多次 next scan 都能拿到"上一次"的原始值
413
+ if (needsOld && chunk.snapshot) {
414
+ chunk.snapshot = Buffer.from(buf);
415
+ }
416
+ else if (chunk.snapshot) {
417
+ chunk.snapshot = Buffer.from(buf);
418
+ }
419
+ }
420
+ }
421
+ /**
422
+ * 单点比较。返回命中的规则下标数组(all 模式),未命中返回 null。
423
+ *
424
+ * 实现方式:把该地址周围一小段窗口交给 scanBlock,
425
+ * 因此"命中"等价于 CE 在 SecondaryAddressBuffer 上做的逐点比较。
426
+ */
427
+ compareSingle(cc, buf, prev, off) {
428
+ // 复用 scanBlock:取一个刚好覆盖该偏移的窗口
429
+ const maxWidth = cc.rules.reduce((a, r) => Math.max(a, r.width), 0);
430
+ if (off + maxWidth > buf.length)
431
+ return null;
432
+ const window = buf.subarray(off, Math.min(buf.length, off + maxWidth));
433
+ const prevWindow = prev ? prev.subarray(off, Math.min(prev.length, off + maxWidth)) : null;
434
+ const offsets = [];
435
+ const perRule = cc.isAll ? [] : undefined;
436
+ (0, matcher_1.scanBlock)(cc, window, prevWindow, offsets, perRule);
437
+ if (offsets.length === 0 || offsets[0] !== 0)
438
+ return null;
439
+ return perRule?.[0] ?? [];
440
+ }
441
+ /** 把各块的块内偏移汇总成结果地址列表。 */
442
+ collectResults() {
443
+ const addresses = [];
444
+ for (const chunk of this.chunks) {
445
+ if (chunk.offsets.length === 0)
446
+ continue;
447
+ const base = chunk.address;
448
+ for (const off of chunk.offsets) {
449
+ addresses.push(base + BigInt(off));
450
+ }
451
+ // 释放不再需要的偏移数组外的内存压力
452
+ }
453
+ this.resultAddresses = addresses;
454
+ }
455
+ /* ---------------------------------------------------------------- *
456
+ * 结果访问
457
+ * ---------------------------------------------------------------- */
458
+ /** 读取结果地址列表(bigint)。 */
459
+ getResults() {
460
+ return this.resultAddresses.slice();
461
+ }
462
+ /** 读取结果地址与当前值。 */
463
+ getResultValues(type, max = Number.MAX_SAFE_INTEGER) {
464
+ const out = [];
465
+ const width = Math.max(1, this.widthOfType(type));
466
+ for (const addr of this.resultAddresses) {
467
+ if (out.length >= max)
468
+ break;
469
+ const buf = this.proc.readMemory(addr, width);
470
+ if (buf.length < width)
471
+ continue;
472
+ out.push({ address: addr, previous: buf });
473
+ }
474
+ return out;
475
+ }
476
+ widthOfType(type) {
477
+ switch (type) {
478
+ case types_1.VariableType.Byte:
479
+ return 1;
480
+ case types_1.VariableType.Word:
481
+ return 2;
482
+ case types_1.VariableType.DWord:
483
+ return 4;
484
+ case types_1.VariableType.QWord:
485
+ case types_1.VariableType.Double:
486
+ case types_1.VariableType.Pointer:
487
+ return 8;
488
+ case types_1.VariableType.Single:
489
+ return 4;
490
+ default:
491
+ return 4;
492
+ }
493
+ }
494
+ /** 清空会话状态。 */
495
+ reset() {
496
+ this.chunks.length = 0;
497
+ this.resultAddresses = [];
498
+ this.compiled = null;
499
+ this.config = null;
500
+ this.snapshotBytes = 0;
501
+ this.hasOldValues = false;
502
+ this.lastStats = null;
503
+ }
504
+ /** 释放 worker 资源(不关闭进程句柄)。 */
505
+ dispose() {
506
+ for (const w of this.workers)
507
+ void w.terminate();
508
+ this.workers = [];
509
+ this.workerReady = [];
510
+ }
511
+ }
512
+ exports.ScanSession = ScanSession;
513
+ //# sourceMappingURL=scanner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scanner.js","sourceRoot":"","sources":["../../../src/scanner/scanner.ts"],"names":[],"mappings":"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"}