docs(sidebar): update sidebar items and add new documentation pages

- Add new sidebar items for message rendering and middleware
- Create new documentation pages for message read and message render
- Update existing documentation to include new features and clarifications

Author: dingyi222666

docs/.vitepress/config.ts

@@ -499,6 +499,10 @@ function sidebarDevelopment(): DefaultTheme.SidebarItem[] {
                     text: '消息读取',
                     link: '/development/connect-to-core-services/message-read',
                 },
+                {
+                    text: '消息渲染',
+                    link: '/development/connect-to-core-services/message-render',
+                },
             ],
         },
         {
@@ -509,15 +513,15 @@ function sidebarDevelopment(): DefaultTheme.SidebarItem[] {
                     link: '/development/api-reference/chatluna-service',
                 },
                 {
-                    text: 'ChatLuna 插件(ChatLuna Plugin)',
+                    text: 'ChatLuna 插件 (ChatLuna Plugin)',
                     link: '/development/api-reference/chatluna-plugin',
                 },
                 {
-                    text: 'ChatLuna 事件(ChatLuna Events)',
+                    text: 'ChatLuna 事件 (ChatLuna Events)',
                     link: '/development/api-reference/chatluna-events',
                 },
                 {
-                    text: 'ChatLuna 大语言模型核心 （LLM Core）',
+                    text: 'ChatLuna 大语言模型核心',
                     collapsed: true,
                     items: [
                         {
@@ -539,7 +543,25 @@ function sidebarDevelopment(): DefaultTheme.SidebarItem[] {
                     ],
                 },
                 {
-                    text: 'ChatLuna 辅助工具 （ChatLuna Utils）',
+                    text: 'ChatLuna 中间件相关',
+                    collapsed: true,
+                    items: [
+                        {
+                            text: '消息 (ChatLuna Message)',
+                            link: '/development/api-reference/middleware/message',
+                        },
+                        {
+                            text: '消息渲染器 (Message Renderer)',
+                            link: '/development/api-reference/middleware/message-renderer',
+                        },
+                        {
+                            text: '消息转换器 (Message Transformer)',
+                            link: '/development/api-reference/middleware/message-transformer',
+                        },
+                    ],
+                },
+                {
+                    text: 'ChatLuna 辅助工具',
                     collapsed: true,
                     items: [
                         {
@@ -554,6 +576,10 @@ function sidebarDevelopment(): DefaultTheme.SidebarItem[] {
                             text: 'SSE 工具 (sse)',
                             link: '/development/api-reference/chatluna-utils/sse',
                         },
+                        {
+                            text: '错误 (Error)',
+                            link: '/development/api-reference/chatluna-utils/error',
+                        },
                     ],
                 },
             ],

docs/development/connect-to-core-services/message-read.md

@@ -0,0 +1,40 @@
+# 消息读取
+
+ChatLuna 是在 Koishi 下的插件。Koishi 作为一个聊天机器人框架，自身也有一套消息元素的机制。
+
+为了让 LLM 能够正确理解各种消息元素（如@提及、表情、图片等），ChatLuna 提供了一个消息转换机制，将这些元素转换为文本形式。
+
+## 用法
+
+在 `messageTransformer` 中添加消息转换器即可：
+
+```typescript
+const dispose = ctx.chatluna.messageTransformer.intercept(
+    'at',
+    async (session, element, message) => {
+        const name = element.attrs['name']
+        const id = element.attrs['id']
+
+        if (name && id !== session.bot.selfId) {
+            message.content += `[at:${name}:${id}]`
+        }
+    }
+)   
+
+ctx.effect(() => dispose)
+```
+
+在大部分情况下，将消息元素转换为文本，添加到 `message.content` 中即可。
+
+## API 参考
+
+`intercept` 方法接收两个参数:
+
+- `type: string` - 消息元素的类型，支持的类型请参考 [Koishi 文档](https://koishi.chat/zh-CN/guide/basic/element.html#%E6%B3%A8%E5%86%8C%E5%85%A8%E5%B1%80%E7%BB%84%E4%BB%B6)。
+
+- `handler: (session, element, message) => Promise<void>` - 处理函数，包含:
+  - `session`: 当前的 [会话对象](https://koishi.chat/zh-CN/api/core/session.html)
+  - `element`: 当前的 [消息元素对象](https://koishi.chat/zh-CN/api/message/elements.html)
+  - `message`: 当前的 [ChatLuna 消息对象](../api-reference/middleware/message)
+
+返回值 `() => void` 用于清理资源。建议使用 `ctx.effect(() => dispose)` 确保资源被正确释放。

docs/development/connect-to-core-services/message-render.md

@@ -0,0 +1,87 @@
+# 消息渲染
+
+LLM 的默认输出都是文本。但在 Koishi 中，可以发送多种类型的消息元素（图片，语音等）。
+
+为了让用户能够自由的选择消息元素的渲染方式，ChatLuna 提供了一个消息渲染 API，将这些文本渲染为 Koishi 的消息元素。
+
+## 注册插件
+
+所有需要接入功能到 ChatLuna 的插件，都得新建 `ChatLunaPlugin` 实例，并注册到 `ChatLuna` 服务中。
+
+```typescript
+import { ChatLunaPlugin } from 'koishi-plugin-chatluna/services/chat'
+import { Context, Schema } from 'koishi'
+
+export function apply(ctx: Context, config: Config) {
+    const plugin = new ChatLunaPlugin(ctx, config, 'your-plugin-name', false)
+
+    ctx.on('ready', async () => {
+        // 在 ready 事件中注册到 ChatLuna 服务
+        plugin.registerToService()
+
+        // 继续...
+    })
+}
+
+```
+
+> [!NOTE]
+> 如果你的插件不需要注册模型适配器，`ChatLunaPlugin` 的构造函数需要传入 `false` 作为第四个参数。
+> 该参数默认为 `true`，表示插件需要注册模型适配器。
+
+## 继承 Renderer 类
+
+继承 `Renderer` 类，实现你自己的消息渲染逻辑。
+
+```typescript
+import {
+    Message,
+    Renderer,
+    RenderMessage,
+    RenderOptions
+} from 'koishi-plugin-chatluna'
+import { h, Schema } from 'koishi'
+
+export class RawRenderer extends Renderer {
+    async render(
+        message: Message,
+        options: RenderOptions
+    ): Promise<RenderMessage> {
+        return {
+            element: h.text(message.content)
+        }
+    }
+
+    schema = Schema.const('raw').i18n({
+        'zh-CN': '原始输出',
+        'en-US': 'Raw text'
+    })
+}
+
+```
+
+`render` 方法接收两个参数：
+
+- `message`: 当前的 [ChatLuna 消息对象](../api-reference/middleware/message)
+- `options`: 当前的 [渲染选项](../api-reference/middleware/message-renderer')
+
+返回值 `RenderMessage` 包含一个 `element` 属性，用于指定渲染后的消息元素。
+
+对于 `Renderer` 类，`schema` 属性是必须的，用于指定渲染器的名称。
+
+## 注册 Renderer
+
+在 `ready` 事件中，调用 `renderer` 服务的 `addRenderer` 方法注册消息渲染器。
+
+```typescript
+ctx.on('ready', async () => {
+    // 在 ready 事件中注册到 ChatLuna 服务
+    plugin.registerToService()
+
+    ctx.effect(() =>
+        ctx.chatluna.renderer.addRenderer('raw', (_) => {
+            return new RawRenderer(ctx, config)
+        })
+    )
+})
+```

docs/development/connect-to-core-services/vector-database.md

@@ -11,7 +11,7 @@ import { ChatLunaPlugin } from 'koishi-plugin-chatluna/services/chat'
 import { Context, Schema } from 'koishi'
 
 export function apply(ctx: Context, config: Config) {
-    const plugin = new ChatLunaPlugin(ctx, config, 'your-plugin-name')
+    const plugin = new ChatLunaPlugin(ctx, config, 'your-plugin-name', false)
 
     ctx.on('ready', async () => {
         // 在 ready 事件中注册到 ChatLuna 服务
@@ -22,6 +22,10 @@ export function apply(ctx: Context, config: Config) {
 }
 ```
 
+> [!NOTE]
+> 如果你的插件不需要注册模型适配器，`ChatLunaPlugin` 的构造函数需要传入 `false` 作为第四个参数。
+> 该参数默认为 `true`，表示插件需要注册模型适配器。
+
 ## 配置 Schema
 
 如果你的向量数据库需要连接 URL 等参数，则需要自行声明 Schema。