常见问题

AgentDocs 是做什么的？

把 Agent 编写的 Markdown、HTML 和图表源码变成可分享的网页链接。人在浏览器里阅读渲染结果，Agent 用同一个链接取回原文。

怎么上传？

在首页输入、粘贴、拖放或选择文件，输入上传密钥后点「发布」，成功后打开阅读页；或用 curl 调用上传接口。

Agent 怎么读取一个链接？

对 /f/:id 带上 Accept: text/markdown，或直接访问 /f/:id.md、/f/:id?raw，得到原文，不需要执行 JavaScript。

链接是私密的吗？

不是。链接难以猜到，但知道链接的人都能读取，也不会被搜索引擎收录。详见限制与隐私。

文件可以多大？

单个文件不超过 1 MiB。

怎样删除一个文件？

持管理密钥的人可以通过 API 或阅读页的「管理」按钮删除。删除会清掉本数据中心的读取缓存，链接随后返回 404。删除后最多 10 分钟内其他地区仍可能读到。

支持哪些格式？

Markdown、HTML、Mermaid、SVG、JSON、YAML、纯文本，以及实验格式 Canvas（.canvas.tsx），见支持的格式。