截图之后的所有事
一个托盘图标解决

变更 · 开机自启改为静默启动（重新打包）

• 注册表 Run 项写入 "…\snipforge.exe" --silent。登录 Windows 后只驻留托盘图标， 不再弹主界面抢焦点；主窗口照常创建，热键、托盘、剪贴板监听全都正常， 点托盘或按热键随时亮出来
• 手动双击 exe 不带该参数，行为不变（照常显示主界面）
• 老版本写入的自启项在下次启动时自动校正成带 --silent 的写法，不用手动重开开关
• 静默启动时撞上已有实例直接安静退出，不弹"已经在运行"的对话框

新增 · 开发者工具箱（插件形式）

21 个本地工具，侧边栏「开发工具」进入，手势里也能挂一条。

• 编码转换：Base64（URL-safe / 折行）、URL、Hex、HTML 实体、Unicode 转义、JWT 解析
• 格式化 / 校验：JSON（带行列报错、键排序）、XML、SQL、正则测试（高亮 + 分组明细 + 替换预览）
• 生成 / 计算：UUID、时间戳互转、哈希（MD5/SHA-1/256/384/512）、随机密码、进制转换、Cron 下次触发
• 文本处理：命名风格（camel/snake/kebab…）、去重排序、行级 diff、行处理、字数统计
• 工具目录写在 plugins/devkit.plugin.json，算法在前端注册表 src/lib/devkit/。 清单一改，导航和工具列表跟着变；插件页可以整体开关这个工具箱
• MD5 是手写的（Web Crypto 不提供），已和 Node 的 crypto 对过 8 组输入； 密码用拒绝采样 + 保证每类字符至少一个；进制转换走 BigInt，超过 2^53 不丢精度

变更 · 手势引擎换 8 方向（破坏性）

• 方向从 4 个扩到 8 个：上下左右 + 四个斜向。位移按 45° 扇区判定， 一个方向走够 step 才记一个 token
• 逗号分隔 token：D,R = 先下后右，DR = 一条右下斜线 —— 不分开的话 这两种手势会撞成同一个串
• 容错一个 token：转折处多判/少判一个方向是常态，要求逐字相等太脆。 DR,UR 和 DR,U,UR 都能命中 V
• 掉头要 1.8 倍距离：上↔下、左↔右这种正相反的方向，防转折点抖动 切出多余 token
• 删掉形状识别：点云匹配、模板阈值、@ 前缀、自定义笔画全部去掉。 S / H 改用方向串写（S = DL,DR,DL，H = D,R,D），行为从"黑盒猜" 变成"画什么就是什么"
• 默认绑定全部重配（配置迁移 v5 会重置，旧绑定在新语义下意思全变了）： 四个主方向 + DR/DL 两条斜线 + 若干组合
• 录制框改成「画一遍 → 后端翻译成方向串」，和真手势共用同一套判定

变更 · 默认手势定稿（8 方向）

按实际使用习惯重排，配置迁移 v6 会重置绑定：

浏览器专用集：↑ 页顶 / ↓ 页底 / ↘↗ 刷新 / ↗↘ 强制刷新 / ↓→ 关标签 / ↑→ 右侧标签 / ↑← 左侧标签 / ↓→↓ 主页。

新增三个动作：

• 关闭同程序其他窗口：枚举同进程、可见、有标题的顶层窗口发 WM_CLOSE， 当前窗口留着。没有标题的多是隐藏辅助窗口，关掉会伤到正在运行的程序
• 搜索选中文字：先 Ctrl+C，180ms 后读剪贴板，开 Bing
• Ping 选中地址：Ctrl+C 后只保留域名/IP/端口的合法字符， 直接 spawn ping —— 不经过任何 shell，没有命令注入面

修复

• 右键点一下菜单不弹（被"吞"了）。判定的顺序错了：先看方向串再看位移。 手抖 40 多像素时 path_to_dir 已经能切出一个 token（R/D/…），而单 token 手势是精确匹配的 —— 于是"点一下"变成执行动作，菜单自然不出来。 现在位移 < 48px 一律按单击补发，不看向量算出了什么
• 补发点击加了诊断日志（光标位置 + 光标下的窗口类名 + SendInput 的返回值和 错误码）。以后"补发没生效"能一眼看出是没发出去，还是发到了别的窗口

审计（第二轮）

