Skip to content

Releases

测试版 (df8807bf9f96)

Pre-release

Choose a tag to compare

@github-actions github-actions released this 17 Nov 10:01

测试版 · df8807b

  • 构建时间:2026-11-17 10:01 (UTC+8)
  • 触发:push / run 38
  • 提交:df8807bf9f96 (df8807b)
  • 自动发布,滚动 tag:test-latest

BUILD_INFO.txt

name        modular-clipboard
version     1.0.0
commit      df8807bf9f96
built_at    2026-11-17T10:01:34Z (UTC)
profile     release
target      x86_64-pc-windows-msvc
rustc       rustc 1.100.0 (0ef1bc386 2026-11-09)
cargo       cargo 1.100.0 (3acc79c0c 2026-11-05)
size_bytes  9990144

SHA256SUMS.txt

662c00dc1e114d3ad6842132c5a87f75aa2f48eea645e67de88ca115e4b56671 *modular-clipboard.exe

ModularClipboard 1.0.0

Choose a tag to compare

@MCheng404 MCheng404 released this 24 Oct 06:12

ModularClipboard 1.0.0

第一个稳定版。

常驻后台的剪贴板管理器:无边框磨砂主窗口、类型过滤、搜索面板、
图片缩略图与内嵌编辑、五种界面语言、MCP 接入、全局热键。

安装

下载 modular-clipboard.exe 直接运行,无需安装。首次运行会在
%APPDATA%/modular-clipboard/ 下建数据目录。

校验

sha256sum -c SHA256SUMS.txt

本版内容

主题:大文件拆分、多 Agent 审查与安全加固、多语言与界面打磨。

新增

  • 卡片磨砂(设置 → 外观 → 卡片磨砂,0 ~ 10,默认 0 = 关):
    给每一张行卡片单独铺一层模糊的身后桌面,让卡片成为一块毛玻璃。

    与「磨砂强度」不是一回事:后者模糊的是窗口背景层,这一项模糊的是
    卡片自己身后那一块。它同时解决了「卡片调透后整体变暗」——玻璃的
    关键不是能透多少,而是透过来的是什么:此前卡片透明只能透出窗口
    自己的 list_bg(比卡片更暗),所以越调越暗。

    实现走 CPU 侧:按 1/N 分辨率抓屏(N 由档位定),GDI 的 HALFTONE
    缩放本身是盒式平均 ⇒ 降采样即模糊,不必再跑一遍卷积,GPU 侧零新增
    资源。捕获 30fps 节流,纹理只在尺寸变化时才新建。

  • CLDR 复数选形:新增 i18n::tp(n, en_one, other),按 CLDR 复数规则
    为计数短语选形态——英文 one/other、俄语 one/few/many、中日文不分。
    覆盖相对时间(1 hour ago 不再显成 1 hours ago)、多文件预览
    (俄语 2–4 个要 файла 不是 файлов)、类型栏计数、设置项单位后缀。
    各语言表新增 PLURALS 复数子表(键是英文复数形,值是四形态数组)。

  • 源码 ↔ 译文表覆盖守门:cargo test 现在扫描全部源码里标记过的文案
    (t("…") / msg("…")),断言「四张表都有译文」与「表里无孤儿条目」。
    一次性核验脚本的职责就此固化——加文案或改英文措辞漏同步会当场红,
    而不是等有人切到日语才发现那一段是英文。

  • 译者上下文注释:21 个易混条目(Above/Top edge、Stroke color、
    Pinned card/Lock 等消歧后的词)在三张表里都写了上下文说明,
    是 gettext msgctxt 的穷人版。

  • 界面语言扩充到五种:在简体中文 / 英文之外新增繁体中文、日语、俄语。
    四门非英语语言各住一个模块(core/src/i18n/{zh_hans,zh_hant,ja,ru}.rs),
    一语言一文件、自己持有表与不变量测试;英文是键也是主语言。
    覆盖约 400 条文案(含设置界面的标签/说明、分段控件选项、图标提示、
    MCP 能力名),每张表各约 396 条有效条目、零死条目。
    语言选项改用下拉框 + 语言自称(日本語 / Русский / 繁體中文),
    避免「用 A 语言写 B 语言名字」的循环;6 个选项挤分段控件会把说明列
    压成窄条,这是换控件的原因。
    系统语言识别补上子语言判别(SUBLANG_CHINESE_TRADITIONAL/SIMPLIFIED/ HONGKONG/SINGAPORE/MACAU → 简/繁),LANG_JAPANESE / LANG_RUSSIAN。

  • 字体字重:加载 CJK 字体的独立粗体伴随字体(msyhbd.ttc 等),
    注册为独立族 cjk_bold,新增 theme::emphasis(size) 助手。设置窗导航
    的选中项改用粗体。没有粗体文件的机器(等线 / 宋体 / 自定义字体)
    自动回落常规字重——不伪造加粗,也不会因为构造了未注册的族而 panic。

