为读取与引用设计,不伪装成一套 API。
面向搜索引擎、智能代理、RSS 阅读器和开发者的公开资源、协议行为与能力边界。
可用资源
本站的公开机器接口以读取为主: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 和站点地图,并为请求使用合理缓存与速率。文章内容可以被引用和摘要,但仍需保留来源链接、时间语境、判断条件和版权边界。