@bingine/cemem 0.0.0-stage → 0.1.1

package/dist/types/types.d.ts

@@ -0,0 +1,239 @@
+/**
+ * 核心类型定义 —— 与 Cheat Engine 源码严格对齐。
+ *
+ * 对齐依据（`Cheat Engine/memscan.pas`）：
+ *   type TScanType=(stNewScan=0, stFirstScan=1, stNextScan=2);
+ *   type TRoundingType=(rtRounded=0,rtExtremerounded=1,rtTruncated=2);
+ *   type TVariableType=(vtByte=0, vtWord=1, vtDword=2, vtQword=3, vtSingle=4, vtDouble=5,
+ *      vtString=6, vtUnicodeString=7, vtByteArray=8, vtBinary=9, vtAll=10,
+ *      vtAutoAssembler=11, vtPointer=12, vtCustom=13, vtGrouped=14, vtByteArrays=15,
+ *      vtCodePageString=16);
+ *   type TPointerType=(ptStatic, ptDynamic, ptExecutable);
+ *   type TScanOption=(soUnknownValue, soExactValue, soValueBetween, soBiggerThan,
+ *      soSmallerThan, soIncreasedValue, soIncreasedValueBy, soDecreasedValue,
+ *      soDecreasedValueBy, soChanged, soUnchanged, soIncreasedValueByPercentage,
+ *      soDecreasedValueByPercentage, soValueBetweenPercentage);
+ */
+/** CE 的 TVariableType，枚举值与源码一一对应。 */
+export declare enum VariableType {
+    Byte = 0,
+    Word = 1,
+    DWord = 2,
+    QWord = 3,
+    Single = 4,
+    Double = 5,
+    String = 6,
+    UnicodeString = 7,
+    ByteArray = 8,
+    Binary = 9,
+    All = 10,
+    AutoAssembler = 11,
+    Pointer = 12,
+    Custom = 13,
+    Grouped = 14,
+    ByteArrays = 15,
+    CodePageString = 16
+}
+/** 类型名（用于命令行/日志） */
+export declare const VARIABLE_TYPE_NAMES: Record<VariableType, string>;
+/** 每种类型占用的字节宽度；变长/特殊类型为 0（由使用者显式给长度）。 */
+export declare const VARIABLE_TYPE_SIZES: Record<VariableType, number>;
+/** CE 的 TScanOption */
+export declare enum ScanOption {
+    UnknownValue = 0,
+    ExactValue = 1,
+    ValueBetween = 2,
+    BiggerThan = 3,
+    SmallerThan = 4,
+    IncreasedValue = 5,
+    IncreasedValueBy = 6,
+    DecreasedValue = 7,
+    DecreasedValueBy = 8,
+    Changed = 9,
+    Unchanged = 10,
+    IncreasedValueByPercentage = 11,
+    DecreasedValueByPercentage = 12,
+    ValueBetweenPercentage = 13
+}
+export declare const SCAN_OPTION_NAMES: Record<ScanOption, string>;
+/** CE 的 TRoundingType：浮点比较策略 */
+export declare enum RoundingType {
+    /** rtRounded=0 —— 四舍五入到小数位数后严格相等 */
+    Rounded = 0,
+    /** rtExtremerounded=1 —— 落在 [value-eps, value+eps] 区间 */
+    ExtremeRounded = 1,
+    /** rtTruncated=2 —— [value, value+step) 左闭右开 */
+    Truncated = 2
+}
+/** CE 的 TScanType */
+export declare enum ScanType {
+    NewScan = 0,
+    FirstScan = 1,
+    NextScan = 2
+}
+/** CE 的 TPointerType */
+export declare enum PointerType {
+    Static = 0,
+    Dynamic = 1,
+    Executable = 2
+}
+/** CE 的 TFastScanMethod */
+export declare enum FastScanMethod {
+    NotAligned = 0,
+    Aligned = 1,
+    LastDigits = 2
+}
+/** 指针类型集合（对齐 TPointerTypes = set of TPointerType） */
+export interface PointerTypes {
+    static?: boolean;
+    dynamic?: boolean;
+    executable?: boolean;
+}
+/** 创建"全部指针类型"的便捷值，对齐 CE 默认。 */
+export declare function allPointerTypes(): Required<PointerTypes>;
+/** 内存区域可读性/保护属性，对齐 TaccessRight */
+export interface AccessRights {
+    execute?: boolean;
+    read?: boolean;
+    write?: boolean;
+}
+/** CE 的 TMemoryRegion（精简，用于扫描配置） */
+export interface MemoryRegion {
+    baseAddress: bigint;
+    memorySize: bigint;
+    /** 该区域之前是否已有区域（CE: IsChild） */
+    isChild?: boolean;
+    /** VirtualQueryEx 的 State == MEM_COMMIT */
+    committed: boolean;
+    /** 原始 Protect 值 */
+    protect: number;
+    /** 分配类型：MEM_IMAGE / MEM_MAPPED / MEM_PRIVATE */
+    type: number;
+}
+/** 扫描过程中缓存的一块内存（原始内存副本 + 每条记录对应的原始值） */
+export interface ScannedRegion {
+    baseAddress: bigint;
+    size: number;
+    /** 提交状态的保护属性 */
+    protect: number;
+    /** 分配类型 MEM_IMAGE/MEM_MAPPED/MEM_PRIVATE */
+    memType: number;
+}
+/** 一条扫描结果 */
+export interface ScanResult {
+    address: bigint;
+    /** 首次扫描时若需要保存原始值，此处为该地址在本次扫描快照中的原始字节 */
+    previous?: Buffer;
+}
+/** 扫描进度回调，对齐 TMemScanGuiUpdateRoutine */
+export type ScanProgressCallback = (totalAddressesToScan: bigint, currentlyScanned: bigint, foundCount: bigint) => void;
+/** 扫描配置 */
+export interface ScanConfig {
+    /** 变量类型 */
+    variableType: VariableType;
+    /** 扫描选项 */
+    scanOption: ScanOption;
+    /** 浮点比较策略 */
+    roundingType: RoundingType;
+    /** 小数位数（CE: floataccuracy，-1 表示使用字符串中的小数位数） */
+    floatAccuracy: number;
+    /** 扫描值 1（字符串形式，便于精确复刻 CE 的解析行为） */
+    value1?: string;
+    /** 扫描值 2（区间上界 / 百分比上界） */
+    value2?: string;
+    /** 是否按十六进制解析输入值 */
+    hexadecimal?: boolean;
+    /** 符号有无（整数区间） */
+    signed?: boolean;
+    /** 字符串扫描是否区分大小写（CE 默认不区分） */
+    caseSensitive?: boolean;
+    /** 文本编码（vtString / vtCodePageString） */
+    codePage?: number;
+    /** 字符串/Unicode 长度（字符数）；未给出时由 value1 推导 */
+    stringLength?: number;
+    /** 是否仅在可写内存中扫描 */
+    writableOnly?: boolean;
+    /** 是否仅在可执行内存中扫描 */
+    executableOnly?: boolean;
+    /** 是否包含 MEM_IMAGE */
+    includeImage?: boolean;
+    /** 是否包含 MEM_MAPPED */
+    includeMapped?: boolean;
+    /** 是否包含 MEM_PRIVATE */
+    includePrivate?: boolean;
+    /** 是否包含 PAGE_GUARD 区域 */
+    includeGuard?: boolean;
+    /** 对齐方式 */
+    fastScanMethod?: FastScanMethod;
+    /** fsmLastDigits 时的最后一位数字 */
+    fastScanAlignmentLastDigits?: number;
+    /** 是否只在 4GB 以下地址扫描（32 位目标） */
+    is32Bit?: boolean;
+    /** 扫描块大小（字节），默认 4MB */
+    blockSize?: number;
+    /** 是否在浮点扫描时排除含指数的浮点数（CE: floatscanWithoutExponents） */
+    floatScanWithoutExponents?: boolean;
+    /** AOB 二进制串（vtBinary 用） */
+    binaryString?: string;
+    /** vtBinary 是否按十进制解析 */
+    binaryStringAsDecimal?: boolean;
+    /** 分组长扫描条目 */
+    groupElements?: GroupElement[];
+    /** 分组长扫描是否允许乱序 */
+    groupOutOfOrder?: boolean;
+    /** 分组长扫描是否要求按类型宽度对齐 */
+    groupAligned?: boolean;
+}
+/** CE 分组长扫描的单个条目（对齐 TGroupData 内部 record） */
+export interface GroupElement {
+    variableType: VariableType;
+    /** 通配符：只参与偏移计算，不比较数值 */
+    wildcard?: boolean;
+    value?: string;
+    value2?: string;
+    hexadecimal?: boolean;
+    signed?: boolean;
+    floatAccuracy?: number;
+    roundingType?: RoundingType;
+    /** 字符串长度（字符） */
+    stringLength?: number;
+    /** vtByteArray 数组 */
+    aob?: string;
+    /** 指针类型（通配符指针） */
+    pointerTypes?: PointerTypes;
+}
+/** 内存保护常量 */
+export declare const MEM_COMMIT = 4096;
+export declare const MEM_RESERVE = 8192;
+export declare const MEM_FREE = 65536;
+export declare const MEM_PRIVATE = 131072;
+export declare const MEM_MAPPED = 262144;
+export declare const MEM_IMAGE = 16777216;
+export declare const PAGE_NOACCESS = 1;
+export declare const PAGE_READONLY = 2;
+export declare const PAGE_READWRITE = 4;
+export declare const PAGE_WRITECOPY = 8;
+export declare const PAGE_EXECUTE = 16;
+export declare const PAGE_EXECUTE_READ = 32;
+export declare const PAGE_EXECUTE_READWRITE = 64;
+export declare const PAGE_EXECUTE_WRITECOPY = 128;
+export declare const PAGE_GUARD = 256;
+export declare const PAGE_NOCACHE = 512;
+export declare const PAGE_WRITECOMBINE = 1024;
+/** 进程访问权限常量 */
+export declare const PROCESS_TERMINATE = 1;
+export declare const PROCESS_CREATE_THREAD = 2;
+export declare const PROCESS_VM_OPERATION = 8;
+export declare const PROCESS_VM_READ = 16;
+export declare const PROCESS_VM_WRITE = 32;
+export declare const PROCESS_QUERY_INFORMATION = 1024;
+export declare const PROCESS_QUERY_LIMITED_INFORMATION = 4096;
+export declare const PROCESS_SUSPEND_RESUME = 2048;
+/**
+ * 打开进程所需的最小权限组合。
+ * 对齐 CE 的 ProcessHandler：读写 + 查询 + 分配/保护内存。
+ */
+export declare const DEFAULT_PROCESS_ACCESS: number;
+/** 64 位用户态最高地址（不含），用于 VirtualQueryEx 遍历上界。 */
+export declare const MAX_USER_ADDRESS_64 = 140737488355327n;
+//# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types/value-codec.d.ts

