本地应用 · NOTE4

NAS 相册

从 NAS 照片文件夹随机挑选人像,以十六灰阶铺满 NOTE4,并标注拍摄日期。

它能做什么

本地筛选人像,跳过截屏与纯风景
400×300 十六灰阶铺满显示与拍摄日期
自动轮播、设备按键翻页和暂停
预备小图、限额缓存与 NAS 离线回看

安装与使用

先构建本地程序,再接入插件

先用公开 SDK 构建电脑上的本地程序,再接入选好的插件。可以让本地 AI 完成构建与适配,最后确认设备上的实际效果。

公开源码

本地推送 SDK · macOS 15+ / Apple Silicon · NAS 共享

原相册的人像筛选依赖 macOS Vision,当前为 macOS 15+ / Apple Silicon。使用 SDK 不会自动消除该限制;其他系统需另做适配。

  1. 用 SDK 构建本地程序

    获取公开的本地推送 SDK,按电脑系统准备 Rust 与编译工具,先通过示例构建和本地测试,再实现设备连接与画面输出。当前 SDK 配套 NOTE4 固件 3.7.2。

  2. 接入 NAS 相册功能

    在 Mac 挂载 NAS 共享,复用照片筛选、裁剪、日期与缓存逻辑;把图片发送改为 SDK Gray16 接口,按键、轮播和应用数据由本地程序管理。

  3. 选择目录并验证一张照片

    在管理页填写已挂载的照片目录、缓存目录和轮播间隔。先检查人像裁剪、右下角 YYYY-MM-DD 日期、设备显示回执和上下键翻页,再启用自动轮播;缺少可靠拍摄日期的照片会跳过。

获取本地推送 SDK ↗

把任务交给电脑上的 Codex 或其他本地 AI。它会先准备 SDK 与本地程序,再检查插件接口并完成适配。

看看交给 AI 的内容
请使用本地推送 SDK,在我的电脑上构建本地程序,再接入「NAS 相册」的功能并验证。
项目仓库:https://github.com/itopinion/zectrix-nas-gallery
安装说明:https://github.com/itopinion/zectrix-nas-gallery/blob/main/README.md
本站核查日期:2026-10-20;参考提交:bc89e341e0c2e31bc6a884984aa72ce54c70bb23。执行前重新核对当前版本。
本地推送 SDK:https://github.com/itopinion/zectrix-local-push-sdk
SDK API 文档:https://github.com/itopinion/zectrix-local-push-sdk/blob/main/docs/API.md
SDK 兼容性清单:https://github.com/itopinion/zectrix-local-push-sdk/blob/main/compatibility.json
项目要求:本地推送 SDK · macOS 15+ / Apple Silicon · NAS 共享
接入方式:使用公开 SDK 构建本地程序,再接入应用逻辑、渲染与设备事件。执行时按当前源码核对接口和依赖。
先读当前 SDK README、API 文档和兼容性清单。当前 SDK 0.1.0 配套 NOTE4 固件 3.7.2,画布为 400×300;不适用于 NOTE4C。核对实际设备,不自动升级固件。
1. 识别我的操作系统和处理器,检查本机已有的 SDK 与本地程序,兼容时复用。缺少时克隆公开 SDK,按当前 README 准备 Rust、C/C++ 编译器与 CMake,用路径依赖构建适合本机的程序。
2. 先运行 cargo test --locked 与 cargo check --locked --examples。实现设备选择、单连接管理、PNG 渲染、事件处理、配置保存和退出清理;SDK 不提供现成的插件加载器。
3. 再读取插件源码,复用业务逻辑,并把原有渲染、设备事件和音频接口适配到本地程序。按插件需要实现调用接口或兼容层;不能只替换依赖名称就报告接入成功。
4. 按插件的实际需求,在本地程序中实现渲染、状态管理、按键和音频功能,并逐项测试。分别记录已完成的功能与实际遇到的问题,依据测试结果汇报可用范围。
5. NOTE4 与电脑需在可互通的局域网;按 SDK 指引启用待机保持 Wi-Fi。连接前确认目标设备与其他程序的占用情况,不抢占连接。本地设备连接不需要极趣云 API Key,数据源密钥按插件单独配置。
6. 提交原始 400×300 PNG,由 SDK 转为 mono、gray4 或 gray16,不重复抖色。交互时持续消费 next_event(),退出调用 close()。不要自动重连或抢占设备;ResultUnknown 不得当作失败重新刷图或播放。
7. SDK 不含语音识别、TTS 或大模型。需要语音时另配后端,播放为 16 kHz 单声道 PCM16,录音由设备按键触发。只有用户确认目标与预览后,才执行首次设备推送。

