Evil Martians:让技术文档与网页更易获 AI 检索
2026-11-05Evil Martians约 1 分钟阅读
文献归档与全文阅读 • 本地全文存档
Evil Martians 实操手册:设计对 AI Agent 友好的技术文档
Claude Code、Cursor 等编程 Agent 在日常开发工作流中会动态拉取在线技术文档。Evil Martians 团队结合工程实践,梳理了一套面向开发类 Agent 的技术文档托管与响应规范。
一、Markdown 优先的内容协商机制
编程 Agent 抓取网页时,会在请求头(Header)中主动传入 Accept: text/markdown。为文档站点配置无页面外壳的纯 Markdown 响应出口,能减少解析错误并节省上下文额度。
二、Link Alternate 物理声明
为了让爬虫在抓取 HTML 时立即发现对应的 Markdown 精简版路径,可在页面 <head> 中添加 alternate 声明:
TEXT1 行
| 1 | <link rel="alternate" type="text/markdown" href="/docs/guide.md" /> |
前沿文献
觉得本文有启发?一键复制标准引用摘要
自带原文归因链接与核心摘要,可直接粘贴至团队飞书/Slack 知识库、技术周报或大模型上下文。