Wiki 标题、文件名与标签的默认处理

Decision(决策)

把“给人看的标题”和“给系统用的文件名”分开处理。
可见标题优先服务 Buu 的阅读;文件名优先服务稳定、搜索和维护。
标签不预先设计完整体系,而是在受控前提下逐步生长。

Context(背景)

当前 wiki 已建立基本结构,但还没有正式页面。
在开始实际收录之前,需要先固定一套足够简单、不会反复摇摆的默认规则。
Buu 明确表达了三个要求:

  • 不要把 skill 已有的默认骨架再翻译成额外的元问题
  • 可见标题要更贴近自己的阅读习惯
  • 产品、服务、品牌、模型等专有名称要保留官方写法

Criteria(判断标准)

默认规则应同时满足:

  • 读起来顺
  • 写起来稳
  • 多语言材料可兼容
  • 文件名不因显示偏好频繁变动
  • 标签不会一开始就失控膨胀

Facts(事实)

  • 现有 schema 已将本 wiki 定义为 Buu 的 personal explicit-knowledge wiki(个人显性知识 wiki)。
  • schema 已要求文件名使用 lowercase with hyphens(小写加连字符)这一稳定格式。
  • schema 已有 controlled tags(受控标签)作为初始种子集合。
  • 当前讨论中,Buu 明确表示:
    • 写给自己的文档,标题用中文即可
    • 原始材料应沿用原始标题
    • 专有名称如 Notion 应保留官方拼写和大小写
    • 标签应逐渐生长,而不是一开始设计完毕

Interpretation(解释)

标题和文件名承担的是不同任务。
如果把 slug(稳定文件名)直接塞进可见标题,会降低可读性。
如果把可见标题直接当文件名,又会让多语言页面在搜索、链接和后续自动处理时变得不稳定。
因此分层处理最稳妥。

标签方面,完全放开会失控,完全预设完也不现实。
更合适的做法是:先用已有种子标签,等新模式反复出现时再正式增补。

Current Rule(当前规则)

  • 正式 wiki 页的可见标题以中文优先,按 Buu 的阅读习惯书写。
  • 原始材料的可见标题沿用原始来源标题。
  • 产品、服务、品牌、模型等专有名称,在可见标题和正文首次正式出现时,保留官方拼写和大小写。
  • 文件名继续使用小写加连字符的稳定格式,不要求与可见标题完全一致。
  • aliases(别名)字段用于收录其他叫法、缩写、不同语言写法和大小写变体。
  • 标签先使用现有 controlled tags(受控标签);只有当新标签反复出现并且确实有检索价值时,才把它加入 schema。
  • 不为了“看起来完整”而预先发明大量标签。

Exceptions(例外)

  • 当某个对象没有自然的中文标题时,可直接用官方原文作为可见标题。
  • 当同名对象在当前 wiki 范围内会混淆时,标题可加短限定词进行消歧。
  • 当原始来源标题过长、过噪或包含明显营销措辞时,可在 source-note(来源笔记)中另写更适合复用的标题,但 raw(原始材料)文件仍保留来源标题。

Review Trigger(复查触发条件)

以下情况出现时,复查这条规则:

  • 文件查找或链接明显变得困难
  • 多语言标题导致频繁混淆
  • 新标签数量快速膨胀
  • 专有名称的记录方式在不同页面中不一致
  • Buu 对当前标题可读性明显不满意
  • 暂无