跳到主要内容

CmsKit 能力价值与代码对齐报告（2026-04）

1. 本次对齐范围​

本报告对齐目录：src/Services/CmsKit/FreeKit.CmsKit

关注点：

  • 文档与代码一致性
  • 用户侧真实价值
  • 基础能力缺口与实现

2. 已存在且有用户价值的能力（代码已落地）​

2.1 内容生产与分发​

  • 文章、草稿、定时发布、版本管理
  • 沸点（短内容）、话题、频道、分类
  • SEO（Slug、Meta）

用户价值：

  • 创作者可以完整发布与复盘内容
  • 读者可通过频道/分类/搜索快速消费内容

2.2 社区互动​

  • 点赞、评论、收藏、关注
  • 用户交互日志（浏览行为）
  • 作者中心数据看板

用户价值：

  • 形成反馈闭环，提高创作动力
  • 作者可基于数据优化选题

2.3 平台治理与运营​

  • 审核日志（单条/批量审核）
  • 回收站
  • 管理端内容治理

用户价值：

  • 降低违规内容风险
  • 平台运营动作可追溯

2.4 搜索能力​

  • MeiliSearch 全文搜索（文章/沸点）
  • 搜索建议、热词、搜索历史
  • 高亮与摘取

用户价值：

  • 降低信息获取成本
  • 明显提升内容可发现性

3. 发现的关键缺口​

存在“手工推荐位（IsRecommend）”，但缺少“个性化智能推荐”。

影响：

  • 推荐依赖人工维护，扩展性差
  • 用户首屏内容相关性不稳定

4. 本次已实现能力（新增）​

4.1 智能推荐​

新增接口：

  • GET /api/cms/recommendations/articles

新增实现：

  • 服务接口：Application/Recommendations/Contracts/IRecommendationService.cs
  • 服务实现：Application/Recommendations/RecommendationService.cs
  • 控制器：Controllers/RecommendationController.cs
  • DI 注册：CmsKitModuleStartup.cs

4.2 推荐算法（基于现有日志）​

数据来源：

  • 用户浏览日志：cms_interaction_log（EntityType=Article）
  • 内容热度：HotIndex / 点赞 / 评论 / 浏览
  • 内容元数据：频道、作者、标签、发布时间、人工推荐位

评分原则：

  • 个性化偏好：频道、作者、标签加权
  • 站内质量：热度、互动、新鲜度加权
  • 运营兜底：无画像时回落到热门推荐

5. 从用户角度的价值评估​

5.1 真正有价值的能力​

  • 搜索 + 推荐 + 互动数据闭环
    • 用户可以“找得到、看得下去、持续发现新内容”
  • 定时发布 + 审核治理
    • 创作者和运营协作效率更高
  • 作者中心图表
    • 让创作行为可量化，支持持续优化

5.2 更有意思的能力（下一步建议）​

  • 多样性推荐（避免同质化）
  • 探索位（小流量试验新作者）
  • 主题型推荐（按标签簇组装内容流）

6. CmsKit 基础能力分析与实现结论​

基础能力清单：

  • 内容：文章/沸点/话题/频道/分类
  • 互动：赞评藏关 + 浏览日志
  • 治理：审核/回收站
  • 分发：搜索/热榜/订阅流
  • 实时：通知 Hub

实现结论：

  • 原有基础能力总体完整
  • 本次补齐“智能推荐”短板，形成“内容-互动-分发”的核心闭环