feat(website): 添加文档页面布局和根目录快捷脚本

- 新增 DocsSidebar 文档导航侧边栏组件 - 新增 DocsLayout 文档页面布局模板 - 首页导航添加文档入口链接 - 根目录 package.json 添加各包快捷脚本
2025-12-12 23:09:41 +08:00
parent 2f9db8d7d8
commit 87620a1141
4 changed files with 243 additions and 1 deletions
@@ -0,0 +1,73 @@
+---
+interface Props {
+  currentPath: string;
+}
+
+const { currentPath } = Astro.props;
+
+const navigation = [
+  {
+    title: '开始',
+    items: [
+      { title: '概览', href: '/docs' },
+    ],
+  },
+  {
+    title: '架构设计',
+    items: [
+      { title: 'GUI Server/Client 架构', href: '/docs/architecture' },
+    ],
+  },
+  {
+    title: '功能设计',
+    items: [
+      { title: '编辑模式', href: '/docs/features/edit-modes' },
+      { title: '增强型仓库地图', href: '/docs/features/repo-map' },
+      { title: '多模型支持', href: '/docs/features/multi-model' },
+      { title: 'Linting 集成', href: '/docs/features/linting' },
+      { title: '测试集成', href: '/docs/features/testing' },
+      { title: '对话历史管理', href: '/docs/features/chat-history' },
+      { title: 'Watch 模式', href: '/docs/features/watch-mode' },
+      { title: '语音输入', href: '/docs/features/voice-input' },
+      { title: '浏览器 GUI', href: '/docs/features/browser-gui' },
+      { title: '配置管理', href: '/docs/features/configuration' },
+      { title: 'Checkpoint 增强', href: '/docs/features/checkpoint' },
+    ],
+  },
+];
+
+function isActive(href: string): boolean {
+  // 精确匹配或以 href 开头（用于子路径）
+  if (currentPath === href || currentPath === href + '/') {
+    return true;
+  }
+  return false;
+}
+---
+
+<nav class="space-y-6">
+  {navigation.map((section) => (
+    <div>
+      <h3 class="mb-3 text-xs font-semibold uppercase tracking-wider text-gray-500">
+        {section.title}
+      </h3>
+      <ul class="space-y-1">
+        {section.items.map((item) => (
+          <li>
+            <a
+              href={item.href}
+              class:list={[
+                'block rounded-lg px-3 py-2 text-sm transition',
+                isActive(item.href)
+                  ? 'bg-primary-500/10 text-primary-400 font-medium'
+                  : 'text-gray-400 hover:bg-gray-800 hover:text-white',
+              ]}
+            >
+              {item.title}
+            </a>
+          </li>
+        ))}
+      </ul>
+    </div>
+  ))}
+</nav>