# 快速开始

本页帮助用户、开发者和测试人员找到正确入口。星线 App 当前处于开发与发布准备阶段；先核对你正在使用的版本和环境，再进行登录、存储或协议测试。

## 查看可用版本

到 [App 官网](https://app.thestarline.cn/#downloads)查看 iOS 和 Android 的发布状态。没有真实公开下载地址时，页面显示准备中。开发预览截图、源码中的版本号、签名成功或商店草稿都不能证明可公开下载。

取得开发预览包时，应确认提供方、平台、构建版本、签名与服务器环境。不要把未经核对的第三方 APK 当作正式发行版，也不要为了复现问题卸载保存个人记忆的现有 App。正式发布条件见[版本发布](https://document.thestarline.cn/app/releases.md)。

## 一次正常的使用路径

1. 打开 App，查看聊天、工作台和我的等主要入口；具体布局以平台和构建为准。
2. 使用聊天功能时进入星线账户登录；系统浏览器承载 Account 身份认证与授权，App 不应自己模拟 Account 登录页。
3. 确认授权应用名称为“星线 App”，授权说明为：正在为“星线 App”授权您的账号信息数据。
4. 完成授权后返回 App，客户端换取聊天会话并恢复用户资料。
5. 在已有权限的会话发送消息，或在本机建立记忆、个人任务与收藏。

账号授权成功、返回 App 成功和聊天会话建立成功是三个需要分别观察的步骤。授权码和一次性 ticket 不能重复使用，回调失败时应重新发起登录，不复制带参数的完整回跳链接给他人。协议说明见[登录与会话](https://document.thestarline.cn/app/authentication.md)。

## 登录停在某一步时

| 看到的状态 | 先检查什么 | 后续动作 |
| --- | --- | --- |
| App 尚未打开 Account | 当前构建的聊天地址、网络和授权开始响应 | 先定位请求是否成功，不反复改账号密码 |
| 浏览器仍停在验证或授权页面 | 用户是否完成当前步骤，页面是否报错或要求补充验证 | 按页面完成必要验证；取消后从 App 重新发起 |
| 浏览器结束但 App 未回到前台 | 回调 scheme、系统是否允许返回、对应构建是否仍安装 | 记录平台与停留页面；不要将回跳 URL 公开发送 |
| App 收到回调但显示失败 | state、到期、pending、ticket 和换票请求 | 同一次流程必须匹配；重新开始，而不是混用旧参数 |
| 已登录后重开变为未登录 | 聊天会话到期、安全存储与恢复读取结果 | 区分会话失效和读取失败，不清空记忆作为修复 |

Android 当前信任正式 Account HTTPS 授权来源；将聊天服务切到本地不等于已经完成本地原生授权配置。开发人员应先阅读[开发配置](https://document.thestarline.cn/app/development.md)，不要按端口连通推断整个原生流程可用。

## 先区分在线与本机功能

| 使用内容 | 依赖 | 需要注意 |
| --- | --- | --- |
| 聊天、新事、媒体和通话 | 聊天会话、网络与对应服务 | 对方关系、群成员或媒体权限决定可见范围 |
| 记忆主体和记忆附件 | 当前设备的本地存储与密钥 | 当前没有云同步，另一设备不会自动获得内容 |
| 个人任务、收藏 | 客户端本地数据 | 不等同于独立星企产品的企业待办 |
| 城市定位选择 | 操作触发的位置权限或允许的城市来源 | 拒绝权限不应阻止选择其他适用城市 |

重要记忆在卸载、换机或清理应用数据前需要单独处理。转出 JSON 不等于已有完整导入恢复；本机加密也不能保护已经转出的明文文件。详见[本地记忆](https://document.thestarline.cn/app/local-memory.md)。医疗健康模板是个人记录工具，不提供诊断、健康平台自动同步或已交付的用药提醒，详见[医疗记录](https://document.thestarline.cn/app/medical-records.md)。

## 第一次发送与记录

聊天应先确认好友或群成员关系，再发送一条没有敏感内容的测试文字。附件分成上传和发送引用两个阶段，上传成功但第二步失败时，不能按对方已收到处理。重复点击或网络重试应对应同一个发送意图，客户端通过 clientId 与服务端消息 ID 合并，见[消息与媒体](https://document.thestarline.cn/app/messaging-and-media.md)。

建立记忆时可先用合成标题、正文和一个小附件检查保存、列表、搜索、编辑与重开。确认原文件和预览都能读取后，再使用个人资料。选择了主题但所有内容均为空时不会保存一条空记录。附件名参与搜索，附件正文当前不等于已执行 OCR 或全文索引。

工作台的个人任务和收藏也保存在设备上。两端的筛选与时间展示有差异，例如 iOS 有任务标题/备注搜索和独立逾期筛选，Android 当前不能按同一界面能力假定完全对等。完整字段、操作及排序说明见[个人工作台](https://document.thestarline.cn/app/workbench.md)。

## 权限在对应操作中处理

选择城市、扫码、视频和实时位置分别需要不同系统能力。拒绝相机后可用的图片/粘贴路径、拒绝定位后的城市选择、仅音频入会，以及系统设置重新授权，都应按实际入口判断。不要将一种权限拒绝解释为账号失效。

实时位置开始后要分别确认本机持续采集状态和服务端共享状态。停止失败时仍需读取和确认远端是否已移除；简单离开页面不等于共享已终止。详细步骤见[位置共享](https://document.thestarline.cn/app/location-sharing.md)和[权限说明](https://document.thestarline.cn/app/permissions-accessibility.md)。

## 更新、退出与换机前

更新前核对构建来源与签名兼容，优先保留既有应用数据。记录保存在当前设备不等于按聊天账号分别隔离；修改 Account 密码、退出或切换账号不会自动删除、重加密本机记忆。退出界面完成也不一定证明远端 logout 请求已经成功。

换机或清理前先查[记忆转出](https://document.thestarline.cn/app/memory-export.md)和[本机格式](https://document.thestarline.cn/app/local-data-formats.md)。转出还依赖额外许可流程，当前跨服务闭环仍需核验；不能在未经验证的前提下把它作为唯一备份，更不能因已有 JSON 就认定当前版本一定支持导入恢复。读取损坏或密钥不可用时保留原安装和原文件，避免覆盖式修复。

## 开发者的最短阅读路线

先读[系统架构](https://document.thestarline.cn/app/architecture.md)了解职责，再按目标平台阅读 [iOS](https://document.thestarline.cn/app/ios.md)或 [Android](https://document.thestarline.cn/app/android.md)。准备构建和隔离联调时使用[开发配置](https://document.thestarline.cn/app/development.md)，核对[环境及配置](https://document.thestarline.cn/app/configuration.md)。接口实现以[API 参考](https://document.thestarline.cn/app/api-reference.md)为入口，尤其注意聊天 token 与 Account token 的区别。

公开文档不提供生产客户端密钥、受保护数据库或实际用户测试账号。API 表格是协议说明，不代表第三方 App 自动获得注册、访问或生产接入许可。测试应使用明确隔离的合成数据，验收清单见[测试](https://document.thestarline.cn/app/testing.md)。

接口调用可按[协议示例](https://document.thestarline.cn/app/protocol-recipes.md)先核对 `/me`、分页、幂等发送、媒体引用和事件游标，再处理附加能力。开发测试与真实分发的检查项不同；需要准备发行包时，使用[发行检查清单](https://document.thestarline.cn/app/release-checklist.md)，逐项记录签名、版本、安装、授权、数据兼容及渠道状态。

## 遇到问题时记录什么

保留平台、系统版本、App 构建版本、发生时间、网络类型、操作步骤和已脱敏的错误提示。涉及回调时只描述停留在哪一步；涉及记忆时先区分保存失败、列表未刷新、文件权限或密钥不可用。不要把验证码、token、病历正文、聊天内容或含敏感参数的 URL 写入公开问题。

前端可打开、API 健康、短信/邮件到达和双端消息可用分别验证。[故障排查](https://document.thestarline.cn/app/troubleshooting.md)提供定位顺序，[支持站](https://support.thestarline.cn/)提供后续联系入口。