欢迎使用文档站

这篇文档演示了三件事：原稿在 src/、成品在 pages/、附件在 files/，可达性按前缀一刀切；
壳可按集合指定；正文内链自动改写。

快速开始

1. 上传 md 或 html 原稿（扩展名决定解析方式，见下表）
2. 建一条集合路由：源目录 → 输出目录 → 壳
3. 访问 /docs/ —— 目录页、正文、上下篇自动生成

格式说明

HTML 原稿与成品不会互相覆盖，是因为它们分处 src/ 与 pages/ 两个前缀 ——
这套设计里可达性只看前缀，不看扩展名。旧版让原稿与成品同前缀时，
a.html 原稿会被自己的成品覆盖，而且裸原稿会被直出、壳永久不生效。

图片与内链

下面的图片来自附件前缀 files/（不是原稿前缀）：

• 格式与占位符演示
• HTML 原稿演示
• 回目录：使用手册 —— 这种跨前缀写法不会被改写，保留原样

想验证是否真「命中直出」

刷新两次同一个页面，看响应头：第一次有 X-Doc: render（按需渲染并写回成品），第二次没有（直读成品）。
X-Doc-Shell: <壳id>/<来源> 会一直显示当前用的是哪个壳、来源是单篇还是集合还是默认 ——
「改了壳却没生效」必须是肉眼可见的，不能静默。