配置 GitHub Pages 部署

设置 baseUrl、routeBasePath，修正语言切换和自动跳转路径。

Author: CodFrm

docs/getting-started/quick-start.md

@@ -95,13 +95,13 @@ This works with any OpenAI-compatible API, including self-hosted models.
 
 4. If the command matches a **deny** policy, it will be blocked. If it requires confirmation, you will see a prompt before execution.
 
-All actions are logged in the [Audit Log](/docs/guide/audit) with full decision tracking.
+All actions are logged in the [Audit Log](/guide/audit) with full decision tracking.
 
 ## What's Next
 
-- [Asset Management](/docs/guide/asset-management) — Organize assets into groups, import/export
-- [SSH Terminal](/docs/guide/ssh-terminal) — Split pane, SFTP, jump hosts, port forwarding
-- [AI Agent](/docs/guide/ai-agent) — Provider configuration, tools, policy enforcement
-- [Query Editor](/docs/guide/query-editor) — SQL and Redis query editor
-- [Policy](/docs/guide/policy) — Configure allow/deny rules
-- [Audit](/docs/guide/audit) — Review audit logs and approval workflows
+- [Asset Management](/guide/asset-management) — Organize assets into groups, import/export
+- [SSH Terminal](/guide/ssh-terminal) — Split pane, SFTP, jump hosts, port forwarding
+- [AI Agent](/guide/ai-agent) — Provider configuration, tools, policy enforcement
+- [Query Editor](/guide/query-editor) — SQL and Redis query editor
+- [Policy](/guide/policy) — Configure allow/deny rules
+- [Audit](/guide/audit) — Review audit logs and approval workflows

docs/guide/ai-agent.md

@@ -84,7 +84,7 @@ Every tool call from the AI agent passes through the same policy pipeline as man
 
 The AI agent can proactively call `request_permission` to submit command patterns for batch approval, reducing the number of individual confirmations.
 
-See [Policy Enforcement](/docs/guide/policy) for details on configuring rules.
+See [Policy Enforcement](/guide/policy) for details on configuring rules.
 
 ## AI Coding Tool Integration
 

docs/guide/asset-management.md

@@ -47,7 +47,7 @@ Groups organize assets into a tree hierarchy using parent-child relationships. E
 
 - Create nested groups for environments (e.g., Production > Web Servers)
 - Assets and groups can be reordered via drag-and-drop
-- Groups can have their own [policy configurations](/docs/guide/policy), inherited by child assets
+- Groups can have their own [policy configurations](/guide/policy), inherited by child assets
 
 ## Adding, Editing, and Deleting Assets
 

docs/guide/query-editor.md

@@ -30,7 +30,7 @@ OpsKat uses **TiDB Parser** to analyze SQL statements before execution. This pow
   - `DELETE` or `UPDATE` without a `WHERE` clause
   - `PREPARE` statements
   - `CALL` statements
-- **Policy enforcement** — Statement types and flags are checked against the asset's [query policy](/docs/guide/policy) before execution
+- **Policy enforcement** — Statement types and flags are checked against the asset's [query policy](/guide/policy) before execution
 
 ## Result Tables
 
@@ -70,7 +70,7 @@ The key browser provides a visual interface for exploring Redis data:
 
 ## Policy Enforcement
 
-All queries and commands executed through the Query Editor are subject to the same [policy rules](/docs/guide/policy) as AI Agent operations:
+All queries and commands executed through the Query Editor are subject to the same [policy rules](/guide/policy) as AI Agent operations:
 
 - **SQL** — Checked against the asset's query policy (allowed/denied statement types, dangerous pattern flags)
 - **Redis** — Checked against the asset's Redis policy (allowed/denied command patterns)

docusaurus.config.ts

@@ -15,7 +15,7 @@ const config: Config = {
   },
 
   url: "https://opskat.github.io",
-  baseUrl: "/",
+  baseUrl: "/docs/",
 
   organizationName: "opskat",
   projectName: "docs",
