技术文档

版本、构建与分发状态

本文区分源码、预览构建、真实验收、商店上传、审核与公开发布。状态依据截至 2026-10-22 的仓库与保存记录整理;本次文档工作没有重新登录商店后台、复跑产品测试或重新核验生产。后续状态必须由新的可核对回执更新,不能用构建数量或聊天中的完成表述代替。

当前可以确认的范围

项目 源码或历史证据 尚需完成或重新核对
Android App 当前 versionName=1.0.6-preview、versionCode=7;保存记录包含一次真实账号授权、自动返回与 force-stop 后冷启动恢复 正式 Release 签名、公开 APK、备案签名一致性、商店与跨网络验收
iOS App 原生系统授权、PKCE、Keychain 与冷回调实现;保存记录包含 16 项授权测试与正式登录表单 UI 验证 真实账号完整登录/授权回跳/冷启动,以及 iPhone、iPad 真机闭环
医疗健康记忆 双端历史 QA 覆盖八个可选字段、多行文本、本机加密、附件、搜索和重开 其他设备、全部系统版本和字号不在原记录范围
下载介绍站 历史部署记录已确认静态站、HTTPS 和备案页脚发布 公开 App Store 地址和可分发正式 APK 仍未提供
音视频与推送 本机媒体入房、状态与 APNs 请求构造测试 真实 APNs 到达、双向媒体、跨网络、锁屏与后台真机验收
watchOS 手表独立登录联网版的产品方向已确定 尚无独立版实现交付证据;登录、网络、输入、消息和来电提醒待实施

Android 真实生产授权记录仅保存布尔结果与必要范围:真实账号授权成功、一次性票据消费、自动回前台、替换进程后恢复,以及原记忆与会话密文未改变。设备会话期限为 24 小时,没有 refresh token 或永久登录承诺,也没有连续运行 24 小时的验收。Android 结论不能代替 iOS 或 Apple 审核设备的结果。

Apple 与小米渠道

Apple 渠道仍需完成 iPad 账号授权可访问性及商业模式说明等审核事项的闭环;后续签名 Archive、构建上传及重新提审,需要新的后台记录核对。仅修复源码、打开登录页、通过模拟器用例或完成 Android 登录都不足以宣称审核问题已解决。

小米渠道仍是草稿、未提审。版权证明与聊天安全评估等渠道要求材料仍需按实际情况核对补齐;不能把待备材料写成已提交。正式 Android Release 签名、备案相关签名一致性和联网验收仍待完成,Debug APK 仅用于开发预览。

watchOS 的规划方向是“独立登录联网版”。范围包括独立登录、文字/听写、语音消息、图片、普通与城市贴纸、回应、未读已读、历史和来电提醒。现有通话 SDK 不支持 watchOS,手表直接接听需另行设计与验证;尚不能宣称手表版可下载或接听。

星线智联暂停状态

星线智联小程序开发版本 0.1.0 有上传成功的历史回执,但回执明确尚未提审、尚未发布。后续发布流程已暂停;文档公开、App 开发和资料整理不会自动恢复小程序验收或提交审核。

真实微信登录曾显示“暂时无法核对”,已有证据不足以确定是 wx.login、网络还是后端 inspect 环节失败,不能直接断言密钥或合法域名错误。恢复后先核对当前 Account 运行版本及请求链,再做真实手机闭环。正式 URL Link 需要线上发布版本;开发预览或填写版本号不等于正式往返已通过,公开入口状态也应以恢复后的实际回读为准。

可复现构建与正式产物

Android 构建入口存在,但当前配置没有提供可公开使用的正式签名凭据。下面命令生成 Release 构建候选,不能仅凭文件存在就称为正式已签名发行包:

cd android-app
./gradlew :app:assembleRelease --max-workers=1

正式分发前应核对 application ID、版本号/版本码、目标服务、签名证书、权限、最低系统、安装升级兼容与备案材料。用 Android SDK 工具验证签名,并为最终文件计算摘要;以下路径假定维护者已将真正完成签名的候选命名为该文件:

apksigner verify --verbose candidate-release.apk
shasum -a 256 candidate-release.apk

同一待发布 APK 的签名、大小、摘要、下载内容和验收记录必须对应。不能把测试 APK 或另一轮构建的摘要写到下载站。

iOS 使用工程的 StarlineWorkbench scheme;生产 Archive 需正确的 Apple 开发团队、证书、描述文件、Bundle ID 与推送能力。示例将归档保存到本工作区的构建目录,实际签名参数通过受保护的 Xcode 配置提供:

xcodebuild -project ios-app/StarlineWorkbench.xcodeproj \
  -scheme StarlineWorkbench -configuration Release \
  -destination 'generic/platform=iOS' \
  -archivePath build/StarlineWorkbench.xcarchive archive

Archive 成功只产生候选。之后仍需签名检查、目标设备安装、隐私与权限复核、上传回执、审核提交、审核结果与公开版本链接。开发推送和发布推送环境不同,不能混用测试签名和正式 APNs 结论。

下载站与文档发布

下载配置在 app-download/dist/downloads.config.js。空地址显示“准备中”;ios.url 应为确认存在的公开 App Store HTTPS 地址,android.url 应指向真实可分发 APK。只有正式稳定版验收完成后才把 android.channel 切为 stable,同时更新真实版本、大小、最低系统与 64 位 SHA-256。浏览器的 URL 结构校验不能证明服务器可下载或安装成功。

静态页面与文档发布也要单独记录:本地预览、上传、公网访问与抓取规则分别核对。发布产物只包含明确允许公开的页面、样式、脚本、图片和文档,不包含仓库 README、部署回执、环境文件、源代码快照、日志或数据库。下载新增后验证公网 GET、字节摘要和安装;文档新增后验证导航、Markdown、站点地图与抓取规则。旧部署脚本带有一次性基线假设,不应直接重复运行。

建议每次发行记录版本与提交基线、构建工具链、最终产物摘要、签名标识、测试环境、真实验收范围、渠道回执及已知限制。状态词使用“本地构建”“已上传”“已提审”“审核通过”“公开发布”等准确阶段;测试数量只作为证据索引。当前 Account 已有 001–007 与 PII 迁移、SES/阿里云投递等变化,不能从 App 历史副本冻结服务版本。具体门禁与签名命令见发行核对清单,测试见测试与验收,服务切换和恢复见运行维护。

Markdown 原文完整文档文本