Yomiya Canonical Naming / 命名冻结表
Yomiya Canonical Naming / 命名冻结表
Section titled “Yomiya Canonical Naming / 命名冻结表”文档性质：名词冻结表
用途：统一产品、研发、运营三方在 Phase 1 及后续阶段的命名口径
状态：当前有效
规则：一旦本表定义生效，后续文档、接口、表设计、页面文案优先遵守本表，不再随意混用近义词
最后更新：2026-03-28
Yomiya 当前已经形成较完整的内容系统讨论，但多个文档中已经出现以下风险：
- 同一对象被不同词叫法混用
- 产品名词、数据库名词、接口名词、前端展示名词未完全对齐
- 栏目、合集、系列、专题、标签、首页区块容易互相混淆
本表的目标是：
用一套固定命名，把“内容是什么、放在哪里、如何组织、如何分发”一次性钉死。
2. 命名冻结总原则
Section titled “2. 命名冻结总原则”一个概念只保留一个主名称。
产品概念优先，工程实现可适配，但不能反向污染产品概念。
标签负责描述，容器负责承载。两者不能混用。
首页区块不是内容归属层，只是分发层。
3. 一级核心对象定义
Section titled “3. 一级核心对象定义”3.0 第一次读这些概念时怎么记
Section titled “3.0 第一次读这些概念时怎么记”如果第一次读这套命名，先不要按工程脑去背，先按前台理解去记：
- Channel（栏目）：长期来看，这条内容归哪一大类
- Collection（合集）：前台拿给用户点的一组内容
- Series（系列）：会持续更新、用户会等下一期的一条内容线
- Topic（专题）：只在一个时间窗口里集中推的短期入口
再说得更直白一点：
Channel是“内容长期住在哪里”Collection是“前台现在拿什么给用户点”Series是“这东西还会继续更新”Topic是“这阵子重点推什么”
一句话记忆：
Channel 管长期归属，Collection 管前台发现，Series 管连续更新，Topic 管短期运营。
对 Phase 1 来说，最重要的是先别混掉这两层：
- 用户在前台最常看到的是 Collection，不是 Channel
- 首页真正分发的是方向、合集和内容，不是后台模型名
3.1 Content Item（内容条目）
Section titled “3.1 Content Item（内容条目）”- 中文：内容条目
- 英文：Content Item
- 简称：Item
用户实际消费的最小单元。
- 一条视频
- 一期播客
- 一篇资讯
- 一条图文内容
- Item 是实际消费对象
- Item 不等于首页发现对象
- Item 可以被多个合集或专题引用
- Item 只能有一个长期归属栏目
Phase 1 暂时继续由 news 表承载。
3.2 Channel（栏目）
Section titled “3.2 Channel（栏目）”- 中文：栏目
- 英文：Channel
内容的一级长期归属容器。
它回答的问题
Section titled “它回答的问题”这条内容从长期来看，主要服务哪一类用户动机和内容职责？
- Channel 是唯一归属层
- 每条 Item 只属于一个 Channel
- Channel 是长期稳定结构，不是临时运营位
- Channel 不是首页区块
- Channel 不是标签
- 每日资讯
- 动漫日剧
- 日本文化
- 场景日语
- JLPT 专区
- 日语播客
继续由 channels 表承载。
3.3 Collection（合集）
Section titled “3.3 Collection（合集）”- 中文：合集
- 英文：Collection
长期存在、可反复发现的内容组织单元，是内容系统的常设货架。
它回答的问题
Section titled “它回答的问题”围绕一个长期成立的主题或目标，哪些内容应该被组织在一起，帮助用户降低选择成本？
- Collection 是长期发现容器
- Collection 不是唯一归属层，而是引用层
- Collection 以主题或目标组织内容，不以时机组织内容
- Collection 是首页和栏目页的核心发现对象
- 去日本旅行必备
- 动漫日语精听
- 日本文化冷知识
- JLPT N3 冲刺
Phase 1 新增 collections 与 collection_items。
3.4 Series（系列）
Section titled “3.4 Series（系列）”- 中文：系列
- 英文：Series
具有连续更新关系的内容组织单元，强调时间顺序、更新频率和追更预期。
它回答的问题
Section titled “它回答的问题”哪些内容具备天然的连续性，用户会期待下一期？
- Series 是连续更新容器
- Series 的关键不是相似，而是连续
- Series 可以独立存在，也可以被纳入 Collection
- Series 通常适用于播客、连载视频、固定主讲人栏目
- 固定播客节目
- 每周日本热词
- 连载文化观察
Phase 1 可先作为 Collection 的一种特殊类型表达，不强制单独建模；正式独立建模放后续阶段。
3.5 Topic（专题）
Section titled “3.5 Topic（专题）”- 中文：专题
- 英文：Topic
为特定时机、特定时间窗口或特定运营活动服务的时效性编排容器。
它回答的问题
Section titled “它回答的问题”在某个时间点，哪些内容值得被集中推送和重新包装？
- Topic 是时效运营容器
- Topic 可以跨栏目引用内容
- Topic 不承担唯一归属
- Topic 有明确起止时间
- Topic 不是长期货架
- 樱花季特辑
- JLPT 考前冲刺月
- 新番开播季专题
Phase 1 可先复用 Collection 承载并加时效字段，不要求立刻完全独立建模。
4. 标签体系冻结定义
Section titled “4. 标签体系冻结定义”4.1 Tag（标签）
Section titled “4.1 Tag（标签）”- 中文：标签
- 英文：Tag
用于描述内容属性的字段集合，不承担内容承载职责。
- Tag 负责描述内容
- Container 负责承载内容
- 标签不能替代栏目、合集、系列、专题
4.2 Scene Tag（场景标签）
Section titled “4.2 Scene Tag（场景标签）”- 中文：场景标签
- 英文：Scene Tag
- 工程对象：
scene
描述内容所对应场景、主题或使用情境的标签体系。
Phase 1 优先继续沿用现有 scenes 体系，不再额外新建一套完全独立的 topic_tags 主体系。
- 内容筛选
- 内容聚合
- Tab 分类映射
- 合集建议分析
- 推荐与分发辅助
- Scene Tag 是标签，不是栏目
- Scene Tag 是描述维度，不是长期归属维度
4.3 Level（难度等级）
Section titled “4.3 Level（难度等级）”- 中文：难度等级
- 英文：Level
描述内容难度的统一等级字段，与 JLPT 体系对齐。
- N5
- N4
- N3
- N2
- N1
- 不限
- Level 是描述属性，不是内容归属
- Level 不能替代 JLPT 专区入口
4.4 Operator Tag（运营标签）
Section titled “4.4 Operator Tag（运营标签）”- 中文：运营标签
- 英文：Operator Tag
为临时运营编排和活动聚合服务的短期标签。
- 樱花季
- 热点
- 考前冲刺
- 新番季
- Operator Tag 只服务分发与运营
- 不承担长期内容归属
5. 首页与分发层命名冻结
Section titled “5. 首页与分发层命名冻结”5.1 Home（首页）
Section titled “5.1 Home（首页）”- 中文：首页
- 英文：Home
平台内容丰富度的第一展示面，也是内容消费的第一入口。
Phase 1 明确定位
Section titled “Phase 1 明确定位”首页是内容平台首页，不是学习任务首页。
5.2 Home Module（首页区块）
Section titled “5.2 Home Module（首页区块）”- 中文：首页区块
- 英文：Home Module
首页上用于内容分发的展示区块。
- 首页区块是分发层，不是归属层
- 首页区块不能反向决定 Item 的 Channel
- 首页区块可以展示 Collection、Topic、Item 等不同对象
- Banner
- 热门推荐
- 今日新闻速递
- 每日资讯 Tab 区
- JLPT 入口
- 播客精选
5.3 Featured（精选分发位）
Section titled “5.3 Featured（精选分发位）”- 中文：精选分发位
- 英文：Featured
运营显式控制的首页/核心页面分发位置。
- Featured 是分发机制，不是内容对象
- Featured 不等于 Collection
- Featured 可承载合集、专题或单条内容
现有 /featured 接口、配置项等，都属于分发层，不属于内容归属层。
5.4 Tab（首页资讯 Tab）
Section titled “5.4 Tab（首页资讯 Tab）”- 中文：Tab
- 英文：Tab
首页某一区块下的横向分类切换入口。
- Tab 是展示分类，不是栏目
- Tab 是前台浏览入口，不是后台归属对象
- Tab 可通过 scene/tag 规则映射生成
每日资讯 Tab 不是新的一级内容容器，不能替代 Channel。
6. 状态层命名冻结
Section titled “6. 状态层命名冻结”6.1 Visibility（可见性）
Section titled “6.1 Visibility（可见性）”- 中文：可见性
- 英文：Visibility
控制内容是否对用户可见，以及以什么权限可见。
- 控制是否可见
- 控制会员可见
- 控制限时可见
Visibility 解决“用户能不能看到”，不解决“内容应不应该被首页推荐”。
6.2 Distribution Eligibility（分发资格）
Section titled “6.2 Distribution Eligibility（分发资格）”- 中文：分发资格
- 英文：Distribution Eligibility
控制内容是否具备进入列表、合集、首页、专题等分发场景的资格。
为什么必须单独存在
Section titled “为什么必须单独存在”因为：
自动入库 ≠ 自动分发 ≠ 自动首页推荐
- 区分已入库和可分发
- 区分可分发和可首页推荐
7. 产品名词与工程名词映射
Section titled “7. 产品名词与工程名词映射”| 产品名词 | 英文 | 工程承载建议 | 说明 |
|---|---|---|---|
| 内容条目 | Content Item / Item | news（Phase 1） | 实际消费单元 |
| 栏目 | Channel | channels | 一级长期归属容器 |
| 合集 | Collection | collections + collection_items | 长期发现容器 |
| 系列 | Series | 先作为 collection_type 或扩展字段 | 连续更新容器 |
| 专题 | Topic | Phase 1 可借 Collection + 时效字段 | 时效运营容器 |
| 场景标签 | Scene Tag | scenes + news_scenes | 标签体系 |
| 难度等级 | Level | news.level | 描述属性 |
| 可见性 | Visibility | news.visibility | 是否可见 |
| 分发资格 | Distribution Eligibility | 新状态字段或规则层 | 是否可进入分发层 |
| 首页区块 | Home Module | 前端模块 / featured 配置 | 分发层，不是归属层 |
| 精选分发位 | Featured | /featured / 配置层 | 运营精选位 |
| Tab | Tab | 前端展示逻辑 | 浏览入口，不是内容容器 |
8. 明确禁止的混用方式
Section titled “8. 明确禁止的混用方式”以下混用从本表生效后视为错误：
把 Tab 当 Channel 使用
错误示例：
- “社会 Tab 就是一个栏目”
正确理解：
- Tab 是首页展示分类
- Channel 是长期归属容器
把标签当合集使用
错误示例：
- “打了旅行标签，就等于进入了去日本旅行必备合集”
正确理解：
- 标签描述内容
- 合集组织内容
把 Featured 当内容对象使用
错误示例：
- “featured 就是一类内容”
正确理解：
- featured 只是分发层机制
把可见性当作分发资格使用
错误示例：
- “只要是 VISIBLE 就能进首页”
正确理解：
- Visibility 解决能否看见
- Distribution Eligibility 解决能否被分发
把 Topic 和 Collection 混成同一种长期对象
错误示例：
- “樱花季特辑长期作为合集保留在首页主入口”
正确理解：
- Collection 是长期货架
- Topic 是时效展台
9. Phase 1 解释优先级
Section titled “9. Phase 1 解释优先级”当多个文档之间出现名词冲突时，解释顺序如下：
- 本文档（
yomiya-canonical-naming.md） yomiya-phase1-execution-spec.mdyomiya-content-strategy.mdyomiya-implementation-spec.md- 其他讨论性文档、审核记录、补充附录
也就是说：
本文档负责冻结名词，其他文档必须与它对齐。
10. 一句话总括
Section titled “10. 一句话总括”Channel 负责归属，Collection / Series / Topic 负责组织与分发，Tag 负责描述，Home Module / Featured / Tab 只负责展示。