浮匣 FloePod

本地优先的 Windows 屏幕边缘文件暂存工具。把文件、图片、文字拖到屏幕边缘的浮匣里集中保管，需要时再拖出去或批量导出。不联网、无遥测，所有数据只存在你自己的电脑上。

当前源码版本 1.8.2，提供 x64 Windows 便携包、NSIS、MSI 和 MSIX 构建路径。

功能

• 多匣体系：多个「匣」各自独立贴在屏幕的上/下/左/右边缘，可分别设置所在显示器、沿边缘位置、暂存文件夹、不透明度与材质（亚克力 / 纯半透明），随时启用或停用；浮动条图标可自定义（emoji），暂存数量徽标可显可隐
• 拖入即暂存：文件、文件夹、图片拖到匣上松手即入暂存；落地动作可选 复制 / 移动 / 创建快捷方式（可固定选择，也可用修饰键临时直达：Ctrl=复制、Shift=移动、Alt=快捷方式）
• 文字暂存：全局热键一键收集剪贴板文字，或面板手动输入（可填文件标题，默认取正文首行；自动存为 .txt）
• 暂存面板：悬停或单击浮匣弹出（不抢焦点，无系统阴影）；文件缩略图、多选（点选 / 框选）、列表与图标平铺两种视图、批量「复制到… / 移动到…」导出、拖出（复制 / 剪切）、移出暂存（移入系统回收站，可随时还原）；面板最小长度可调
• 单一活动面板：同一时刻只展开一个未固定的面板，切匣自动收起其他面板，避免多匣窗口重叠闪烁
• 文件夹对账：启动或更换暂存文件夹时，自动把文件夹里已有的文件读入列表；资源管理器里手动增删也会同步
• 主题跟随：浅色 / 深色 / 跟随系统；启动预置主题避免白色首帧闪烁，原生与 WebView 双通道同步
• 多窗口定向事件：每个匣的事件只发给自己的窗口，多匣并存互不串扰
• 系统集成：托盘菜单、全局快捷键（默认 Alt+Shift+F 显示/隐藏匣、Alt+Shift+S 收集剪贴板、Alt+Shift+P 打开面板）、开机自启（可选）
• 显式便携模式：便携包带 marker，数据写入 exe 旁 FloePodData/；安装版写入 %APPDATA%\FloePod，已有便携数据继续自动识别
• 操作时间线与一键恢复：持久记录暂存、导出、移出、隐私清理和交接操作；免费提供最近 24 小时的保守撤销，文件内容变化后拒绝误删，并可只重试失败项
• 关于页：占用空间统计、应用内检查更新（GitHub Releases）、数据位置查看 / 打开 / 迁移（重启生效）
• 辅助功能：50%～150% 界面缩放（滑块连续调节）、高对比度、减少透明/动画、44px 点击目标、危险操作预览；支持文件选择器、Ctrl+V、资源管理器右键菜单（每个匣一个「发送到」项）和 Alt+1…9，核心流程无需拖拽
• 规则匣：按扩展名、文件名、来源、大小和 SHA-256 重复内容过滤，支持日期重命名、年月子目录、校验文件、到期提醒和导出后移出
• 可信交接与安全导出：生成清单 CSV、机器可读 JSON、交接说明 HTML 和 SHA256SUMS.txt；本地提示并清理图片 EXIF/GPS、PDF 与 Office/OpenDocument 属性，原文件保持不变
• 敏感匣：使用 Windows EFS 加密目录、Windows Hello/PIN 解锁、自动/紧急锁定、缩略图与索引禁止、保留期限和导出后清理，不自制加密算法

技术栈

• 前端：Vue 3 + TypeScript + Vite + Pinia（设计令牌走纯 CSS 变量，无 UI 框架运行时）
• 后端：Rust + Tauri 2（多窗口、原生拖放、托盘、全局快捷键、系统主题）
• 存储：SQLite（rusqlite bundled，含 WAL）——暂存条目 + 匣配置 + 设置
• 拖出：tauri-plugin-drag（Windows OLE 拖放，剪切模式遵循移动契约回删源文件）
• 圆角：浮动面板为 CSS 圆角 + DWM 系统圆角对齐（材质随窗口轮廓裁圆），浮动条为 CSS 自绘；面板窗口 1.7.4 起不带系统框架，彻底摆脱 DWM 系统强调色边框线

开发

pnpm install          # 安装前端依赖
pnpm test             # 前端逻辑与 IPC 测试
pnpm tauri dev        # 开发运行（Rust + Vite 联动）
cargo test --manifest-path src-tauri/Cargo.toml --locked
pnpm build            # 前端类型检查 + 产物构建
pnpm tauri build      # 发布构建（NSIS 安装包 + 裸 exe）
pwsh -File scripts/package-msix.ps1 # 构建 MSIX（需要 Windows SDK）
pnpm tauri icon app-icon.png             # 由源图生成全套图标

结构

