本文档详细介绍了 GEO Wiki Pro 的所有功能和操作方法，精确到每一个按钮和交互元素。 --- ## 一、首页 首页由多个可配置区块组成，管理员可在后台自由编排区块顺序和内容。 ### 1.1 顶部导航栏（NavHeader） 顶部导航栏在所有页面可见。  | 按钮/元素 | 位置 | 操作说明 | |-----------|------|---------| | **Logo / 站点名称** | 左侧 | 点击返回首页 | | **汉堡菜单** ☰ | 左侧（移动端） | 展开/收起移动端侧边栏 | | **搜索栏** | 中间 | 点击打开全局搜索弹窗（快捷键 `Cmd+K` / `Ctrl+K`） | | **主题切换** 🌙/☀️ | 右侧 | 在浅色模式和深色模式之间切换 | | **语言选择器** | 右侧 | 点击展开下拉菜单，可选：中文 / EN / 日本語 | | **登录/后台** 按钮 | 右侧 | 未登录时显示「登录」，点击跳转登录页；已登录时显示「后台」，点击进入管理后台 | ### 1.2 Hero 区块 Hero 区块是首页最上方的横幅区域，支持管理员自定义配置。  | 元素 | 说明 | |------|------| | **Logo 图标** | 站点 Logo，管理员可配置是否显示 | | **大标题** | 站点主标题，如「欢迎来到 GEO Wiki Pro」 | | **副标题** | 站点描述，如「新一代结构化知识库，深度 GEO 搜索引擎优化」 | | **「快速开始」卡片** | 点击「查看产品总览」按钮跳转到快速入门文档 | | **「让 AI 快速了解」卡片** | 点击「一键复制」按钮，将 `/api/v1/llms.txt` 内容复制到剪贴板，可粘贴给 ChatGPT/Claude/DeepSeek | ### 1.3 分类网格区块  | 元素 | 操作 | |------|------| | **分类卡片** | 点击卡片跳转到对应分类页面，显示分类名称和文章数量 | ### 1.4 热门文档 / 最新文档区块  | 元素 | 操作 | |------|------| | **文档卡片** | 点击跳转到对应文档详情页 | | **「查看全部文档」按钮** | 跳转到全部文档列表页 | ### 1.5 常见问题区块  | 元素 | 操作 | |------|------| | **FAQ 问答卡片** | 点击跳转到 FAQ 文档对应锚点位置 | | **「查看全部常见问题」按钮** | 跳转到完整 FAQ 页面 | ### 1.6 回到顶部按钮  | 元素 | 操作 | |------|------| | **回到顶部按钮** ↑ | 滚动超过 400px 后出现，点击平滑滚动到页面顶部 | --- ## 二、全局搜索（SearchModal） 通过点击搜索栏或快捷键 `Cmd+K` / `Ctrl+K` 打开。  | 元素 | 操作 | |------|------| | **搜索输入框** | 输入关键词，实时模糊搜索文档标题和内容 | | **ESC 提示** | 按 `Esc` 键关闭搜索弹窗 | | **分类快捷链接** | 点击直接跳转到对应分类页面 | | **搜索结果项** | 点击跳转到对应文档详情页 | | **↑ ↓ 键盘导航** | 使用方向键在结果中上下移动选中 | | **Enter 打开** | 按 `Enter` 打开当前选中的结果 | | **空白遮罩** | 点击搜索框外部区域关闭弹窗 | | **无结果提示** | 显示「未找到相关文档，尝试其他关键词或浏览分类」 | --- ## 三、登录页面 访问 `/login` 进入登录页面。  ### 3.1 登录表单 | 按钮/元素 | 操作 | |-----------|------| | **用户名输入框** | 输入管理员或编辑者用户名 | | **密码输入框** | 输入密码 | | **「忘记密码？」链接** | 点击弹出提示框：「请联系系统管理员重置密码」 | | **「登录」按钮** | 提交表单，验证通过后弹出验证码 | | **「联系管理员」链接** | 点击弹出提示框：「请联系系统管理员创建新账户」 | ### 3.2 验证码弹窗 登录验证通过后弹出验证码。  | 按钮/元素 | 操作 | |-----------|------| | **表情网格（3×3）** | 点击正确的表情图标完成验证，自动提交登录 | | **「取消」按钮** | 关闭验证码弹窗，重置登录状态 | | **错误提示** | 验证失败时显示错误信息 | ### 3.3 首次登录 首次登录使用默认密码时，系统会弹出密码修改提醒。  | 按钮/元素 | 操作 | |-----------|------| | **当前密码** | 输入当前默认密码 | | **新密码** | 输入新密码（至少8位，含大写、小写字母和数字） | | **确认新密码** | 再次输入新密码 | | **「确认修改」按钮** | 提交修改 | | **「稍后修改」按钮** | 跳过，稍后可在右上角用户菜单中修改 | --- ## 四、文档详情页（DocPage） 访问 `/docs/:slug` 查看单篇文档。  ### 4.1 面包屑导航 | 元素 | 操作 | |------|------| | **🏠 首页图标** | 返回首页 | | **分类名称** | 跳转到该分类页面 | | **文档标题** | 当前位置（不可点击） | ### 4.2 文档内容区 | 元素 | 操作 | |------|------| | **文档标题** | 显示文档标题 | | **文档描述** | 显示文档摘要 | | **通知横幅** | 如果该分类设置了通知，页面顶部显示黄色/蓝色提示条 | | **Markdown 内容** | 渲染后的文档正文 | | **代码块「复制」按钮** | 点击将代码块内容复制到剪贴板 | | **图片** | 点击图片可全屏查看（Lightbox） | | **YouTube/Bilibili 嵌入** | 内嵌视频播放器 | | **3D 模型嵌入** | 内嵌 3D 模型查看器 | | **标签链接** | 点击标签跳转到对应分类 | | **作者信息** | 显示最后编辑者头像缩写、名称和日期 | | **「最后更新于」** | 显示文档最后更新时间 | ### 4.3 右侧目录（SubSidebar）  | 按钮/元素 | 操作 | |-----------|------| | **分类名称** | 显示当前分类 | | **收起/展开按钮** | 折叠或展开侧边栏 | | **文档链接列表** | 显示当前分类下的所有文档，点击切换文档 | | **目录展开/收起箭头** | 展开或收起当前文档的标题目录 | | **目录标题链接** | 点击滚动到文档中对应标题位置 | ### 4.4 文档反馈 文档底部提供反馈功能。  | 按钮/元素 | 操作 | |-----------|------| | **「有帮助」按钮** | 点击表示文档有帮助，可进一步填写感想和邮箱 | | **「需要改进」按钮** | 点击表示文档需要改进，可填写改进建议 | | **留言输入框** | 输入反馈内容（选填） | | **邮箱输入框** | 输入邮箱（选填） | | **「跳过」按钮** | 取消反馈 | | **「提交反馈」按钮** | 提交反馈到后台 | | **感谢提示** | 提交后显示感谢信息 | ### 4.5 留言板（Guestbook） 如果管理员启用了留言功能，文档底部会显示留言板。  | 按钮/元素 | 操作 | |-----------|------| | **「留下留言」按钮** | 展开留言表单 | | **昵称输入框** | 输入留言昵称 | | **邮箱输入框** | 输入邮箱（选填） | | **留言输入框** | 输入留言内容 | | **「跳过」按钮** | 收起留言表单 | | **「提交留言」按钮** | 提交留言，需管理员审核后显示 | | **已有留言列表** | 显示已审核通过的留言（头像、昵称、日期、内容） | --- ## 五、分类页面（CategoryPage） 访问 `/category/:slug` 查看分类下的文档列表。  | 元素 | 操作 | |------|------| | **面包屑：首页** | 返回首页 | | **面包屑：分类名** | 当前位置 | | **分类名称** | 大标题显示 | | **分类描述** | 副标题显示 | | **文档列表** | 点击文档标题跳转到文档详情页 | --- ## 六、全部文档列表页（DocsListPage） 访问 `/docs` 查看所有文档。  | 元素 | 操作 | |------|------| | **页面标题「全部文档」** | 显示 | | **文档总数** | 显示「共 N 篇文档」 | | **精选徽章** | 精选文档显示「精选」标签 | | **文档列表项** | 点击跳转到文档详情页 | --- ## 七、管理后台 管理员和编辑者登录后可访问后台。访问 `/admin` 进入。 ### 7.1 后台侧边栏 侧边栏包含以下导航项，点击切换对应页面： | 导航项 | 路径 | 说明 | |--------|------|------| | **仪表盘** | `/admin/dashboard` | 概览统计和快捷入口 | | **文档管理** | `/admin/docs` | 文档的增删改查 | | **分类管理** | `/admin/categories` | 分类的增删改和排序 | | **标签管理** | `/admin/tags` | 标签的增删 | | **反馈管理** | `/admin/feedback` | 用户反馈和留言管理 | | **资源管理** | `/admin/media` | 文件上传和管理 | | **GEO 仪表盘** | `/admin/geo` | GEO 优化评分 | | **AI 爬虫分析** | `/admin/crawlers` | AI 爬虫访问统计 | | **GEO 报告** | `/admin/geo-report` | GEO 追踪效果报告 | | **首页布局** | `/admin/homepage-layout` | 首页区块编排 | | **用户管理** | `/admin/users` | 管理员/编辑者账号管理 | | **设置** | `/admin/settings` | 站点全局配置 | ### 7.2 后台顶部栏  | 按钮/元素 | 操作 | |-----------|------| | **汉堡菜单**（移动端） | 展开/收起侧边栏 | | **通知铃铛** 🔔 | 点击展开通知下拉列表（当前显示「暂无新通知」） | | **用户菜单** | 点击展开下拉菜单 | | ↳ **设置** | 跳转到设置页面 | | ↳ **修改密码** | 打开修改密码弹窗 | | ↳ **退出登录** | 退出登录，返回首页 | ### 7.3 退出登录 | 按钮 | 操作 | |------|------| | **侧边栏底部「退出登录」** | 退出登录，返回首页 | --- ## 八、仪表盘（AdminOverview） 路径：`/admin/dashboard`  ### 8.1 统计卡片 | 卡片 | 操作 | |------|------| | **文档数** | 点击跳转到文档管理页 | | **分类数** | 点击跳转到分类管理页 | | **标签数** | 点击跳转到标签管理页 | | **反馈数** | 点击跳转到反馈管理页 | ### 8.2 快捷操作 | 按钮 | 操作 | |------|------| | **「新建文档」** | 跳转到新建文档编辑器 | | **「GEO 仪表盘」** | 跳转到 GEO 仪表盘 | | **「设置」** | 跳转到设置页面 | --- ## 九、文档管理（AdminDashboard） 路径：`/admin/docs`  ### 9.1 工具栏 | 按钮/元素 | 操作 | |-----------|------| | **「+ 新建文档」按钮** | 跳转到新建文档编辑器 | | **搜索输入框** | 输入关键词筛选文档标题或标识 | | **分类筛选下拉框** | 选择分类过滤文档列表 | | **文档计数** | 显示「共 N 篇，显示 M 篇」 | | **排序提示** | 选择分类后显示「拖拽行首 ⋮⋮ 图标可重新排序」 | ### 9.2 文档列表表格 | 列 | 说明 | |----|------| | **排序** ⋮⋮ | 拖拽图标，拖动可调整文档排序（需先选择分类） | | **标题** | 文档标题 | | **分类** | 文档所属分类 | | **操作** | 编辑和删除按钮 | ### 9.3 每行操作按钮 | 按钮 | 操作 | |------|------| | **编辑** ✏️ | 跳转到文档编辑器 | | **删除** 🗑️ | 弹出确认框「确定要删除这篇文档吗？」，确认后删除 | --- ## 十、文档编辑器（AdminEditor） 路径：`/admin/docs/new` 或 `/admin/docs/edit/:slug` 这是内容创作的核心页面，包含丰富的编辑和 AI 优化工具。  ### 10.1 顶部操作栏 | 按钮/元素 | 操作 | |-----------|------| | **页面标题** | 新建时显示「新建文档」，编辑时显示「编辑文档」 | | **「显示预览」/「隐藏预览」按钮** | 切换右侧预览面板的显示/隐藏 | | **「历史版本」按钮** | 展开版本历史下拉列表，可查看和恢复历史版本 | | **「翻译」下拉按钮** | 展开翻译选项菜单 | | ↳ **翻译为英文** | 将文档标题、描述、内容翻译为英文并保存 | | ↳ **翻译为中文** | 将文档标题、描述、内容翻译为中文并保存 | | ↳ **翻译为日文** | 将文档标题、描述、内容翻译为日文并保存 | | **「AI 分析」按钮** | 对文档内容进行 GEO 优化分析，显示评分和建议 | | **「取消」按钮** | 返回文档管理页 | | **「保存文档」按钮** | 保存当前文档 | ### 10.2 元信息表单 | 字段 | 说明 | |------|------| | **标题**（必填） | 文档标题 | | **标识**（必填） | URL 标识符（编辑模式下不可修改） | | **分类**（下拉选择） | 文档所属分类 | | **作者** | 文档作者 | | **标签** | 输入标签后按 `Enter` 或逗号添加，点击 × 可删除 | | **描述** | 用于 GEO/SEO 的简短摘要，旁边有「AI 分析」按钮可自动生成 | | **通知** | 可选，显示在文章顶部的通知文本 | ### 10.3 富文本编辑器（RichEditor） 编辑器基于 CodeMirror，支持完整的 Markdown 编辑。  工具栏按钮从左到右： | 按钮 | 图标 | 功能 | 语法 | |------|------|------|------| | **加粗** | **B** | 将选中文本加粗 | `**文本**` | | **斜体** | *I* | 将选中文本设为斜体 | `*文本*` | | **一级标题** | H1 | 插入一级标题 | `# 标题` | | **二级标题** | H2 | 插入二级标题 | `## 标题` | | **三级标题** | H3 | 插入三级标题 | `### 标题` | | **分隔线** | — | 插入水平分隔线 | `---` | | **代码块** | </> | 插入代码块（可选择 27 种编程语言） | ` ``` 语言 ` | | **标签式代码块** | 📑 | 插入多语言标签式代码块（Python + JS 示例） | `:::code-tab` | | **引用** | ❝ | 插入引用块 | `> 引用文本` | | **无序列表** | • | 插入无序列表 | `- 列表项` | | **有序列表** | 1. | 插入有序列表 | `1. 列表项` | | **任务列表** | ☐ | 插入任务列表 | `- [ ] 任务项` | | **链接** | 🔗 | 插入超链接 | `[文本](URL)` | | **图片** | 🖼️ | 插入图片 | `` | | **表格** | 📊 | 插入 Markdown 表格骨架 | `\| 列1 \| 列2 \|` | | **分栏布局** | ⊞ | 选择 2 列或 3 列布局 | `:::grid[2]` | | **视频** | 🎬 | 嵌入 YouTube/Bilibili 视频 | `:::video[Title](url):::` | | **3D 模型** | 🧊 | 嵌入 3D 模型查看器 | `:::model[Title](url):::` | | **媒体上传** | ⬆️ | 打开媒体上传面板 | — | **编辑器附加功能：** - 拖拽文件到编辑器区域可直接上传 - 编辑器光标位置与右侧预览同步滚动 - 代码块插入时弹出语言选择器（JavaScript、Python、Go、Rust 等 27 种语言） ### 10.4 预览面板 | 元素 | 说明 | |------|------| | **实时预览** | 右侧面板实时渲染 Markdown 内容，所见即所得 | ### 10.5 AI GEO 优化面板 点击「AI 分析」按钮后展开。  | 元素 | 说明 | |------|------| | **GEO 分数** | 显示当前文档的 GEO 优化评分 | | **优化建议列表** | 显示具体改进建议（描述、标签、内容长度等） | | **检测主题** | 显示 AI 识别的文档主题 | | **「展开」/「收起」按钮** | 折叠或展开建议详情 | | **「插入优化内容」按钮** | 将优化建议追加到文档末尾 | | **「替换全文」按钮** | 用 AI 优化后的版本替换整个文档内容 | ### 10.6 翻译功能 点击「翻译」按钮可将文档翻译为其他语言。  | 元素 | 说明 | |------|------| | **翻译状态徽章** | 显示各语言版本状态：NEW（新增）/ ✅（已存在） | | **翻译缺失提示** | 如缺少英文/中文版本，显示「缺少XX版本，建议生成」 | | **翻译确认弹窗** | 翻译前弹出确认：「将翻译标题、描述、通知和全部内容，确认继续？」 | ### 10.7 版本历史  | 元素 | 操作 | |------|------| | **版本列表** | 显示历史版本号 | | **「恢复」按钮** | 点击恢复到指定版本，弹出确认：「确定恢复到版本 vX？」 | ### 10.8 底部操作 | 按钮 | 操作 | |------|------| | **「取消」按钮** | 返回文档管理页（未保存时弹出确认提示） | | **「保存文档」按钮** | 保存文档。新建时保存到当前语言目录，分类和标签自动同步到其他语言版本 | --- ## 十一、分类管理（AdminCategories） 路径：`/admin/categories`  ### 11.1 添加分类 | 按钮/元素 | 操作 | |-----------|------| | **「添加新分类」按钮** | 展开/收起添加表单 | | **分类名称（中文）** | 输入中文分类名称 | | **分类名称（英文）** | 输入英文分类名称 | | **分类名称（日文）** | 输入日文分类名称 | | **分类标识（slug）** | 自动生成（从中文名称），也可手动修改 | | **图标选择器** 📷 | 点击打开图标选择弹窗，选择分类图标 | | **中文描述** | 输入中文分类描述（可选） | | **英文描述** | 输入英文分类描述（可选） | | **日文描述** | 输入日文分类描述（可选） | | **「+ 添加分类」按钮** | 提交创建分类 | ### 11.2 分类列表 | 列 | 说明 | |----|------| | **拖拽排序** ⋮⋮ | 拖动可调整分类排序 | | **图标** | 分类图标 | | **名称** | 分类名称 | | **标识** | 分类 slug | | **文档数** | 该分类下的文档数量 | | **操作** | 编辑和删除按钮 | ### 11.3 每行操作 | 按钮 | 操作 | |------|------| | **编辑** | 进入行内编辑模式，修改后点击「保存」 | | **删除** | 弹出删除确认弹窗 | ### 11.4 图标选择弹窗  | 元素 | 操作 | |------|------| | **23 个图标按钮** | 点击选择分类图标 | | **关闭按钮** | 关闭弹窗 | --- ## 十二、标签管理（AdminTags） 路径：`/admin/tags`  | 按钮/元素 | 操作 | |-----------|------| | **「新增标签」按钮** | 展开添加表单 | | **标签名称输入框** | 输入标签名称 | | **标签标识输入框** | 输入标签 slug | | **「保存」按钮** | 创建标签 | | **「取消」按钮** | 收起表单 | | **标签列表** | 显示所有标签的名称和标识 | | **「删除」按钮** | 弹出确认弹窗「确定要删除此标签吗？此操作不可撤销」 | --- ## 十三、反馈管理（AdminFeedback） 路径：`/admin/feedback`  ### 13.1 选项卡切换 | 按钮 | 操作 | |------|------| | **反馈** 选项卡 | 切换到用户反馈视图 | | **留言** 选项卡 | 切换到留言管理视图 | | **「刷新」按钮** | 重新加载数据 | | **留言功能开关** | 开启/关闭留言功能 | ### 13.2 反馈视图 | 子选项卡 | 说明 | |---------|------| | **需要改进** | 显示用户标记为「需要改进」的反馈 | | **有帮助** | 显示用户标记为「有帮助」的反馈 | 每个反馈卡片包含： | 按钮/元素 | 操作 | |-----------|------| | **展开/收起** | 查看反馈详情 | | **「发布为留言」按钮** | 将有帮助的反馈发布为留言（需在留言管理中审核） | ### 13.3 留言管理 | 按钮/元素 | 操作 | |-----------|------| | **留言列表** | 显示所有留言，含头像、昵称、日期、内容 | | **状态徽章** | 「已通过」/「待审核」 | | **「通过」按钮** | 审核通过留言，使其在前台显示 | | **「待审核」按钮** | 将留言设为待审核状态 | | **「删除」按钮** | 删除留言（需确认） | | **「来自反馈」标记** | 显示该留言是否来自反馈转发布 | --- ## 十四、资源管理（AdminMedia） 路径：`/admin/media`  ### 14.1 上传区域 | 按钮/元素 | 操作 | |-----------|------| | **「上传文件」按钮** | 打开文件选择器，选择要上传的文件 | | **拖拽区域** | 将文件拖拽到此区域直接上传 | | **「浏览文件」链接** | 同上传按钮，打开文件选择器 | | **保存目录输入框** | 设置上传文件的子目录路径 | | **上传进度** | 显示上传中的进度状态 | **支持格式**：JPG, PNG, GIF, WebP，最大 50MB ### 14.2 文件列表 | 列 | 说明 | |----|------| | **文件** | 文件名和 URL | | **类型** | 文件 MIME 类型 | | **大小** | 文件大小 | | **上传时间** | 上传日期 | | **操作** | 复制 URL 和删除按钮 | ### 14.3 文件操作 | 按钮 | 操作 | |------|------| | **图片缩略图** | 点击打开图片全屏预览（Lightbox） | | **「复制 URL」按钮** | 复制文件 URL 到剪贴板 | | **「删除」按钮** | 弹出确认弹窗「确认删除 XX？此操作不可撤销」 | --- ## 十五、GEO 仪表盘（GeoDashboard） 路径：`/admin/geo`  ### 15.1 概览卡片 | 卡片 | 说明 | |------|------| | **平均 GEO 分数** | 所有文档的平均优化评分 | | **文档总数** | 文档数量和分类数 | | **llms.txt** | 状态：已启用/已禁用，已索引文档数 | | **Sitemap** | 状态：已启用/已禁用，URL 数量 | ### 15.2 图表区域 | 图表 | 说明 | |------|------| | **分数分布** | 柱状图显示各分数段的文档数量 | | **内容覆盖率** | 进度条显示有描述/有标签/长内容的文档占比 | ### 15.3 优化机会 列出最常见的未通过检查项，帮助优先改进。 ### 15.4 分类统计表 | 列 | 说明 | |----|------| | **分类** | 分类名称 | | **文档数** | 该分类文档数 | | **平均分** | 该分类平均 GEO 分数 | | **分数条** | 可视化分数进度条 | ### 15.5 文档评分表 | 列 | 说明 | |----|------| | **文档** | 文档标题 | | **分数** | GEO 评分 | | **描述/标签/内容** | 各项检查结果 | | **检查项** | 通过的检查数量 | | **编辑** | 点击跳转到文档编辑器 | **评分等级**：优秀 / 良好 / 一般 / 需改进 --- ## 十六、AI 爬虫分析（CrawlerDashboard） 路径：`/admin/crawlers`  ### 16.1 概览卡片 | 卡片 | 说明 | |------|------| | **总访问量** | 所有 AI 爬虫的总访问次数 | | **独立爬虫** | 不同爬虫的数量 | | **最活跃爬虫** | 访问次数最多的爬虫名称 | ### 16.2 每日活动 30 天柱状图，显示每日 AI 爬虫访问量趋势。 ### 16.3 爬虫明细 | 列 | 说明 | |----|------| | **爬虫** | 爬虫 User-Agent 名称 | | **厂商** | AI 厂商标签（如 ChatGPT、Claude 等） | | **访问次数** | 该爬虫的访问总数 | | **进度条** | 占总访问量的比例 | | **最近访问** | 最后一次访问时间 | ### 16.4 热门路径 按访问量排序的 URL 路径列表。 ### 16.5 最近访问 | 列 | 说明 | |----|------| | **爬虫** | 访问的爬虫名称 | | **厂商** | AI 厂商 | | **路径** | 访问的 URL 路径 | | **时间** | 访问时间 | --- ## 十七、GEO 报告（GeoReport） 路径：`/admin/geo-report`  ### 17.1 访问指标 | 指标 | 说明 | |------|------| | **总访问量** | AI 爬虫的总访问次数 | | **日均访问** | 平均每天的访问量 | | **趋势变化** | 上升/下降/持平 + 百分比 | ### 17.2 AI 模型收录 网格显示各 AI 模型的收录情况： | 模型信息 | 说明 | |---------|------| | **模型名称** | ChatGPT、Claude、Gemini 等 | | **收录状态** | 「已收录」/「未收录」徽章 | | **访问次数** | 该模型的访问次数 | | **最近访问** | 最后一次访问时间 | ### 17.3 热门内容 按引用次数排序的热门文档列表。 ### 17.4 优化建议 | 建议 | 说明 | |------|------| | **提交站点到 AI 模型索引服务** | 让 AI 模型发现您的站点 | | **确保 /llms.txt 可正常访问** | AI 爬虫通过此文件了解站点 | | **为文档添加 JSON-LD 结构化数据** | 提升 AI 理解能力 | | **编写 FAQ 和应用案例** | 提升被 AI 引用的概率 | --- ## 十八、首页布局管理（AdminHomepageLayout） 路径：`/admin/homepage-layout`  ### 18.1 区块列表 | 按钮/元素 | 操作 | |-----------|------| | **拖拽排序** ⋮⋮ | 拖动调整区块顺序 | | **显示/隐藏开关** | 切换区块在前台是否可见 | | **删除按钮** 🗑️ | 删除该区块 | | **展开/收起** ▼ | 展开或收起区块的详细配置 | ### 18.2 底部操作 | 按钮 | 操作 | |------|------| | **「+ 添加区块」按钮** | 选择区块类型并添加（Hero 标题区/分类网格/精选文章/最新文档/常见问题） | | **「重置为默认布局」按钮** | 恢复默认布局（需确认） | | **「💾 保存布局」按钮** | 保存当前布局配置 | ### 18.3 Hero 标题区配置 | 配置项 | 说明 | |--------|------| | **大标题（中文/英文）** | 自定义 Hero 区域标题 | | **副标题（中文/英文）** | 自定义 Hero 区域副标题 | | **显示 Logo** | 开关控制是否显示 Logo | | **快速开始按钮** | 开关控制是否显示快速开始卡片 | | **AI 提示按钮** | 开关控制是否显示 AI 提示卡片 | | **卡片比例** | 滑块调节两张卡片的宽度比例 | | **卡片顺序** | 切换快速开始和 AI 提示的左右顺序 | | **快速开始配置** | 标题、描述、按钮文字、跳转链接 | | **AI 提示配置** | 标题、描述、按钮文字、背景颜色 | ### 18.4 分类网格配置 | 配置项 | 说明 | |--------|------| | **列数** | 1/2/3/4 列布局 | | **文章数** | 显示/隐藏文章数量 | | **标题** | 自定义区块标题 | | **选中展示的分类** | 勾选要展示的分类（不选则全部展示） | ### 18.5 精选文章 / 最新文档配置 | 配置项 | 说明 | |--------|------| | **区块标题** | 自定义标题 | | **列数** | 1/2/3/4 列布局 | | **展示数量** | 最多展示 N 篇 | | **查看全部** | 显示/隐藏「查看全部」链接 | | **精选文档**（仅精选文章） | 手动选择要展示的文档 | ### 18.6 常见问题配置 | 配置项 | 说明 | |--------|------| | **区块标题** | 自定义标题 | | **展示条数** | 最多展示 N 条 | | **来源文档** | 指定 FAQ 数据来源的文档 slug | | **查看全部** | 显示/隐藏「查看全部」链接 | | **问答列表** | 手动添加问答对（留空则从来源文档读取） | | **「+ 添加问答」按钮** | 添加新的问答对 | --- ## 十九、用户管理（AdminUsers） 路径：`/admin/users`  ### 19.1 新增用户 | 按钮/元素 | 操作 | |-----------|------| | **「新增用户」按钮** | 展开/收起新增用户表单 | | **用户名输入框** | 输入新用户名 | | **密码输入框** | 输入初始密码 | | **角色下拉框** | 选择角色：管理员 / 编辑者 | | **密码提示** | 「密码至少 8 位，包含大写字母、小写字母和数字。用户首次登录时需修改密码。」 | | **「创建」按钮** | 创建用户 | ### 19.2 用户列表 | 列 | 说明 | |----|------| | **用户名** | 用户登录名 | | **角色** | 管理员 / 编辑者 | | **创建时间** | 用户创建日期 | | **密码状态** | 「待修改」表示用户仍在使用默认密码 | | **操作** | 编辑、重置密码、删除按钮 | ### 19.3 用户操作 | 按钮 | 操作 | |------|------| | **「编辑」按钮** | 进入行内编辑模式，可修改角色 | | **角色编辑下拉框** | 选择新角色 | | **「保存」按钮** | 保存角色修改 | | **「取消」按钮** | 取消编辑 | | **「重置密码」按钮** | 打开重置密码弹窗 | | **「删除」按钮** | 打开删除确认弹窗 | **注意**：当前登录用户不能删除自己的账号，也不能修改自己的角色。当前用户行显示「当前」标记。 ### 19.4 重置密码弹窗  | 元素 | 说明 | |------|------| | **重置确认** | 「确定要重置用户 XX 的密码吗？」 | | **「重置密码」按钮** | 点击生成随机临时密码 | | **新密码显示** | 显示生成的新密码（可复制） | | **警告提示** | 「点击重置后将生成一个随机临时密码」 | | **「关闭」按钮** | 关闭弹窗 | --- ## 二十、设置页面（AdminSettings） 路径：`/admin/settings` 设置页面分为 6 个区块，每个区块独立保存。  ### 20.1 品牌设置 | 配置项 | 说明 | |--------|------| | **站点名称** | 输入站点名称 | | **站点描述** | 输入站点描述 | | **Logo** | 显示当前 Logo 预览 | | **「上传 Logo」按钮** | 选择图片文件上传 Logo | | **主题色** | 颜色选择器 + 文本输入，实时预览效果 | | **重置颜色按钮** | 恢复默认色 #2563EB | | **默认语言** | 下拉选择：中文 / English / 日本語 | | **页脚文本** | 输入页脚显示的文本 | | **「保存设置」按钮** | 保存品牌设置 | ### 20.2 首页设置 | 配置项 | 说明 | |--------|------| | **Hero 标题（中文/英文）** | 自定义首页 Hero 区域标题 | | **Hero 副标题（中文/英文）** | 自定义首页 Hero 区域副标题 | | **「保存设置」按钮** | 保存首页设置 | ### 20.3 通用设置 | 配置项 | 说明 | |--------|------| | **站点 URL** | 输入站点完整 URL | | **支持的 AI 模型** | 输入 AI 模型列表 | | **「保存设置」按钮** | 保存通用设置 | ### 20.4 AI & GEO 设置 | 配置项 | 说明 | |--------|------| | **LLM 厂商** | 下拉选择：OpenAI / Anthropic / DeepSeek / MiniMax / 自定义 | | **API Key** | 输入 LLM API 密码 | | **模型** | 输入模型名称 | | **Base URL** | 输入 API 基础 URL | | **「测试连接」按钮** | 测试 LLM API 连接是否正常 | | **自动 GEO 优化** | 开关，自动为所有文档生成 JSON-LD 结构化数据 | | **启用 /llms.txt** | 开关，生成 AI 友好的文档索引 | | **启用 Sitemap** | 开关，自动生成 sitemap.xml | | **启用留言** | 开关，在文档页面底部显示留言板 | | **「重建 GEO 数据」按钮** | 重建所有 GEO 结构化数据 | | **「保存设置」按钮** | 保存 AI & GEO 设置 | **提示**：也可通过环境变量 `LLM_PROVIDER` / `LLM_API_KEY` 配置 LLM。 ### 20.5 LLMs.txt 配置 | 配置项 | 说明 | |--------|------| | **联系邮箱** | 输入联系邮箱 | | **联系页面 URL** | 输入联系页面链接（选填） | | **显示 API 文档** | 开关，在 llms.txt 中包含 API 接口信息 | | **排除的分类** | 输入要排除的分类 slug（逗号分隔） | | **排除的文档** | 输入要排除的文档 slug（逗号分隔） | | **「预览 llms.txt 内容」链接** | 新窗口打开 llms.txt 预览 | | **「保存设置」按钮** | 保存 LLMs.txt 配置 | ### 20.6 高级设置 | 配置项 | 说明 | |--------|------| | **自定义 Head HTML** | 输入要注入到所有页面 `<head>` 中的 HTML 代码（用于统计、自定义 meta 标签等） | | **「AI 优化」按钮** | 使用 AI 自动优化 Head HTML 内容 | | **「保存设置」按钮** | 保存高级设置 | --- ## 二十一、媒体上传面板（ImageUploader） 在文档编辑器中点击「媒体上传」按钮打开。  ### 21.1 上传区域 | 按钮/元素 | 操作 | |-----------|------| | **拖拽区域** | 拖拽文件到此区域直接上传 | | **保存目录** | 设置上传文件的子目录 | | **「点击选择文件」** | 打开文件选择器 | | **上传进度** | 显示上传状态 | | **错误提示** | 文件过大（>50MB）/ 上传失败 / 网络错误 | ### 21.2 已上传文件 | 按钮/元素 | 操作 | |-----------|------| | **文件缩略图** | 显示已上传的文件 | | **「点击插入」按钮** | 将文件 URL 插入到编辑器 | | **「收起」按钮** | 折叠文件列表 | ### 21.3 媒体操作按钮 | 按钮 | 操作 | |------|------| | **插入图片** | 插入 Markdown 图片语法 | | **嵌入 YouTube** | 插入 YouTube 视频嵌入代码 | | **嵌入 Bilibili** | 插入 Bilibili 视频嵌入代码 | | **嵌入 3D 模型** | 插入 3D 模型查看器代码 | | **浏览已有文件** | 打开已有文件浏览器 | | **插入文件** | 插入文件引用 | --- ## 二十二、404 页面 访问不存在的路径时显示。  | 元素 | 说明 | |------|------| | **404 标题** | 大号显示 | | **描述文字** | 「页面不存在，请返回首页继续浏览文档」 | | **「返回首页」按钮** | 点击返回首页 | --- ## 附录 A：快捷键 | 快捷键 | 功能 | |--------|------| | `Cmd+K` / `Ctrl+K` | 打开全局搜索 | | `Esc` | 关闭搜索弹窗/弹窗 | | `↑` `↓` | 在搜索结果中导航 | | `Enter` | 打开选中的搜索结果 | ## 附录 B：角色权限 | 功能 | 管理员 | 编辑者 | |------|--------|--------| | 查看文档 | ✅ | ✅ | | 创建/编辑文档 | ✅ | ✅ | | 删除文档 | ✅ | ❌ | | 管理分类 | ✅ | ❌ | | 管理标签 | ✅ | ❌ | | 管理反馈和留言 | ✅ | ❌ | | 管理媒体资源 | ✅ | ✅ | | 管理用户 | ✅ | ❌ | | 修改设置 | ✅ | ❌ | | GEO 仪表盘 | ✅ | ❌ | | 首页布局 | ✅ | ❌ | ## 附录 C：支持的语言 | 语言 | 代码 | 说明 | |------|------|------| | 中文 | `zh` | 默认语言 | | English | `en` | 英文 | | 日本語 | `jp` | 日文 | ## 附录 D：文件上传限制 | 项目 | 限制 | |------|------| | 最大文件大小 | 50MB | | 支持格式 | JPG, PNG, GIF, WebP, PDF, DOC, DOCX, STEP, STP | | 存储位置 | `public/media/` |