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 对当前标题可读性明显不满意
Related Pages(相关页面)
- 暂无