docs(site): restructure into book-style chapters with custom nav theme

- Split index into 11 ordered chapters aligned with README content
- Add custom VitePress theme: home TOC cards + chapter Prev/Next nav bar
- Rewrite nav/sidebar to book-style single TOC entry
- Remove getting-started.md (content merged into quick-start + start-here)

Author: ymkiux

site/.vitepress/config.js

@@ -8,18 +8,26 @@ export default {
   lastUpdated: true,
   themeConfig: {
     nav: [
-      { text: "快速开始", link: "/guide/getting-started" },
-      { text: "核心工作流", link: "/guide/workflow" },
-      { text: "GitHub Pages", link: "/guide/github-pages" },
+      { text: "目录", link: "/" },
+      { text: "从这里开始", link: "/guide/start-here" },
+      { text: "架构", link: "/guide/architecture" },
       { text: "GitHub", link: "https://github.com/SakuraByteCore/codexmate" }
     ],
     sidebar: [
       {
-        text: "使用指南",
+        text: "目录",
         items: [
-          { text: "快速开始", link: "/guide/getting-started" },
+          { text: "从这里开始", link: "/guide/start-here" },
+          { text: "它能做什么", link: "/guide/capabilities" },
+          { text: "快速开始", link: "/guide/quick-start" },
           { text: "核心工作流", link: "/guide/workflow" },
-          { text: "GitHub Pages", link: "/guide/github-pages" }
+          { text: "Web UI 集中管理", link: "/guide/web-ui" },
+          { text: "会话管理", link: "/guide/sessions" },
+          { text: "Skills 与提示词", link: "/guide/skills-prompt" },
+          { text: "任务编排", link: "/guide/tasks" },
+          { text: "架构总览", link: "/guide/architecture" },
+          { text: "设计边界", link: "/guide/limits" },
+          { text: "GitHub Pages 部署", link: "/guide/github-pages" }
         ]
       }
     ],

site/.vitepress/theme/Layout.vue

@@ -0,0 +1,55 @@
+<script setup>
+import { computed } from "vue";
+import DefaultTheme from "vitepress/theme";
+import { useData } from "vitepress";
+import "./style.css";
+
+const { Layout } = DefaultTheme;
+
+const CHAPTERS = [
+  { link: "/guide/start-here", title: "从这里开始" },
+  { link: "/guide/capabilities", title: "它能做什么" },
+  { link: "/guide/quick-start", title: "快速开始" },
+  { link: "/guide/workflow", title: "核心工作流" },
+  { link: "/guide/web-ui", title: "Web UI 集中管理" },
+  { link: "/guide/sessions", title: "会话管理" },
+  { link: "/guide/skills-prompt", title: "Skills 与提示词" },
+  { link: "/guide/tasks", title: "任务编排" },
+  { link: "/guide/architecture", title: "架构总览" },
+  { link: "/guide/limits", title: "设计边界" },
+  { link: "/guide/github-pages", title: "GitHub Pages 部署" },
+];
+
+const { page } = useData();
+
+const nav = computed(() => {
+  const raw = (page.value.relativePath || "").replace(/\.md$/, "");
+  const path = "/" + raw;
+  const idx = CHAPTERS.findIndex((c) => c.link === path);
+  if (idx < 0) return null;
+  return {
+    prev: idx > 0 ? CHAPTERS[idx - 1] : null,
+    next: idx < CHAPTERS.length - 1 ? CHAPTERS[idx + 1] : null,
+  };
+});
+</script>
+
+<template>
+  <Layout>
+    <template #doc-after>
+      <nav v-if="nav" class="book-nav-bottom">
+        <a v-if="nav.prev" :href="nav.prev.link">
+          <span aria-hidden="true">←</span>
+          {{ nav.prev.title }}
+        </a>
+        <span v-else class="placeholder">.</span>
+        <a class="to-toc" href="/">回到目录</a>
+        <a v-if="nav.next" :href="nav.next.link">
+          {{ nav.next.title }}
+          <span aria-hidden="true">→</span>
+        </a>
+        <span v-else class="placeholder">.</span>
+      </nav>
+    </template>
+  </Layout>
+</template>

site/.vitepress/theme/index.js

@@ -0,0 +1,8 @@
+import DefaultTheme from "vitepress/theme";
+import Layout from "./Layout.vue";
+import "./style.css";
+
+export default {
+  extends: DefaultTheme,
+  Layout,
+};

site/.vitepress/theme/style.css

@@ -0,0 +1,72 @@
+.VPHome .VPFeatures {
+  max-width: 1152px;
+  margin: 0 auto;
+  padding: 0 24px 96px;
+}
+.VPHome .VPFeatures .container {
+  margin: 0 !important;
+}
+.VPHome .VPFeatures .items {
+  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr)) !important;
+  gap: 18px !important;
+}
+.VPHome .VPFeatures .item {
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 12px;
+  transition: transform 0.18s ease, box-shadow 0.18s ease, border-color 0.18s ease;
+}
+.VPHome .VPFeatures .item:hover {
+  transform: translateY(-3px);
+  box-shadow: 0 6px 20px rgba(0, 0, 0, 0.08);
+  border-color: var(--vp-c-brand-1);
+}
+.VPHome .VPFeatures .VPFeature {
+  height: 100%;
+}
+.VPHome .VPFeatures .title {
+  font-size: 16px;
+  font-weight: 650;
+  line-height: 24px;
+}
+.VPHome .VPFeatures .details {
+  font-size: 13.5px;
+  line-height: 22px;
+  margin-top: 8px;
+  color: var(--vp-c-text-2);
+}
+
+.book-nav-bottom {
+  margin: 48px auto 24px;
+  padding: 16px 24px;
+  border-top: 1px solid var(--vp-c-divider);
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  max-width: 768px;
+}
+.book-nav-bottom a {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 14px;
+  font-weight: 500;
+  padding: 8px 14px;
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 10px;
+  text-decoration: none;
+  color: var(--vp-c-text-1);
+  transition: border-color 0.15s ease, color 0.15s ease, background 0.15s ease;
+}
+.book-nav-bottom a:hover {
+  border-color: var(--vp-c-brand-1);
+  color: var(--vp-c-brand-1);
+  background: var(--vp-c-bg);
+}
+.book-nav-bottom .to-toc {
+  font-size: 13px;
+  color: var(--vp-c-text-2);
+}
+.book-nav-bottom .placeholder {
+  visibility: hidden;
+}