@@ -0,0 +1,134 @@
+/**
+ * 数值编解码层 —— 与 Cheat Engine `memscan.pas` 的变量类型语义严格对齐。
+ *
+ * 本模块负责三件事：
+ *  1. 从 Buffer 中按 CE 的变量类型读写数值（含大小端、精度、有符号/无符号）；
+ *  2. 复刻 CE 的扫描值解析（十六进制前缀、区间、百分比、小数位数 floataccuracy）；
+ *  3. 复刻 CE 的浮点比较策略（rtRounded / rtExtremerounded / rtTruncated）。
+ *
+ * 对齐依据：`memscan.pas` 的 SingleExact/DoubleExact/SingleBetween 等
+ *   以及 setScanValueFloat 片段（floataccuracy 计算、RoundTo 调用、min/max 边界）。
+ */
+import { RoundingType, VariableType } from './types';
+export declare function readUInt8(buf: Buffer, off: number): number;
+export declare function readInt8(buf: Buffer, off: number): number;
+export declare function readUInt16(buf: Buffer, off: number): number;
+export declare function readInt16(buf: Buffer, off: number): number;
+export declare function readUInt32(buf: Buffer, off: number): number;
+export declare function readInt32(buf: Buffer, off: number): number;
+export declare function readUInt64(buf: Buffer, off: number): bigint;
+export declare function readInt64(buf: Buffer, off: number): bigint;
+export declare function readSingle(buf: Buffer, off: number): number;
+export declare function readDouble(buf: Buffer, off: number): number;
+export declare function writeUInt8(buf: Buffer, off: number, v: number | bigint): void;
+export declare function writeUInt16(buf: Buffer, off: number, v: number | bigint): void;
+export declare function writeUInt32(buf: Buffer, off: number, v: number | bigint): void;
+export declare function writeUInt64(buf: Buffer, off: number, v: number | bigint): void;
+export declare function writeSingle(buf: Buffer, off: number, v: number): void;
+export declare function writeDouble(buf: Buffer, off: number, v: number): void;
+/** 按变量类型把值写入 buffer（写入路径的统一起点）。 */
+export declare function writeValue(buf: Buffer, off: number, type: VariableType, value: number | bigint | string): void;
+export declare function roundTo(value: number, decimals: number): number;
+export interface ParsedNumber {
+    /** 解析出的原始数值（无符号 64 位语义） */
+    raw: bigint;
+    /** 该值是否为负数写法（决定区间比较时用有符号解释） */
+    negative: boolean;
+    /** 是否按十六进制解析 */
+    hex: boolean;
+}
+/**
+ * 解析 CE 风格的整数字面量。
+ * 支持：十进制、`$`/`0x` 前缀十六进制、可选的 `+`/`-` 前缀。
+ * 无效时抛错，便于 CLI 给出明确提示。
+ */
+export declare function parseIntegerLiteral(input: string, forceHex?: boolean): ParsedNumber;
+/** 解析浮点字面量（支持科学计数法）。 */
+export declare function parseFloatLiteral(input: string): number;
+/** 统计字符串中的小数位数，对齐 CE 的 floataccuracy 推导。 */
+export declare function decimalsOf(input: string): number;
+export interface FloatCompareParams {
+    /** 目标值（double 语义） */
+    value: number;
+    /** 目标值（single 语义，CE: svalue） */
+    single: number;
+    /** 小数位数 */
+    accuracy: number;
+    /** 区间上界 */
+    value2?: number;
+    single2?: number;
+    /** extreme-rounded 边界 */
+    minSingle: number;
+    maxSingle: number;
+    minDouble: number;
+    maxDouble: number;
+    /** truncated 上界 */
+    maxTruncSingle: number;
+    maxTruncDouble: number;
+    /** 百分比模式下已换算为倍率的值 */
+    isPercentage: boolean;
+}
+/**
+ * 由用户输入推导浮点比较参数。
+ *
+ * 对齐 CE `setScanValueFloat`：
+ *   - floataccuracy = 去掉小数点后的位数（含 E 时置 0）
+ *   - 非百分比且 accuracy != 0 时，对 svalue/svalue2/dvalue/dvalue2 做 RoundTo(., -accuracy)
+ *   - accuracy != 0: min/max = value ∓ 1/10^accuracy
+ *     否则:        min/max = value ∓ 1
+ *   - truncated 模式 CE 使用 maxsvalue/maxdvalue 作为上界
+ */
+export declare function buildFloatCompareParams(value1: string, value2: string | undefined, isPercentage: boolean): FloatCompareParams;
+/** 对齐 TScanner.SingleExact（注意 rtExtremerounded 用闭区间 ≥/≤）。 */
+export declare function singleMatches(actual: number, p: FloatCompareParams, rounding: RoundingType): boolean;
+/** 对齐 TScanner.DoubleExact（注意 rtExtremerounded 用开区间 >/<）。 */
+export declare function doubleMatches(actual: number, p: FloatCompareParams, rounding: RoundingType): boolean;
+/** AOB 的单个字节模式：wildcard 或带可选半字节掩码。 */
+export interface PatternByte {
+    /** 是否为完全通配 */
+    wildcard: boolean;
+    /** 必须匹配的值 */
+    value: number;
+    /** 掩码（与上内存字节后的结果需等于 value） */
+    mask: number;
+}
+/**
+ * 解析 AOB 字符串，对齐 `parsers.ConvertStringToBytes` + 半字节通配支持。
+ *
+ * 支持：
+ *   - `90 90 ??`、`90,90,xx`、`9090??`（- 、 , 、空格均为分隔符，且允许两字符一组连写）
+ *   - 半字节通配 `7*`、`*7`，对齐 CE 的 $8000f070 / $80000f07 编码语义
+ */
+export declare function parseAob(input: string, hexadecimal?: boolean): PatternByte[];
+/** 判断 AOB 模式中是否含有半字节级通配（决定是否走慢路径）。 */
+export declare function aobHasNibbleWildcard(pattern: PatternByte[]): boolean;
+/** 在缓冲区指定偏移处比较 AOB 模式。 */
+export declare function aobMatchesAt(buf: Buffer, off: number, pattern: PatternByte[], nibbleSupport: boolean): boolean;
+/** vtBinary 的匹配参数，对齐 CE 的 andmask / bitmask 推导。 */
+export interface BinaryPattern {
+    andMask: bigint;
+    bitMask: bigint;
+    bitCount: number;
+}
+/**
+ * 由位串推导 andmask/bitmask，对齐 CE setScanValue 中 vtBinary 分支：
+ *   '?' 或 '*' → andmask 位 0，bitmask 位 0
+ *   '0' / '1'  → andmask 位 1，bitmask 位取该数字
+ */
+export declare function parseBinaryPattern(input: string): BinaryPattern;
+/** 位串在内存中的字节宽度（向上取整）。 */
+export declare function binaryByteWidth(bitCount: number): number;
+/** 对齐 testString：区分大小写 */
+export declare function testString(buf: Buffer, off: number, target: string): boolean;
+/** 对齐 testWideString：UTF-16LE 区分大小写 */
+export declare function testWideString(buf: Buffer, off: number, target: string): boolean;
+/** 对齐 CaseInsensitiveAnsiStringExact：仅 ASCII a-z 折叠为大写。 */
+export declare function testStringCI(buf: Buffer, off: number, upperTarget: string): boolean;
+/** 对齐 CaseInsensitiveUnicodeStringExact：用 UpCase 逐字符比较。 */
+export declare function testWideStringCI(buf: Buffer, off: number, target: string): boolean;
+/**
+ * 对齐 FPC 的 system.UpCase（宽字符版）：
+ * 只处理 Latin-1 的 a-z / à-þ 等基本区段，这里复刻 ASCII + Latin-1 行为。
+ */
+export declare function upCaseWide(c: number): number;
+//# sourceMappingURL=value-codec.d.ts.map

