dsh-screenshot-capture 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wangzhanchao883
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,170 @@
+# dsh-screenshot-capture · 指哪拍哪 (Point-and-Shoot Capture)
+
+DeepSeek Harness 插件:截屏即存 —— 监听剪贴板 → 鼠标位置弹出系统级悬浮窗
+【注释输入框 +「重点」复选框 + 复制截图 / 存文档 / 存图片】→ 图片 + 即时 OCR(通义千问多模态)写入 Obsidian 按天合并笔记
+→ 晚间 AI 整理(点选保留 / 保存全部 → 归类 → 双链 → 当日总结 → 归档)。
+
+A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH) plugin that turns a screenshot (or any copied image) into
+an Obsidian note: a system-level floating window appears next to your mouse, lets you add a comment / mark it as a
+key point, then saves the image (with instant OCR via the
+[Tongyi Qianwen](https://dashscope.aliyuncs.com) multimodal API) into a per-day note, and an optional
+evening AI pass organizes the day's entries with categories, backlinks, a summary, and archival.
+`v0.2.0` adds a comment box and a "重点 / key point" checkbox to each capture.
+
+[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
+
+## 功能 / Features
+
+- **Windows 系统级悬浮窗**:检测到新截图(或复制图片)后,在鼠标旁弹出置顶小窗,三键选择;
+- **注释 / 重点标记(v0.2.0)**:弹窗内置注释输入框 +「重点」复选框;勾重点后该条注释以标题一 `**重点**` 写入笔记,提示这是重点;
+- **存文档**:图片入库 + 当天笔记立即生成,OCR 文字 1~5 秒后自动回填;
+- **存图片**:仅图片入库(`#图片` 标签);
+- **即时 OCR**:通义千问多模态,无需本地模型;未配 key 时存文档会标注识别失败,不影响入库;
+- **晚间 AI 整理**:对当天收件箱条目,点选保留/保存全部 → 归类 → 生成分类笔记 + 双链 → 当日总结 → 归档;
+- **Web 图形配置界面**:DSH 设置 →「截图入库」,改动实时生效。
+
+## 截图 / Screenshots
+
+DSH 设置 →「截图入库」图形配置界面:
+
+![Settings](assets/screenshots/settings.png)
+
+截图后鼠标旁弹出的系统级悬浮窗(注释 + 重点 + 复制截图 / 存文档 / 存图片):
+
+![Floating window](assets/screenshots/floating-window.png)
+
+入库后的 Obsidian 按天合并笔记(含 OCR 文字):
+
+![Obsidian note](assets/screenshots/obsidian-note.png)
+
+## 环境要求 / Requirements
+
+- **Windows**(依赖系统自带 PowerShell 5.1 + WinForms)
+- 通义千问 API key(通过 `DASHSCOPE_API_KEY` 环境变量,或插件配置文件)
+- Obsidian 库(或任意本地 markdown 目录)
+
+## 安装 / Install (DSH plugin)
+
+```sh
+# 从 npm 安装(若已发布)
+dsh plugin --profile desktop add dsh-screenshot-capture
+
+# 从 GitHub 源安装
+dsh plugin --profile desktop add github:wangzhanchao883/dsh-screenshot-capture
+
+# 或用本地目录(开发时)
+dsh plugin --profile desktop add ./dsh-screenshot-capture
+```
+
+重启 DSH 后生效。剪贴板监听与悬浮窗由插件 host 端自动拉起(需要 DSH 运行中)。
+
+> 首次使用请先在 DSH 设置 →「截图入库」里配置你的 Obsidian 库路径(以及可选的通义千问 API key)。
+> 未配置 `vaultPath` 时采集功能会自动停用并告警。
+
+## 配置 / Configuration
+
+### 方式一:Web 图形界面 / Web settings (推荐)
+
+DSH Web 界面 → 侧栏 **设置** → **截图入库** 分区,直接改:
+- 通用:启用监听、Obsidian 库路径、轮询间隔、冷却时间
+- OCR:识别模式(通义千问 / 关闭)、模型、API Key(留空则用环境变量)
+- 悬浮窗:横向/纵向偏移、预览最大宽度
+
+改动**实时生效**(监听器会自动重启)。配置存储在 DSH 的 `settings.yaml` 用户层。
+
+### 方式二:配置文件 / config file (base 层)
+
+`%USERPROFILE%\.dsh-screenshot-capture\config.json`
+
+```jsonc
+{
+  "enabled": true,
+  "vaultPath": "D:\\path\\to\\obsidian-vault",
+  "ocr": { "mode": "qwen", "model": "qwen-vl-plus", "apiKey": "" },
+  "pollIntervalMs": 200,
+  "cooldownMs": 2000
+}
+```
+
+- OCR key 也可放环境变量 `DASHSCOPE_API_KEY`(推荐,避免明文落盘);
+- `ocr.mode` 为 `"off"` 时存文档不识别文字。
+
+> 注意:插件**默认不带库路径**(为空)。未配置 `vaultPath` 时,采集功能会自动停用并告警,不会创建任何目录。首次使用请务必在 Web 设置 / `config.json` 里配置你自己的 Obsidian 库路径。
+
+## 使用 / Usage
+
+1. 开着 DSH;
+2. `Win+Shift+S` 框选截图(或 `Ctrl+C` 复制任意图片);
+3. 悬浮窗出现在鼠标旁:先在注释框里写注释/评论(可选),需要的话勾选「重点」,再选【复制截图 / 存文档 / 存图片】;
+4. 晚上对 DSH 说"整理今天的截图",按提示选择保留条目。
+
+### 注释与「重点」标记 / Comments & key points
+
+- 截图时填写的注释会写入当天收件箱该条目下方;
+- 勾选「重点」后,注释上方加一行标题一 `# **重点**` 作为醒目提示;
+- 晚间整理时,注释与重点标记随条目进入「知识库/<分类>/」笔记的 `## 重点` 小节(未勾重点的纯注释也保留);
+- 点「复制截图」不写笔记,忽略输入框内容。
+
+## Obsidian 结构 / Output layout
+
+```
+vault/
+├── 收件箱/            # 白天截图进(按天合并)
+│   ├── 2026-08-21.md
+│   └── attachments/
+├── 知识库/<分类>/     # 晚间整理后,按分类
+│   ├── INDEX.md
+│   └── 20260821_1430_文档.md
+├── 总结/              # 当日总结(含双链)
+└── 归档/              # 已整理的收件箱笔记
+```
+
+## 目录结构 / Repository layout
+
+```
+dsh-screenshot-capture/
+├── index.mjs           # host 端入口:注册工具 + settings 命名空间 + 剪贴板监听(watcher 单例、配置热重启)
+├── core.mjs            # 悬浮窗三键选择的分发处理
+├── config.mjs          # 默认配置 / config.json 合并 / 运行时入参覆盖
+├── clipboard.mjs       # 拉起 PowerShell 常驻助手并读事件日志
+├── storage.mjs         # Obsidian 入库(按天合并、目录结构)
+├── ocr.mjs             # 通义千问多模态识别
+├── organize.mjs        # 晚间 AI 整理(归类 / 双链 / 总结 / 归档)
+├── dev-run.mjs         # 独立开发入口(不需要 DSH)
+├── client.js           # 浏览器端:注册 Web 设置页,经 settingsScope 读写配置
+├── scripts/
+│   └── clip-dialog.ps1 # PowerShell 轮询剪贴板 + 弹出系统级悬浮窗
+├── cordis.patch.yml    # DSH bundle patch(声明本插件为可安装 host 端 bundle)
+├── test/               # 独立测试脚本(注入 vault 路径即可跑,无需 DSH)
+├── package.json        # dsh.bundle + dsh.client manifest
+├── LICENSE             # MIT
+└── README.md
+```
+
+## 架构速览 / Architecture
+
+- **host 端**(Node):`index.mjs` 入口,注册工具 + settings 命名空间 + 剪贴板监听(watcher 单例、配置热重启);`clipboard.mjs` 拉起 PowerShell 常驻助手并读事件日志;`storage.mjs`/`ocr.mjs`/`organize.mjs` 负责入库/识别/整理。
+- **client 端**(浏览器):`client.js` 注册 Web 设置页,经 `settingsScope` 读写配置。
+- **PowerShell**:`scripts/clip-dialog.ps1` 轮询剪贴板 + 弹出悬浮窗,通过 `%TEMP%\dsh-capture\events.log` 与 Node 通信。
+
+> 注意:悬浮窗脚本是 Windows PowerShell(`Add-Type` + WinForms)。请在可控环境下使用,并只安装你信任的代码(本插件无后门,不联网外传剪贴板数据)。
+
+## 安全说明 / Security
+
+- 本插件**不含任何内置密钥**;OCR key 只从环境变量或配置文件读取;
+- 剪贴板图片仅本地处理,OCR 时才向通义千问上传该张图片用于识别;
+- 仓库代码不含个人路径之外的敏感信息;配置文件里的 `vaultPath` 等路径是使用者的本地路径,不会写入仓库(仓库默认 `vaultPath` 为空,首次使用需自行配置,未配置时自动停用采集)。
+
+## 开发与独立测试 / Development (no DSH needed)
+
+```sh
+npm run dev          # 交互模式(真实弹窗)
+npm run dev:auto     # 自动模式:检测到截图自动存文档
+npm test             # 运行存储/整理单测(无需 DSH、无需 API key)
+```
+
+可用环境变量 `DSC_VAULT_PATH` 覆盖 vault 路径,避免污染真实库。测试说明见 [`test/README.md`](./test/README.md)。
+
+## License
+
+[MIT](./LICENSE) © 2026 wangzhanchao883

package/client.js

@@ -0,0 +1,261 @@
+/* dsh-screenshot-capture client bundle — 浏览器半端(Web 设置页)。
+ * 以经典脚本形式注册到 window.__ModuleLoader__;工厂内用 require 取 React,
+ * 不能用 JSX(无构建步骤),一律 React.createElement。 */
+window.__ModuleLoader__.load({
+  id: "dsh-screenshot-capture",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+
+    const React = require("react");
+    const h = React.createElement;
+    const { useEffect, useRef, useState } = React;
+
+    const NS = "settings.screenshotCapture";
+    const SETTINGS_NAMESPACE = "dsh-screenshot-capture";
+
+    const zh = {
+      nav: "截图入库",
+      loading: "正在读取配置…",
+      unavailable: "配置面板不可用(设置服务未挂载)。请直接编辑配置 JSON 文件。",
+      saved: "已保存",
+      error: "保存失败:",
+      general: "通用",
+      enabled: "启用剪贴板监听",
+      enabledHint: "关闭后不再监听剪贴板,悬浮窗也不会弹出",
+      vaultPath: "Obsidian 库路径",
+      vaultPathHint: "截图笔记会写入这个库",
+      pollIntervalMs: "剪贴板轮询间隔 (ms)",
+      cooldownMs: "截图冷却时间 (ms)",
+      ocr: "OCR 文字识别",
+      ocrMode: "识别模式",
+      ocrModeQwen: "通义千问 (qwen)",
+      ocrModeOff: "关闭(只存图不识别)",
+      ocrModel: "模型",
+      ocrApiKey: "API Key",
+      ocrApiKeyHint: "留空则使用环境变量 DASHSCOPE_API_KEY",
+      dialog: "悬浮窗",
+      dialogOffsetX: "横向偏移 (px)",
+      dialogOffsetY: "纵向偏移 (px)",
+      dialogPreviewMaxWidth: "预览最大宽度 (px)",
+    };
+
+    const en = {
+      nav: "Screenshot Capture",
+      loading: "Reading configuration…",
+      unavailable: "Configuration panel unavailable (settings service not mounted). Edit the config JSON file directly instead.",
+      saved: "Saved",
+      error: "Save failed:",
+      general: "General",
+      enabled: "Enable clipboard watching",
+      enabledHint: "When off, clipboard watching and the floating window are disabled",
+      vaultPath: "Obsidian vault path",
+      vaultPathHint: "Screenshots are stored into this vault",
+      pollIntervalMs: "Clipboard poll interval (ms)",
+      cooldownMs: "Screenshot cooldown (ms)",
+      ocr: "OCR",
+      ocrMode: "Recognition mode",
+      ocrModeQwen: "Qwen (qwen)",
+      ocrModeOff: "Off (store without OCR)",
+      ocrModel: "Model",
+      ocrApiKey: "API Key",
+      ocrApiKeyHint: "Leave empty to use the DASHSCOPE_API_KEY environment variable",
+      dialog: "Floating window",
+      dialogOffsetX: "Horizontal offset (px)",
+      dialogOffsetY: "Vertical offset (px)",
+      dialogPreviewMaxWidth: "Preview max width (px)",
+    };
+
+    const STYLES = [
+      ".scc-config{max-width:640px;display:flex;flex-direction:column;gap:16px;color:var(--dsw-alias-label-primary)}",
+      ".scc-group{border:1px solid var(--dsw-alias-border-l2);border-radius:10px;padding:14px;background:var(--dsw-alias-bg-layer-2)}",
+      ".scc-group h3{margin:0 0 12px;font-size:13px;font-weight:600}",
+      ".scc-field{display:flex;flex-direction:column;gap:4px;margin-bottom:10px}",
+      ".scc-field label{font-size:12px;font-weight:500}",
+      ".scc-field input[type=text],.scc-field input[type=number],.scc-field input[type=password],.scc-field select{height:30px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);border-radius:6px;padding:0 8px;font:inherit;font-size:13px;box-sizing:border-box}",
+      ".scc-hint{font-size:11px;color:var(--dsw-alias-label-tertiary)}",
+      ".scc-switch{display:flex;align-items:center;gap:8px;margin-bottom:6px}",
+      ".scc-switch input{accent-color:var(--dsw-alias-state-business-primary)}",
+      ".scc-status{font-size:12px;color:var(--dsw-alias-label-tertiary);min-height:16px}",
+      ".scc-row{display:flex;gap:12px}",
+      ".scc-row .scc-field{flex:1}",
+    ].join("");
+
+    /** 一行标签 + 控件 + 提示 */
+    function Field({ label, hint, children }) {
+      return h("div", { className: "scc-field" },
+        h("label", null, label),
+        children,
+        hint ? h("div", { className: "scc-hint" }, hint) : null,
+      );
+    }
+
+    /** 文本输入:本地草稿,失焦/回车时才提交 */
+    function TextInput({ value, onCommit, password }) {
+      const [draft, setDraft] = useState(value);
+      useEffect(() => setDraft(value), [value]);
+      return h("input", {
+        type: password ? "password" : "text",
+        value: draft,
+        onChange: (e) => setDraft(e.target.value),
+        onBlur: () => {
+          if (draft !== value) onCommit(draft);
+        },
+        onKeyDown: (e) => {
+          if (e.key === "Enter") e.target.blur();
+        },
+      });
+    }
+
+    /** 数字输入:解析失败则回退当前值 */
+    function NumberInput({ value, onCommit, min, max }) {
+      const [draft, setDraft] = useState(String(value ?? ""));
+      useEffect(() => setDraft(String(value ?? "")), [value]);
+      const commit = () => {
+        const n = Number(draft);
+        if (Number.isFinite(n) && n !== value) onCommit(n);
+        else setDraft(String(value ?? ""));
+      };
+      return h("input", {
+        type: "number",
+        min,
+        max,
+        value: draft,
+        onChange: (e) => setDraft(e.target.value),
+        onBlur: commit,
+        onKeyDown: (e) => {
+          if (e.key === "Enter") e.target.blur();
+        },
+      });
+    }
+
+    /** 设置页:绑定 settings 命名空间,展示并保存配置 */
+    function ConfigSection({ scope, t }) {
+      const [snap, setSnap] = useState(() => scope.getSnapshot());
+      const [status, setStatus] = useState("");
+      const statusTimer = useRef(null);
+      useEffect(() => scope.subscribe(() => setSnap(scope.getSnapshot())), [scope]);
+      useEffect(() => () => {
+        if (statusTimer.current) clearTimeout(statusTimer.current);
+      }, []);
+      const flash = (msg) => {
+        setStatus(msg);
+        if (statusTimer.current) clearTimeout(statusTimer.current);
+        statusTimer.current = setTimeout(() => setStatus(""), 2500);
+      };
+      const save = (field, v) => {
+        Promise.resolve(scope.set(field, v))
+          .then(() => flash(t("saved")))
+          .catch((err) => flash(`${t("error")} ${err && err.message ? err.message : String(err)}`));
+      };
+
+      if (snap.status === "loading") return h("p", { className: "scc-status" }, t("loading"));
+      if (snap.status === "unavailable") return h("p", { className: "scc-status" }, t("unavailable"));
+      const v = snap.value || {};
+
+      return h("div", { className: "scc-config" }, [
+        h("div", { className: "scc-group" }, [
+          h("h3", null, t("general")),
+          h("div", { className: "scc-switch" }, [
+            h("input", {
+              type: "checkbox",
+              id: "scc-enabled",
+              checked: !!v.enabled,
+              onChange: (e) => save("enabled", e.target.checked),
+            }),
+            h("label", { htmlFor: "scc-enabled" }, t("enabled")),
+          ]),
+          h("div", { className: "scc-hint" }, t("enabledHint")),
+          Field({
+            label: t("vaultPath"),
+            hint: t("vaultPathHint"),
+            children: h(TextInput, { value: v.vaultPath || "", onCommit: (val) => save("vaultPath", val) }),
+          }),
+          h("div", { className: "scc-row" }, [
+            Field({
+              label: t("pollIntervalMs"),
+              children: h(NumberInput, { value: v.pollIntervalMs, min: 50, max: 60000, onCommit: (n) => save("pollIntervalMs", n) }),
+            }),
+            Field({
+              label: t("cooldownMs"),
+              children: h(NumberInput, { value: v.cooldownMs, min: 0, max: 120000, onCommit: (n) => save("cooldownMs", n) }),
+            }),
+          ]),
+        ]),
+        h("div", { className: "scc-group" }, [
+          h("h3", null, t("ocr")),
+          Field({
+            label: t("ocrMode"),
+            children: h("select", { value: v.ocrMode || "qwen", onChange: (e) => save("ocrMode", e.target.value) }, [
+              h("option", { value: "qwen" }, t("ocrModeQwen")),
+              h("option", { value: "off" }, t("ocrModeOff")),
+            ]),
+          }),
+          Field({
+            label: t("ocrModel"),
+            children: h(TextInput, { value: v.ocrModel || "", onCommit: (val) => save("ocrModel", val) }),
+          }),
+          Field({
+            label: t("ocrApiKey"),
+            hint: t("ocrApiKeyHint"),
+            children: h(TextInput, { value: v.ocrApiKey || "", password: true, onCommit: (val) => save("ocrApiKey", val) }),
+          }),
+        ]),
+        h("div", { className: "scc-group" }, [
+          h("h3", null, t("dialog")),
+          h("div", { className: "scc-row" }, [
+            Field({
+              label: t("dialogOffsetX"),
+              children: h(NumberInput, { value: v.dialogOffsetX, min: -1000, max: 1000, onCommit: (n) => save("dialogOffsetX", n) }),
+            }),
+            Field({
+              label: t("dialogOffsetY"),
+              children: h(NumberInput, { value: v.dialogOffsetY, min: -1000, max: 1000, onCommit: (n) => save("dialogOffsetY", n) }),
+            }),
+          ]),
+          Field({
+            label: t("dialogPreviewMaxWidth"),
+            children: h(NumberInput, { value: v.dialogPreviewMaxWidth, min: 100, max: 2000, onCommit: (n) => save("dialogPreviewMaxWidth", n) }),
+          }),
+        ]),
+        h("div", { className: "scc-status" }, status),
+      ]);
+    }
+
+    function apply(ctx) {
+      ctx.effect(() => {
+        const tag = document.createElement("style");
+        tag.setAttribute("data-plugin", "dsh-screenshot-capture");
+        tag.textContent = STYLES;
+        document.head.appendChild(tag);
+        return () => {
+          if (tag.parentNode) tag.parentNode.removeChild(tag);
+        };
+      }, "dsh-screenshot-capture: styles");
+
+      ctx.effect(() => {
+        return ctx.locale.register(NS, { zh, en });
+      }, "dsh-screenshot-capture: dictionaries");
+
+      const t = ctx.locale.bind(NS);
+      const scope = ctx.settingsScope.bind({ namespace: SETTINGS_NAMESPACE });
+      const injected = () => ({ scope });
+
+      ctx.slots.inject("settings.section", () => ctx.slots.register({
+        name: "settings.section",
+        id: "screenshot-capture",
+        order: 200,
+        label: () => t("nav"),
+        locale: NS,
+        inject: injected,
+      }, ConfigSection));
+    }
+
+    module.exports = {
+      name: "dsh-screenshot-capture",
+      inject: ["slots", "locale", "settingsScope"],
+      apply,
+    };
+    return module.exports;
+  },
+});

package/clipboard.mjs

@@ -0,0 +1,146 @@
+import { spawn } from "node:child_process";
+import { EventEmitter } from "node:events";
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { fileURLToPath } from "node:url";
+
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+const PS_SCRIPT = join(__dirname, "scripts", "clip-dialog.ps1");
+const POWERSHELL = join(
+  process.env.SystemRoot || "C:\\Windows",
+  "System32",
+  "WindowsPowerShell",
+  "v1.0",
+  "powershell.exe",
+);
+
+/**
+ * 剪贴板监听器:拉起常驻 PowerShell 助手(轮询剪贴板 + 系统级悬浮窗),
+ * 通过事件日志文件(events.log, JSON 每行)通信,避免管道依赖。
+ * 事件: "ready" | "img" | "choice" | "err" | "exit"
+ */
+export class ClipboardWatcher extends EventEmitter {
+  constructor(config = {}, options = {}) {
+    super();
+    this.config = config;
+    this.autoAction = options.autoAction || "";
+    this.workDir = join(tmpdir(), "dsh-capture");
+    this.logPath = join(this.workDir, "events.log");
+    this.offset = 0;
+    this.child = null;
+    this.timer = null;
+    this.started = false;
+  }
+
+  start() {
+    if (this.started) return;
+    this.started = true;
+    mkdirSync(this.workDir, { recursive: true });
+    if (existsSync(this.logPath)) this.offset = statSync(this.logPath).size;
+    else this.offset = 0;
+
+    const cfgFile = join(this.workDir, "watcher-config.json");
+    writeFileSync(cfgFile, JSON.stringify({
+      pollIntervalMs: this.config.pollIntervalMs ?? 200,
+      cooldownMs: this.config.cooldownMs ?? 2000,
+      offsetX: this.config.dialog?.offsetX ?? 16,
+      offsetY: this.config.dialog?.offsetY ?? 16,
+      previewMaxWidth: this.config.dialog?.previewMaxWidth ?? 320,
+    }), "utf8");
+
+    const args = [
+      "-NoProfile",
+      "-ExecutionPolicy", "Bypass",
+      "-File", PS_SCRIPT,
+      "-ConfigPath", cfgFile,
+    ];
+    if (this.autoAction) args.push("-AutoAction", this.autoAction);
+
+    try {
+      this.child = spawn(POWERSHELL, args, {
+        stdio: "ignore",
+        windowsHide: true,
+      });
+    } catch (err) {
+      this.emit("err", { msg: `spawn powershell: ${err.message}` });
+      return;
+    }
+
+    this.child.on("exit", (code) => {
+      this.emit("exit", { code });
+      this.started = false;
+      this.child = null;
+    });
+
+    this.timer = setInterval(() => this.#tick(), 300);
+    this.timer.unref?.();
+  }
+
+  /** 同步停(用于插件卸载,不等待退出)。 */
+  stop() {
+    if (this.timer) { clearInterval(this.timer); this.timer = null; }
+    if (this.child) {
+      try { this.child.kill(); } catch { /* ignore */ }
+      this.child = null;
+    }
+    this.started = false;
+  }
+
+  /**
+   * 异步停:等 PowerShell 子进程真正退出后再 resolve,避免旧监听残留。
+   * kill() 之外再用 taskkill /T /F 强杀进程树,并带超时兜底。
+   * @param timeoutMs - 等待退出的上限(默认 3s)。
+   */
+  stopAsync(timeoutMs = 3000) {
+    if (this.timer) { clearInterval(this.timer); this.timer = null; }
+    this.started = false;
+    const child = this.child;
+    this.child = null;
+    if (!child || child.exitCode !== null) return Promise.resolve();
+    return new Promise((resolve) => {
+      let settled = false;
+      const done = () => {
+        if (settled) return;
+        settled = true;
+        resolve();
+      };
+      const guard = setTimeout(done, timeoutMs);
+      child.once("exit", () => {
+        clearTimeout(guard);
+        done();
+      });
+      try {
+        child.kill();
+      } catch { /* 继续走 taskkill 兜底 */ }
+      // Windows 兜底:强制终止进程树(子进程可能处于 Add-Type 初始化等状态)
+      try {
+        const killer = spawn("taskkill", ["/PID", String(child.pid), "/T", "/F"], {
+          stdio: "ignore",
+          windowsHide: true,
+        });
+        killer.unref?.();
+      } catch { /* ignore */ }
+    });
+  }
+
+  #tick() {
+    if (!existsSync(this.logPath)) return;
+    const size = statSync(this.logPath).size;
+    if (size <= this.offset) return;
+    let buf;
+    try {
+      const fd = readFileSync(this.logPath);
+      buf = fd.subarray(this.offset, size);
+    } catch {
+      return;
+    }
+    this.offset = size;
+    const lines = buf.toString("utf8").split(/\r?\n/).filter(Boolean);
+    for (const line of lines) {
+      let ev;
+      try { ev = JSON.parse(line); } catch { continue; }
+      this.emit(ev.t, ev);
+    }
+  }
+}

package/config.example.json

@@ -0,0 +1,21 @@
+{
+  "//": "dsh-screenshot-capture config example. Copy to %USERPROFILE%\\.dsh-screenshot-capture\\config.json and fill in your own values. The OCR key is also read from the DASHSCOPE_API_KEY environment variable (recommended).",
+  "enabled": true,
+  "vaultPath": "D:\\path\\to\\obsidian-vault",
+  "inboxFolder": "收件箱",
+  "attachmentsFolder": "attachments",
+  "knowledgeFolder": "知识库",
+  "summaryFolder": "总结",
+  "archiveFolder": "归档",
+  "recycleFolder": "回收站",
+  "ocr": {
+    "mode": "qwen",
+    "model": "qwen-vl-plus",
+    "apiKey": "",
+    "endpoint": "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions"
+  },
+  "pollIntervalMs": 200,
+  "cooldownMs": 2000,
+  "dialog": { "offsetX": 16, "offsetY": 16, "previewMaxWidth": 320 },
+  "organize": { "addBacklinks": true }
+}