Initial TrueGrowth source import

docs/user-manual/content/advanced/command-palette.mdx

@@ -0,0 +1,38 @@
+---
+title: 命令面板
+category: advanced
+order: 9
+---
+
+# 命令面板
+
+命令面板可以快速搜索并执行常用功能，适合高频操作和键盘流用户。
+
+## 打开方式
+
+- 快捷键：`Cmd + K`
+- 菜单：左上角菜单 → **命令面板**
+
+## 基本用法
+
+1. 输入关键词筛选命令
+2. 使用 ↑ / ↓ 选择
+3. 按 **Enter** 执行
+4. 按 **Esc** 退出
+
+## 命令分类
+
+命令按以下类别归类：
+
+- 工具
+- 编辑
+- 视图
+- AI
+- 导出
+- 设置
+
+## 使用建议
+
+:::tip
+不记得具体位置时，直接在命令面板里搜索功能名称即可。
+:::

docs/user-manual/content/advanced/export-import.mdx

@@ -0,0 +1,129 @@
+---
+title: 导出与导入
+category: advanced
+order: 1
+---
+
+# 导出与导入
+
+Opentu 支持多种格式的导出和导入，方便你保存和分享作品。
+
+## 导出图片
+
+### 导出为 PNG
+
+1. 点击左上角的菜单按钮
+2. 选择 **导出图片**
+3. 选择 **PNG 格式**
+
+**特点**：
+- 支持透明背景
+- 适合网页使用
+- 文件较大
+
+**快捷键**：`Ctrl/Cmd + Shift + E`
+
+### 导出为 JPG
+
+1. 点击菜单按钮
+2. 选择 **导出图片**
+3. 选择 **JPG 格式**
+
+**特点**：
+- 不支持透明背景
+- 文件较小
+- 适合照片类图片
+
+## 导出选中区域
+
+只想导出一部分？
+
+1. 先选中要导出的元素
+2. 再执行导出操作
+
+只有选中的内容会被导出。
+
+## 保存项目
+
+### 保存为 JSON
+
+将项目保存为 `.drawnix` 文件（实际是 JSON 格式）：
+
+1. 点击菜单按钮
+2. 选择 **保存文件**
+3. 选择保存位置
+
+**快捷键**：`Ctrl/Cmd + S`
+
+### 打开项目
+
+1. 点击菜单按钮
+2. 选择 **打开文件**
+3. 选择 `.drawnix` 文件
+
+## 自动保存
+
+Opentu 会自动保存你的工作：
+
+- 数据保存在浏览器本地
+- 刷新页面不会丢失
+- 切换项目自动保存
+
+:::tip
+虽然有自动保存，但重要项目建议定期手动导出备份。
+:::
+
+## 备份与恢复
+
+### 导出备份
+
+可以将所有数据打包导出：
+
+1. 点击菜单按钮
+2. 选择 **备份 / 恢复**
+
+<Screenshot id="backup-restore" alt="备份恢复对话框" />
+
+3. 选择要备份的内容：
+   - 提示词历史
+   - 项目文件
+   - 素材库
+4. 点击 **导出**
+
+会下载一个 ZIP 文件，包含所有选中的数据。
+
+### 导入备份
+
+从备份文件恢复：
+
+1. 点击菜单按钮
+2. 选择 **备份恢复**
+3. 选择要导入的 ZIP 文件
+4. 选择要恢复的内容
+5. 点击 **导入**
+
+:::note
+导入会与现有数据合并，不会覆盖。
+:::
+
+## 分享作品
+
+想分享你的作品？
+
+1. **导出为图片** - 分享到社交媒体
+2. **导出为 JSON** - 发给其他 Opentu 用户
+3. **截图分享** - 快速分享
+
+## 常见问题
+
+**Q：导出的图片太大/太小？**
+
+A：导出的图片大小取决于画布上内容的实际尺寸。如果需要特定尺寸，可以先调整内容大小。
+
+**Q：导出时背景是透明的？**
+
+A：PNG 格式支持透明背景。如果需要白色背景，可以在画布底层添加一个白色矩形，或导出为 JPG 格式。
+
+**Q：项目文件可以发给别人吗？**
+
+A：可以。把 `.drawnix` 文件发给对方，对方用 Opentu 打开即可。

