本地应用 · NOTE4
奇门遁甲排盘
在 NAS / Docker 上为 NOTE4 生成 400×300 九宫盘，支持按时间排盘、抽六十甲子、切换时辰与保存盘面。可配置 MiniMax 语音识别、解读和朗读；语音链路仍有作者记录的实机未通过项。
它能做什么
九宫盘与干支信息，默认十六灰文字渲染
短按抽盘，上下键切换时辰；盘面快照与问答保存在主机
可选 MiniMax 识别、解读与朗读，语音实机验证尚未完成
安装与使用
按项目说明安装本地应用
先生成本机预览，再配置 NAS 容器和自己的设备地址。单纯排盘不需要 API Key，语音与 AI 功能需自行开通对应接口。
公开源码
NOTE4 黑白屏 · SDK 配套固件 3.7.2 · Linux NAS / Docker Compose · 同一局域网 · 可选 MiniMax API Key
作者文档仅针对 NOTE4，不适用于 NOTE4C。容器使用 host 网络，Node 负责排盘与服务逻辑，Rust 桥接调用随附 SDK。默认十六灰，主机需持续运行；连接前退出其他占用设备的程序。
预览与环境核对
NAS 需支持 Linux Docker Compose 与 host 网络；镜像使用 Node 24 和 Rust。源码开发先执行 npm ci 与 npm run preview，并配置 Noto Sans CJK 字体。当前 npm test 为 21 项中 20 项通过，1 项历史页码显示断言失败。
填写自己的设备与接口配置
首次复制 .env.example 为 .env，将 NOTE4_TARGET 改为自己的局域网 IP，不沿用作者示例地址。排盘可不填密钥；需要语音时在本机填写自己的 MiniMax Key 并核对 ASR、文本和 TTS 权限。保留原有 .env 与 data。
启动并验证
退出其他设备客户端后运行 docker compose up -d --build，并查看日志、显示回执和按键。停止用 docker compose stop，恢复用 docker compose up -d。当前作者记录仍有连续播放失败与长按录音未验收项，请先验证基本排盘，不将启动成功当成语音全部可用。
把任务交给电脑上的 Codex 或其他本地 AI，按项目当前 README 完成安装与验证。
看看交给 AI 的内容
https://github.com/yingling686/qimen-note4 https://github.com/yingling686/qimen-note4/blob/main/README.md NOTE4 黑白屏 · SDK 配套固件 3.7.2 · Linux NAS / Docker Compose · 同一局域网 · 可选 MiniMax API Key 作者文档仅针对 NOTE4，不适用于 NOTE4C。容器使用 host 网络，Node 负责排盘与服务逻辑，Rust 桥接调用随附 SDK。默认十六灰，主机需持续运行；连接前退出其他占用设备的程序。 NAS 需支持 Linux Docker Compose 与 host 网络；镜像使用 Node 24 和 Rust。源码开发先执行 npm ci 与 npm run preview，并配置 Noto Sans CJK 字体。当前 npm test 为 21 项中 20 项通过，1 项历史页码显示断言失败。 首次复制 .env.example 为 .env，将 NOTE4_TARGET 改为自己的局域网 IP，不沿用作者示例地址。排盘可不填密钥；需要语音时在本机填写自己的 MiniMax Key 并核对 ASR、文本和 TTS 权限。保留原有 .env 与 data。 退出其他设备客户端后运行 docker compose up -d --build，并查看日志、显示回执和按键。停止用 docker compose stop，恢复用 docker compose up -d。当前作者记录仍有连续播放失败与长按录音未验收项，请先验证基本排盘，不将启动成功当成语音全部可用。 核对显示完成回执、时辰切换、抽盘与数据保存；语音需单独验证录音、识别、解读和实际出声。当前不能声称测试全部通过或已实机验收。
装好以后，确认这一点
核对显示完成回执、时辰切换、抽盘与数据保存；语音需单独验证录音、识别、解读和实际出声。当前不能声称测试全部通过或已实机验收。
排盘预览已验证 · 语音功能待实机验证。复制任务不会自动执行安装。
常见问题
语音数据会去哪里？
启用语音时，录音在内存中封装并发送至 MiniMax 识别，问题与盘面用于 AI 解读；原始录音不落盘，盘面、问答与解读保存在主机 SQLite 和导出文件中。
本站做了哪些验证？
已运行 Node 测试并生成真实 400×300 盘面预览：20 项通过，1 项因预期历史页码未渲染而失败。未部署 NAS、编译 Rust 桥接或连接 NOTE4；作者的 VERIFICATION.md 也列有语音未通过项。仓库未发现项目根目录许可证，随附 SDK 的 MIT 许可不等于整个项目的许可。