• 方向解析（dir8 / RDP / 折线简化）搬进 snipforge_core::stroke， 补 8 条单测。这块以前一条测试都没有 —— 而"画 3 段出 5 个 token" 正是这里出过的 bug。现在覆盖：8 个扇区、22.5° 边界、直线单 token、 直角两 token、↙↘↙ 三段、锯齿抖动仍是一段、相邻同向合并、过短轨迹不出 token
• step 字段已废弃：RDP 之后"几段就是几个 token"，本来按"走够多少像素 算一次转向"的 step 不再参与任何判定。从 Snapshot 和 on_move 里删掉， 配置字段保留但注明废弃（删了会让旧配置文件丢字段）
• gesture_trace 去掉没用的 step 参数（前后端一起改）
• 文档对齐现状：docs/FEATURES.md 还在写"画一个 S 截图""@S/@H 形状命名空间""接管右键按下开关""$P 点云匹配"—— 这些都是已经删掉的东西。 整章按 8 方向重写，含默认手势表和三条匹配规则；README.md 的 "画一个 S 就截图"一并改掉

审计（手势链路）

一轮完整代码审计，按"会不会在钩子线程里出事"这条线逐层过：

• handle_event 每个 mousemove 都拿配置锁 + clone() 一个 String。 这个函数就在钩子线程里同步跑，等于持续分配内存。改为配置变更时写进 AtomicBool + RwLock<String>，热路径只做一次原子读
• on_move 在轨迹点数封顶后每个事件都做全量 RDP。pts 到 1500 后长度 不再变，1500 % 6 == 0 让重算条件恒成立 —— 越划越卡。改成只有真的压入 新点时才重算
• match_action 每次方向变化都整体 clone 专用手势集（连所有绑定的轨迹点）。 改成按引用索引
• inject_click 在钩子回调里调 SendInput。整理成整对发送都在工作线程 里做，回调只负责"决定要补点一下"
• "关闭同程序其他窗口"会把自己也关掉：枚举时没有排除当前窗口， 说是"其他窗口"，实际连用户正在用的那个一起 WM_CLOSE
• path_to_dir 里有两处 unwrap()（包围盒）。虽然前面对点数有保护， 但这段跑在钩子线程，panic 会连带整个输入链。改成单次遍历算包围盒
• on_move 的兜底之外，on_down 也会处理"上一次抬起丢了"的残留状态， 先把旧轨迹收掉再开新的
• 修正 gesture.rs 顶部过时的模块文档（还在描述已删除的点云形状识别、 四个方向）和 window.rs 里一段粘错位置的注释

• 在浏览器里画 ↓↑→↓ 打开的是主页，而不是编辑 hosts。原因是匹配顺序： 先查浏览器专用集，里面 ↓→↓（主页）只要"差一个 token"就算命中， 于是把通用集里精确命中的 ↓↑→↓ 挡住了。现在改成：

• 先比距离，精确匹配永远赢过模糊匹配；距离相同才让专用集优先 （专用集的意义是"在这个程序里覆盖"，不是"随便糊一个"）
• 容错按长度收紧：两段以内只认精确（↓→ 是关窗口，↓→→ 不该命中它）； 三段以上才允许差一个
• 只容忍"多画"，不容忍"少画"：转折处手抖多切一个 token 可以， 但 3 段手势不会去命中 4 段绑定 —— 否则画 ↓→↓ 会误触 ↓↑→↓
• 匹配规则搬到 snipforge_core::pattern。主 crate 的测试 harness 在本机 起不来（STATUS_ENTRYPOINT_NOT_FOUND），所以 gesture.rs 里的测试从来没跑过， 其中两条断言一直是错的（normalize("D-X,R") 和一处编辑距离）。搬进 core 后 36 项单测全绿，这两条也一并修正

• 吞一半按下/抬起会让系统按键状态卡死（这是这一轮所有怪现象的根）。 鼠标钩子吞掉一个事件，系统那颗键的状态就不会跟着变 —— 实测：放行 RButtondown、吞掉 RButtonup 之后，GetAsyncKeyState(VK_RBUTTON) 会一直返回 DOWN。后果是目标窗口一直以为右键按着：捕获不放、 菜单卡住、左键跟着失灵，得再点一次右键才恢复。 规则：按下和抬起必须成对处理，要么都放行，要么都吞掉
• 桌面右键菜单跳两下。整对吞掉后必须补发一次点击，而补发时按下和抬起 之间的间隔太短（35ms），桌面/任务栏的菜单还没建完，合成的抬起落在了底下 的桌面上，于是又开一次菜单。间隔改成 100ms（接近真人点击），抬起就能落到 已经建好的菜单窗口上
• 松手后手势不结束、轨迹一直跟着鼠标。根因是同时跑了两个实例： 两套钩子互相截事件，一边拿了按下、另一边拿了抬起，前者状态永远不清。 启动时用会话内命名互斥体挡掉第二个实例（弹提示后退出）；另外加 20 秒 超时兜底，任何情况下都不会再"永久跟随"
• 删掉 swallowDown 开关（配置项和界面都去掉）：两种模式只有一种是对的， 留个开关只会让人选到错的那个
• 手势只认 S 和 H，其余字母不再内置识别。一笔画的折线本来就是方向串 （↓→ 既是「向下再向右」，又恰好是字母 L 的写法），全字母参与识别时 每次「下再右」都被判成画字母。更要紧的是 RLR（画 Z 形）是「排除当前 程序」的默认绑定，会被 @Z 吃掉，排除功能直接失效。 现在只有 S / H 参与内置识别；其他字母在「鼠标手势」页画一遍存成自定义 手势即可 —— 只认你加的那一个，不干扰任何方向手势
• 画 ↓→ 时浮标报「未绑定」，但松手却执行了动作。原因：↓→ 的形状正好 等于字母 L 的模板（竖下 + 横右），被形状识别抢成 @L。执行层有回落 （@L 没绑就按方向串 DR 找），浮标层却只查 @L —— 显示和执行用了两套规则。 现在两处共用同一套回落，浮标显示的永远是真正会执行的那个动作