package/dist/types/value-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-codec.d.ts","sourceRoot":"","sources":["../../src/value-codec.ts"],"names":[],"mappings":"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"}

package/dist/types/win/process.d.ts

@@ -0,0 +1,190 @@
+/**
+ * 进程与内存访问层 —— 后端无关的门面。
+ *
+ * 本文件不再直接调用 Win32 API，而是委托给 `MemoryBackend`：
+ *   - `SelfBackend`      → 自研引擎（默认，本进程内直接调用 Win32）
+ *   - `NativeCeBackend`  → 原生 CE 兼容层（连接 ceserver 的 TCP 协议）
+ *
+ * 因此 `Process` 的用法在两种后端下完全一致：
+ * ```ts
+ * const p = Process.open(pid);                       // 默认自研后端
+ * const p2 = Process.open(pid, { backend: native }); // 走原生 CE
+ * ```
+ *
+ * 性能提示：CE 扫描时把整段内存拷进缓冲区再本地比较，本移植沿用同一思路，
+ * 因此后端只需要提供一个"按块读内存"的原语即可，比较逻辑全在上层。
+ */
+import { DEFAULT_PROCESS_ACCESS, MEM_COMMIT, MEM_IMAGE, MEM_MAPPED, MEM_PRIVATE, MemoryRegion, PAGE_GUARD } from '../types';
+import { BackendProcessHandle, BackendRegionFilter, MemoryBackend } from '../backend/types';
+export { isReadable, isWritable, isExecutable } from '../backend/self-backend';
+/** 取进程内共享的默认后端（自研引擎）。 */
+export declare function getDefaultBackend(): MemoryBackend;
+/** 替换默认后端（例如全局切到原生 CE）。传入 null 恢复自研后端。 */
+export declare function setDefaultBackend(backend: MemoryBackend | null): void;
+/** `Process.open` 的选项 */
+export interface OpenProcessOptions {
+    /** 使用哪个后端；省略则用默认后端 */
+    backend?: MemoryBackend;
+    /** 请求的进程访问权限（仅自研后端支持） */
+    access?: number;
+}
+export interface ProcessInfo {
+    pid: number;
+    name: string;
+    parentPid: number;
+    threadCount: number;
+    /** 是否存在同名多进程 */
+    duplicateName?: boolean;
+}
+/** 枚举全部进程（使用默认后端；同步后端专用，异步后端请用 listProcessesAsync） */
+export declare function listProcesses(backend?: MemoryBackend): ProcessInfo[];
+/** 按名字查进程（不区分大小写，包含匹配） */
+export declare function findProcessesByName(name: string, backend?: MemoryBackend): ProcessInfo[];
+/** 枚举全部进程（异步；对同步与异步后端都可用） */
+export declare function listProcessesAsync(backend?: MemoryBackend): Promise<ProcessInfo[]>;
+/** 按名字查进程（异步） */
+export declare function findProcessesByNameAsync(name: string, backend?: MemoryBackend): Promise<ProcessInfo[]>;
+/** 可扫描区域过滤条件，对齐 CE 的扫描设置 */
+export interface RegionFilter extends BackendRegionFilter {
+}
+/**
+ * 枚举进程内存区域。
+ *
+ * 只接受 `Process` 实例（早期版本接受裸 Win32 句柄，那样无法支持原生 CE 后端，
+ * 因此移除；请用 `process.regions()`）。
+ */
+export declare function enumerateRegions(process: Process, options?: {
+    includeFree?: boolean;
+    maxAddress?: bigint;
+}): MemoryRegion[];
+/** 选出"可扫描"的内存区域（对齐 CE 首次扫描的默认行为） */
+export declare function selectScannableRegions(process: Process, filter?: RegionFilter): MemoryRegion[];
+/** 打开进程失败时抛出的错误，带 pid 与 Win32 错误码（若后端提供）。 */
+export declare class ProcessOpenError extends Error {
+    readonly pid: number;
+    readonly win32Code: number;
+    constructor(pid: number, win32Code: number, message?: string);
+}
+export interface ProcessModule {
+    name: string;
+    path: string;
+    baseAddress: bigint;
+    size: number;
+}
+/**
+ * 一个已打开的目标进程。
+ *
+ * 生命周期：
+ * ```ts
+ * const p = Process.open(pid);
+ * try { ... } finally { p.close(); }
+ * ```
+ * 也支持 `using`（Symbol.dispose）。
+ */
+export declare class Process {
+    readonly pid: number;
+    readonly name: string;
+    readonly backend: MemoryBackend;
+    private readonly handle;
+    private closed;
+    private constructor();
+    /** 按 pid 打开进程（同步后端专用；异步后端请用 openProcessAsync） */
+    static open(pid: number, options?: OpenProcessOptions): Process;
+    /** 按进程名打开；同名多进程时选第一个 */
+    static openByName(name: string, options?: OpenProcessOptions): Process;
+    /** 按进程名打开全部同名进程 */
+    static openByNameAll(name: string, options?: OpenProcessOptions): Process[];
+    /**
+     * 由"已打开的后端句柄"构造 Process —— 供异步打开路径使用。
+     * 一般业务代码请用 `Process.open` / `openProcessAsync`。
+     */
+    static fromHandle(pid: number, name: string, backend: MemoryBackend, handle: BackendProcessHandle): Process;
+    get isOpen(): boolean;
+    /** 所属后端名称 */
+    get backendName(): string;
+    /**
+     * 底层后端句柄 —— 供需要直接调用后端的扩展代码使用
+     * （例如 Lua 桥要把句柄转成整数传给脚本）。
+     * 一般业务代码应优先使用 Process 的高层方法。
+     */
+    get backendHandle(): BackendProcessHandle;
+    private assertOpen;
+    /** 是否为 WOW64（32 位）进程 */
+    isWow64(): boolean;
+    /** 列出全部内存区域 */
+    regions(options?: {
+        includeFree?: boolean;
+        maxAddress?: bigint;
+    }): MemoryRegion[];
+    /** 列出可扫描区域 */
+    scannableRegions(filter?: RegionFilter): MemoryRegion[];
+    /**
+     * 读取内存。整块读取失败时由后端做二分回退。
+     * @returns 实际读到的数据（长度可能小于请求）
+     */
+    readMemory(address: bigint, size: number): Buffer;
+    /** 读取失败时抛错的严格版本 */
+    readMemoryExact(address: bigint, size: number): Buffer;
+    /**
+     * 写入内存。默认在写只读页前临时改保护（与 CE 的 writeprocessmemory 行为一致）。
+     * @returns 实际写入字节数
+     */
+    writeMemory(address: bigint, data: Buffer, fixProtection?: boolean): number;
+    /** 在目标进程内分配内存 */
+    allocate(size: number, protect?: number, address?: bigint): bigint;
+    /** 释放由 allocate 分配的内存 */
+    free(address: bigint): void;
+    /** 修改内存保护属性，返回旧保护值 */
+    protect(address: bigint, size: number, newProtect: number): number;
+    /** 列出进程模块 */
+    modules(): ProcessModule[];
+    /** 列出线程 id */
+    threadIds(): number[];
+    /**
+     * 挂起进程全部线程，返回可传给 resume() 的令牌。
+     * 仅自研后端支持（原生 CE 后端会抛错）。
+     */
+    suspend(): unknown;
+    /** 恢复之前挂起的线程 */
+    resume(token: unknown): void;
+    /** 关闭句柄。可重复调用。 */
+    close(): void;
+    /** 支持 `using` 语义 */
+    [Symbol.dispose](): void;
+    /** 异步关闭句柄 */
+    closeAsync(): Promise<void>;
+    /** 异步枚举全部内存区域 */
+    regionsAsync(options?: {
+        includeFree?: boolean;
+        maxAddress?: bigint;
+    }): Promise<MemoryRegion[]>;
+    /** 异步枚举可扫描区域 */
+    scannableRegionsAsync(filter?: RegionFilter): Promise<MemoryRegion[]>;
+    /** 异步读取内存 */
+    readMemoryAsync(address: bigint, size: number): Promise<Buffer>;
+    /** 异步读取内存（不足则抛错） */
+    readMemoryExactAsync(address: bigint, size: number): Promise<Buffer>;
+    /** 异步写入内存 */
+    writeMemoryAsync(address: bigint, data: Buffer, fixProtection?: boolean): Promise<number>;
+    /** 异步枚举模块 */
+    modulesAsync(): Promise<ProcessModule[]>;
+    /** 异步枚举线程 id */
+    threadIdsAsync(): Promise<number[]>;
+    /** 异步分配内存 */
+    allocateAsync(size: number, protect?: number, address?: bigint): Promise<bigint>;
+    /** 异步修改内存保护 */
+    protectAsync(address: bigint, size: number, newProtect: number): Promise<number>;
+    /** 异步判断是否 WOW64 */
+    isWow64Async(): Promise<boolean>;
+}
+/** 打开进程的异步变体（原生 CE 后端下必须用它）。 */
+export declare function openProcessAsync(pid: number, options?: OpenProcessOptions): Promise<Process>;
+/** 按名字打开进程（异步变体）。 */
+export declare function openProcessByNameAsync(name: string, options?: OpenProcessOptions): Promise<Process>;
+/** 展示用：区域类型的可读名字 */
+export declare function regionTypeName(type: number): string;
+/** 默认最大用户态地址（供上层限制扫描范围） */
+export declare const MAX_ADDRESS = 140737488355327n;
+/** 默认保护属性常量转发 */
+export { PAGE_GUARD, MEM_COMMIT, MEM_IMAGE, MEM_MAPPED, MEM_PRIVATE, DEFAULT_PROCESS_ACCESS };
+//# sourceMappingURL=process.d.ts.map

