vibe-ai-c 3.3.0 → 3.3.2

package/README.md

@@ -0,0 +1,73 @@
+# VibeAI (v3.3)
+
+VibeAI 是一个极简、高性能、面向浏览器的多供应商 AI SDK 与 UI 管理工具。它旨在通过 **CDN 零配置集成**，为任何网页快速提供 OpenAI 兼容的 AI 能力。
+
+## 核心特性
+
+- **CDN 优先**：无需 npm 或复杂的构建工具，直接通过原生 ESM 导入。
+- **零依赖 (Zero-dependency)**：纯 JavaScript 实现，体积精简，不污染全局环境。
+- **安全性 (Web Crypto)**：支持 AES-GCM 硬件级加密存储 API Key。
+- **多实例绑定**：支持一个页面内多个对话框绑定不同供应商/模型。
+- **智能 UI 交互**：内置模型搜索、自动 `/v1` 路径补全、批量资产选择，且渲染过程不丢失输入焦点。
+
+## 快速集成 (Quick Start)
+
+由于 VibeAI 采用标准的 ESM 架构，你只需在 HTML 中使用 `<script type="module">` 即可直接从 CDN 引入：
+
+### 1. 引入并初始化
+```html
+<script type="module">
+  // 推荐从 unpkg 引入最新生产版本
+  import { vibeAI } from 'https://unpkg.com/vibe-ai-c@3.3.2/vibe-ai.min.js';
+
+  // 初始化并绑定管理按钮
+  await vibeAI.init({
+    setupBtnId: 'settings-btn' 
+  });
+
+  // 绑定你的模型选择下拉框
+  vibeAI.bindModelSelect('my-selector');
+</script>
+
+<button id="settings-btn">设置 AI 供应商</button>
+<select id="my-selector"></select>
+```
+
+### 2. 调用对话
+```javascript
+const stream = await vibeAI.chat({
+  instanceId: 'my-selector', // 对应绑定的 select id
+  messages: [{ role: 'user', content: '你好！' }],
+  stream: true
+});
+
+for await (const chunk of stream) {
+  console.log(chunk); // 实时流式输出
+}
+```
+
+## API 参考
+
+### `vibeAI.init({ setupBtnId })`
+- **setupBtnId**: (可选) 字符串 ID。绑定后，点击该元素将自动弹出供应商配置界面。
+- **功能**: 执行存储迁移 (v2 -> v3) 并挂载全局样式。
+
+### `vibeAI.bindModelSelect(id)`
+- **id**: HTML `<select>` 元素的 ID。
+- **功能**: 自动填充已勾选的模型资产池。当用户在设置中更改模型或供应商时，该下拉框会自动同步更新，并记忆用户的最后一次选择。
+
+### `vibeAI.chat(payload)`
+- **payload.instanceId**: (必填) 绑定的 Select ID，SDK 据此识别供应商配置。
+- **payload.stream**: 布尔值。为 `true` 时返回 `AsyncGenerator`。
+- **payload.messages**: 标准 OpenAI 消息数组。
+
+## 进阶与部署
+
+- **生产环境建议**：始终在 CDN URL 中锁定版本号（如 `@3.3.2`）以确保生产环境稳定性。
+- **安全警告**：在非加密模式下，API Key 以明文存在 `localStorage`。建议引导用户点击设置面板顶部的“锁定”图标，通过 Web Crypto API 进行本地加密。
+- **智能路径补全**：若用户输入的 Base URL 无法连接，SDK 会自动尝试追加 `/v1`（如 `https://api.deepseek.com` -> `https://api.deepseek.com/v1`）。
+
+## 配置规范 (Storage)
+
+- 存储键名：`vibe_ai_v3_config`
+- 加密前缀：`ENC:`（仅在开启加密模式时）

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "vibe-ai-c",
-  "version": "3.3.0",
+  "version": "3.3.2",
   "description": "一个极简的、面向浏览器的多供应商 AI SDK 与 UI 管理工具。支持 OpenAI 兼容协议。",
-  "main": "vibe-ai.js",
+  "main": "vibe-ai.min.js",
   "type": "module",
   "scripts": {
     "dev": "npx servor . demo.html 8080",
@@ -25,7 +25,6 @@
     "demo.html",
     "vibe-ai.js",
     "vibe-ai.min.js",
-    "llm.txt",
     "README.md"
   ]
 }