使用指南

PrimeEdge Admin 各功能模块的使用方法

使用指南

登录后台后，左侧菜单栏可以访问所有功能模块。

仪表盘

仪表盘是登录后的默认页面，展示：

内容统计 - 文章、笔记、好物、投资笔记等各模块的数量
最近提交 - 博客仓库最近的 Git 提交记录
版本检测 - 对比当前版本与线上版本，提示是否需要更新

文章管理

文章列表

按发布时间倒序排列
支持搜索过滤（按标题搜索）
支持分类筛选
分页显示

创建/编辑文章

点击"新建文章"进入编辑器页面：

标题 - 填写文章标题（必填）
发布时间 - 选择发布日期和时间
分类 - 选择或创建分类
标签 - 添加标签，多个标签用回车分隔
摘要 - 可选，填写文章摘要
封面图 - 可选，输入图片 URL
正文 - Markdown 编辑器编写正文内容

编辑完毕后点击"发布"或"更新"按钮保存。

笔记管理

笔记列表

按时间倒序排列的表格展示
显示标题、日期、分类
支持分类筛选和搜索

创建/编辑笔记

笔记编辑器比文章更简洁：

标题 - 笔记标题（必填）
发布时间 - 发布日期时间
分类 - 选择分类
目录开关 - 是否在博客端显示目录
正文 - Markdown 内容

投资笔记

投资笔记分为两种类型：

盘前计划

用于记录每日开盘前的投资思路：

关注列表 - 今日关注的标的（代码、名称、理由）
持仓计划 - 现有持仓的操作预案
正文 - 其他盘前分析内容

盘后复盘

用于记录当日交易情况：

当日收益率 - 填写百分比（正数为盈利，负数为亏损）
交易记录 - 买入/卖出记录
重要新闻/消息 - 影响市场的消息
经验总结 - 今日反思
正文 - 详细复盘内容

列表中收益率显示规则：盈利为红色，亏损为绿色，持平为黑色（符合中国股市习惯）。

好物推荐

好物列表

表格形式展示，显示名称、日期、分类
支持分类筛选
支持全量扫描功能

创建/编辑好物

名称 - 产品名称（必填）
发布时间 - 发布日期时间
分类 - 选择分类
图片 URL - 产品图片地址
描述 - 简短描述
精选好物 - 勾选后在博客首页优先展示
正文 - 详细的使用体验和评测内容

文档管理

文档模块支持多层级的文档结构管理：

左侧树形导航 - 展示文档层级结构
右侧编辑器 - 编辑选中文档的内容
拖拽排序 - 支持拖拽调整文档顺序
新建/删除 - 支持在任意层级新建或删除文档

相册管理

相册管理维护博客仓库中的 content/photos/_index.md，图片数据写在页面 Front Matter 的 photos 数组中。

支持创建、编辑、删除相册
每个相册可以配置标题、描述、封面和多张图片
图片 URL 可配合「图片管理」上传后复制使用
保存后会提交到博客仓库

友链管理

管理博客友情链接：

添加友链（名称、URL、描述、头像）
编辑已有友链信息
删除友链
调整友链排序

书签管理

管理分类书签网址：

按分组管理书签
添加/编辑/删除书签
书签包含：名称、URL、描述、图标

分类管理

统一管理所有内容类型的分类：

按模块分区展示（文章分类、笔记分类、好物分类）
支持新建分类
重命名分类 - 重命名后会自动同步更新所有关联文章的分类字段
删除分类

单页管理

单页管理用于维护不属于列表型内容的固定页面：

页面	仓库文件
关于页	`content/about.md`
服务页	`content/services.md`
留言板	`content/comments.md`

这些页面都支持 Markdown 编辑，保存后直接写回博客仓库。

图片管理

基于 GitHub API 的图床管理，支持将图片直接托管在 GitHub 仓库中。

上传图片

支持三种上传方式：

拖拽上传 - 将图片拖拽到上传区域
粘贴上传 - 直接 Ctrl/Cmd+V 粘贴剪贴板中的图片
点击选择 - 点击上传区域选择本地文件

支持批量上传，支持 JPG / PNG / GIF / WebP / SVG 格式。

目录管理

支持创建多级目录
面包屑导航在目录间跳转
编辑器中上传的图片自动按 年/月 分目录存储（如 2026/05/image.png）

图片操作

复制链接 - 一键复制图片 URL
链接格式 - 支持 URL / Markdown / HTML / BBCode 四种格式
批量选择 - 勾选多张图片后可批量复制链接或删除
删除 - 单张或批量删除

图床配置

在"系统"菜单下的"图床配置"中设置：

仓库设置

配置项	说明
图床仓库	格式为 `owner/repo`，可与博客仓库相同或使用独立仓库
分支	仓库分支名，默认 `main`
存储目录	图片存放的根目录路径，留空表示仓库根目录
GitHub Token	需要 repo 权限，留空则复用系统设置中的 Token

