使用说明：前台阅读与后台管理全流程

这篇文章按“你要做什么”来说明焦茶纪念博客怎么用。后台按钮比较多，但逻辑其实很简单：写内容、管理内容、管理图片、调整首页、设置个人资料。

如果界面切换成其他语言，按钮位置基本不变，只是文字会变化。

一、进入后台

后台地址默认是：

リンクプレビューlocalhost:5175http://localhost:5175

打开后会进入登录页。

登录方式：

1. 在“用户名”输入 admin。
2. 在“密码”输入 123456。
3. 点击“登录”。

登录成功后会进入后台首页。上线后请第一时间修改默认密码。

二、后台顶部区域怎么用

后台顶部右侧一般有这些按钮：

1. 语言切换：切换中文、英文、日文、韩文界面。
2. 前台按钮：点击后打开前台博客。
3. 头像和名称：显示当前个人资料。
4. 退出按钮：退出后台登录状态。

左上角有折叠菜单按钮：

• 在桌面端点击，可以收起或展开左侧菜单。
• 在手机或窄屏上点击，会打开侧边抽屉菜单。

三、左侧菜单说明

左侧菜单是后台的主要入口。

菜单	用途
仪表盘	查看整体数据和概览
写文章	新建文章或短记录
内容管理 / 分类管理	新增、编辑、删除分类
内容管理 / 文章管理	搜索、筛选、置顶、编辑、删除文章
内容管理 / 草稿箱	管理保存但未发布的文章
内容管理 / 标签管理	新增、删除标签
扩展 / 主题管理	设置 Hero 大图、贴纸、个人简介样式
扩展 / API 管理	创建 API Token，供外部聚合器写文章和发快讯
系统配置	设置站点名称、页脚、账号资料、站外链接
文件管理	上传、预览、删除图片和文件

四、写文章页面

点击左侧“写文章”进入编辑页面。

页面顶部有一个切换按钮：

1. “写文章”：发布完整文章。
2. “写短记录”：发布类似动态的小内容。

文章模式顶部按钮

文章模式右上角有几个常用按钮：

1. “返回列表”：回到文章管理页。
2. “保存草稿”：把当前内容保存为草稿，不会出现在前台正式列表。
3. “预览”：打开预览窗口，检查 Markdown 渲染效果。
4. “发布”：打开发布抽屉，设置简介、封面、分类、标签、时间和状态。

编辑工具栏

编辑区上方有一排工具按钮：

1. B 图标：给选中文字加粗。
2. I 图标：给选中文字设置斜体。
3. 删除线图标：给选中文字加删除线。
4. 样式下拉：可插入正文、标题、小标题。
5. 无序列表：插入 - 开头的列表。
6. 有序列表：插入 1. 开头的列表。
7. 链接按钮：插入 Markdown 链接格式。
8. 表情按钮：插入表情。
9. 插入菜单：展开更多插入项。
10. 信息按钮：提示当前编辑器支持 Markdown。
11. 字数统计：显示当前正文大约多少字。

插入菜单

点击“插入”会看到更多选项：

1. 媒体：上传图片并插入到文章正文。
2. GIF：输入 GIF 地址并插入。
3. 帖子：插入站内内容卡片。
4. 文章：插入某篇文章链接或引用。
5. 快讯：插入短记录内容。
6. 分割线：插入一条 Markdown 分割线。
7. 代码：插入代码块。
8. LaTeX：插入公式块。
9. 表格：插入基础 Markdown 表格。

封面区域

编辑器上方的大图区域是文章封面。

1. 没有封面时，点击封面区域可以上传图片。
2. 上传封面建议使用 3:2 比例。
3. 上传后会显示缩略预览。
4. “预览封面”可以查看封面图。
5. “移除封面”会把当前文章封面清空。
6. 发布抽屉里的“封面 URL”也可以手动填写 /uploads/... 地址。

标题和正文

1. “添加标题”位置输入文章标题。
2. 正文区域输入 Markdown 内容。
3. 可以直接粘贴 Markdown。
4. 也可以用工具栏辅助插入格式。

发布抽屉

点击“发布”后，右侧会打开发布抽屉。

里面有这些字段：

