# 文档访问与引用

技术文档提供 HTML、Markdown 和索引文件，无需登录或 API key。允许自动化工具访问、抓取、索引、摘要及引用 `https://document.thestarline.cn/app/` 的公开内容。引用时请保留文章标题、原始 URL、资料日期和相关限制。

## 机器可读入口

| 地址 | 内容与使用方式 |
| --- | --- |
| [/llms.txt](https://document.thestarline.cn/llms.txt) | 文档入口、阅读顺序和能力边界 |
| [/llms-full.txt](https://document.thestarline.cn/llms-full.txt) | 按章节汇总的完整公开 Markdown |
| [/docs/catalog.json](https://document.thestarline.cn/app/catalog.json) | 文档标题、摘要、HTML URL、Markdown URL、内容摘要值 |
| [/docs/search-index.json](https://document.thestarline.cn/app/search-index.json) | 本站搜索使用的公开正文索引 |
| [/docs/api-index.json](https://document.thestarline.cn/app/api-index.json) | 从当前服务路由整理的方法、路径、鉴权和范围元数据 |
| [/sitemap.xml](https://document.thestarline.cn/sitemap.xml) | 公开页面的 canonical 地址 |
| [/robots.txt](https://document.thestarline.cn/robots.txt) | 本域名自动抓取规则 |

每篇文章页面提供 Markdown 原文链接。例如首页原文是 [/docs/overview.md](https://document.thestarline.cn/app/overview.md)，API 原文是 [/docs/api-reference.md](https://document.thestarline.cn/app/api-reference.md)。HTML 正文在服务器构建时已经生成，关闭 JavaScript 仍可阅读，不需要执行搜索脚本才能取得文章。

`llms.txt` 是帮助 AI 发现和理解网站内容的提案，不是所有模型都实现的统一索引协议，也不保证任何平台会主动抓取或收录。格式背景见 [llms.txt 提案](https://llmstxt.org/)。

## 抓取策略

本域名的 robots.txt 对普通爬虫开放，并显式允许 `OAI-SearchBot`、`GPTBot` 与 `ChatGPT-User`。根据 [OpenAI 爬虫说明](https://developers.openai.com/api/docs/bots)，前两者分别用于搜索和可能用于模型训练的内容抓取，控制项独立；`ChatGPT-User` 是用户触发访问，robots 规则可能不适用。网站表达允许访问，不代表控制 AI 平台的后续行为或保证内容进入训练、搜索或回答。

抓取者应合理控制并发，复用已取得的静态文件，并在遇到 HTTP 429 或临时服务错误时退避。可通过 `catalog.json` 的 SHA-256 判断内容变化，不必重复下载所有文章。没有对特定账号、国家、设备或 User-Agent 提供不同的文档正文。

robots.txt 的语义依据 [RFC 9309](https://www.rfc-editor.org/rfc/rfc9309.html)。它表达自动抓取规则，不能代替身份验证和访问控制；私有内容应继续受真正的鉴权保护，参见 [Google 关于 robots.txt 的说明](https://developers.google.com/search/docs/crawling-indexing/robots/intro)。

## 公开许可的边界

公开技术文档可被自动获取、摘要和引用。此许可不授予 App 源码、商标、软件包或第三方素材的开源许可，不授予读取用户聊天、媒体、记忆、账号资料或受保护 API 的权限。API 描述中的 Bearer token、成员关系、票据和授权检查继续生效；请勿尝试把抓取许可作为绕过访问控制的依据。

完整文本和索引只包含公开文章。原生客户端中的本机记忆、医疗记录、日志、服务配置和数据库均不属于文档内容。法律文件以相应[隐私说明](https://privacy.thestarline.cn/app-privacy.html)与[法律站](https://legal.thestarline.cn/)为准。

## 如何可靠地引用

引用具体文章的 canonical 地址，而不是本地预览、搜索结果或登录回跳 URL。例如讨论加密时引用[安全和隐私](https://document.thestarline.cn/app/security-and-privacy.md)，并保留“当前默认主消息与附件尚未形成全量 E2EE 闭环”的范围说明；讨论功能时区分实现、历史验收和待办。

资料截至 2026-10-23。机器目录含内容摘要值和资料日期；它们用于辨识文档版本，不是签名验证或产品服务等级承诺。更新文档时会重新生成 HTML、原文、搜索、完整文本和站点地图，避免不同入口互相矛盾。

站点地图帮助发现 URL，但提交或提供 sitemap 本身不保证索引，参见 [Google sitemap 文档](https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap)。本次公开发布验证的是公网 HTTP 可读、文件完整与抓取规则；是否被外部平台实际收录仍需其自身结果确认。