src/                    # Vue 前端（按窗口 label 分发视图，无需路由）
  domain/               # 共享类型以及选择、主题、窗口和拖放规则
  ipc/                  # Tauri 命令、事件与浏览器预览 mock
  windows/              # PodBar（胶囊条）/ PodPanel（面板）/ SettingsWindow（设置与 OOBE）
  components/           # 文件图形、缩略图、拖入询问、冲突解决与表单控件
  stores/               # Pinia：settings（设置 + 主题）/ staging（条目 + 选中态）
  lib/                  # 弹簧动画、缩略图队列与展示格式化
src-tauri/src/
  lib.rs                # 应用装配（插件/托盘/首启引导/启动恢复）
  manager.rs            # 窗口位置、面板显隐与单一活动面板管理
  commands.rs           # Tauri 命令入口
  pods.rs staging.rs    # 匣配置与暂存条目管理
  file_ops.rs export.rs # 文件操作、批量导出与错误处理
  drag_out.rs thumbnail.rs # OLE 拖出与缩略图读取
      db.rs settings.rs state.rs   # SQLite 持久化与运行态
      operations.rs rules.rs       # 操作时间线/撤销与规则匣
      handoff.rs privacy.rs        # 可信交接包与本地隐私清理
      security.rs shell_integration.rs # EFS 敏感匣与资源管理器入口
  clipboard.rs menu.rs   # 系统剪贴板写入、右键菜单窗口管理
  watcher.rs            # 暂存文件夹监听与按匣同步（notify）
  autostart.rs          # 开机自启（HKCU 注册表同步）
  events.rs logging.rs  # 事件名与定向发送、日志
  win.rs lnk.rs paths.rs       # Win32 辅助、.lnk 快捷方式、路径探测
  tray.rs hotkeys.rs          # 托盘与全局快捷键

便携版打包

pnpm tauri build
node scripts/package-portable.mjs
# -> dist/FloePod-<版本>-win-x64-portable.zip

版本