site/guide/architecture.md

@@ -0,0 +1,59 @@
+# 架构总览
+
+用户 → CLI / Web UI / MCP → HTTP API → 核心(配置引擎/会话管理/Skills/任务) → 本地文件系统。
+
+```mermaid
+%%{ init: { 'flowchart': { 'curve': 'catmullRom' } } }%%
+flowchart TD
+    User([User])
+    CLI[CLI]
+    WebUI[Web UI]
+    MCP[MCP Server]
+
+    subgraph Mate [Codex Mate Core]
+        API[HTTP API]
+        Config[Config Engine]
+        Session[Session Manager]
+        Skills[Skills Market]
+        Tasks[Task Runner]
+    end
+
+    subgraph Local [Local Filesystem]
+        CodexDir[~/.codex]
+        ClaudeDir[~/.claude]
+        ClawDir[~/.openclaw]
+        OpenCodeDir[~/.config/opencode]
+        MateDir[~/.codexmate]
+        State[Sessions/Usage/Trash]
+    end
+
+    User --> CLI & WebUI & MCP
+    CLI & WebUI & MCP --> API
+
+    API --> Config & Session & Skills & Tasks
+
+    Config --> CodexDir & ClaudeDir & ClawDir & OpenCodeDir & MateDir
+    Session --> State
+    Skills --> Local
+```
+
+## 各层职责
+
+| 层 | 职责 |
+| --- | --- |
+| 入口 | CLI / Web UI / MCP stdio 三个面向用户的入口 |
+| HTTP API | 统一后端,承接三入口调用 |
+| 配置引擎 | 写各工具配置,首轮接管有备份,可回滚 |
+| 会话管理 | 聚合多工具会话,搜索/预览/导出/清理 |
+| Skills Market | 跨 agent 应用导入导出 |
+| 任务运行器 | DAG 编排与执行日志 |
+| 本地 FS | 配置与会话/用量/回收站落盘 |
+
+## 设计要点
+
+- 本地优先:配置写本地目录,不碰云端账号。
+- 隔离:每个工具的配置路径独立,首轮接管有备份。
+- 不替代:只做管理层,原工具照常运行。
+
+## 下一步
+架构之外看 [Web UI 集中管理](/guide/web-ui) 实操,或了解 [设计边界](/guide/limits)。

