自托管的蜂窝电话与短信服务：在 Unraid 上连接 DJI 第一代 QDC507 4G 模块，使用网页完成基础验证，使用原生 iOS 随行号作为日常客户端。用户自行部署服务，在 App 中填写 HTTPS 根地址和该服务签发的 App Key。
将家里的蜂窝通信模块接入自建服务，在 iPhone 上使用自己的号码收发短信、拨打和接听电话。网页用于验证部署，随行号 App 是日常使用入口。
当前公开测试版本：App 0.1.13/build63，服务端 0.1.14/build15。 TestFlight外部测试已开放；配套服务支持通话切网重连、声音设备切换、延迟优化及推送授权重新申请。GitHub以prerelease提供；App Store 0.1.13/build63已提交正式审核，等待审核，尚未上架。
服务端0.1.14/build15新增默认官方中继，并保留0.1.13起的授权重新申请功能：允许用户主动解除后保留同一NAS实例身份重新申请，并在现有官方App中再次确认；旧凭据永久失效，发布者管理员撤销仍不可自行恢复。可从独立服务端测试版 Release下载，iOS App不需修改或升版。已注册的中继域名继续可用，原凭证与授权不因新域名上线失效。新的默认中继地址是 sxhpush.jphr.cc；升级保留已有显式配置及自动授权原地址，不自动迁移。
自动推送：前提与开通步骤 · 部署指南 · iOS 客户端 · 接口规范 · 已知限制 · 问题反馈
- 电话：拨号、来电接听、挂断，以及通过 CallKit 显示系统来电界面；App／服务端0.1.1支持接通前模块音频，维护者已确认本轮开发包真机验证通过。
- 短信：查看、发送短信，支持确认后删除整个会话或单条历史短信；删除影响共享服务的所有客户端。
- 自定义接入：填写自己的 HTTPS 服务地址和独立 App Key；主动断开保留最近配置，点击连接即可恢复。设置按连接配置与电话授权、当前状态、历史状态排列。
- 网页验证：先验证电话与部署是否可用，再使用 App；网页也提供 App Key 管理入口。
- 通话诊断：自动采集发送、接收异常时间线和数值音量，便于事后排查；不代表已修复断音，真实听感继续验证。
- 部署与推送：提供 Unraid 部署适配、驱动来源说明和受控 APNs 中继；NAS管理员申请、官方App验证确认后自动取得推送授权。
需要兼容模块、SIM 卡、Unraid 及可用的 HTTPS 服务；本项目不提供号码、套餐或公共电话托管。运营商费用由用户自行承担，支持环境见硬件说明。
| 部分 | 职责 | 在本仓库中的位置 |
|---|---|---|
| HiDeck | 上游设备管理、短信及 AT 指令队列 | 外部依赖，固定参考版本 2.1.23 |
| Unraid 部署与驱动适配 | 容器、宿主服务、声卡及模块音频运行时 | deploy/unraid |
| 电话/API 服务与测试网页 | App Key、电话控制、音频、短信代理、推送适配；网页验证部署 | server，网页源码在 server/web |
| 随行号 iOS App | 用户手工配置服务，完成日常电话和短信操作 | ios |
网页和 App 共用一套服务、一个模块和一路通话。多把 App Key 代表多个授权客户端，不代表可以同时拨打多路电话。
-
按 Unraid 部署说明 配置 HiDeck、服务和 HTTPS 反代。模板中的凭据均由部署者自行设置。
-
在
https://voice.example.org/voice-test/测试网页电话；通过/voice-test/app-access/登录并签发一把设备专用 App Key。 -
安装发布者提供的官方App（自行签名者参考iOS构建说明），填写根地址
https://voice.example.org和自己的 Key。地址不要包含/voice-test/，也不是 Unraid 管理接口。 -
按自动推送前提与步骤在NAS申请、App确认。已有手工凭据继续使用，不会自动迁移。 只检查源码、预览页面不需要硬件，参见 服务端说明 和 iOS 说明。正式部署涉及设备和驱动写入，务必先核对支持环境并按分步说明执行。
server/ 电话与 API 服务，web/ 为测试网页
deploy/ 部署材料：unraid/ 为宿主适配，relay/ 为推送中继
ios/ 原生随行号 iOS App 与构建脚本
docs/ 架构、硬件、接口、隐私、运行及发布说明
licenses/ 自有服务依赖的许可证文本
Version.xcconfig App版本配置（服务端独立在server/Version.xcconfig）
HiDeck 是独立上游依赖，不包含其源码；部署者从原项目获取。日常在 develop 开发，main 维护公开版本；本地签名、测试包、服务配置及真实数据不上传。发布流程见开发与发布说明。
- API 规范：鉴权、电话状态、事件、音频、短信与错误码。
- 技术支持 / Support：求助入口、常见问题与免费使用说明。
- 隐私说明：本机保存、服务器处理、录音、推送与数据清除边界。
- 运行与回退、需求与验收、已知限制。
App 不内置个人服务地址或 Key，Key 保存在本机钥匙串；服务端只持久化 App Key 摘要。录音是服务器侧功能，启用前应告知通信参与者；新部署示例关闭录音，既有服务逻辑仍须按文档核对默认行为。
新 App 身份为 Suixinghao / com.junpo.suixinghao，显示名称为“随行号”。它按新 App 安装，需重新配置服务；旧 App 的本机数据不会自动迁移。
首版计划分发地区保持既有海外范围；正式上架状态以Apple读回为准，本轮只更新GitHub测试版本与TestFlight外部Beta提交。官方App的锁屏推送由发布者维护Apple身份，用户无需Apple开发者账号或VPS。当前提供受控自动绑定及原手工方式，前提、部署与验收见自动开通说明和中继契约。
正式版本将对应固定源码标签、提交、构建环境和产物证明。App 关于页显示源码身份；未提交或有修改的本地构建会明确标记。详见 发布与源码追溯。
- callmepopo：项目发起与维护，负责产品需求、方案决策、设备及运行环境、真机验收和发布。
- OpenAI Codex：主要 AI 开发贡献者，参与服务端与 iOS 客户端开发、问题排查与修复、测试验证、部署适配及文档维护。
- Claude Code：AI 开发协作者，参与功能开发、通话音频优化与问题修复。
以上记录项目实际协作角色；GitHub 自动生成的 Contributors 列表按提交署名统计，不能完整反映历史工作量。后续共同作者署名规范见 贡献说明。
本仓库自有代码采用 MIT。HiDeck 的 PolyForm Noncommercial 许可和第三方驱动许可独立适用；MIT 不代表整套依赖允许商用。 本项目不是 DJI、HiDeck、MaVo 或 Unraid 的官方产品。
贡献方式见 CONTRIBUTING，安全反馈见 SECURITY，变更见 CHANGELOG。提交问题时仅使用合成数据，删除号码、短信、设备标识和凭据。
官方推送自动开通由App0.1.9／服务0.1.5起提供：用户自行部署兼容NAS及HTTPS入口，服务0.1.14起默认使用 sxhpush.jphr.cc，在NAS管理页申请、App设置页确认，服务器自动领取／续期，无需用户VPS或开发者账号。已注册的中继域名继续可用，已有配置优先。发布者必须启用App Attest核验；旧手工凭据仍兼容。签发台账、身份数据和验证层级见推送中继。维护者及首个网友自建NAS自动绑定均已取得授权记录；真实锁屏送达仍按每套环境独立验收。