@unif/react-native-chat-sdk 0.1.0 → 0.1.2

package/lib/commonjs/index.md

@@ -0,0 +1,188 @@
+---
+title: SDK 概览
+nav:
+  title: SDK
+  path: /sdk
+---
+
+# @unif/react-native-chat-sdk
+
+聊天 SDK 包，提供 Provider 抽象、Hooks、状态管理和流式处理工具。
+
+## 架构
+
+```
+┌─────────────────────────────────────────┐
+│            useXChat (Hook)              │
+│   组合 Provider + store，输出 messages  │
+├─────────────────────────────────────────┤
+│           ChatProvider 层               │
+│  AbstractChatProvider → OpenAI/DeepSeek │
+├─────────────────────────────────────────┤
+│              工具层                     │
+│   XRequest → XStream → SSEParser       │
+├─────────────────────────────────────────┤
+│              数据层                     │
+│   chatStore / sessionStore / modelStore │
+└─────────────────────────────────────────┘
+```
+
+## 核心 Hooks
+
+### useXChat — 聊天操作
+
+```tsx
+import { useXChat, OpenAIChatProvider, XRequest } from '@unif/react-native-chat-sdk';
+
+const request = new XRequest({
+  baseURL: 'https://api.openai.com',
+  getToken: async () => 'sk-...',
+});
+const provider = new OpenAIChatProvider({ request, model: 'gpt-4o' });
+
+const { messages, requesting, onRequest, abort } = useXChat({ provider });
+
+// 发起请求
+onRequest({ message: { text: '你好' } });
+
+// 中止请求
+abort();
+```
+
+**返回值:**
+
+| 属性 | 说明 | 类型 |
+|------|------|------|
+| messages | 可渲染消息列表 | `MessageInfo<Message>[]` |
+| requesting | 是否请求中 | `boolean` |
+| suggestions | 建议提示 | `SuggestionItem[]` |
+| onRequest | 发起请求 | `(input: Input) => void` |
+| abort | 中止请求 | `() => void` |
+
+### useXConversations — 会话管理
+
+```tsx
+import { useXConversations } from '@unif/react-native-chat-sdk';
+import AsyncStorage from '@react-native-async-storage/async-storage';
+
+const {
+  sessions, activeId,
+  switchSession, newSession, deleteSession,
+} = useXConversations({ storage: AsyncStorage });
+```
+
+### useXModel — 模型选择
+
+```tsx
+import { useXModel } from '@unif/react-native-chat-sdk';
+
+const { selectedModel, setSelectedModel } = useXModel({
+  models: [
+    { id: 'gpt-4o', name: 'GPT-4o', desc: '最强模型' },
+    { id: 'gpt-4o-mini', name: 'GPT-4o Mini', desc: '快速响应' },
+  ],
+  defaultModel: 'gpt-4o',
+});
+```
+
+## Provider 体系
+
+### 内置 Provider
+
+| Provider | 说明 |
+|----------|------|
+| `OpenAIChatProvider` | 兼容 OpenAI API 格式（含 Azure、Moonshot、通义千问等） |
+| `DeepSeekChatProvider` | 继承 OpenAI，额外处理 `reasoning_content` 字段 |
+
+### 自定义 Provider
+
+继承 `AbstractChatProvider`，实现 3 个抽象方法：
+
+```tsx
+import { AbstractChatProvider } from '@unif/react-native-chat-sdk';
+
+class MyProvider extends AbstractChatProvider {
+  transformParams(input) {
+    // 转换请求参数为你的 API 格式
+    return { query: input.message.text, model: input.model };
+  }
+
+  transformLocalMessage(input) {
+    // 创建本地用户消息
+    return { id: generateId(), text: input.message.text, role: 'user', status: 'local', ... };
+  }
+
+  transformMessage(output, current) {
+    // 解析流式响应，累积到 assistant 消息
+    const data = JSON.parse(output.data);
+    return { ...current, text: (current?.text || '') + data.content, status: 'updating' };
+  }
+}
+```
+
+## 工具类
+
+### XRequest
+
+面向 LLM 的 HTTP 请求工具，内置 token 注入和 SSE 解析。
+
+```tsx
+const request = new XRequest({
+  baseURL: 'https://api.example.com',
+  endpoint: '/v1/chat/completions',
+  getToken: async () => await loadToken(),
+  timeout: 120000,
+});
+```
+
+### XStream
+
+SSE 流适配器（RN 原生实现，基于 react-native-sse）。
+
+### SSEParser
+
+SSE 解析器，提供 `event_id` 幂等去重和 `seq` 严格排序。
+
+## ChatProvider — 全局模式
+
+```tsx
+import { ChatProvider, useChatContext } from '@unif/react-native-chat-sdk';
+
+// 根组件
+<ChatProvider provider={provider} storage={AsyncStorage} models={MODELS}>
+  <App />
+</ChatProvider>
+
+// 子组件
+const { messages, onRequest, sessions, selectedModel } = useChatContext();
+```
+
+## 类型定义
+
+### ChatMessage
+
+```typescript
+interface ChatMessage {
+  id: string;
+  text: string;
+  role: 'user' | 'assistant' | 'system';
+  createdAt: Date;
+  messageType: 'text' | 'card' | 'system';
+  status: 'local' | 'loading' | 'updating' | 'success' | 'error' | 'abort';
+  cardType?: string;
+  cardData?: { data: Record<string, unknown>; actions: string[] };
+  turnId: string;
+  extra?: Record<string, unknown>;
+}
+```
+
+### MessageInfo
+
+```typescript
+interface MessageInfo<Message> {
+  id: string;
+  message: Message;
+  status: MessageStatus;
+  extra?: Record<string, unknown>;
+}
+```

