# 星线 App 技术文档

星线 App 的技术文档涵盖 iOS、Android、账号授权、聊天服务、本地数据、媒体与通话、安全、开发、测试和部署。资料日期为 2026-10-23；接口与操作说明依据可检查的源码和已有记录整理，实际可用范围以所安装版本和对应验收结果为准。

## 从这里开始

首次了解产品，先读[快速开始](https://document.thestarline.cn/app/getting-started.md)与[功能及平台范围](https://document.thestarline.cn/app/features.md)。开发者可沿[系统架构](https://document.thestarline.cn/app/architecture.md)、[登录与会话](https://document.thestarline.cn/app/authentication.md)、[API 参考](https://document.thestarline.cn/app/api-reference.md)进入协议；维护者可从[开发配置](https://document.thestarline.cn/app/development.md)、[测试验收](https://document.thestarline.cn/app/testing.md)、[运维](https://document.thestarline.cn/app/operations.md)和[故障排查](https://document.thestarline.cn/app/troubleshooting.md)进入实际流程。

| 主题 | 阅读入口 |
| --- | --- |
| 原生客户端 | [iOS](https://document.thestarline.cn/app/ios.md)、[Android](https://document.thestarline.cn/app/android.md)、[权限与无障碍](https://document.thestarline.cn/app/permissions-accessibility.md) |
| 消息与在线能力 | [消息及媒体](https://document.thestarline.cn/app/messaging-and-media.md)、[实时同步与通话](https://document.thestarline.cn/app/realtime-and-calls.md)、[城市贴纸](https://document.thestarline.cn/app/city-stickers.md) |
| 本机个人资料 | [本地记忆](https://document.thestarline.cn/app/local-memory.md)、[医疗健康记录](https://document.thestarline.cn/app/medical-records.md) |
| 服务与数据 | [数据模型](https://document.thestarline.cn/app/data-model.md)、[安全和隐私](https://document.thestarline.cn/app/security-and-privacy.md)、[配置与环境](https://document.thestarline.cn/app/configuration.md) |
| 交付与公开访问 | [版本发布](https://document.thestarline.cn/app/releases.md)、[文档访问与引用](https://document.thestarline.cn/app/ai-access.md) |

## 按具体工作查阅

| 需要完成的工作 | 建议顺序 | 应得到的结论 |
| --- | --- | --- |
| 接入一次完整登录 | [登录与会话](https://document.thestarline.cn/app/authentication.md) → [协议示例](https://document.thestarline.cn/app/protocol-recipes.md) → [客户端生命周期](https://document.thestarline.cn/app/client-lifecycle.md) | 两层 proof、回调校验、pending 恢复及会话失效如何处理 |
| 接入消息和附件 | [好友与群](https://document.thestarline.cn/app/contacts-and-groups.md) → [消息与媒体](https://document.thestarline.cn/app/messaging-and-media.md) → [API](https://document.thestarline.cn/app/api-reference.md) | 关系权限、上传引用、重复发送、分页及本人删除的含义 |
| 开发新事与定位 | [新事](https://document.thestarline.cn/app/moments.md) → [位置共享](https://document.thestarline.cn/app/location-sharing.md) → [权限](https://document.thestarline.cn/app/permissions-accessibility.md) | 可见范围、媒体处理、开始/更新/停止及拒绝权限后的状态 |
| 调整本机记忆或工作台 | [工作台](https://document.thestarline.cn/app/workbench.md) → [本机格式](https://document.thestarline.cn/app/local-data-formats.md) → [记忆转出](https://document.thestarline.cn/app/memory-export.md) | 哪些数据按设备保存、如何兼容旧字段、失败时如何保留原库 |
| 分析加密能力 | [安全与隐私](https://document.thestarline.cn/app/security-and-privacy.md) → [MLS协议](https://document.thestarline.cn/app/mls-protocol.md) | 当前普通消息链路、独立加密协议与本机加密的准确范围 |
| 准备联调环境 | [模块地图](https://document.thestarline.cn/app/module-map.md) → [开发](https://document.thestarline.cn/app/development.md) → [配置参考](https://document.thestarline.cn/app/configuration-reference.md) | 当前权威源码、依赖、配置校验及隔离测试的限制 |
| 执行回归或发行 | [测试矩阵](https://document.thestarline.cn/app/qa-matrix.md) → [发行检查](https://document.thestarline.cn/app/release-checklist.md) → [运维](https://document.thestarline.cn/app/operations.md) | 每个场景的前置条件、预期结果、证据与回滚对象 |
| 排查已有故障 | [故障排查](https://document.thestarline.cn/app/troubleshooting.md) → [处置步骤](https://document.thestarline.cn/app/incident-runbooks.md) → [限制与错误](https://document.thestarline.cn/app/limits-and-errors.md) | 失败发生在哪一层、能否重试、怎样核对恢复结果 |

阅读接口时先确认对象所属产品、当前账号和会话范围。阅读本机格式时先确认平台与安装环境。名词、ID、时间单位和删除状态可随时对照[术语参考](https://document.thestarline.cn/app/glossary.md)，避免把同名字段跨服务或跨资源使用。

## 产品和系统入口

星线 App 将联系、分享与本机日常记录放在一起。iOS 使用 SwiftUI，Android 使用 Jetpack Compose；聊天服务负责在线会话、消息、媒体、新事与相关权限，星线 Account 提供身份认证与授权。本机记忆、个人任务和收藏有独立的设备端存储边界。

| 公开入口 | 用途 |
| --- | --- |
| [App 官网](https://app.thestarline.cn/) | 产品介绍与真实下载状态 |
| [星线 Account](https://account.thestarline.cn/) | 账户登录、授权与账号管理 |
| `https://chat.thestarline.cn` | 客户端聊天 API 基地址，受保护接口需要聊天会话 |
| [App 隐私说明](https://privacy.thestarline.cn/app-privacy.html) | 对用户生效的 App 隐私说明 |
| [支持](https://support.thestarline.cn/) | 产品支持入口 |

本技术文档解释实现，不替代法律文本、正式服务承诺或对某个账号的访问授权。公开聊天 API 地址不是匿名读取他人数据的入口。

## 怎样理解实现状态

文档区分源码中可确认的实现、历史保存的测试记录，以及仍需要当前环境验证的事项。代码中有路由说明服务端存在该契约；客户端有调用说明该构建包含相应路径；真实设备、跨网络、推送与渠道状态需要各自证据。文档整理不会替代这些业务验收。

当前下载站仍将 iOS 与 Android 标为准备中。没有可据此宣称已公开上架的 App Store 链接或正式稳定 APK。Android 存在历史真实授权和冷启动恢复记录；iOS 真实账号完整链路、iPad 可用性、跨网络通话与后台来电等仍有独立验收要求。watchOS 独立应用尚未交付，星线智联小程序发布流程已暂停。详情见[发布状态](https://document.thestarline.cn/app/releases.md)。

新增专题写到具体约束与差异：例如临时好友码的消费顺序、群主退出后的转移、客户端视频缓存方式、位置停止失败、本地字段兼容和记忆转出依赖。源码中发现的差异会标明核对位置与待验场景，不把“建议实现的行为”写成“当前必然如此”。

## 数据与加密的重要边界

本机记忆主体和附件使用设备端加密保存；它们目前没有跨设备云同步。退出账号、卸载、删除记忆和转出文件是不同操作，不能互相推断。

聊天服务存在 MLS 加密核心和独立加密事件协议，但当前默认客户端聊天发送仍使用普通消息接口，附件也没有完整的客户端密文封装链路。因此不承诺所有当前聊天和附件已经完成端到端加密。阅读[安全和隐私](https://document.thestarline.cn/app/security-and-privacy.md)了解 TLS、本机加密、服务端字段加密与 MLS 的不同范围。

## 文档中的示例与配置

JSON 中的 UUID、消息编号、时间和文字是合成示例；配置只给变量名、用途、默认与启用条件，不给运行凭据。命令默认用于已隔离的开发或测试环境，涉及写入的步骤需使用授权测试账号。完整返回字段、分页边界、权限和错误状态应结合相邻表格阅读，不从单个成功响应推导全链路可用。

Account 与 App 使用独立维护来源。App 工作树附带的历史 Account 文件可能落后于当前身份服务，配置和迁移以当前 Account 权威源码为依据；模块归属和核对方法见[源码模块地图](https://document.thestarline.cn/app/module-map.md)。

## 文档格式与引用

每篇文章提供 HTML 页面与 Markdown 原文，正文不依赖 JavaScript。可通过[文档清单](https://document.thestarline.cn/app/catalog.json)查看目录，或下载[完整文本](https://document.thestarline.cn/llms-full.txt)。引用时请注明文章标题、原始地址和资料日期，具体规则见[文档访问与引用](https://document.thestarline.cn/app/ai-access.md)。