剪贴板 · 富文本与隐私

对照 TieZ 的剪贴板实现补齐三块：

• 富文本 HTML 保留（以前挂在 📋 计划里的那条）。采集时读 Windows 的 HTML Format，粘贴时同时写 CF_UNICODETEXT 和 HTML —— 从网页复制的表格、 带样式的文字，粘到 Word / 邮件 / 飞书里格式不丢；记事本、终端这类只认纯文本的 地方照常能粘。去重仍按纯文本 hash：同一段话复制两次不该变成两条历史
• 隐私遮罩预览：列表里手机号、身份证、银行卡、邮箱自动打码 （138**8000 / 110101****1234）。只影响显示**，选中后写进剪贴板的 还是原文。面板和主窗口都生效 —— 投屏、录屏、旁边有人的时候不至于把证件号念出来
• 按来源程序筛选：卡片底部的程序名现在可点，点一下只看那个程序里的复制记录； 再点一下（或点顶部「来自 xxx ✕」）取消
• 粘贴为纯文本：面板里 Alt+Enter，丢掉网页带来的字体颜色等样式， 只把文字塞过去。配合上面的富文本保留，两种场景各取所需

不做的事：WebDAV / MQTT 跨设备同步。这个工具的定位是本地常驻，剪贴板历史里 经常有密码和证件号，不上传比"能同步"重要。

鼠标手势 · 支持画字母

以前只能认方向（←→↑↓ 及其组合）和 S / H 两个形状，画 W、V、B、M 一律落到"未绑定"。原因是形状和方向串共用同一批字符：D 既是"向下划" 又是"字母 D"，加一个字母就得跟方向抢名字。

现在按主流工具的做法拆开：

• 一笔画字母基本都认：A B C D E F G H J K L M N P R S T U V W X Y （I 是一条竖线、等于方向串；O 是闭合圆；Q 一笔画不自然）
• 形状用 @ 前缀，和方向串分处两个命名空间：@W 是字母，DR 是方向。 用户手写 W 也认（自动补前缀）
• 形状没绑动作时自动回落方向串：画 Z 会先认成 @Z，没绑就落回 RLR， 「画 Z 排除当前程序」照常工作，不需要为每个字母补绑定
• 配置迁移 v4：老绑定里的 S / H 自动改成 @S / @H
• S 补了两个斜写模板（±10°）：点云不抗旋转，以前斜着写 S 认不出
• 形状识别从主 crate 搬到 snipforge-core，第一次有了真正能跑的测试 （letters_recognize_themselves：每个字母 6 个抖动/缩放变体必须认回自己）

鼠标手势 · 手感修复

反馈「划起来不流畅、不灵活，和其它手势工具差距极大」。定位到四个实现问题， 全部在轨迹层和默认参数上，与 UI 框架无关：

• 不再每帧重建 GDI 资源：画笔、画刷、字体改成随窗口缓存，只在分辨率或 轨迹色变化时重建。以前每帧 CreateFontW 一次，字体面查询就是几毫秒
• 重绘合并 + 66fps 上限：高刷鼠标每秒上千次位移，以前每次都投递一次重绘， 消息队列被灌满，表现是轨迹越划越落后于光标
• 只贴脏区：以前每帧清空并回贴整个虚拟屏（4K 双屏 800 万像素每帧）， 现在只处理「轨迹包围盒 ∪ 浮标包围盒 ∪ 上一帧范围」
• 灵敏度默认值 30/55 → 16/38：旧值划一小段没反应、短促手势划不出方向。 配置里两个值都还是旧默认的自动升级（v3 迁移），自己调过的不动
• 浮标停留 520 → 240ms：连续划两个手势不再互相干扰
• 轨迹采样加 2px 阈值，去掉一像素一报的抖动点

决策记录