package/lib/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/commonjs/providers/AbstractChatProvider.js

@@ -0,0 +1,64 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AbstractChatProvider = void 0;
+/**
+ * AbstractChatProvider — Provider 抽象基类
+ *
+ * 3 个抽象方法：transformParams / transformLocalMessage / transformMessage
+ */
+
+class AbstractChatProvider {
+  constructor(config) {
+    this.request = config.request;
+  }
+
+  /**
+   * 转换请求参数
+   * 将 useXChat.onRequest() 传入的参数转换为 XRequest 需要的格式
+   */
+
+  /**
+   * 转换本地消息
+   * 将请求参数转换为用户发送的本地 ChatMessage（用于消息列表渲染）
+   */
+
+  /**
+   * 转换响应消息
+   * 将 XRequest 返回的流数据转换为 ChatMessage（用于 assistant 消息渲染）
+   */
+
+  /**
+   * 发起请求（内部调用 XRequest）
+   */
+  sendMessage(input, callbacks) {
+    const params = this.transformParams(input);
+    let currentMessage;
+    const requestCallbacks = {
+      onStream: chunk => {
+        currentMessage = this.transformMessage(chunk, currentMessage);
+        callbacks.onUpdate(currentMessage);
+      },
+      onSuccess: () => {
+        if (currentMessage) {
+          callbacks.onSuccess(currentMessage);
+        }
+      },
+      onError: error => {
+        callbacks.onError(new Error(error.message));
+      }
+    };
+    this.request.create(params, requestCallbacks);
+  }
+
+  /**
+   * 中止请求
+   */
+  abort() {
+    this.request.abort();
+  }
+}
+exports.AbstractChatProvider = AbstractChatProvider;
+//# sourceMappingURL=AbstractChatProvider.js.map

