84 lines
3.3 KiB
Markdown
84 lines
3.3 KiB
Markdown
|
# 写作后台
|
|||
|
|
|
|||
|
|
Hugo 博客的本地管理后台，Next.js 16 + Tailwind CSS 4，运行在 `localhost:8016`。
|
|||
|
|
|
|||
|
|
## 核心模块
|
|||
|
|
|
|||
|
|
### 1. 文章管理 `/`
|
|||
|
|
- 读取 Hugo `content/post/` 下的 Markdown 文件，列表展示、搜索、分页
|
|||
|
|
- 点击标题进入编辑，hover 显示预览、编辑、删除按钮
|
|||
|
|
- 预览自动启动 `hugo serve`（kill 端口冲突后重启）
|
|||
|
|
|
|||
|
|
### 2. 撰写/编辑 `/edit`
|
|||
|
|
- 新建文章自动生成 `YYYYMMDDHHmm` 格式 slug，文件夹命名 `YYYY-MM-DD-slug`
|
|||
|
|
- 文章元信息编辑（标题、日期、分类、标签、作者、AI 评论）
|
|||
|
|
- Markdown 正文编辑，支持插入图片（上传到文章同级文件夹）
|
|||
|
|
- 三个发布状态：
|
|||
|
|
- **草稿** — `draft: true`，前台不可见
|
|||
|
|
- **保存** — `draft: false`，存本地不推送
|
|||
|
|
- **发布** — 保存 + `git add -A && git commit && git push`
|
|||
|
|
|
|||
|
|
### 3. 评论管理 `/comments`
|
|||
|
|
- Artalk 管理员登录（邮箱+密码），token 缓存 localStorage
|
|||
|
|
- 文章列表按 MD 文件日期倒序，默认选中最新文章，按需加载评论
|
|||
|
|
- 支持在线回复、隐藏/显示、删除评论
|
|||
|
|
- 回复评论时显示父级评论引用
|
|||
|
|
|
|||
|
|
### 4. 订阅源管理 `/feeds`
|
|||
|
|
- 对接 `rssapi.usj.cc`，token 存储在 `.env` 服务端
|
|||
|
|
- 增删 RSS 订阅源，批量检测存活状态
|
|||
|
|
|
|||
|
|
### 5. 友链管理 `/links`
|
|||
|
|
- 对接 `rssapi.usj.cc`，token 存储在 `.env` 服务端
|
|||
|
|
- 增删改友链，支持隐藏/显示切换
|
|||
|
|
- 单个/批量存活检测，失联标记
|
|||
|
|
|
|||
|
|
### 6. 回收站 `/recycle`
|
|||
|
|
- 软删除文章移至 `.recycle/`，保留 30 天
|
|||
|
|
- 支持恢复和永久删除
|
|||
|
|
|
|||
|
|
## API 路由
|
|||
|
|
|
|||
|
|
| 路径 | 方法 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| `/api/posts` | GET/POST | 文章列表、新建 |
|
|||
|
|
| `/api/posts/[slug]` | GET/PUT/DELETE | 单篇文章 CRUD |
|
|||
|
|
| `/api/comments` | GET/POST | 评论列表、回复 |
|
|||
|
|
| `/api/comments/[id]` | PUT/DELETE | 评论操作 |
|
|||
|
|
| `/api/comments/login` | POST | Artalk 登录 |
|
|||
|
|
| `/api/rss/feeds` | GET/POST/DELETE | 订阅源管理 |
|
|||
|
|
| `/api/rss/links` | GET/POST/PUT/DELETE | 友链管理 |
|
|||
|
|
| `/api/recycle` | GET/POST/DELETE | 回收站 |
|
|||
|
|
| `/api/upload` | POST | 图片上传 |
|
|||
|
|
| `/api/deploy` | POST | Git 部署 |
|
|||
|
|
| `/api/hugo` | GET | Hugo 启动/检测 |
|
|||
|
|
|
|||
|
|
## 技术栈
|
|||
|
|
|
|||
|
|
- **框架**: Next.js 16 (App Router, Turbopack)
|
|||
|
|
- **样式**: Tailwind CSS 4，SEN 主题暖色系
|
|||
|
|
- **数据**: 直接读写 Hugo Markdown 文件（gray-matter），无数据库
|
|||
|
|
- **评论**: Artalk API v2
|
|||
|
|
- **RSS/友链**: 自建 API `rssapi.usj.cc` + SCF 代理
|
|||
|
|
- **部署**: 执行 shell git push
|
|||
|
|
|
|||
|
|
## 提示词指南
|
|||
|
|
|
|||
|
|
### 新增页面/模块
|
|||
|
|
> "在写作后台新增一个 XXX 模块，左侧侧边栏加入口，页面风格与现有文章管理一致"
|
|||
|
|
|
|||
|
|
### 修改现有功能
|
|||
|
|
> "优化文章管理页面的 XXX 功能，保持 SEN 配色和卡片式布局"
|
|||
|
|
> "修复评论管理页面的 XXX bug，不要改动其他功能"
|
|||
|
|
|
|||
|
|
### 样式调整
|
|||
|
|
> "把 XXX 页面的色调整体改为 SEN 暖色系（bg: #fcfaf5, text: #223d66, accent: #1d3d6c, line: #e4dfd2）"
|
|||
|
|
|
|||
|
|
### API 对接
|
|||
|
|
> "对接 rssapi.usj.cc 的 XXX 接口，token 在 .env 的 RSS_API_TOKEN，后端代理不要暴露到前端"
|
|||
|
|
|
|||
|
|
### 常见问题描述
|
|||
|
|
- "布局太窄了" → 去掉 max-w 限制
|
|||
|
|
- "左右比例不对" → sidebar w-1/4，main flex-1
|
|||
|
|
- "最新数据没排前面" → sort by date desc
|
|||
|
|
- "不知道点哪里" → 标题做成可点击，加明显按钮
|