📚 模型概览
Wiki模型是知识库系统的核心,用于构建结构化的百科词条,支持丰富的关联关系、分类体系和内容管理功能。适用于知识库、产品库、人物库、术语解释等场景。✨ 核心功能特性
1. 结构化知识管理
- 主副标题:支持主标题、副标题、别名
- 分层内容:基本资料+详细内容双字段设计
- 完整分类:严格的分类体系管理
- 关联网络:多层级关联关系构建
2. 智能关联系统
- 自关联:百科词条间的相互关联
- 标签关联:手动标签+自动标签双模式
- 动态匹配:标题关键词自动关联标签
- 相关文章:可关联相关文章内容
3. 富文本内容编辑
- 基本资料:CKEditor5编辑,用于摘要或基本信息
- 详细内容:完整富文本编辑器
- 多配置支持:支持不同编辑配置
- 媒体嵌入:支持图片、视频、表格等
4. 完整的内容工作流
- 7种状态:完整的审核发布流程
- 权限控制:多级访问权限管理
- 版本控制:通过状态实现版本管理
- 归档机制:历史内容归档
5. 强大的关联网络
6. SEO与URL优化
- 完整SEO:继承SEOMixin所有优化功能
- URL友好:自动生成唯一slug
- 规范链接:防止重复内容
- 社交分享:Open Graph优化
7. 权限与可见性
- 状态控制:7种状态管理
- 用户组控制:限制特定用户组访问
- 评论管理:控制评论权限
- 员工可见:内部使用内容标记
🎯 后台使用指南
1. 创建新百科词条
2. 关联关系管理
- 用途:建立百科词条间的关联网络
- 示例:
3. 工作流程
- 已入库(0):新创建词条默认状态
- 草稿(1):编辑中,未提交审核
- 已提交(2):已提交等待审核
- 审核中(3):正在审核
- 已通过(4):审核通过待发布
- 已发布(99):已正式发布
- 已驳回(5):审核未通过
- 已归档(6):历史归档
4. URL访问规则
- 模型路径:
/wiki/123.html - 单级Slug:
/knowledge/123.html - 多级Slug:
/tech/programming/123.html - 随机字符:
/jklfdsa/1.html - 自定义路径:
/mywiki/mypage/1.shtml
/wiki/{标识}{后缀}- 标识:ID或哈希值
- 后缀:.html、.shtml等
📊 字段说明速查
字段分组 | 字段名 | 说明 | 必填 | 默认值 |
|---|---|---|---|---|
基础信息 | title | 词条标题 | 是 | - |
subtitle | 副标题 | 否 | 空 | |
alias | 别名 | 否 | 空 | |
pytitle | 标题拼音 | 自动 | 空 | |
内容编辑 | basic | 基本资料 | 否 | 空 |
content | 详细内容 | 否 | 空 | |
thumbimage | 缩略图 | 否 | 空 | |
template | 个性模板 | 否 | 空 | |
分类标签 | category | 所属分类 | 是 | - |
about | 相关百科 | 否 | 空 | |
relatedtags | 关联标签 | 否 | 空 | |
filteredtags | 动态标签 | 自动 | 空 | |
权限控制 | status | 审核状态 | 是 | 99(已发布) |
staffonly | 仅员工可见 | 否 | False | |
allowedgroups | 允许用户组 | 否 | 空 | |
allowcomment | 允许评论 | 否 | True | |
统计导航 | hits | 点击量 | 自动 | 0 |
istop | 是否推荐 | 否 | False | |
previousobj | 上一篇 | 否 | null | |
nextobj | 下一篇 | 否 | null | |
createtime | 创建时间 | 自动 | 当前时间 | |
updatetime | 更新时间 | 自动 | 当前时间 | |
关联信息 | editor | 内容编辑 | 是 | 当前用户 |
继承字段 | 所有SEOMixin字段 | SEO优化 | 自动/手动 | - |
🔗 关联网络详解
1. 自关联(about字段)
- 相关概念:解释相关术语
- 上级分类:所属大类
- 下级分类:包含的子类
- 应用实例:实际应用案例
- 历史发展:相关历史背景
2. 标签系统
- 保存时检查标题变化
- 提取标题关键词
- 与标签库模糊匹配
- 建立动态关联关系
- 更新缓存时间戳
3. 分类体系
🎨 模板使用技巧
1. 基础信息展示
2. 关联内容展示
3. 导航与分页
4. SEO标签生成
🔧 高级功能配置
1. 性能优化索引
2. 安全删除功能
3. URL生成策略
💡 最佳实践建议
1. 内容结构规划
- 主标题:简洁明确
- 副标题:补充说明
- 别名:常用称呼、外文名
- 示例:
2. 关联关系管理
- 强相关:直接相关概念
- 层级关系:上下级分类
- 应用关联:实际应用场景
- 历史关联:发展历程
- 避免循环:防止循环关联
- 核心标签:3-5个核心关键词
- 扩展标签:相关领域标签
- 避免冗余:合并相似标签
- 定期维护:清理无用标签
3. 分类体系建设
4. SEO优化策略
- 包含核心关键词
- 长度控制在60字符内
- 主标题+副标题组合
- 摘要基本资料内容
- 包含核心关键词
- 长度150-300字符
- 吸引用户点击
- 核心词+长尾词
- 用英文逗号分隔
- 避免堆砌关键词
- 定期更新优化
5. 权限管理
6. 性能优化
- 合理使用索引
- 避免N+1查询
- 使用selectrelated和prefetchrelated
- 定期清理过期数据
- 热门词条缓存
- 关联关系缓存
- 列表页分页缓存
- 标签匹配结果缓存
7. 维护与备份
- 定期检查死链
- 更新关联关系
- 清理重复内容
- 优化标签系统
- 定期全量备份
- 增量备份关联关系
- 备份图片媒体文件
- 测试恢复流程