package/lib/commonjs/providers/AbstractChatProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["AbstractChatProvider","constructor","config","request","sendMessage","input","callbacks","params","transformParams","currentMessage","requestCallbacks","onStream","chunk","transformMessage","onUpdate","onSuccess","onError","error","Error","message","create","abort","exports"],"sourceRoot":"../../../src","sources":["providers/AbstractChatProvider.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;;AAMO,MAAeA,oBAAoB,CAIxC;EAGAC,WAAWA,CAACC,MAA6B,EAAE;IACzC,IAAI,CAACC,OAAO,GAAGD,MAAM,CAACC,OAAO;EAC/B;;EAEA;AACF;AACA;AACA;;EAGE;AACF;AACA;AACA;;EAGE;AACF;AACA;AACA;;EAGE;AACF;AACA;EACEC,WAAWA,CAACC,KAAY,EAAEC,SAAqC,EAAQ;IACrE,MAAMC,MAAM,GAAG,IAAI,CAACC,eAAe,CAACH,KAAK,CAAC;IAC1C,IAAII,cAAmC;IAEvC,MAAMC,gBAAmC,GAAG;MAC1CC,QAAQ,EAAGC,KAAK,IAAK;QACnBH,cAAc,GAAG,IAAI,CAACI,gBAAgB,CACpCD,KAAK,EACLH,cACF,CAAC;QACDH,SAAS,CAACQ,QAAQ,CAACL,cAAc,CAAC;MACpC,CAAC;MACDM,SAAS,EAAEA,CAAA,KAAM;QACf,IAAIN,cAAc,EAAE;UAClBH,SAAS,CAACS,SAAS,CAACN,cAAc,CAAC;QACrC;MACF,CAAC;MACDO,OAAO,EAAGC,KAAK,IAAK;QAClBX,SAAS,CAACU,OAAO,CAAC,IAAIE,KAAK,CAACD,KAAK,CAACE,OAAO,CAAC,CAAC;MAC7C;IACF,CAAC;IAED,IAAI,CAAChB,OAAO,CAACiB,MAAM,CAACb,MAAM,EAAEG,gBAAgB,CAAC;EAC/C;;EAEA;AACF;AACA;EACEW,KAAKA,CAAA,EAAS;IACZ,IAAI,CAAClB,OAAO,CAACkB,KAAK,CAAC,CAAC;EACtB;AACF;AAACC,OAAA,CAAAtB,oBAAA,GAAAA,oBAAA","ignoreList":[]}

package/lib/commonjs/providers/DeepSeekChatProvider.js

@@ -0,0 +1,88 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DeepSeekChatProvider = void 0;
+var _OpenAIChatProvider = require("./OpenAIChatProvider");
+/**
+ * DeepSeekChatProvider — DeepSeek Provider
+ *
+ * 继承 OpenAIChatProvider（DeepSeek API 兼容 OpenAI 格式）
+ * 额外处理 reasoning_content 字段（DeepSeek 的思考过程）→ 映射到 <think> 标签
+ */
+
+class DeepSeekChatProvider extends _OpenAIChatProvider.OpenAIChatProvider {
+  constructor(config) {
+    super({
+      baseURL: config.baseURL ?? 'https://api.deepseek.com',
+      apiKey: config.apiKey,
+      model: config.model ?? 'deepseek-chat',
+      getToken: config.getToken
+    });
+  }
+
+  /**
+   * 覆写 transformMessage，处理 DeepSeek reasoning_content
+   */
+  transformMessage(output, current) {
+    const raw = output.data;
+    if (raw.trim() === '[DONE]') {
+      return {
+        ...(current ?? {
+          id: '',
+          text: '',
+          role: 'assistant',
+          createdAt: new Date(),
+          messageType: 'text',
+          status: 'success',
+          turnId: ''
+        }),
+        status: 'success'
+      };
+    }
+    try {
+      const parsed = JSON.parse(raw);
+      const delta = parsed.choices?.[0]?.delta;
+      const content = delta?.content ?? '';
+      const reasoningContent = delta?.reasoning_content ?? '';
+      const finishReason = parsed.choices?.[0]?.finish_reason;
+      const prevText = current?.text ?? '';
+      let newText = prevText;
+
+      // 将 reasoning_content 映射为 <think> 标签包裹
+      if (reasoningContent) {
+        // 如果还没有开始 think 标签，添加开始标签
+        if (!prevText.includes('<think>')) {
+          newText += '<think>';
+        }
+        newText += reasoningContent;
+      }
+      if (content) {
+        // 如果有未关闭的 think 标签，先关闭
+        if (newText.includes('<think>') && !newText.includes('</think>')) {
+          newText += '</think>';
+        }
+        newText += content;
+      }
+
+      // 完成时确保 think 标签闭合
+      if (finishReason && newText.includes('<think>') && !newText.includes('</think>')) {
+        newText += '</think>';
+      }
+      return {
+        id: current?.id ?? `msg-${Date.now()}`,
+        text: newText,
+        role: 'assistant',
+        createdAt: current?.createdAt ?? new Date(),
+        messageType: 'text',
+        status: finishReason ? 'success' : 'updating',
+        turnId: current?.turnId ?? `turn-${Date.now()}`
+      };
+    } catch {
+      return current ?? super.transformMessage(output, current);
+    }
+  }
+}
+exports.DeepSeekChatProvider = DeepSeekChatProvider;
+//# sourceMappingURL=DeepSeekChatProvider.js.map

