無論是小白還是資深軟件工程師,在工作中接手其他同事寫的項(xiàng)目代碼最怕的就是:
- 新人入職,對(duì)業(yè)務(wù)不熟悉,團(tuán)隊(duì)也沒有技術(shù)沉淀,來什么活就干什么活,混一天是一天屎山代碼,只有它的鼻祖才知道怎么維護(hù)和增加功能需求又來了,產(chǎn)品、項(xiàng)目經(jīng)理既要、又要、也要,巴不得你明天就把活搞定,后天就能順利上線突然接手代碼,馬上讓你解BUG,對(duì)于小白而言一臉懵逼,不知道從何處下手,就算是來一個(gè)資深的大佬、技術(shù)專家、架構(gòu)師,短時(shí)間也無能為力等等
以上這些應(yīng)該就是大部分做開發(fā)的朋友們?nèi)粘C媾R的難題以及常態(tài);這些可能也就是導(dǎo)致如今為啥總是996、007的常態(tài)而不能真正的好好生活的原因之一吧!不過,隨著AI時(shí)代的來臨,有需求,就有跨時(shí)代產(chǎn)品的誕生!deepwiki
它來了:
https://github.com/AsyncFuncAI/deepwiki-open
deepwiki
是由Cognition Labs推出的一款 AI 驅(qū)動(dòng)的開源工具,旨在幫助開發(fā)者快速理解GitHub上的代碼倉(cāng)庫(kù)。它通過分析代碼、README和配置文件,自動(dòng)生成結(jié)構(gòu)化的文檔和交互式圖表,并提供對(duì)話式AI助手,幫助開發(fā)者快速理解項(xiàng)目結(jié)構(gòu)和邏輯,在deepwiki
官網(wǎng)上已經(jīng)有許多生成好的代碼倉(cāng)庫(kù)wiki:
https://deepwiki.com/
不過,目前 deepwiki 僅支持開源項(xiàng)目的生成,如果想要支持私有部署,則需要付一定的費(fèi)用來支持,具體可以了解下 deepwiki 官方 API 的定價(jià)。
一 、deepwiki核心功能
- 自動(dòng)生成結(jié)構(gòu)化文檔
DeepWiki 能自動(dòng)將 GitHub 倉(cāng)庫(kù)轉(zhuǎn)化為類似維基百科的文檔頁(yè)面,包含項(xiàng)目目標(biāo)、核心模塊、依賴關(guān)系圖等。通過分析代碼邏輯,生成通俗易懂的說明,適合新手和資深開發(fā)者。
- 對(duì)話式 AI 助手
用戶可以通過自然語(yǔ)言向deepwiki
提問,例如"如何實(shí)現(xiàn)用戶鑒權(quán)?"或"解釋MVC架構(gòu)",AI 會(huì)基于代碼分析給出精準(zhǔn)解答。支持中文等語(yǔ)言對(duì)話,增強(qiáng)全球開發(fā)者的使用體驗(yàn)。
- 交互式圖表
自動(dòng)生成可點(diǎn)擊的交互式圖示,包括類層次結(jié)構(gòu)、依賴關(guān)系圖和工作流程圖,用戶可以放大縮小,自由探索各模塊之間的關(guān)聯(lián)。
- 深度研究模式
面向高階用戶,deepWiki
支持運(yùn)行高級(jí)分析任務(wù),如檢測(cè)潛在漏洞、建議優(yōu)化方向,或?qū)?dāng)前倉(cāng)庫(kù)與其他倉(cāng)庫(kù)進(jìn)行對(duì)比分析
二、deepwiki實(shí)戰(zhàn)
以我自己前一兩年開源的項(xiàng)目為例:QT-Sensor
https://github.com/Yangyuanxin/QT-Sensor
操作手法:
即可得到如下網(wǎng)頁(yè):
以下是生成的wiki項(xiàng)目鏈接:
https://deepwiki.com/Yangyuanxin/QT-Sensor
這簡(jiǎn)直寫得太好了!圖文并茂,比我們自己想的和考慮的還要周全!以后,即使沒有代碼,想要了解項(xiàng)目的架構(gòu)、代碼邏輯實(shí)現(xiàn)等將不再是難事!快來試試吧!閱讀原文,跳轉(zhuǎn)到該項(xiàng)目的wiki瀏覽觀摩學(xué)習(xí)下!