1. 系统架构概述本系统采用前后端分离架构，旨在支持高度自定义的角色扮演体验。
前端 (Vue 3)：负责 UI 渲染、插件面板挂载、脚本沙箱执行及动态 HTML 处理。
后端 (Go)：处理业务逻辑、Prompt 组装、插件权限校验及静态资源分发。
数据库 (PostgreSQL)：存储用户数据、角色卡设定、对话历史及插件配置（JSONB）。

2. 插件分类定义系统支持以下两类插件，并区分 公共 (Public) 与 私人 (Private) 权限：
插件类型实现技术核心功能设定集 (Lorebook)后端注入 + 数据库检索关键词触发知识点注入 Prompt。
功能扩展 (Extension)前端沙箱 (Iframe/JS)增加 UI 面板、导入脚本库、渲染自定义 HTML。

3. 数据库模型设计3.1 插件主表 (plugins)
```SQL
CREATE TABLE plugins (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    name VARCHAR(100) NOT NULL,
    type VARCHAR(20) NOT NULL,    -- 'lorebook' 或 'extension'
    is_public BOOLEAN DEFAULT false,
    owner_id UUID REFERENCES users(id),
    manifest JSONB,               -- 存储版本、作者、入口点等元数据
    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
);
```
3.2 设定条目表 (lore_items)
```SQL
CREATE TABLE lore_items (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    plugin_id UUID REFERENCES plugins(id) ON DELETE CASCADE,
    keywords TEXT[],              -- 触发词：["魔法", "火球"]
    content TEXT NOT NULL,        -- 注入内容
    priority INT DEFAULT 10       -- 插入顺序
);
```
3.3 用户配置表 (user_plugin_configs)
```SQL
CREATE TABLE user_plugin_configs (
    user_id UUID REFERENCES users(id),
    plugin_id UUID REFERENCES plugins(id),
    is_enabled BOOLEAN DEFAULT true,
    settings JSONB,               -- 存储插件的个性化设置
    PRIMARY KEY (user_id, plugin_id)
);
```

4. 后端开发：设定集注入逻辑 (Go)
4.1 Prompt 组装流程后端在向 LLM 发送请求前，需执行以下伪逻辑：
分词匹配：提取用户最新输入及其上下文，比对数据库中的 keywords。
内容提取：获取命中条目的 content。
模板拼接：
```Plaintext
{{System_Prompt}}
[相关设定注入区]
{{Injected_Lore_Content}}
----------------
{{Chat_History}}
{{User_Input}}
```

5. 前端开发：扩展功能实现 (Vue 3)
5.1 插件面板挂载参考 src/Panel.vue 的设计，利用动态组件加载插件配置：功能：读取插件的 manifest.settings_schema。交互：通过 Vue 响应式表单实时预览设置效果，并保存至后端 JSONB 字段。
5.2 脚本沙箱与 HTML 渲染参考你提供的 Iframe.vue 逻辑，为“酒馆助手”类插件提供运行环境：A. 沙箱初始化使用不可见的 <iframe> 运行插件 JS，防止污染主页面全局变量。通过 postMessage 实现主窗口与插件的通信。B. 动态 HTML 接管在聊天渲染组件中预留“渲染钩子”：JavaScript
```
// 在消息渲染循环中
const renderMessage = (msg) => {
  if (helperPlugin.enabled && helperPlugin.hasRenderer) {
    // 调用插件提供的 HTML 渲染逻辑
    return helperPlugin.process(msg.content);
  }
  return standardMarkdownRender(msg.content);
};
```
6. 目录结构规范后端存储 (Go 服务端)
```Plaintext
/storage/plugins
  /public/            # 公共插件（如官方酒馆助手）
    /tavern-helper/
      manifest.json
      index.js
  /private/           # 用户上传
    /{user_id}/
      /my-custom-ui/
```
前端状态 (Pinia/Vuex)
```TypeScript
interface PluginState {
  enabledPlugins: Plugin[];
  activeLore: LoreItem[];
  // 存储插件注入的自定义 HTML 元素
  injectedUIElements: Map<string, HTMLElement>;
}
```

7. 开发路线图 (Roadmap)
阶段一 (核心)：完成 Go 后端的关键词匹配算法，实现简单的设定集注入。
阶段二 (管理)：开发 Vue 前端的插件管理列表，支持从 JSON 导入设定集。
阶段三 (高级)：实现基于 Iframe 的脚本加载器，支持插件向侧边栏注入自定义 HTML 面板。
阶段四 (优化)：引入 PostgreSQL 的向量搜索 (pgvector)，取代简单的关键词匹配，实现语义级设定调取