weflow-cli 1.6.4 → 1.8.0

package/dist/src/panel/client.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 端点客户端：`weflow-cli panel` 用它读状态、换一次性口令、问一句话。
+ *
+ * 和悬浮窗走的是**同一个端点、同一套规矩**——所以"面板与微信共用一个大脑"这件事，
+ * 可以在命令行上被端到端地测（`panel ask` 就是"面板减去像素"）。
+ *
+ * 凭据从不进日志、不进错误信息：出错时只说状态码与分类，不回显 token。
+ */
+import type { PanelEndpoint } from './endpoint.js';
+export type ClientResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    code: string;
+    error?: string;
+};
+export declare function panelStatus(endpoint: PanelEndpoint): Promise<ClientResult<any>>;
+/** 换一个一次性口令，用来拼浏览器那条路的 URL（口令不是 token，可以进命令行） */
+export declare function panelPair(endpoint: PanelEndpoint): Promise<ClientResult<{
+    url: string;
+    expiresInMs: number;
+}>>;
+export declare function panelAsk(endpoint: PanelEndpoint, text: string): Promise<ClientResult<any>>;
+//# sourceMappingURL=client.d.ts.map

package/dist/src/panel/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/panel/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,MAAM,MAAM,YAAY,CAAC,CAAC,IACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACrB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAyB/C,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAE/E;AAED,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAE9G;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAE1F"}

package/dist/src/panel/client.js

