星线 App 技术文档
星线 App 的技术文档涵盖 iOS、Android、账号授权、聊天服务、本地数据、媒体与通话、安全、开发、测试和部署。资料日期为 2026-10-23；接口与操作说明依据可检查的源码和已有记录整理，实际可用范围以所安装版本和对应验收结果为准。
从这里开始
首次了解产品，先读快速开始与功能及平台范围。开发者可沿系统架构、登录与会话、API 参考进入协议；维护者可从开发配置、测试验收、运维和故障排查进入实际流程。
| 主题 | 阅读入口 |
|---|---|
| 原生客户端 | iOS、Android、权限与无障碍 |
| 消息与在线能力 | 消息及媒体、实时同步与通话、城市贴纸 |
| 本机个人资料 | 本地记忆、医疗健康记录 |
| 服务与数据 | 数据模型、安全和隐私、配置与环境 |
| 交付与公开访问 | 版本发布、文档访问与引用 |
按具体工作查阅
| 需要完成的工作 | 建议顺序 | 应得到的结论 |
|---|---|---|
| 接入一次完整登录 | 登录与会话 → 协议示例 → 客户端生命周期 | 两层 proof、回调校验、pending 恢复及会话失效如何处理 |
| 接入消息和附件 | 好友与群 → 消息与媒体 → API | 关系权限、上传引用、重复发送、分页及本人删除的含义 |
| 开发新事与定位 | 新事 → 位置共享 → 权限 | 可见范围、媒体处理、开始/更新/停止及拒绝权限后的状态 |
| 调整本机记忆或工作台 | 工作台 → 本机格式 → 记忆转出 | 哪些数据按设备保存、如何兼容旧字段、失败时如何保留原库 |
| 分析加密能力 | 安全与隐私 → MLS协议 | 当前普通消息链路、独立加密协议与本机加密的准确范围 |
| 准备联调环境 | 模块地图 → 开发 → 配置参考 | 当前权威源码、依赖、配置校验及隔离测试的限制 |
| 执行回归或发行 | 测试矩阵 → 发行检查 → 运维 | 每个场景的前置条件、预期结果、证据与回滚对象 |
| 排查已有故障 | 故障排查 → 处置步骤 → 限制与错误 | 失败发生在哪一层、能否重试、怎样核对恢复结果 |
阅读接口时先确认对象所属产品、当前账号和会话范围。阅读本机格式时先确认平台与安装环境。名词、ID、时间单位和删除状态可随时对照术语参考，避免把同名字段跨服务或跨资源使用。
产品和系统入口
星线 App 将联系、分享与本机日常记录放在一起。iOS 使用 SwiftUI，Android 使用 Jetpack Compose；聊天服务负责在线会话、消息、媒体、新事与相关权限，星线 Account 提供身份认证与授权。本机记忆、个人任务和收藏有独立的设备端存储边界。
| 公开入口 | 用途 |
|---|---|
| App 官网 | 产品介绍与真实下载状态 |
| 星线 Account | 账户登录、授权与账号管理 |
https://chat.thestarline.cn |
客户端聊天 API 基地址，受保护接口需要聊天会话 |
| App 隐私说明 | 对用户生效的 App 隐私说明 |
| 支持 | 产品支持入口 |
本技术文档解释实现，不替代法律文本、正式服务承诺或对某个账号的访问授权。公开聊天 API 地址不是匿名读取他人数据的入口。
怎样理解实现状态
文档区分源码中可确认的实现、历史保存的测试记录，以及仍需要当前环境验证的事项。代码中有路由说明服务端存在该契约；客户端有调用说明该构建包含相应路径；真实设备、跨网络、推送与渠道状态需要各自证据。文档整理不会替代这些业务验收。
当前下载站仍将 iOS 与 Android 标为准备中。没有可据此宣称已公开上架的 App Store 链接或正式稳定 APK。Android 存在历史真实授权和冷启动恢复记录；iOS 真实账号完整链路、iPad 可用性、跨网络通话与后台来电等仍有独立验收要求。watchOS 独立应用尚未交付，星线智联小程序发布流程已暂停。详情见发布状态。
新增专题写到具体约束与差异：例如临时好友码的消费顺序、群主退出后的转移、客户端视频缓存方式、位置停止失败、本地字段兼容和记忆转出依赖。源码中发现的差异会标明核对位置与待验场景，不把“建议实现的行为”写成“当前必然如此”。
数据与加密的重要边界
本机记忆主体和附件使用设备端加密保存；它们目前没有跨设备云同步。退出账号、卸载、删除记忆和转出文件是不同操作，不能互相推断。
聊天服务存在 MLS 加密核心和独立加密事件协议，但当前默认客户端聊天发送仍使用普通消息接口，附件也没有完整的客户端密文封装链路。因此不承诺所有当前聊天和附件已经完成端到端加密。阅读安全和隐私了解 TLS、本机加密、服务端字段加密与 MLS 的不同范围。
文档中的示例与配置
JSON 中的 UUID、消息编号、时间和文字是合成示例；配置只给变量名、用途、默认与启用条件，不给运行凭据。命令默认用于已隔离的开发或测试环境，涉及写入的步骤需使用授权测试账号。完整返回字段、分页边界、权限和错误状态应结合相邻表格阅读，不从单个成功响应推导全链路可用。
Account 与 App 使用独立维护来源。App 工作树附带的历史 Account 文件可能落后于当前身份服务，配置和迁移以当前 Account 权威源码为依据；模块归属和核对方法见源码模块地图。
文档格式与引用
每篇文章提供 HTML 页面与 Markdown 原文，正文不依赖 JavaScript。可通过文档清单查看目录，或下载完整文本。引用时请注明文章标题、原始地址和资料日期，具体规则见文档访问与引用。