package/lib/commonjs/providers/DeepSeekChatProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_OpenAIChatProvider","require","DeepSeekChatProvider","OpenAIChatProvider","constructor","config","baseURL","apiKey","model","getToken","transformMessage","output","current","raw","data","trim","id","text","role","createdAt","Date","messageType","status","turnId","parsed","JSON","parse","delta","choices","content","reasoningContent","reasoning_content","finishReason","finish_reason","prevText","newText","includes","now","exports"],"sourceRoot":"../../../src","sources":["providers/DeepSeekChatProvider.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/providers/OpenAIChatProvider.js

@@ -0,0 +1,114 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.OpenAIChatProvider = void 0;
+var _AbstractChatProvider = require("./AbstractChatProvider");
+var _XRequest = require("../tools/XRequest");
+/**
+ * OpenAIChatProvider — OpenAI 兼容 Provider
+ *
+ * 兼容所有 OpenAI 标准 API（OpenAI、Azure、Moonshot、通义千问兼容模式等）
+ */
+
+let _idCounter = 0;
+const genId = () => `msg-${Date.now()}-${++_idCounter}`;
+class OpenAIChatProvider extends _AbstractChatProvider.AbstractChatProvider {
+  constructor(config) {
+    const headers = {};
+    if (config.apiKey) {
+      headers['Authorization'] = `Bearer ${config.apiKey}`;
+    }
+    const request = new _XRequest.XRequest({
+      baseURL: config.baseURL,
+      endpoint: config.endpoint ?? '/v1/chat/completions',
+      headers,
+      getToken: config.getToken
+    });
+    super({
+      request
+    });
+    this.model = config.model ?? 'gpt-4o';
+  }
+
+  /**
+   * 将消息转为 OpenAI messages 格式: [{role, content}]
+   */
+  transformParams(input) {
+    const messages = (input.messages ?? []).map(m => ({
+      role: m.role,
+      content: m.text
+    }));
+    messages.push({
+      role: input.message.role,
+      content: input.message.text
+    });
+    return {
+      model: input.model ?? this.model,
+      messages,
+      stream: true
+    };
+  }
+
+  /**
+   * 创建本地用户消息
+   */
+  transformLocalMessage(input) {
+    return {
+      id: genId(),
+      text: input.message.text,
+      role: 'user',
+      createdAt: new Date(),
+      messageType: 'text',
+      status: 'local',
+      turnId: input.extra?.turnId ?? genId()
+    };
+  }
+
+  /**
+   * 将 SSE delta 转为 ChatMessage（累积 content）
+   */
+  transformMessage(output, current) {
+    const raw = output.data;
+
+    // OpenAI 结束标记
+    if (raw.trim() === '[DONE]') {
+      return {
+        ...(current ?? this.createEmptyAssistant()),
+        status: 'success'
+      };
+    }
+    try {
+      const parsed = JSON.parse(raw);
+      const delta = parsed.choices?.[0]?.delta;
+      const content = delta?.content ?? '';
+      const finishReason = parsed.choices?.[0]?.finish_reason;
+      const prevText = current?.text ?? '';
+      return {
+        id: current?.id ?? genId(),
+        text: prevText + content,
+        role: 'assistant',
+        createdAt: current?.createdAt ?? new Date(),
+        messageType: 'text',
+        status: finishReason ? 'success' : 'updating',
+        turnId: current?.turnId ?? genId()
+      };
+    } catch {
+      return current ?? this.createEmptyAssistant();
+    }
+  }
+  createEmptyAssistant() {
+    return {
+      id: genId(),
+      text: '',
+      role: 'assistant',
+      createdAt: new Date(),
+      messageType: 'text',
+      status: 'updating',
+      turnId: genId()
+    };
+  }
+}
+exports.OpenAIChatProvider = OpenAIChatProvider;
+//# sourceMappingURL=OpenAIChatProvider.js.map

