From e66148a75ccc1620f18bdbe741c3513231840dd4 Mon Sep 17 00:00:00 2001
From: snowy-yang <102860110+snowy-yang@users.noreply.github.com>
Date: Thu, 24 Sep 2026 21:51:40 +0800
Subject: [PATCH] =?UTF-8?q?fix:=20=E6=96=87=E6=A1=A3=E7=AB=99=E5=AD=90?=
 =?UTF-8?q?=E9=A1=B5=E9=9D=A2=E5=B7=A6=E4=BE=A7=E7=9B=AE=E5=BD=95=E4=B8=8D?=
 =?UTF-8?q?=E5=8A=A0=E8=BD=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

docsify 进子目录路由会先请求 <目录>/_sidebar.md，失败（404）才回退根
目录；Cloudflare Pages 无 404.html 时对缺失路径 SPA 回退返回 index.html
且状态 200，docsify 把 HTML 当侧栏 Markdown 解析，左侧目录卡在加载中。
alias 将 docs/、examples/ 的 _sidebar.md 请求映射回根目录 _sidebar.md。
---
 CHANGELOG.md | 1 +
 index.html   | 5 +++++
 2 files changed, 6 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 99eedf1..e6173f4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -58,6 +58,7 @@
 - token 请求失败时抛出 `TokenError`（携带 QQ 返回的 `code`/`message`），不再抛出掩盖真实原因的 `KeyError: 'access_token'`
 - 修正被动回复 `event_id` 的指引：官方要求取网关帧最外层的 id（`Event.event_id`），事件体里的裸 UUID（`Interaction.id` 等）不能作 `event_id`，此前文档与 docstring 的说法有误
 - 响应 `Content-Type` 非 JSON 时不再抛 `ContentTypeError`（个别接口如回应互动返回 200 text/plain + `{}` body）；JSON 解析统一切换 ujson
+- 文档站点子页面左侧目录不加载：docsify 进入子目录页面会先请求 `<目录>/_sidebar.md`、请求失败才回退根目录，而 Cloudflare Pages 对缺失路径回退返回 `index.html`（状态 200），侧栏被当作 Markdown 解析成空白；`index.html` 的 alias 现将 `docs/`、`examples/` 的 `_sidebar.md` 请求映射回根目录
 
 ## [0.1.0] - 2026-09-14
 
diff --git a/index.html b/index.html
index 8c3fd60..c676f85 100644
--- a/index.html
+++ b/index.html
@@ -50,6 +50,11 @@
       alias: {
         '/examples': '/examples/README.md',
         '/examples/': '/examples/README.md',
+        // 子目录页面的 _sidebar.md 请求映射到根目录的：
+        // docsify 会先请求 <当前目录>/_sidebar.md，而 Cloudflare Pages 对
+        // 缺失文件回退 index.html 且状态 200，docsify 误当作侧栏解析导致目录空白
+        '/docs/_sidebar.md': '/_sidebar.md',
+        '/examples/_sidebar.md': '/_sidebar.md',
       },
       plugins: [
         // 把 ```mermaid 代码块替换为 div 后交给 mermaid 渲染（架构图/时序图）