@windsland52/maafw-live 0.0.0-stage → 0.3.0

package/lib/interface/jsonc.js.map

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

package/lib/interface/load.js

@@ -0,0 +1,307 @@
+/**
+ * 载入项目 interface.json（ProjectInterface v2）。
+ *
+ * 只做本工具需要的窄解析：控制器声明（连接规划用）、资源声明（路径解析用）、任务入口
+ * （run --project 用）。其余字段（task 参数、option、i18n 等）不属于 CLI 的职责，原样忽略。
+ * 全过程不抛异常：问题进 problems[]，由调用方决定怎么呈现。
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { parseJsonc } from './jsonc.js';
+/** 找 interface.json：项目根优先，其次 assets/（部分项目把声明放资源目录下）。 */
+const REL_CANDIDATES = ['interface.json', 'assets/interface.json'];
+export function findInterfaceFile(dir) {
+    const base = resolve(dir);
+    for (const rel of REL_CANDIDATES) {
+        const p = join(base, rel);
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+function str(v) {
+    return typeof v === 'string' && v.trim() ? v : undefined;
+}
+function num(v) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : undefined;
+}
+function strList(v) {
+    if (typeof v === 'string')
+        return [v];
+    if (Array.isArray(v))
+        return v.filter((x) => typeof x === 'string' && x.length > 0);
+    return [];
+}
+function obj(v) {
+    return v && typeof v === 'object' && !Array.isArray(v) ? v : null;
+}
+export function loadInterface(dir) {
+    const file = findInterfaceFile(dir);
+    const base = {
+        file,
+        dir: file ? dirname(file) : null,
+        version: null,
+        name: null,
+        controllers: [],
+        resources: [],
+        tasks: [],
+        options: {},
+        presets: [],
+        globalOption: [],
+        pretask: [],
+        agents: [],
+        problems: [],
+    };
+    if (!file) {
+        return { ...base, problems: [{ message: '未找到 interface.json（找过 ' + REL_CANDIDATES.join(' / ') + '）' }] };
+    }
+    let raw;
+    try {
+        raw = parseJsonc(readFileSync(file, 'utf8'));
+    }
+    catch (e) {
+        return { ...base, problems: [{ message: 'interface.json 解析失败：' + String(e.message) }] };
+    }
+    const o = obj(raw);
+    if (!o)
+        return { ...base, problems: [{ message: 'interface.json 顶层必须是对象' }] };
+    const problems = [];
+    const version = num(o.interface_version);
+    if (version === undefined)
+        problems.push({ message: '缺少 interface_version（ProjectInterface v2 应为 2）' });
+    else if (version !== 2)
+        problems.push({ message: 'interface_version=' + version + '；本工具按 v2 解析，可能有出入' });
+    const controllers = [];
+    for (const item of Array.isArray(o.controller) ? o.controller : []) {
+        const c = obj(item);
+        const name = c ? str(c.name) : undefined;
+        const type = c ? str(c.type) : undefined;
+        if (!c || !name || !type) {
+            problems.push({ message: 'controller 项缺少 name 或 type，已跳过' });
+            continue;
+        }
+        const display = {};
+        const ss = num(c.display_short_side);
+        if (ss !== undefined)
+            display.shortSide = ss;
+        const ls = num(c.display_long_side);
+        if (ls !== undefined)
+            display.longSide = ls;
+        if (c.display_raw === true)
+            display.raw = true;
+        if (Array.isArray(c.display_expand) && c.display_expand.length === 2) {
+            const a = num(c.display_expand[0]);
+            const b = num(c.display_expand[1]);
+            if (a !== undefined && b !== undefined)
+                display.expand = [a, b];
+        }
+        const w = obj(c.win32);
+        const g = obj(c.gamepad);
+        controllers.push({
+            name,
+            type,
+            display: Object.keys(display).length ? display : undefined,
+            win32: w
+                ? {
+                    classRegex: str(w.class_regex),
+                    windowRegex: str(w.window_regex),
+                    screencap: str(w.screencap),
+                    mouse: str(w.mouse),
+                    keyboard: str(w.keyboard),
+                }
+                : undefined,
+            gamepad: g
+                ? {
+                    classRegex: str(g.class_regex),
+                    windowRegex: str(g.window_regex),
+                    gamepadType: str(g.gamepad_type),
+                    screencap: str(g.screencap),
+                }
+                : undefined,
+            attachResourcePath: strList(c.attach_resource_path),
+            option: strList(c.option),
+        });
+    }
+    if (!controllers.length)
+        problems.push({ message: 'controller[] 为空：项目没有声明任何控制器' });
+    const resources = [];
+    for (const item of Array.isArray(o.resource) ? o.resource : []) {
+        const r = obj(item);
+        const name = r ? str(r.name) : undefined;
+        const paths = r ? strList(r.path) : [];
+        if (!r || !name || !paths.length) {
+            problems.push({ message: 'resource 项缺少 name 或 path，已跳过' });
+            continue;
+        }
+        resources.push({ name, paths, controllers: strList(r.controller), option: strList(r.option) });
+    }
+    const tasks = [];
+    const options = {};
+    const presets = [];
+    const globalOption = [];
+    const pretask = [];
+    const agents = [];
+    const readAgents = (list) => {
+        for (const item of Array.isArray(list) ? list : (list !== undefined ? [list] : [])) {
+            const a = obj(item);
+            const exec = a ? str(a.child_exec) : undefined;
+            if (!a || !exec)
+                continue;
+            agents.push({ exec, args: strList(a.child_args) });
+        }
+    };
+    const readTasks = (list, src) => {
+        for (const item of Array.isArray(list) ? list : []) {
+            const t = obj(item);
+            const name = t ? str(t.name) : undefined;
+            if (!t || !name) {
+                problems.push({ message: 'task 项缺少 name，已跳过（' + src + '）' });
+                continue;
+            }
+            tasks.push({
+                name,
+                entry: str(t.entry),
+                controller: strList(t.controller),
+                resource: strList(t.resource),
+                option: strList(t.option),
+            });
+        }
+    };
+    const readOptions = (dict, src) => {
+        const d = obj(dict);
+        if (!d) {
+            if (dict !== undefined)
+                problems.push({ message: 'option 应为对象（键=配置项名），已忽略（' + src + '）' });
+            return;
+        }
+        for (const [key, val] of Object.entries(d)) {
+            const v = obj(val);
+            if (!v || !str(v.type)) {
+                problems.push({ message: 'option ' + key + ' 缺少 type，已跳过（' + src + '）' });
+                continue;
+            }
+            const cases = [];
+            for (const cs of Array.isArray(v.cases) ? v.cases : []) {
+                const c2 = obj(cs);
+                const cname = c2 ? str(c2.name) : undefined;
+                if (!c2 || !cname)
+                    continue;
+                const po = obj(c2.pipeline_override);
+                cases.push({
+                    name: cname,
+                    ...(po ? { pipelineOverride: po } : {}),
+                    option: strList(c2.option),
+                });
+            }
+            options[key] = {
+                name: key,
+                type: String(v.type),
+                cases,
+                ...(v.default_case !== undefined ? { defaultCase: v.default_case } : {}),
+                controller: strList(v.controller),
+                resource: strList(v.resource),
+            };
+        }
+    };
+    const readPresets = (list) => {
+        for (const item of Array.isArray(list) ? list : []) {
+            const p = obj(item);
+            const name = p ? str(p.name) : undefined;
+            if (!p || !name)
+                continue;
+            const tlist = [];
+            for (const tp of Array.isArray(p.task) ? p.task : []) {
+                const t2 = obj(tp);
+                const tname = t2 ? str(t2.name) : undefined;
+                if (!t2 || !tname)
+                    continue;
+                const pv = obj(t2.option);
+                tlist.push({ name: tname, enabled: t2.enabled !== false, ...(pv ? { option: pv } : {}) });
+            }
+            presets.push({ name, task: tlist });
+        }
+    };
+    readTasks(o.task, '主文件');
+    readOptions(o.option, '主文件');
+    readPresets(o.preset);
+    readAgents(o.agent);
+    for (const g of strList(o.global_option))
+        if (!globalOption.includes(g))
+            globalOption.push(g);
+    const mainPretasks = Array.isArray(o.pretask) ? o.pretask : (o.pretask !== undefined ? [o.pretask] : []);
+    for (const pt of mainPretasks) {
+        const p2 = obj(pt);
+        if (p2)
+            pretask.push({ name: str(p2.name), exec: str(p2.exec) });
+    }
+    /* import 合并（v2.2.0）：只合 task/option/preset/global_option/pretask（及 group/setting，本工具不消费）。
+     * controller/resource 不可导入——子文件声明了也忽略并记 problems。循环导入用 visited 集合挡住。
+     *
+     * 上游口径（MaaFW 5.14.2 @ 8061d5b，逐条核过）：
+     *  - 被 import 的文件由 tools/interface_import.schema.json 约束（描述原文："用于 interface.json 的
+     *    import 字段引用的文件"），顶层只有 task/option/pretask/global_option/setting/preset，且
+     *    `additionalProperties: false` → **`import` 不可嵌套**、`agent` 也不在其中；
+     *  - 协议文档 3.3 的 import 节把 `group` 列进可导入字段（v2.4.0，合并表里也有 group 行），
+     *    而 5.14.2 的 import schema 顶层**没有 group** → 文档与 schema 不一致（上游漂移）。
+     *    **后续：上游已就这条提 PR，结论是"改 schema"**（即 import 文件将来可以合法带 group）。
+     *    我们的行为不变——group 本工具不消费，因此既不合并也不报错；真要用到 UI 分组时再说。
+     *  - `agent` 不在 import schema 里，但本工具**宽容读取**（下面的 readAgents）：这是超出协议的扩展，
+     *    只影响"文件结构校验收紧的工具"与我们的行为差异，实现上进 candidates 前仍会如实报 problems。 */
+    const seen = new Set([file]);
+    const imports = strList(o.import);
+    for (const rel of imports) {
+        const childFile = join(dirname(file), rel);
+        if (seen.has(childFile)) {
+            problems.push({ message: 'import 循环引用，已跳过：' + rel });
+            continue;
+        }
+        seen.add(childFile);
+        let child = null;
+        try {
+            child = obj(parseJsonc(readFileSync(childFile, 'utf8')));
+        }
+        catch (e) {
+            problems.push({ message: 'import 文件读取/解析失败：' + rel + '（' + String(e.message) + '）' });
+            continue;
+        }
+        if (!child)
+            continue;
+        if (child.controller !== undefined || child.resource !== undefined) {
+            problems.push({ message: 'import 文件 ' + rel + ' 声明了 controller/resource：协议不可导入，已忽略' });
+        }
+        /* import 不可嵌套：被引用的文件由 interface_import.schema.json 约束（MaaFW 5.14.2，
+         * 顶层只有 task/option/pretask/global_option/setting/preset 且 additionalProperties: false，
+         * 文档 3.3 的 import 节也没有嵌套写法）。静默吞掉会让"二级文件"整份消失得无影无踪，
+         * 所以这里记一条 problem——它通常意味着拆分方式需要改成平铺。 */
+        if (child.import !== undefined) {
+            problems.push({ message: 'import 文件 ' + rel + ' 里还有 import：import 不可嵌套（该文件的 schema 顶层没有 import 字段），其引用的文件已忽略' });
+        }
+        readTasks(child.task, rel);
+        readOptions(child.option, rel);
+        readPresets(child.preset);
+        readAgents(child.agent);
+        for (const g of strList(child.global_option))
+            if (!globalOption.includes(g))
+                globalOption.push(g);
+        for (const pt of Array.isArray(child.pretask) ? child.pretask : []) {
+            const p2 = obj(pt);
+            if (p2)
+                pretask.push({ name: str(p2.name), exec: str(p2.exec) });
+        }
+    }
+    return {
+        ...base,
+        version: version ?? null,
+        name: str(o.name) ?? null,
+        controllers,
+        resources,
+        tasks,
+        options,
+        presets,
+        globalOption,
+        pretask,
+        agents,
+        problems,
+    };
+}
+//# sourceMappingURL=load.js.map

package/lib/interface/load.js.map

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

package/lib/interface/override.js

@@ -0,0 +1,103 @@
+/**
+ * 把一份 pipeline_override 并入累计结果：同节点字段替换（与协议"不深度合并"一致）。
+ *
+ * **唯一一份实现**：四级链、`run --override`、`timing --override` 都走这里。这三处曾经各写一份，
+ * 代价是同一个参数在不同命令里表现不同。非对象值必须**原样替换、不能展开**：字符串会被摊成
+ * `{0:'a',1:'b'}`，`null` / 数字会静默变成空对象——等于把用户写的节点悄悄丢掉。
+ */
+export function mergeOverride(acc, po) {
+    for (const [node, fields] of Object.entries(po)) {
+        if (fields && typeof fields === 'object' && !Array.isArray(fields)) {
+            acc[node] = { ...(acc[node] ?? {}), ...fields };
+        }
+        else {
+            acc[node] = fields;
+        }
+    }
+}
+export function computePipelineOverride(input) {
+    const { loaded, controllerName, resourceName, taskName, presetName } = input;
+    const warns = [];
+    const applied = [];
+    const acc = {};
+    const preset = presetName ? loaded.presets.find((p) => p.name === presetName) : undefined;
+    if (presetName && !preset)
+        warns.push('preset ' + presetName + ' 不存在（可用：' + loaded.presets.map((p) => p.name).join(' / ') + '或无）');
+    const presetTask = preset && taskName ? preset.task.find((t) => t.name === taskName) : undefined;
+    const applicable = (o) => {
+        if (o.controller?.length && controllerName && !o.controller.includes(controllerName))
+            return false;
+        if (o.resource?.length && resourceName && !o.resource.includes(resourceName))
+            return false;
+        return true;
+    };
+    /** 解析一个 option 的当前取值：preset > default_case；返回 case 名（单个或数组）。 */
+    const valueOf = (name) => {
+        const o = loaded.options[name];
+        if (!o) {
+            warns.push('option ' + name + ' 未在 interface 中定义，已跳过');
+            return null;
+        }
+        const pv = presetTask?.option?.[name];
+        if (pv !== undefined) {
+            return { cases: Array.isArray(pv) ? pv.map(String) : [String(pv)], via: 'preset' };
+        }
+        if (o.defaultCase !== undefined) {
+            return { cases: Array.isArray(o.defaultCase) ? o.defaultCase.map(String) : [String(o.defaultCase)], via: 'default' };
+        }
+        return null;
+    };
+    const mergeOption = (name, level, chain = []) => {
+        /* 嵌套 option 是"case 里再列 option"，A → B → A 这类自引用会让递归停不下来：
+         * 记一条警告并跳过，而不是用栈溢出把整条 run 打断。 */
+        if (chain.includes(name)) {
+            warns.push('option ' + name + ' 出现在自己的嵌套链里（' + [...chain, name].join(' > ') + '），已跳过');
+            return;
+        }
+        const o = loaded.options[name];
+        if (o && !applicable(o))
+            return;
+        const v = valueOf(name);
+        if (!o)
+            return;
+        if (!v) {
+            if (o.type === 'input' || o.type === 'hotkey')
+                return; // 输入类不产生 pipeline_override，不算异常
+            warns.push('option ' + name + '（' + level + '）无 preset/default_case 取值，跳过其 pipeline_override');
+            return;
+        }
+        for (const cname of v.cases) {
+            const c = o.cases.find((x) => x.name === cname);
+            if (!c) {
+                warns.push('option ' + name + ' 的取值 ' + cname + ' 不是已声明的 case，已跳过');
+                continue;
+            }
+            if (c.pipelineOverride && Object.keys(c.pipelineOverride).length) {
+                mergeOverride(acc, c.pipelineOverride);
+                applied.push(name + '=' + cname + '（' + level + '，via ' + v.via + '）');
+            }
+            /* 嵌套子 option：父 case 生效后按声明顺序合并（更具体，晚于父级） */
+            for (const child of c.option ?? [])
+                mergeOption(child, level + ' > ' + name, [...chain, name]);
+        }
+    };
+    for (const name of loaded.globalOption)
+        mergeOption(name, 'global_option');
+    if (resourceName) {
+        const r = loaded.resources.find((x) => x.name === resourceName);
+        for (const name of r?.option ?? [])
+            mergeOption(name, 'resource.option');
+    }
+    if (controllerName) {
+        const c = loaded.controllers.find((x) => x.name === controllerName);
+        for (const name of c?.option ?? [])
+            mergeOption(name, 'controller.option');
+    }
+    if (taskName) {
+        const t = loaded.tasks.find((x) => x.name === taskName);
+        for (const name of t?.option ?? [])
+            mergeOption(name, 'task.option');
+    }
+    return { override: acc, warns, applied };
+}
+//# sourceMappingURL=override.js.map

package/lib/interface/override.js.map

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

package/lib/interface/plan.js

@@ -0,0 +1,188 @@
+/**
+ * 项目驱动的连接规划：把 interface.json 的控制器声明与枚举到的设备对上，
+ * 产出 daemon `connect` 的参数；对不上时给出候选与可操作的原因。
+ *
+ * 为什么不猜设备：猜错不只是连错窗口，还会把 roi 与模板的坐标系一起猜错。
+ */
+import { resolve } from 'node:path';
+const KIND_BY_TYPE = { Adb: 'adb', Win32: 'win32', Gamepad: 'gamepad', PlayCover: 'playcover', Linux: 'linux' };
+function safeRegExp(pattern) {
+    try {
+        return new RegExp(pattern);
+    }
+    catch {
+        return null;
+    }
+}
+function fail(c, code, error, candidates, connect, notes) {
+    return { ok: false, code, error, controllerName: c.name, connect, candidates, notes };
+}
+export function planController(loaded, overrides, devices) {
+    const wanted = overrides.controller;
+    const c = wanted ? loaded.controllers.find((x) => x.name === wanted) : loaded.controllers[0];
+    if (!c) {
+        const names = loaded.controllers.map((x) => x.name).join(' / ');
+        return {
+            ok: false,
+            code: wanted ? 'CONTROLLER_NOT_FOUND' : 'NO_CONTROLLER',
+            controllerName: null,
+            connect: {},
+            candidates: [],
+            error: wanted
+                ? 'interface.json 里没有控制器 ' + wanted + (names ? '（可用：' + names + '）' : '')
+                : 'interface.json 没有声明任何控制器',
+        };
+    }
+    const kind = KIND_BY_TYPE[c.type];
+    if (!kind) {
+        return {
+            ok: false,
+            code: 'CONTROLLER_UNSUPPORTED',
+            controllerName: c.name,
+            connect: {},
+            candidates: [],
+            error: '控制器 ' + c.name + ' 的类型 ' + c.type + ' 暂不受支持（本 CLI 支持 Adb / Win32 / Gamepad / PlayCover / Linux；MacOS 走手动 --kind macos）',
+        };
+    }
+    const notes = ['控制器 ' + c.name + '（来自 interface.json）'];
+    const connect = { kind };
+    if (c.display?.shortSide !== undefined)
+        connect.shortSide = c.display.shortSide;
+    if (c.display?.longSide !== undefined)
+        connect.longSide = c.display.longSide;
+    if (c.display?.raw)
+        connect.rawSize = true;
+    if (c.display?.expand)
+        notes.push('display_expand 暂不生效（daemon 未接入），已忽略');
+    if (kind === 'playcover' || kind === 'linux') {
+        /* 两类控制器没有可枚举的设备发现：必须显式给 target（playcover=<address>/<uuid>，
+           linux=<config JSON>），工具不猜会话形态。 */
+        const t = overrides.manualTarget ?? null;
+        if (!t) {
+            return fail(c, 'TARGET_REQUIRED', kind === 'playcover'
+                ? 'PlayCover 需要 --target <address>/<uuid>（PlayCover 设置里可见）'
+                : 'Linux 需要 --target <config JSON>（含 screencap_method / input_method 等必填字段）', [], connect, notes);
+        }
+        connect.target = t;
+        return { ok: true, controllerName: c.name, connect, notes };
+    }
+    if (kind === 'adb') {
+        const addr = overrides.adb?.address ?? null;
+        let hit;
+        if (addr)
+            hit = devices.find((d) => String(d.id ?? '') === addr);
+        if (addr && !hit) {
+            return fail(c, 'DEVICE_NOT_FOUND', 'adb 地址 ' + addr + ' 不在已发现设备中（共 ' + devices.length + ' 台）', devices, connect, notes);
+        }
+        if (!hit && devices.length === 0) {
+            return fail(c, 'NO_DEVICES', '没有发现 adb 设备（检查 adb 连接与模拟器）', [], connect, notes);
+        }
+        if (!hit && devices.length === 1)
+            hit = devices[0];
+        if (!hit) {
+            return fail(c, 'DEVICE_AMBIGUOUS', '发现 ' + devices.length + ' 台 adb 设备，请用 --address 显式指定', devices, connect, notes);
+        }
+        connect.target = String(hit.id ?? '');
+        notes.push('设备：' + (hit.name || hit.id || '?'));
+        return { ok: true, controllerName: c.name, connect, notes };
+    }
+    /* Win32 / Gamepad：窗口类名与标题正则两条都生效（与本体 boost::regex_search 语义一致）。 */
+    const decl = kind === 'gamepad' ? { ...(c.gamepad ?? {}) } : { ...(c.win32 ?? {}) };
+    const hwnd = (kind === 'gamepad' ? overrides.gamepad?.hwnd : overrides.win32?.hwnd) ?? null;
+    let hit;
+    if (hwnd) {
+        hit =
+            devices.find((d) => String(d.id ?? '') === hwnd) ??
+                devices.find((d) => String(d.name ?? '').includes(hwnd) || String(d.cls ?? '').includes(hwnd));
+        if (!hit) {
+            return fail(c, 'WINDOW_NOT_FOUND', '窗口未找到：' + hwnd + '（hwnd 变了或窗口已关闭）', devices, connect, notes);
+        }
+    }
+    else {
+        const clsRe = decl.classRegex ? safeRegExp(decl.classRegex) : null;
+        const winRe = decl.windowRegex ? safeRegExp(decl.windowRegex) : null;
+        if (decl.classRegex && !clsRe)
+            notes.push('class_regex 不是合法正则，已忽略：' + decl.classRegex);
+        if (decl.windowRegex && !winRe)
+            notes.push('window_regex 不是合法正则，已忽略：' + decl.windowRegex);
+        if (clsRe || winRe) {
+            const matched = devices.filter((d) => (!clsRe || clsRe.test(String(d.cls ?? ''))) && (!winRe || winRe.test(String(d.name ?? ''))));
+            if (matched.length === 1)
+                hit = matched[0];
+            else if (matched.length === 0) {
+                const cond = [
+                    decl.classRegex && 'class~' + decl.classRegex,
+                    decl.windowRegex && 'title~' + decl.windowRegex,
+                ]
+                    .filter(Boolean)
+                    .join(' + ');
+                return fail(c, 'WINDOW_NOT_FOUND', '没有窗口同时匹配 ' + cond + '（当前 ' + devices.length + ' 个窗口）', devices, connect, notes);
+            }
+            else {
+                return fail(c, 'WINDOW_AMBIGUOUS', '有 ' + matched.length + ' 个窗口匹配，请用 --hwnd 显式指定', matched, connect, notes);
+            }
+        }
+        else if (devices.length === 1) {
+            hit = devices[0];
+            notes.push('控制器未声明窗口匹配规则，使用唯一窗口');
+        }
+        else {
+            return fail(c, 'WINDOW_AMBIGUOUS', '控制器未声明窗口匹配规则，且当前有 ' + devices.length + ' 个窗口，请用 --hwnd 指定', devices, connect, notes);
+        }
+    }
+    connect.target = String(hit.id ?? '');
+    if (decl.screencap)
+        connect.screencap = decl.screencap;
+    if (kind === 'win32') {
+        if (decl.mouse)
+            connect.mouse = decl.mouse;
+        if (decl.keyboard)
+            connect.keyboard = decl.keyboard;
+    }
+    else if (decl.gamepadType) {
+        connect.gamepadType = decl.gamepadType;
+    }
+    notes.push('窗口：' + (hit.name || hit.cls || hit.id || '?'));
+    return { ok: true, controllerName: c.name, connect, notes };
+}
+/**
+ * 解析资源路径：resource[] 是互斥单选（Client 语义）——不传 override 时取第一个适用于
+ * 所选控制器的条目，条目自身多路径按声明顺序叠加（如"B 服"= base + bilibili）；
+ * attach_resource_path 在选中控制器后追加。override（--resource）先按资源名匹配，
+ * 匹配不上再按文件系统路径解释（原有行为）。
+ */
+export function resolveResourcePaths(loaded, controllerName, override) {
+    const dir = loaded.dir;
+    /**
+     * 追加控制器声明的 attach_resource_path（v2.2.0："在 resource.path 加载完成后，额外加载"）。
+     * 它是**控制器的属性**，所以 `--resource` 走哪条分支都要追加——曾经两条提前 return 把它丢了。
+     */
+    const withAttach = (paths, names, selected) => {
+        const out = [...paths];
+        if (dir && controllerName) {
+            const c = loaded.controllers.find((x) => x.name === controllerName);
+            for (const p of c?.attachResourcePath ?? [])
+                out.push(resolve(dir, p));
+        }
+        return { paths: [...new Set(out)], names, selected };
+    };
+    if (override) {
+        const byName = loaded.resources.find((r) => r.name === override);
+        if (byName && dir) {
+            return withAttach(byName.paths.map((p) => resolve(dir, p)), [byName.name], byName.name);
+        }
+        return withAttach([resolve(override)], ['(--resource)'], null);
+    }
+    if (!dir)
+        return { paths: [], names: [], selected: null };
+    const applicable = loaded.resources.filter((r) => !controllerName || !r.controllers.length || r.controllers.includes(controllerName));
+    const paths = [];
+    let selected = null;
+    if (applicable.length) {
+        selected = applicable[0].name;
+        for (const p of applicable[0].paths)
+            paths.push(resolve(dir, p));
+    }
+    return withAttach(paths, selected ? [selected] : [], selected);
+}
+//# sourceMappingURL=plan.js.map