package/lib/commonjs/providers/OpenAIChatProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_AbstractChatProvider","require","_XRequest","_idCounter","genId","Date","now","OpenAIChatProvider","AbstractChatProvider","constructor","config","headers","apiKey","request","XRequest","baseURL","endpoint","getToken","model","transformParams","input","messages","map","m","role","content","text","push","message","stream","transformLocalMessage","id","createdAt","messageType","status","turnId","extra","transformMessage","output","current","raw","data","trim","createEmptyAssistant","parsed","JSON","parse","delta","choices","finishReason","finish_reason","prevText","exports"],"sourceRoot":"../../../src","sources":["providers/OpenAIChatProvider.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/stores/chatStore.js

@@ -0,0 +1,65 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createChatStore = void 0;
+var _zustand = require("zustand");
+/**
+ * Chat 消息状态管理（Zustand）
+ * 内部 store，通过 useXChat hook 封装后对外暴露
+ */
+
+const createChatStore = () => (0, _zustand.create)((set, get) => ({
+  messages: [],
+  streamingText: '',
+  suggestions: [],
+  isRequesting: false,
+  error: null,
+  addMessage: message => set(state => ({
+    messages: [message, ...state.messages]
+  })),
+  updateMessage: (id, updater) => set(state => ({
+    messages: state.messages.map(m => m.id === id ? updater(m) : m)
+  })),
+  upsertMessage: message => {
+    const state = get();
+    const existingIdx = state.messages.findIndex(m => m.id === message.id);
+    if (existingIdx >= 0) {
+      const newMessages = [...state.messages];
+      newMessages[existingIdx] = message;
+      set({
+        messages: newMessages
+      });
+    } else {
+      set({
+        messages: [message, ...state.messages]
+      });
+    }
+  },
+  setSuggestions: items => set({
+    suggestions: items
+  }),
+  setRequesting: v => set({
+    isRequesting: v
+  }),
+  setError: error => set({
+    error
+  }),
+  resetChat: () => set({
+    messages: [],
+    streamingText: '',
+    suggestions: [],
+    isRequesting: false,
+    error: null
+  }),
+  loadSession: messages => set({
+    messages,
+    streamingText: '',
+    suggestions: [],
+    isRequesting: false,
+    error: null
+  })
+}));
+exports.createChatStore = createChatStore;
+//# sourceMappingURL=chatStore.js.map

