拾起时光碎片 — 一个轻量的个人博客系统
核心功能
- 📝 文章管理 — 写文章、分类、标签、置顶、软删除回收站
- 💬 评论系统 — 自建评论、嵌套回复、审核机制
- 📄 独立页面 — 关于页、友链等自定义页面
- 🔍 全文搜索 — 标题+内容搜索、关键词高亮
- 📡 RSS / Sitemap — 自动生成订阅源和站点地图
- 🔐 用户认证 — 管理员登录、密码修改
插件系统（自由选装，自动发现）
- 🔗 友链展示 — 前台友链页 + 后台管理
- 📡 RSS 订阅 — 标准 RSS 2.0 输出
- 🧩 安装即用 — 新建
app/plugins/你的插件/plugin.json即自动注册，不用改任何共享文件
主题系统（自由切换，自动发现）
- 🎨 紫橙 SaaS 主题（默认）— 毛玻璃导航 + 渐变系统
- ⬜ 极简白色主题 — 适合纯文字阅读
- 🖌️ 安装即用 — 新建
app/themes/你的主题/theme.json+layout.vue即自动出现
截图位置（部署后补充）
| 首页 | 文章页 | 后台 |
|---|---|---|
git clone https://github.com/joy-cbo/shiguang.git
cd shiguang
npm install
npm run build
npx wrangler pages deploy dist --project-name=你的项目名 --branch=main然后浏览器打开 https://你的域名/admin/setup → 创建管理员账号 → 博客上线！
⚠️ 部署后需要在 Cloudflare 后台绑定 D1（变量名shiguang-db）和 R2（变量名shiguang-files），详见 部署指南。数据库会在首次访问 /admin/setup 时自动建表。
| 层 | 技术 |
|---|---|
| 框架 | Nuxt 3 |
| 样式 | Tailwind CSS |
| 数据库 | Cloudflare D1 (SQLite) |
| 文件存储 | Cloudflare R2 |
| 部署 | Cloudflare Pages |
app/plugins/
├── registry.ts # 自动发现，不需手改
├── friend-links/ # 友链插件（自包含）
│ ├── plugin.json # 元数据（name/version/features）
│ ├── api/ # API handler 源码
│ │ ├── index.get.ts
│ │ ├── index.post.ts
│ │ └── [id].ts
│ └── pages/
│ └── links.vue # 前台页面源码
└── rss-feed/ # RSS 插件（自包含）
├── plugin.json
└── api/
└── rss.xml.ts
开发新插件只需三步：
# 1. 建文件夹 + 写 plugin.json
mkdir app/plugins/my-plugin
echo '{"name":"my-plugin","version":"1.0.0","description":"我的插件","features":["功能A"]}' > app/plugins/my-plugin/plugin.json
# 2. 写 API 和页面代码 → app/plugins/my-plugin/api/、app/plugins/my-plugin/pages/
# 3. 在 engine/api/ 和 app/pages/ 创建重导出文件（一行代码）不需要改 app/plugins/registry.ts — 系统自动扫描 plugin.json 注册。
app/themes/
├── saas/
│ ├── theme.json # 元数据（name/id/icon/features）
│ └── layout.vue # 完整布局源码
└── default/
├── theme.json
└── layout.vue # 含暗黑模式切换
开发新主题只需三步：
# 1. 复制一份
cp -r app/themes/default app/themes/my-theme
# 2. 改 theme.json（id、name、icon、features）
# 3. 改 layout.vue（导航栏、配色、布局）theme.json 中的 icon 字段对应 IconShiguang 组件的图标名。
不需要改任何后台页面 — 系统自动扫描 theme.json 展示。
欢迎提 Issue 和 PR！详见 CONTRIBUTING.md
发现漏洞请发邮件到 joy.cb@qq.com，不要提公开 Issue。详见 SECURITY.md
如果这个项目对你有帮助，可以请作者喝杯咖啡 ☕
赞赏码（放这里）