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

它能做什么
安装与使用
先构建本地程序,再接入插件
先用公开 SDK 构建电脑上的本地程序,再接入选好的插件。可以让本地 AI 完成构建与适配,最后确认设备上的实际效果。
本地推送 SDK · macOS 15+ / Apple Silicon · NAS 共享
原相册的人像筛选依赖 macOS Vision,当前为 macOS 15+ / Apple Silicon。使用 SDK 不会自动消除该限制;其他系统需另做适配。
用 SDK 构建本地程序
获取公开的本地推送 SDK,按电脑系统准备 Rust 与编译工具,先通过示例构建和本地测试,再实现设备连接与画面输出。当前 SDK 配套 NOTE4 固件 3.7.2。
接入 NAS 相册功能
在 Mac 挂载 NAS 共享,复用照片筛选、裁剪、日期与缓存逻辑;把图片发送改为 SDK Gray16 接口,按键、轮播和应用数据由本地程序管理。
选择目录并验证一张照片
在管理页填写已挂载的照片目录、缓存目录和轮播间隔。先检查人像裁剪、右下角 YYYY-MM-DD 日期、设备显示回执和上下键翻页,再启用自动轮播;缺少可靠拍摄日期的照片会跳过。
把任务交给电脑上的 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。本地程序需要持续运行,断网或退出后的设备显示不能当作相册仍在运行。