package/lib/commonjs/stores/chatStore.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_zustand","require","createChatStore","create","set","get","messages","streamingText","suggestions","isRequesting","error","addMessage","message","state","updateMessage","id","updater","map","m","upsertMessage","existingIdx","findIndex","newMessages","setSuggestions","items","setRequesting","v","setError","resetChat","loadSession","exports"],"sourceRoot":"../../../src","sources":["stores/chatStore.ts"],"mappings":";;;;;;AAKA,IAAAA,QAAA,GAAAC,OAAA;AALA;AACA;AACA;AACA;;AAuBO,MAAMC,eAAe,GAAGA,CAAA,KAC7B,IAAAC,eAAM,EAAY,CAACC,GAAG,EAAEC,GAAG,MAAM;EAC/BC,QAAQ,EAAE,EAAE;EACZC,aAAa,EAAE,EAAE;EACjBC,WAAW,EAAE,EAAE;EACfC,YAAY,EAAE,KAAK;EACnBC,KAAK,EAAE,IAAI;EAEXC,UAAU,EAAGC,OAAO,IAClBR,GAAG,CAAES,KAAK,KAAM;IACdP,QAAQ,EAAE,CAACM,OAAO,EAAE,GAAGC,KAAK,CAACP,QAAQ;EACvC,CAAC,CAAC,CAAC;EAELQ,aAAa,EAAEA,CAACC,EAAE,EAAEC,OAAO,KACzBZ,GAAG,CAAES,KAAK,KAAM;IACdP,QAAQ,EAAEO,KAAK,CAACP,QAAQ,CAACW,GAAG,CAAEC,CAAC,IAAMA,CAAC,CAACH,EAAE,KAAKA,EAAE,GAAGC,OAAO,CAACE,CAAC,CAAC,GAAGA,CAAE;EACpE,CAAC,CAAC,CAAC;EAELC,aAAa,EAAGP,OAAO,IAAK;IAC1B,MAAMC,KAAK,GAAGR,GAAG,CAAC,CAAC;IACnB,MAAMe,WAAW,GAAGP,KAAK,CAACP,QAAQ,CAACe,SAAS,CAAEH,CAAC,IAAKA,CAAC,CAACH,EAAE,KAAKH,OAAO,CAACG,EAAE,CAAC;IAExE,IAAIK,WAAW,IAAI,CAAC,EAAE;MACpB,MAAME,WAAW,GAAG,CAAC,GAAGT,KAAK,CAACP,QAAQ,CAAC;MACvCgB,WAAW,CAACF,WAAW,CAAC,GAAGR,OAAO;MAClCR,GAAG,CAAC;QAAEE,QAAQ,EAAEgB;MAAY,CAAC,CAAC;IAChC,CAAC,MAAM;MACLlB,GAAG,CAAC;QAAEE,QAAQ,EAAE,CAACM,OAAO,EAAE,GAAGC,KAAK,CAACP,QAAQ;MAAE,CAAC,CAAC;IACjD;EACF,CAAC;EAEDiB,cAAc,EAAGC,KAAK,IAAKpB,GAAG,CAAC;IAAEI,WAAW,EAAEgB;EAAM,CAAC,CAAC;EACtDC,aAAa,EAAGC,CAAC,IAAKtB,GAAG,CAAC;IAAEK,YAAY,EAAEiB;EAAE,CAAC,CAAC;EAC9CC,QAAQ,EAAGjB,KAAK,IAAKN,GAAG,CAAC;IAAEM;EAAM,CAAC,CAAC;EAEnCkB,SAAS,EAAEA,CAAA,KACTxB,GAAG,CAAC;IACFE,QAAQ,EAAE,EAAE;IACZC,aAAa,EAAE,EAAE;IACjBC,WAAW,EAAE,EAAE;IACfC,YAAY,EAAE,KAAK;IACnBC,KAAK,EAAE;EACT,CAAC,CAAC;EAEJmB,WAAW,EAAGvB,QAAQ,IACpBF,GAAG,CAAC;IACFE,QAAQ;IACRC,aAAa,EAAE,EAAE;IACjBC,WAAW,EAAE,EAAE;IACfC,YAAY,EAAE,KAAK;IACnBC,KAAK,EAAE;EACT,CAAC;AACL,CAAC,CAAC,CAAC;AAACoB,OAAA,CAAA5B,eAAA,GAAAA,eAAA","ignoreList":[]}

package/lib/commonjs/stores/historyStore.js

@@ -0,0 +1,79 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createHistoryStore = createHistoryStore;
+/**
+ * 历史会话持久化
+ * 使用 ChatStorage 抽象，不直接依赖 AsyncStorage
+ */
+
+const MAX_SESSIONS = 50;
+const MESSAGE_KEY_PREFIX = 'chat-session-';
+function createHistoryStore(storage) {
+  let sessions = [];
+  let initialized = false;
+  const loadIndex = async () => {
+    if (initialized) return;
+    try {
+      const raw = await storage.getItem('chat-history-index');
+      if (raw) {
+        sessions = JSON.parse(raw);
+      }
+    } catch {
+      sessions = [];
+    }
+    initialized = true;
+  };
+  const saveIndex = async () => {
+    await storage.setItem('chat-history-index', JSON.stringify(sessions));
+  };
+  return {
+    get sessions() {
+      return sessions;
+    },
+    archiveSession: async (id, title, messages) => {
+      await loadIndex();
+      if (messages.length === 0) return;
+      await storage.setItem(`${MESSAGE_KEY_PREFIX}${id}`, JSON.stringify(messages));
+      const lastMsg = messages[0];
+      const summary = {
+        id,
+        title,
+        lastMessage: lastMsg?.text?.slice(0, 50) ?? '',
+        timestamp: Date.now(),
+        messageCount: messages.length
+      };
+
+      // 去重（如果已存在则更新）
+      sessions = sessions.filter(s => s.id !== id);
+      sessions = [summary, ...sessions];
+
+      // FIFO 淘汰
+      if (sessions.length > MAX_SESSIONS) {
+        const removed = sessions.splice(MAX_SESSIONS);
+        await Promise.all(removed.map(s => storage.removeItem(`${MESSAGE_KEY_PREFIX}${s.id}`)));
+      }
+      await saveIndex();
+    },
+    loadSessionMessages: async id => {
+      const raw = await storage.getItem(`${MESSAGE_KEY_PREFIX}${id}`);
+      if (!raw) return [];
+      return JSON.parse(raw);
+    },
+    deleteSession: async id => {
+      await loadIndex();
+      await storage.removeItem(`${MESSAGE_KEY_PREFIX}${id}`);
+      sessions = sessions.filter(s => s.id !== id);
+      await saveIndex();
+    },
+    clearAll: async () => {
+      await loadIndex();
+      await Promise.all(sessions.map(s => storage.removeItem(`${MESSAGE_KEY_PREFIX}${s.id}`)));
+      sessions = [];
+      await saveIndex();
+    }
+  };
+}
+//# sourceMappingURL=historyStore.js.map

