# 为读取与引用设计，不伪装成一套 API。

> 面向搜索引擎、智能代理、RSS 阅读器和开发者的公开资源、协议行为与能力边界。

Canonical: https://xiyu.im/developer

## 可用资源

本站的公开机器接口以读取为主：sitemap.xml 用于发现规范页面，rss/feed.xml 用于跟踪更新，llms.txt 提供精简导航，llms-full.txt 提供更完整的站点说明，agent-instructions.txt 说明自动化使用边界。首页、关于、联系、隐私和本页还提供显式 .md 地址；对这些页面发送 Accept: text/markdown，也会在同一个 URL 返回 Markdown。

内容协商遵循 HTTP Accept 质量权重。服务器会在可接受的 text/html 与 text/markdown 中选择质量最高的表示，在权重相同时尊重客户端顺序，并通过 Vary: Accept, Accept-Encoding 防止缓存混淆。如果客户端明确拒绝本站能够生成的两种表示，响应为 406 Not Acceptable。直接访问 .md 地址始终返回 text/markdown; charset=utf-8。

## 目前没有的能力

xiyu.im 目前没有公开 REST API、GraphQL API、MCP 服务、OAuth 流程、API Key、Webhook、写入端点、用户数据导出接口或服务状态承诺。站内搜索是面向读者的内容检索，不应被描述成通用开发者 API。不存在的能力会在这里明确写成“不提供”，而不是发布空白文档、虚构鉴权方式或让客户端猜测端点。

如果未来增加真正的程序化能力，本页会列出基础地址、版本、鉴权、速率限制、错误格式、隐私影响和变更记录。在那之前，请只读取已公开的网页、Markdown、RSS 和站点地图，并为请求使用合理缓存与速率。文章内容可以被引用和摘要，但仍需保留来源链接、时间语境、判断条件和版权边界。

## Links

- [llms.txt](https://xiyu.im/llms.txt) — 精简的 Agent 导航
- [llms-full.txt](https://xiyu.im/llms-full.txt) — 完整站点语境
- [agent-instructions.txt](https://xiyu.im/agent-instructions.txt) — 自动化使用边界
- [sitemap.xml](https://xiyu.im/sitemap.xml) — 规范 URL 索引
- [RSS feed](https://xiyu.im/rss/feed.xml) — 文章更新订阅
- [Home.md](https://xiyu.im/index.md) — 首页 Markdown

## Site navigation

- [Home](https://xiyu.im/)
- [Archive](https://xiyu.im/archive)
- [Sitemap](https://xiyu.im/sitemap.xml)
- [Agent guide](https://xiyu.im/llms.txt)
- [Developer resources](https://xiyu.im/developer)