' +
+ '' +
+ '',
+ }
+ }
+ },
+ en: {
+ label: "English",
+ lang: "en-US",
+ themeConfig: {
+ nav: [
+ { text: "Home", link: "https://astrbot.app" },
+ { text: "Blog", link: "https://blog.astrbot.app" },
+ { text: "Roadmap", link: "https://astrbot.featurebase.app/roadmap" },
+ { text: "HTTP API", link: "https://docs.astrbot.app/scalar.html" },
+ ],
+ sidebar: [
+ {
+ text: "Introduction",
+ items: [
+ { text: "What is AstrBot", link: "/en/what-is-astrbot" },
+ { text: "Community", link: "/en/community" },
+ { text: "FAQ", link: "/en/faq" },
+ ],
+ },
+ {
+ text: "Deployment",
+ base: "/en/deploy",
+ collapsed: false,
+ items: [
+ { text: "Package Manager", link: "/astrbot/package" },
+ { text: "One-click Launcher", link: "/astrbot/launcher" },
+ { text: "Docker", link: "/astrbot/docker" },
+ { text: "Kubernetes", link: "/astrbot/kubernetes" },
+ { text: "BT Panel", link: "/astrbot/btpanel" },
+ { text: "1Panel", link: "/astrbot/1panel" },
+ { text: "Manual", link: "/astrbot/cli" },
+ {
+ text: "Other Deployments",
+ link: "/astrbot/other-deployments",
+ collapsed: true,
+ items: [
+ { text: "CasaOS", link: "/astrbot/casaos" },
+ { text: "Compshare GPU", link: "/astrbot/compshare" },
+ { text: "Community-provided Deployment", link: "/astrbot/community-deployment" },
+ ],
+ },
+ {
+ text: "Support Us",
+ link: "/when-deployed",
+ },
+ ],
+ },
+ {
+ text: "Messaging Platforms",
+ base: "/en/platform",
+ collapsed: false,
+ items: [
+ {
+ text: "Quick Start",
+ link: "/start",
+ },
+ {
+ text: "QQ Official Bot",
+ link: "/qqofficial",
+ collapsed: true,
+ items: [
+ { text: "Websockets", link: "/qqofficial/websockets" },
+ { text: "Webhook", link: "/qqofficial/webhook" },
+ ],
+ },
+ {
+ text: "OneBot v11",
+ base: "/en/platform/aiocqhttp",
+ collapsed: true,
+ items: [
+ { text: "NapCat", link: "/napcat" },
+ { text: "Lagrange", link: "/lagrange" },
+ { text: "Other Clients", link: "/others" },
+ ],
+ },
+ { text: "WeCom Application", link: "/wecom" },
+ { text: "WeCom AI Bot", link: "/wecom_ai_bot" },
+ { text: "WeChat Official Account", link: "/weixin-official-account" },
+ { text: "Lark", link: "/lark" },
+ { text: "DingTalk", link: "/dingtalk" },
+ { text: "Telegram", link: "/telegram" },
+ { text: "LINE", link: "/line" },
+ { text: "Slack", link: "/slack" },
+ { text: "Misskey", link: "/misskey" },
+ { text: "Discord", link: "/discord" },
+ {
+ text: "Satori",
+ base: "/en/platform/satori",
+ collapsed: true,
+ items: [
+ { text: "Using LLOneBot", link: "/llonebot" },
+ { text: "Using server-satori", link: "/server-satori" },
+ ],
+ },
+ {
+ text: "Community-provided",
+ collapsed: false,
+ items: [
+ { text: "Matrix", link: "/matrix" },
+ { text: "KOOK", link: "/kook" },
+ { text: "VoceChat", link: "/vocechat" },
+ ],
+ },
+ ],
+ },
+ {
+ text: "AI Integration",
+ base: "/en/providers",
+ collapsed: false,
+ items: [
+ {
+ text: "✨ Model Providers",
+ link: "/start",
+ collapsed: true,
+ items: [
+ { text: "NewAPI", link: "/newapi" },
+ { text: "AIHubMix", link: "/aihubmix" },
+ { text: "PPIO Cloud", link: "/ppio" },
+ { text: "SiliconFlow", link: "/siliconflow" },
+ { text: "TokenPony", link: "/tokenpony" },
+ { text: "302.AI", link: "/302ai" },
+ { text: "Ollama", link: "/provider-ollama" },
+ { text: "LMStudio", link: "/provider-lmstudio" },
+ ],
+ },
+ {
+ text: "⚙️ Agent Runners",
+ link: "/agent-runners",
+ collapsed: false,
+ items: [
+ { text: "Built-in Agent Runner", link: "/agent-runners/astrbot-agent-runner" },
+ { text: "Dify", link: "/agent-runners/dify" },
+ { text: "Coze", link: "/agent-runners/coze" },
+ { text: "Alibaba Bailian", link: "/agent-runners/dashscope" },
+ { text: "DeerFlow", link: "/agent-runners/deerflow" },
+ ],
+ },
+ ],
+ },
+ {
+ text: "Usage",
+ base: "/en/use",
+ collapsed: true,
+ items: [
+ { text: "WebUI", link: "/webui" },
+ { text: "Plugins", link: "/plugin" },
+ { text: "Built-in Commands", link: "/command" },
+ { text: "Tool Use", link: "/function-calling" },
+ { text: "Anthropic Skills", link: "/skills" },
+ { text: "SubAgent Orchestration", link: "/subagent" },
+ { text: "Proactive Tasks", link: "/proactive-agent" },
+ { text: "MCP", link: "/mcp" },
+ { text: "Web Search", link: "/websearch" },
+ { text: "Knowledge Base", link: "/knowledge-base" },
+ { text: "Custom Rules", link: "/custom-rules" },
+ { text: "Agent Runner", link: "/agent-runner" },
+ { text: "Unified Webhook Mode", link: "/unified-webhook" },
+ { text: "Auto Context Compression", link: "/context-compress" },
+ { text: "Agent Sandbox", link: "/astrbot-agent-sandbox" },
+ ],
+ },
+ {
+ text: "Development",
+ base: "/en/dev",
+ collapsed: true,
+ items: [
+ {
+ text: "Plugin Development",
+ base: "/en/dev/star",
+ collapsed: true,
+ items: [
+ { text: "🌠 Getting Started", link: "/plugin-new" },
+ { text: "Minimal Example", link: "/guides/simple" },
+ { text: "Listen to Message Events", link: "/guides/listen-message-event" },
+ { text: "Send Messages", link: "/guides/send-message" },
+ { text: "Plugin Configuration", link: "/guides/plugin-config" },
+ { text: "AI", link: "/guides/ai" },
+ { text: "Storage", link: "/guides/storage" },
+ { text: "HTML to Image", link: "/guides/html-to-pic" },
+ { text: "Session Control", link: "/guides/session-control" },
+ { text: "Publish Plugin", link: "/plugin-publish" },
+ ],
+ },
+ {
+ text: "Platform Adapter Integration",
+ link: "/plugin-platform-adapter",
+ },
+ {
+ text: "AstrBot HTTP API",
+ link: "/openapi",
+ },
+ {
+ text: "AstrBot Configuration File",
+ link: "/astrbot-config",
+ },
+ ],
+ },
+ {
+ text: "Others",
+ base: "/en/others",
+ collapsed: true,
+ items: [
+ { text: "Self-hosted HTML to Image", link: "/self-host-t2i" },
+ ],
+ },
+ {
+ text: "Open Source Summer",
+ base: "/en/ospp",
+ collapsed: true,
+ items: [{ text: "OSPP 2025", link: "/2025" }],
+ },
+ ],
+ outline: {
+ level: 'deep',
+ label: 'On this page',
+ },
+ darkModeSwitchLabel: 'Toggle dark mode',
+ sidebarMenuLabel: 'Menu',
+ returnToTopLabel: 'Return to top',
+ docFooter: {
+ prev: 'Previous',
+ next: 'Next'
+ },
+ editLink: {
+ pattern: 'https://github.com/AstrBotdevs/AstrBot-docs/edit/v4/:path',
+ text: 'Edit this page on GitHub',
+ },
+ logo: '/logo_prod.png',
+ socialLinks: [
+ { icon: "github", link: "https://github.com/AstrBotDevs/AstrBot" },
+ ],
+ footer: {
+ message: 'Deployed on ' +
+ '' +
+ '' +
+ '',
+ }
+ }
+ },
+ },
+
+ themeConfig: {
+ search: {
+ provider: "local",
+ options: {
+ locales: {
+ root: {
+ translations: {
+ button: {
+ buttonText: "搜索文档",
+ buttonAriaLabel: "搜索文档",
+ },
+ modal: {
+ noResultsText: "无法找到相关结果",
+ resetButtonTitle: "清除查询条件",
+ footer: {
+ selectText: "选择",
+ navigateText: "切换",
+ closeText: "关闭",
+ },
+ },
+ },
+ },
+ },
+ },
+ },
+ }
+});
diff --git a/docs/.vitepress/config/head.ts b/docs/.vitepress/config/head.ts
new file mode 100644
index 000000000..efa645e1a
--- /dev/null
+++ b/docs/.vitepress/config/head.ts
@@ -0,0 +1,47 @@
+import type { HeadConfig } from "vitepress";
+
+export const head: HeadConfig[] = [
+ // --- Google Fonts ---
+ ["link", { rel: "preconnect", href: "https://fonts.googleapis.cn", crossorigin: "" }],
+ ["link", { rel: "dns-prefetch", href: "https://fonts.googleapis.cn" }],
+ ["link", { rel: "preconnect", href: "https://fonts.gstatic.cn", crossorigin: "" }],
+ ["link", { rel: "dns-prefetch", href: "https://fonts.gstatic.cn" }],
+ ["link", { rel: "stylesheet", href: "https://fonts.googleapis.com/css2?family=Outfit:wght@100..900&display=swap" }],
+
+ // --- 基础和SEO元数据 ---
+ ["link", { rel: "icon", href: "/logo.png" }],
+ ["meta", { name: "description", content: "AstrBot" }],
+ [
+ "meta",
+ { name: "viewport", content: "width=device-width, initial-scale=1.0" },
+ ],
+
+ /* // --- Open Graph (OG) 协议元数据 (用于社交媒体分享) ---
+ ["meta", { property: "og:type", content: "website" }],
+ ["meta", { property: "og:locale", content: "zh_CN" }],
+ ["meta", { property: "og:title", content: "AstrBot" }],
+ ["meta", { property: "og:description", content: "AstrBot" }],
+ ["meta", { property: "og:url", content: "https://docs.astrbot.app" }],
+ ["meta", { property: "og:site_name", content: "AstrBot" }],
+ [
+ "meta",
+ {
+ property: "og:image",
+ content: "/",
+ },
+ ],
+ [
+ "meta",
+ { property: "og:image:alt", content: "AstrBot" },
+ ],
+ ["meta", { property: "og:image:width", content: "1200" }],
+ ["meta", { property: "og:image:height", content: "630" }],
+ ["meta", { property: "og:image:type", content: "image/png" }],
+
+ // --- Twitter Card 元数据 ---
+ ["meta", { name: "twitter:card", content: "summary_large_image" }],
+ ["meta", { name: "twitter:site", content: "@AstrBot" }],*/
+
+ // --- Umami Analytics ---
+ ["script", { defer: "", src: "https://cloud.umami.is/script.js", "data-website-id": "9c3f777e-9f4a-4b79-a5c3-ff94f5dca8f9" }],
+];
\ No newline at end of file
diff --git a/docs/.vitepress/theme/components/ArticleShare.vue b/docs/.vitepress/theme/components/ArticleShare.vue
new file mode 100644
index 000000000..35115e5a6
--- /dev/null
+++ b/docs/.vitepress/theme/components/ArticleShare.vue
@@ -0,0 +1,194 @@
+
+
+
+
+
+ 
+ 请点击左上角 Logo 返回首页，或点击下方按钮。
+ +