点读伙伴 Vibe 项目

项目简介 点读伙伴（DianduPartner）是作者用 Codex 一步步「搓」出来的小达人点读笔 Mac 助手，仓库 54philos/xiaodaren-mac，MIT 许可，用 Swift 与 SwiftUI / AppKit / Foundation / CryptoKit 编写，不依赖任何第三方运行时库。作者自述并非程序员，这是一款典型的 Vibe Coding 产物：为了给小达人点读笔在 Mac 上装点读包，摆脱「装一个 30GB 的 PD 虚拟机 + 官方 Windows 客户端」的折腾，他一边提需求一边连着实体笔测试，把整套安装与管理流程搬到了 macOS 上。

核心功能

• 安装 DAB 点读包：选择文件、核对书名贴号与内容类型，直接装进点读笔
• 独立安装 UNB 包：可从原始 DAB 生成设备绑定，不依赖笔里已有同一本书的旧文件
• 书目管理：查看书名、贴号、类型与大小，支持搜索，默认按贴号排序，也可点表头按大小排序
• 批量移除：⌘ 多选、⇧ 连选，一次移除多个点读包
• 安装完成后可在软件里「安全推出」点读笔再拔线开机；同时自动识别设备、刷新书目并收起安装参数

技术实现 整个应用是一个纯本地 macOS 客户端，不联网、不需要 Windows、PD、Python 或任何开发工具。安装流程分「快速安装」与「完整回读校验」两档：快速安装不完整回读音频数据，只保留写入完成、文件大小与绑定包头检查，排查问题时可从 File 菜单切到完整校验，校验失败会提示重装而不会自动重拷。UNB 包的设备绑定算法参考社区项目 kings0527/talking-pen-toolkit，许可声明保留在仓库的 THIRD_PARTY_LICENSE.txt。工程侧提供 build.sh、build.sh test、build.sh ui-test 三条构建与验证入口，产物在 dist/点读伙伴.app，发行包目前只提供 arm64 架构。作者记录 72 项本地核心检查通过，覆盖快速与完整安装、UNB 绑定、源包保留、占用保护、损坏检测、失败清理与批量移除。

快速上手

1. 电脑装好 macOS 14 或以上的 Apple Silicon 版本，从 Releases 下载 DianduPartner-0.5.1-macOS-arm64.zip 并解压后拖入「应用程序」
2. 点读笔关机，用支持数据传输的线连上 Mac，打开应用等待显示「点读笔已连接」
3. 选择自己的 DAB 文件，按资源提供方说明核对贴号、类型与参数，点「安装到点读笔」
4. 安装完成后点「安全推出」，拔线并开机，用手上的实体书测试点读
5. 想清理内容时在书目列表里 ⌘ 多选后批量移除；移除会直接删掉笔内文件且不创建备份，电脑上的源包不受影响

适用人群 家里有小达人点读笔、又在用 Mac 的家长与孩子，以及喜欢自己写小工具解决日常麻烦的开发者。当前是测试版，仅在小达人 908 上做过实机验证，其他型号与点读包尚未验证。

已知限制 应用目前使用 ad-hoc 临时签名，尚未提供 Apple Developer ID 签名与 Apple 公证；系统拦截时按苹果官方说明在「隐私与安全性」中处理即可，不需要关闭系统全局安全保护。遇到编号被占用会阻止覆盖，已安装内容的移除不可撤销。

官方链接 仓库与下载页 https://github.com/54philos/xiaodaren-mac ，使用说明与问题反馈见仓库内的 docs/使用说明.md 与 Issues。