Skip to content

NotchPeninsula 2.2.3

Latest

Choose a tag to compare

@ZZJ-jack ZZJ-jack released this 14 Nov 15:30
· 49 commits to main since this release
25519ba

🫧 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 / 18 DIP)。选「关」时背板覆盖归零、桌面直接透出;最低色调只留 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 文件夹内(若没有此文件夹可以手动创建),重启软件后在插件中心里启用即可。

image