feat(docs): show icon and version in navbar

Author: Aliorpse

saltify-docs/.gitignore

@@ -5,3 +5,6 @@ out/
 
 # Dependencies
 node_modules/
+
+# Auto-generated version file
+app/version.ts

saltify-docs/app/[[...mdxPath]]/page.tsx

@@ -2,7 +2,9 @@ import { generateStaticParamsFor, importPage } from 'nextra/pages';
 import { useMDXComponents as getMDXComponents } from '../../mdx-components';
 import { Metadata } from 'next';
 
-export const generateStaticParams = generateStaticParamsFor('mdxPath');
+export const generateStaticParams = async () => {
+  return generateStaticParamsFor('mdxPath')();
+};
 
 type Props = {
   params: Promise<{ slug: string; mdxPath: string[] }>;

saltify-docs/app/layout.tsx

@@ -4,6 +4,9 @@ import 'nextra-theme-docs/style.css';
 import './styles.css';
 import { Head, Search } from 'nextra/components';
 import { Metadata } from 'next';
+import React from "react";
+import Image from 'next/image';
+import { SALTIFY_VERSION } from './version';
 
 export const metadata: Metadata = {
   title: 'Saltify 文档',
@@ -19,8 +22,15 @@ export default async function RootLayout({ children }: { children: React.ReactNo
       navbar={
         <Navbar
           logo={
-            <div style={{ fontSize: '1.15rem' }}>
-              <b>Saltify</b> 文档
+            <div style={{ display: 'flex', alignItems: 'center' }}>
+              <Image src="/saltify-150.png" alt="Saltify Logo" width={40} height={40} style={{ borderRadius: '8px' }} />
+              <div style={{ marginLeft: '0.75rem' }} />
+              <div style={{ fontSize: '1.15rem' }}>
+                <b>Saltify</b> Docs
+                <div style={{ fontSize: '0.75rem' }}>
+                  <code>v{SALTIFY_VERSION}</code>
+                </div>
+              </div>
             </div>
           }
           projectLink={'https://github.com/SaltifyDev/saltify'}

saltify-docs/app/styles.css

@@ -4,4 +4,4 @@ code, kbd, samp, pre {
 
 code.nextra-code {
     font-size: 1em;
-}
+}

saltify-docs/content/docs-core/application.md

@@ -8,22 +8,22 @@
 val client = SaltifyApplication {
     connection {
         baseUrl = "http://localhost:3000"
-        accessToken = "your_token" // 选填：访问令牌（不用加 Bearer）
+        accessToken = "your_token" // 访问令牌
 
         // 事件服务连接配置
         events {
             type = EventConnectionType.WebSocket // 可选 WebSocket 或 SSE
             autoReconnect = true
         }
     }
-}.start() // 不要忘记这里的 start() 调用！
+}.start()
 ```
 
 事件服务连接不会自动建立，你需要手动调用 `connectEvent()` 才会真正开始监听事件。
 
 ```kotlin
 suspend fun main() {
-    val client = SaltifyApplication { /* ... */ }
+    val client = SaltifyApplication { /* ... */ }.start()
 
     client.connectEvent() 
 

saltify-docs/content/index.md

@@ -10,14 +10,15 @@ Saltify 是一个跨平台、可扩展的 Kotlin QQ Bot 框架 & Milky SDK。
 
 ## 开始之前
 
-### 添加 `saltify-core` 依赖
+### 添加 Saltify 依赖
 
 [![Maven Central](https://img.shields.io/maven-central/v/org.ntqqrev/saltify-core?label=Maven%20Central&logo=maven)](https://central.sonatype.com/artifact/org.ntqqrev/saltify-core)
 
 对于使用 Gradle 的 Kotlin 项目，可以在 `build.gradle.kts` 中添加以下内容：
 
 ```kotlin
 dependencies {
+    // 核心模块
     implementation("org.ntqqrev:saltify-core:$saltifyVersion")
 
     // 你可以选择为 Ktor client 使用不同的引擎而不是 cio，这里只是一个推荐。

saltify-docs/package.json

@@ -4,8 +4,9 @@
   "description": "Saltify Documentation",
   "main": "index.js",
   "scripts": {
-    "dev": "next",
-    "build": "next build",
+    "extract-version": "node scripts/extract-version.js",
+    "dev": "pnpm extract-version && next",
+    "build": "pnpm extract-version && next build",
     "start": "next start",
     "postbuild": "pagefind --site .next/server/app --output-path out/_pagefind"
   },

saltify-docs/scripts/extract-version.js

@@ -0,0 +1,14 @@
+const fs = require('fs');
+const path = require('path');
+
+// 从 build.gradle.kts 读取版本号
+const gradleFile = path.join(__dirname, '../../build.gradle.kts');
+const content = fs.readFileSync(gradleFile, 'utf8');
+
+const versionMatch = content.match(/version\s*=\s*"([^"]+)"/);
+const version = versionMatch ? versionMatch[1] : 'unknown';
+
+const outputPath = path.join(__dirname, '../app/version.ts');
+const output = `export const SALTIFY_VERSION = '${version}';`;
+
+fs.writeFileSync(outputPath, output, 'utf8');