Admin Console 快速指南

发布于:2026-04-24 #Admin Console#指南 共 1,111 字 约 4 分钟

Admin Console /admin/是本地后台入口,于在 fork、clone 或自托管后接手站点配置与内容维护。

它不是独立 CMS,保存操作会写回仓库里的配置或内容文件,因此适合和 Git 一起使用:改动前后可以看 diff,需要回退时也按普通项目文件处理。

本地工具

Admin Console 仅在开发环境提供写入能力。
生产环境最多保留只读的站点概览页面;/api/admin/* 只服务本地后台,不作为公开 API。

快速入口

本地启动项目:

Bash
UTF-8|2 Lines|
npm install
npm run dev

开发服务器默认运行在 http://localhost:4321/ ,如修改过端口,请将 4321 换成你的实际端口。

入口页面主要用途
/admin/Site Overview查看站点概况、内容结构、近期文章等
/admin/theme/Theme Console编辑站点信息、侧栏、首页、内页文案
/admin/content/Content Console🚧文章管理与可视化写作(开发中)
/admin/images/Images Console浏览图片资源,复制路径可用路径
/admin/checks/Checks Console查看结构化诊断,做发布前检查
/admin/data/Data Console导入与导出主题设置,便于迁移和备份

主要页面

📈Site Overview

Site Overview 是后台首页,用于查看站点内容数量、近期更新、后台入口等(入口仅开发环境可见)。

本页面可选对访客开放,受 Theme Console 页面内的 Admin Overview 开关控制。

🛠️ Theme Console

Theme Console 用于管理主题级配置,用于在 fork 或 clone 后快速调整站点基础设置。

具体内容详见 Theme Console 配置指南

📝Content Console

Content Console 是内容管理与可视化写作入口,用于集中查看和维护站点的写作内容。

当前仍在开发中,暂未开放。

🖼️ Images Console

Images Console 用于浏览图片资源、核对图片信息,并复制可用于配置或内容字段的路径。

目前定位接近资源浏览器,暂不支持压缩、删除或替换文件。 需要换图时,先把图片放到项目约定目录,再回到对应页面选择或填写路径。

📝Checks Console

Checks Console 用于发布前检查。它会把内容、配置、图片引用和约定风险整理成可读的诊断结果。

这个页面不直接修改文件。发现问题后,再回到 Theme、Content 或源码里处理。

📤Data Console

Data Console 用于导入或导出主题设置。导出适合做迁移或备份;导入会先走预检,再确认写入。

它处理的是 Theme Console 管理的主题配置数据,不处理文章内容。


以上内容覆盖了 Admin Console 当前主要入口与功能。如果更多想法与建议,欢迎提交 Issue。