集中式配置：让 Reddit 组件脱离重复泥潭

数据重复是软件系统中最隐蔽的债务。你在 A 文件中改了一个 ID，却忘了 B 文件和 C 文件中还有相同的配置。系统在这种割裂中逐渐失控。

重复的本质问题

当你需要在多个页面展示 Reddit 讨论时，最直观的做法是在每个页面的配置文件中写入相同的 post IDs。这看起来很自然：每个页面有自己的数据，互不干扰。

但这种"自然"的代价是隐形的。当你发现某个 post 需要替换时，你必须记住所有用到它的地方。如果有十个页面使用了这个配置，你需要修改十次。这不是勤奋的问题，而是系统设计的问题。

更深层的矛盾在于：这些数据在逻辑上是同一个实体。同一种语言的 Reddit posts 列表，无论在哪个页面展示，本质上是同一份数据的不同视图。把它们分散存储，违背了数据的本质属性。

Single Source of Truth 的价值

集中式配置的核心不是"把文件放在一起"，而是建立数据的唯一权威来源。

当所有页面都从同一个地方读取 Reddit posts 配置时，修改的传播变得自动。你改一处，所有依赖它的地方同步更新。这不需要记忆力，不需要 checklist，系统自己保证一致性。

设计主题 Collections

实现集中式配置的关键是引入"主题"概念。不同的页面可能展示不同主题的 Reddit 讨论：Sora 2 的讨论、通用 AI 话题、Claude AI 相关内容。

创建 lib/reddit-collections.ts：

export interface RedditCollection {
  name: string;
  description: string;
  posts: Record<string, RedditDiscussionConfig[]>;
}

export const REDDIT_COLLECTIONS: Record<string, RedditCollection> = {
  'sora2': {
    name: 'Sora 2 Discussions',
    description: 'Community discussions about OpenAI Sora 2',
    posts: {
      'en': [
        {
          postId: '1o8cylw',
          subreddit: 'StableDiffusion',
          featured: true,
          locale_note: 'Comparison: Veo 3.1 vs Kling 2.5 vs Sora 2',
        },
        // 更多英文posts...
      ],
      'zh-cn': [
        {
          postId: '1o8cylw',
          subreddit: 'StableDiffusion',
          featured: true,
          locale_note: '对比评测：Veo 3.1 vs Kling 2.5 vs Sora 2',
        },
        // 同样的post IDs，不同的locale_note
      ],
    },
  },

  'general-ai': {
    name: 'General AI Discussions',
    posts: { /* ... */ },
  },
};

数据按主题和语言两个维度组织。同一主题下，不同语言的 posts 使用相同的 post IDs，只有 locale_note 翻译不同。这保证了内容的一致性：英文用户和中文用户看到的是同一个讨论，只是注释语言不同。

引用而非复制

有了集中式配置后，各个页面的 JSON 文件变得极简：

{
  "redditCard": {
    "sectionTitle": "Community Discussions",
    "collectionName": "sora2"
  }
}

只需指定 collection 名称。页面不再"拥有"数据，而是"引用"数据。这种关系的转变很关键：页面关心的是"展示哪个主题的讨论"，而不是"这些讨论的具体 IDs 是什么"。

获取数据的逻辑相应简化：

import { getRedditCollection } from './reddit-collections';

export async function getRedditDiscussions(
  lang: SupportedLanguage,
  modelId?: string
): Promise<RedditDiscussion[]> {
  const modelContent = await getModelContent(modelId, lang);
  const { collectionName } = modelContent.redditCard;

  // 从集中配置中获取
  const configs = getRedditCollection(collectionName, lang);

  // 转换为展示用的 RedditDiscussion 对象...
}

数据流向变清晰：集中配置 → 按需获取 → 渲染展示。中间没有重复，没有歧义。

扩展的边界

当需要添加新页面时，你不需要复制任何 posts 配置。只需要：

1. 确定这个页面应该展示哪个主题的讨论
2. 在 JSON 中写入 "collectionName": "主题名"

如果这个主题还不存在，才需要在 reddit-collections.ts 中创建新的 collection。但即使创建新 collection，也是在集中的地方添加，而不是散落到各个页面配置中。

这种模式的边界很明确：

• 集中配置层：管理所有主题的 posts 数据，按主题和语言组织
• 页面配置层：只需声明引用哪个主题
• 业务逻辑层：负责从集中配置获取数据并转换为展示格式

系统性的收益

集中式配置带来的不仅是代码层面的简洁，更是认知负担的降低。

当你需要添加新的 Reddit post 时，你不需要思考"这个 post 应该加到哪些文件里"。你只需要思考"这个 post 属于哪个主题"。决策的复杂度从 O(n) 降到 O(1)。

当你需要审查 Reddit 内容配置时，你不需要在多个 JSON 文件之间跳转。所有主题的所有配置都在一个文件中，你可以一眼看到全局。

当新成员加入项目时，他们不需要学习"posts 配置可能散落在哪些地方"。他们只需要知道"去 reddit-collections.ts 看就行了"。知识传递的成本降低了。

最后

配置的组织方式反映了你对系统的理解。分散的配置暗示着"每个页面是独立的"，集中的配置则明确宣告"这些页面共享同一份数据源"。

技术选择的背后是认知模型的选择。当你把数据集中起来，你不只是在写更好的代码，你是在强制系统暴露它真实的结构。

重复是系统的熵。集中式配置是对抗熵增的手段。