1. 简介：文章摘要。可以手动写，不写时系统会取正文前面的内容。
2. 封面 URL：当前封面地址，也可以手动改。
3. 分类：选择一个或多个分类。
4. 标签：选择一个或多个标签。
5. 发布时间：设置文章显示时间。
6. 状态：选择正常、不在首页、隐藏。
7. 取消：关闭抽屉，不发布。
8. 确认发布：正式发布文章。

状态说明：

状态	作用
正常	文章正常展示
不在首页	文章可访问，但不出现在首页列表
隐藏	前台不公开展示

五、写短记录

在写文章页面顶部切换到“写短记录”。

短记录适合：

1. 临时想法。
2. 图片补充。
3. 小公告。
4. 不需要完整标题的内容。

短记录窗口里可以操作：

1. 输入正文。
2. 图片按钮：上传并插入图片。
3. GIF 按钮：插入 GIF。
4. 表情按钮：插入表情。
5. 分类下拉：选择分类。
6. 标签下拉：选择标签。
7. 发布按钮：发布短记录。

六、文章管理

点击“内容管理 / 文章管理”。

顶部右侧有两个按钮：

1. 批量导入：导入 Markdown 或 JSON 文件。
2. 新建文章：进入写文章页面。

筛选区从左到右一般是：

1. 全部 / 已发布 / 草稿：快速切换文章范围。
2. 排序下拉：选择排序方式。
3. 关键词搜索框：输入标题或正文关键词。
4. 类型下拉：筛选文章或短记录。
5. 状态下拉：筛选正常、不在首页、隐藏。
6. 搜索按钮：按当前条件查询。
7. 重置按钮：清空筛选条件。

排序方式说明：

排序	适合场景
最新发布	找最近写的内容
总浏览量最高	找长期最受欢迎的内容
一周内浏览最高	找最近热度最高的内容
热度排序	综合近期和总浏览量
置顶优先	先看已经置顶的文章

文章表格里常用操作：

1. 勾选框：选择多篇文章。
2. 置顶图标：点击插针，插上表示置顶；再次点击取消置顶。
3. 标题：显示文章标题。
4. 类型：区分文章和短记录。
5. 状态：显示正常、不在首页、隐藏。
6. 分类：显示文章所属分类。
7. 浏览量：显示总浏览量。
8. 周浏览量：显示最近一周浏览量。
9. 创建时间：显示发布时间。
10. 编辑：进入编辑页面。
11. 删除：删除文章。删除前会弹出确认。

置顶后的文章会进入前台首页顶部滚动横幅。横幅最多展示 5 篇，按照置顶时间排序。

七、批量导入

在文章管理页点击“批量导入”。

可以上传：

1. Markdown 文件。
2. JSON 文件。

上传后会出现预览列表，确认没问题再执行导入。适合一次性导入整理好的纪念资料。

八、草稿箱

点击“内容管理 / 草稿箱”。

这里显示保存为草稿的文章。

常用操作：

1. 编辑：继续写这篇草稿。
2. 删除：删除不需要的草稿。
3. 写文章：新建一篇文章。

建议写长文章时经常保存草稿，避免浏览器刷新或误关页面导致内容丢失。

九、分类管理

点击“内容管理 / 分类管理”。

这里可以新增和编辑分类。

常用字段：

1. 名称：分类显示名称，例如“教程”。
2. 图标：可以填一个符号或 emoji。
3. 标识：可以填英文标识，例如 tech。

按钮说明：

1. 新建分类：打开分类表单。
2. 保存：保存新增或编辑结果。
3. 编辑：修改已有分类。
4. 删除：删除分类。

分类会影响前台分类页，也会出现在文章详情和文章卡片中。

十、标签管理

点击“内容管理 / 标签管理”。

操作很简单：

1. 在输入框里输入标签名。
2. 点击新增按钮。
3. 表格里会显示已有标签。
4. 删除按钮可以删除标签。

标签适合描述主题，比如“焦茶”“部署”“教程”“资料整理”。

十一、主题管理和 Hero 大图

点击“扩展 / 主题管理”。

这里主要控制首页 Hero 区域。

常用区域：

1. Hero 图片区：设置桌面端大图和移动端大图。
2. 全息层开关：控制是否显示全息光效。
3. 小组件开关：控制 Hero 上附加组件是否显示。
4. 贴纸区：添加贴纸或便签。
5. 个人简介区：设置 Hero 中间的头像、标题、简介、主题词和玻璃效果。
6. 实时预览：右侧或下方可以看到当前配置的大致效果。
7. 保存按钮：保存当前主题配置。