site/guide/capabilities.md

@@ -0,0 +1,40 @@
+# 它能做什么
+
+完整能力按四块组织:provider 管理、会话浏览、Skills 与提示词、任务编排。下面的状态表来自仓库 README,各项都已在 CLI / Web UI 落地。
+
+## 功能进度
+
+| 功能 | 状态 | 说明 |
+| --- | --- | --- |
+| Provider 管理 | ✅ | Codex / Claude / OpenCode / KiloCode / OpenClaw 的 provider/model 切换 |
+| 实时同步 | ✅ | Codex / Claude 配置与状态实时监控 |
+| 会话浏览 | ✅ | Codex / Claude Code / Gemini CLI / CodeBuddy Code / Pi 会话统一搜索、预览、筛选、导出 |
+| 用量分析 | ✅ | 消息趋势与项目排行可视化 |
+| 本地 Skills Market | ✅ | 跨 agent 应用导入导出 skills |
+| 任务队列 | ✅ | 基于 DAG 的任务执行与日志 |
+| OpenAI 桥 | ✅ | Codex Responses API 转标准 OpenAI 格式,并在内置转换中补齐/规范化 Codex 指纹头 |
+| Claude Provider 桥 | ✅ | Claude Code 接 OpenAI Chat Completions 兼容 provider 与 Ollama |
+| OpenCode Provider Store | ✅ | 多 provider 存于 `~/.codexmate`,仅把激活项投影到原生配置 |
+| KiloCode 配置桥 | ✅ | `codexmate kilo config` 或 Web UI 写 `~/.config/kilo/kilo.jsonc`,保留已有 Key |
+| Provider 健康检查 | ✅ | 探测 Codex/Claude 本地路由,高亮失败项并批量安全清理 |
+| Prompt 模板 | ✅ | 带变量复用提示词插件 |
+| Prompt 文件编辑器 | ✅ | 编辑全局/项目级 `CLAUDE.md`/`AGENTS.md`,自动检测项目路径,应用 preset 仅更新编辑器,保存才写盘 |
+| MCP 集成 | ✅ | MCP stdio 暴露本地工具与资源 |
+| 自动更新 | ✅ | `codexmate update` 一键升级 CLI |
+
+## 四块能力拆解
+
+### Provider 管理
+统一切换多个 agent 的 provider/model;每个工具的配置写入路径隔离,首轮接管有备份,可回滚。
+
+### 会话浏览
+把散落在各工具目录的会话拉到同一视图:搜索、筛选、预览、导出为 Markdown、单条删除与批量清理。
+
+### Skills 与提示词
+本地优先的 Skills Market 做跨应用导入导出;Prompt 文件编辑器管 `CLAUDE.md`/`AGENTS.md`,带可复用 preset 池。
+
+### 任务编排
+基于 DAG 的任务队列,支持依赖追踪、执行与日志,适合编排多步任务。
+
+## 下一步
+能力清单看完,去 [快速开始](/guide/quick-start) 跑起来,或看 [架构总览](/guide/architecture) 懂内部怎么连。

site/guide/getting-started.md

@@ -0,0 +1,27 @@
+# 设计边界
+
+用前必读:明确什么不做,避免误用。
+
+## 不做的事
+
+- **不做云端托管与账号体系**——全部本地,无遥测、无云账号。
+- **不代管密钥**——只负责写配置,Key 由用户自管。
+- **不替代原工具**——仅在其之上做配置与会话管理层,原工具照常运行。
+
+## 配置写入约定
+
+- 配置写本地文件,首轮接管有备份,便于回滚。
+- 各工具配置路径隔离:
+  - Codex: `~/.codex`(含 `AGENTS.md` 与 skills)
+  - Claude: `~/.claude/settings.json`
+  - OpenClaw: `~/.openclaw/openclaw.json` 与 workspace `AGENTS.md`
+  - OpenCode: `~/.codexmate` 多 provider store,投影到 `~/.config/opencode`
+  - KiloCode: `~/.config/kilo/kilo.jsonc`
+
+## 安全提示
+
+- 默认监听 `0.0.0.0:3737` 在局域网暴露未鉴权界面。仅可信网络使用。
+- 涉及 Key/配置/Skills 建议改 `127.0.0.1`。
+
+## 下一步
+回 [目录](/) 重新挑章节,或看 [GitHub Pages 部署](/guide/github-pages) 把文档站发上线。