目录结构说明

顶层结构

blogkit/
├── index.php            # 前台统一入口（路由分发）
├── admin.php            # 后台统一入口
├── api.php              # API 入口
├── install.php          # 安装向导（安装完成后建议删除）
├── .htaccess            # Apache 伪静态规则
├── nginx.htaccess       # Nginx 伪静态参考规则
├── core/                # 框架核心（不要随意修改）
├── app/                 # 业务控制器与模型
├── admin/               # 后台页面与资源
├── themes/              # 主题目录（每主题一个子目录）
├── plugins/             # 插件目录（每插件一个子目录）
├── uploads/             # 用户上传的媒体文件（用户数据）
└── storage/             # 缓存、日志、编译模板（运行时文件）

core/ — 框架核心

• core/lib/：框架类库，主要包括：
• core/template/：自研模板引擎，由 9 个类组成：Template（总控）、TemplateParser（标签解析）、TemplateCompiler（编译）、TemplateCondition（条件）、TemplateFilter（过滤器）、TemplateUrl（URL 生成）、TemplateOutput（输出与转义）、TemplateInheritance（模板继承）、TemplateExtension（扩展点）。
• core/config/：database.php（数据库配置，安装时生成）、system.php、version.php（版本号唯一真相来源）。

app/ — 业务层

• app/Controllers/：前台控制器（Home、Auth、User、Profile、RSS 等）与后台控制器（Admin/ 下的文章、页面、评论、用户、主题、插件、设置等）；
• app/Models/：数据模型，封装各业务表的查询与写入。

admin/ — 后台

• admin/templates/：后台页面模板与组件（侧边栏 components/sidebar.html、设置导航 components/config_nav.html 等）；
• admin/assets/：后台样式与脚本。

themes/ 与 plugins/

每个主题包含 templates/（模板文件）、assets/（静态资源）、theme.json（声明与配置项）、screenshot.png（预览图）。每个插件包含 plugin.json（元数据）、plugin.php（入口类），详见主题/插件开发指南。

storage/ 与 uploads/

storage/ 内全部为可再生成的运行时文件（缓存、日志、编译产物），可随时清空；uploads/ 是用户上传内容，备份时必须保留。