docs/user-manual/content/advanced/image-preview-edit.mdx

@@ -0,0 +1,150 @@
+---
+title: 图片预览与编辑
+category: advanced
+order: 5
+---
+
+# 图片预览与编辑
+
+Opentu 提供强大的图片预览和编辑功能，让你可以查看、裁剪、调整图片效果。
+
+## 图片预览
+
+<Screenshot id="image-preview" />
+<p class="screenshot-caption">图片预览界面：① 关闭预览 ② 缩放控制 ③ 编辑工具</p>
+
+### 打开预览
+
+在画布上**双击**图片元素，即可打开全屏预览。
+
+### 预览功能
+
+预览界面支持：
+
+- **缩放** - 滚轮缩放或点击 +/- 按钮
+- **拖动** - 拖动查看大图细节
+- **多图浏览** - 如果画布上有多张图片，可以左右切换
+- **联动模式** - 多图时可开启同步缩放/拖动（按 `S` 键切换）
+
+### 预览工具栏
+
+| 按钮 | 功能 |
+|------|------|
+| 缩放滑块 | 调整图片大小 |
+| 适应窗口 | 让图片适应当前窗口 |
+| 原始大小 | 以 100% 比例显示 |
+| 上一张/下一张 | 切换图片 |
+| 联动模式 | 多图同步操作 |
+
+## 图片编辑
+
+### 进入编辑模式
+
+1. 在画布上选中图片
+2. 点击弹出工具栏中的 **编辑** 按钮（画笔图标）
+
+或者在预览界面中点击 **编辑** 按钮。
+
+### 编辑界面
+
+图片编辑器提供两大功能：
+
+## 裁剪功能
+
+点击 **裁剪** 按钮进入裁剪模式：
+
+### 自由裁剪
+
+直接拖动裁剪框的边缘或角落，调整裁剪区域。
+
+### 比例裁剪
+
+选择预设的宽高比：
+- **自由** - 任意比例
+- **1:1** - 正方形
+- **4:3** - 传统照片比例
+- **16:9** - 宽屏比例
+- **9:16** - 竖屏比例
+- **原始** - 保持原图比例
+
+### 智能去白边
+
+点击 **自动去白边** 按钮，自动检测并裁剪掉图片的白色边框。
+
+:::tip
+这个功能对 AI 生成的图片特别有用，可以快速去除多余的白边。
+:::
+
+## 滤镜调整
+
+点击 **滤镜** 按钮进入调整模式：
+
+### 预设滤镜
+
+选择预设滤镜效果：
+- **原图** - 恢复原始效果
+- **鲜艳** - 增强饱和度和对比度
+- **柔和** - 降低对比度，更柔美
+- **复古** - 怀旧暖色调
+- **黑白** - 经典黑白效果
+- **冷色** - 蓝色冷调
+- **暖色** - 橙色暖调
+
+### 手动调节
+
+使用滑块精细调整：
+- **亮度** - 整体明暗
+- **对比度** - 明暗差异
+- **饱和度** - 色彩鲜艳程度
+- **色温** - 冷暖色调
+- **锐化** - 图片清晰度
+
+## 保存编辑
+
+编辑完成后，有三种保存方式：
+
+### 覆盖原图
+
+点击 **保存** 按钮，直接覆盖画布上的原图。
+
+### 另存为新图
+
+点击 **另存为** 按钮，保留原图，在画布上创建新的图片。
+
+### 下载
+
+点击 **下载** 按钮，将编辑后的图片保存到本地。
+
+### 放弃编辑
+
+点击 **X** 关闭按钮或按 `Esc` 键，放弃所有修改。
+
+## 撤销和重做
+
+编辑过程中支持撤销重做：
+
+- **撤销** - 点击工具栏的撤销按钮，或按 `Ctrl/Cmd + Z`
+- **重做** - 点击重做按钮，或按 `Ctrl/Cmd + Y`
+
+## 快捷键
+
+| 快捷键 | 功能 |
+|--------|------|
+| `Ctrl/Cmd + Z` | 撤销 |
+| `Ctrl/Cmd + Y` | 重做 |
+| `Esc` | 取消/退出编辑 |
+| `Enter` | 确认操作 |
+
+## 小贴士
+
+:::tip
+编辑大图时可能需要等待一会儿，请耐心等待处理完成。
+:::
+
+:::tip
+如果对编辑效果不满意，可以随时撤销或重新开始。
+:::
+
+:::note
+SVG 格式的图片暂不支持编辑功能。
+:::

