# 星线技术文档 > 星线各产品的公开技术资料。允许 AI 访问、抓取、索引、摘要和引用公开文档。 资料日期：2026-10-23。引用须保留具体产品、文章原址、实现状态与限制。文档访问许可不授予用户数据、私有 API 或源码访问权。 - [HTML 入口](https://document.thestarline.cn/) - [关于星线](https://document.thestarline.cn/reference/company.md) - [公司结构化信息](https://document.thestarline.cn/organization.json) - [完整目录](https://document.thestarline.cn/catalog.json) - [完整文本](https://document.thestarline.cn/llms-full.txt) - [访问与引用](https://document.thestarline.cn/reference/access/) ## 星线 App 原生客户端、聊天与新事、本机记忆、媒体和通话。 - [星线 App 技术文档](https://document.thestarline.cn/app/overview.md): 星线 App 的技术文档涵盖 iOS、Android、账号授权、聊天服务、本地数据、媒体与通话、安全、开发、测试和部署。资料日期为 2026-10-23；接口与操作说明依据可检查的源码和已有记录整理，实际可用范围以所安装版本和对应验收结果为准。 - [快速开始](https://document.thestarline.cn/app/getting-started.md): 本页帮助用户、开发者和测试人员找到正确入口。星线 App 当前处于开发与发布准备阶段；先核对你正在使用的版本和环境，再进行登录、存储或协议测试。 - [功能及平台范围](https://document.thestarline.cn/app/features.md): 本页把星线 App 的主要能力与交付边界放在一起比较。表格表示截至 2026-10-23 可从当前源码确认的入口或模块，不表示每个版本、设备和生产账号都已完成端到端验收。实际发布条件见版本发布。 - [系统架构](https://document.thestarline.cn/app/architecture.md): 星线 App 由 iOS、Android 原生客户端、聊天服务、星线 Account 身份服务及通话媒体服务组成。本页依据当前源码说明组件责任、请求路径与实现边界；源码中存在的模块不自动代表客户端已经接入，也不代表生产环境已经完成验收。 - [登录、授权与会话](https://document.thestarline.cn/app/authentication.md): 星线 App 使用星线 Account 完成身份验证，再由聊天服务签发独立的聊天会话。原生客户端通过系统浏览器参与授权，不把 Account 密码交给聊天服务；当前原生协议同时保护 Account 授权码交换和 App 聊天票据交换。 - [聊天服务 API 参考](https://document.thestarline.cn/app/api-reference.md): 本页列出当前聊天服务源码的 HTTP 契约，包括星线 App 使用的个人业务接口、独立 MLS 接口及共享后台中属于星企的企业接口。基地址为 https://chat.thestarline.cn。路由存在仅代表代码实现，不能证明生产依赖已经配置、客户端已经接入或真实设备路径已经验收。 - [协议示例与集成步骤](https://document.thestarline.cn/app/protocol-recipes.md): 本页把分散的接口串成可检查的流程，说明调用顺序、需要保留的状态、重复请求及失败处理。请求契约来自聊天服务当前源码；这些示例不代表所有客户端已经采用相同实现。路由逐项定义见 API 参考，状态和限制见限制与错误。 - [数据模型与一致性](https://document.thestarline.cn/app/data-model.md): 聊天服务以 SQLite 保存身份映射、联系人关系、聊天内容、媒体、新事、事件和通话状态。原生记忆数据另有客户端本地模型。本页描述源码中的逻辑实体与约束，帮助调用方理解 ID、可见性、重试和删除语义；不提供任何用户数据库或生产记录。 - [MLS 设备与加密事件协议](https://document.thestarline.cn/app/mls-protocol.md): 仓库已实现Rust MLS核心、服务端交付接口和iOS独立传输器。当前iOS主ChatStore与Android主聊天仍发送普通text/media，附件也未接入客户端密文封装。本页解释协议状态与恢复要求，不把模块存在等同于全量端到端加密或生产安全审计通过。 - [限制、错误码与重试规则](https://document.thestarline.cn/app/limits-and-errors.md): 本页按当前聊天服务与客户端源码列出限制。数值是具体字段或路由的约束，不代表全局容量承诺；反向代理、操作系统和外部供应商还可能有独立限制，但本页不臆测未实现的策略。错误判断应结合HTTP状态、error.code和当前业务阶段。 - [联系人、好友申请与个人群](https://document.thestarline.cn/app/contacts-and-groups.md): 好友关系、屏蔽关系、聊天可见性和群成员是四类独立状态。删除聊天不等于删除好友，群静音不等于屏蔽群成员，个人删除消息也不是全员撤回。本页给出这些状态的操作顺序、权限与恢复边界；全部业务请求使用聊天 Bearer 会话。 - [消息、媒体与 MLS 数据流](https://document.thestarline.cn/app/messaging-and-media.md): 星线 App 当前主聊天界面通过普通消息 API 发送文字或媒体引用。仓库另外实现了 Rust MLS 核心、服务端加密事件流和 iOS 独立加密传输器。本页分别说明实际消息路径与 MLS 协议，尤其明确附件是否经过客户端加密，避免把已有加密模块扩大描述为所有聊天数据已经端到端加密。 - [新事的发布、可见性与媒体](https://document.thestarline.cn/app/moments.md): 新事是服务端保存的图文与短视频内容，使用独立于聊天消息的表、媒体配额和通知机制。它没有接入MLS；可见范围由每次读取时的当前关系决定。服务端支持媒体Range，但当前iOS与Android播放器路径都先完整下载后播放。 - [城市提示与实时位置共享](https://document.thestarline.cn/app/location-sharing.md): 城市贴纸推荐、一次性地点消息和实时位置共享是不同功能。城市识别只为推荐素材；实时共享会把精确坐标和时间持续写入聊天服务，必须由用户显式开始，并在停止、权限变化、断网和退出账号时分别处理本机采集与远端记录。 - [实时同步、位置与音视频通话](https://document.thestarline.cn/app/realtime-and-calls.md): 聊天变更通过 HTTP 长轮询通知，音视频使用独立的 LiveKit 媒体连接，iOS 来电可通过 APNs VoIP 唤醒。三者承担不同责任：事件告诉客户端刷新什么，通话 API 维护参与状态，媒体服务承载实际音视频。任何单一环节成功都不能代表整个通话已经可用。 - [iOS 客户端](https://document.thestarline.cn/app/ios.md): 星线 iOS 是使用 SwiftUI 编写的原生 iPhone 客户端。本文说明工程入口、状态管理、本机数据与系统能力接入，面向需要运行、维护或扩展客户端的开发者。 - [Android 客户端](https://document.thestarline.cn/app/android.md): 星线 Android 使用 Kotlin 与 Jetpack Compose 实现聊天、工作台、记忆和个人设置。当前工程版本标记为预览版；本文说明源码组织、构建配置、数据流和平台能力边界。 - [客户端启动、恢复与资源生命周期](https://document.thestarline.cn/app/client-lifecycle.md): 客户端生命周期包含本机数据加载、登录事务、已登录会话、增量刷新、消息重试、媒体连接和持续位置共享。它们的恢复条件不同：重新打开 App 不等于重新登录，关闭聊天页不等于结束通话或位置共享，进程内队列也不等于已持久化的离线发件箱。 - [个人工作台、任务与网站](https://document.thestarline.cn/app/workbench.md): 工作台集中展示本机个人任务、网页收藏和最近访问。它不要求先加入企业组织，也没有把任务提交到共享企业后台。iOS 与 Android 共用产品方向，但当前筛选、日期、网址保存和持久化实现存在差异，应按平台理解实际行为。 - [本地记忆与加密存储](https://document.thestarline.cn/app/local-memory.md): “记忆”用于保存个人文字、结构化选项、图片与文件，核心读写、搜索和模板推荐在设备本机完成，不要求先登录。账号退出不会自动清除记忆；当前没有跨设备自动同步或通用导入恢复能力。 - [双端本机数据格式与兼容](https://document.thestarline.cn/app/local-data-formats.md): 本页记录任务、网站、记忆、附件和本机授权状态在当前源码中的形状。示例均为合成值，只用于解释字段；不提供读取用户私有数据或导出密钥的操作。原生磁盘格式是实现细节，没有通用跨平台导入承诺，修改前应保留旧数据兼容和失败保护。 - [记忆转出容器、许可与失败处理](https://document.thestarline.cn/app/memory-export.md): 客户端已经编写记忆转出的许可桥接和本机打包代码。当前作为维护基线的 Account 主目录源码没有对应记忆转出模块与 /api/memory-export/redeem 路由，因此本页描述实现契约与本机文件格式，不代表当前跨服务转出已经可用。App 工作树中的历史 Account 副本不能代替权威 Account 的运行版本与真实验收。 - [医疗健康记录](https://document.thestarline.cn/app/medical-records.md): 医疗健康记录是本地记忆的一种结构化模板，用于整理就诊、检查检验、用药、疫苗与复诊资料。它沿用本机加密、附件、编辑、搜索与转出机制，内容由用户输入和确认。 - [城市建筑贴纸](https://document.thestarline.cn/app/city-stickers.md): 城市建筑贴纸根据用户识别或手选的城市提供一张本地建筑插画，再通过聊天服务登记成系统贴纸媒体。它与自定义图片贴纸分开管理，不占用户自定义贴纸数量。 - [权限、系统能力与可访问性](https://document.thestarline.cn/app/permissions-accessibility.md): 星线按扫码、通话、城市识别、实时位置和文件操作分别接入系统能力。本文列明源码声明及触发路径，并说明现有可访问性实现与验收范围。 - [安全、加密与隐私边界](https://document.thestarline.cn/app/security-and-privacy.md): 本页描述当前源码可确认的防护、数据可见性和已知实现边界。它不是独立安全审计报告，也不表示生产部署、客户端权限、外部依赖或端到端安全已经全部验收。维护者应以实际构建、配置回读和完整双设备路径的结果更新状态。 - [源码模块与修改入口地图](https://document.thestarline.cn/app/module-map.md): 本页将目录、关键文件、跨模块依赖和验证入口对应起来，便于定位变更边界。路径均相对其所属仓库，不代表公开源码下载授权。App 仓库含 iOS、Android、聊天和加密核心；Account 另有当前维护的主仓库，App 工作树附带的 identity/ 是历史快照。二者不能以目录同名认定版本相同，更不能把旧副本整体覆盖到共享服务。 - [本地开发与配置](https://document.thestarline.cn/app/development.md): 本文说明星线 App 的源码入口、隔离开发环境和配置方法。App 与聊天命令默认从 App 仓库根目录执行；Account 命令必须进入其当前维护仓库，不能使用 App 工作树中同名的历史 identity/ 副本。示例中的账号、口令和 example.test 域名均为合成测试值。配置依据 2026-10-23 当前源码整理，本次文档整理没有启动服务、模拟器或访问生产配置。 - [环境、配置与兼容性](https://document.thestarline.cn/app/configuration.md): 星线 App、聊天服务与 Account 必须使用匹配环境。本页解释配置契约与变更影响；变量明细及本地命令见开发配置，生产变更步骤见运维。公开资料不包含任何实际密钥或私有配置文件。 - [配置变量与启动校验参考](https://document.thestarline.cn/app/configuration-reference.md): 本页从配置加载器、服务入口、构建文件和适配器提取变量名、默认行为与失败条件，不使用环境文件中的实际值。Account 以其当前维护的主源码为准；App 独立工作树中的 identity/ 是历史副本，不能作为现行生产配置模板。以下描述是源码契约，不是运行配置或业务可用性的回读结果。环境选择见开发配置，维护流程见故障处理手册。 - [测试、隔离与验收边界](https://document.thestarline.cn/app/testing.md): 本文给出仓库实际存在的测试入口，说明各层测试能够证明什么，以及如何保护本机数据。命令供维护者在具备条件的隔离环境执行；本次文档编写没有重跑产品测试。文中历史数量仅指相应日期的保存记录，不能作为当前版本、线上部署或所有设备均可用的保证。 - [分层测试与双端验收矩阵](https://document.thestarline.cn/app/qa-matrix.md): 本页将源码检查、自动测试、界面验证、真实设备与生产验收分开。矩阵中的“期望”是测试断言或必须满足的产品边界，不表示本轮已经运行。历史记录按其日期和目标保留；所有新增执行都应记录当前基线、设备、环境、命令、结果与剩余范围。基础命令见测试，模块入口见模块地图。 - [服务运行、迁移与数据保护](https://document.thestarline.cn/app/operations.md): 星线 App 的运行涉及静态下载站、Account 身份服务、聊天服务，以及可选的模型、LiveKit 和 APNs。本文介绍源码中可确认的运行机制与维护原则，不提供生产凭据、服务器地址或私有部署目录。本次仅核对代码与历史文档，没有连接生产、读取数据库、执行迁移或演练恢复。 - [故障处理与恢复演练手册](https://document.thestarline.cn/app/incident-runbooks.md): 本页按现象给出只读排查、安全修复、验证与恢复边界。命令中的 qa-fixture、qa-backup、测试数据库和连接别名均为隔离演练示例，不指向真实用户数据。本次编写没有运行这些命令或执行恢复。首先记录时间、平台、版本、网络、操作阶段与脱敏错误；不要收集密码、验证码、verifier、票据、访问 token、记忆正文或完整带参数回跳 URL。 - [版本、构建与分发状态](https://document.thestarline.cn/app/releases.md): 本文区分源码、预览构建、真实验收、商店上传、审核与公开发布。状态依据截至 2026-10-22 的仓库与保存记录整理；本次文档工作没有重新登录商店后台、复跑产品测试或重新核验生产。后续状态必须由新的可核对回执更新，不能用构建数量或聊天中的完成表述代替。 - [构建、签名与发行核对清单](https://document.thestarline.cn/app/release-checklist.md): 发行应绑定一个明确基线、一组不可混用的最终产物和分阶段回执。源码版本、测试数量、Archive、APK 文件、上传、提审和公开下载各有独立证据。以下命令供在授权构建环境核对，本次没有运行原生构建、签名、服务测试或渠道操作；当前状态见版本发布。 - [故障定位与恢复边界](https://document.thestarline.cn/app/troubleshooting.md): 排查星线 App 时，先确定故障发生在本机界面、网络、聊天服务、Account、第三方授权还是商店。本文根据源码中的实际错误与运行机制整理处理顺序。示例仅使用本机地址和合成数据；本次没有访问生产、读取用户内容或实施恢复操作。服务机制见运行维护，验收命令见测试与验收。 - [标识符、时间与术语参考](https://document.thestarline.cn/app/glossary.md): 本页统一文档中的名称、数据单位和状态含义。相似名称不一定代表同一对象；集成时应同时核对所属服务、用户、会话范围和有效期。具体字段以 API 参考、本机数据格式和配置参考为准。 - [文档访问与引用](https://document.thestarline.cn/app/ai-access.md): 技术文档提供 HTML、Markdown 和索引文件，无需登录或 API key。允许自动化工具访问、抓取、索引、摘要及引用 https://document.thestarline.cn/app/ 的公开内容。引用时请保留文章标题、原始 URL、资料日期和相关限制。 ## 星线账户 注册登录、通行密钥、会话安全、账号资料和身份验证。 - [星线账户技术概览](https://document.thestarline.cn/account/overview.md): 星线账户（Account）负责账户凭据、网页登录、安全设置、个人资料和应用授权。资料依据 2026 年 10 月 23 日 identity/ 源码整理。账户站为 https://account.thestarline.cn，第三方接入见开放平台，微信小程序确认见星线智联。 - [星线账户接口接入](https://document.thestarline.cn/account/integration.md): 账户网页接口使用同站 Cookie、精确来源和 CSRF 校验。它们适用于账户前端；第三方业务登录应使用开放平台的 OIDC，不要求用户向第三方提交账户密码。资料依据 2026 年 10 月 23 日 identity/server/ 源码整理，介绍请求顺序、字段与失败边界。 ## 星线开放平台 应用登记、OIDC 授权、签名 API 和事件通知。 - [星线开放平台技术概览](https://document.thestarline.cn/open-platform/overview.md): 开放平台管理第三方应用、OIDC 登录授权、服务端签名 API 和 Webhook，实现与星线账户同在 identity/，使用账户身份与 MySQL 存储，通过 https://open.thestarline.cn 提供独立平台界面。资料依据 2026 年 10 月 23 日源码整理；外部应用接入资格与生产回调需单独验收。 - [开放平台接入与协议细则](https://document.thestarline.cn/open-platform/integration.md): 接入前由平台管理员登记应用类型、精确回调和最小 scope。先完成 OIDC 用户授权，再按实际需要启用签名 API 或通知。三种凭据的区别与数据边界见技术概览；本文依据 identity/server/protocols.ts、oidc.ts、open-api.ts 说明当前契约。 ## 星线智联 微信小程序、手机确认流程、受控入口和发布验收。 - [星线智联技术概览](https://document.thestarline.cn/zhilian/overview.md): 星线智联是用于确认星线账户网页登录请求的微信小程序。它在手机微信中核对发起站点、浏览器和两位核对码，由用户主动确认或取消，再由原浏览器领取结果。工程位于 identity/mini-program/，后端桥接位于 identity/server/wechat-mobile.ts。资料依据 2026 年 10 月 23 日源码与实施记录整理；联调与发布工作仍处于暂停状态。 - [星线智联接入流程](https://document.thestarline.cn/zhilian/integration.md): 智联的接入方是 Account 原浏览器及固定微信小程序，不是任意第三方登录 SDK。所有后端路由使用 https://account.thestarline.cn，路径前缀为 /api/providers/wechat/mobile。资料依据 2026 年 10 月 23 日 identity/server/protocols.ts、wechat-mobile.ts 和 identity/mini-program/lib/ 整理；目前联调暂停、开发上传未审核，完整流程仍待验收。 ## 星企 组织、成员、频道、待办、公告与企业客户端。 - [星企技术概览](https://document.thestarline.cn/xingqi/overview.md): 星企是独立的企业协作客户端，拥有 iOS、Android 工程，与星线 App共享聊天服务的账户映射与部分基础设施。企业 API 位于 chat-service/src/enterprise-routes.mjs，并不因此成为星线 App 的前台功能。资料依据 2026 年 10 月 23 日源码整理；两端界面仍标记开发预览，正式企业服务及商店发布不能由源码或本机样例推定。 - [星企接口与客户端接入](https://document.thestarline.cn/xingqi/integration.md): 星企业务接口由共享聊天服务提供，正式目标来源配置为 https://chat.thestarline.cn。请求使用聊天服务签发的 Bearer 会话，企业范围写入路由路径。不要使用 Account Cookie、OIDC Access Token 或开放平台 HMAC 密钥直接调用企业路由。模块边界见技术概览。 ## 星线云 云产品展示、控制台、账号会话及资源能力边界。 - [星线云技术概览](https://document.thestarline.cn/cloud/overview.md): 星线云包含公开产品页面、资源配置与风险提示、本机演示控制台，以及接入 Account 的服务端登录适配层。登录会话与演示资源是两套独立状态：取得身份不代表已经购买、创建或接管真实云服务器。 ## 星线 Email 邮箱服务、管理接口、IMAP、SMTP 与投递运维。 - [星线 Email 技术概览](https://document.thestarline.cn/email/overview.md): 星线 Email 提供公开邮箱入口、工作空间域名与邮箱管理、网页收发信和管理功能。网页服务负责身份、权限和元数据，邮件协议与邮箱内容由 Mailu、IMAP 和 SMTP 链路承载；网页可打开不等于邮件已能送达外部收件人。 ## 星线 Pay 支付接入、订单、回调、幂等与商户配置。 - [星线 Pay 技术概览](https://document.thestarline.cn/pay/overview.md): 星线 Pay 当前包含公开介绍页面与独立的微信支付 Native 后端。后端可以按服务端商品表创建支付订单、核验通知和主动对账；公开页面中的登录、注册地区引导尚未形成用户支付操作闭环。 ## 星线 Trade 模拟行情、地区选择与当前实现范围。 - [Starline Trade 技术概览](https://document.thestarline.cn/trade/overview.md): Trade 当前是带模拟 K 线背景的静态产品页面。图形数据在浏览器本地生成，登录和注册入口进入地区选择及暂不可用提示；当前源码没有接入真实行情、交易账户或订单执行服务。 ## 星线游戏 游戏展示页、渲染资源及浏览器兼容。 - [星线游戏技术概览](https://document.thestarline.cn/game/overview.md): 星线游戏当前源码实现一张带 WebGL 局部动态效果的视觉首页，提供暂停、关于和沉浸预览。它还不是可运行的网络游戏、VR游戏或游戏发行平台；页面图像属于视觉创作，不是黑洞物理模拟或观测视频。 ## 星线社 商品目录、站点结构及交易功能的实现范围。 - [星线社技术概览](https://document.thestarline.cn/shop/overview.md): 星线社是面向实物商品的静态展示与咨询入口。当前商品数组为空，页面只保留品牌和联系内容；源码保留的搜索、详情和咨询清单组件，不代表当前已有商品可购买或已经形成电商订单系统。 ## 星线官网与建站 公司官网、建站入口、开发服务与静态发布。 - [星线官网技术概览](https://document.thestarline.cn/website/overview.md): 星线官网是公司介绍、云产品和网站/App开发服务的静态入口，并通过页脚连接其他公开产品与政策站点。官网里的产品链接说明入口关系，不代表被链接服务的全部能力已经上线或通过验收。 ## 星职 职位、招聘账号、申请、简历文件与通知任务。 - [星职技术概览](https://document.thestarline.cn/careers/overview.md): 星职是职位发布、候选人投递、HR 初筛和管理员复核的招聘系统。当前流程覆盖录用与拒绝状态；面试排期、面试通知日历或自动入职办理不在已实现范围内。 ## 星线 Support 帮助资料、搜索、回电申请与支持站维护。 - [星线支持中心技术概览](https://document.thestarline.cn/support/overview.md): 支持中心由静态帮助文章、浏览器搜索、地区选择和回电申请组成。文章阅读不要求登录；回电申请另由独立接收服务校验并持久写入待处理队列。申请已接收不等于电话已拨出，也不承诺自动回电时间。 ## 星线法律 协议与法律文件的组织、版本和公开访问。 - [星线法律中心技术概览](https://document.thestarline.cn/legal/overview.md): 法律中心是独立的静态文档站，提供网站条款、账号条款、知识产权与投诉说明、联系信息和旧地址迁移。它与隐私中心共用内容生成及本地化机制，正式政策内容以公开页面为准；本技术文档不修改条款或代替法律审阅。 ## 星线隐私 各产品隐私文件、数据范围与政策发布。 - [星线隐私中心技术概览](https://document.thestarline.cn/privacy/overview.md): 隐私中心提供网站与账号、星线 App、星企三类隐私说明，以及同语种下载、打印和发送邮件副本。政策正文为静态文件；邮件副本由独立服务读取已发布文本发送，不依赖用户登录 Account，也不导出任何用户账户资料。