• 1.8.2（当前）：修复每周定时依赖审计连续失败——source-map-js 升到 1.2.2（修复事件循环拒绝服务）、vite 升到 7.3.7（修复 launch-editor 绕过）、fast-uri 升到 3.1.9；Rust 侧 zip 从 6.0 升到 9.1（修复解压路径穿越与符号链接权限提升，含 1 个 critical 漏洞）
• 1.8.1：彻底去除浮动面板窗口的 DWM 投影阴影；修复移出操作因单条路径解析失败被放大成整批失败的问题（错误信息也会原样透传）；右键菜单填充改为完全不透明（不再继承匣的亚克力材质）；新增「浮动面板最小长度」设置（160–900px）
• 1.8.0：修复切换视图后面板持续变短、从匣移出文件报错、切换主题后边缘胶囊的标题栏伪影；面板显隐动画回到前端淡入淡出（无阴影不变）；移出文件改为一键移入系统回收站；资源管理器右键菜单按匣名逐个显示「发送到」项；辅助功能界面大小改为 50%–150% 连续滑块；删除本地 OCR / 全文搜索 / 标签与机构策略 / 审计 / 诊断；高级设置中规则匣与敏感匣拆为两个独立功能区；关于页新增占用空间、检查更新与数据位置迁移
• 1.7.7：面板显隐动画改由 AnimateWindow 显式播放（标准窗口淡入/淡出，作用于整个窗口含亚克力材质），并遵循系统「动画效果」开关——1.7.6 依赖的 DWM 隐藏过渡对 SW_HIDE 实际不生效，面板上恢复禁用该属性
• 1.7.6：浮动面板显隐动画改为 Windows 原生 DWM 过渡（重新启用 1.4.0 起禁用的窗口过渡，无框架架构下幽灵标题栏残影源头已不存在），删除与亚克力材质不同步的 CSS 淡入淡出——关闭面板不再出现「内容渐隐后材质矩形残留原位再硬切消失」，进出场由系统统一播放且对称；面板关闭从延迟 220ms 改为即时响应
• 1.7.5：浮动面板去除自绘外阴影，原生窗口回到面板本体尺寸（不再外扩光晕边距）——亚克力材质随窗口轮廓与 DWM 系统圆角直接贴合面板形状，边缘干净无模糊晕圈；层级感由材质与 1px 玻璃描边承担，拖放命中范围收回面板本体
• 1.7.4：重写浮动面板窗口架构，根治 Windows 开启「在标题栏和窗口边框上显示强调色」时聚焦后顶部出现的蓝色边框线——面板窗口退出 DWM 框架体系（无边框消息防护 + 客户区铺满 + 样式位清理），系统强调色边框无处可画；系统阴影与圆角改由 CSS 自绘（窗口四周外扩光晕边距）；亚克力/普通材质切换路径同步简化
• 1.7.3：剪切拖回自身新增与落点记录独立的终保底（源文件仍在暂存目录内时无条件保留，根治 1.7.2 残余丢失）；面板顶部恢复改为无条件执行并写入日志（修复 1.7.2 防护被瞬时窗口矩形误拦导致的时隐时现）；复制拖回自身改为创建后缀副本而非忽略
• 1.7.2：修复剪切模式把文件拖回自身仍可能删除文件的问题（落点记录与源路径统一「原始 + 规范化」双键匹配，清理判定写入日志）；修复浮动面板顶部的空缺边框线（窗口层恢复被 tao 顶部内缩占用的客户区，WebView 铺满窗口）
• 1.7.1：规则匣与敏感匣设置重组为单匣卡片双分组，匣切换按钮常显、开关控件统一、文案精简；修复浮动面板顶部在 Windows 11 上出现的白色/无色细线（tao 客户区顶部内缩留下的非客户区被 DWM 默认 caption 色填充，现在请求不绘制 caption）；修复匣的浮动条 emoji 图标与暂存数量开关保存失败（字段未接入后端补丁白名单）
• 1.7.0：新增匣级浮动条 emoji 图标与暂存数量徽标显隐设置；浮动面板新增多选模式（点选 / 框选）与图标平铺视图，视图一键切换；右键菜单收起时淡出；移除面板头部的选择文件 / 文件夹入口（拖入与 Alt+数字 投递不受影响），暂存文字正文随面板高度伸展；修复剪切模式下把文件拖回同一个匣导致文件被错误删除的严重问题（自拖完全屏蔽，跨匣移动不受影响）
• 1.6.1：保持兼容的设置、面板、Windows 窗口与文件事务重构；补强隐私检查资源限制、后台任务退出与版本发布门禁。
• 1.6.0：修复浮动面板四周多出的白色边框（停止对面板清除框架样式位，保留 tao 的系统阴影架构，仅压制 Win11 1px 外描边与焦点过渡）；修复边缘浮动条偶发白色方角标题栏（消除显示 / 焦点 / 拖动路径上对 WebView2 合成的反复打断，显示后强制重新呈现）
• 1.5.0：辅助功能各选项独立生效（移除总开关模式）；高级设置中规则匣与敏感匣拆分独立卡片；浮动条新增「长度」与「填充色」设置并统一命名；浮动面板宽度范围调整为 410–600px；修复边缘浮动条偶发矩形标题栏与材质切换后不立即刷新；优化多选勾选按钮与右键菜单交互
• 1.4.0：隐匿模式（边缘浮动条延迟淡化隐去、鼠标靠近淡入）；新增「高级设置」页收纳自动屏蔽与规则匣、敏感匣；移除云母材质，亚克力改走随窗口常驻的 ACCENT 通道并在应用后立即刷新；「胶囊条 / 面板 / 安心模式」更名为「边缘浮动条 / 浮动面板 / 辅助功能」；统一设置界面卡片风格；移除浮动面板底部白色分割线
• 1.3.0：自动屏蔽（指定应用前台时隐藏全部匣、离开自动恢复）；匣自动收起开关与延迟；面板独立材质与不透明度；材质扩展为亚克力 / 云母 / 模糊 / 普通；位置示意图放大并支持拖动小蓝点定位；修复右键菜单无法再次打开与阴影显示错误
• 1.2.0：匣宽度 / 圆角 / 边框颜色与不透明度可调；点击匣切换面板显隐并以固定方式弹出；多匣设置改为列表选匣编辑；新建匣弹窗询问名称与文件夹；修复显示器下拉重复「主显示器」
• 1.1.0：禁用 WebView 原生右键菜单，新增专属设计的右键菜单（打开、打开所在位置、复制到系统剪贴板、复制路径、移出暂存）；文字条目可复制文本内容
• 1.0.0：更新 FloePod 品牌图形，统一应用、安装包和便携包的版本信息
• 0.6.0：强化文件复制 / 移动 / 导出回滚与剪切拖出身份检查；修复面板状态竞态、首启幂等、多显示器缩放和安装版 / 便携版路径隔离；增加自动审计、Windows 构建与 Release 流水线
• 0.5.1：多匣事件定向化消除串扰；文字暂存支持文件标题；文件名截断放宽至 48 字符；启动预置主题防白闪 + 原生主题同步；面板 Windows 11 系统圆角
• 0.5.0：单一活动面板，看门狗改为直接隐藏避免重叠闪烁；暂存文件夹启动/变更对账；面板尺寸防抖；材质只应用一次减少重绘闪烁
• 0.4.0：引入多匣体系取代「场景」，每个匣独立配置位置、显示器与暂存文件夹

说明

• 需要 WebView2 运行时（Windows 10/11 一般自带）
• PR 阶段完成质量门禁，合并后自动构建与发布，流程及 required checks 配置见 自动发布说明
• 兼容性边界和本轮验证见 工程说明；真实桌面环境检查见 Windows 检查单，不作为自动 Release 的人工等待步骤
• 无障碍范围见 辅助功能说明，本地数据边界见 隐私说明
• 机构离线部署、MSI/MSIX、签名和策略见 部署指南
• 功能覆盖与需要外部主体完成的边界见 安心工作台能力对照
• 图标为正式 FP Logo（docs/fp-logo.png 横向字标 / app-icon.png 应用图标）；如需重新生成图标执行 pnpm tauri icon app-icon.png && pnpm tauri build 即可