docs/user-manual/content/advanced/knowledge-base.mdx

@@ -0,0 +1,75 @@
+---
+title: 知识库
+category: advanced
+order: 7
+---
+
+# 知识库
+
+知识库是你的个人知识管理空间，支持目录、标签、搜索、导入导出，并可将笔记插入到画布。
+
+## 打开知识库
+
+1. 点击 **工具箱**
+2. 找到 **知识库**
+3. 点击 **打开** 或 **新窗口**
+
+## 界面结构
+
+- **左侧栏**：搜索、标签筛选、目录树、笔记列表
+- **中间**：笔记编辑区（Markdown 编辑）
+- **右侧**：相似笔记与知识提取
+
+## 目录与笔记
+
+### 默认目录
+
+- **笔记**：通用知识与灵感记录
+- **Skill**：自定义 Skill 的专用目录
+
+### 目录操作
+
+在目录上右键可以：
+- 新建笔记
+- 复制目录
+- 重命名
+- 删除
+
+### 笔记操作
+
+在笔记上右键可以：
+- 创建副本
+- 插入到画布（生成关联卡片）
+- 删除
+
+## 标签与检索
+
+- 在顶部搜索框中输入关键词快速定位
+- 使用标签筛选笔记
+- 在菜单中选择 **管理标签** 进行维护
+
+## 导入与导出
+
+在左上角 **更多操作** 菜单中可以：
+
+- **导入 Markdown**：批量导入 `.md` / `.markdown`
+- **导入 ZIP**：导入完整的知识库备份
+- **导出 ZIP**：打包导出全部目录、笔记和标签
+
+:::note
+导入内容会与现有数据合并，不会覆盖已有笔记。
+:::
+
+## 知识提取
+
+在右侧切换到 **知识提取**：
+
+1. 让 AI 归纳关键知识点
+2. 选择需要的条目
+3. 保存为笔记或合并为一篇
+
+## Skill 目录用法
+
+- **系统 Skill** 会以只读笔记显示
+- **自定义 Skill**：在 Skill 目录新建笔记，写清楚角色、输入与输出格式
+- 保存后即可在 AI 输入框的 Skill 下拉中选择

docs/user-manual/content/advanced/media-library.mdx

@@ -0,0 +1,94 @@
+---
+title: 素材库
+category: advanced
+order: 2
+---
+
+# 素材库
+
+素材库用于管理你的图片和视频素材，包括 AI 生成的和手动上传的。
+
+## 打开素材库
+
+点击底部工具栏的 **素材库** 按钮，或点击底部的图库图标。
+
+<Screenshot id="media-library" alt="素材库面板" />
+
+## 素材来源
+
+素材库中的素材有两种来源：
+
+### AI 生成
+
+所有通过 AI 生成的图片和视频都会自动保存到素材库。
+
+### 手动上传
+
+你也可以手动上传图片：
+
+1. 打开素材库
+2. 点击 **上传** 按钮
+3. 选择本地图片文件
+
+## 使用素材
+
+### 插入到画布
+
+1. 在素材库中找到想要的图片
+2. 点击图片
+3. 图片会自动插入到画布中
+
+### 作为参考图
+
+在 AI 生成图片时：
+
+1. 点击输入框的图片图标
+2. 选择 **素材库**
+3. 选择要参考的图片
+
+## 管理素材
+
+### 查看详情
+
+点击素材可以查看大图和详细信息。
+
+### 删除素材
+
+1. 选中素材
+2. 点击删除按钮
+
+:::note
+删除素材不会影响已经插入画布的图片。
+:::
+
+### 筛选素材
+
+可以按类型筛选：
+- **全部** - 显示所有素材
+- **图片** - 只显示图片
+- **视频** - 只显示视频
+
+## 存储说明
+
+素材保存在浏览器本地存储中：
+
+- **优点**：无需登录，数据在本地，隐私安全
+- **注意**：清除浏览器数据会丢失素材
+
+:::tip
+重要素材建议使用 **备份恢复** 功能定期导出备份。
+:::
+
+## 常见问题
+
+**Q：素材库满了怎么办？**
+
+A：可以删除不需要的素材释放空间。或者导出备份后清理。
+
+**Q：换电脑/换浏览器素材还在吗？**
+
+A：不在。素材保存在当前浏览器中。需要使用 **备份恢复** 功能迁移数据。
+
+**Q：素材库支持多大的文件？**
+
+A：取决于浏览器的存储限制，一般几百 MB 到几 GB 不等。

