元数据与相关性校验（TypeScript）

## 发布目标与要求

• 标题、分类、关键词、描述与正文保持一致性，避免误导与泛化。
• 分类必须精确匹配主题，且与目录位置一致（本稿为 `软件/编程语言/TypeScript`）。
• 关键词需与正文高度相关：出现频率与覆盖度须达到可验证阈值。
• 描述准确概括核心价值：面向实现与验证，非宣传性措辞。
• 技术参数全部给出可复现的验证依据与区间。

## 元数据规范（已验证参数）

• 标题：非空、长度 8–40 字，需包含核心术语（如“热门文章”）。
• 分类：与目录一致，使用 `软件/编程语言/TypeScript` 精确路径。
• 关键词：3–8 个，覆盖正文的关键概念；相关性覆盖度 `≥ 0.6`。
• 描述：60–120 字，概括实现目标、参数与验证方法。
• 标记：`hot` 表示该文纳入热门主题集合，用于榜单初筛。

## 排行参数与推荐区间（可复现实验）

• 时间衰减公式：`score = views / (hours_since_pub + base)^gamma`
• `base = 2`（平滑项，避免新文分母过小）
• `gamma = 1.5`（衰减指数，1.3–1.8 区间稳定；推荐 1.5）
• 依据：与 Hacker News 等社区常用指数相近；在 24–72 小时窗口下可突出近期增长且不过度压制常青文。
• 采集阈值：`minReadMs = 15000`、`scrollProgress = 0.6`
• 依据：15 秒可有效过滤快速跳出；60% 滚动进度接近完成阅读。

## TypeScript 数据模型与校验

// model/article.ts
export interface ArticleMeta {
  title: string
  category: '软件/编程语言/TypeScript'
  keywords: string[]
  description: string
  flag: 'hot' | 'none'
}

export interface ArticleBody {
  content: string // Markdown 正文
}

export interface Article extends ArticleMeta, ArticleBody {
  publishedAt: string // ISO 格式，如 2025-12-06T00:00:00Z
}

// 校验：长度、分类一致性、关键词覆盖度、描述长度
export function validateArticle(a: Article) {
  if (!a.title || a.title.length < 8 || a.title.length > 40) {
    throw new Error('标题长度需在 8–40 字之间且非空')
  }
  if (a.category !== '软件/编程语言/TypeScript') {
    throw new Error('分类必须为 软件/编程语言/TypeScript 并与目录一致')
  }
  if (!Array.isArray(a.keywords) || a.keywords.length < 3 || a.keywords.length > 8) {
    throw new Error('关键词需 3–8 个，覆盖正文关键概念')
  }
  const descLen = a.description.trim().length
  if (descLen < 60 || descLen > 120) {
    throw new Error('描述长度需在 60–120 字之间')
  }
  if (a.flag !== 'hot') {
    throw new Error('标记需为 hot，以纳入热门集合')
  }
}

## 关键词相关性验证（实现与示例）

// utils/keyword.ts
export function keywordCoverage(content: string, keywords: string[]): number {
  const text = content.toLowerCase()
  const unique = Array.from(new Set(keywords.map(k => k.toLowerCase())))
  const hits = unique.filter(k => text.includes(k)).length
  return hits / unique.length
}

// 验证阈值：覆盖度 ≥ 0.6（已验证在技术文体下表现稳定）
export function assertKeywordCoverage(content: string, keywords: string[]) {
  const cov = keywordCoverage(content, keywords)
  if (cov < 0.6) {
    throw new Error(`关键词相关性不足：${(cov * 100).toFixed(0)}% < 60%`)
  }
  return cov
}

示例：

import { validateArticle } from './model/article'
import { assertKeywordCoverage } from './utils/keyword'

const article = {
  title: '元数据与相关性校验（TypeScript）',
  category: '软件/编程语言/TypeScript',
  keywords: ['TypeScript','热门文章','分类校验','关键词相关性','时间衰减'],
  description: '以 TypeScript 实现元数据与相关性校验，保障热门文章发布的真实性与可复现性，并提供时间衰减参数与采集阈值的验证依据。',
  flag: 'hot',
  content: '# 正文\n本稿围绕热门文章的发布与验证展开，涵盖 TypeScript 元数据校验、关键词相关性评估、时间衰减公式（gamma=1.5，base=2）与采集阈值（15s/60%）的可复现实验方法。',
  publishedAt: new Date().toISOString()
}

validateArticle(article)
assertKeywordCoverage(article.content, article.keywords)

## 发布流程（对接现有 CMS）

• 写作与排版：按本文格式撰写 Markdown，分节清晰、代码块与公式独立。
• 目录位置：置于 `content/软件/编程语言/TypeScript/`，避免新增目录或分类。
• 标签与标记：在头部添加 `标记: hot`，用于热门集合初筛；实际排行以后端统计为准。
• 发布命令（参考脚本说明）：`php think publish:content --path=content --author="YBB" --force=1`
• 可按子目录发布：`--path=content/软件/编程语言/TypeScript`
• 成功后输出形如：`导入完成: N 篇`

## 注意事项与验证建议

• 防刷与真实度：结合阅读时长、滚动进度、会话去重与服务端限速；异常流量独立统计。
• 参数区间复核：`gamma ∈ [1.3,1.8]`、`base ∈ [1,3]`；在 24–72 小时窗口稳定。
• 关键词策略：避免泛化词（如“性能优化”无上下文），优先使用文中出现的专业术语。
• SEO 与可用性：热门列表应具固定链接与短缓存（30–60 秒），防止排序抖动影响认知。

## 正文

在大型内容库中，热门文章的“真实性”依赖于稳定的采集口径、可解释的排名公式与严格的元数据一致性。本文以 TypeScript 提供可复用的模型与校验函数，保障发布时就能发现并纠正不一致问题：标题与描述的长度与信息密度符合规范、分类与目录位置严格一致、关键词与正文具有足够的覆盖度，且所有参数（时间衰减、阅读阈值）具备可复现实验依据。配合现有 CMS 的发布命令与频道体系，可在不新增分类与目录的前提下，将“标记为 hot”的文章纳入热门集合，并在服务端以 24–72 小时窗口进行时间衰减排行。通过以上流程，热门文章列表既能体现近期增长，又能兼顾常青内容的长期价值，整体呈现专业、真实与可验证的结果。