Appearance
CMS 内容管理插件
CMS 插件是 MengStack 的内容管理核心,提供文章、版本控制、频道、分类、标签、媒体资源等完整的内容管理能力。支持多租户隔离、文章版本历史、SEO 字段、定时发布。
插件信息
| 属性 | 值 |
|---|---|
| 名称 | cms |
| 版本 | 0.2.0 |
| 描述 | 内容管理模块 -- 文章、版本、频道、分类、标签、媒体资源 |
| 管理面板 | 是 |
| 存储权限 | 是(沙箱前缀 cms) |
事件
| 事件名 | 触发时机 |
|---|---|
article.created | 文章创建 |
article.published | 文章发布 |
article.updated | 文章更新 |
article.version.restored | 版本恢复 |
数据模型
Article(文章)
表名: cms_articles
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseModel) | embedded | ID, TenantID, CreatorID, CreatedAt, UpdatedAt, DeletedAt |
| Title | string(500) | 标题 |
| Slug | string(500) | URL 标识,租户内唯一 |
| Content | text | 正文内容 |
| Excerpt | text | 摘要 |
| Status | string(20) | 状态:draft / pending / published / archived |
| ContentType | string(50) | 内容类型:article / page / video / gallery |
| CoverImage | string(1000) | 封面图 URL |
| PublishedAt | *time.Time | 发布时间 |
| ScheduledAt | *time.Time | 定时发布时间 |
| AuthorID | uint | 作者 ID |
| ChannelID | *uint | 所属频道 |
| CategoryID | *uint | 所属分类 |
| Tags | []Tag | 标签(多对多) |
| Version | int | 版本号,默认 1 |
| Schema | jsonb | 扩展结构化数据 |
| SEOTitle | string(500) | SEO 标题 |
| SEODescription | string(1000) | SEO 描述 |
| SEOKeywords | string(500) | SEO 关键词 |
| IsPinned | bool | 是否置顶 |
| IsFeatured | bool | 是否推荐 |
| ViewCount | int64 | 浏览次数 |
| LikeCount | int64 | 点赞数 |
| CommentCount | int64 | 评论数 |
ArticleVersion(文章版本)
表名: cms_article_versions
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseModel) | embedded | |
| ArticleID | uint | 关联文章 |
| Version | int | 版本号 |
| Title | string(500) | 版本标题快照 |
| Content | text | 版本内容快照 |
| Excerpt | text | 版本摘要快照 |
| Slug | string(500) | 版本 Slug 快照 |
| ChangedBy | uint | 修改人 |
| ChangedAt | time.Time | 修改时间 |
| ChangeNote | string(500) | 修改说明 |
Channel(频道)
表名: cms_channels
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseModel) | embedded | |
| Name | string(255) | 频道名称 |
| Slug | string(255) | URL 标识,租户内唯一 |
| Description | text | 描述 |
| Icon | string(500) | 图标 |
| SortOrder | int | 排序权重 |
| Status | string(20) | active / inactive |
| SEOTitle / SEODescription / SEOKeywords | SEO 字段 |
Category(分类)
表名: cms_categories
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseModel) | embedded | |
| Name | string(255) | 分类名称 |
| Slug | string(255) | URL 标识,租户内唯一 |
| ParentID | *uint | 父分类 ID(自引用层级) |
| ChannelID | *uint | 所属频道 |
| SortOrder | int | 排序权重 |
| SEOTitle / SEODescription / SEOKeywords | SEO 字段 |
Tag(标签)
表名: cms_tags
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseModel) | embedded | |
| Name | string(255) | 标签名称 |
| Slug | string(255) | URL 标识,租户内唯一 |
| ChannelID | *uint | 所属频道 |
| SEOTitle / SEODescription / SEOKeywords | SEO 字段 |
Media(媒体)
表名: cms_media
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseModel) | embedded | |
| FileURL | string(1000) | 文件 URL |
| FileType | string(100) | 文件类型 |
| FileSize | int64 | 文件大小(字节) |
| AltText | string(500) | 替代文本 |
| UploadedBy | uint | 上传者 |
| Width / Height | int | 图片尺寸 |
| Folder | string(255) | 文件夹 |
| IsWatermarked | bool | 是否已加水印 |
API 接口
公开接口
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/cms/articles | 已发布文章列表(分页) |
| GET | /api/v1/cms/articles/:id | 获取已发布文章 |
| POST | /api/v1/cms/articles/:id/view | 增加浏览次数 |
| GET | /api/v1/cms/channels | 频道列表 |
| GET | /api/v1/cms/channels/:id | 频道详情(含文章/分类计数) |
| GET | /api/v1/cms/categories | 分类列表 |
| GET | /api/v1/cms/categories/:id | 分类详情(含文章计数) |
| GET | /api/v1/cms/tags | 标签列表 |
| GET | /api/v1/cms/tags/:id | 标签详情(含文章计数) |
| GET | /api/v1/cms/media | 媒体列表 |
| GET | /api/v1/cms/media/:id | 媒体详情 |
管理接口(需认证 + 权限)
| 方法 | 路径 | 权限 | 说明 |
|---|---|---|---|
| POST | /api/v1/cms/articles | cms.article.write | 创建文章 |
| PUT | /api/v1/cms/articles/:id | cms.article.write | 更新文章(自动创建版本) |
| DELETE | /api/v1/cms/articles/:id | cms.article.write | 删除文章(仅创建者) |
| GET | /api/v1/cms/article-versions | cms.article.read | 版本列表(需 article_id 参数) |
| GET | /api/v1/cms/article-versions/:id | cms.article.read | 版本详情 |
| POST | /api/v1/cms/article-versions/:id/restore | cms.article.write | 恢复版本 |
| POST | /api/v1/cms/channels | cms.channel.write | 创建频道 |
| PUT | /api/v1/cms/channels/:id | cms.channel.write | 更新频道 |
| DELETE | /api/v1/cms/channels/:id | cms.channel.write | 删除频道(有文章时阻止) |
| POST | /api/v1/cms/categories | cms.category.write | 创建分类 |
| PUT | /api/v1/cms/categories/:id | cms.category.write | 更新分类 |
| DELETE | /api/v1/cms/categories/:id | cms.category.write | 删除分类(有子分类时阻止) |
| POST | /api/v1/cms/tags | cms.tag.write | 创建标签 |
| PUT | /api/v1/cms/tags/:id | cms.tag.write | 更新标签 |
| DELETE | /api/v1/cms/tags/:id | cms.tag.write | 删除标签 |
| POST | /api/v1/cms/media/upload | cms.media.write | 上传媒体文件 |
| PUT | /api/v1/cms/media/:id | cms.media.write | 更新媒体元数据 |
| DELETE | /api/v1/cms/media/:id | cms.media.write | 删除媒体 |
业务规则
- 版本控制: 文章更新时,如果内容发生变化,自动递增版本号并创建版本快照
- 所有权保护: 文章更新/删除仅限创建者(
CreatorID == userID) - Slug 自动生成: 文章、分类、标签创建时如未提供 Slug,自动生成
- 频道删除保护: 频道下有文章时禁止删除
- 分类删除保护: 分类下有子分类时禁止删除
- 标签关联: 文章与标签通过
article_tags中间表多对多关联 - 三阶段迁移: Phase 1 创建基础表 → Phase 2 添加 UNIQUE 约束 → Phase 3 创建 many2many 关联表

