Admin Console 快速指南
Admin Console /admin/是本地后台入口,于在 fork、clone 或自托管后接手站点配置与内容维护。
它不是独立 CMS,保存操作会写回仓库里的配置或内容文件,因此适合和 Git 一起使用:改动前后可以看 diff,需要回退时也按普通项目文件处理。
本地工具
Admin Console 仅在开发环境提供写入能力。
生产环境最多保留只读的站点概览页面;/api/admin/* 只服务本地后台,不作为公开 API。
快速入口
本地启动项目:
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。