光隙操作文档

设计

光隙博客 — 网站操作指南

目录

1. 浏览首页

打开网站 https://你的域名。

首页展示三部分内容：

  • 左侧个人卡片 — 头像、昵称、签名、职业/城市/设备/兴趣、GitHub 和邮箱图标、"联系我"按钮
  • 右侧 Hero 区域 — 欢迎语、大标题、"了解更多"按钮
  • 底部三张模块卡片 — 学习记录 / 摄影作品 / 日常感悟

点击任一卡片或"了解更多"按钮即可进入对应模块。

2. 阅读学习记录

无需登录，公开访问

  1. 打开 https://你的域名/notes
  2. 顶部有搜索框，输入关键词后点击"搜索"，支持搜索标题、摘要和正文
  3. 搜索框下方是分类标签，点击可筛选不同分类的文章
  4. 文章列表按发布时间倒序排列，置顶文章会排在最前面，带有"置顶"徽标
  5. 点击文章标题进入详情页
  6. 详情页支持：
    • Markdown 渲染（标题、列表、表格、代码块等）
    • 代码语法高亮（GitHub Dark 主题）
    • 长文自动生成目录（在文章开头自动插入）

3. 浏览摄影作品

无需登录，公开访问

  1. 打开 https://你的域名/photos
  2. 看到相册封面网格，每个相册显示封面缩略图、标题和照片数量
  3. 点击相册进入相册详情页
  4. 照片以瀑布流方式排列（手机双列、平板三列、桌面四列）
  5. 点击任意照片进入大图灯箱模式，显示：
    • 大图浏览
    • 照片标题、说明、拍摄设备、地点、拍摄日期、标签
  6. 灯箱模式下可左右切换浏览所有照片

4. 注册朋友账号

需要管理员提供的有效邀请码

  1. 打开 https://你的域名/register
  2. 填写四个字段：
    • 邀请码：管理员在后台生成的 8 位大写邀请码（如 A1B2C3D4）
    • 账号：自定义登录账号，至少 2 个字符
    • 昵称：显示名称
    • 密码：至少 6 位
  3. 点击"注册"
  4. 注册成功后自动跳转到登录页面

注意：邀请码有效期 7 天，只能使用一次。过期或已被使用的邀请码会提示错误。

5. 登录

  1. 打开 https://你的域名/login
  2. 输入账号和密码
  3. 点击"登录"
  4. 登录成功后自动跳转到日常感悟页面

登录后你可以：

  • 访问日常感悟
  • 在文章详情页发表私密留言
  • 查看管理员回复

6. 阅读日常感悟

需要登录后才能访问

  1. 登录后，打开 https://你的域名/thoughts
  2. 顶部有搜索框（仅搜索日常感悟，不包含学习记录）
  3. 文章列表按发布时间倒序排列
  4. 点击文章标题进入详情页
  5. 详情页显示 Markdown 正文
  6. 文章底部是私密留言区

7. 发表私密留言

需要登录，仅限于日常感悟文章下

  1. 打开任意日常感悟文章详情页（/thoughts/文章名）
  2. 滚动到页面底部，找到留言区
  3. 在文本框中输入留言内容
  4. 点击"发送留言"
  5. 你的留言会显示在左侧有紫色边框的消息气泡中
  6. 管理员回复会显示在右侧有蓝色"管理员"标识的气泡中

注意：

  • 每条留言只有你本人和管理员能看到
  • 其他朋友看不到你的留言
  • 你在每篇文章下有一条独立的对话线程

8. 登录后台

仅管理员

  1. 打开 https://你的域名/admin
  2. 如果未登录，会自动跳转到登录页
  3. 输入管理员账号密码后登录
  4. 登录成功后进入后台仪表盘

后台左侧是导航侧栏，包含 8 个模块。手机端点击左上角按钮打开侧栏。

9. 仪表盘

仪表盘是后台首页，展示站点概览：

区域内容
指标卡片已发布文章 / 日常感悟 / 照片数量 / 受邀朋友 / 本地存储 / OSS 状态
最近文章最近 5 篇发布文章
最近留言最近 5 条留言 + 待回复数量
最近阅读最近 5 条阅读记录
最近照片最近上传的缩略图

10. 发布文章

  1. 后台侧栏点击**"内容管理"**

  2. 点击右上角**"新建文章"**按钮

  3. 弹出编辑窗口，填写：

    字段说明
    类型学习记录（公开） 或 日常感悟（私密）
    状态草稿（不发布） 或 发布（立即公开）
    标题文章标题
    摘要简短描述（可选，显示在列表页）
    分类选择分类（下拉列表，仅学习记录有效）
    正文Markdown 格式撰写内容

  4. 点击**"保存"**