修复

  • GPU 侧高斯换成 Dual Filtering:原来半径直接等于 tap 数(半径 12
    就是 25 次采样 × 2 趟),要做大模糊只能加 tap。现在模糊半径由降采样
    链的深度
    给出:每深一级半径翻倍、像素数降到 1/4——半径更大而开销更小。
    升采样端用 3x3 tent(恒 9 次采样),收尾的高斯只留 5 tap 抹掉方块感。
    档位 7(历史默认)落在 2 级,等效半径与升级前一致。

  • 描述符池少了 max_sets 与 FREE_DESCRIPTOR_SET:上一个改动要给
    链各级分配集合,只放大了 descriptor_count 不够——max_sets 才是集合
    条数的硬上限(实测分配第 7 个就 ERROR_OUT_OF_POOL_MEMORY);归还集合
    还需要 FREE_DESCRIPTOR_SET 标志。

  • 卡片磨砂与背景磨砂各抓一次屏:GDI BitBlt 是这条管线里最贵的
    一步(同步阻塞、毫秒级),两个功能同时开就付两倍。现在背景磨砂抓到
    像素后顺手给卡片做一次 CPU 降采样,卡片不再自己抓屏——每秒少一次
    全屏 BitBlt。附带好处:原先两次抓屏相差一个节流周期,窗口移动时
    卡片里的画面与背景里的会错位;共享后两者是同一时刻的内容。

  • 卡片磨砂的模糊只有一次 HALFTONE 平均:降采样按块取均值,放大回
    卡片尺寸会看见方块边界,边界还随窗口位置抖动。改成降采样之后再叠
    1~3 趟分离式 3×3 盒式模糊(盒式迭代定理:3 趟已很接近高斯)。输入是
    降采样后的小图(~110×130),成本几十微秒。

  • 「卡片透明度」把通知气泡与设置窗面板一起弄透:该设置改的是
    surface_raised,而那个令牌是浮层令牌(通知气泡、设置窗口面板、
    类型徽标都在用)。于是把列表卡片调透会连坐那些浮层——它们身后
    没有磨砂底图可透,透出来的只有窗口底色,观感是「整片界面一起变暗」。
    新增行卡片专用令牌 card_bg,surface_raised 回归浮层专用。

  • 主窗口最小化 / 隐藏到托盘期间复制内容后,打开主窗口文字渲染异常:
    跳帧渲染时把 egui 的纹理增量丢了。

    egui::FullOutput::textures_delta 是一次性的:egui 交出这一帧的
    纹理变化(新建 / 局部补丁 / 释放)就认为已被消费,下一帧不会重发
    ——egui 甚至在 TexturesDelta::drop 里 debug_assert! 了这点。
    而「窗口隐藏」与「客户区 0×0(最小化)」两条分支为了绕开那个断言,
    用 DeltaGuard 把增量 clear() 了事:断言不响了,数据也没了。

    后果落在字体图集上:图集按需栅格化,一条新内容里的新字符首次
    被排版时才画进图集,那一帧的增量是它的唯一上传机会。刚好那时
    跳过渲染 ⇒ GPU 上的字体纹理永远缺那一块 ⇒ 恢复显示后文字错乱/缺失,
    而数据层完全正常(复制粘贴照旧),极难联想到渲染层。

    完整故障链(实测):主窗口隐藏 → 后台复制内容 → svc.pump() 返回
    true ⇒ request_repaint_after ⇒ 渲染闸门放行 ⇒ run_ui 排版新预览
    文字 ⇒ 新字形入图集 ⇒ 增量产生 → 但窗口不可见 ⇒ 增量被清空。

    改法:跳过渲染的帧把增量攒进 pending_delta,下一次真正渲染时
    前插到本帧增量之前一起上传(顺序不能颠倒——图集增量多为局部
    补丁,顺序错了会把新字形画到旧位置)。acquire 过期重建交换链的
    那条分支同样处理。

  • 托盘右键菜单永远显示英文:i18n::set_locale 是进程级全局量,
    而本项目有两个进程。此前只在界面进程设置(首帧之前 + 设置里改语言时),
    常驻进程一次都没设——托盘菜单、热键注册失败提示都在那边用 t()
    取文案,于是无论用户选什么语言都显示主语言。
    现在常驻进程在启动时按 ui.language 解析一次,Command::SaveConfig
    时再同步一次(菜单每次右键重新拼文案,所以下一次右键即生效)。
    顺带把这段「resolve + set_locale」收成 app::apply_language——界面侧
    本来抄了两份,常驻侧漏了一份,正是重复代码漂移的典型。

  • 托盘悬停提示硬编码中文("ModularClipboard 剪贴板"):与界面进程的
    "ModularClipboard" 不一致,且在日/俄界面下仍是中文。tooltip 只在托盘
    创建时写进 NOTIFYICONDATAW 一次,本地化它就会变成「切了语言、tooltip
    还是旧语言」的半生效状态,故统一为语言中立的品牌名。

  • platform 缺 Win32_Globalization feature:system_langid() 挪到
    platform 后,靠工作区的 feature 统一才编得过;单独
    cargo test -p modular-clipboard-app 会报「找不到 Globalization」。

  • 1 hours ago / 1 days ago / 1 entries 等英文单数错形:计数短语
    此前不管 n 是几都套同一串,现在按 n 选形。

  • 15 条漏译:Colors / Temperature / Pin window / Pinned card /
    All history cleared / MCP 配对说明等此前不在任何译文表里,英文键一改
    就没人译。守门测试把它们全找了出来。

  • 设置界面「重置」按钮没有按钮背景:该按钮用了 .frame(false),
    观感是一段说明文字而不是可点的控件。改为与「检查更新」按钮同一画法
    (surface_variant 填充 + 圆角),文字色从 text_dim 提到 text。

  • 语言下拉框选了不生效,永远是「跟随系统」:ComboBox::show_ui 返回的
    .response 是按钮的 response,在菜单里点选不会把它标记为 changed
    ⇒ Op::SetLanguage 永远不推送。改为收选项自己的 changed()。
    界面上看不出异常(下拉框确实划过、确实高亮了),只是没落地。

  • 英文/日/俄界面下热键注册失败提示仍是中文:failed_message 的格式串
    是硬编码中文。改为走 t(),占位符改成命名形式({a}/{b})。

  • 英文/日/俄界面下「N 天前」仍是中文:format_time 的天分支硬编码
    " 天前" 不走 t()。同上改走 t(),并补 days ago 译文。

  • max_items 溢出导致删光历史:配置值 ≥ 2^63 时 as i64 回绕成负数,
    「保留数」被 .max(0) 兜成 0,下一次复制即删光全部未置顶条目。

  • 去重命中不补载荷:原条目若插入时因当时上限太小而 blob_file = NULL,
    会永远停在「看得见、复制必败」——用户调大上限后再次复制同样内容也修不好,
    因为去重挡住了新插入。新增 Store::backfill_payload 在去重命中时补回。

  • insert 失败回滚摧毁他人载荷:原先无条件删 {hash}.bin,而该文件
    与同哈希条目共享。改为按引用计数删。

  • like_search 排序不确定:ORDER BY 缺 id DESC 并列兜底,
    同一毫秒插入的多条两次查询可能给不同顺序。

  • wait_own_inflight 不复位 fence:abandon_frame 走过后,槽位轮回转回时
    acquire 的 reset 被 in_flight 门控跳过 ⇒ 每帧提交已 signal 未 reset 的
    fence(VUID-vkQueueSubmit-fence-00063),直到交换链重建才自愈。

  • 设置窗/卡片子窗没有重绘闸门:空闲时仍 ~125Hz 全量 acquire+paint+present。

  • 卡片子窗 textures_delta 漏清:只在成功路径 clear(),paint 出错路径
    直接返回,release 下不 panic 而是字体图集增量被静默丢弃、缺字形且不自愈。

  • 删除 7 处零引用死代码:Store::rename_group、Store::stats、
    ActionPlan::payload_text、builtin_rule_templates、AppState::visible_count、
    Service::request_show_window、anim::tween_rect。

