夸克(sQuark PC)全局划词工具栏 —— 逆向研究笔记
夸克(sQuark PC)全局划词工具栏 —— 逆向研究笔记
研究对象:G:\Soft2\Down\Quark(安装目录)+ %LOCALAPPDATA%\Quark\User Data(运行时数据)
版本:7.4.2.1020(build_info.json 里另有 product_version 1.4.5.62)
研究方式:只读。未修改安装目录任何内容;所有脚本/中间产物都在 debug\。
原提问:
该工作区是 Quark 夸克的安装目录
(当然,你也许可以不去看代码和解包,在没必要时。但如果你需要,你也可以那样做。应该没有其他重要代码逻辑在别的文件夹,如果有告诉我,我帮你补充进来)。
1. 需要研究:他是如何做到检测电脑上全局的鼠标选中文本事件。
当鼠标选中文本后,他会自动弹出一个工具栏在选中的文本上方(工具栏内容:AI搜索、翻译、总结、复制、写作、更多)。
并且在点击这些按钮后发现他确实能够正常获取到选中的文本。
经我个人测试的一些环境:
- 生效:网页上,vscode上,QQ上、记事本、Word
- 不生效:资源管理器url、deepseek harness、Obsidian、Typora
2. 研究期间不要修改里面的内容导致软件不可用,如果你想要进行一些脚本创建、exe解压缩等操作,创建一个 debug 文件夹,并在里面进行这些操作。
我的一些猜测:(本来认为很玄乎,但在打这些字的同时,我又有了新发现,感觉其实可能是我以前想复杂了)
- 我开始认为这是 TSF、UIA 之类的
- 但后来我发现在网页框选操作时发现,鼠标往上或往下一点,选中文本选中框的位置是相同的,但工具栏会向上/向下偏移,所以他很可能只是检测鼠标的初始位置,而非检测选中框的位置。在鼠标选中期间进行网页滚动操作,发现也是基于鼠标初始位置生成工具栏的,也证实了这点。
- 他很有可能只是单纯检测 “鼠标框选” 这个动作,并查看对应窗口的昵称是否在白名单上。而非什么复杂的检测。
研究目的:我的一个项目 https://github.com/any-menu/any-menu/ 也需要内置这类需求,但是目前还不是很完善,缺点很多。于是这里参考别的项目了。
我开始时用了大量 window api 和 uia 之类的方案。
缺陷点:
- 基本很难正常获取到选中文本框的位置(但我感觉可以不去获取了,Quark 的思路感觉更简单方便)
- 目前的文本获取都是通过模拟拷贝进行的,而且还没做剪切版恢复功能,可能会造成污染(感觉应该能做,后期再说)
- 目前在 vscode 中难以获取文本(不开启 vscode 无障碍时,quark 能获取到,但我这里获取不到,不知道为什么)0. 一句话结论
它没有去定位"选中的文本在哪里",也没有用 TSF。
它做的是:全局监听鼠标"按下→拖动→抬起"这个动作 + 用进程名白名单判断该不该管 + 用 MSAA(不是 UIA)或模拟复制去取选中文本 + 把鼠标坐标当成工具栏位置。
你的新猜测("只是检测鼠标框选动作 + 查窗口是不是在白名单里")基本正确,只差两点修正:
1)判定的粒度是进程名(Code.exe/NOTEPAD.EXE…),不是窗口标题;
2)取文本是两级策略(MSAA 优先 → 模拟 Ctrl+Insert 兜底,且剪贴板会完整恢复)。
个人补充:这里的模拟 Ctrl+Insert 在夸克的实际使用中会有bug,经常导致 Insert 状态无法正常恢复
1. 代码/资源分布(先把地图画出来)
| 位置 | 作用 | 与划词的关系 |
|---|---|---|
7.4.2.1020\quark.dll(322 MB) | 单体 Chromium 构建,所有 C++ 业务代码都在这(含 quark\browser\... 自研目录) | ★ 划词全部逻辑在这里 |
7.4.2.1020\quark_app_shared.dll(350 KB) | Office/PDF 文档接管 + COM 自动化(Excel/Word/WPS/Acrobat/Foxit) | ★ 表格类应用的"选中内容"走它的 COM 通道 |
7.4.2.1020\Locales\zh-CN.pak | Chromium grit 字符串表(未压缩) | UI 文案(含"划词") |
7.4.2.1020\Resources\webui.pak | 内嵌 WebUI 的 JS | 大面板(AI Launcher)用的网页层 |
7.4.2.1020\Resources\app.asar(275 MB) | 网盘/知识库等网页前端 | 与划词无关(里面没有"划词") |
%LOCALAPPDATA%\Quark\User Data\cms_config(923 KB) | ★★ 服务端下发的配置缓存 | ★★ 白名单、URL 黑名单、工具条按钮表都在这 |
7.4.0.1015\ | 上一版本残留 | 忽略 |
你问"有没有别的文件夹有重要逻辑":有,而且不在安装目录——
C:\Users\76269\AppData\Local\Quark\User Data\cms_config才是划词"放不放行"的真值来源。
命名规律:夸克内部把这个功能叫 Wording(划词),模块目录 quark\browser\ai_launcher\,
UI 控件叫 QuarkWordingToolbarDialog。
2. 触发层:它到底"检测"了什么
2.1 从字符串直接读出来的流水线
quark.dll 里同一批日志字符串(.rdata 按编译单元连续排列,地址 0x0110945xx–0x0110954xx)几乎等于伪代码:
LauncherWindows::OnMouseLButtonDownEvent skip key_downing
LauncherWindows::OnMouseLButtonDownEvent skip current_wnd null
LauncherWindows::OnMouseLButtonDownEvent accepted process=
LauncherWindows::StartLauncher skip background_wnd null
LauncherWindows::StartLauncher trigger start
LauncherWindows::ShowSelectionWindowIfNeeded skip not processing
LauncherWindows::ShowSelectionWindowIfNeeded show selection process=..., text_length=
LauncherWindows::ShowSelectionWindowIfNeeded no selection
LauncherWindows::RegisterShortcut shortcut_id=..., accelerator=翻译一下:
- 鼠标左键按下时先做一道廉价过滤:
key_downing:当前是否有键按住(GetAsyncKeyState)→ 有(比如 Shift/Ctrl)就跳过;current_wnd null:光标下没有窗口 → 跳过;accepted process=:取光标下窗口所属进程名,命中白名单才继续。
- 通过后
StartLauncher(需要background_wnd存在,说明它是常驻的,不是每次新建)。 - 抬键后
ShowSelectionWindowIfNeeded:先把选中文本取出来(日志里紧接着text_length=),
取到非空才弹;取不到就no selection什么都不弹。
2.2 位置:确实不查选区,只查鼠标
你的观察完全正确,代码也印证:
- 没有任何"求选区矩形"的迹象(既没
UIA_TextPatternId::GetSelection,也没做 Chromium AX 的 bounding box 回传); - 位置参数来自弹窗组件本身:字符串里有
auto_size_to_screen、auto_size_to_screen_bottom_space、horizontal_align、vertical_align、popup_inside_view_radius、draggable_top/bottom、popup_close_on_deactivate(_delay)
→ 即"以鼠标点为锚,上方放不下就按auto_size_to_screen_bottom_space翻到下方",而不是"贴着选区"。
所以你看到"选中框不动、工具栏上下偏移"是设计如此,不是 bug。
2.3 用了哪个 Win32 原语?
quark.dll 的导入表被做了手脚(可见 Import Directory 只有 15 个 DLL),但 Delay-Load 目录是完整的,
我把它解出来(0x127d63d0,48 个 DLL),里面一次性出现了所有"全局监听"的可能选项:
USER32.dll (delay-import 节选)
SetWindowsHookExW, CallNextHookEx, UnhookWindowsHookEx ← 低层鼠标/键盘钩子
RegisterRawInputDevices, GetRawInputData, DefRawInputProc ← Raw Input(RIDEV_INPUTSINK 可后台收)
SetWinEventHook, UnhookWinEvent ← WinEvent 全局事件
GetLastInputInfo, GetMessageTime, GetMessagePos, GetCursorInfo,
GetCursorPos, GetGUIThreadInfo, GetAsyncKeyState, GetKeyState,
TrackMouseEvent, GetDoubleClickTime
OpenClipboard/GetClipboardData/SetClipboardData/EmptyClipboard,
GetClipboardSequenceNumber, IsClipboardFormatAvailable
SendInput
WindowFromPoint, GetForegroundWindow, GetClassNameW, EnumWindows, ...
ole32.dll : OleGetClipboard, OleDuplicateData, ReleaseStgMedium ← 剪贴板"全格式"备份/恢复
OLEACC.dll: AccessibleObjectFromWindow, AccessibleChildren, ... ← ★ MSAA 客户端(取别的进程的选中文本)
UIAutomationCore.DLL: **只有 Uia*Provider* / UiaReturnRawElementProvider** ← 只做 provider,不当 UIA 客户端两条重要排除:
- ❌ 不是 TSF:整套 import 里没有任何
msctf.h侧的东西(MSCTF.dll只是 Chromium/输入法通用加载)。 - ❌ 不是 UIA 客户端取文本:
UIAutomationCore的导入全是 provider 端导出(夸克自己是 Chromium,
需要向别人提供 UIA 树)。取别家的选中文本走的是 MSAA(oleacc):AccessibleObjectFromWindow。
✅ 触发层是"Win32 全局鼠标事件",但具体是哪一种我无法从静态证据 100% 断言(见 §2.4)。
无论哪种,行为等价:它拿到的只是 "按下/抬起 + 屏幕坐标 + 当时的窗口/进程"。
2.4 为什么"鼠标时间"这个细节很重要(我的推断)
关键串:
SelectionText::GetSelectionTextByClipboard abort mouse time changed before store
SelectionText::GetSelectionTextByClipboard abort mouse time changed after delay
SelectionText::GetSelectionTextByClipboard abort mouse time changed before send ctrl+insert
SelectionText::GetSelectionTextByClipboard abort mouse time changed after ctrl+insert
SelectionText::GetSelectionTextByClipboard abort mouse time changed before return它在剪贴板操作的每一个异步边界都重新校验一次"鼠标时间有没有变"。这说明:
它保存了一个"这次交互的时间戳",一旦用户在取词过程中又动了鼠标/点了别的地方,整条链路立刻放弃
(否则会把别人后来选的东西当成你的选中文本,或者把工具栏弹到错误的地方)。
这种"鼠标事件自带时间戳 + 全程可比对"的写法,最自然的是 WH_MOUSE_LL 钩子(MSLLHOOKSTRUCT.time),
其次才是定时轮询(GetAsyncKeyState(VK_LBUTTON) + GetCursorPos + GetLastInputInfo)。OnMouseLButtonDownEvent 这种命名、以及在按下时就用 accepted process= 做过滤,更像钩子回调。
—— 这一条标记为推断,未拿到指令级证据(quark.dll 无符号、字符串里也没有钩子安装日志)。
想彻底钉死,可以跑 §7 的实验脚本,或做一次行为实验,见 §7.3。
3. 取文本:三级策略(这是最值得抄的部分)
SelectionText:: 前缀的日志串把实现摊开了:
SelectionText::GetText use automation success
SelectionText::GetText use automation empty
SelectionText::GetText skip clipboard by copy blacklist
SelectionText::GetText fallback clipboard第 1 级:MSAA(通用)
AccessibleObjectFromWindow → IAccessible → get_accSelection / IAccessibleText,
拿不到再退回 OBJID_CARET。这条路对 记事本 / Word / 标准编辑框 / Chromium 系(浏览器、VSCode)都有效。
(这解释了你的疑问:为什么不开 VSCode 无障碍,夸克也能取到 —— Chromium 检测到无障碍客户端访问时会
"按需开启"(on-demand accessibility)AX 树,所以客户端一探就有;见 §6。)
第 2 级:COM(表格类)
quark_app_shared.dll 里:
Excel.Application / KET.Application / KWPS.Application / Word.Application
find selection connection point failed
advise excel selection change failed
selection monitor started / stopped / not running
selected_text / selected_cells
only Excel.Application and KET.Application are supported即对 Excel/WPS 表格用 COM connection point(Advise) 监听选区变化,直接读 Selection,
因为表格里"复制出来的是单元格文本",MSAA 给的往往不可用。
第 3 级:模拟复制 + 剪贴板(兜底)
关键串(按顺序):
SelectionText::GetSelectionTextByClipboard skip ctrl down
SelectionText::GetSelectionTextByClipboard acquire clipboard mutex failed ← ScopedNamedMutex
SelectionText::GetSelectionTextByClipboard store_old_clipboard=
SelectionText::GetSelectionTextByClipboard skip store_old_clipboard for process=
SelectionText::GetTextByClipboard ... text_length=
SelectionText::GetSelectionTextByClipboard restore_old_clipboard=
SelectionText::GetSelectionTextByClipboard result=
SelectionText::StoreClipboard OleGetClipboard failed, sc=
SelectionText::StoreClipboard EnumFormatEtc failed, sc=
SelectionText::StoreClipboard get format data failed, format=
SelectionText::StoreClipboard saved format_count=
SelectionText::LockClipboard failed, max_try=
SelectionText::RestoreClipboardContent restored success, success_count=..., failed_count=
SelectionText::SendControlInsert skip ctrl already down
SelectionText::SendCopyShortcut SendInput failed, shortcut=
ctrl + insert
SelectionText::SendControlInsert clipboard sequence unchanged逐条解读 → 这就是一份"生产级实现清单":
- 按住 Ctrl 就不做(否则我们合成的 Ctrl+Insert 会跟用户手上的 Ctrl 打架)。
- 命名互斥量串行化(多实例/多线程不能同时动剪贴板)。
- 全格式备份:
OleGetClipboard()拿IDataObject→EnumFormatEtc枚举所有格式 →
对每个 formatGetData一份(OleDuplicateData),不是只备份纯文本。skip store_old_clipboard for process=:如果剪贴板当前所有者是"某些进程",干脆不备份
(典型场景:截图工具正在写图、剪贴板管理器在忙 → 备份会损坏它的数据)。
- 发
Ctrl+Insert,不是Ctrl+C。(ctrl + insert字符串 +SendControlInsert函数名) - 用
GetClipboardSequenceNumber()校验是否真的变了(clipboard sequence unchanged= 复制失败)。 - 读
CF_UNICODETEXT(OpenClipboard/GetClipboardData/GlobalLock,带max_try重试)。 - 恢复全部格式(
RestoreClipboardContent+success_count/failed_count)。 - 每一步前后做 §2.4 的"鼠标时间"校验,过期即放弃(并且先恢复剪贴板再返回)。
为什么要 Ctrl+Insert? 这是本次研究里最有实用价值的发现之一,它直接解释了你测试矩阵里的怪现象:
| 应用 | 白名单 | MSAA | Ctrl+Insert 是否等于"复制" | 观察结果 |
|---|---|---|---|---|
| 记事本/Word | ✅ | ✅ | ✅(标准编辑控件) | 生效 |
| 浏览器网页 | ✅(msedge/chrome/firefox) | ✅(Chromium 按需 AX) | ✅(Chromium 绑定 kCopy) | 生效 |
| VSCode | ✅ Code.exe | ✅ | ✅(VSCode 默认键位里 Ctrl+Insert = copy) | 生效 |
| QQ/微信 | ✅ | ✅(自绘但有 MSAA) | — | 生效 |
| Typora | ✅ Typora.exe 在白名单里 | ✗ | ✗(CodeMirror 没绑 Ctrl+Insert) | 失败 |
| Obsidian | ✗ Obsidian.exe 不在名单里 | — | — | 失败 |
| DSH / 其他 Electron | ✗ | — | — | 失败 |
| 资源管理器地址栏 | ✗ explorer.exe 不在名单里 | — | — | 失败 |
两条结论:
- Obsidian 失败是"白名单"问题;Typora 失败是"取文本"问题(白名单过了,但 MSAA 空 + Ctrl+Insert 无人响应 →
clipboard sequence unchanged/clipboard text empty→ 不弹)。 - 白名单 ≠ 一定能弹;它只是必要条件。
另外有 mintty.exe 这个硬编码特例(Git Bash 终端),以及 ai_launcher_wording_copy_blacklist
("禁止对它模拟复制"的进程名单,当前服务端值为空)。
4. 闸门:白名单/黑名单到底长什么样(已从运行时配置读出来)
位置:C:\Users\76269\AppData\Local\Quark\User Data\cms_config
(服务端 CMS 下发,poll_interval=5 轮询热更新;本地键 pc_ai_desktop_plugin_control)
{
"ai_wording_enable": "1",
"ai_launcher_wording_whitelist": [ // ★ 37 项,按进程名匹配
"iDingTalk.exe","quark.exe","WeChat.exe","msedge.exe","WINWORD.EXE","360SE.exe",
"NOTEPAD.EXE","QQBrowser.exe","WXWork.exe","DingTalk.exe","SogouExplorer.exe",
"idea64.exe","Code.exe","firefox.exe","POWERPNT.EXE","360ChromeX.exe","QQ.exe",
"Feishu.exe","devenv.exe","哔哩哔哩.exe","Chrome.exe","360chrome.exe","pycharm64.exe",
"SLBrowser.exe","notepad++.exe","wpp.exe","TencentDocs.exe","2345Explorer.exe",
"WeMail.exe","Foxmail.exe","Telegram.exe","chrome.exe","UV4.exe","studio64.exe",
"studio.exe","WeChatAppEx.exe","Typora.exe"
],
"ai_launcher_wording_blacklist": "", // 反向名单(当前空)
"ai_launcher_wording_copy_blacklist": "", // 不做"模拟复制兜底"的进程(当前空)
"ai_launcher_wording_cursor_whitelist": "", // 光标判定特例(当前空)
"ai_launcher_wording_url_blacklist": [ // 这些 URL 上不弹(夸克自己的聊天页)
"quark.cn/chat","quark-settings","qianwen.com","quark.cn/pc-chat",
"p.quark.cn/chat","p-pre.quark.cn/chat","render.alibaba.net/chat"
],
"ai_launcher_wording_ai_side_panel_enable": "disable",
"ai_launcher_wording_ai_launcher_window_enable": "disable",
"ai_toolbar_list": [ /* 7 项:AI 搜索/HIGHLIIGHTING_CHAT、翻译/TRANSLATE、总结/AI_CHAT_SUMMARY、… */ ],
"ai_highlight_items_max_count": "5"
}要点:
- 判定键 = 进程可执行文件名(大小写不敏感;同时写了
chrome.exe和Chrome.exe就是证据)。
→ 你的"资源管理器不生效"=explorer.exe不在名单里,不是技术做不到。 - 名单在服务端,可灰度、可热更;本地只是缓存。所以不同时间/不同用户行为可能不一样。
- 还叠了一层
text_selection_conflict_config("与别的划词工具冲突"的让路名单)和
cold/hot start traffic config(冷/热启动灰度),来自quark\browser\feature_yield\feature_yield_service.cc。 - 可观测字段(埋点,也说明它靠这些特征做启发式):
win_class、double_click、has_text、text_cursor、found_copy、always_arrow_cursor
→ 它会看当前光标是不是 I 型(I-beam)来判断"这块像不像可选文本",
对"永远是箭头光标"的应用另有分支。这就是persistent_cursor_whitelist那类配置的意义。
5. 弹窗:native Views + 不抢焦点(关键工程细节)
相关符号:
..\..\quark\browser\ui\views\toolbar\quark_wording_toolbar_dialog.cc ← 主实现
QuarkWordingToolbarDialog::QuarkWordingToolbarDialog
QuarkWordingButton / WordingMenuButton ← 按钮
WordingMenuButton::ButtonPressed
..\..\quark\chrome\browser\quark_pdf\toolbar\quark_pdf_wording_toolbar_dialog.cc ← PDF 内专用
quarkAiToolsPrivate.onWordingDialogButtonClicked
quarkAiAppSharedPrivate.getCurWordingInfo
ai_desktop_controller.is_wording_open / show_wording_dialog
kQuarkWordingAisearchIcon / AisummaryIcon / TranslateIcon / CopyIcon / AiwriteIcon / MoreIcon …
selection_toolbar_ask / _search / _summarize / _quote / _translate / _writing
quarkpc.ai_toolbar.{search,summary,translate,polish,copy,question,open_url,explain}.0
quarkpc.ai_toolbar.more.{abbreviation,expand,continue,disable_all,disable_one}即:小工具条是 Chromium Views 的原生窗口(不是 HTML),
只有"AI 搜索/AI 对话"展开的大面板才是 WebUI(chrome://ai-desktop-plugin/launcher/,
字符串里有 https://www.myquark.cn/?...&qk_module=/browser/ai_launcher&...)。
5.1 运行时实测到的窗口(未触发,静息状态)
枚举夸克浏览器进程(pid 53628)的全部顶层窗口,发现常驻但隐藏的这些:
cls=Chrome_WidgetWin_1 vis=False rect=(16, 558, 333, 36) ex=0x08200088
cls=Chrome_WidgetWin_1 vis=True rect=(2566,1254, 48, 48) ex=0x00200088
cls=Chrome_WidgetWin_1 vis=False rect=(2586,1254,148, 48) ex=0x00200088
cls=Chrome_WidgetWin_1 vis=False rect=(2566,1078,168,212) ex=0x00200088
cls=Chrome_WidgetWin_1 vis=True rect=(2566,1167, 48, 97) ex=0x00200088(333 × 36) 那个尺寸与"一条 6 个小图标的胶囊"高度吻合,ex=0x08200088 拆开是:
0x00000080WS_EX_TOOLWINDOW—— 不进任务栏 / 不参与 Alt-Tab0x08000000WS_EX_NOACTIVATE—— 点了不激活、不抢焦点0x00200000WS_EX_NOREDIRECTIONBITMAP—— 无重定向表面(配合 DirectComposition 合成,Chromium 常用)
推断(标 □ 表示未 100% 证实):这个窗口就是划词条,预创建、复用、隐藏着等,
所以第一次弹出也几乎无延迟;WS_EX_NOACTIVATE 是它的灵魂——
如果点击工具条会激活我们自己的窗口,源应用失焦 → 选区消失 → 后面的"复制/翻译"就全废了。
(同理,"先取文本,再弹条"的顺序也避免了这个坑:日志里 show selection process=..., text_length=。)
6. 回到你的三个痛点 + 我建议的做法
痛点 A:「基本拿不到选中文本框的位置」
👉 别拿了。 夸克也没拿。位置 = 鼠标坐标;再做一个"上方放不下就翻下 / 出屏就夹到工作区"的自适应。
只保留两个必要修正:多显示器(用 MonitorFromPoint 取 work area,别用 GetSystemMetrics)和
Per-Monitor DPI(GetDpiForWindow/WM_DPICHANGED)。
痛点 B:「模拟复制污染剪贴板,还没做恢复」
👉 照 §3 第 3 级做,顺序别改:named mutex → OleGetClipboard → EnumFormatEtc 全格式备份 → SendInput(Ctrl+Insert) → GetClipboardSequenceNumber 校验 → 读 CF_UNICODETEXT → 全格式恢复 → 释放 mutex。
三个容易漏的点:
- 只备份"纯文本"是不够的,用户剪贴板里常常是图片/文件/HTML,必须逐 format备份(
OleDuplicateData); - 恢复要在
finally里做,并且中途被打断也要恢复(夸克用"鼠标时间变了"当打断信号); - 剪贴板被别的进程占用时
OpenClipboard会失败 → 要有限次重试 + 超时(max_try)。
痛点 C:「VSCode 取不到」
👉 两条腿都补上:
- 补 MSAA(不是 UIA):
AccessibleObjectFromWindow(hwnd, OBJID_CLIENT, IID_IAccessible)→get_accSelection()→ 对每个IAccessible取get_accValue(VAR_CHILDID_SELF);
失败再试OBJID_CARET+IAccessibleText::get_text。
Electron/Chromium 系(VSCode)在你挂上客户端后会按需开 AX,不要求用户手动开"屏幕阅读器支持"。 - 兜底快捷键换成
Ctrl+Insert(比Ctrl+C命中面更广:记事本/Office/浏览器/VSCode 都认,
而且不容易被应用自定义键位吃掉)。取不到就安静地什么都不弹,不要弹空工具条。
推荐架构(any-menu)
[独立的小 helper(推荐)]
├─ WH_MOUSE_LL 钩子(或 50ms 轮询 GetAsyncKeyState(VK_LBUTTON))
├─ 状态机: DOWN(记录 pt/time/hwnd/proc) → MOVE(位移阈值) → UP
├─ 过滤: 进程名白名单(本地配置) / 排除自身进程 / 排除本应用窗口
├─ 取文本: MSAA → (表格:COM) → Ctrl+Insert+剪贴板(全格式备份恢复)
└─ 非空 → 弹窗(WS_EX_NOACTIVATE + WS_EX_TOOLWINDOW + SW_SHOWNOACTIVATE)
[Electron 侧]
BrowserWindow({ frame:false, transparent:true, alwaysOnTop:true,
skipTaskbar:true, focusable:false, show:false })
win.showInactive() // ★ 千万别用 show()要点:helper 单独进程更稳(钩子回调必须在有消息循环的线程里,且 Electron 主进程被 JS 阻塞时
钩子会拖慢全局鼠标——WH_MOUSE_LL 是同步的,回调里千万别做重活,只记录状态 + PostMessage)。
判定建议(比夸克更好做的部分,因为你可以给用户开配置):
- 白名单默认给一批(
Code.exe/notepad++.exe/WINWORD.EXE/chrome.exe/msedge.exe/QQ.exe/WeChat.exe…),
并且允许用户自己加(夸克只能等服务端下发,这点你可以做得更好); - 额外加
win_class黑名单(排除Shell_TrayWnd/Progman/WorkerW等),比单纯进程名更稳; text_cursor(GetCursorInfo().hCursor == LoadCursor(NULL, IDC_IBEAM))作为"要不要试一下"的廉价预判,
但不要把它当硬门槛(很多自绘编辑器永远是箭头)。
7. 想自己复核的话
debug\ 里我留下了这些:
| 文件 | 用途 |
|---|---|
pe.py / filt.py | 纯 Python PE 导入/导出解析(注意:quark.dll 的 Import Directory 被清过,要看 Delay-Import,我这次的教训) |
grepstr.py / dump_range.py / strings.py / scan*.py | 二进制字符串提取(含 UTF-16 中文) |
imports.txt / quark_exports.txt | 全模块导入导出快照 |
str_wording.txt / str_selection.txt / range_ailauncher.txt | 本次结论的原始证据(划词/SelectionText/ai_launcher 区段) |
spy.py | 窗口/模块枚举(`windows |
test_select.py | 自动化验证脚本(在记事本里自动拖选,记录新窗口 + 剪贴板序列号)——我没能运行(权限被拒),你可以直接跑 |
7.1 用 spy.py 抓一次真实弹出
python debug\spy.py windows quark # 静息状态:能看到那个隐藏的 333x36 窗口
# 然后手动在记事本里划一段字,立刻再跑一次:
python debug\spy.py windows quark # 应该看到它变成 vis=True 且 rect 跟着鼠标走判定点:如果 vis 变 True 且 rect 的左上角≈鼠标点、(w,h) 仍是 333x36 左右,
则 §5.1 的"预创建复用"推断成立。
7.2 区分白名单 / 取文本(最有价值的行为实验)
- 在 VSCode 里划词 → 应弹(白名单 + MSAA/键位都通);
- 在 Typora 里划词 → 若不弹,几乎就能确定是"取文本"失败(它在白名单里);
- 在 Obsidian 里划词 → 不弹,白名单问题;
- 想要旁证:在 Obsidian 里手动按
Ctrl+Insert,如果没有复制反应,就说明兜底路径在 Electron/CodeMirror 里天然不通。
7.3 想彻底钉死"钩子 vs 轮询"(可选)
- 用 5 ms 的极短"按下→抬起"划过一段已选中的文字:轮询实现容易漏,钩子不会;
- 或在
spy.py里加GetLastInputInfo的时序采样,看夸克是否在没有鼠标事件的间隙也做周期性工作(轮询会有稳定节拍)。
8. 证据索引(地址均为 quark.dll 文件偏移)
| 偏移 | 内容 |
|---|---|
0x0110a6dce | ..\..\quark\browser\ui\views\toolbar\quark_wording_toolbar_dialog.cc |
0x0110a6f01 / 0x0110a6f62 | QuarkWordingButton / WordingMenuButton |
0x0128df320 | ButtonPressed@WordingMenuButton(RTTI) |
0x011091710 | ai_wording_enable |
0x0110917d0–0x011091870 | ai_launcher_wording_{blacklist,whitelist,copy_blacklist,cursor_whitelist,url_blacklist} |
0x011092113 | OnSDKWordingSelection |
0x011092399 / 0x01109258b | WordingDialogButtonClick / WordingDialogHide |
0x011094615–0x011094654 | win_class,double_click,has_text,text_cursor,found_copy,always_arrow_cursor |
0x011094702–0x011094aac | LauncherWindows::*(触发与过滤) |
0x011094ae8–0x0110953b1 | SelectionText::*(备份/复制/恢复/校验) |
0x011094efd | mintty.exe(硬编码特例) |
0x01105a79d | getAppSelection / startMonitorAppSelection / stopMonitorAppSelection |
0x0110b0450 | QuarkAiAppSharedService::StartMonitorAppSelection |
0x0117efb70 | quarkAiToolsPrivate IDL(AiToolbarType 全枚举) |
0x0117eba10 | quarkAiAppSharedPrivate IDL |
Delay-Import 0x127d63d0 | 48 个 DLL 的完整延迟导入表(触发原语都在这里) |
0x127d7c46 | SetWindowsHookExW 导入名 |