CDPR技術(shù)文檔的八年彎路：從8000頁(yè)廢紙到跨項(xiàng)目共享

你有沒(méi)有想過(guò)，那些讓你肝到凌晨三點(diǎn)的3A大作，背后可能是用"考古"方式做出來(lái)的？

CD Projekt RED最近自曝了一段挺離譜的家丑：從《巫師1》《巫師2》的"零文檔"，到《賽博朋克2077》的8000頁(yè)"文檔垃圾山"，再到如今《巫師4》和《賽博朋克2》的跨項(xiàng)目知識(shí)共享——這家波蘭蠢驢花了整整十幾年，才弄明白"寫(xiě)文檔"這件事到底該怎么做。

這事我是在Digital Dragon的開(kāi)發(fā)者論壇上看到的，CDPR的首席技術(shù)文檔工程師Jaros?aw Ruciński和高級(jí)技術(shù)文檔工程師Adrian Fulneczek聊得相當(dāng)坦誠(chéng)。聽(tīng)完我只想說(shuō)：能把自己怎么搞砸的講得這么細(xì)，也算是種勇氣。

一切從"什么都沒(méi)有"開(kāi)始

事情得追溯到《巫師》系列最早那兩作。Ruciński的原話是："那個(gè)時(shí)期的東西，什么都沒(méi)有留下來(lái)。"

這話聽(tīng)著夸張，但仔細(xì)想想也挺合理。2007年的《巫師1》是CDPR的第一款游戲，那時(shí)候團(tuán)隊(duì)規(guī)模小，大家靠喊、靠記憶、靠"那個(gè)誰(shuí)上次怎么做的"就能把事情推進(jìn)下去。到2011年的《巫師2》，雖然技術(shù)升級(jí)了，但文檔習(xí)慣顯然沒(méi)跟上。

后果是什么？Ruciński舉了個(gè)現(xiàn)成例子：現(xiàn)在Fool's Theory正在重制《巫師1》，目標(biāo)是"為主流玩家重現(xiàn)經(jīng)典"。結(jié)果CDPR翻遍倉(cāng)庫(kù)，發(fā)現(xiàn)"幾乎沒(méi)有保留任何技術(shù)知識(shí)"。重制團(tuán)隊(duì)想?yún)⒖籍?dāng)年的設(shè)計(jì)思路、技術(shù)方案、甚至某個(gè)功能為什么這么實(shí)現(xiàn)——對(duì)不起，沒(méi)有。全在當(dāng)年某個(gè)程序員的腦子里，而那位程序員可能早就去別的公司了。

這就像一個(gè)廚師做了道成名菜，但菜譜沒(méi)寫(xiě)，調(diào)料用量靠手感，火候憑經(jīng)驗(yàn)。十年后你想復(fù)刻這道菜，只能對(duì)著成品猜。

《賽博朋克2077》的" fresh start"翻車(chē)記

到了《賽博朋克2077》，CDPR終于意識(shí)到需要系統(tǒng)化的文檔管理。他們的解決方案是Confluence——一款"活文檔工具"，理論上可以讓團(tuán)隊(duì)成員實(shí)時(shí)協(xié)作、隨時(shí)更新。

初衷是好的，執(zhí)行是崩的。

Confluence確實(shí)被用起來(lái)了，但用著用著就變成了"文檔墳場(chǎng)"。Ruciński透露，最終攢出了超過(guò)8000頁(yè)的文檔。8000頁(yè)是什么概念？按A4紙算，摞起來(lái)大概有一米高。問(wèn)題是，這些頁(yè)面"幾乎沒(méi)什么用"。

為什么？因?yàn)榫S護(hù)文檔被當(dāng)成了"低優(yōu)先級(jí)"任務(wù)。開(kāi)發(fā)趕進(jìn)度的時(shí)候，誰(shuí)有空去更新Confluence？新功能上線三個(gè)月，文檔還停留在設(shè)計(jì)稿階段；某個(gè)系統(tǒng)被重寫(xiě)了，舊文檔沒(méi)人刪，新文檔另起爐灶。結(jié)果就是8000頁(yè)里，不知道多少是過(guò)時(shí)的、矛盾的、或者干脆沒(méi)人看的。

更亂的是2023年《往日之影》（Phantom Liberty）資料片開(kāi)發(fā)時(shí)，團(tuán)隊(duì)又搞了個(gè)"云端Confluence實(shí)例"。Fulneczek的原話是：" chaos，對(duì)吧？?jī)蓚€(gè)空間，兩個(gè)實(shí)例。對(duì)我們來(lái)說(shuō)很難理解，對(duì)我們的外包合作伙伴來(lái)說(shuō)也是……如果可以的話，不要在不同平臺(tái)或工具之間分割。你必須在它們之間建立非常清晰的鏈接。"

想象一下：你查一個(gè)功能的實(shí)現(xiàn)方式，發(fā)現(xiàn)Confluence A有一份文檔，Confluence B有另一份，內(nèi)容還對(duì)不上。你問(wèn)同事，同事說(shuō)"以B為準(zhǔn)"，但B的最后更新日期是半年前。這種場(chǎng)景重復(fù)一百次，8000頁(yè)文檔的信任度就歸零了。

