docs(api): add prompt renderer and update related docs

- Add new documentation for Prompt Renderer service
- Update ChatLunaService docs with new methods and return types
- Update PlatformService docs with reactive patterns and new APIs
- Update PresetTemplate docs with full interface and service details
- Update Requester docs with simplified parameter descriptions
- Update MessageTransformer docs with priority support and new options
- Update Message docs with content type changes
- Add new chat events documentation
- Update sidebar navigation with new preset and prompt renderer links

Author: dingyi222666

docs/.vitepress/config.ts

@@ -526,6 +526,10 @@ function sidebarDevelopment(): DefaultTheme.SidebarItem[] {
                     text: "Agent",
                     link: "/development/call-core-services/agent",
                 },
+                {
+                    text: "预设",
+                    link: "/development/call-core-services/preset",
+                },
             ],
         },
         {
@@ -602,6 +606,10 @@ function sidebarDevelopment(): DefaultTheme.SidebarItem[] {
                             text: "消息渲染器 (Message Renderer)",
                             link: "/development/api-reference/middleware/message-renderer",
                         },
+                        {
+                            text: "Prompt 渲染服务 (Prompt Renderer)",
+                            link: "/development/api-reference/middleware/prompt-renderer",
+                        },
                         {
                             text: "消息转换器 (Message Transformer)",
                             link: "/development/api-reference/middleware/message-transformer",

docs/development/api-reference/chatluna-events.md

@@ -19,6 +19,53 @@ ChatLuna 的通用会话事件。
 
 当返回值为 `true`，ChatLuna 将不会处理该会话。
 
+## 聊天事件
+
+ChatLuna 的聊天流程事件。
+
+### 事件：chatluna/before-chat
+
+- **conversationId**: `string` 会话 ID
+- **message**: `HumanMessage` 用户发送的消息
+- **promptVariables**: `ChainValues` 当前可用的提示词变量
+- **chatInterface**: `ChatInterface` 当前聊天接口实例
+- **session**: `Session` 会话
+- **触发方式**: parallel
+
+在开始调用模型之前触发，可用于检查输入、动态修改提示词变量、注入提示词或提前拦截聊天流程。
+
+### 事件：chatluna/after-chat
+
+- **conversationId**: `string` 会话 ID
+- **sourceMessage**: `HumanMessage` 原始用户消息
+- **responseMessage**: `AIMessage` 模型返回的消息
+- **promptVariables**: `ChainValues` 调用时携带的提示词变量，包含 `chatCount` 等信息
+- **chatInterface**: `ChatInterface` 当前聊天接口实例
+- **session**: `Session` 会话
+- **触发方式**: parallel
+
+在模型生成回复后触发，可用于对回复进行记录、二次处理或推送至其他系统。
+
+### 事件：chatluna/clear-chat-history
+
+- **conversationId**: `string` 会话 ID
+- **chatInterface**: `ChatInterface` 当前聊天接口实例
+- **触发方式**: parallel
+
+当会话历史被清空时触发，方便同步清理缓存、外部存储或关联上下文。
+
+### 事件：chatluna/after-chat-error
+
+- **error**: `Error` 对话过程中捕获的异常对象
+- **conversationId**: `string` 会话 ID
+- **sourceMessage**: `HumanMessage` 原始用户消息
+- **promptVariables**: `ChainValues` 调用时的提示词变量
+- **chatInterface**: `ChatInterface` 当前聊天接口实例
+- **chain**: `ChatLunaLLMChainWrapper` 触发错误的链路实例（可选）
+- **触发方式**: parallel
+
+当聊天流程出现异常时触发，可用于日志上报、兜底回复或通知维护者。
+
 ## 生命周期事件
 
 ChatLuna 的生命周期事件，监听某些模型或者工具的变化。

docs/development/api-reference/chatluna-plugin.md

@@ -21,48 +21,54 @@ export class ChatLunaPlugin<
 - **platformName**: `PlatformClientNames` 平台名称
 - **createConfigPool**: `boolean` 是否创建配置池（默认为 `true`）
 
+构造函数会在上下文 `ready` 时自动安装插件，并在上下文销毁时自动卸载，无需额外调用注册方法。
+
 ### parseConfig()
 
 - **f**: `(config: T) => R[]` 配置解析函数
-- 返回值: `Promise<void>`
+- 返回值: `void`
 
 解析插件配置并添加到配置池中。
 
 ```typescript
-await plugin.parseConfig(config => [{
+plugin.parseConfig(config => [{
   apiKey: config.apiKey,
   baseURL: config.baseURL
 }])
 ```
 
-### initClients()
+### initClient()
 
 - 返回值: `Promise<void>`
 
-初始化平台客户端。该方法会：
+初始化当前平台的客户端。如果创建过程中发生错误会回滚安装流程并抛出异常。
 
-1. 注册配置池
-2. 创建所有客户端
-3. 更新支持的模型列表
+### dispose()
 
-### registerToService()
+销毁插件，清理所有注册的资源。
 
-注册插件到 ChatLuna 服务中。通常在插件初始化时调用。
+### supportedModels
 
-### dispose()
+- 返回值: `readonly string[]`
 
-销毁插件，清理所有注册的资源。
+获取当前插件可用的模型名称列表，形式为 `platform/model`。
+
+### platformConfigPool
+
+- 返回值: `ClientConfigPool<R>`
+
+访问插件的配置池，可用于自定义负载均衡策略或读取已解析的配置。
 
 ### registerClient()
 
-- **func**: `(ctx: Context, config: R) => BasePlatformClient` 客户端创建函数
+- **func**: `() => BasePlatformClient` 客户端创建函数
 - **platformName**: `string` 平台名称（可选，默认为插件的 platformName）
 - 返回值: `void`
 
 注册一个平台客户端。
 
 ```typescript
-plugin.registerClient((ctx, config) => new MyPlatformClient(ctx, config))
+plugin.registerClient(() => new MyPlatformClient(ctx, plugin.platformConfigPool))
 ```
 
 ### registerVectorStore()
@@ -85,11 +91,19 @@ plugin.registerClient((ctx, config) => new MyPlatformClient(ctx, config))
 
 - **name**: `string` 对话链名称
 - **description**: `Dict<string>` 多语言描述
-- **func**: `(params: CreateChatLunaLLMChainParams) => Promise<ChatLunaLLMChainWrapper>` 对话链创建函数
+- **func**: `(params: CreateChatLunaLLMChainParams) => ChatLunaLLMChainWrapper` 对话链创建函数
 - 返回值: `void`
 
 注册一个对话链提供者。
 
+### registerRenderer()
+
+- **name**: `string` 渲染器名称
+- **renderer**: `(ctx: Context, config: Config) => Renderer` 渲染器工厂函数
+- 返回值: `void`
+
+注册一个响应渲染器。
+
 ### fetch()
 
 - **info**: `RequestInfo` 请求信息
@@ -112,4 +126,4 @@ plugin.registerClient((ctx, config) => new MyPlatformClient(ctx, config))
 
 根据插件配置的代理模式创建 WebSocket 连接。
 
-支持与 fetch 相同的代理模式。
+支持与 fetch 相同的代理模式。

docs/development/api-reference/chatluna-service.md

@@ -4,12 +4,12 @@ ChatLuna 服务是整个系统的核心，用于管理插件、对话、模型
 
 ## 类：ChatLunaService
 
-### chatluna.registerPlugin()
+### chatluna.installPlugin()
 
 - **plugin**: `ChatLunaPlugin` 要注册的插件
 - 返回值: `Promise<void>`
 
-注册一个 ChatLuna 插件。如果插件已注册则会抛出错误。
+安装一个 ChatLuna 插件。如果同名插件已存在会抛出错误。插件通常会在构造函数中自动调用该方法。
 
 ### chatluna.awaitLoadPlatform()
 
@@ -19,18 +19,17 @@ ChatLuna 服务是整个系统的核心，用于管理插件、对话、模型
 
 等待平台加载完成。如果超时会抛出错误。
 
-### chatluna.unregisterPlugin()
+### chatluna.uninstallPlugin()
 
 - **plugin**: `ChatLunaPlugin | string` 插件实例或平台名称
-- **withError**: `boolean` 是否在插件不存在时抛出错误，默认为 true
 - 返回值: `void`
 
-注销一个 ChatLuna 插件。
+卸载一个 ChatLuna 插件。如果插件未安装将被忽略。
 
 ### chatluna.getPlugin()
 
 - **platformName**: `string` 平台名称
-- 返回值: `ChatLunaPlugin`
+- 返回值: `ChatLunaPlugin | undefined`
 
 获取指定平台名称的插件。
 
@@ -44,17 +43,17 @@ ChatLuna 服务是整个系统的核心，用于管理插件、对话、模型
 - **variables**: `Record<string, any>` 变量对象，默认为空对象
 - **postHandler**: `PostHandler` 后处理函数（可选）
 - **requestId**: `string` 请求 ID，默认自动生成
-- 返回值: `Promise<void>`
+- 返回值: `Promise<Message>`
 
-发起一个对话请求。
+发起一个对话请求，返回最终回复消息。部分模型会附带 `additionalReplyMessages` 用于展示思考过程等扩展内容。
 
 ### chatluna.stopChat()
 
 - **room**: `ConversationRoom` 对话房间
 - **requestId**: `string` 请求 ID
-- 返回值: `Promise<void>`
+- 返回值: `Promise<boolean | undefined>`
 
-停止指定请求 ID 的对话。
+尝试停止指定请求 ID 的对话。当没有找到对应请求时返回 `false`，如果会话尚未创建则返回 `undefined`。
 
 ### chatluna.clearChatHistory()
 
@@ -66,25 +65,25 @@ ChatLuna 服务是整个系统的核心，用于管理插件、对话、模型
 ### chatluna.clearCache()
 
 - **room**: `ConversationRoom` 对话房间
-- 返回值: `Promise<void>`
+- 返回值: `Promise<boolean>`
 
-清除指定房间的缓存。
+清除指定房间的缓存并同步触发 `chatluna/clear-chat-history` 事件。返回值表示是否成功移除缓存的聊天接口。
 
 ### chatluna.createChatModel()
 
 - **platformName**: `string` 平台名称
 - **model**: `string` 模型名称
-- 返回值: `Promise<ChatLunaChatModel>`
+- 返回值: `Promise<ComputedRef<ChatLunaChatModel | undefined>>`
 
-创建一个聊天模型实例。
+创建一个聊天模型的计算引用。也支持直接传入 `platform/model` 组合字符串。
 
 ### chatluna.createEmbeddings()
 
 - **platformName**: `string` 平台名称
 - **modelName**: `string` 模型名称
-- 返回值: `Promise<ChatHubBaseEmbeddings>`
+- 返回值: `Promise<ComputedRef<Embeddings | undefined>>`
 
-创建一个嵌入模型实例。
+创建一个嵌入模型的计算引用。若模型不可用会回退为空嵌入实现。
 
 ### 属性
 
@@ -129,3 +128,10 @@ ChatLuna 服务是整个系统的核心，用于管理插件、对话、模型
 - **只读**
 
 默认渲染器实例。
+
+#### chatluna.promptRenderer
+
+- **类型**: `ChatLunaPromptRenderService`
+- **只读**
+
+提示词渲染服务实例。