@opentiny/tiny-robot-kit 0.2.0-alpha.0 → 0.2.0-alpha.1

package/README.md

@@ -162,3 +162,128 @@ enum STATUS {
   ERROR = 'error', // AI请求发生错误
 }
 ```
+
+### useConversation
+
+对话管理与数据持久化
+
+#### 基本用法
+
+```typescript
+import { useConversation, AIClient } from '@opentiny/tiny-robot-kit'
+
+const client = new AIClient({
+  provider: 'openai',
+  apiKey: 'your-api-key',
+  defaultModel: 'gpt-3.5-turbo'
+});
+
+const {
+  state,
+  messageManager, // 与 useMessage 返回一致，具体查看useMessage
+  createConversation,
+  switchConversation,
+  deleteConversation,
+  // ...
+} = useConversation({ client })
+
+const conversationId = createConversation('新对话')
+
+messageManager.sendMessage('你好，请介绍一下自己')
+```
+
+#### 返回值
+
+`useConversation` 返回以下内容：
+
+```typescript
+interface UseConversationReturn {
+  /** 会话状态 */
+  state: ConversationState;
+  /** 消息管理 */
+  messageManager: UseMessageReturn;
+  /** 创建新会话 */
+  createConversation: (title?: string, metadata?: Record<string, any>) => string;
+  /** 切换会话 */
+  switchConversation: (id: string) => void;
+  /** 删除会话 */
+  deleteConversation: (id: string) => void;
+  /** 更新会话标题 */
+  updateTitle: (id: string, title: string) => void;
+  /** 更新会话元数据 */
+  updateMetadata: (id: string, metadata: Record<string, any>) => void;
+  /** 保存会话 */
+  saveConversations: () => Promise<void>;
+  /** 加载会话 */
+  loadConversations: () => Promise<void>;
+  /** 生成会话标题 */
+  generateTitle: (id: string) => Promise<string>;
+  /** 获取当前会话 */
+  getCurrentConversation: () => Conversation | null;
+}
+```
+
+#### 会话状态
+
+```typescript
+interface ConversationState {
+  /** 会话列表 */
+  conversations: Conversation[];
+  /** 当前会话ID */
+  currentId: string | null;
+  /** 是否正在加载 */
+  loading: boolean;
+}
+```
+
+#### 会话接口
+
+```typescript
+
+interface Conversation {
+  /** 会话ID */
+  id: string;
+  /** 会话标题 */
+  title: string;
+  /** 创建时间 */
+  createdAt: number;
+  /** 更新时间 */
+  updatedAt: number;
+  /** 自定义元数据 */
+  metadata?: Record<string, any>;
+  /** 消息 */
+  messages: ChatMessage[];
+}
+```
+
+#### 自定义存储策略
+
+默认使用 LocalStorage 存储会话数据，你也可以实现自定义的存储策略：
+
+```typescript
+interface ConversationStorageStrategy {
+  /** 保存会话列表 */
+  saveConversations: (conversations: Conversation[]) => Promise<void> | void;
+  /** 加载会话列表 */
+  loadConversations: () => Promise<Conversation[]> | Conversation[];
+}
+
+// 自定义存储策略示例
+class CustomStorageStrategy implements ConversationStorageStrategy {
+  async saveConversations(conversations: Conversation[]) {
+    // 实现自定义存储逻辑
+  }
+
+  async loadConversations(): Promise<Conversation[]> {
+    // 实现自定义加载逻辑
+    return [];
+  }
+}
+
+// 使用自定义存储策略
+const conversationManager = useConversation({
+  client,
+  storage: new CustomStorageStrategy(),
+});
+```
+

package/dist/index.d.mts

@@ -348,4 +348,106 @@ interface UseMessageReturn {
  */
 declare function useMessage(options: UseMessageOptions): UseMessageReturn;
 
-export { type AIAdapterError, AIClient, type AIModelConfig, type AIProvider, BaseModelProvider, type ChatCompletionOptions, type ChatCompletionRequest, type ChatCompletionResponse, type ChatCompletionResponseChoice, type ChatCompletionResponseMessage, type ChatCompletionResponseUsage, type ChatCompletionStreamResponse, type ChatCompletionStreamResponseChoice, type ChatCompletionStreamResponseDelta, type ChatHistory, type ChatMessage, ErrorType, FinalStatus, GeneratingStatus, type MessageRole, type MessageState, OpenAIProvider, STATUS, StreamEventType, type StreamHandler, type UseMessageOptions, type UseMessageReturn, extractTextFromResponse, formatMessages, useMessage };
+/**
+ * useConversation composable
+ * 提供会话管理和持久化功能
+ */
+
+/**
+ * 会话接口
+ */
+interface Conversation {
+    /** 会话ID */
+    id: string;
+    /** 会话标题 */
+    title: string;
+    /** 创建时间 */
+    createdAt: number;
+    /** 更新时间 */
+    updatedAt: number;
+    /** 自定义元数据 */
+    metadata?: Record<string, unknown>;
+    /** 会话消息 */
+    messages: ChatMessage[];
+}
+/**
+ * 存储策略接口
+ */
+interface ConversationStorageStrategy {
+    /** 保存会话列表 */
+    saveConversations: (conversations: Conversation[]) => Promise<void> | void;
+    /** 加载会话列表 */
+    loadConversations: () => Promise<Conversation[]> | Conversation[];
+}
+/**
+ * 本地存储策略
+ */
+declare class LocalStorageStrategy implements ConversationStorageStrategy {
+    private storageKey;
+    constructor(storageKey?: string);
+    saveConversations(conversations: Conversation[]): void;
+    loadConversations(): Conversation[];
+}
+/**
+ * 会话状态接口
+ */
+interface ConversationState {
+    /** 会话列表 */
+    conversations: Conversation[];
+    /** 当前会话ID */
+    currentId: string | null;
+    /** 是否正在加载 */
+    loading: boolean;
+}
+/**
+ * useConversation选项接口
+ */
+interface UseConversationOptions {
+    /** AI客户端实例 */
+    client: AIClient;
+    /** 存储策略 */
+    storage?: ConversationStorageStrategy;
+    /** 是否自动保存 */
+    autoSave?: boolean;
+    /** 是否默认使用流式响应 */
+    useStreamByDefault?: boolean;
+    /** 错误消息模板 */
+    errorMessage?: string;
+}
+/**
+ * useConversation返回值接口
+ */
+interface UseConversationReturn {
+    /** 会话状态 */
+    state: ConversationState;
+    /** 消息管理 */
+    messageManager: UseMessageReturn;
+    /** 创建新会话 */
+    createConversation: (title?: string, metadata?: Record<string, unknown>) => string;
+    /** 切换会话 */
+    switchConversation: (id: string) => void;
+    /** 删除会话 */
+    deleteConversation: (id: string) => void;
+    /** 更新会话标题 */
+    updateTitle: (id: string, title: string) => void;
+    /** 更新会话元数据 */
+    updateMetadata: (id: string, metadata: Record<string, unknown>) => void;
+    /** 保存会话 */
+    saveConversations: () => Promise<void>;
+    /** 加载会话 */
+    loadConversations: () => Promise<void>;
+    /** 生成会话标题 */
+    generateTitle: (id: string) => Promise<string>;
+    /** 获取当前会话 */
+    getCurrentConversation: () => Conversation | null;
+}
+/**
+ * useConversation composable
+ * 提供会话管理和持久化功能
+ *
+ * @param options useConversation选项
+ * @returns UseConversationReturn
+ */
+declare function useConversation(options: UseConversationOptions): UseConversationReturn;
+
+export { type AIAdapterError, AIClient, type AIModelConfig, type AIProvider, BaseModelProvider, type ChatCompletionOptions, type ChatCompletionRequest, type ChatCompletionResponse, type ChatCompletionResponseChoice, type ChatCompletionResponseMessage, type ChatCompletionResponseUsage, type ChatCompletionStreamResponse, type ChatCompletionStreamResponseChoice, type ChatCompletionStreamResponseDelta, type ChatHistory, type ChatMessage, type Conversation, type ConversationState, type ConversationStorageStrategy, ErrorType, FinalStatus, GeneratingStatus, LocalStorageStrategy, type MessageRole, type MessageState, OpenAIProvider, STATUS, StreamEventType, type StreamHandler, type UseConversationOptions, type UseConversationReturn, type UseMessageOptions, type UseMessageReturn, extractTextFromResponse, formatMessages, useConversation, useMessage };

package/dist/index.d.ts

@@ -348,4 +348,106 @@ interface UseMessageReturn {
  */
 declare function useMessage(options: UseMessageOptions): UseMessageReturn;
 
-export { type AIAdapterError, AIClient, type AIModelConfig, type AIProvider, BaseModelProvider, type ChatCompletionOptions, type ChatCompletionRequest, type ChatCompletionResponse, type ChatCompletionResponseChoice, type ChatCompletionResponseMessage, type ChatCompletionResponseUsage, type ChatCompletionStreamResponse, type ChatCompletionStreamResponseChoice, type ChatCompletionStreamResponseDelta, type ChatHistory, type ChatMessage, ErrorType, FinalStatus, GeneratingStatus, type MessageRole, type MessageState, OpenAIProvider, STATUS, StreamEventType, type StreamHandler, type UseMessageOptions, type UseMessageReturn, extractTextFromResponse, formatMessages, useMessage };
+/**
+ * useConversation composable
+ * 提供会话管理和持久化功能
+ */
+
+/**
+ * 会话接口
+ */
+interface Conversation {
+    /** 会话ID */
+    id: string;
+    /** 会话标题 */
+    title: string;
+    /** 创建时间 */
+    createdAt: number;
+    /** 更新时间 */
+    updatedAt: number;
+    /** 自定义元数据 */
+    metadata?: Record<string, unknown>;
+    /** 会话消息 */
+    messages: ChatMessage[];
+}
+/**
+ * 存储策略接口
+ */
+interface ConversationStorageStrategy {
+    /** 保存会话列表 */
+    saveConversations: (conversations: Conversation[]) => Promise<void> | void;
+    /** 加载会话列表 */
+    loadConversations: () => Promise<Conversation[]> | Conversation[];
+}
+/**
+ * 本地存储策略
+ */
+declare class LocalStorageStrategy implements ConversationStorageStrategy {
+    private storageKey;
+    constructor(storageKey?: string);
+    saveConversations(conversations: Conversation[]): void;
+    loadConversations(): Conversation[];
+}
+/**
+ * 会话状态接口
+ */
+interface ConversationState {
+    /** 会话列表 */
+    conversations: Conversation[];
+    /** 当前会话ID */
+    currentId: string | null;
+    /** 是否正在加载 */
+    loading: boolean;
+}
+/**
+ * useConversation选项接口
+ */
+interface UseConversationOptions {
+    /** AI客户端实例 */
+    client: AIClient;
+    /** 存储策略 */
+    storage?: ConversationStorageStrategy;
+    /** 是否自动保存 */
+    autoSave?: boolean;
+    /** 是否默认使用流式响应 */
+    useStreamByDefault?: boolean;
+    /** 错误消息模板 */
+    errorMessage?: string;
+}
+/**
+ * useConversation返回值接口
+ */
+interface UseConversationReturn {
+    /** 会话状态 */
+    state: ConversationState;
+    /** 消息管理 */
+    messageManager: UseMessageReturn;
+    /** 创建新会话 */
+    createConversation: (title?: string, metadata?: Record<string, unknown>) => string;
+    /** 切换会话 */
+    switchConversation: (id: string) => void;
+    /** 删除会话 */
+    deleteConversation: (id: string) => void;
+    /** 更新会话标题 */
+    updateTitle: (id: string, title: string) => void;
+    /** 更新会话元数据 */
+    updateMetadata: (id: string, metadata: Record<string, unknown>) => void;
+    /** 保存会话 */
+    saveConversations: () => Promise<void>;
+    /** 加载会话 */
+    loadConversations: () => Promise<void>;
+    /** 生成会话标题 */
+    generateTitle: (id: string) => Promise<string>;
+    /** 获取当前会话 */
+    getCurrentConversation: () => Conversation | null;
+}
+/**
+ * useConversation composable
+ * 提供会话管理和持久化功能
+ *
+ * @param options useConversation选项
+ * @returns UseConversationReturn
+ */
+declare function useConversation(options: UseConversationOptions): UseConversationReturn;
+
+export { type AIAdapterError, AIClient, type AIModelConfig, type AIProvider, BaseModelProvider, type ChatCompletionOptions, type ChatCompletionRequest, type ChatCompletionResponse, type ChatCompletionResponseChoice, type ChatCompletionResponseMessage, type ChatCompletionResponseUsage, type ChatCompletionStreamResponse, type ChatCompletionStreamResponseChoice, type ChatCompletionStreamResponseDelta, type ChatHistory, type ChatMessage, type Conversation, type ConversationState, type ConversationStorageStrategy, ErrorType, FinalStatus, GeneratingStatus, LocalStorageStrategy, type MessageRole, type MessageState, OpenAIProvider, STATUS, StreamEventType, type StreamHandler, type UseConversationOptions, type UseConversationReturn, type UseMessageOptions, type UseMessageReturn, extractTextFromResponse, formatMessages, useConversation, useMessage };

package/dist/index.js

@@ -25,11 +25,13 @@ __export(index_exports, {
   ErrorType: () => ErrorType,
   FinalStatus: () => FinalStatus,
   GeneratingStatus: () => GeneratingStatus,
+  LocalStorageStrategy: () => LocalStorageStrategy,
   OpenAIProvider: () => OpenAIProvider,
   STATUS: () => STATUS,
   StreamEventType: () => StreamEventType,
   extractTextFromResponse: () => extractTextFromResponse,
   formatMessages: () => formatMessages,
+  useConversation: () => useConversation,
   useMessage: () => useMessage
 });
 module.exports = __toCommonJS(index_exports);
@@ -266,14 +268,15 @@ var OpenAIProvider = class extends BaseModelProvider {
         ...request.options,
         stream: false
       };
-      const response = await fetch(`${this.baseURL}/chat/completions`, {
+      const options = {
         method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          Authorization: `Bearer ${this.apiKey}`
-        },
+        headers: { "Content-Type": "application/json" },
         body: JSON.stringify(requestData)
-      });
+      };
+      if (this.apiKey) {
+        Object.assign(options.headers, { Authorization: `Bearer ${this.apiKey}` });
+      }
+      const response = await fetch(`${this.baseURL}/chat/completions`, options);
       if (!response.ok) {
         const errorText = await response.text();
         throw new Error(`HTTP error! status: ${response.status}, details: ${errorText}`);
@@ -298,7 +301,7 @@ var OpenAIProvider = class extends BaseModelProvider {
         ...options,
         stream: true
       };
-      const response = await fetch(`${this.baseURL}/chat/completions`, {
+      const requestOptions = {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
@@ -307,7 +310,11 @@ var OpenAIProvider = class extends BaseModelProvider {
         },
         body: JSON.stringify(requestData),
         signal
-      });
+      };
+      if (this.apiKey) {
+        Object.assign(requestOptions.headers, { Authorization: `Bearer ${this.apiKey}` });
+      }
+      const response = await fetch(`${this.baseURL}/chat/completions`, requestOptions);
       if (!response.ok) {
         const errorText = await response.text();
         throw new Error(`HTTP error! status: ${response.status}, details: ${errorText}`);
@@ -411,7 +418,7 @@ var AIClient = class {
   }
 };
 
-// src/vue/useMessage.ts
+// src/vue/message/useMessage.ts
 var import_vue = require("vue");
 var STATUS = /* @__PURE__ */ ((STATUS2) => {
   STATUS2["INIT"] = "init";
@@ -463,7 +470,7 @@ function useMessage(options) {
           if (messages.value[messages.value.length - 1].role === "user") {
             messages.value.push({ role: "assistant", content: "" });
           }
-          const choice = data.choices[0];
+          const choice = data.choices?.[0];
           if (choice && choice.delta.content) {
             messages.value[messages.value.length - 1].content += choice.delta.content;
           }
@@ -545,6 +552,198 @@ function useMessage(options) {
     retryRequest
   };
 }
+
+// src/vue/conversation/useConversation.ts
+var import_vue2 = require("vue");
+var LocalStorageStrategy = class {
+  constructor(storageKey = "tiny-robot-ai-conversations") {
+    this.storageKey = storageKey;
+  }
+  saveConversations(conversations) {
+    try {
+      localStorage.setItem(this.storageKey, JSON.stringify(conversations));
+    } catch (error) {
+      console.error("\u4FDD\u5B58\u4F1A\u8BDD\u5931\u8D25:", error);
+    }
+  }
+  loadConversations() {
+    try {
+      const data = localStorage.getItem(this.storageKey);
+      return data ? JSON.parse(data) : [];
+    } catch (error) {
+      console.error("\u52A0\u8F7D\u4F1A\u8BDD\u5931\u8D25:", error);
+      return [];
+    }
+  }
+};
+function generateId() {
+  return Date.now().toString(36) + Math.random().toString(36).substring(2, 9);
+}
+function useConversation(options) {
+  const {
+    client,
+    storage = new LocalStorageStrategy(),
+    autoSave = true,
+    useStreamByDefault = true,
+    errorMessage = "\u8BF7\u6C42\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5"
+  } = options;
+  const state = (0, import_vue2.reactive)({
+    conversations: [],
+    currentId: null,
+    loading: false
+  });
+  const messageManager = useMessage({
+    client,
+    useStreamByDefault,
+    errorMessage,
+    initialMessages: []
+  });
+  (0, import_vue2.watch)(
+    () => messageManager.messages.value,
+    (messages) => {
+      if (state.currentId && messages.length > 0) {
+        const index = state.conversations.findIndex((row) => row.id === state.currentId);
+        if (index !== -1) {
+          state.conversations[index].messages = [...messages];
+          state.conversations[index].updatedAt = Date.now();
+          if (autoSave) {
+            saveConversations();
+          }
+        }
+      }
+    },
+    { deep: true }
+  );
+  const createConversation = (title = "\u65B0\u4F1A\u8BDD", metadata = {}) => {
+    const id = generateId();
+    const newConversation = {
+      id,
+      title,
+      createdAt: Date.now(),
+      updatedAt: Date.now(),
+      messages: [],
+      metadata
+    };
+    state.conversations.unshift(newConversation);
+    switchConversation(id);
+    if (autoSave) {
+      saveConversations();
+    }
+    return id;
+  };
+  const switchConversation = (id) => {
+    const conversation = state.conversations.find((conv) => conv.id === id);
+    if (conversation) {
+      state.currentId = id;
+      messageManager.clearMessages();
+      if (conversation.messages.length > 0) {
+        conversation.messages.forEach((msg) => messageManager.addMessage(msg));
+      }
+    }
+  };
+  const deleteConversation = (id) => {
+    const index = state.conversations.findIndex((conv) => conv.id === id);
+    if (index !== -1) {
+      state.conversations.splice(index, 1);
+      if (state.currentId === id) {
+        if (state.conversations.length > 0) {
+          switchConversation(state.conversations[0].id);
+        } else {
+          state.currentId = null;
+          messageManager.clearMessages();
+        }
+      }
+      if (autoSave) {
+        saveConversations();
+      }
+    }
+  };
+  const updateTitle = (id, title) => {
+    const conversation = state.conversations.find((conv) => conv.id === id);
+    if (conversation) {
+      conversation.title = title;
+      conversation.updatedAt = Date.now();
+      if (autoSave) {
+        saveConversations();
+      }
+    }
+  };
+  const updateMetadata = (id, metadata) => {
+    const conversation = state.conversations.find((conv) => conv.id === id);
+    if (conversation) {
+      conversation.metadata = { ...conversation.metadata, ...metadata };
+      conversation.updatedAt = Date.now();
+      if (autoSave) {
+        saveConversations();
+      }
+    }
+  };
+  const saveConversations = async () => {
+    try {
+      await storage.saveConversations(state.conversations);
+    } catch (error) {
+      console.error("\u4FDD\u5B58\u4F1A\u8BDD\u5931\u8D25:", error);
+    }
+  };
+  const loadConversations = async () => {
+    state.loading = true;
+    try {
+      const conversations = await storage.loadConversations();
+      state.conversations = conversations;
+      if (conversations.length > 0 && !state.currentId) {
+        switchConversation(conversations[0].id);
+      }
+    } catch (error) {
+      console.error("\u52A0\u8F7D\u4F1A\u8BDD\u5931\u8D25:", error);
+    } finally {
+      state.loading = false;
+    }
+  };
+  const generateTitle = async (id) => {
+    const conversation = state.conversations.find((conv) => conv.id === id);
+    if (!conversation || conversation.messages.length < 2) {
+      return conversation?.title || "\u65B0\u4F1A\u8BDD";
+    }
+    try {
+      const prompt = {
+        role: "system",
+        content: "\u8BF7\u6839\u636E\u4EE5\u4E0B\u5BF9\u8BDD\u5185\u5BB9\uFF0C\u751F\u6210\u4E00\u4E2A\u7B80\u77ED\u7684\u6807\u9898\uFF08\u4E0D\u8D85\u8FC720\u4E2A\u5B57\u7B26\uFF09\u3002\u53EA\u9700\u8981\u8FD4\u56DE\u6807\u9898\u6587\u672C\uFF0C\u4E0D\u9700\u8981\u4EFB\u4F55\u89E3\u91CA\u6216\u989D\u5916\u5185\u5BB9\u3002"
+      };
+      const contextMessages = conversation.messages.slice(0, Math.min(4, conversation.messages.length));
+      const response = await client.chat({
+        messages: [prompt, ...contextMessages],
+        options: {
+          stream: false,
+          max_tokens: 30
+        }
+      });
+      const title = response.choices[0].message.content.trim();
+      updateTitle(id, title);
+      return title;
+    } catch (error) {
+      console.error("\u751F\u6210\u6807\u9898\u5931\u8D25:", error);
+      return conversation.title;
+    }
+  };
+  const getCurrentConversation = () => {
+    if (!state.currentId) return null;
+    return state.conversations.find((conv) => conv.id === state.currentId) || null;
+  };
+  loadConversations();
+  return {
+    state,
+    messageManager,
+    createConversation,
+    switchConversation,
+    deleteConversation,
+    updateTitle,
+    updateMetadata,
+    saveConversations,
+    loadConversations,
+    generateTitle,
+    getCurrentConversation
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AIClient,
@@ -552,10 +751,12 @@ function useMessage(options) {
   ErrorType,
   FinalStatus,
   GeneratingStatus,
+  LocalStorageStrategy,
   OpenAIProvider,
   STATUS,
   StreamEventType,
   extractTextFromResponse,
   formatMessages,
+  useConversation,
   useMessage
 });

package/dist/index.mjs

@@ -230,14 +230,15 @@ var OpenAIProvider = class extends BaseModelProvider {
         ...request.options,
         stream: false
       };
-      const response = await fetch(`${this.baseURL}/chat/completions`, {
+      const options = {
         method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          Authorization: `Bearer ${this.apiKey}`
-        },
+        headers: { "Content-Type": "application/json" },
         body: JSON.stringify(requestData)
-      });
+      };
+      if (this.apiKey) {
+        Object.assign(options.headers, { Authorization: `Bearer ${this.apiKey}` });
+      }
+      const response = await fetch(`${this.baseURL}/chat/completions`, options);
       if (!response.ok) {
         const errorText = await response.text();
         throw new Error(`HTTP error! status: ${response.status}, details: ${errorText}`);
@@ -262,7 +263,7 @@ var OpenAIProvider = class extends BaseModelProvider {
         ...options,
         stream: true
       };
-      const response = await fetch(`${this.baseURL}/chat/completions`, {
+      const requestOptions = {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
@@ -271,7 +272,11 @@ var OpenAIProvider = class extends BaseModelProvider {
         },
         body: JSON.stringify(requestData),
         signal
-      });
+      };
+      if (this.apiKey) {
+        Object.assign(requestOptions.headers, { Authorization: `Bearer ${this.apiKey}` });
+      }
+      const response = await fetch(`${this.baseURL}/chat/completions`, requestOptions);
       if (!response.ok) {
         const errorText = await response.text();
         throw new Error(`HTTP error! status: ${response.status}, details: ${errorText}`);
@@ -375,7 +380,7 @@ var AIClient = class {
   }
 };
 
-// src/vue/useMessage.ts
+// src/vue/message/useMessage.ts
 import { reactive, ref, toRaw } from "vue";
 var STATUS = /* @__PURE__ */ ((STATUS2) => {
   STATUS2["INIT"] = "init";
@@ -427,7 +432,7 @@ function useMessage(options) {
           if (messages.value[messages.value.length - 1].role === "user") {
             messages.value.push({ role: "assistant", content: "" });
           }
-          const choice = data.choices[0];
+          const choice = data.choices?.[0];
           if (choice && choice.delta.content) {
             messages.value[messages.value.length - 1].content += choice.delta.content;
           }
@@ -509,16 +514,210 @@ function useMessage(options) {
     retryRequest
   };
 }
+
+// src/vue/conversation/useConversation.ts
+import { reactive as reactive2, watch } from "vue";
+var LocalStorageStrategy = class {
+  constructor(storageKey = "tiny-robot-ai-conversations") {
+    this.storageKey = storageKey;
+  }
+  saveConversations(conversations) {
+    try {
+      localStorage.setItem(this.storageKey, JSON.stringify(conversations));
+    } catch (error) {
+      console.error("\u4FDD\u5B58\u4F1A\u8BDD\u5931\u8D25:", error);
+    }
+  }
+  loadConversations() {
+    try {
+      const data = localStorage.getItem(this.storageKey);
+      return data ? JSON.parse(data) : [];
+    } catch (error) {
+      console.error("\u52A0\u8F7D\u4F1A\u8BDD\u5931\u8D25:", error);
+      return [];
+    }
+  }
+};
+function generateId() {
+  return Date.now().toString(36) + Math.random().toString(36).substring(2, 9);
+}
+function useConversation(options) {
+  const {
+    client,
+    storage = new LocalStorageStrategy(),
+    autoSave = true,
+    useStreamByDefault = true,
+    errorMessage = "\u8BF7\u6C42\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5"
+  } = options;
+  const state = reactive2({
+    conversations: [],
+    currentId: null,
+    loading: false
+  });
+  const messageManager = useMessage({
+    client,
+    useStreamByDefault,
+    errorMessage,
+    initialMessages: []
+  });
+  watch(
+    () => messageManager.messages.value,
+    (messages) => {
+      if (state.currentId && messages.length > 0) {
+        const index = state.conversations.findIndex((row) => row.id === state.currentId);
+        if (index !== -1) {
+          state.conversations[index].messages = [...messages];
+          state.conversations[index].updatedAt = Date.now();
+          if (autoSave) {
+            saveConversations();
+          }
+        }
+      }
+    },
+    { deep: true }
+  );
+  const createConversation = (title = "\u65B0\u4F1A\u8BDD", metadata = {}) => {
+    const id = generateId();
+    const newConversation = {
+      id,
+      title,
+      createdAt: Date.now(),
+      updatedAt: Date.now(),
+      messages: [],
+      metadata
+    };
+    state.conversations.unshift(newConversation);
+    switchConversation(id);
+    if (autoSave) {
+      saveConversations();
+    }
+    return id;
+  };
+  const switchConversation = (id) => {
+    const conversation = state.conversations.find((conv) => conv.id === id);
+    if (conversation) {
+      state.currentId = id;
+      messageManager.clearMessages();
+      if (conversation.messages.length > 0) {
+        conversation.messages.forEach((msg) => messageManager.addMessage(msg));
+      }
+    }
+  };
+  const deleteConversation = (id) => {
+    const index = state.conversations.findIndex((conv) => conv.id === id);
+    if (index !== -1) {
+      state.conversations.splice(index, 1);
+      if (state.currentId === id) {
+        if (state.conversations.length > 0) {
+          switchConversation(state.conversations[0].id);
+        } else {
+          state.currentId = null;
+          messageManager.clearMessages();
+        }
+      }
+      if (autoSave) {
+        saveConversations();
+      }
+    }
+  };
+  const updateTitle = (id, title) => {
+    const conversation = state.conversations.find((conv) => conv.id === id);
+    if (conversation) {
+      conversation.title = title;
+      conversation.updatedAt = Date.now();
+      if (autoSave) {
+        saveConversations();
+      }
+    }
+  };
+  const updateMetadata = (id, metadata) => {
+    const conversation = state.conversations.find((conv) => conv.id === id);
+    if (conversation) {
+      conversation.metadata = { ...conversation.metadata, ...metadata };
+      conversation.updatedAt = Date.now();
+      if (autoSave) {
+        saveConversations();
+      }
+    }
+  };
+  const saveConversations = async () => {
+    try {
+      await storage.saveConversations(state.conversations);
+    } catch (error) {
+      console.error("\u4FDD\u5B58\u4F1A\u8BDD\u5931\u8D25:", error);
+    }
+  };
+  const loadConversations = async () => {
+    state.loading = true;
+    try {
+      const conversations = await storage.loadConversations();
+      state.conversations = conversations;
+      if (conversations.length > 0 && !state.currentId) {
+        switchConversation(conversations[0].id);
+      }
+    } catch (error) {
+      console.error("\u52A0\u8F7D\u4F1A\u8BDD\u5931\u8D25:", error);
+    } finally {
+      state.loading = false;
+    }
+  };
+  const generateTitle = async (id) => {
+    const conversation = state.conversations.find((conv) => conv.id === id);
+    if (!conversation || conversation.messages.length < 2) {
+      return conversation?.title || "\u65B0\u4F1A\u8BDD";
+    }
+    try {
+      const prompt = {
+        role: "system",
+        content: "\u8BF7\u6839\u636E\u4EE5\u4E0B\u5BF9\u8BDD\u5185\u5BB9\uFF0C\u751F\u6210\u4E00\u4E2A\u7B80\u77ED\u7684\u6807\u9898\uFF08\u4E0D\u8D85\u8FC720\u4E2A\u5B57\u7B26\uFF09\u3002\u53EA\u9700\u8981\u8FD4\u56DE\u6807\u9898\u6587\u672C\uFF0C\u4E0D\u9700\u8981\u4EFB\u4F55\u89E3\u91CA\u6216\u989D\u5916\u5185\u5BB9\u3002"
+      };
+      const contextMessages = conversation.messages.slice(0, Math.min(4, conversation.messages.length));
+      const response = await client.chat({
+        messages: [prompt, ...contextMessages],
+        options: {
+          stream: false,
+          max_tokens: 30
+        }
+      });
+      const title = response.choices[0].message.content.trim();
+      updateTitle(id, title);
+      return title;
+    } catch (error) {
+      console.error("\u751F\u6210\u6807\u9898\u5931\u8D25:", error);
+      return conversation.title;
+    }
+  };
+  const getCurrentConversation = () => {
+    if (!state.currentId) return null;
+    return state.conversations.find((conv) => conv.id === state.currentId) || null;
+  };
+  loadConversations();
+  return {
+    state,
+    messageManager,
+    createConversation,
+    switchConversation,
+    deleteConversation,
+    updateTitle,
+    updateMetadata,
+    saveConversations,
+    loadConversations,
+    generateTitle,
+    getCurrentConversation
+  };
+}
 export {
   AIClient,
   BaseModelProvider,
   ErrorType,
   FinalStatus,
   GeneratingStatus,
+  LocalStorageStrategy,
   OpenAIProvider,
   STATUS,
   StreamEventType,
   extractTextFromResponse,
   formatMessages,
+  useConversation,
   useMessage
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opentiny/tiny-robot-kit",
-  "version": "0.2.0-alpha.0",
+  "version": "0.2.0-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -22,5 +22,5 @@
   "peerDependencies": {
     "vue": ">=3.0.0"
   },
-  "gitHead": "3517724651afbbb05b1be20487a9f3341c06133c"
+  "gitHead": "3000951723ed8b1caa1361ebac131229bec9c237"
 }

package/src/providers/openai.ts

@@ -48,14 +48,15 @@ export class OpenAIProvider extends BaseModelProvider {
         stream: false,
       }
 
-      const response = await fetch(`${this.baseURL}/chat/completions`, {
+      const options = {
         method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          Authorization: `Bearer ${this.apiKey}`,
-        },
+        headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify(requestData),
-      })
+      }
+      if (this.apiKey) {
+        Object.assign(options.headers, { Authorization: `Bearer ${this.apiKey}` })
+      }
+      const response = await fetch(`${this.baseURL}/chat/completions`, options)
 
       if (!response.ok) {
         const errorText = await response.text()
@@ -88,7 +89,7 @@ export class OpenAIProvider extends BaseModelProvider {
         stream: true,
       }
 
-      const response = await fetch(`${this.baseURL}/chat/completions`, {
+      const requestOptions = {
         method: 'POST',
         headers: {
           'Content-Type': 'application/json',
@@ -97,7 +98,11 @@ export class OpenAIProvider extends BaseModelProvider {
         },
         body: JSON.stringify(requestData),
         signal,
-      })
+      }
+      if (this.apiKey) {
+        Object.assign(requestOptions.headers, { Authorization: `Bearer ${this.apiKey}` })
+      }
+      const response = await fetch(`${this.baseURL}/chat/completions`, requestOptions)
 
       if (!response.ok) {
         const errorText = await response.text()

package/src/vue/conversation/useConversation.ts

@@ -0,0 +1,365 @@
+/**
+ * useConversation composable
+ * 提供会话管理和持久化功能
+ */
+
+import { reactive, watch } from 'vue'
+import type { ChatMessage } from '../../types'
+import { useMessage, type UseMessageReturn } from '../message/useMessage'
+import type { AIClient } from '../../client'
+
+/**
+ * 会话接口
+ */
+export interface Conversation {
+  /** 会话ID */
+  id: string
+  /** 会话标题 */
+  title: string
+  /** 创建时间 */
+  createdAt: number
+  /** 更新时间 */
+  updatedAt: number
+  /** 自定义元数据 */
+  metadata?: Record<string, unknown>
+  /** 会话消息 */
+  messages: ChatMessage[]
+}
+
+/**
+ * 存储策略接口
+ */
+export interface ConversationStorageStrategy {
+  /** 保存会话列表 */
+  saveConversations: (conversations: Conversation[]) => Promise<void> | void
+  /** 加载会话列表 */
+  loadConversations: () => Promise<Conversation[]> | Conversation[]
+}
+
+/**
+ * 本地存储策略
+ */
+export class LocalStorageStrategy implements ConversationStorageStrategy {
+  private storageKey: string
+
+  constructor(storageKey: string = 'tiny-robot-ai-conversations') {
+    this.storageKey = storageKey
+  }
+
+  saveConversations(conversations: Conversation[]): void {
+    try {
+      localStorage.setItem(this.storageKey, JSON.stringify(conversations))
+    } catch (error) {
+      console.error('保存会话失败:', error)
+    }
+  }
+
+  loadConversations(): Conversation[] {
+    try {
+      const data = localStorage.getItem(this.storageKey)
+      return data ? JSON.parse(data) : []
+    } catch (error) {
+      console.error('加载会话失败:', error)
+      return []
+    }
+  }
+}
+
+/**
+ * 会话状态接口
+ */
+export interface ConversationState {
+  /** 会话列表 */
+  conversations: Conversation[]
+  /** 当前会话ID */
+  currentId: string | null
+  /** 是否正在加载 */
+  loading: boolean
+}
+
+/**
+ * useConversation选项接口
+ */
+export interface UseConversationOptions {
+  /** AI客户端实例 */
+  client: AIClient
+  /** 存储策略 */
+  storage?: ConversationStorageStrategy
+  /** 是否自动保存 */
+  autoSave?: boolean
+  /** 是否默认使用流式响应 */
+  useStreamByDefault?: boolean
+  /** 错误消息模板 */
+  errorMessage?: string
+}
+
+/**
+ * useConversation返回值接口
+ */
+export interface UseConversationReturn {
+  /** 会话状态 */
+  state: ConversationState
+  /** 消息管理 */
+  messageManager: UseMessageReturn
+  /** 创建新会话 */
+  createConversation: (title?: string, metadata?: Record<string, unknown>) => string
+  /** 切换会话 */
+  switchConversation: (id: string) => void
+  /** 删除会话 */
+  deleteConversation: (id: string) => void
+  /** 更新会话标题 */
+  updateTitle: (id: string, title: string) => void
+  /** 更新会话元数据 */
+  updateMetadata: (id: string, metadata: Record<string, unknown>) => void
+  /** 保存会话 */
+  saveConversations: () => Promise<void>
+  /** 加载会话 */
+  loadConversations: () => Promise<void>
+  /** 生成会话标题 */
+  generateTitle: (id: string) => Promise<string>
+  /** 获取当前会话 */
+  getCurrentConversation: () => Conversation | null
+}
+
+/**
+ * 生成唯一ID
+ */
+function generateId(): string {
+  return Date.now().toString(36) + Math.random().toString(36).substring(2, 9)
+}
+
+/**
+ * useConversation composable
+ * 提供会话管理和持久化功能
+ *
+ * @param options useConversation选项
+ * @returns UseConversationReturn
+ */
+export function useConversation(options: UseConversationOptions): UseConversationReturn {
+  const {
+    client,
+    storage = new LocalStorageStrategy(),
+    autoSave = true,
+    useStreamByDefault = true,
+    errorMessage = '请求失败，请稍后重试',
+  } = options
+
+  // 会话状态
+  const state = reactive<ConversationState>({
+    conversations: [],
+    currentId: null,
+    loading: false,
+  })
+
+  // 消息管理
+  const messageManager = useMessage({
+    client,
+    useStreamByDefault,
+    errorMessage,
+    initialMessages: [],
+  })
+
+  // 监听消息变化，自动更新会话
+  watch(
+    () => messageManager.messages.value,
+    (messages: ChatMessage[]) => {
+      if (state.currentId && messages.length > 0) {
+        const index = state.conversations.findIndex((row: Conversation) => row.id === state.currentId)
+        if (index !== -1) {
+          state.conversations[index].messages = [...messages]
+          state.conversations[index].updatedAt = Date.now()
+          if (autoSave) {
+            saveConversations()
+          }
+        }
+      }
+    },
+    { deep: true },
+  )
+
+  /**
+   * 创建新会话
+   */
+  const createConversation = (title: string = '新会话', metadata: Record<string, unknown> = {}): string => {
+    const id = generateId()
+    const newConversation: Conversation = {
+      id,
+      title,
+      createdAt: Date.now(),
+      updatedAt: Date.now(),
+      messages: [],
+      metadata,
+    }
+
+    state.conversations.unshift(newConversation)
+    switchConversation(id)
+
+    if (autoSave) {
+      saveConversations()
+    }
+
+    return id
+  }
+
+  /**
+   * 切换会话
+   */
+  const switchConversation = (id: string): void => {
+    const conversation = state.conversations.find((conv: Conversation) => conv.id === id)
+    if (conversation) {
+      state.currentId = id
+      messageManager.clearMessages()
+      if (conversation.messages.length > 0) {
+        conversation.messages.forEach((msg: ChatMessage) => messageManager.addMessage(msg))
+      }
+    }
+  }
+
+  /**
+   * 删除会话
+   */
+  const deleteConversation = (id: string): void => {
+    const index = state.conversations.findIndex((conv: Conversation) => conv.id === id)
+    if (index !== -1) {
+      state.conversations.splice(index, 1)
+
+      // 如果删除的是当前会话，切换到第一个会话或清空
+      if (state.currentId === id) {
+        if (state.conversations.length > 0) {
+          switchConversation(state.conversations[0].id)
+        } else {
+          state.currentId = null
+          messageManager.clearMessages()
+        }
+      }
+
+      if (autoSave) {
+        saveConversations()
+      }
+    }
+  }
+
+  /**
+   * 更新会话标题
+   */
+  const updateTitle = (id: string, title: string): void => {
+    const conversation = state.conversations.find((conv: Conversation) => conv.id === id)
+    if (conversation) {
+      conversation.title = title
+      conversation.updatedAt = Date.now()
+
+      if (autoSave) {
+        saveConversations()
+      }
+    }
+  }
+
+  /**
+   * 更新会话元数据
+   */
+  const updateMetadata = (id: string, metadata: Record<string, unknown>): void => {
+    const conversation = state.conversations.find((conv: Conversation) => conv.id === id)
+    if (conversation) {
+      conversation.metadata = { ...conversation.metadata, ...metadata }
+      conversation.updatedAt = Date.now()
+
+      if (autoSave) {
+        saveConversations()
+      }
+    }
+  }
+
+  /**
+   * 保存会话
+   */
+  const saveConversations = async (): Promise<void> => {
+    try {
+      await storage.saveConversations(state.conversations)
+    } catch (error) {
+      console.error('保存会话失败:', error)
+    }
+  }
+
+  /**
+   * 加载会话
+   */
+  const loadConversations = async (): Promise<void> => {
+    state.loading = true
+    try {
+      const conversations = await storage.loadConversations()
+      state.conversations = conversations
+
+      // 如果有会话，默认选中第一个
+      if (conversations.length > 0 && !state.currentId) {
+        switchConversation(conversations[0].id)
+      }
+    } catch (error) {
+      console.error('加载会话失败:', error)
+    } finally {
+      state.loading = false
+    }
+  }
+
+  /**
+   * 生成会话标题
+   * 基于会话内容自动生成标题
+   */
+  const generateTitle = async (id: string): Promise<string> => {
+    const conversation = state.conversations.find((conv: Conversation) => conv.id === id)
+    if (!conversation || conversation.messages.length < 2) {
+      return conversation?.title || '新会话'
+    }
+
+    try {
+      // 构建生成标题的提示
+      const prompt: ChatMessage = {
+        role: 'system',
+        content:
+          '请根据以下对话内容，生成一个简短的标题（不超过20个字符）。只需要返回标题文本，不需要任何解释或额外内容。',
+      }
+
+      // 获取前几条消息用于生成标题
+      const contextMessages = conversation.messages.slice(0, Math.min(4, conversation.messages.length))
+
+      const response = await client.chat({
+        messages: [prompt, ...contextMessages],
+        options: {
+          stream: false,
+          max_tokens: 30,
+        },
+      })
+
+      const title = response.choices[0].message.content.trim()
+      updateTitle(id, title)
+      return title
+    } catch (error) {
+      console.error('生成标题失败:', error)
+      return conversation.title
+    }
+  }
+
+  /**
+   * 获取当前会话
+   */
+  const getCurrentConversation = (): Conversation | null => {
+    if (!state.currentId) return null
+    return state.conversations.find((conv: Conversation) => conv.id === state.currentId) || null
+  }
+
+  // 初始加载会话
+  loadConversations()
+
+  return {
+    state,
+    messageManager,
+    createConversation,
+    switchConversation,
+    deleteConversation,
+    updateTitle,
+    updateMetadata,
+    saveConversations,
+    loadConversations,
+    generateTitle,
+    getCurrentConversation,
+  }
+}

package/src/vue/index.ts

@@ -1 +1,2 @@
-export * from './useMessage'
+export * from './message/useMessage'
+export * from './conversation/useConversation'

package/src/vue/{useMessage.ts → message/useMessage.ts}

@@ -4,8 +4,8 @@
  */
 
 import { reactive, Reactive, ref, toRaw, type Ref } from 'vue'
-import type { ChatMessage } from '../types'
-import type { AIClient } from '../client'
+import type { ChatMessage } from '../../types'
+import type { AIClient } from '../../client'
 
 export enum STATUS {
   INIT = 'init', // 初始状态
@@ -125,7 +125,7 @@ export function useMessage(options: UseMessageOptions): UseMessageReturn {
           if (messages.value[messages.value.length - 1].role === 'user') {
             messages.value.push({ role: 'assistant', content: '' })
           }
-          const choice = data.choices[0]
+          const choice = data.choices?.[0]
           if (choice && choice.delta.content) {
             messages.value[messages.value.length - 1].content += choice.delta.content
           }