Repository navigation
🫧 NotchPeninsula 2.2.3 → 2.2.5
这一页同时挂着 2.2.3 / 2.2.4 / 2.2.5 三个版本的安装包(2.2.4、2.2.5 没有单独开 Release)。下面按版本分节写更新日志,从新到旧,想看某个改动直接往下翻到对应版本。
先选安装包
| 文件 | 版本 | 平台 | 说明 |
|---|---|---|---|
NotchPeninsula.v.2.2.5.exe |
2.2.5 | Windows x64 | 推荐,已恢复液态玻璃抓屏与折射 |
NotchPeninsula.v2.2.4.exe |
2.2.4 | Windows x64 | 上一个正式版,留给需要回退对比的人 |
NotchPeninsula.v2.2.4.arm64-beta.exe |
2.2.4 | Windows on Arm | ARM64 试验包,需自备 ARM64 版 .NET 10 Desktop Runtime |
NotchPeninsula.v2.2.3.exe |
2.2.3 | Windows x64 | 首个 2.2.3 包 |
目标机需自备 .NET 10 Desktop Runtime。2.2.5 的液态玻璃支持 Windows 10 / 11;原生亚克力为 Windows 11 功能,Windows 10 使用兼容路径。
2.2.5
液态玻璃与亚克力
- 液态玻璃恢复旧版抓屏与主岛折射。 Windows 10 / 11 均可使用,优先走 DXGI 桌面采集,必要时用 GDI。模糊、折射和刷新周期可调,实况窗复用抓屏背板。
- 液态玻璃主题可选「黑 / 白 / 自动」。自动根据玻璃背景亮度切换文字颜色;手动选黑或白时固定配色。
- Windows 11 亚克力继续使用 Windows Composition 原生背板,主题可选「黑 / 白 / 系统」。设置窗口使用独立的原生背板,系统效果不可用时显示实色底。
- 修复重启后被强制切回亚克力的问题。普通安装包恢复上次保存的材质。前景帧率的「自动」档在空闲时为 30 FPS,交互或有动态内容时为 60 FPS。
NEW
插件详情页尺寸:可以不指定,也可以随时改
IDetailPage.MeasureWidth()/MeasureHeight()变成可选成员:不实现、或者返回0/ 负数 /NaN都表示「我不指定」,宿主用默认 350 × 130(和宿主自己的媒体展开面板同尺寸),不再当成非法值按最小尺寸兜底。- 宽高各自独立兜底:只报宽度、高度交给宿主也合法。
- 保护性裁剪保持不变:宽
180 ~ 1000、高48 ~ 480,超界按边界收,不抛异常也不记警告。 - 展开期间尺寸可以变(以前是一次展开就定死)。两条路按变化频率选:
ResizeWithContent => true让宿主每帧重测;偶尔变一次就改完调host.InvalidateDetailPageSize(),下一帧重测一次。两条都同时覆盖岛内详情页和实况窗浮动面板,插件不用判断自己开在哪。 - 尺寸变化走原有的 0.45s 弹簧过渡,变化小于 1px 直接忽略 —— 避免测量值在边界上抖,把弹簧一次次重启;命中矩形立刻作废、下一帧重算,点完按钮马上就能点到新位置的控件。
- 实况窗浮动面板同样接受「不指定尺寸」(以前
MeasureWidth返回 0 会直接拒绝展开)。 - 文档
NPS_PluginsAPI.md第 7 章重写:谁生效真值表、两条动态路径的可抄示例、老宿主的MissingMethodException兼容写法、换尺寸时的反向命中变换,另外补了 3 条常见坑。
UPDATE
实况窗分裂 / 合并重做为「液体吸附」
- 进出场合并成一条「液体转移」时间轴:吸附先慢后快(像被表面张力抽进去),脱离先快后慢并带一点过冲(水滴甩出去再回稳),时长收到 0.44 / 0.46s。
- 删掉旧的「母圆一起缩到 R/√2 再长回来」联动 —— 几个圆同时抽动正是之前「像吃了菌子」的主因。新气泡统一从岛体左缘挤出来,再滑到自己的槽位。
- 旧的「张着嘴 + 粗黑轮廓」膜动画换成两圆之间的水桥:切点接在岛体左端圆帽的表面上(原先接在内部,描边会从岛体里长出两根灰钩子),腰身压到 R 的 30%,接触角与腰身分开推 —— 前期细颈,后段猛地吞进去,最后掐断。
- 气泡用同一条水桥路径做差集裁切,是被「打口吃掉」而不是整体淡出;再叠一层沿运动方向的压扁拉伸,看起来是水在变形而不是圆在缩小。
- 腰线只描在水膜外侧,不再穿进气泡的透明内容区;面板展开时那根粗直线一并删掉。
插件市场
- 卡片上的「详情」不再弹本地弹窗,改为用浏览器打开官网对应插件详情页(
plugins.php?id=<插件 id>),11 个市场插件地址均已核验可访问。本地详情弹窗保留给「岛上推荐通知」入口。
FIX
- 修复点岛体偶尔没反应、指针在手形和箭头之间来回闪:根因是命中几何的竞态 —— 渲染线程在帧首把时钟 / 硬件 / 媒体 / 时间轴热区清成
-1再逐块填回,绘制期间落进来的点击和WM_MOUSEMOVE会读到「热区全不存在」。改成渲染线程写草稿、帧末整体发布,输入线程只读已发布快照;插件行热区同样改成两份槽位交换。绘制代码一行未改,视觉不变。 - 修复
IsTopOfZOrder用错 Z 序常量(把GW_HWNDNEXT当成GW_HWNDPREV),导致置顶保活每 2 秒就把岛体重新HWND_TOPMOST一次,白让 DWM 合成并抖动输入。
2.2.4
NEW
Windows 11 原生亚克力转正
- 不再需要额外参数:Windows 11 下**普通发布、Visual Studio 的 F5 调试、运行中选中「亚克力」**都直接走 Windows Composition
HostBackdropBrush原生背板。 --native-acrylic与-p:NativeAcrylicPreview=true降级为「启动时临时选中亚克力」的试验入口,效果与普通构建一致。- 刘海与灵动岛各按自己的轮廓裁切,顶角不再借用对方的圆角。
- 背板宿主或裁切初始化失败时只保留亚克力色调并记日志,不用 GDI / DXGI 抓屏兜底;Windows 10 的亚克力继续走旧兼容路径。
液态玻璃:2.2.4 的 Composition 合成方案
以下是 2.2.4 的历史行为。当前 2.2.5 附件已恢复抓屏和折射。
- 复用亚克力那套 Composition 宿主与轮廓裁切,删掉旧的 GDI / DXGI 抓屏、临时隐身窗口、位图合成与失效守卫 —— 液态玻璃不再有「抓屏刷新率」这个瓶颈。
- 背景模糊五档:关 / 轻 / 中 / 强 / 最强(高斯标准差
0 / 0.75 / 7 / 12 / 18DIP)。选「关」时背板覆盖归零、桌面直接透出;最低色调只留2/255,用于分层窗口的命中。 - 高光 / 厚度 / 色调各自五档独立可调,主岛、实况窗面板、气泡环共用同一套材质口径,刘海、灵动岛、实况窗都保留自己的裁切。
- 前景帧率新增「不限」:取消应用侧帧率上限,背板本身仍由 DWM 随桌面合成。Windows 10 没有原生模糊,显示半透明色调 + 边缘高光。
插件能拿到逐字歌词时间轴(PR #193)
MediaSnapshot新增LyricTimeline(EndMs/CumChars/TotalChars/ProgressAt(elapsedMs))与LyricLineElapsedMs。ProgressAt()与宿主岛上的扫光是同一套算法(逐字边界精确对齐 + 字内线性插值),插件按 60fps 本地外推即可,扫光与岛上完全同步,不用再靠 250ms 一次的LyricProgress猜速率。- 时间轴每行只构建一份、行变了才换引用,插件可以放心缓存;数组直接指向宿主的 yrc 表,只读共享不复制。
其它
- README 顶部加了每日更新的 Star 趋势图(Actions 每天北京时间 09:23 更新)。
UPDATE
- 液态玻璃默认档按参考效果定为:轻模糊 + 最高高光 + 偏低厚度 + 偏低色调 + 帧率不限;「恢复默认」按钮同一口径,已保存的值不动。
- 交互与合成:纯绘制的原生背板窗口禁用输入,动画中只在确需重排时才动 Z 序;静止悬停不再重复上传同一张前景;左右键首次按下即建立鼠标跟踪,不再依赖先收到一条移动消息。
FIX
- 修复 Windows 11 普通发布与 VS 调试下亚克力回落 GDI 抓屏的问题。
- 修复液态玻璃没有背景模糊、设置页也没有调节入口。
- 修复液态玻璃最低档仍留着一层背板雾感。
- 可交互主岛轮廓保留
12/255前景下限,避免极低色调在抗锯齿和淡出时被量化成零、被分层窗口判成鼠标穿透。
2.2.3
NEW
插件逐元素明暗自适应
- 新增
PluginTone公共 API:插件的文字、图标可以按自己下方那一块底色分别切黑 / 白,不再整块面板共用一个颜色。 - 自动用
canvas.TotalMatrix映射文字包围盒,兼容插件自己的Translate/Scale;没有亮度数据时保留调用方画笔颜色。 - 内置媒体详情页、Toast、实况窗面板同步接入同一套明暗判定,实体 / 亚克力 / 液态玻璃三种材质都生效。
- 新增
IPluginHost.CloseLiveWindowDetailPage(),插件可以主动收起实况窗浮动面板。
Windows 11 原生亚克力试验模式
- 新增基于 Windows Composition
HostBackdropBrush的原生亚克力背板,不再依赖抓屏取桌面。 - 刘海形态按贝塞尔凹角边界一起裁切,顶角不再沿用灵动岛的凸圆角。
- 当时需通过启动参数
--native-acrylic试用(2.2.4 起已转正,见上)。
通知字号四档可调
- 发送者、正文、应用名、时间来源四档字号全部开放为可写属性,写入后下一帧生效。
- 标题到正文的行距随字号增长,正文调大后不会贴住标题。
- 字号持久化在宿主侧,重启后自动恢复;不调用这些接口时,排版与改动前完全一致。
插件可以声明播放器 AppId
- 插件新增
AppIdKeywords,自己声明支持的播放器标识,宿主不再维护硬编码白名单。 - 内置的播放器推荐逻辑也改为读取插件声明,适配新播放器不用再等宿主更新。
显示内容支持拖动排序
- 「显示设置 → 显示内容」新增
≡把手,长按 180ms 进入拖动,按鼠标所在行实时重排。 - 原来的 ↑ / ↓ 按钮保留,拖动后的顺序照常落盘并同步到岛上。
插件市场最低 NPS 版本检查
- 市场接口新增
minNpsVersion:当前版本低于插件要求时,点「下载 / 更新 / 重装」会先弹出版本过低提醒。 - 提醒里直接写明插件要求的版本与当前版本,并提供可点击的 QQ 群号;可以取消,也可以继续安装。
- 「一键更新全部」会跳过这类插件,避免批量更新后换来一个必然的加载失败。
其它新增
- 关于页新增项目主页链接(
https://nps.georgewu.top),四个链接按内容区整体居中,悬停命中按实际字宽计算。 - 「刘海样式」卡片里的迷你岛预览跟随当前材质:选液态玻璃时按玻璃画,不再是一块纯黑剪影。
UPDATE
实况窗动画与媒体排队
- 实况窗进出场统一改为「宿主吞噬膜」:生成与退出是同一段几何 / 曲线的正反播放,气泡从岛体左缘被吐出、再被吞回,不再走细胞分裂。
- 媒体气泡与主岛动画排队:进的时候主岛先收短再注册气泡,退的时候气泡先吞回、主岛再展开,两段动画不再重叠。
- 等待主岛动画的定时器加入超时兜底,不会再因为一次状态异常无限阻塞。
- 新增
ILiveWindow.SpinWhenNoProgress:没有可用进度时,内圈可以选择继续旋转;内置媒体播放中用它代替「转圈扫描段」。 - 这一版的「吞噬膜」在 2.2.5 已换成液体吸附动画(见上)。
内置面板统一调色
- 媒体详情页的图标、频谱、进度条、按钮 / 悬停圆底全部接入逐元素明暗,玻璃下不再整块黑或整块白。
- Toast 的「拒收」胶囊底色也跟随下方材质;正文、卡拉 OK 未唱段在浅底上保持可读。
- 面板亮度改用面板局部坐标采样,玻璃合成只做临时结果,不污染主岛的缓存、亮度与缓动。
动画与性能
- 日志改为异步落盘,渲染线程不再被诊断日志的磁盘 IO 拖慢;WARN / ERROR 立即催刷,崩溃与退出显式
Flush。 - 帧节拍改用高精度可等待定时器,空闲时不再靠
Thread.Yield()忙等占满一个核;置顶检查先判 Z 序,空闲压缩 GC 增加 180MB 私有内存门槛。 - 玻璃合成缓存复用;岛体完全隐藏且滑出动画结束后跳过
UpdateLayeredWindow;动画帧不再做整画布像素比较;去掉重复清屏。 - 微信转发消息跳会话改用 Unicode 直接输入,不再占用剪贴板。
插件
- 实况窗插件级开关加入带动画的挂起 / 恢复,切换时气泡与详情面板的状态保持一致。
- 插件导入(按钮、拖入、市场清单)统一只接受
.dll/.zip,其他格式直接拒绝并提示,不会再尝试把任意文件复制进plugins\。
FIX
- 修复原生亚克力在刘海形态下裁切错位、切换材质时闪烁,以及 WinRT 接口注册失败后错误回退抓屏的问题。
- 修复插件更新后显示位置跑到列表末尾:更新时按插件 Id 记住旧位置,新版加载成功后原地归位。
- 修复实况窗插件级开关切换时面板动画不一致,以及卸载插件后开关记录残留。
- 修复动画帧对整张画布做像素比较带来的额外开销,动画期间直接提交。
插件市场
NPS v1.6.0 起开放对插件的支持,允许用户下载使用、自由开发、分发 dll 插件,获取插件请前往 NPS 官网,若要上传插件前往 插件分发入口,同时我们为各位准备了一份完整且易懂的插件开发文档 点我阅读 Wiki。
通过对插件的支持,将刘海 / 灵动岛推向一个自由度更高的高度,目前已经开放了大部分接口与能力,详情参考 Wiki。关于 NPS 的更多玩法和特性也可以查看 NPS 进阶玩法(Wiki)。
👉 如何下载与安装插件?
下载方式(二选一):
方式一(推荐):通过内置插件市场直接进行安装、更新和卸载等操作,无需再执行下方手动安装。
方式二:访问 官方插件市场 下载插件(.dll)文件,然后通过以下两种方式手动安装。
手动安装方式(二选一):
方式一(推荐):打开 NPS,插件中心 -> 导入 DLL 即可,插件默认会自动启用,否则手动启用插件;
方式二:放置到本软件 NotchPeninsula.exe 同目录下的 plugins 文件夹内(若没有此文件夹可以手动创建),重启软件后在插件中心里启用即可。
