feat(docs): update documentation and configuration for vitepress and chatluna api

- Reformat social links in `.vitepress/config.ts` for readability
- Remove deprecated CSS preprocessor options and adjust code transformers
- Add explicit language support for syntax highlighting
- Update import statements in theme files to use double quotes
- Integrate TwoslashFloatingVue for enhanced code display
- Modify markdown documents to change alert types from TIP to IMPORTANT
- Revise development guides with updated plugin creation instructions
- Adjust frontmatter and component registrations in docs
- Update dependencies including koishi, chatluna, and vitepress versions

Author: dingyi222666

docs/.vitepress/config.ts

@@ -46,7 +46,10 @@ export default defineConfig({
         },
 
         socialLinks: [
-            { icon: "github", link: "https://github.com/ChatLunaLab/chatluna" },
+            {
+                icon: "github",
+                link: "https://github.com/ChatLunaLab/chatluna",
+            },
         ],
         footer: {
             message: "在 CC-BY-SA-4.0 许可下发布",
@@ -106,19 +109,14 @@ export default defineConfig({
 
             md.use(InlineLinkPreviewElementTransform);
         },
-        codeTransformers: [transformerTwoslash() as any],
         image: {
             lazyLoading: true,
         },
+        codeTransformers: [transformerTwoslash()],
+        // Explicitly load these languages for types hightlighting
+        languages: ["js", "jsx", "ts", "tsx"],
     },
     vite: {
-        css: {
-            preprocessorOptions: {
-                scss: {
-                    api: "modern-compiler", // or "modern"
-                },
-            },
-        },
         ssr: {
             noExternal: ["@nolebase/*", "vue-demi", "@unlazy/*"],
         },

docs/.vitepress/theme/index.ts

@@ -1,71 +1,72 @@
-import { h } from 'vue';
-import DefaultTheme from 'vitepress/theme';
-import { enhanceAppWithTabs } from 'vitepress-plugin-tabs/client';
-import './styles/custom.css';
-import ChatPanel from './components/ChatPanel.vue';
-import ChatMessage from './components/ChatMessage.vue';
+import { h } from "vue";
+import DefaultTheme from "vitepress/theme";
+import { enhanceAppWithTabs } from "vitepress-plugin-tabs/client";
+import "./styles/custom.css";
+import ChatPanel from "./components/ChatPanel.vue";
+import ChatMessage from "./components/ChatMessage.vue";
 
-import { Theme } from 'vitepress';
+import { Theme } from "vitepress";
 
 import {
     InjectionKey as NolebaseEnhancedReadabilitiesInjectionKey,
     LayoutMode as NolebaseEnhancedReadabilitiesLayoutMode,
     NolebaseEnhancedReadabilitiesMenu,
     NolebaseEnhancedReadabilitiesScreenMenu,
-} from '@nolebase/vitepress-plugin-enhanced-readabilities/client';
+} from "@nolebase/vitepress-plugin-enhanced-readabilities/client";
 
-import { NolebaseInlineLinkPreviewPlugin } from '@nolebase/vitepress-plugin-inline-link-preview/client';
+import { NolebaseInlineLinkPreviewPlugin } from "@nolebase/vitepress-plugin-inline-link-preview/client";
 
-import { NolebaseHighlightTargetedHeading } from '@nolebase/vitepress-plugin-highlight-targeted-heading/client';
+import { NolebaseHighlightTargetedHeading } from "@nolebase/vitepress-plugin-highlight-targeted-heading/client";
 
 import {
     InjectionKey,
     NolebaseGitChangelogPlugin,
-} from '@nolebase/vitepress-plugin-git-changelog/client';
+} from "@nolebase/vitepress-plugin-git-changelog/client";
 
-import { NolebasePagePropertiesPlugin } from '@nolebase/vitepress-plugin-page-properties/client';
+import { NolebasePagePropertiesPlugin } from "@nolebase/vitepress-plugin-page-properties/client";
 
-import { NolebaseUnlazyImg } from '@nolebase/vitepress-plugin-thumbnail-hash/client';
+import { NolebaseUnlazyImg } from "@nolebase/vitepress-plugin-thumbnail-hash/client";
 
-import AppContainer from './components/AppContainer.vue';
+import AppContainer from "./components/AppContainer.vue";
+import TwoslashFloatingVue from '@shikijs/vitepress-twoslash/client'
 
-import '@nolebase/vitepress-plugin-enhanced-readabilities/client/style.css';
-import '@nolebase/vitepress-plugin-highlight-targeted-heading/client/style.css';
-import '@nolebase/vitepress-plugin-inline-link-preview/client/style.css';
-import '@nolebase/vitepress-plugin-git-changelog/client/style.css';
-import '@nolebase/vitepress-plugin-page-properties/client/style.css';
-import '@nolebase/vitepress-plugin-thumbnail-hash/client/style.css';
-import '@nolebase/vitepress-plugin-enhanced-mark/client/style.css';
+import "@nolebase/vitepress-plugin-enhanced-readabilities/client/style.css";
+import "@nolebase/vitepress-plugin-highlight-targeted-heading/client/style.css";
+import "@nolebase/vitepress-plugin-inline-link-preview/client/style.css";
+import "@nolebase/vitepress-plugin-git-changelog/client/style.css";
+import "@nolebase/vitepress-plugin-page-properties/client/style.css";
+import "@nolebase/vitepress-plugin-thumbnail-hash/client/style.css";
+import "@nolebase/vitepress-plugin-enhanced-mark/client/style.css";
 
-import 'virtual:uno.css'
+import "virtual:uno.css";
 
-import './styles/main.css';
-import './styles/vars.css';
-import './styles/sponsor.css';
+import "./styles/main.css";
+import "./styles/vars.css";
+import "./styles/sponsor.css";
 
-import '@shikijs/vitepress-twoslash/style.css';
-import Sponsors from './components/Sponsors.vue';
+import '@shikijs/vitepress-twoslash/style.css'
+import Sponsors from "./components/Sponsors.vue";
 
-import('@nolebase/vitepress-plugin-inline-link-preview/client');
+import("@nolebase/vitepress-plugin-inline-link-preview/client");
 
 export default {
     extends: DefaultTheme,
     Layout: () => {
         return h(DefaultTheme.Layout, null, {
             // https://vitepress.dev/guide/extending-default-theme#layout-slots
-            'doc-top': () => [h(NolebaseHighlightTargetedHeading)],
-            'nav-bar-content-after': () => [
+            "doc-top": () => [h(NolebaseHighlightTargetedHeading)],
+            "nav-bar-content-after": () => [
                 h(NolebaseEnhancedReadabilitiesMenu),
             ],
-            'nav-screen-content-after': () => [
+            "nav-screen-content-after": () => [
                 h(NolebaseEnhancedReadabilitiesScreenMenu),
             ],
         });
     },
     enhanceApp({ app }) {
-        app.component('chat-panel', ChatPanel);
-        app.component('chat-message', ChatMessage);
-        app.component('sponsors', Sponsors);
+        app.component("chat-panel", ChatPanel);
+        app.component("chat-message", ChatMessage);
+        app.component("sponsors", Sponsors);
 
         enhanceAppWithTabs(app);
 
@@ -76,8 +77,8 @@ export default {
          * https://github.com/vuejs/vitepress/issues/1918
          */
 
-        app.component('AppContainer', AppContainer);
-        app.component('NolebaseUnlazyImg', NolebaseUnlazyImg);
+        app.component("AppContainer", AppContainer);
+        app.component("NolebaseUnlazyImg", NolebaseUnlazyImg);
 
         app.provide(NolebaseEnhancedReadabilitiesInjectionKey, {
             layoutSwitch: {
@@ -87,7 +88,7 @@ export default {
             spotlight: {
                 disableHelp: true,
                 defaultToggle: true,
-                hoverBlockColor: 'rgb(240 197 52 / 7%)',
+                hoverBlockColor: "rgb(240 197 52 / 7%)",
             },
         });
 
@@ -98,30 +99,31 @@ export default {
 
         app.use(NolebaseInlineLinkPreviewPlugin);
         app.use(NolebaseGitChangelogPlugin);
+        app.use(TwoslashFloatingVue);
         app.use(
             NolebasePagePropertiesPlugin<{
                 progress: number;
             }>(),
             {
                 properties: {
-                    'zh-CN': [
+                    "zh-CN": [
                         {
-                            key: 'wordCount',
-                            type: 'dynamic',
-                            title: '字数',
+                            key: "wordCount",
+                            type: "dynamic",
+                            title: "字数",
                             options: {
-                                type: 'wordsCount',
+                                type: "wordsCount",
                             },
                         },
                         {
-                            key: 'readingTime',
-                            type: 'dynamic',
-                            title: '阅读时间',
+                            key: "readingTime",
+                            type: "dynamic",
+                            title: "阅读时间",
                             options: {
-                                type: 'readingTime',
-                                dateFnsLocaleName: 'zhCN',
+                                type: "readingTime",
+                                dateFnsLocaleName: "zhCN",
                             },
-                        }
+                        },
                     ],
                 },
             }

docs/development/api-reference/chatluna-utils/request.md

@@ -35,7 +35,7 @@ const ua = randomUA()
 
 建立一个 `fetch` 请求。
 
-> [!TIP] 注意
+> [!IMPORTANT] 注意
 > 如果 `proxy` 参数传递为 'null'(注意是纯文本的 `null`，不是 `null` 变量)，则不会使用代理。
 
 ### ws(url, init, proxy)
@@ -47,7 +47,7 @@ const ua = randomUA()
 
 建立一个 `ws` 请求。
 
-> [!TIP] 注意
+> [!IMPORTANT] 注意
 > 如果 `proxy` 参数传递为 'null'(注意是纯文本的 `null`，不是 `null` 变量)，则不会使用代理。
 
 ### randomUA()

docs/development/api-reference/chatluna-utils/sse.md

@@ -50,5 +50,5 @@ for await (const event of sseIterable(response)) {
 
 将 SSE 响应转换为原始数据的异步迭代器。当 `cacheCount` 大于 0 时，将累积指定数量的原始数据后一次性产出。
 
-> [!TIP] 注意
+> [!IMPORTANT] 注意
 > `rawSeeAsIterable` 返回的是未经解析的原始 SSE 数据流，而 `sseIterable` 返回的是经过解析的事件数据。

docs/development/call-core-services/vector-database.md

@@ -4,7 +4,7 @@ ChatLuna 提供了向量数据库的集成能力，用于高效存储和检索
 
 向量数据库是 LLM 应用的核心基础设施之一，它通过存储文本的向量表示，实现了基于语义的相似度搜索，为 LLM 提供外部知识库和记忆能力。
 
-> [!TIP] 提示
+> [!IMPORTANT] 提示
 > 创建向量数据库时还需要指定嵌入模型，请参考 [嵌入模型](/development/call-core-services/embedding-model)。
 
 ## 基于内存的向量数据库

docs/development/extend-chatluna-api.md

@@ -2,40 +2,13 @@
 
 另外一个常见的需求是扩展 ChatLuna 的能力。
 
-ChatLuna 支持插件聊天模式 (Plugin Chat Mode)，允许其他插件定义 [Tool](https://js.langchain.com/docs/concepts/tools/)，让模型可以调用这些 Tool 来完成一些任务。
-
-## 添加依赖
-
-首先，需要在你的 Koishi 插件的 `package.json` 文件中添加必要的依赖：
-
-```json
-{
-    "peerDependencies": {
-        "koishi": "^4.18.0",
-        "koishi-plugin-chatluna": "^1.0.0-beta.119"
-    },
-    "devDependencies": {
-        "koishi-plugin-chatluna": "^1.0.0-beta.119"
-    },
-    "dependencies": {
-        "@langchain/core": "^0.3.2"
-    },
-    "koishi": {
-        "service": {
-            "required": ["chatluna"]
-        }
-    }
-}
-```
+ChatLuna 支持 Agent 模式，允许其他插件定义 [工具](https://js.langchain.com/docs/concepts/tools/)。
 
-运行 `npm install` 或 `yarn install` 安装依赖后，在插件的主入口文件中引入并声明 ChatLuna 服务：
+模型可以调用这些工具来完成各种任务。
 
-```typescript
-import type {} from "koishi-plugin-chatluna/services/chat";
-import { ChatLunaChatModel } from 'koishi-plugin-chatluna/llm-core/platform/model'
+## 创建插件
 
-export const inject = ['chatluna']
-```
+阅读 [创建插件](./getting-started.md#创建插件) 以了解更多。
 
 ## 注册工具
 
@@ -104,7 +77,7 @@ export class EchoTool extends Tool {
 
 ```
 
-下面的代码注册了一个名为 `echo` 的 Tool。当聊天记录符合 `selector` 的匹配条件时，会调用 `createTool` 方法创建一个 `EchoTool` 实例。
+上面的代码注册了一个名为 `echo` 的 Tool。当聊天记录符合 `selector` 的匹配条件时，会调用 `createTool` 方法创建一个 `EchoTool` 实例。
 
 更详细的工具注册方法，请参考 [模型工具](./development/connect-to-core-services/model-tool)。