docs/user-manual/content/advanced/settings.mdx

@@ -0,0 +1,151 @@
+---
+title: 设置与配置
+category: advanced
+order: 3
+---
+
+# 设置与配置
+
+了解如何配置 Opentu 的各项设置，包括 API 配置、主题切换等。
+
+## 打开设置
+
+点击左上角的菜单按钮，打开应用菜单：
+
+<Screenshot id="app-menu" alt="应用菜单" />
+
+选择 **设置** 打开设置对话框：
+
+<Screenshot id="settings-dialog" alt="设置对话框" />
+
+## API 配置
+
+要使用 AI 生成功能，需要配置 API。
+
+### 图片生成 API
+
+1. 打开设置 → **图片生成** 选项卡
+2. 填写 **API Key**
+3. 填写 **API 地址**（如有需要）
+4. 点击保存
+
+**获取 API Key**：
+- 可以使用 [tu-zi.com](https://tu-zi.com) 提供的 API 服务
+- 或使用自己的 Gemini API Key
+
+### 视频生成 API
+
+1. 打开设置 → **视频生成** 选项卡
+2. 配置视频 API 相关信息
+3. 保存设置
+
+## 主题切换
+
+支持亮色和暗色两种主题：
+
+1. 点击右下角的主题切换按钮
+2. 或在设置中选择主题模式
+
+**亮色主题**：适合白天使用，背景明亮
+**暗色主题**：适合夜间使用，保护眼睛
+
+## 语言设置
+
+支持中文和英文界面：
+
+1. 打开设置
+2. 找到语言选项
+3. 选择 **中文** 或 **English**
+
+## 数据存储
+
+### 本地存储
+
+Opentu 的数据存储在浏览器本地：
+
+- **项目文件** - 你的画布内容
+- **素材库** - 上传和生成的图片视频
+- **提示词历史** - 使用过的提示词
+- **设置** - 你的配置信息
+
+### 存储位置
+
+数据保存在：
+- IndexedDB - 大文件存储
+- LocalStorage - 配置信息
+- Cache Storage - 缓存数据
+
+### 数据安全
+
+- 数据不会上传到服务器
+- 只保存在你的浏览器中
+- 清除浏览器数据会丢失
+
+:::tip
+重要数据请定期使用 **备份恢复** 功能导出备份。
+:::
+
+## 清除数据
+
+如需清除数据：
+
+### 清除当前画布
+
+1. 点击菜单 → **清空画布**
+2. 确认清除
+
+**快捷键**：`Ctrl/Cmd + Backspace`
+
+### 清除所有数据
+
+1. 打开浏览器设置
+2. 清除网站数据
+3. 选择 opentu.ai 的数据
+
+:::note
+清除后无法恢复，请先备份重要内容。
+:::
+
+## 快捷键设置
+
+目前使用系统默认快捷键，暂不支持自定义。
+
+常用快捷键参考首页的快捷键列表。
+
+## 移动端适配
+
+Opentu 支持在移动设备上使用：
+
+- **触摸操作** - 支持手指缩放和拖动
+- **响应式布局** - 自动适应屏幕大小
+- **工具栏适配** - 底部工具栏优化
+
+### 移动端特殊操作
+
+- **双指缩放** - 缩放画布
+- **单指拖动** - 移动画布（手形模式）
+- **长按** - 触发右键菜单
+
+## 常见问题
+
+**Q：设置保存在哪里？**
+
+A：保存在浏览器的 LocalStorage 中，换浏览器需要重新配置。
+
+**Q：API Key 安全吗？**
+
+A：API Key 只保存在你的浏览器本地，不会上传到服务器。但请注意不要在公共电脑上配置。
+
+**Q：为什么 AI 功能不可用？**
+
+A：请检查：
+1. API Key 是否正确配置
+2. API 地址是否正确
+3. 网络是否正常
+4. API 额度是否充足
+
+**Q：如何迁移到新电脑？**
+
+A：使用 **备份恢复** 功能：
+1. 在旧电脑导出备份 ZIP 文件
+2. 在新电脑导入该 ZIP 文件

docs/user-manual/content/advanced/task-queue.mdx

@@ -0,0 +1,51 @@
+---
+title: 任务队列
+category: advanced
+order: 8
+---
+
+# 任务队列
+
+任务队列用于管理所有 AI 生成任务，支持图片、视频与角色相关任务的追踪、筛选与批量操作。
+
+## 打开任务队列
+
+点击右侧工具栏底部的 **任务队列** 按钮即可展开面板。
+
+## 任务状态
+
+顶部 Tab 支持快速切换：
+
+- **全部** - 查看所有任务
+- **生成中** - 正在处理的任务
+- **失败** - 需要重试的任务
+- **已完成** - 可插入或下载的任务
+
+## 筛选与搜索
+
+- 类型过滤：图片 / 视频 / 角色
+- 搜索框：按提示词或内容关键字检索
+
+## 单个任务操作
+
+任务卡片提供常用操作：
+
+- **插入**：将生成结果插入到画布
+- **下载**：保存到本地
+- **编辑**：进入内置编辑器继续处理
+- **重试**：失败任务一键重试
+- **删除**：移除任务记录
+
+## 批量操作
+
+点击 **多选** 进入批量模式后，可以：
+
+- **取消** 进行中的任务
+- **重试** 失败任务
+- **删除** 选中任务
+
+## 常见提示
+
+:::tip
+生成完成的图片或视频会自动进入素材库，方便后续复用。
+:::

docs/user-manual/content/advanced/toolbox.mdx

@@ -0,0 +1,164 @@
+---
+title: 工具箱
+category: advanced
+order: 6
+---
+
+# 工具箱
+
+工具箱是 Opentu 的扩展功能中心，提供各种实用工具来增强你的创作体验。
+
+## 打开工具箱
+
+<Screenshot id="toolbox-entry" />
+<p class="screenshot-caption">点击工具箱按钮打开工具箱</p>
+
+点击右侧工具栏的 **打开工具箱** 按钮。
+
+<Screenshot id="toolbox-drawer" />
+<p class="screenshot-caption">工具箱抽屉：内容工具和 AI 工具</p>
+
+## 工具分类
+
+工具箱中的工具分为两大类：
+
+### 内容工具
+
+提供创作素材和灵感的工具：
+
+| 工具 | 功能 |
+|------|------|
+| **香蕉提示词** | 查看和复制优质 AI 提示词 |
+| **动作场景库** | 专业人体姿态参考素材库 |
+| **知识库** | 个人知识管理与 Skill 管理 |
+
+### AI 工具
+
+AI 驱动的创作工具：
+
+| 工具 | 功能 |
+|------|------|
+| **Chat-MJ** | ChatGPT Web 聊天界面，支持 Midjourney |
+| **批量出图工具** | Excel式批量 AI 图片生成 |
+| **AI 图片生成（单图）** | 专业 AI 图片创作工具 |
+| **AI 视频生成** | AI 驱动的短视频创作 |
+
+## 使用工具
+
+### 方法一：在抽屉中打开
+
+1. 点击工具项右侧的 **打开** 按钮
+2. 工具会在侧边面板中显示
+
+### 方法二：独立窗口打开
+
+1. 点击工具项右侧的 **新窗口** 按钮（带外链图标）
+2. 工具会在独立的浮动窗口中打开
+
+### 独立窗口功能
+
+独立窗口可以：
+- **拖动** - 移动窗口位置
+- **调整大小** - 拖动边缘改变窗口大小
+- **最小化** - 缩小到角落
+- **关闭** - 关闭窗口
+
+## 香蕉提示词
+
+这是一个提示词库，收集了各种优质的 AI 绘图提示词：
+
+### 浏览分类
+
+提示词按风格分类：
+- 人物
+- 风景
+- 动物
+- 抽象艺术
+- 更多...
+
+### 使用提示词
+
+1. 找到喜欢的提示词
+2. 点击 **复制** 按钮
+3. 粘贴到 AI 输入框使用
+
+## 批量出图工具
+
+需要批量生成图片时，使用这个工具：
+
+### 表格编辑
+
+像 Excel 一样编辑多行提示词：
+- 每行一条提示词
+- 支持批量编辑
+- 支持图片参考
+
+### 批量生成
+
+1. 填写提示词列表
+2. 选择模型和设置
+3. 点击开始批量生成
+4. 查看生成进度和结果
+
+### 历史追踪
+
+所有生成记录会保存，可以随时查看历史任务。
+
+## 知识库
+
+知识库是你的个人素材与知识管理区，适合记录灵感、规范、项目资料，并支持自定义 Skill。
+
+### 快速打开
+
+1. 在工具箱中找到 **知识库**
+2. 点击 **打开** 或 **新窗口**
+
+### 常见用法
+
+- 记录笔记并按目录管理
+- 使用标签快速筛选
+- 将笔记插入到画布作为卡片
+
+## 动作场景库
+
+提供人体动作参考素材：
+
+### 分类浏览
+
+- 站立姿势
+- 坐姿
+- 动作姿势
+- 多角度参考
+
+### 使用方法
+
+1. 浏览找到需要的姿势
+2. 点击查看大图
+3. 可以作为 AI 生成的参考
+
+## 工具筛选
+
+### 搜索工具
+
+在搜索框输入关键词，快速找到需要的工具。
+
+### 分类筛选
+
+点击分类标签筛选：
+- **全部** - 显示所有工具
+- **内容工具** - 只显示内容类工具
+- **AI 工具** - 只显示 AI 类工具
+
+## 小贴士
+
+:::tip
+常用的工具可以用独立窗口打开，边创作边使用。
+:::
+
+:::tip
+批量出图工具非常适合需要大量图片的场景，比如制作系列图片。
+:::
+
+:::note
+部分工具需要网络连接才能使用。
+:::

docs/user-manual/content/advanced/troubleshooting.mdx

@@ -0,0 +1,197 @@
+---
+title: 问题排查
+category: advanced
+order: 4
+---
+
+# 问题排查
+
+遇到问题不要慌，本文介绍如何排查和解决常见问题。
+
+## 调试面板
+
+Opentu 提供了一个内置的调试面板，可以帮助定位问题。
+
+### 打开调试面板
+
+在浏览器地址栏输入对应环境的调试面板地址：
+
+| 环境 | 调试面板地址 |
+|------|-------------|
+| 正式环境 | [https://opentu.ai/sw-debug.html](https://opentu.ai/sw-debug.html) |
+| 体验环境 | [https://pr.opentu.ai/sw-debug.html](https://pr.opentu.ai/sw-debug.html) |
+
+**规则**：在当前应用地址后面加 `/sw-debug.html`
+
+### 调试面板功能
+
+调试面板界面如下：
+
+<Screenshot id="debug-panel" alt="调试面板" />
+
+调试面板提供以下功能：
+
+#### 1. Service Worker 状态
+
+显示当前 Service Worker 的运行状态：
+- **已连接**（绿色）- 正常工作
+- **未连接**（红色）- 需要排查
+
+#### 2. 导出诊断日志
+
+点击 **导出日志** 按钮，会下载一个 JSON 文件，包含：
+- 任务队列状态
+- API 请求日志
+- 错误信息
+
+:::tip
+遇到问题时，导出日志文件发给开发者，可以帮助快速定位问题。
+:::
+
+#### 3. 数据备份
+
+在调试面板中也可以进行数据备份：
+- 点击 **数据备份** 按钮
+- 选择要备份的内容
+- 下载 ZIP 文件
+
+#### 4. 清除缓存
+
+如果应用出现异常（如页面空白、功能失效），可以尝试清除缓存：
+- 点击 **清除缓存** 按钮
+- 刷新页面
+
+:::note
+清除缓存不会删除你的项目和素材，只会清除应用程序的缓存文件。
+:::
+
+## 常见问题
+
+### AI 生成功能不可用
+
+**症状**：点击发送后没有反应，或提示错误
+
+**排查步骤**：
+
+1. **检查网络连接**
+   - 确保网络正常
+   - 尝试刷新页面
+
+2. **检查 API 配置**
+   - 打开 **菜单 → 设置**
+   - 确认 API Key 已正确填写
+   - 确认 API 地址正确
+
+3. **检查 API 额度**
+   - 登录 API 服务商后台查看余额
+
+4. **查看调试面板**
+   - 打开 `sw-debug.html`
+   - 查看是否有错误日志
+
+### 页面加载缓慢或空白
+
+**症状**：页面长时间白屏或加载很慢
+
+**解决方法**：
+
+1. **清除浏览器缓存**
+   - 打开调试面板
+   - 点击 **清除缓存**
+   - 刷新页面
+
+2. **硬刷新**
+   - Windows: `Ctrl + Shift + R`
+   - Mac: `Cmd + Shift + R`
+
+3. **检查浏览器兼容性**
+   - 推荐使用 Chrome、Edge、Safari 最新版
+   - 不建议使用 IE 浏览器
+
+### 素材库图片不显示
+
+**症状**：素材库中的图片显示为空白或加载失败
+
+**解决方法**：
+
+1. **检查存储空间**
+   - 浏览器本地存储可能已满
+   - 删除不需要的素材释放空间
+
+2. **清除并重新缓存**
+   - 打开调试面板
+   - 查看缓存状态
+   - 尝试清除异常的缓存项
+
+### 数据丢失
+
+**症状**：项目或素材突然消失
+
+**可能原因**：
+
+1. **浏览器数据被清除**
+   - 检查是否使用了"清理工具"
+   - 检查浏览器隐私设置
+
+2. **使用了无痕/隐私模式**
+   - 无痕模式关闭后数据会丢失
+   - 请使用正常模式
+
+**预防措施**：
+
+- 定期使用 **备份恢复** 功能导出数据
+- 重要项目及时导出为 PNG 或 JSON 文件
+
+### 视频生成一直等待
+
+**症状**：视频任务长时间显示"处理中"
+
+**说明**：
+
+视频生成需要较长时间（1-5 分钟甚至更长），这是正常的。
+
+**如果超过 10 分钟**：
+
+1. 在任务队列中查看任务状态
+2. 如果显示失败，点击 **重试**
+3. 检查调试面板中的错误日志
+
+### 快捷键不生效
+
+**可能原因**：
+
+1. **焦点在输入框中**
+   - 点击画布空白区域，确保焦点在画布上
+
+2. **与浏览器快捷键冲突**
+   - 某些快捷键可能被浏览器占用
+   - 尝试使用工具栏按钮代替
+
+3. **输入法干扰**
+   - 切换到英文输入法
+   - 关闭输入法后重试
+
+## 获取技术支持
+
+如果以上方法无法解决问题：
+
+### 1. 收集信息
+
+- 打开调试面板，导出日志
+- 截图问题界面
+- 记录操作步骤
+
+### 2. 联系方式
+
+- **GitHub Issues**: [提交问题](https://github.com/ljquan/aitu/issues)
+- **用户交流群**: 扫码加入
+
+<img src="https://tuziai.oss-cn-shenzhen.aliyuncs.com/aitu/AiTu.png" alt="用户交流群二维码" style="max-width: 180px; border-radius: 8px;" />
+
+### 3. 提交问题时请包含
+
+- 问题描述
+- 操作步骤
+- 浏览器版本
+- 导出的日志文件（如有）
+- 截图（如有）