# LittleWhiteBox

## 目录结构

```
LittleWhiteBox/
|-- .editorconfig                   # 编辑器格式规范
|-- .eslintignore                   # ESLint 忽略规则
|-- .eslintrc.cjs                   # ESLint 配置
|-- .gitattributes                  # Git 属性
|-- .gitignore                      # Git 忽略规则
|-- index.js                        # 插件入口：初始化/注册所有模块
|-- jsconfig.json                   # JS/TS 编辑器提示
|-- manifest.json                   # 插件清单：版本/依赖/入口
|-- package-lock.json               # 依赖锁定
|-- package.json                    # 开发依赖/脚本
|-- README.md                       # 说明文档
|-- settings.html                   # 主设置页：模块开关/UI
|-- style.css                       # 全局样式
|
|-- bridges/                        # 外部桥接
|   |-- call-generate-service.js    # 调用生成服务桥接
|   |-- worldbook-bridge.js         # 世界书桥接
|   `-- wrapper-iframe.js           # iframe 包装桥接
|
|-- core/                           # 核心基础设施
|   |-- constants.js                # 常量/路径定义
|   |-- debug-core.js               # 日志/缓存注册
|   |-- event-manager.js            # 统一事件管理
|   |-- iframe-messaging.js         # postMessage 封装
|   |-- server-storage.js           # 服务器存储封装
|   |-- slash-command.js            # 斜杠命令封装
|   |-- variable-path.js            # 变量路径解析
|   `-- wrapper-inline.js           # iframe 内联脚本
|
|-- docs/                           # 文档与许可
|   |-- COPYRIGHT                   # 版权声明
|   |-- LICENSE.md                  # 许可协议
|   `-- NOTICE                      # 通知/第三方声明
|
|-- libs/                           # 第三方库
|   |-- dexie.mjs                   # IndexedDB 封装库
|   |-- js-yaml.mjs                 # YAML 解析/序列化（ESM）
|   |-- minisearch.mjs              # 轻量搜索库
|   |-- pixi.min.js                 # PixiJS 渲染库
|   |-- fflate.mjs                  # 压缩解压库
|   `-- jieba-wasm/
|       |-- jieba_rs_wasm.js        # 结巴分词 WASM JS 包装
|       |-- jieba_rs_wasm_bg.wasm   # 结巴分词 WASM 二进制
|       `-- jieba_rs_wasm_bg.wasm.d.ts # WASM 类型声明
|
|-- modules/                        # 功能模块
|   |-- control-audio.js            # 音频权限控制
|   |-- iframe-renderer.js          # iframe 渲染
|   |-- immersive-mode.js           # 沉浸模式
|   |-- message-preview.js          # 消息预览/拦截
|   |-- streaming-generation.js     # 生成相关功能
|   |
|   |-- debug-panel/
|   |   |-- debug-panel.html        # 调试面板 UI
|   |   `-- debug-panel.js          # 调试面板逻辑
|   |
|   |-- fourth-wall/
|   |   |-- fourth-wall.html        # UI
|   |   |-- fourth-wall.js          # 主逻辑
|   |   |-- fw-image.js             # 图像相关增强
|   |   |-- fw-message-enhancer.js  # 消息增强
|   |   |-- fw-prompt.js            # 提示词/注入
|   |   `-- fw-voice.js             # 语音相关
|   |
|   |-- novel-draw/
|   |   |-- cloud-presets.js        # 云端预设
|   |   |-- floating-panel.js       # 浮动面板
|   |   |-- gallery-cache.js        # 图库缓存
|   |   |-- image-live-effect.js    # 图像动态效果
|   |   |-- llm-service.js          # LLM 服务调用
|   |   |-- novel-draw.html         # UI
|   |   |-- novel-draw.js           # 主逻辑
|   |   `-- TAG编写指南.md  # TAG 编写指南
|   |
|   |-- scheduled-tasks/
|   |   |-- embedded-tasks.html     # 内嵌任务 UI
|   |   |-- scheduled-tasks.html    # 主 UI
|   |   `-- scheduled-tasks.js      # 逻辑
|   |
|   |-- story-outline/
|   |   |-- story-outline-prompt.js # Prompt 模板
|   |   |-- story-outline.html      # UI
|   |   `-- story-outline.js        # 逻辑
|   |
|   |-- story-summary/              # 剧情总结 + 记忆系统
|   |   |-- story-summary-ui.js     # UI 逻辑
|   |   |-- story-summary.css       # 样式
|   |   |-- story-summary.html      # UI（含向量设置）
|   |   |-- story-summary.js        # 主入口：事件/UI/iframe 通讯
|   |   |-- data/
|   |   |   |-- config.js           # 配置管理
|   |   |   |-- db.js               # 向量存储：L1/L2 Vectors
|   |   |   `-- store.js            # 核心存储：L2事件 + L3世界状态
|   |   |-- generate/
|   |   |   |-- generator.js        # 调度器：调用 LLM -> 解析 -> 清洗 -> 合并
|   |   |   |-- llm.js              # LLM API 与 Prompt 定义
|   |   |   `-- prompt.js           # 注入层：格式化 + 预算装配
|   |   `-- vector/
|   |       |-- chunk-builder.js    # L1 切分与构建
|   |       |-- chunk-store.js      # 向量 CRUD 操作
|   |       |-- embedder.js         # 向量化服务 (Local/Online)
|   |       |-- embedder.worker.js  # 本地模型 Worker
|   |       |-- entity.js           # 召回实体/辅助结构
|   |       |-- recall.js           # 召回引擎：加权 Query + 实体加分 + MMR
|   |       |-- state-integration.js# 状态接入：L0 atoms -> 向量信号
|   |       |-- state-recall.js     # L0/L1 召回合并逻辑
|   |       |-- state-store.js      # L0 状态持久化/索引
|   |       |-- text-filter.js      # 文本清洗
|   |       `-- vector-io.js        # 向量导出/导入
|   |
|   |-- template-editor/
|   |   |-- template-editor.html    # UI
|   |   `-- template-editor.js      # 逻辑
|   |
|   |-- tts/
|   |   |-- tts-api.js              # API 适配
|   |   |-- tts-auth-provider.js    # 鉴权提供者
|   |   |-- tts-cache.js            # 缓存
|   |   |-- tts-free-provider.js    # 免费提供者
|   |   |-- tts-overlay.html        # Overlay UI
|   |   |-- tts-panel.js            # 面板逻辑
|   |   |-- tts-player.js           # 播放器
|   |   |-- tts-text.js             # 文本处理
|   |   |-- tts-voices.js           # 语音配置
|   |   |-- tts.js                  # 主入口
|   |   |-- 声音复刻.png            # 说明图
|   |   |-- 开通管理.png            # 说明图
|   |   `-- 获取ID和KEY.png         # 说明图
|   |
|   `-- variables/                  # 变量系统（含 2.0）
|       |-- var-commands.js         # 变量命令/宏/路径解析
|       |-- varevent-editor.js      # 变量编辑器/注入处理
|       |-- variables-core.js       # 变量系统核心
|       |-- variables-panel.js      # 变量面板 UI
|       `-- state2/                 # 变量系统 2.0
|           |-- executor.js         # WAL/Checkpoint 执行与回放
|           |-- guard.js            # 规则守卫/验证
|           |-- index.js            # 2.0 导出入口
|           |-- parser.js           # <state> 解析
|           `-- semantic.js         # 语义/原子化解析
|
`-- widgets/                        # 通用 UI 组件
    |-- button-collapse.js          # 按钮收纳
    `-- message-toolbar.js          # 消息工具条
```

## 许可说明
详见 `docs/LICENSE.md`