变更

  • 简体中文也进 src/i18n/:调用点只留英文键。
    此前中文是内联在调用点的双语对 t(("中文", "English")),其余四门语言
    却在表里——改一句中文措辞要去十几个 crate 里 grep,加一门语言又是另一种
    形态。现在统一成「英文键 + 四张表」:

    • 调用点 t("Reset"),静态表与 match 臂 msg("Reset")(gettext N_() 同款,
      运行期恒等,只作覆盖守门的识别标记);
    • Msg = &'static str,Bi(双语对)类型整体移除;
    • 设置项搜索同时匹配英文键与当前语言译文,两种输入都搜得到。
      代价是调用点不再一眼看见中文;换来的是译文只在一处可改、五门语言形态一致。
  • i18n 以英文为主语言,译文表按语言拆成独立模块。

    • 英文是查找键与所有回落目标(Locale::pick 的 unwrap_or(en));
      中文降为「跟随系统且系统是中文」时的一种本地化。改前中文是键,带来
      两个问题:开发者对着满表中文字面量无从下手;中文同形不同义
      (「置顶」既是卡片种类也是行操作按钮),三处共用一个键,译文只能三选一。
    • 译文表从单个 catalog.rs 拆为 i18n/zh_hant.rs / i18n/ja.rs /
      i18n/ru.rs,一语言一文件、自己持有表与不变量测试。加一门语言 =
      加一个文件 + 一个 Locale 变体 + 一行 mod + 一个 overlay 臂。
    • 为使英文可作键,先消歧了 12 个撞键的英文串(Top 一词对应四个中文)
      与修掉一处英文不一致(Icon::Lock = "Locked" 而 Icon::Unlock = "Pin")。
      现在 settings_rows 的分段选项直接复用 core::config::panels 的
      label(),不再写第二份字面量。
    • 删除「译文 == 英文」的无操作条目(单位类 ms / MB),回落英文
      结果完全一致。
    • 新增守门测试:Locale 全变体 parse_lang 往返、下拉框覆盖全部
      Locale、非中英语言绝不显示源码那一半中文、键必须是英文、各表
      无重复键/空译文/占位符错位。
  • 语言菜单过滤已选中项:当前语言再列一遍没有意义,只多占一行、
    也让「点它是没反应」成为可能的误操作。

  • 语言菜单一体化(无分界线):下拉项用的 Button::selectable 默认
    .frame(true),每项各画一圈描边就成了「一格一格」。用
    egui::containers::menu::menu_style 清掉各态描边与 inactive 填充,
    再把条目间距与圆角归零,整列读作一块连续面板。

移除

  • 磨砂光标光晕:光标靠近主窗口时在指针位置渲染的光晕(开关 + 半径 +
    浓度三个设置项)整体移除。该效果为装饰性且常驻持续重绘成本,权衡后
    决定不做。配置字段 ui.glow 随之删除;旧 config.json 里的该字段
    被 serde 忽略(不报错、不影响其余设置)。

重构

  • 七个巨型文件拆分为模块家族(「删一个功能 = 删一个文件 + 一行 mod」):

    • store/lib.rs 1854 → root 866 + open/query/write/retention/groups/blobs
    • platform/tray.rs 1777 → root 712 + tray/imp.rs(Win32 实现整体收进 #[cfg(windows)])
    • ui/imgedit.rs 1574 → root 1246 + imgedit/{crop,adjust,stroke}
    • gfx/chrome.rs 1395 → root 1163 + chrome/{hit,corners}
    • ui/icons.rs 1369 → root 1096 + icons/{font,draw,md}
    • 另含早前的 paint(16 子模块)、app(5)、theme(5)、
      config(11)、frame、window、app-crate lib
  • 文档重整:三份审查清单合并为 docs/reviews.md;四份历史类文档
    (并行开发黑板 / UI 重构设计稿 / 项目报告 / 旧 README)合并为
    docs/history.md;根级 md 收敛为 README / ARCHITECTURE / BUILD / CHANGELOG。

  • 仓库瘦身:设计原型(settings-proto / shadow-preview / main-proto)、
    实机探针与诊断脚本清除;main 只保留构建环境、文档、源代码、协议四类,
    完整历史移至 old 分支。

安全

  • MCP HTTP 空 token 不再等于「无需认证」:该服务能合成键鼠、截屏、
    读写剪贴板,此前 token 为空时鉴权分支被整段跳过,恶意网页一个
    text/plain 简单请求(免 CORS 预检)即可驱动。现改为空 token 仅许
    loopback 对端;绑非 loopback 且无 token 直接拒绝启动;Host 头白名单
    (127.0.0.1 / localhost / ::1)防 DNS rebinding。

  • MCP HTTP 传输层加上限:Content-Length 此前完全由请求方决定,
    一个头即可 OOM。现加请求体上限 8MB、请求行/头行 8KB、头行数 64、
    读超时 30s。

  • 托盘窗口不再处理 WM_COMMAND:两条菜单路径都用 TPM_RETURNCMD
    直接取返回值,该分支对合法流量是死代码,却让同完整性进程可
    PostMessageW 伪造退出 / 清空历史 / 弹窗口。

测试

  • 新增守门测试:MCP 的 Host 白名单与行长度封顶(5 项)、
    max_items 溢出不误删(1 项)、backfill_payload 补回与幂等(2 项)、
    窗口模块导入的 32 个 VK 必须全部有映射(1 项)。

  • 基线:969 项通过 / 23 个测试二进制 / clippy 零警告。