贴纸和标签建议不要放得太密，位置可以分散一些，避免挡住人物或重要画面。

玻璃效果一般有：

1. 亚克力：适合清晰、干净的半透明面板。
2. 液态玻璃：适合更有流动感的视觉。
3. 毛玻璃：适合柔和、朦胧的背景。

十二、系统配置

点击“系统配置”。这里分为站点配置和账号资料。

站点配置

常用字段：

1. 站点名称：浏览器标题和站点显示名。
2. 站点 Logo：浏览器图标和后台品牌图标。
3. 副标题：站点说明。
4. 页脚：前台底部内容。内容较长时可以分段或分栏写。
5. 保存按钮：保存站点配置。

账号资料

常用字段：

1. 名称：显示在个人简介和后台头像旁边。
2. 头像：用于后台左上角、个人简介页和 Hero 个人信息。
3. 邮箱：选填，填写后个人简介页可以显示邮件链接。
4. 简介：个人介绍文字。
5. 站外链接：添加外部平台入口。
6. 保存按钮：保存账号资料。

添加站外链接时：

1. 点击“添加链接”。
2. 在平台下拉框选择平台。
3. 输入显示名称。
4. 输入 URL。
5. 保存。

如果平台列表里没有想要的平台，可以选择自定义。

十三、文件管理

点击“文件管理”。

左侧是文件夹列表，右侧是当前文件夹里的文件。

常用按钮：

1. 新建文件夹：创建新的文件目录。
2. 上传：上传图片或文件。
3. 表格 / 网格切换：切换文件显示方式。
4. 刷新：重新加载当前文件夹。
5. 删除：删除未被使用的文件。

文件管理有引用保护：

1. 如果某张图片被文章、封面、头像或配置使用，引用数会显示出来。
2. 正在被使用的文件不能直接删除。
3. 如果要删除，先去文章或配置里移除引用，再回来删除。

图片上传时可能会出现裁剪框。头像一般建议裁成正方形，封面建议使用 3:2。

十四、API 管理

点击“扩展 / API 管理”。

这里可以创建 API Token，给外部聚合器、脚本或自动化工具使用。

常用操作：

1. 新建 Token：输入名称，选择权限后创建。
2. 复制 Token：复制前需要再次输入后台账号密码确认。
3. 删除 Token：删除不再使用的 token。

权限说明：

1. 写文章和发快讯：外部工具可以调用两个发布接口。
2. 仅写文章：只能调用文章发布接口。
3. 仅发快讯：只能调用快讯发布接口。

接口地址：

1. POST /api/external/article：发布文章。
2. POST /api/external/quick：发布快讯。

请求头使用 Authorization: Bearer <token> 或 X-API-Token: <token>。不要把 Token 公开到仓库里。

十五、前台怎么使用

前台地址默认是：

リンクプレビューlocalhost:9002http://localhost:9002

前台主要区域：

1. Hero 首屏：展示大图、头像、简介、站外平台和贴纸。
2. 顶部导航：进入首页、归档、分类、标签、关于页面。
3. 置顶横幅：展示后台置顶的文章，最多 5 篇。
4. 文章列表：浏览正式文章。
5. 短记录入口：查看轻量动态。
6. 媒体内容：从文章或短记录中提取图片展示。
7. 文章详情页：阅读正文、目录、分类、标签、评论和推荐文章。
8. 个人简介页：查看名称、头像、简介、邮箱和站外链接。

Hero 首屏有滚动阈值：轻微滚动不会立刻离开首屏，明显下滑才会进入文章区域。这样可以避免误触，也让首页大图保留完整的观看时间。

十六、推荐使用流程

如果你是第一次使用，建议按这个顺序：

1. 登录后台。
2. 进入系统配置，先设置站点名称、头像、简介和页脚。
3. 进入文件管理，上传默认封面、头像和 Hero 大图。
4. 进入主题管理，设置首页 Hero 和个人简介样式。
5. 进入分类管理，创建基础分类。
6. 进入标签管理，创建常用标签。
7. 进入写文章，发布第一篇正式文章。
8. 到文章管理里给重要文章点置顶。
9. 回前台检查首页、文章页、个人简介页是否显示正常。

这套后台的核心思路是：先把站点外观和个人资料设好，再持续写内容。内容多起来以后，再靠分类、标签、筛选和置顶来管理重点。