Admin Console 快速指南

#Admin Console#指南 共 1,105 字 约 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 是内容管理与可视化写作入口,可以集中查看和维护站点的写作内容。

具体内容详见 Content Console 使用指南

🖼️ Images Console

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

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

✅ Checks Console

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

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

📤 Data Console

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

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


这些就是目前 Admin Console 的主要入口和功能。如果你有更多想法或建议,欢迎提交 Issue。