package/lib/commonjs/stores/historyStore.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MAX_SESSIONS","MESSAGE_KEY_PREFIX","createHistoryStore","storage","sessions","initialized","loadIndex","raw","getItem","JSON","parse","saveIndex","setItem","stringify","archiveSession","id","title","messages","length","lastMsg","summary","lastMessage","text","slice","timestamp","Date","now","messageCount","filter","s","removed","splice","Promise","all","map","removeItem","loadSessionMessages","deleteSession","clearAll"],"sourceRoot":"../../../src","sources":["stores/historyStore.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;;AAKA,MAAMA,YAAY,GAAG,EAAE;AACvB,MAAMC,kBAAkB,GAAG,eAAe;AAsBnC,SAASC,kBAAkBA,CAACC,OAAoB,EAAgB;EACrE,IAAIC,QAA0B,GAAG,EAAE;EACnC,IAAIC,WAAW,GAAG,KAAK;EAEvB,MAAMC,SAAS,GAAG,MAAAA,CAAA,KAAY;IAC5B,IAAID,WAAW,EAAE;IACjB,IAAI;MACF,MAAME,GAAG,GAAG,MAAMJ,OAAO,CAACK,OAAO,CAAC,oBAAoB,CAAC;MACvD,IAAID,GAAG,EAAE;QACPH,QAAQ,GAAGK,IAAI,CAACC,KAAK,CAACH,GAAG,CAAC;MAC5B;IACF,CAAC,CAAC,MAAM;MACNH,QAAQ,GAAG,EAAE;IACf;IACAC,WAAW,GAAG,IAAI;EACpB,CAAC;EAED,MAAMM,SAAS,GAAG,MAAAA,CAAA,KAAY;IAC5B,MAAMR,OAAO,CAACS,OAAO,CAAC,oBAAoB,EAAEH,IAAI,CAACI,SAAS,CAACT,QAAQ,CAAC,CAAC;EACvE,CAAC;EAED,OAAO;IACL,IAAIA,QAAQA,CAAA,EAAG;MACb,OAAOA,QAAQ;IACjB,CAAC;IAEDU,cAAc,EAAE,MAAAA,CAAOC,EAAE,EAAEC,KAAK,EAAEC,QAAQ,KAAK;MAC7C,MAAMX,SAAS,CAAC,CAAC;MACjB,IAAIW,QAAQ,CAACC,MAAM,KAAK,CAAC,EAAE;MAE3B,MAAMf,OAAO,CAACS,OAAO,CACnB,GAAGX,kBAAkB,GAAGc,EAAE,EAAE,EAC5BN,IAAI,CAACI,SAAS,CAACI,QAAQ,CACzB,CAAC;MAED,MAAME,OAAO,GAAGF,QAAQ,CAAC,CAAC,CAAC;MAC3B,MAAMG,OAAuB,GAAG;QAC9BL,EAAE;QACFC,KAAK;QACLK,WAAW,EAAEF,OAAO,EAAEG,IAAI,EAAEC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE;QAC9CC,SAAS,EAAEC,IAAI,CAACC,GAAG,CAAC,CAAC;QACrBC,YAAY,EAAEV,QAAQ,CAACC;MACzB,CAAC;;MAED;MACAd,QAAQ,GAAGA,QAAQ,CAACwB,MAAM,CAAEC,CAAC,IAAKA,CAAC,CAACd,EAAE,KAAKA,EAAE,CAAC;MAC9CX,QAAQ,GAAG,CAACgB,OAAO,EAAE,GAAGhB,QAAQ,CAAC;;MAEjC;MACA,IAAIA,QAAQ,CAACc,MAAM,GAAGlB,YAAY,EAAE;QAClC,MAAM8B,OAAO,GAAG1B,QAAQ,CAAC2B,MAAM,CAAC/B,YAAY,CAAC;QAC7C,MAAMgC,OAAO,CAACC,GAAG,CACfH,OAAO,CAACI,GAAG,CAAEL,CAAC,IACZ1B,OAAO,CAACgC,UAAU,CAAC,GAAGlC,kBAAkB,GAAG4B,CAAC,CAACd,EAAE,EAAE,CACnD,CACF,CAAC;MACH;MAEA,MAAMJ,SAAS,CAAC,CAAC;IACnB,CAAC;IAEDyB,mBAAmB,EAAE,MAAOrB,EAAE,IAAK;MACjC,MAAMR,GAAG,GAAG,MAAMJ,OAAO,CAACK,OAAO,CAAC,GAAGP,kBAAkB,GAAGc,EAAE,EAAE,CAAC;MAC/D,IAAI,CAACR,GAAG,EAAE,OAAO,EAAE;MACnB,OAAOE,IAAI,CAACC,KAAK,CAACH,GAAG,CAAC;IACxB,CAAC;IAED8B,aAAa,EAAE,MAAOtB,EAAE,IAAK;MAC3B,MAAMT,SAAS,CAAC,CAAC;MACjB,MAAMH,OAAO,CAACgC,UAAU,CAAC,GAAGlC,kBAAkB,GAAGc,EAAE,EAAE,CAAC;MACtDX,QAAQ,GAAGA,QAAQ,CAACwB,MAAM,CAAEC,CAAC,IAAKA,CAAC,CAACd,EAAE,KAAKA,EAAE,CAAC;MAC9C,MAAMJ,SAAS,CAAC,CAAC;IACnB,CAAC;IAED2B,QAAQ,EAAE,MAAAA,CAAA,KAAY;MACpB,MAAMhC,SAAS,CAAC,CAAC;MACjB,MAAM0B,OAAO,CAACC,GAAG,CACf7B,QAAQ,CAAC8B,GAAG,CAAEL,CAAC,IACb1B,OAAO,CAACgC,UAAU,CAAC,GAAGlC,kBAAkB,GAAG4B,CAAC,CAACd,EAAE,EAAE,CACnD,CACF,CAAC;MACDX,QAAQ,GAAG,EAAE;MACb,MAAMO,SAAS,CAAC,CAAC;IACnB;EACF,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/stores/modelStore.js

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createModelStore = void 0;
+var _zustand = require("zustand");
+/**
+ * 模型选择状态（Zustand）
+ * 内部 store，通过 useXModel hook 封装后对外暴露
+ */
+
+const createModelStore = defaultModel => (0, _zustand.create)(set => ({
+  selectedModel: defaultModel,
+  setSelectedModel: id => set({
+    selectedModel: id
+  })
+}));
+exports.createModelStore = createModelStore;
+//# sourceMappingURL=modelStore.js.map

package/lib/commonjs/stores/modelStore.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_zustand","require","createModelStore","defaultModel","create","set","selectedModel","setSelectedModel","id","exports"],"sourceRoot":"../../../src","sources":["stores/modelStore.ts"],"mappings":";;;;;;AAKA,IAAAA,QAAA,GAAAC,OAAA;AALA;AACA;AACA;AACA;;AASO,MAAMC,gBAAgB,GAAIC,YAAoB,IACnD,IAAAC,eAAM,EAAcC,GAAG,KAAM;EAC3BC,aAAa,EAAEH,YAAY;EAC3BI,gBAAgB,EAAGC,EAAE,IAAKH,GAAG,CAAC;IAAEC,aAAa,EAAEE;EAAG,CAAC;AACrD,CAAC,CAAC,CAAC;AAACC,OAAA,CAAAP,gBAAA,GAAAA,gBAAA","ignoreList":[]}