package/dist/types/win/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../src/win/process.ts"],"names":[],"mappings":"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"}

package/dist/types/win/scan-worker.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 扫描 worker —— 在独立线程中读取目标进程内存、执行比较，并把结果写入共享内存。
+ *
+ * 对应 CE 的 TScanner（TThread 子类）：CE 每条扫描线程负责一段内存，
+ * 通过临界区/信号量把结果写回主线程的地址缓冲区。
+ * 这里用 SharedArrayBuffer + Atomics 达到同样目的。
+ *
+ * 共享内存之所以必须共享：扫描 API 是同步的（对齐 CE 的阻塞语义），
+ * 主线程用 Atomics.wait 等待，此时无法处理 worker 的 postMessage。
+ *
+ * 容量约束：V8 对单个 SharedArrayBuffer 有约 1.5GB 上限，
+ * 因此每个 worker 批次使用**独立的、容量受控的**共享段，
+ * 而不是一个大段。详见 shared-layout.ts 的 createBatchLayout。
+ */
+import { ScanConfig } from '../types';
+/** 单个块的扫描任务 */
+export interface ScanJob {
+    /** 块的全局下标（用于主线程回收结果） */
+    index: number;
+    /** 块起始地址（十六进制字符串，避免 BigInt 在结构化克隆中的额外开销） */
+    address: string;
+    /** 块长度 */
+    size: number;
+}
+/** worker 收到的一次扫描任务 */
+export interface WorkerScanRequest {
+    type: 'scan';
+    /** 目标进程 pid */
+    pid: number;
+    /** 扫描配置 */
+    config: ScanConfig;
+    /** 本 worker 负责的块 */
+    jobs: ScanJob[];
+    /** 是否保留快照 */
+    keepSnapshot: boolean;
+    /** 本批次的共享内存本体（SAB 经结构化克隆后仍共享同一块内存） */
+    shared: SharedArrayBuffer;
+    /** 本批次的共享段容量参数 */
+    layoutParams: {
+        jobCount: number;
+        slotCapacity: number;
+        arenaCapacity: number;
+    };
+}
+/** worker 发出的消息 */
+export interface WorkerScanDone {
+    type: 'batchDone';
+    /** 本批次发生失败的块数 */
+    failed: number;
+}
+//# sourceMappingURL=scan-worker.d.ts.map

package/dist/types/win/scan-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-worker.d.ts","sourceRoot":"","sources":["../../../src/win/scan-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,eAAe;AACf,MAAM,WAAW,OAAO;IACtB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU;IACV,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uBAAuB;AACvB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,oBAAoB;IACpB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,aAAa;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,sCAAsC;IACtC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,kBAAkB;IAClB,YAAY,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,mBAAmB;AACnB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB"}