• 新增 docs/ADR-001-ui-stack.md：评估 Rust + egui 迁移，结论是不迁。 内存 27 MB 不是瓶颈，且 egui 的立即模式对全屏覆盖层是负优化； 手势卡顿的根因在 GDI 重绘方式，换框架解决不了。文档里留了重新评估的触发条件

---

第一个预览版。Windows 10/11 x64。

截图

• 一个入口：Alt+Q 打开冻结画面，拖拽框选区域、单击选窗口、Ctrl 选整窗、 Ctrl+A 整屏、S 滚动长截图
• 滚动长截图按行签名拼接，最高 24000px
• 取完之后做什么可配：打开编辑器 / 直接复制到剪贴板 / 直接保存 / 钉在屏幕上。 选「直接复制」完全不弹窗口

标注与美化

• 矩形、椭圆、箭头、画笔、文字、序号、高亮、马赛克
• V 切选择工具，点中标注可拖动、Delete 删除，Esc 先退选中再退编辑器
• 撤销重做、颜色/粗细/字号可调；对象化模型（标注是数据不是像素）
• 美化：背景、边距、圆角、阴影；水印：文字/平铺/九宫格

取字（OCR）

• Windows 系统 OCR（需对应语言包）；可选 PaddleOCR 引擎，设置页一键下载安装 （多镜像 + 体积校验 + 离线导入）
• 识别结果手动触发翻译；点词复制：原图上每个词都是可点区域

剪贴板

• 文本 / 图片 / 文件 / 颜色四类全收，按 GetClipboardSequenceNumber 变更检测
• Alt+V 面板：搜索、分类、收藏、来源程序识别；Win+V 可用键盘钩子接管
• 历史落盘做了节流，连续复制不会反复重写索引

安全

• 主密码：Argon2id 派生 + AES-256-GCM，加密收藏的密码、图床 token、翻译 key。 设了主密码后磁盘上没有明文；启动即锁定，可随时「立即锁定」
• 忘记密码没有后门，唯一出路是「清空保险箱」（两段式确认）
• 路径穿越防护：图床目录、文件名、保存文件名统一出口校验

图床

• GitHub、S3 兼容、SM.MS、自定义、本地目录；声明式插件（JSON 描述即可接入新图床）
• 上传历史、连通性测试、目录浏览

录屏

• 视频（H.264 MP4）与 GIF 分开录，Ctrl+Alt+R / Ctrl+Alt+G
• 系统声音（WASAPI loopback，不用装虚拟声卡）+ 麦克风，两路自动混音， 静音时段按视频时间轴补静音
• 摄像头画中画：圆角+描边、四角位置、大小比例、水平镜像
• 恒定帧率、光标合成、点击高亮环、放大镜、暂停续录

其他

• 图标提取：exe / dll / lnk / APK / IPA → 各尺寸原始图标，可导出 PNG / ICO。 Android 自适应图标会合成背景+前景
• 图片工具：格式互转、质量压缩、等比缩放
• Hosts 编辑：可视化编辑，写入自动提权
• 鼠标手势：自定义手势绑定到任意功能
• 检查更新：启动后静默检查一次 GitHub Release，只提示不自动安装。 API 被限流时自动改用 releases 订阅（不受 60 次/小时配额限制）
• 联网走系统代理：图床上传、OCR 引擎下载、翻译、检查更新统一读取 Windows「Internet 选项」的代理设置（Clash / v2rayN 默认就是系统代理）， 也认 HTTPS_PROXY / ALL_PROXY 环境变量

关于与站点

• 设置 → 关于：新增「产品主页」「源码与反馈」「更新日志」三个入口。外链地址由后端 commands/about.rs 统一维护，界面只传名字，不再散落硬编码 URL
• 关于页补一行说明：截图、OCR、剪贴板、录屏均在本机完成，只有主动上传或允许检查更新时才联网
• 产品主页上线 GitHub Pages：<https://adream2.github.io/SnipForge/>（功能、截图、常见问题、下载）
• SEO：canonical、Open Graph / Twitter 卡片、sitemap.xml、robots.txt、1200×630 分享图
• GEO：JSON-LD（SoftwareApplication / FAQPage / WebSite / Organization）、llms.txt， 页面补「SnipForge 是什么」事实表与常见问题八问，便于搜索引擎与 AI 问答引擎直接引用
• 新增 npm run site:check（上线前自检）与 npm run site:ping（IndexNow 主动推送）
• 本版产物在发布后重新打包覆盖，版本号未变

已知限制

• 只支持 Windows；多显示器不支持跨屏框选
• 没有代码签名，首次运行 SmartScreen 会拦一下
• 录屏的摄像头设备不支持热切换，录制后不能剪辑
• 长截图依赖目标窗口响应合成滚轮事件（部分 Electron 应用和游戏不响应）