feat: 初始化 VitePress Web 版指导书

- VitePress 1.6 站点(中文/搜索/侧边栏/品牌主题)
- 11 个 Markdown 页面,Step 表格结构化
- 88 张图压缩为 webp(45MB → 6MB)
- favicon + 下载资料包(mac/win)
- GitHub Pages 部署工作流
This commit is contained in:
2026-10-16 16:07:54 +08:00
commit 23a81acd2d
111 changed files with 3062 additions and 0 deletions
+80
View File
@@ -0,0 +1,80 @@
import { defineConfig } from 'vitepress'
// 本地运行用 '/';部署到 GitHub Pages 等项目子路径时,通过环境变量 VITEPRESS_BASE 覆盖,
// 例如 VITEPRESS_BASE=/GuideBook/ pnpm docs:build
const base = process.env.VITEPRESS_BASE || '/'
export default defineConfig({
lang: 'zh-CN',
title: 'Digi Agent Builder 3.0',
description: '鼎捷雅典娜 IndepthAI · 智能体开发示例指导书',
base,
cleanUrls: true,
head: [
['meta', { name: 'theme-color', content: '#1c5fd4' }],
['meta', { name: 'viewport', content: 'width=device-width,initial-scale=1' }],
['link', { rel: 'icon', type: 'image/png', href: `${base}favicon.png` }],
['link', { rel: 'shortcut icon', type: 'image/png', href: `${base}favicon.png` }]
],
themeConfig: {
siteTitle: 'Digi Agent Builder 3.0 指导书',
nav: [
{ text: '首页', link: '/' },
{ text: '架构设计', link: '/guide/' },
{ text: '开发实战', link: '/guide/scenario' },
{
text: '开发平台',
items: [
{ text: 'Web 端', link: 'https://kai-wis.apps.digiwincloud.com.cn/' }
]
}
],
sidebar: {
'/guide/': [
{
text: '第一章 智能体架构介绍',
items: [
{ text: '1.1-1.2 平台简介与架构概览', link: '/guide/' },
{ text: '1.3.1 如何登录智能体开发平台', link: '/guide/environment-login' },
{ text: '1.3.2 界面关键功能简介', link: '/guide/environment-ui' },
{ text: '1.3.3 前置文档数据准备', link: '/guide/environment-prepare' }
]
},
{
text: '第二章 企业智能体开发实战',
collapsed: false,
items: [
{ text: '2.1 企业智能体示例场景说明', link: '/guide/scenario' },
{ text: '2.2.1 工作区环境准备', link: '/guide/workspace' },
{ text: '2.2.2 项目搭建及方案生成', link: '/guide/agent-dev' },
{ text: '2.2.3 报价流程编排技能开发', link: '/guide/skill' },
{ text: '2.2.4.1 自主推理智能体', link: '/guide/reasoning-agent' },
{ text: '2.2.4.2 会话流智能体', link: '/guide/chatflow-agent' }
]
},
{
text: '附录',
items: [{ text: '附录 1-2 智能体测试结果', link: '/guide/appendix' }]
}
]
},
outline: { level: [2, 4], label: '本页目录' },
search: { provider: 'local' },
docFooter: { prev: '上一页', next: '下一页' },
returnToTopLabel: '返回顶部',
sidebarMenuLabel: '目录',
darkModeSwitchLabel: '主题',
lightModeSwitchTitle: '切换到浅色模式',
darkModeSwitchTitle: '切换到深色模式',
footer: {
message: '本指导书用于 Digi Agent Builder 3.0 智能体开发示例教学',
copyright: 'Copyright © 2026 鼎捷数智'
}
}
})
+139
View File
@@ -0,0 +1,139 @@
/* ===== Digi Agent Builder 3.0 指导书主题样式 ===== */
:root {
--vp-c-brand-1: #1c5fd4;
--vp-c-brand-2: #2f7ce8;
--vp-c-brand-3: #4a92f5;
--vp-c-brand-soft: rgba(28, 95, 212, 0.14);
--vp-home-hero-name-color: transparent;
--vp-home-hero-name-background: linear-gradient(120deg, #1c5fd4 20%, #17b3a3 80%);
--vp-home-hero-image-background-image: linear-gradient(-45deg, #1c5fd4 40%, #17b3a3 100%);
--vp-home-hero-image-filter: blur(56px);
--gb-border: rgba(28, 95, 212, 0.18);
--gb-card-bg: rgba(28, 95, 212, 0.035);
}
.dark {
--gb-border: rgba(120, 170, 255, 0.22);
--gb-card-bg: rgba(120, 170, 255, 0.06);
}
/* ---- 正文排版 ---- */
.vp-doc h1 {
font-size: 1.9rem;
line-height: 1.3;
}
.vp-doc h2 {
margin-top: 2.6rem;
padding-top: 0.7rem;
border-top: 1px solid var(--vp-c-divider);
font-size: 1.42rem;
}
.vp-doc h3 {
margin-top: 1.8rem;
font-size: 1.18rem;
}
/* ---- 正文图片:统一卡片化,响应式 ---- */
.vp-doc img {
display: block;
max-width: 100%;
height: auto;
margin: 0.9rem auto;
border: 1px solid var(--gb-border);
border-radius: 10px;
background: #fff;
box-shadow: 0 2px 10px rgba(15, 23, 42, 0.08);
cursor: zoom-in;
}
.dark .vp-doc img {
background: #0f172a;
}
/* 图片说明文字 */
.vp-doc p:has(> img) + em,
.vp-doc img + em {
display: block;
text-align: center;
font-size: 0.85rem;
color: var(--vp-c-text-2);
}
/* ---- 步骤标题:Step 序号卡片化 ---- */
.vp-doc h2[id^='step-'],
.vp-doc h3[id^='step-'] {
padding-left: 0.75rem;
border-left: 4px solid var(--vp-c-brand-1);
border-top: none;
margin-top: 2.2rem;
}
/* ---- 表格 ---- */
.vp-doc table {
display: table;
width: 100%;
margin: 1.2rem 0;
}
.vp-doc tr:nth-child(2n) {
background-color: var(--gb-card-bg);
}
.vp-doc th {
background-color: var(--vp-c-brand-soft);
}
/* ---- 提示块 ---- */
.vp-doc .custom-block {
border-radius: 10px;
font-size: 0.94rem;
}
.vp-doc .custom-block.tip,
.vp-doc .custom-block.warning,
.vp-doc .custom-block.danger,
.vp-doc .custom-block.info {
border-width: 1px;
}
/* ---- 代码/斜体提示词(原文中的需复制文字) ---- */
.vp-doc em strong,
.vp-doc strong em {
display: inline-block;
padding: 0.1rem 0.3rem;
border-radius: 5px;
background: var(--vp-c-brand-soft);
font-style: normal;
color: var(--vp-c-brand-1);
}
/* ---- 首页 hero ---- */
.VPHero .name {
font-size: 2.6rem;
}
.VPHero .text {
font-size: 1.5rem;
}
.VPFeature {
border-color: var(--gb-border);
}
/* ---- 移动端 ---- */
@media (max-width: 640px) {
.vp-doc h1 {
font-size: 1.5rem;
}
.vp-doc h2 {
font-size: 1.22rem;
}
.vp-doc img {
border-radius: 8px;
}
}
+21
View File
@@ -0,0 +1,21 @@
import DefaultTheme from 'vitepress/theme'
import mediumZoom from 'medium-zoom'
import { onMounted, watch, nextTick } from 'vue'
import { useRoute } from 'vitepress'
import './custom.css'
export default {
extends: DefaultTheme,
setup() {
const route = useRoute()
const initZoom = () => {
// 所有正文图片支持点击放大查看
mediumZoom('.vp-doc img:not(.no-zoom)', {
background: 'rgba(15, 23, 42, 0.82)',
margin: 24
})
}
onMounted(() => nextTick(initZoom))
watch(() => route.path, () => nextTick(initZoom))
}
}