從"各掃門(mén)前雪"到"公司級(jí)知識(shí)庫(kù)"

現(xiàn)在CDPR終于換了打法。Fulneczek說(shuō)得很直接："未來(lái)對(duì)我們來(lái)說(shuō)真的很光明。我們吸取了教訓(xùn)。"

核心變化有幾個(gè)：

第一，重新定義"完成"。以前項(xiàng)目 milestone 過(guò)了就過(guò)了，文檔愛(ài)寫(xiě)不寫(xiě)。現(xiàn)在每個(gè)開(kāi)發(fā)階段結(jié)束都有個(gè)" gate "（關(guān)卡），過(guò)關(guān)條件之一就是文檔必須到位。不是可選任務(wù)，是硬性要求。

第二，打破團(tuán)隊(duì)壁壘。Ruciński解釋："與過(guò)去不同，現(xiàn)在、今天，我們的知識(shí)不會(huì)被鎖定在特定團(tuán)隊(duì)的權(quán)限后面。它是一種共享資產(chǎn)。"

具體什么意思？假設(shè)《巫師4》團(tuán)隊(duì)解決了一個(gè)技術(shù)難題——比如某種開(kāi)放世界植被渲染的優(yōu)化方案。以前這個(gè)方案可能只存在那個(gè)程序員的本地文件夾里，或者某個(gè)小團(tuán)隊(duì)的私有Confluence空間里。現(xiàn)在，這個(gè)方案會(huì)被記錄進(jìn)公司級(jí)知識(shí)庫(kù)，《賽博朋克2》團(tuán)隊(duì)也能看到、能借用、能根據(jù)自己的需求修改。

Ruciński算過(guò)賬："問(wèn)題不會(huì)被不同團(tuán)隊(duì)重復(fù)解決，而且如果某個(gè)項(xiàng)目取得突破，整個(gè)公司都能受益。"

這話聽(tīng)著像企業(yè)管理的陳詞濫調(diào)，但在游戲開(kāi)發(fā)這種創(chuàng)意+技術(shù)高度混雜的行業(yè)里，確實(shí)能省大量成本。兩個(gè)項(xiàng)目并行開(kāi)發(fā)，意味著兩撥人可能卡在同一個(gè)技術(shù)坑上。以前各自爬坑，現(xiàn)在前面的人插個(gè)路標(biāo)，后面的人繞道走。

一個(gè)讓人既安心又焦慮的事實(shí)

聊完CDPR的文檔進(jìn)化史，有個(gè)念頭一直繞在我腦子里：

他們以前那么混亂，居然還能做出《巫師3》和《賽博朋克2077》（發(fā)售災(zāi)難 notwithstanding，最終銷(xiāo)量和口碑都翻盤(pán)了）。

這說(shuō)明什么？說(shuō)明3A游戲開(kāi)發(fā)某種程度上是靠人堆出來(lái)的。靠核心成員的記憶力、靠關(guān)鍵時(shí)刻的加班、靠發(fā)行前的瘋狂救火。CDPR的"波蘭蠢驢"外號(hào)，一半是自嘲工作強(qiáng)度，一半也是這種土法煉鋼模式的寫(xiě)照。

但這也意味著，如果文檔體系真的理順了，同樣的團(tuán)隊(duì)能做出什么？

《巫師4》2024年11月進(jìn)入全面制作階段，目前沒(méi)有發(fā)售日期。《賽博朋克2》截至2025年5月還處于預(yù)制作階段，但兩個(gè)項(xiàng)目的團(tuán)隊(duì)規(guī)模都在擴(kuò)張。Fulneczek說(shuō)的"未來(lái)光明"，可能不只是場(chǎng)面話——至少?gòu)墓こ坦芾淼慕嵌龋麄兘K于站在了一個(gè)更扎實(shí)的基礎(chǔ)上。

最后說(shuō)點(diǎn)玩家視角的

作為玩家，我其實(shí)不太關(guān)心廠商內(nèi)部用Confluence還是Notion、文檔寫(xiě)8000頁(yè)還是80頁(yè)。但這件事有個(gè)有趣的側(cè)面：它解釋了為什么有些游戲的重制/續(xù)作感覺(jué)"對(duì)味"，有些就明顯跑偏。

知識(shí)傳承斷裂，游戲的精神內(nèi)核就容易丟。《巫師1》重制如果能從原版團(tuán)隊(duì)那里拿到完整的設(shè)計(jì)文檔、技術(shù)方案、甚至當(dāng)時(shí)的棄用創(chuàng)意，成品和"對(duì)著成品反推"做出來(lái)的東西，大概率是不一樣的。

CDPR現(xiàn)在做的，本質(zhì)上是在給自己買(mǎi)保險(xiǎn)：萬(wàn)一《巫師4》或《賽博朋克2》十年后也要重制，至少下一波開(kāi)發(fā)者不用從零開(kāi)始考古。

至于這些改進(jìn)能不能真的反映在最終游戲質(zhì)量上——2025年或者2026年，我們應(yīng)該能看到答案。