@@ -0,0 +1,34 @@
+async function request(endpoint, path, init = {}, timeoutMs = 10_000) {
+    try {
+        const res = await fetch(`http://127.0.0.1:${endpoint.port}${path}`, {
+            ...init,
+            headers: {
+                Authorization: `Bearer ${endpoint.token}`,
+                ...(init.body ? { 'Content-Type': 'application/json' } : {}),
+                ...(init.headers ?? {}),
+            },
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        const body = await res.json().catch(() => ({}));
+        if (!res.ok)
+            return { ok: false, code: String(body?.code ?? `HTTP_${res.status}`), error: body?.error };
+        return { ok: true, data: body };
+    }
+    catch (error) {
+        // 连不上：进程可能刚被停掉，或端点文件是残留的。**分开说**，别都说成"失败"
+        if (error?.name === 'TimeoutError')
+            return { ok: false, code: 'TIMEOUT' };
+        return { ok: false, code: 'UNREACHABLE' };
+    }
+}
+export function panelStatus(endpoint) {
+    return request(endpoint, '/api/status');
+}
+/** 换一个一次性口令，用来拼浏览器那条路的 URL（口令不是 token，可以进命令行） */
+export function panelPair(endpoint) {
+    return request(endpoint, '/api/pair', { method: 'POST' });
+}
+export function panelAsk(endpoint, text) {
+    return request(endpoint, '/api/ask', { method: 'POST', body: JSON.stringify({ text }) }, 200_000);
+}
+//# sourceMappingURL=client.js.map

package/dist/src/panel/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/panel/client.ts"],"names":[],"mappings":"AAcA,KAAK,UAAU,OAAO,CACpB,QAAuB,EAAE,IAAY,EAAE,OAAoB,EAAE,EAAE,SAAS,GAAG,MAAM;IAEjF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,QAAQ,CAAC,IAAI,GAAG,IAAI,EAAE,EAAE;YAClE,GAAG,IAAI;YACP,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,QAAQ,CAAC,KAAK,EAAE;gBACzC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;aACxB;YACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;SACvC,CAAC,CAAA;QACF,MAAM,IAAI,GAAQ,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACpD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;QACvG,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACjC,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,0CAA0C;QAC1C,IAAI,KAAK,EAAE,IAAI,KAAK,cAAc;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;QACzE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,CAAA;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAuB;IACjD,OAAO,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAA;AACzC,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,SAAS,CAAC,QAAuB;IAC/C,OAAO,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAuB,EAAE,IAAY;IAC5D,OAAO,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;AACnG,CAAC"}

package/dist/src/panel/endpoint.d.ts

@@ -0,0 +1,45 @@
+/** 端点文件的格式版本。读不出来或不认识就**当作不存在**，不猜、不迁移（同记忆文件的纪律） */
+export declare const PANEL_ENDPOINT_VERSION = 1;
+/** `/api/status` 的身份字段：防止把别人的端口当成助手（`service !== 它` 就不认） */
+export declare const PANEL_SERVICE_ID = "weflow-assistant";
+/**
+ * 默认端口。**固定**而不是随机：便于本人手工 `curl` 排查，也让文档能写一个确定的地址。
+ * 端口被占时**大声失败**，不静默换一个——静默换端口会让"文件里写着 A、实际在 B"成为可能。
+ */
+export declare const DEFAULT_PANEL_PORT = 8766;
+export type PanelChannelMode = 'wechat' | 'local';
+export interface PanelEndpoint {
+    version: number;
+    service: string;
+    port: number;
+    token: string;
+    pid: number;
+    startedAt: string;
+    channel: PanelChannelMode;
+    /** 这个进程给本机入口用的记忆桶（与微信直聊同一个 id 时才是"共用一个大脑"） */
+    memoryBucket: string;
+}
+export declare function weflowHome(): string;
+export declare function endpointFile(): string;
+/** 每进程一份，**每次启动重新生成**。32 字节 base64url。 */
+export declare function generateToken(): string;
+/** 原子写：先 `.tmp` 再 rename。失败不抛——端点起不来不该把助手一起弄死，调用方会记日志 */
+export declare function writeEndpoint(endpoint: PanelEndpoint): boolean;
+/**
+ * 读并校验。**任何一种不可信都返回 `null`**，绝不返回一个"大概是它"的对象：
+ * 文件不存在、JSON 坏了、版本不认识、字段缺、**进程已经没了**。
+ */
+export declare function readEndpoint(): PanelEndpoint | null;
+/** 探活。照抄 `assistantDaemon.isDaemonAlive()`：`kill(pid, 0)` 不真发信号，只做权限/存在性检查 */
+export declare function isProcessAlive(pid: number): boolean;
+/**
+ * 删除端点文件。**只在"确认要停"时用**（例如 `assistant stop`），
+ * 不要指望它在崩溃/被 SIGTERM 时被调用——见文件头第 3 条。
+ */
+export declare function clearEndpoint(): void;
+/**
+ * token 比较。长度不等时 `timingSafeEqual` 会**抛**，所以先比长度。
+ * 用 `timingSafeEqual` 是为了不把"前几个字符对了"这件事通过耗时泄漏出去。
+ */
+export declare function tokenMatches(expected: string, given: unknown): boolean;
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/src/panel/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../../src/panel/endpoint.ts"],"names":[],"mappings":"AAmCA,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,IAAI,CAAA;AACvC,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,qBAAqB,CAAA;AAClD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,OAAO,CAAA;AAEtC,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEjD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,gBAAgB,CAAA;IACzB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,0CAA0C;AAC1C,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAcD,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAU9D;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,aAAa,GAAG,IAAI,CAWnD;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAOtE"}

package/dist/src/panel/endpoint.js

@@ -0,0 +1,132 @@
+/**
+ * 本机面板的**发现 + 凭据**：一个文件解决两件事。
+ *
+ * 悬浮窗要跟助手说话，需要知道两样东西——**端口**和**口令**。分开存会让"端口写死但服务没起来"
+ * 变成一类难查的故障，所以合在一个文件里，由守护进程**原子写**（先写 `.tmp` 再 `rename`，
+ * 照抄 `configService.save()` 的手法）。
+ *
+ * ## 三个必须处理的失效模式
+ *
+ * 1. **崩溃残留**：文件还在，进程没了 → 用 `process.kill(pid, 0)` 探活
+ *    （照抄 `assistantDaemon.isDaemonAlive()` 的写法）。
+ * 2. **端口被别的进程占了**：文件里的端口是准的，但回应的人不是我们 → 拿到之后
+ *    **必须打一次 `/api/status`**，校验 `service` 与 `startedAt` 都对得上
+ *    （照抄 `getDailyReaderStatus()` 里那三行；它就是为这个存在的）。
+ * 3. **退出时不删文件**：**不要指望清理**。`stopDaemon()` 发的是 SIGTERM，而 Node 默认不为它跑
+ *    清理逻辑，所以文件**一定会残留**。"退出时删掉它"看起来太像一个能用的方案了，
+ *    所以这里明说：正确做法是探活，不是删。
+ *
+ * ## 关于 Windows 上的文件权限
+ *
+ * token 写在 `~/.weflow-cli/` 下。**不要声称"权限已收紧"**：Windows 上 `fs.chmod` /
+ * `mode: 0o600` 基本无效（Node 只能映射只读位）。真正起作用的是 `%USERPROFILE%\.weflow-cli\`
+ * 的默认 ACL（只有本人 + SYSTEM + Administrators）——**那是既成事实，不是我们做的事**。
+ * `mode: 0o600` 仍然传，因为在 Linux/macOS/WSL 上有意义；在 Windows 上它是空操作。
+ *
+ * 所以这道 token 的真实作用是：挡住**本机其它程序与任意网页**（它们读不到这个文件）。
+ * 它**挡不住**以同一用户身份运行、且愿意翻 `~/.weflow-cli/` 的程序——那种程序本来就能直接读库。
+ * 这是这条设计的真实边界，别把它说成比这更强。
+ */
+import { existsSync, mkdirSync, readFileSync, rmSync } from 'fs';
+import { writeFileAtomic } from '../utils/atomicWrite.js';
+import { randomBytes, timingSafeEqual } from 'crypto';
+import { join } from 'path';
+import os from 'os';
+/** 端点文件的格式版本。读不出来或不认识就**当作不存在**，不猜、不迁移（同记忆文件的纪律） */
+export const PANEL_ENDPOINT_VERSION = 1;
+/** `/api/status` 的身份字段：防止把别人的端口当成助手（`service !== 它` 就不认） */
+export const PANEL_SERVICE_ID = 'weflow-assistant';
+/**
+ * 默认端口。**固定**而不是随机：便于本人手工 `curl` 排查，也让文档能写一个确定的地址。
+ * 端口被占时**大声失败**，不静默换一个——静默换端口会让"文件里写着 A、实际在 B"成为可能。
+ */
+export const DEFAULT_PANEL_PORT = 8766;
+export function weflowHome() {
+    return join(os.homedir(), '.weflow-cli');
+}
+export function endpointFile() {
+    return join(weflowHome(), 'assistant_endpoint.json');
+}
+/** 每进程一份，**每次启动重新生成**。32 字节 base64url。 */
+export function generateToken() {
+    return randomBytes(32).toString('base64url');
+}
+function isEndpoint(value) {
+    return !!value && typeof value === 'object'
+        && value.version === PANEL_ENDPOINT_VERSION
+        && value.service === PANEL_SERVICE_ID
+        && typeof value.port === 'number' && Number.isInteger(value.port) && value.port > 0 && value.port < 65536
+        && typeof value.token === 'string' && value.token.length > 0
+        && typeof value.pid === 'number'
+        && typeof value.startedAt === 'string'
+        && (value.channel === 'wechat' || value.channel === 'local')
+        && typeof value.memoryBucket === 'string';
+}
+/** 原子写：先 `.tmp` 再 rename。失败不抛——端点起不来不该把助手一起弄死，调用方会记日志 */
+export function writeEndpoint(endpoint) {
+    try {
+        mkdirSync(weflowHome(), { recursive: true });
+        // `mode` 在 Windows 上是空操作，见文件头注释；不是为了"安全"，是为了别的平台。
+        // 用 writeFileAtomic：rename 在被占用时会 EPERM，重试+兜底由它负责
+        writeFileAtomic(endpointFile(), JSON.stringify(endpoint, null, 2), { mode: 0o600 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 读并校验。**任何一种不可信都返回 `null`**，绝不返回一个"大概是它"的对象：
+ * 文件不存在、JSON 坏了、版本不认识、字段缺、**进程已经没了**。
+ */
+export function readEndpoint() {
+    try {
+        const file = endpointFile();
+        if (!existsSync(file))
+            return null;
+        const parsed = JSON.parse(readFileSync(file, 'utf8'));
+        if (!isEndpoint(parsed))
+            return null;
+        if (!isProcessAlive(parsed.pid))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/** 探活。照抄 `assistantDaemon.isDaemonAlive()`：`kill(pid, 0)` 不真发信号，只做权限/存在性检查 */
+export function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 删除端点文件。**只在"确认要停"时用**（例如 `assistant stop`），
+ * 不要指望它在崩溃/被 SIGTERM 时被调用——见文件头第 3 条。
+ */
+export function clearEndpoint() {
+    try {
+        rmSync(endpointFile(), { force: true });
+    }
+    catch { /* 删不掉不影响正确性：读取端会探活 */ }
+}
+/**
+ * token 比较。长度不等时 `timingSafeEqual` 会**抛**，所以先比长度。
+ * 用 `timingSafeEqual` 是为了不把"前几个字符对了"这件事通过耗时泄漏出去。
+ */
+export function tokenMatches(expected, given) {
+    if (typeof given !== 'string' || given.length !== expected.length)
+        return false;
+    try {
+        return timingSafeEqual(Buffer.from(expected, 'utf8'), Buffer.from(given, 'utf8'));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=endpoint.js.map

package/dist/src/panel/endpoint.js.map

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

package/dist/src/panel/launch.d.ts

@@ -0,0 +1,50 @@
+export type ExistsFn = (path: string) => boolean;
+export interface ElectronLookup {
+    /** 找 Electron 的顺序：包内 → 全局 npm 目录 → 都没有就是 null */
+    candidates: string[];
+    found: string | null;
+}
+/**
+ * 找 Electron。**用 `existsSync` 逐个试，不用 `where`/`which`**：
+ * PATH 上可能有 shim，而 shim 的行为不比一个确定的路径更可信。
+ */
+export declare function resolveElectronBinary(env: {
+    packageRoot: string;
+    localAppData?: string;
+    programFiles?: string;
+    exists?: ExistsFn;
+}): ElectronLookup;
+/**
+ * Electron 的 argv。**就一个参数**：应用目录（里面的 `package.json` 指向 `main.cjs`）。
+ * 什么都不多带——不带 token、不带端口、不带 URL。
+ */
+export declare function electronLaunchArgs(panelDir: string): string[];
+export interface EdgeLookup {
+    candidates: string[];
+    found: string | null;
+}
+/** 找 Edge；找不到再找 Chrome（Chromium 内核的 `--app=` 都能用） */
+export declare function resolveBrowserBinary(env: {
+    programFiles?: string;
+    programFilesX86?: string;
+    localAppData?: string;
+    exists?: ExistsFn;
+}): EdgeLookup;
+/**
+ * 浏览器降级的 argv。
+ *
+ * - `--app=<url>`：没有地址栏、没有标签栏，看起来就是个独立小窗。**这就是降级能给的极限**：
+ *   它不是悬浮球——不能无边框、不能置顶、没有托盘、没有全局快捷键。这件事必须对用户说清。
+ * - `--user-data-dir=<独立目录>`：**不是可选的**。不带它，`--app` 会挤进用户日常那个浏览器实例
+ *   （共享 cookie 与会话，甚至可能被并进已有窗口而不是新开一个）。代价是多一个约 50MB 的
+ *   profile 目录，**它要进隐私文档的敏感路径清单**。
+ * - URL 里带的是**一次性口令**（`?c=`），不是 token：口令单次使用、60 秒过期，
+ *   所以它出现在命令行与浏览器历史里都不构成泄漏。
+ */
+export declare function browserLaunchArgs(options: {
+    url: string;
+    profileDir: string;
+}): string[];
+/** 浏览器降级专用的 profile 目录（与用户日常浏览器隔离） */
+export declare function browserProfileDir(weflowHome: string): string;
+//# sourceMappingURL=launch.d.ts.map

package/dist/src/panel/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../src/panel/launch.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;AAEhD,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,QAAQ,CAAA;CAClB,GAAG,cAAc,CAWjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAE7D;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,qDAAqD;AACrD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE;IACxC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,QAAQ,CAAA;CAClB,GAAG,UAAU,CAWb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAOxF;AAED,sCAAsC;AACtC,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/src/panel/launch.js

@@ -0,0 +1,74 @@
+/**
+ * 面板的**启动决策**：用哪个二进制、argv 是什么、URL 是什么。
+ *
+ * 全部是纯函数，返回路径与数组、没有副作用——**因为这一层能进 CI，而窗口不能**。
+ * `resources/panel/main.cjs` 里只剩"调用 spawn / new BrowserWindow"，决策都在这儿，
+ * 于是"会不会把凭据写进命令行"这种问题有地方可以钉住。
+ *
+ * 一条硬规矩贯穿本文件：**任何凭据都不许进 argv**。Windows 上同机任何进程都能从
+ * `wmic process get commandline` 读到命令行，把 token 放进去就是一次**看不出破绽的泄漏**。
+ * 所以浏览器那条路只带**一次性口令**（见 `server.ts` 的 `/api/pair`），Electron 那条什么都不带
+ * （它自己去读端点文件）。
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * 找 Electron。**用 `existsSync` 逐个试，不用 `where`/`which`**：
+ * PATH 上可能有 shim，而 shim 的行为不比一个确定的路径更可信。
+ */
+export function resolveElectronBinary(env) {
+    const exists = env.exists ?? existsSync;
+    const candidates = [
+        // 1. 本项目里装过（npm i -D electron）
+        join(env.packageRoot, 'node_modules', 'electron', 'dist', 'electron.exe'),
+        // 2. 全局 npm 装过（npm i -g electron）
+        env.localAppData ? join(env.localAppData, 'npm', 'node_modules', 'electron', 'dist', 'electron.exe') : '',
+        // 3. 全局装到别处时的兜底
+        env.programFiles ? join(env.programFiles, 'nodejs', 'node_modules', 'electron', 'dist', 'electron.exe') : '',
+    ].filter(Boolean);
+    return { candidates, found: candidates.find((p) => exists(p)) ?? null };
+}
+/**
+ * Electron 的 argv。**就一个参数**：应用目录（里面的 `package.json` 指向 `main.cjs`）。
+ * 什么都不多带——不带 token、不带端口、不带 URL。
+ */
+export function electronLaunchArgs(panelDir) {
+    return [panelDir];
+}
+/** 找 Edge；找不到再找 Chrome（Chromium 内核的 `--app=` 都能用） */
+export function resolveBrowserBinary(env) {
+    const exists = env.exists ?? existsSync;
+    const roots = [env.programFilesX86, env.programFiles, env.localAppData].filter(Boolean);
+    const candidates = [];
+    for (const root of roots) {
+        candidates.push(join(root, 'Microsoft', 'Edge', 'Application', 'msedge.exe'));
+    }
+    for (const root of roots) {
+        candidates.push(join(root, 'Google', 'Chrome', 'Application', 'chrome.exe'));
+    }
+    return { candidates, found: candidates.find((p) => exists(p)) ?? null };
+}
+/**
+ * 浏览器降级的 argv。
+ *
+ * - `--app=<url>`：没有地址栏、没有标签栏，看起来就是个独立小窗。**这就是降级能给的极限**：
+ *   它不是悬浮球——不能无边框、不能置顶、没有托盘、没有全局快捷键。这件事必须对用户说清。
+ * - `--user-data-dir=<独立目录>`：**不是可选的**。不带它，`--app` 会挤进用户日常那个浏览器实例
+ *   （共享 cookie 与会话，甚至可能被并进已有窗口而不是新开一个）。代价是多一个约 50MB 的
+ *   profile 目录，**它要进隐私文档的敏感路径清单**。
+ * - URL 里带的是**一次性口令**（`?c=`），不是 token：口令单次使用、60 秒过期，
+ *   所以它出现在命令行与浏览器历史里都不构成泄漏。
+ */
+export function browserLaunchArgs(options) {
+    return [
+        `--app=${options.url}`,
+        `--user-data-dir=${options.profileDir}`,
+        '--no-first-run',
+        '--no-default-browser-check',
+    ];
+}
+/** 浏览器降级专用的 profile 目录（与用户日常浏览器隔离） */
+export function browserProfileDir(weflowHome) {
+    return join(weflowHome, 'panel-browser-profile');
+}
+//# sourceMappingURL=launch.js.map

package/dist/src/panel/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../../src/panel/launch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAUhC;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAKrC;IACC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,UAAU,CAAA;IACvC,MAAM,UAAU,GAAG;QACjB,+BAA+B;QAC/B,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC;QACzE,kCAAkC;QAClC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE;QACzG,gBAAgB;QAChB,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE;KAC7G,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACjB,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAA;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,CAAC,QAAQ,CAAC,CAAA;AACnB,CAAC;AAOD,qDAAqD;AACrD,MAAM,UAAU,oBAAoB,CAAC,GAKpC;IACC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,UAAU,CAAA;IACvC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,OAAO,CAAa,CAAA;IACnG,MAAM,UAAU,GAAa,EAAE,CAAA;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC,CAAA;IAC/E,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC,CAAA;IAC9E,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAA;AACzE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA4C;IAC5E,OAAO;QACL,SAAS,OAAO,CAAC,GAAG,EAAE;QACtB,mBAAmB,OAAO,CAAC,UAAU,EAAE;QACvC,gBAAgB;QAChB,4BAA4B;KAC7B,CAAA;AACH,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,OAAO,IAAI,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAA;AAClD,CAAC"}

package/dist/src/panel/server.d.ts

@@ -0,0 +1,23 @@
+import { type PanelChannelMode, type PanelEndpoint } from './endpoint.js';
+import type { AssistantService } from '../services/assistantService.js';
+export interface PanelServerOptions {
+    service: AssistantService;
+    memoryBucket: string;
+    /** 给人看的一句话：这个桶是不是与微信共用的，以及为什么。界面要显示它 */
+    memoryNote?: string;
+    channel: PanelChannelMode;
+    port?: number;
+    onLog?: (line: string) => void;
+}
+export interface PanelServer {
+    port: number;
+    endpoint: PanelEndpoint;
+    close: () => Promise<void>;
+}
+/** 只认本机来源。带 Origin 就必须对得上；不带 Origin 放行（curl / file:// 的 Electron） */
+export declare function isLocalOrigin(origin: string | undefined, port: number): boolean;
+/**
+ * 起端点。返回**实际**监听的端口——调用方要把它写进端点文件，不要用请求的那个值。
+ */
+export declare function startPanelServer(options: PanelServerOptions): Promise<PanelServer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/src/panel/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/panel/server.ts"],"names":[],"mappings":"AA+BA,OAAO,EAEU,KAAK,gBAAgB,EAAE,KAAK,aAAa,EACzD,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,iCAAiC,CAAA;AAyCpF,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,gBAAgB,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,gBAAgB,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,aAAa,CAAA;IACvB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAYD,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAG/E;AAyED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CA8NxF"}