feat: 初始化 VitePress Web 版指导书
- VitePress 1.6 站点(中文/搜索/侧边栏/品牌主题) - 11 个 Markdown 页面,Step 表格结构化 - 88 张图压缩为 webp(45MB → 6MB) - favicon + 下载资料包(mac/win) - GitHub Pages 部署工作流
This commit is contained in:
@@ -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 鼎捷数智'
|
||||
}
|
||||
}
|
||||
})
|
||||
@@ -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;
|
||||
}
|
||||
}
|
||||
@@ -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))
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user