fix: remove .md suffix from all internal Docusaurus links

JusterZhu · claude · JusterZhu · commit 990947699c1b · 2026-06-04T11:34:37.000+08:00
Docusaurus resolves internal doc links without the .md extension.
Links with .md suffix break when the target document's i18n override
is removed (Docusaurus falls back to docs/ but can't match the .md suffix).

This was pre-existing but masked by zh-Hans i18n overrides for Core and
Differential docs.

Co-Authored-By: Claude Opus 4.8 &lt;noreply@anthropic.com&gt;
diff --git a/website/docs/doc/GeneralUpdate.Bowl.md b/website/docs/doc/GeneralUpdate.Bowl.md
@@ -417,4 +417,4 @@ MyApp/
 
 - [Bowl 示例代码](https://github.com/GeneralLibrary/GeneralUpdate-Samples/tree/main/src/Bowl)
 - [GeneralUpdate 仓库](https://github.com/GeneralLibrary/GeneralUpdate)
-- [Dump 指南](../guide/Dump.md)
+- [Dump 指南](../guide/Dump)
diff --git a/website/docs/doc/GeneralUpdate.Core.md b/website/docs/doc/GeneralUpdate.Core.md
@@ -1010,5 +1010,5 @@ var failedVersion = Environments.Get("UpgradeFail");
 - [GeneralUpdate 仓库](https://github.com/GeneralLibrary/GeneralUpdate)
 - [Samples 示例代码](https://github.com/GeneralLibrary/GeneralUpdate-Samples)
 - [GeneralUpdate.Tools](https://github.com/GeneralLibrary/GeneralUpdate.Tools)
-- [入门实战手册](../quickstart/Beginner%20cookbook.md)
-- [组件文档](./GeneralUpdate.Core.md)
+- [入门实战手册](../quickstart/Beginner%20cookbook)
+- [组件文档](./GeneralUpdate.Core)
diff --git a/website/docs/doc/GeneralUpdate.Differential.md b/website/docs/doc/GeneralUpdate.Differential.md
@@ -363,5 +363,5 @@ await new GeneralUpdateBootstrap()
 
 - [GeneralUpdate 仓库](https://github.com/GeneralLibrary/GeneralUpdate)
 - [Samples 差分示例](https://github.com/GeneralLibrary/GeneralUpdate-Samples/tree/main/src/Hub/Samples/DifferentialSample.cs)
-- [Core DiffPipeline 文档](GeneralUpdate.Core.md)
-- [Tools 打包指南](../guide/Packaging.md)
+- [Core DiffPipeline 文档](GeneralUpdate.Core)
+- [Tools 打包指南](../guide/Packaging)
diff --git a/website/docs/doc/GeneralUpdate.Drivelution.md b/website/docs/doc/GeneralUpdate.Drivelution.md
@@ -554,4 +554,4 @@ GeneralTracer.SetTracingEnabled(true);
 
 - [驱动更新示例](https://github.com/GeneralLibrary/GeneralUpdate-Samples/tree/main/src/Hub/Samples/ImDiskQuickInstallSample.cs)
 - [GeneralUpdate 仓库](https://github.com/GeneralLibrary/GeneralUpdate)
-- [GeneralUpdate.Drivelution 组件文档](../doc/GeneralUpdate.Drivelution.md)
+- [GeneralUpdate.Drivelution 组件文档](../doc/GeneralUpdate.Drivelution)
diff --git a/website/docs/doc/GeneralUpdate.Extension.md b/website/docs/doc/GeneralUpdate.Extension.md
@@ -676,4 +676,4 @@ report-extension_1.0.0.zip
 
 - [扩展管理示例](https://github.com/GeneralLibrary/GeneralUpdate-Samples/tree/main/src/Hub/Samples/ExtensionSample.cs)
 - [GeneralUpdate 仓库](https://github.com/GeneralLibrary/GeneralUpdate)
-- [打包指南](../guide/Packaging.md)
+- [打包指南](../guide/Packaging)
diff --git a/website/docs/doc/UpgradeHub.md b/website/docs/doc/UpgradeHub.md
@@ -363,4 +363,4 @@ await new GeneralClientBootstrap()
 
 - **示例代码：** [查看 GitHub 示例](https://github.com/GeneralLibrary/GeneralUpdate-Samples/blob/main/src/Push/Program.cs)
 - **主仓库：** [GeneralUpdate 项目](https://github.com/GeneralLibrary/GeneralUpdate)
-- **相关组件：** [GeneralUpdate.Core](./GeneralUpdate.Core.md) | [GeneralUpdate.Core](./GeneralUpdate.Core.md)
+- **相关组件：** [GeneralUpdate.Core](./GeneralUpdate.Core) | [GeneralUpdate.Core](./GeneralUpdate.Core)
diff --git a/website/docs/guide/FAQ.md b/website/docs/guide/FAQ.md
@@ -332,7 +332,7 @@ await new GeneralClientBootstrap()
 
 ## 相关资源
 
-- **[GeneralUpdate.Core](../doc/GeneralUpdate.Core.md)** — 核心更新引擎
-- **[入门实战手册](../quickstart/Beginner%20cookbook.md)** — 从零跑通更新闭环
-- **[GeneralUpdate.Tools](../quickstart/GeneralUpdate.PacketTool.md)** — 打包工具
-- **[GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl.md)** — 崩溃监控与回滚
+- **[GeneralUpdate.Core](../doc/GeneralUpdate.Core)** — 核心更新引擎
+- **[入门实战手册](../quickstart/Beginner%20cookbook)** — 从零跑通更新闭环
+- **[GeneralUpdate.Tools](../quickstart/GeneralUpdate.PacketTool)** — 打包工具
+- **[GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl)** — 崩溃监控与回滚
diff --git a/website/docs/guide/Packaging.md b/website/docs/guide/Packaging.md
@@ -120,7 +120,7 @@ await new GeneralUpdateBootstrap()
 **避免 C 盘权限问题：**
 
 - 建议默认安装到 `%LOCALAPPDATA%` 而非 `C:\Program Files\`
-- 如必须安装在 C 盘，参考 [权限指南](./Permission.md) 配置注册表降权
+- 如必须安装在 C 盘，参考 [权限指南](./Permission) 配置注册表降权
 
 **Windows 发布命令：**
 
@@ -280,6 +280,6 @@ jobs:
 ## 相关资源
 
 - **[GeneralUpdate.Tools](../quickstart/GeneralUpdate.PacketTool)** — 补丁包和配置生成工具
-- **[权限指南](./Permission.md)** — Windows UAC 权限处理
-- **[入门实战手册](../quickstart/Beginner%20cookbook.md)** — 从零跑通更新闭环
-- **[GeneralUpdate.Core](../doc/GeneralUpdate.Core.md)** — 核心更新引擎架构
+- **[权限指南](./Permission)** — Windows UAC 权限处理
+- **[入门实战手册](../quickstart/Beginner%20cookbook)** — 从零跑通更新闭环
+- **[GeneralUpdate.Core](../doc/GeneralUpdate.Core)** — 核心更新引擎架构
diff --git a/website/docs/quickstart/Beginner cookbook.md b/website/docs/quickstart/Beginner cookbook.md
@@ -11,12 +11,12 @@ title: 入门实战手册
 
 | 角色 | 在样例中的位置 | 负责什么 | 深入阅读 |
 | --- | --- | --- | --- |
-| Hub | `src\Hub` | 交互式示例浏览器，通过菜单选择并运行各类更新场景 | [GeneralUpdate.Core](../doc/GeneralUpdate.Core.md) |
-| Server | `src\Server` | 返回版本信息、接收更新报告、提供补丁下载 | [GeneralUpdate.Core](../doc/GeneralUpdate.Core.md) |
-| Packet | `src\Server\wwwroot\packages` | 可下载的 `.zip` 更新包和 `versions.json` 元数据 | [GeneralUpdate.Tools](./GeneralUpdate.PacketTool.md) |
-| Tools | GeneralUpdate.Tools 仓库 | 生成补丁包、Hash、OSS 清单、manifest 和仿真报告 | [GeneralUpdate.Tools](./GeneralUpdate.PacketTool.md) |
-| Bowl | Hub Samples 中集成 | 监控进程异常并导出失败信息 | [GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl.md) |
-| Differential | Hub Samples + Core 默认集成 | 对 old/new 文件生成差分，并在更新阶段应用 | [GeneralUpdate.Differential](../doc/GeneralUpdate.Differential.md) |
+| Hub | `src\Hub` | 交互式示例浏览器，通过菜单选择并运行各类更新场景 | [GeneralUpdate.Core](../doc/GeneralUpdate.Core) |
+| Server | `src\Server` | 返回版本信息、接收更新报告、提供补丁下载 | [GeneralUpdate.Core](../doc/GeneralUpdate.Core) |
+| Packet | `src\Server\wwwroot\packages` | 可下载的 `.zip` 更新包和 `versions.json` 元数据 | [GeneralUpdate.Tools](./GeneralUpdate.PacketTool) |
+| Tools | GeneralUpdate.Tools 仓库 | 生成补丁包、Hash、OSS 清单、manifest 和仿真报告 | [GeneralUpdate.Tools](./GeneralUpdate.PacketTool) |
+| Bowl | Hub Samples 中集成 | 监控进程异常并导出失败信息 | [GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl) |
+| Differential | Hub Samples + Core 默认集成 | 对 old/new 文件生成差分，并在更新阶段应用 | [GeneralUpdate.Differential](../doc/GeneralUpdate.Differential) |
 
 ## Step 1：准备仓库和运行环境
 
@@ -239,11 +239,11 @@ Hub 提供了 9 个内置样例，覆盖了 GeneralUpdate 的主要使用场景
 
 跑通这条链路后，建议按顺序阅读：
 
-1. [GeneralUpdate.Core](../doc/GeneralUpdate.Core.md)：更新策略、事件通知、静默更新、manifest 极简配置。
-2. [GeneralUpdate.Tools](./GeneralUpdate.PacketTool.md)：补丁包、Hash、OSS Config、Simulation。
-3. [GeneralUpdate.Differential](../doc/GeneralUpdate.Differential.md)：差分算法、并行处理和 Clean/Dirty。
-4. [GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl.md)：崩溃监控、备份和失败恢复。
-5. [GeneralUpdate.Tools](./GeneralUpdate.PacketTool.md)：补丁包、Hash、OSS Config、Simulation。
+1. [GeneralUpdate.Core](../doc/GeneralUpdate.Core)：更新策略、事件通知、静默更新、manifest 极简配置。
+2. [GeneralUpdate.Tools](./GeneralUpdate.PacketTool)：补丁包、Hash、OSS Config、Simulation。
+3. [GeneralUpdate.Differential](../doc/GeneralUpdate.Differential)：差分算法、并行处理和 Clean/Dirty。
+4. [GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl)：崩溃监控、备份和失败恢复。
+5. [GeneralUpdate.Tools](./GeneralUpdate.PacketTool)：补丁包、Hash、OSS Config、Simulation。
 
 ## Sample UI
 
diff --git a/website/docs/quickstart/GeneralUpdate.PacketTool.md b/website/docs/quickstart/GeneralUpdate.PacketTool.md
@@ -144,7 +144,7 @@ dotnet run --project GeneralUpdate.Tools.csproj
 
 - Extension Host 调用 `ExtensionManager.QueryRemoteExtensionsAsync(...)` 获取扩展列表
 - 安装时下载 ZIP，读取 `manifest.json` 进行兼容性检查和依赖解析
-- 详见 [GeneralUpdate.Extension](../doc/GeneralUpdate.Extension.md)
+- 详见 [GeneralUpdate.Extension](../doc/GeneralUpdate.Extension)
 
 ---
 
@@ -189,7 +189,7 @@ dotnet run --project GeneralUpdate.Tools.csproj
 
 - 将 `oss_config.json` 上传到 OSS bucket 或静态文件服务器
 - OSS 客户端读取此文件发现可用版本，下载后校验 Hash
-- 详见 [GeneralUpdate.Core](../doc/GeneralUpdate.Core.md) OSS 更新策略
+- 详见 [GeneralUpdate.Core](../doc/GeneralUpdate.Core) OSS 更新策略
 
 ---
 
@@ -349,7 +349,7 @@ Generate Sample 额外输出：
 
 ## 关联文档
 
-- [GeneralUpdate.Core](../doc/GeneralUpdate.Core.md)：Client/Upgrade 更新主流程
-- [GeneralUpdate.Differential](../doc/GeneralUpdate.Differential.md)：差分算法 Clean/Dirty 模式
-- [GeneralUpdate.Extension](../doc/GeneralUpdate.Extension.md)：扩展包安装与版本管理
-- [入门实战手册](./Beginner%20cookbook.md)：从零跑通完整更新闭环
+- [GeneralUpdate.Core](../doc/GeneralUpdate.Core)：Client/Upgrade 更新主流程
+- [GeneralUpdate.Differential](../doc/GeneralUpdate.Differential)：差分算法 Clean/Dirty 模式
+- [GeneralUpdate.Extension](../doc/GeneralUpdate.Extension)：扩展包安装与版本管理
+- [入门实战手册](./Beginner%20cookbook)：从零跑通完整更新闭环
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Bowl.md b/website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Bowl.md
@@ -362,4 +362,4 @@ MyApp/
 
 - [Bowl Sample Code](https://github.com/GeneralLibrary/GeneralUpdate-Samples/tree/main/src/Bowl)
 - [GeneralUpdate Repository](https://github.com/GeneralLibrary/GeneralUpdate)
-- [Dump Guide](../guide/Dump.md)
+- [Dump Guide](../guide/Dump)
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Core.md b/website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Core.md
@@ -667,5 +667,5 @@ GeneralTracer.Dispose();
 - [GeneralUpdate Repository](https://github.com/GeneralLibrary/GeneralUpdate)
 - [Samples Code](https://github.com/GeneralLibrary/GeneralUpdate-Samples)
 - [GeneralUpdate.Tools](https://github.com/GeneralLibrary/GeneralUpdate.Tools)
-- [Beginner Cookbook](../quickstart/Beginner%20cookbook.md)
-- [Component docs](./GeneralUpdate.Core.md)
+- [Beginner Cookbook](../quickstart/Beginner%20cookbook)
+- [Component docs](./GeneralUpdate.Core)
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Differential.md b/website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Differential.md
@@ -287,5 +287,5 @@ await new GeneralUpdateBootstrap()
 
 - [GeneralUpdate Repository](https://github.com/GeneralLibrary/GeneralUpdate)
 - [Differential Sample](https://github.com/GeneralLibrary/GeneralUpdate-Samples/tree/main/src/Hub/Samples/DifferentialSample.cs)
-- [Core DiffPipeline Docs](GeneralUpdate.Core.md)
-- [Packaging Guide](../guide/Packaging.md)
+- [Core DiffPipeline Docs](GeneralUpdate.Core)
+- [Packaging Guide](../guide/Packaging)
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Drivelution.md b/website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Drivelution.md
@@ -354,4 +354,4 @@ GeneralTracer.SetTracingEnabled(true);   // Re-enable for troubleshooting
 
 - [Driver Update Sample](https://github.com/GeneralLibrary/GeneralUpdate-Samples/tree/main/src/Hub/Samples/ImDiskQuickInstallSample.cs)
 - [GeneralUpdate Repository](https://github.com/GeneralLibrary/GeneralUpdate)
-- [GeneralUpdate.Drivelution docs](../doc/GeneralUpdate.Drivelution.md)
+- [GeneralUpdate.Drivelution docs](../doc/GeneralUpdate.Drivelution)
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Extension.md b/website/i18n/en/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Extension.md
@@ -518,4 +518,4 @@ Per-extension setting > Global setting > Default (false)
 
 - [Extension Management Sample](https://github.com/GeneralLibrary/GeneralUpdate-Samples/tree/main/src/Hub/Samples/ExtensionSample.cs)
 - [GeneralUpdate Repository](https://github.com/GeneralLibrary/GeneralUpdate)
-- [Packaging Guide](../guide/Packaging.md)
+- [Packaging Guide](../guide/Packaging)
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/guide/FAQ.md b/website/i18n/en/docusaurus-plugin-content-docs/current/guide/FAQ.md
@@ -279,7 +279,7 @@ Sample projects provide a simple server example. For production, implement your
 
 ## Related Resources
 
-- **[GeneralUpdate.Core](../doc/GeneralUpdate.Core.md)** — Core update engine
-- **[Beginner Cookbook](../quickstart/Beginner%20cookbook.md)** — Run through the full update loop
-- **[GeneralUpdate.Tools](../quickstart/GeneralUpdate.PacketTool.md)** — Packaging tools
-- **[GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl.md)** — Crash monitoring & rollback
+- **[GeneralUpdate.Core](../doc/GeneralUpdate.Core)** — Core update engine
+- **[Beginner Cookbook](../quickstart/Beginner%20cookbook)** — Run through the full update loop
+- **[GeneralUpdate.Tools](../quickstart/GeneralUpdate.PacketTool)** — Packaging tools
+- **[GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl)** — Crash monitoring & rollback
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/guide/Packaging.md b/website/i18n/en/docusaurus-plugin-content-docs/current/guide/Packaging.md
@@ -110,7 +110,7 @@ await new GeneralUpdateBootstrap()
 - [NSIS Download](https://nsis.sourceforge.io/Download)
 - Place main app and upgrade assistant in the same directory
 - Default install to `%LOCALAPPDATA%` to avoid C drive permission issues
-- For C drive installs, see [Permission Guide](./Permission.md)
+- For C drive installs, see [Permission Guide](./Permission)
 
 ```bash
 dotnet publish src/MyApp/MyApp.csproj -c Release -r win-x64 --self-contained
@@ -216,6 +216,6 @@ Before deploying, verify:
 ## Related Resources
 
 - **[GeneralUpdate.Tools](../quickstart/GeneralUpdate.PacketTool)** — Patch and config generation tool
-- **[Permission Guide](./Permission.md)** — Windows UAC permission handling
-- **[Beginner Cookbook](../quickstart/Beginner%20cookbook.md)** — Complete update walkthrough
-- **[GeneralUpdate.Core](../doc/GeneralUpdate.Core.md)** — Core update engine architecture
+- **[Permission Guide](./Permission)** — Windows UAC permission handling
+- **[Beginner Cookbook](../quickstart/Beginner%20cookbook)** — Complete update walkthrough
+- **[GeneralUpdate.Core](../doc/GeneralUpdate.Core)** — Core update engine architecture
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/quickstart/Beginner cookbook.md b/website/i18n/en/docusaurus-plugin-content-docs/current/quickstart/Beginner cookbook.md
@@ -11,12 +11,12 @@ This cookbook is for first-time GeneralUpdate users. The goal is not to explain
 
 | Role | Sample location | Responsibility | Deep dive |
 | --- | --- | --- | --- |
-| Hub | `src\Hub` | Interactive sample browser; run update scenarios via menu | [GeneralUpdate.Core](../doc/GeneralUpdate.Core.md) |
-| Server | `src\Server` | Returns version metadata, accepts reports, and serves package downloads | [GeneralUpdate.Core](../doc/GeneralUpdate.Core.md) |
-| Packet | `src\Server\wwwroot\packages` | Downloadable `.zip` packages and `versions.json` metadata | [GeneralUpdate.Tools](./GeneralUpdate.PacketTool.md) |
-| Tools | GeneralUpdate.Tools repository | Generates patch packages, hashes, OSS manifests, and simulation reports | [GeneralUpdate.Tools](./GeneralUpdate.PacketTool.md) |
-| Bowl | Integrated in Hub Samples | Monitors process failures and exports failure data | [GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl.md) |
-| Differential | Hub Samples + Core default integration | Generates old/new binary differences and applies them during updates | [GeneralUpdate.Differential](../doc/GeneralUpdate.Differential.md) |
+| Hub | `src\Hub` | Interactive sample browser; run update scenarios via menu | [GeneralUpdate.Core](../doc/GeneralUpdate.Core) |
+| Server | `src\Server` | Returns version metadata, accepts reports, and serves package downloads | [GeneralUpdate.Core](../doc/GeneralUpdate.Core) |
+| Packet | `src\Server\wwwroot\packages` | Downloadable `.zip` packages and `versions.json` metadata | [GeneralUpdate.Tools](./GeneralUpdate.PacketTool) |
+| Tools | GeneralUpdate.Tools repository | Generates patch packages, hashes, OSS manifests, and simulation reports | [GeneralUpdate.Tools](./GeneralUpdate.PacketTool) |
+| Bowl | Integrated in Hub Samples | Monitors process failures and exports failure data | [GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl) |
+| Differential | Hub Samples + Core default integration | Generates old/new binary differences and applies them during updates | [GeneralUpdate.Differential](../doc/GeneralUpdate.Differential) |
 
 ## Step 1: Prepare the repository and runtime
 
@@ -239,11 +239,11 @@ Try running each sample and observe the results in the `mock_app` directory.
 
 After this flow works, read these pages in order:
 
-1. [GeneralUpdate.Core](../doc/GeneralUpdate.Core.md): update strategies, event notifications, silent updates, and manifest-based minimal configuration.
-2. [GeneralUpdate.Tools](./GeneralUpdate.PacketTool.md): patch packages, Hash, OSS Config, and Simulation.
-3. [GeneralUpdate.Differential](../doc/GeneralUpdate.Differential.md): differential algorithms, parallel processing, and Clean/Dirty.
-4. [GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl.md): crash monitoring, backup, and failure recovery.
-5. [GeneralUpdate.Tools](./GeneralUpdate.PacketTool.md): patch packages, Hash, OSS Config, and Simulation.
+1. [GeneralUpdate.Core](../doc/GeneralUpdate.Core): update strategies, event notifications, silent updates, and manifest-based minimal configuration.
+2. [GeneralUpdate.Tools](./GeneralUpdate.PacketTool): patch packages, Hash, OSS Config, and Simulation.
+3. [GeneralUpdate.Differential](../doc/GeneralUpdate.Differential): differential algorithms, parallel processing, and Clean/Dirty.
+4. [GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl): crash monitoring, backup, and failure recovery.
+5. [GeneralUpdate.Tools](./GeneralUpdate.PacketTool): patch packages, Hash, OSS Config, and Simulation.
 
 ## Sample UI
 
diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/quickstart/GeneralUpdate.PacketTool.md b/website/i18n/en/docusaurus-plugin-content-docs/current/quickstart/GeneralUpdate.PacketTool.md
@@ -138,7 +138,7 @@ Example `manifest.json`:
 
 - Extension Host calls `ExtensionManager.QueryRemoteExtensionsAsync(...)` to list available extensions
 - On install, downloads the ZIP, reads `manifest.json` for compatibility checks and dependency resolution
-- See [GeneralUpdate.Extension](../doc/GeneralUpdate.Extension.md) for details
+- See [GeneralUpdate.Extension](../doc/GeneralUpdate.Extension) for details
 
 ---
 
@@ -183,7 +183,7 @@ If you use OSS mode updates (static file server), you need to maintain a `versio
 
 - Upload `oss_config.json` to your OSS bucket or static file server
 - OSS client reads this file to discover versions and validates Hash after download
-- See [GeneralUpdate.Core](../doc/GeneralUpdate.Core.md) OSS update strategy
+- See [GeneralUpdate.Core](../doc/GeneralUpdate.Core) OSS update strategy
 
 ---
 
@@ -338,7 +338,7 @@ This sequence chains the six modules into a complete release pipeline:
 
 ## Related docs
 
-- [GeneralUpdate.Core](../doc/GeneralUpdate.Core.md): Client/Upgrade main update flow
-- [GeneralUpdate.Differential](../doc/GeneralUpdate.Differential.md): Differential algorithm Clean/Dirty modes
-- [GeneralUpdate.Extension](../doc/GeneralUpdate.Extension.md): Extension install and version management
-- [Beginner cookbook](./Beginner%20cookbook.md): Complete end-to-end update walkthrough
+- [GeneralUpdate.Core](../doc/GeneralUpdate.Core): Client/Upgrade main update flow
+- [GeneralUpdate.Differential](../doc/GeneralUpdate.Differential): Differential algorithm Clean/Dirty modes
+- [GeneralUpdate.Extension](../doc/GeneralUpdate.Extension): Extension install and version management
+- [Beginner cookbook](./Beginner%20cookbook): Complete end-to-end update walkthrough
diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Bowl.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Bowl.md
@@ -417,4 +417,4 @@ MyApp/
 
 - [Bowl 示例代码](https://github.com/GeneralLibrary/GeneralUpdate-Samples/tree/main/src/Bowl)
 - [GeneralUpdate 仓库](https://github.com/GeneralLibrary/GeneralUpdate)
-- [Dump 指南](../guide/Dump.md)
+- [Dump 指南](../guide/Dump)
diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Drivelution.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Drivelution.md
@@ -554,4 +554,4 @@ GeneralTracer.SetTracingEnabled(true);
 
 - [驱动更新示例](https://github.com/GeneralLibrary/GeneralUpdate-Samples/tree/main/src/Hub/Samples/ImDiskQuickInstallSample.cs)
 - [GeneralUpdate 仓库](https://github.com/GeneralLibrary/GeneralUpdate)
-- [GeneralUpdate.Drivelution 组件文档](../doc/GeneralUpdate.Drivelution.md)
+- [GeneralUpdate.Drivelution 组件文档](../doc/GeneralUpdate.Drivelution)
diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Extension.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/doc/GeneralUpdate.Extension.md
@@ -676,4 +676,4 @@ report-extension_1.0.0.zip
 
 - [扩展管理示例](https://github.com/GeneralLibrary/GeneralUpdate-Samples/tree/main/src/Hub/Samples/ExtensionSample.cs)
 - [GeneralUpdate 仓库](https://github.com/GeneralLibrary/GeneralUpdate)
-- [打包指南](../guide/Packaging.md)
+- [打包指南](../guide/Packaging)
diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guide/FAQ.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guide/FAQ.md
@@ -332,7 +332,7 @@ await new GeneralClientBootstrap()
 
 ## 相关资源
 
-- **[GeneralUpdate.Core](../doc/GeneralUpdate.Core.md)** — 核心更新引擎
-- **[入门实战手册](../quickstart/Beginner%20cookbook.md)** — 从零跑通更新闭环
-- **[GeneralUpdate.Tools](../quickstart/GeneralUpdate.PacketTool.md)** — 打包工具
-- **[GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl.md)** — 崩溃监控与回滚
+- **[GeneralUpdate.Core](../doc/GeneralUpdate.Core)** — 核心更新引擎
+- **[入门实战手册](../quickstart/Beginner%20cookbook)** — 从零跑通更新闭环
+- **[GeneralUpdate.Tools](../quickstart/GeneralUpdate.PacketTool)** — 打包工具
+- **[GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl)** — 崩溃监控与回滚
diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/quickstart/Beginner cookbook.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/quickstart/Beginner cookbook.md
diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/quickstart/GeneralUpdate.PacketTool.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/quickstart/GeneralUpdate.PacketTool.md
