Buu 当前希望 llm-wiki 的网站更像 Wiki 而不是文章站

Decision(决策)

当前 llm-wiki 的网站展示,优先追求 Wiki(维基)式的阅读和导航体验,而不是普通文章站 / 博客站的展示气质。

同时保持本地 Markdown 文件为唯一真源,让展示层来适应现有文档,而不是反过来重塑文档结构。

Context(背景)

Buu 当前已经让 Hermes 持续记录 llm-wiki,但一直没有直接在网页里看过这套内容的真实长相。

在这种情况下,先看到“网站里的成品感”比继续抽象讨论框架更重要。
而一旦进入网站 review,问题就会从“能不能建站”转成“这看起来像不像自己想要的 Wiki”。

Criteria(判断标准)

当前网站展示层至少应满足:

  • 直接从现有 Markdown 生成,不要求先改本地文档结构
  • 读起来更像知识条目网络,而不是按文章顺序消费
  • 便于 review 当前内容长相
  • 不打断 Markdown 作为长期真源的地位
  • 后续仍能保留向 Digital Garden 风格融合的空间

Facts(事实)

  • Buu 明确表示:当前最想看到的是网站里的所见即所得效果,而不是额外整理的一份 Markdown 审阅文档。
  • Buu 明确表示:当前本地 Markdown 结构和格式优先不改,应由工具来适配本地文档。
  • Buu 认为理想体验更接近维基百科式的阅读和使用手感,而不是偏文章 / 笔记展示的站点。
  • Buu 同时承认,在真正看到内容长相后,未来也可能再考虑和 Digital Garden 做结合。
  • 当前 Quartz 已经作为展示层接入现有 wiki,并生成了可直接访问的网站。

Interpretation(解释)

当前更该看的,是站点做出来之后像不像一个可浏览、可跳转、可 review 的 Wiki。

Digital Garden 目前先放在后续选项里,等 Wiki 体验跑顺后再考虑怎么融合。

Current Rule(当前规则)

  • 当前 llm-wiki 网站优先往 Wiki 阅读体验靠,而不是文章站体验。
  • 本地 Markdown 继续作为唯一真源。
  • 展示工具应优先适配现有文档,而不是要求先改写内容结构。
  • 在正式 review 完当前网站前,不因为抽象风格争论而反复换方向。
  • Digital Garden 可以作为后续可能的融合方向,但不是当前第一目标。

Exceptions(例外)

  • 如果某种 Digital Garden 特性明显提升了 Wiki 可读性,也可以局部吸收。
  • 如果后续 review 发现“更像纯 Wiki”的框架明显更适合当前文档,也可以重新评估 Quartz。
  • 如果实际内容增长后,当前页面组织方式开始妨碍检索和跳转,则应优先优化展示层。

Review Trigger(复查触发条件)

出现以下情况时,应复查这条决定:

  • 当前网站看起来仍然明显像文章站
  • 导航和跳转无法支撑条目式浏览
  • Buu 在实际 review 后强烈不喜欢当前展示气质
  • 现有 Markdown 结构与展示层之间出现明显冲突
  • 出现更适合当前文档结构、且更像 Wiki 的候选方案