Skip to content

Make clipboard capture safer and add tray and provider settings - #3

Merged
qhmiao merged 17 commits into
qhmiao:mainfrom
Stellar-He:fix/safe-clipboard-capture
Oct 20, 2026
Merged

qhmiao merged 17 commits into
qhmiao:mainfrom
Stellar-He:fix/safe-clipboard-capture

Conversation

@Stellar-He

@Stellar-He Stellar-He commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

旧的取词流程会通过 OLE 读取剪贴板所有格式,可能进入 CLR 原生崩溃路径;全局鼠标拖动还会把窗口操作、文件拖动和空选区当作文字选择。本 PR 改为先在短时独立进程中确认文本上下文并读取选区,仅在已确认的文本区域缺少接口时使用受保护的 Win32 剪贴板回退,同时修正托盘外观并增加翻译服务选择。

主要改动

  • 剪贴板安全:限定备份格式与数据大小,检查序列号、所有者和源窗口,限制重试并串行化取词。保留原内容,避免覆盖期间出现的新剪贴板数据;移除原 OLE 快照路径。
  • 独立选区读取:UIA 对象仅存在于短时辅助进程,主程序不引用 UIAutomationClient。验证窗口归属、密码字段和长度上限,按鼠标位置查找选区,设置独立进程期限并丢弃过期结果。空选区和非文本交互直接结束;已确认文本的读取失败仍明确提示。
  • 拖动上下文:排除标题栏、边框、原生滚动条和窗口移动/缩放。鼠标起点的原生窗口与位置传入辅助进程,先验证起点,再读取终点;Esc 取消拖动后不再排队取词。未知区域不盲目复制,不读取其他焦点的旧选区。
  • Explorer 文件属性:文件属性可能报告为 Edit,却没有 TextPattern。结合 Selection/SelectionItem 祖先、焦点和只读元数据,将未活动或只读的项目属性识别为非文本。真正重命名编辑框及有 TextPattern 的只读文本仍可选词;不使用进程名、窗口名或控件类名黑名单,也不统一吞掉文本读取错误。
  • 托盘外观:按实际字形居中绘制多尺寸图标,跟随保存的字体与背景色,验证保存、取消和连续替换时的资源占用。
  • 翻译服务:保留默认自动模式,可单独选择微软、腾讯或可选的 DeepL;隔离服务/语言/凭据缓存,设置变化时取消旧请求,明确选择单一服务后失败不自动切换。
  • DeepL 官方 API:使用固定官方端点和标准认证,不自动调用、重试或重定向。密钥输入遮挡且不回填,使用当前用户 DPAPI 独立保存,清除在保存后生效;错误文本和日志不包含密钥或响应正文。

验证

  • e51b648 的 Windows CI 全部通过,包含构建、剪贴板流程、原生手势、上下文、翻译服务、隔离原生剪贴板、词库、完整离线自测与真实选区辅助进程测试。
  • 70 项上下文检查通过,包括隐藏的真实列表、树、MSAA Edit 属性、文本框、只读文本和系统浮层常见控件语义。非文本路径在可备份与不可备份剪贴板条件下均不快照、复制、读取或恢复;普通无接口 Edit 与确认文本失败仍保留原行为。
  • 17 项窗口手势检查、TextBox/RichTextBox 选区及空选区集成测试、剪贴板流程回归通过。测试选词可经过辅助进程、上下文判断和语言过滤命中本地词库。
  • 实际 Explorer 基线已人工复现:单选或多选文件后横拖释放会报错,框选不报错,文件重命名选词正常。对同一真实 Explorer 的 12 个属性单元格比较,旧辅助程序均返回 text-unsupported,候选均返回 non-text;比较未读取文件名、选区原文或剪贴板。人工复测反馈文件拖动误触发已修复;结论限于已复测场景。
  • DeepL 测试仅使用虚构密钥、模拟 HTTP 响应及临时凭据文件,覆盖端点、认证、错误、取消、缓存隔离、DPAPI 与设置回滚。设置预览中的密钥输入为空。

边界

原始原生崩溃尚未重新触发,具体剪贴板格式或提供方仍不明确。Win32 延迟渲染可能阻塞,也不存在多格式原子恢复保证。辅助进程是取词依赖,必须与主程序一起分发;进程隔离不是权限沙箱。

隐藏控件测试和真实属性分类比较不替代鼠标交互验收。Explorer 拖动修复已获得人工复测反馈,但修复后的框选、取消拖动、重命名及普通应用选词未逐项记录独立结果。UIA 起点语义在释放后的辅助进程中检查,源界面完全重建的情况仍需实际应用验证。完全自绘且始终返回客户区的滚动条、不同 DPI、管理员窗口和系统浮层的全部交互未获完整覆盖。

尚未使用真实 DeepL 账户或密钥联调,也未发起计费请求;不包含企业区域端点。DPAPI 不能防范同一用户身份下的其他进程,配置、凭据和启动项保存不构成跨文件崩溃原子事务。

@Stellar-He Stellar-He changed the title Make clipboard capture safer and refine tray and provider settings Make clipboard capture safer and add tray and provider settings Oct 14, 2026
@qhmiao
qhmiao marked this pull request as ready for review October 20, 2026 04:02
@qhmiao
qhmiao merged commit 45637d9 into qhmiao:main Oct 20, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants