Repository navigation
Releases
测试版 (df8807bf9f96)
测试版 · df8807b
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
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等消歧后的词)在三张表里都写了上下文说明,
是 gettextmsgctxt的穷人版。 -
界面语言扩充到五种:在简体中文 / 英文之外新增繁体中文、日语、俄语。
四门非英语语言各住一个模块(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_Globalizationfeature: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")(gettextN_()同款,
运行期恒等,只作覆盖守门的识别标记); 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.rs1854 → root 866 +open/query/write/retention/groups/blobsplatform/tray.rs1777 → root 712 +tray/imp.rs(Win32 实现整体收进#[cfg(windows)])ui/imgedit.rs1574 → root 1246 +imgedit/{crop,adjust,stroke}gfx/chrome.rs1395 → root 1163 +chrome/{hit,corners}ui/icons.rs1369 → root 1096 +icons/{font,draw,md}- 另含早前的
paint(16 子模块)、app(5)、theme(5)、
config(11)、frame、window、app-cratelib
-
文档重整:三份审查清单合并为
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 零警告。