Markdown 写作提示：

## 二级标题

普通段落文字。

- 列表项 1
- 列表项 2

```代码块```

**粗体** *斜体* [链接](url)

> 引用文字

11. 管理文章

在内容管理页面：

  • 筛选：点击"全部"/"已发布"/"草稿"/"已删除"切换视图
  • 编辑：点击文章右侧"编辑"按钮，修改后保存
  • 删除：点击"删除"按钮，确认后文章状态变为"已删除"（软删除，数据保留）
  • 状态切换：编辑时将状态从"草稿"改为"发布"即可发布；改为"草稿"可取消发布

12. 创建相册并上传照片

  1. 后台侧栏点击**"摄影管理"**
  2. 点击右上角**"新建相册"**
  3. 输入相册标题（必填）和描述（可选），点击"创建"
  4. 点击刚创建的相册卡片
  5. 相册详情区出现，点击**"批量上传"**
  6. 在弹出的文件选择器中选择多张照片（支持 .jpg .jpeg .png .webp .heic .heif）

上传过程：

  • 系统自动保存原图到 storage/originals/
  • 自动生成展示图（WebP 格式，最大 1920px）
  • 自动生成缩略图（WebP 格式，480px 裁剪）
  • 上传完成后照片列表自动刷新

13. 管理照片元信息

  1. 在摄影管理页面，点击相册进入详情
  2. 每张照片下方有输入框，可以编辑：
    • 标题
    • 设备（如 iPhone 15 Pro）
    • 地点（如 陕西 西安）
  3. 修改后自动保存
  4. 点击"删除"可删除照片

14. 生成邀请码

  1. 后台侧栏点击**"邀请码"**
  2. 在"备注（可选）"中输入用途说明
  3. 点击**"生成"**
  4. 新邀请码出现在列表中，显示为 8 位大写字符串（如 A1B2C3D4）

邀请码规则：

  • 有效期 7 天
  • 单次使用
  • 可手动作废

作废邀请码：

  • 点击"未使用"状态邀请码右侧的"作废"按钮
  • 状态变为"已作废"，无法再使用

15. 管理朋友账号

  1. 后台侧栏点击**"朋友管理"**
  2. 查看所有受邀朋友列表，包含：
    • 昵称、账号、状态标签
    • 注册时间、最后登录时间
    • 阅读次数、留言数量
  3. 禁用账号：点击"禁用"按钮，朋友将无法登录和访问日常感悟
  4. 启用账号：点击"启用"按钮，恢复朋友访问权限

16. 回复私密留言

  1. 后台侧栏点击**"私密留言"**
  2. 每条留言线程显示：
    • 留言者昵称和账号
    • 所属文章标题（可点击跳转）
    • 对话消息列表（蓝色标识为管理员发送）
  3. 在底部的输入框中输入回复内容
  4. 点击**"回复"**按钮
  5. 回复消息会立即显示在对话中，朋友下一次查看文章时可以看到

17. 查看阅读记录

  1. 后台侧栏点击**"阅读记录"**
  2. 列表显示：
    • 哪个人阅读了哪篇文章
    • 精确到秒的阅读时间
  3. 按时间倒序排列，最近 200 条

技术说明：阅读记录在朋友打开文章页面时自动记录。相同文章 30 分钟内只记录一次，避免频繁刷新产生大量记录。

18. 配置站点信息

  1. 后台侧栏点击**"站点设置"**
  2. 可配置以下字段：
字段显示位置
站主昵称首页左侧卡片
职业/身份首页卡片详情行
一句话签名首页卡片 & Hero 区域
所在城市首页卡片详情行
邮箱首页卡片"联系我"按钮 + 图标
GitHub 链接首页卡片 GitHub 图标
常用摄影设备首页卡片详情行
兴趣标签首页卡片详情行（逗号分隔）
头像 URL首页卡片头像
  1. 修改后点击**"保存设置"**
  2. 刷新首页即可看到效果

附录：常见问题

Q: 为什么我上传的照片在前台看不到？ A: 确保已经在后台摄影管理中创建了相册，并将照片上传到该相册。

Q: 邀请码过期了怎么办？ A: 过期的邀请码无法恢复。需要在后台重新生成一个新的邀请码。

Q: 朋友忘记了密码怎么办？ A: 目前第一版不支持自助找回密码。联系管理员在后台禁用旧账号后，用新邀请码重新注册。

Q: 如何修改管理员密码？ A: 目前需要通过 SQLite 数据库直接修改（后续版本会加入后台密码修改功能）。