@yfwu2020/dsh-selection-explain 0.13.0 → 0.14.0

package/lib/types/host/shot.d.ts

@@ -1,73 +1,16 @@
+/** Screenshot HTTP boundary. Each plugin application owns one service and its disposal. */
 import type { IncomingMessage, ServerResponse } from 'node:http';
-import type { Config } from './config.js';
-/** 窗口列表探针（随包编译，见 native/window-list.c）。 */
-export declare function resolveWindowProbe(): string;
-/** 取景范围，从大到小：全屏 → 整窗 → 选区 + 留白 → 仅选区。 */
-export type ShotScope = 'screen' | 'window' | 'margin' | 'selection';
-/** 触发时小窗是开着（直接进输入框）还是没开（弹语音卡）。 */
-export type ShotMode = 'card' | 'panel';
-export interface ShotRect {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-export interface ShotPending {
-    id: string;
-    at: number;
-    /** 这次用的取景范围 / 触发模式（客户端据此决定画不画框、走卡片还是附件）。 */
-    scope: ShotScope;
-    mode: ShotMode;
-    /** 图里要不要画红框（选区之外还有内容时为 true；仅选区恒为 false）。 */
-    frame: boolean;
-    /** 最终图的文件名（落在临时目录，按 shot 序号独立命名）。 */
-    imagePath: string;
-    /** 选区在**这张图里**的位置（像素坐标，可以直接拿去画框）。 */
-    rect: ShotRect;
-    /** 截图覆盖的范围（点）：整窗 / 外扩后的选区 / 整屏；仅选区时就是选区本身。 */
-    windowRect: ShotRect;
-    /** 选区在屏幕上的位置（点）。 */
-    selectionRect: ShotRect;
-    /** 截图像素与点的比例（Retina 一般是 2）。 */
-    scale: number;
-    /** 窗口截图四周的留白（像素）—— `screencapture -l` 会连窗口阴影一起截进来，
-     *  内容不是从 (0,0) 开始的，必须把这段留白算进红框位置。 */
-    pad: {
-        x: number;
-        y: number;
-    };
-    /** 所属窗口的名字（调试用）。 */
-    owner: string;
-    /** 整窗截图是否已经做好（`/shot/image` 会等它；客户端拿到事件就能先画框）。 */
-    ready: boolean;
-}
-/** 一次截图失败（客户端通过长轮询取走，用来给用户一句人话）。 */
-export interface ShotError {
-    code: string;
-    message: string;
-    at: number;
-}
-/** 平台是否受支持（目前只做 macOS：整窗截图与矩形都依赖它）。 */
-export declare function shotSupported(): boolean;
-/** `POST /api/shot/start` —— 开始一次截图（可带 `?rect=x,y,w,h&scope=…` 供测试）。 */
-export declare function handleShotStart(req: IncomingMessage, res: ServerResponse, config?: Pick<Config, 'shotCardScope' | 'shotPanelScope' | 'shotMargin'>): Promise<void>;
-/** `GET /api/shot/pending` —— 长轮询，等下一次截图结果或失败原因（最多 25 秒）。 */
-export declare function handleShotPending(_req: IncomingMessage, res: ServerResponse): void;
-/** `GET /api/shot/image?id=` —— 把图按字节回给客户端（不进 JSON，避免几 MB 的 base64）。 */
-export declare function handleShotImage(req: IncomingMessage, res: ServerResponse): Promise<void>;
-/** 客户端加载时回报的自检结果（开发期用，只存内存）。 */
-export declare let clientHello: unknown;
-/** 按 stage 保留最近一次上报：'geometry' 这种关键诊断不会被后面的 'uploaded' 覆盖。 */
-export declare const clientReports: Record<string, unknown>;
-export declare function handleShotHello(req: IncomingMessage, res: ServerResponse): void;
-export declare function shotStatus(): {
-    available: boolean;
-    reason: string;
-    capturing: boolean;
-    total: number;
-    lastError: string;
+import type { ShotConfig, ShotPlatform } from './shot-types.js';
+export type { ShotScope, ShotMode, ShotRect, ShotPending, ShotError } from './shot-types.js';
+export { resolveWindowProbe, shotSupported } from './shot-platform.js';
+export declare function createShotService(config?: ShotConfig, dependencies?: {
+    platform?: ShotPlatform;
+}): {
+    handleShotStart: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    handleShotPending: (req: IncomingMessage, res: ServerResponse) => void;
+    handleShotImage: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    handleShotHello: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    handleShotStatus: (_req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    status: () => import("./shot-types.js").ShotStatus;
+    stop(): Promise<void>;
 };
-/** 插件卸载 / 热重载：把临时目录清掉（截图是临时的，没有留着的理由）。 */
-export declare function stopShot(): Promise<void>;
-/** `GET /api/shot/status` —— 调试/自检。 */
-export declare function handleShotStatus(_req: IncomingMessage, res: ServerResponse): Promise<void>;

package/native/window-list.c

@@ -0,0 +1,139 @@
+/*
+ * dsh-selection-explain · 窗口列表探针（纯 C + CoreFoundation）
+ *
+ * 干什么：把"当前屏幕上所有窗口"的名字与矩形打成一个 JSON 数组。
+ * 为什么需要它：截图提问要"带出整窗" —— 用户框了一块，我们要知道**那块属于哪个窗口**，
+ * 才能把整个窗口截下来（而不是裁一圈边框）。Node 没有 CoreGraphics 绑定，所以编一个小二进制。
+ * 与本包 native/mic-probe.c 同一套办法：纯 C、无 ObjC、出错就整体降级。
+ *
+ * 输出（一行 JSON，数组顺序即前后顺序，前一个更靠前）：
+ *   [{"id":123,"x":0,"y":25,"w":1200,"h":800,"layer":0,"alpha":1.00,"owner":"Code"}, ...]
+ *
+ * 约定：
+ *   · 只列 on-screen、非桌面元素的窗口；宽或高 < 8 的丢掉（菜单残片、零尺寸辅助窗口）；
+ *   · layer 0 是普通应用窗口（菜单栏/悬浮窗/状态栏都在别的层）；
+ *   · 坐标是**全局点**（左上角原点 = 主屏左上角），与截图文件里那个矩形同一套坐标系。
+ *
+ * 另有 `--displays`：打"当前活跃显示器"的矩形（全局点）与像素尺寸。
+ * 截图范围是「选区 + 留白」时，用它把外扩矩形裁到选区中心所在的那块屏，
+ * 否则 screencapture -R 越界时的裁切原点不可预期（红框会偏）。
+ *   [{"id":1,"x":0,"y":0,"w":1920,"h":1080,"index":1,"main":1}, ...]
+ *
+ * `index` 是 `screencapture -D` 的编号（1 = 主显示器），按 CGGetActiveDisplayList
+ * 的顺序给；`-D` 是截副屏唯一可靠的办法（`-R` 不接受负坐标）。
+ * 截图的实际像素尺寸以 `screencapture` 输出为准，不再从这里报（不同缩放下
+ * CGDisplayPixelsWide 与截图像素并不等价）。
+ */
+#include <CoreGraphics/CoreGraphics.h>
+#include <CoreFoundation/CoreFoundation.h>
+#include <stdio.h>
+#include <string.h>
+
+/** JSON 字符串转义：owner 里可能出现引号/反斜杠（罕见，但别拼坏 JSON）。 */
+static void jsonEscape(const char *src, char *dst, size_t n) {
+  size_t j = 0;
+  for (size_t i = 0; src && src[i] && j + 2 < n; i++) {
+    unsigned char c = (unsigned char)src[i];
+    if (c == '"' || c == '\\') {
+      dst[j++] = '\\';
+      dst[j++] = (char)c;
+    } else if (c < 0x20) {
+      dst[j++] = ' ';
+    } else {
+      dst[j++] = (char)c;
+    }
+  }
+  dst[j] = '\0';
+}
+
+/** CFNumber → double，失败给 fallback。 */
+static double numOr(CFDictionaryRef dict, CFStringRef key, double fallback) {
+  CFTypeRef v = CFDictionaryGetValue(dict, key);
+  double out = fallback;
+  if (v && CFGetTypeID(v) == CFNumberGetTypeID()) {
+    if (!CFNumberGetValue((CFNumberRef)v, kCFNumberDoubleType, &out)) out = fallback;
+  }
+  return out;
+}
+
+/**
+ * `--displays`：活跃显示器的全局矩形（点）与像素尺寸。
+ *
+ * 坐标与 CGWindowList 的窗口矩形、截图的 xattr 矩形是同一套全局点坐标系；
+ * 副屏在主屏左边时 x 会是负数，调用方必须按**全局点**处理。
+ */
+static void printDisplays(void) {
+  CGDirectDisplayID ids[32];
+  uint32_t count = 0;
+  CGError err = CGGetActiveDisplayList(32, ids, &count);
+  /* 锁屏 / 显示器睡眠时 active 可能为空：退到 online，再退到主屏，不能因此让截图整体不可用 */
+  if (err != kCGErrorSuccess || count == 0) {
+    err = CGGetOnlineDisplayList(32, ids, &count);
+  }
+  if (err != kCGErrorSuccess || count == 0) {
+    ids[0] = CGMainDisplayID();
+    count = 1;
+  }
+  printf("[");
+  uint32_t emitted = 0;
+  for (uint32_t i = 0; i < count; i++) {
+    CGRect b = CGDisplayBounds(ids[i]);
+    if (b.size.width < 1 || b.size.height < 1) continue;
+    if (emitted > 0) printf(",");
+    printf("{\"id\":%u,\"x\":%.1f,\"y\":%.1f,\"w\":%.1f,\"h\":%.1f,\"index\":%u,\"main\":%d}",
+           (unsigned)ids[i], b.origin.x, b.origin.y, b.size.width, b.size.height,
+           emitted + 1, CGDisplayIsMain(ids[i]) ? 1 : 0);
+    emitted++;
+  }
+  printf("]\n");
+}
+
+int main(int argc, char **argv) {
+  if (argc > 1 && strcmp(argv[1], "--displays") == 0) {
+    printDisplays();
+    return 0;
+  }
+  CFArrayRef wins = CGWindowListCopyWindowInfo(
+      kCGWindowListOptionOnScreenOnly | kCGWindowListExcludeDesktopElements, kCGNullWindowID);
+  long n = wins ? CFArrayGetCount(wins) : 0;
+  printf("[");
+  int first = 1;
+  for (long i = 0; i < n; i++) {
+    CFDictionaryRef w = (CFDictionaryRef)CFArrayGetValueAtIndex(wins, i);
+    if (!w || CFGetTypeID(w) != CFDictionaryGetTypeID()) continue;
+
+    CFTypeRef idRef = CFDictionaryGetValue(w, kCGWindowNumber);
+    if (!idRef || CFGetTypeID(idRef) != CFNumberGetTypeID()) continue;
+    int wid = 0;
+    if (!CFNumberGetValue((CFNumberRef)idRef, kCFNumberIntType, &wid)) continue;
+
+    /* 窗口矩形：CGWindowBounds 就是一个表示 CGRect 的字典，交给它自己解 */
+    CGRect rect;
+    CFTypeRef boundsRef = CFDictionaryGetValue(w, kCGWindowBounds);
+    if (!boundsRef || CFGetTypeID(boundsRef) != CFDictionaryGetTypeID()) continue;
+    if (!CGRectMakeWithDictionaryRepresentation((CFDictionaryRef)boundsRef, &rect)) continue;
+    if (rect.size.width < 8 || rect.size.height < 8) continue;
+
+    double layer = numOr(w, kCGWindowLayer, 0);
+    double alpha = numOr(w, kCGWindowAlpha, 1);
+
+    char owner[256];
+    CFTypeRef ownerRef = CFDictionaryGetValue(w, kCGWindowOwnerName);
+    if (ownerRef && CFGetTypeID(ownerRef) == CFStringGetTypeID()) {
+      CFStringGetCString((CFStringRef)ownerRef, owner, sizeof(owner), kCFStringEncodingUTF8);
+    } else {
+      owner[0] = '\0';
+    }
+    char safe[512];
+    jsonEscape(owner, safe, sizeof(safe));
+
+    if (!first) printf(",");
+    first = 0;
+    printf("{\"id\":%d,\"x\":%.1f,\"y\":%.1f,\"w\":%.1f,\"h\":%.1f,\"layer\":%d,\"alpha\":%.2f,\"owner\":\"%s\"}",
+           wid, rect.origin.x, rect.origin.y, rect.size.width, rect.size.height,
+           (int)layer, alpha, safe);
+  }
+  printf("]\n");
+  if (wins) CFRelease(wins);
+  return 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yfwu2020/dsh-selection-explain",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "DSH 划词解读：选中文字浮出按钮，点击弹窗流式显示专业中英翻译 + 该文字在当前上下文中的含义详解",
   "type": "module",
   "main": "./lib/index.js",
@@ -8,6 +8,7 @@
   "files": [
     "lib",
     "native/mic-probe.c",
+    "native/window-list.c",
     "cordis.patch.yml",
     "skills",
     "README.md",