命名规则

规则	说明
哈希化	自动生成唯一哈希文件名（默认）
保留原名	使用原始文件名
时间戳	以时间戳命名
前缀 + 原名	添加自定义前缀

图片压缩

上传前可选自动压缩（支持 JPG / PNG / WebP）
可调节压缩质量（0.1 ~ 1.0）

水印

可选添加文字水印
支持 5 个位置：左上、右上、中心、左下、右下
可调节水印透明度

链接规则

规则	URL 格式
GitHub Raw	`https://raw.githubusercontent.com/{owner}/{repo}/{branch}/{path}`
GitHub Pages	`https://{owner}.github.io/{repo}/{path}`
jsDelivr CDN	`https://cdn.jsdelivr.net/gh/{owner}/{repo}@{branch}/{path}`
Statically CDN	`https://cdn.statically.io/gh/{owner}/{repo}/{branch}/{path}`
自定义	使用 `{owner}`, `{repo}`, `{branch}`, `{path}` 变量

测试连接

点击"测试连接"按钮可验证仓库配置是否正确：

验证 Token 是否有效
验证仓库是否可访问
检测存储目录是否存在

评论系统

后台左侧「评论系统」包含两个模块：

模块	功能	依赖
评论管理	审核、搜索、回复、编辑、置顶、删除 Waline 评论	Admin 项目绑定 `WALINE_KV`
评论设置	配置 Waline 站点信息、邮件通知、PushPlus、评论策略、图片上传和极验	Admin 项目绑定 `WALINE_KV`

如果没有给 PrimeEdge Admin 项目绑定 WALINE_KV，这两个模块会提示评论 KV 不可用，但不影响博客内容管理。

评论管理是直接读写 Waline On EdgeOne 的 KV 数据，不是通过评论服务域名调用 API。请确认 Admin 项目绑定的是 Waline 项目正在使用的同一个 KV 命名空间。

详见评论管理。

配置编辑

在线编辑 Hugo 博客的 config.toml 配置文件：

表单模式 - 可视化编辑站点信息、首页风格、横幅、评论系统等
原始编辑模式 - 直接编辑 TOML 源码
保存后自动提交到 Git 仓库（Gitee 或 GitHub）

页头配置

在表单模式"页头配置"区域可设置导航栏品牌标识：

导航栏文字 - 导航栏左侧显示的文字（留空则显示站点标题）
导航栏 Logo 图片 - 填写图片路径后导航栏优先显示 Logo 图片

显示优先级：Logo 图片 > 导航栏文字 > 站点标题

拖拽排序

配置页面中以下模块支持通过拖拽 ⠿ 图标调整顺序：

导航菜单 - 拖拽调整菜单项的显示顺序
社交链接 - 拖拽调整页脚社交图标顺序
热门文章推荐 - 拖拽调整侧边栏推荐文章的排列顺序

首页风格切换

在配置管理的"首页风格"区域，通过下拉菜单选择首页风格：

个人生活风格 - 横幅 + 文章卡片 + 侧边栏（默认）
简洁笔记风格 - 年份筛选 + 两栏文章列表
技术博客风格 - 精选文章置顶 + 文章列表 + 侧边栏
卡片风格 - 多模块卡片展示（文章、笔记、好物、投资、文档）
多栏风格 - 文章卡片网格 + 侧边栏，门户型布局

选择"个人生活风格"后，会展开横幅相关选项面板（Banner 显示名称、背景图等）。

投资提示文字

在"首页风格"区域底部可以自定义投资页面顶部的提示文字（如发布时间说明）。

系统设置

平台选择

系统支持两种 Git 托管平台：

平台	说明
Gitee	国内访问速度快，默认分支 `master`
GitHub	国际通用平台，默认分支 `main`

在系统设置页面顶部的"托管平台"下拉菜单中选择对应平台，系统会自动适配对应的 API。

仓库配置

配置项	说明
托管平台	选择 Gitee 或 GitHub
Access Token	平台的个人访问令牌
仓库所有者	用户名或组织名
仓库名称	Hugo 博客仓库名
分支名称	仓库默认分支（Gitee 默认 master，GitHub 默认 main）

功能操作

连接测试 - 一键测试 API 连通性（自动适配所选平台）
清除缓存 - 清除 KV 中的列表缓存数据
全量扫描 - 重新扫描仓库文件，重建缓存

缓存管理

后台使用 KV 缓存来提升性能：

列表数据首次加载时全量扫描并存入 KV
后续增删改操作自动增量更新缓存
如果数据异常，可在系统设置中手动清除缓存或重新扫描

下一步

编辑器使用 - 详细了解 Markdown 编辑器
版本更新 - 如何更新后台系统