本项目的接入步骤:
1. 用 SDK 构建本地程序:获取公开的本地推送 SDK,按电脑系统准备 Rust 与编译工具,先通过示例构建和本地测试,再实现设备连接与画面输出。当前 SDK 配套 NOTE4 固件 3.7.2。
2. 接入 NAS 相册功能:在 Mac 挂载 NAS 共享,复用照片筛选、裁剪、日期与缓存逻辑;把图片发送改为 SDK Gray16 接口,按键、轮播和应用数据由本地程序管理。
3. 选择目录并验证一张照片:在管理页填写已挂载的照片目录、缓存目录和轮播间隔。先检查人像裁剪、右下角 YYYY-MM-DD 日期、设备显示回执和上下键翻页,再启用自动轮播;缺少可靠拍摄日期的照片会跳过。
首次验证:使用自己的已挂载照片目录,在 NOTE4 验证一张人像铺满画面和拍摄日期、上下键翻页与暂停;分别确认设备回执和实屏效果,并检查 NAS 原图未被改动。
分别汇报构建、预览、设备显示完成回执与实屏观察。交付启动、停止、卸载及更新方法,保留已有数据;交互应用需要电脑程序持续运行。
账号、密钥、设备地址和个人数据仅在本机配置,不写入共享任务或日志。若当前 AI 无本地执行环境,交付构建与接入方案,不声称已经安装。

装好以后,确认这一点

使用自己的已挂载照片目录,在 NOTE4 验证一张人像铺满画面和拍摄日期、上下键翻页与暂停;分别确认设备回执和实屏效果,并检查 NAS 原图未被改动。

安装后请确认设备上的实际效果。复制任务不会自动执行安装。

常见问题

下载插件后就能直接装到 SDK 上吗?

SDK 提供设备连接能力。先构建本地程序,再接入插件的业务逻辑、渲染、事件和音频接口;可以把本页任务交给本地 AI 完成。

照片会上传到云端吗?

原项目在 Mac 读取 NAS 原图并做人像检测;SDK 接入后通过局域网直推设备。保留原图不改动,仅在本机管理小图缓存,不需要上传照片到极趣云。

Windows、Linux 或群晖 DSM 可以直接运行吗?

当前人像筛选依赖 macOS Vision,发行与验证范围为 macOS 15+ Apple Silicon。NAS 负责提供共享目录,程序运行在 Mac;其他系统尚未适配。

为什么有些照片不显示?

应用需要相机来源、人脸和可靠拍摄日期。截屏、纯风景、元数据缺失、过小或低置信的人脸会被跳过;修改时间不当作拍摄日期。

NAS 断开后还能看吗?

可以复用原项目的缓存逻辑回看小图,新照片仍需访问 NAS。本地程序需要持续运行,断网或退出后的设备显示不能当作相册仍在运行。

项目与更新

公开仓库。 项目已于 2026-10-20 核对资料,支持范围以实际版本为准。

后续完善会持续更新到 GitHub 仓库。安装或升级前,请让 AI 阅读当前 README 与版本变更,保留已有设置和数据。

查看源码与说明 ↗
本地应用 · NOTE4开始使用 →

提交后,项目资料会发送至 support@zectrix.com,由我们审核后收录。联系邮箱仅用于投稿沟通。