@@ -54,6 +54,7 @@ const config: Config = {
       "classic",
       {
         docs: {
+          routeBasePath: "/",
           sidebarPath: "./sidebars.ts",
           editUrl: "https://github.com/opskat/docs/tree/main/",
         },

i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/quick-start.md

@@ -95,13 +95,13 @@ AI 智能体允许你通过自然语言管理基础设施。使用前需要先
 
 4. 如果命令匹配了**拒绝**策略，将被阻止。如果需要确认，执行前会提示你进行审批。
 
-所有操作都记录在[审计日志](/docs/guide/audit)中，包含完整的决策追踪。
+所有操作都记录在[审计日志](/guide/audit)中，包含完整的决策追踪。
 
 ## 下一步
 
-- [资产管理](/docs/guide/asset-management) — 将资产分组管理、导入/导出
-- [SSH 终端](/docs/guide/ssh-terminal) — 分屏、SFTP、跳板机、端口转发
-- [AI 智能体](/docs/guide/ai-agent) — 提供商配置、工具、策略执行
-- [查询编辑器](/docs/guide/query-editor) — SQL 和 Redis 查询编辑器
-- [策略](/docs/guide/policy) — 配置允许/拒绝规则
-- [审计](/docs/guide/audit) — 查看审计日志和审批工作流
+- [资产管理](/guide/asset-management) — 将资产分组管理、导入/导出
+- [SSH 终端](/guide/ssh-terminal) — 分屏、SFTP、跳板机、端口转发
+- [AI 智能体](/guide/ai-agent) — 提供商配置、工具、策略执行
+- [查询编辑器](/guide/query-editor) — SQL 和 Redis 查询编辑器
+- [策略](/guide/policy) — 配置允许/拒绝规则
+- [审计](/guide/audit) — 查看审计日志和审批工作流

i18n/zh-CN/docusaurus-plugin-content-docs/current/guide/ai-agent.md

@@ -84,7 +84,7 @@ AI 智能体的每次工具调用都会经过与手动操作相同的策略管
 
 AI 智能体可以主动调用 `request_permission` 提交命令模式进行批量审批，减少逐条确认的次数。
 
-详见[策略执行](/docs/guide/policy)了解规则配置。
+详见[策略执行](/guide/policy)了解规则配置。
 
 ## AI 编程工具集成
 

i18n/zh-CN/docusaurus-plugin-content-docs/current/guide/asset-management.md

@@ -47,7 +47,7 @@ OpsKat 将你的基础设施组织为树状结构的资产清单。资产代表
 
 - 创建嵌套分组来区分环境（例如"生产环境 > Web 服务器"）
 - 资产和分组可以通过拖拽重新排序
-- 分组可以有自己的[策略配置](/docs/guide/policy)，子资产会继承这些策略
+- 分组可以有自己的[策略配置](/guide/policy)，子资产会继承这些策略
 
 ## 添加、编辑和删除资产
 

i18n/zh-CN/docusaurus-plugin-content-docs/current/guide/query-editor.md

@@ -30,7 +30,7 @@ OpsKat 使用 **TiDB Parser** 在执行前分析 SQL 语句。这提供了以下
   - 不带 `WHERE` 子句的 `DELETE` 或 `UPDATE`
   - `PREPARE` 语句
   - `CALL` 语句
-- **策略执行** — 语句类型和标记会在执行前与资产的[查询策略](/docs/guide/policy)进行比对
+- **策略执行** — 语句类型和标记会在执行前与资产的[查询策略](/guide/policy)进行比对
 
 ## 结果表格
 
@@ -70,7 +70,7 @@ INFO server
 
 ## 策略执行
 
-通过查询编辑器执行的所有查询和命令都与 AI 智能体操作遵循相同的[策略规则](/docs/guide/policy)：
+通过查询编辑器执行的所有查询和命令都与 AI 智能体操作遵循相同的[策略规则](/guide/policy)：
 
 - **SQL** — 根据资产的查询策略检查（允许/拒绝的语句类型、危险模式标记）
 - **Redis** — 根据资产的 Redis 策略检查（允许/拒绝的命令模式）

src/clientModules/localeRedirect.ts

@@ -1,18 +1,21 @@
 import ExecutionEnvironment from "@docusaurus/ExecutionEnvironment";
+import siteConfig from "@generated/docusaurus.config";
 
 if (ExecutionEnvironment.canUseDOM) {
   const STORAGE_KEY = "opskat_locale_redirected";
+  const baseUrl = siteConfig.baseUrl; // e.g. "/docs/"
 
   // Only redirect on first visit and if on the default (en) locale root
   if (
     !localStorage.getItem(STORAGE_KEY) &&
-    (window.location.pathname === "/" || window.location.pathname === "")
+    (window.location.pathname === baseUrl ||
+      window.location.pathname === baseUrl.replace(/\/$/, ""))
   ) {
     localStorage.setItem(STORAGE_KEY, "1");
 
     const lang = navigator.language || navigator.languages?.[0] || "";
     if (lang.startsWith("zh")) {
-      window.location.replace("/zh-CN/");
+      window.location.replace(`${baseUrl}zh-CN/`);
     }
   }
 }