桌面應(yīng)用數(shù)據(jù)分析數(shù)據(jù)可視化【免費(fèi)下載鏈接】cs-demo-managerCompanion application for your Counter-Strike demos.項(xiàng)目地址https://gitcode.com/gh_mirrors/cs/cs-demo-manager點(diǎn)擊查看免費(fèi)下載AGENTS.md是 CS Demo Manager 倉庫面向開發(fā)者包括人類與 AI Agent的入門指南它濃縮了這個(gè)跨平臺 Electron 桌面應(yīng)用的技術(shù)選型、開發(fā)命令、進(jìn)程架構(gòu)、目錄組織與編碼約定。本文以此文檔為骨架結(jié)合倉庫內(nèi)真實(shí)的源碼、配置與腳本逐節(jié)展開解讀——讀完你可以快速定位代碼應(yīng)該寫在哪、用什么命令構(gòu)建與測試、如何遵循既有規(guī)范提交高質(zhì)量的改動。項(xiàng)目定位為 Counter-Strike 錄像而生CS Demo Manager 是一個(gè)跨平臺Windows / macOS / Linux的 Electron 桌面應(yīng)用與 CLI 工具專門用于分析Counter-StrikeCS2 / CS:GO的 demo 錄像文件。核心工作流是解析 demo → 將數(shù)據(jù)存入數(shù)據(jù)庫 → 呈現(xiàn)與分析。按 AGENTS.md 的描述它的功能面覆蓋了玩家日常復(fù)盤與分析的全部環(huán)節(jié)數(shù)據(jù)統(tǒng)計(jì)比賽、玩家、戰(zhàn)隊(duì)維度的統(tǒng)計(jì)配合圖表ECharts可視化復(fù)盤能力2D 回合回放視圖round viewer、熱力圖heatmaps錄像與導(dǎo)出視頻生成、從 Valve 與第三方平臺下載 demo、XLSX / JSON 導(dǎo)出衍生功能封禁追蹤ban tracking、語音音頻提取等。這一點(diǎn)也能在 package.json 的元數(shù)據(jù)中得到印證——項(xiàng)目自述為Companion application for your Counter-Strike demos關(guān)鍵詞包括CS2、CS:GO、electron、react當(dāng)前倉庫版本為3.20.1。注意文檔中提及的 Counter-Strike 插件位于倉庫頂層cs2-server-plugin/與csgo-server-plugin/C 實(shí)現(xiàn)它們是控制游戲進(jìn)程的插件部分與分析器本身相互獨(dú)立。技術(shù)棧全景一次看懂誰負(fù)責(zé)什么AGENTS.md 的Stack一節(jié)開宗明義地給出了一條最重要的工程約定本項(xiàng)目使用 Vitevp。所有依賴管理與腳本執(zhí)行都必須使用vp而非pnpm且vpCLI 需要預(yù)先安裝。這一點(diǎn)在 package.json 中可以看到vite-plus以1.0.0版本列入 devDependencies而pnpm12.6.0僅作為packageManager聲明出現(xiàn)——vp是實(shí)際的前端工程化入口。整個(gè)技術(shù)棧可以按層拆解層次技術(shù)選型承擔(dān)職責(zé)桌面框架Electron44.5.1主進(jìn)程、窗口、托盤、自動更新語言TypeScript應(yīng)用與 CLI、C插件與原生 Node addon類型安全 高性能橋接UIReact 19、Redux Toolkit、React Router、Tailwind CSS 4、ECharts、Motion渲染進(jìn)程界面后端PostgreSQLpgkysely、WebSocketws數(shù)據(jù)持久化與進(jìn)程通信數(shù)據(jù)庫形態(tài)內(nèi)置捆綁 PostgreSQL由 server daemon 啟動也支持外部模式連接已有庫零配置開箱 靈活部署i18nLinguiJS Crowdin多語言Lintoxlint linter/目錄中的自定義規(guī)則靜態(tài)檢查測試Vitest經(jīng)vite-plus/test引入單元測試構(gòu)建Vite、esbuild、electron-builder打包分發(fā)CS 生態(tài)akiver/cs-demo-analyzerdemo 解析、akiver/csgo-voice-extractor、csgo-protobuf、csgo-sharecodeCounter-Strike 專用能力其中與 Counter-Strike 深度相關(guān)的庫值得一提akiver/cs-demo-analyzer承擔(dān) demo 二進(jìn)制解析csgo-protobuf用于解碼比賽信息 protobuf 消息可在 valve-match 模塊 看到實(shí)際應(yīng)用csgo-sharecode負(fù)責(zé) sharecode 解析這些直接支撐了Valve 比賽拉取與demo 分析兩大核心鏈路。常用命令開發(fā)、構(gòu)建與質(zhì)量檢查AGENTS.md 按用途把命令分成了三類以下逐一對應(yīng) package.json 中的 scripts 說明其真實(shí)行為。開發(fā)Development命令作用對應(yīng)腳本實(shí)現(xiàn)vp run dev以熱重載方式啟動 Electron 應(yīng)用執(zhí)行node ./scripts/develop.mjsvp run dev:cli以熱重載方式啟動 CLI執(zhí)行node ./scripts/develop-cli.mjs構(gòu)建Build命令作用vp run build生產(chǎn)構(gòu)建main / server / preload 用 esbuild 打包renderer 用 Vite 打包vp run package先build再用 electron-builder 產(chǎn)出可分發(fā)的安裝包vp run i18n:extract提取可本地化字符串為.po文件供 Crowdin 使用以 build.mjs 為例生產(chǎn)構(gòu)建時(shí)會注入IS_PRODUCTION/IS_DEV等編譯期常量并且一個(gè)值得注意的細(xì)節(jié)是構(gòu)建產(chǎn)物不壓縮標(biāo)識符以保證寫入日志的函數(shù)名可讀、可追溯——這解釋了 AGENTS.md 中l(wèi)ogger 在構(gòu)建期注入的設(shè)計(jì)動機(jī)。另外構(gòu)建流程會檢查CROWDIN_PERSONAL_TOKEN環(huán)境變量未設(shè)置時(shí)跳過翻譯下載、僅包含英文設(shè)置后則通過crowdin download拉取各語言包。代碼質(zhì)量Code quality命令作用vp run compile僅做 TypeScript 類型檢查tsc --noEmit不產(chǎn)出文件vp run lint全項(xiàng)目 lintvp lintvp run lint:fix自動修復(fù) lint 問題vp run format用 oxfmt 格式化代碼vp fmtvp run test運(yùn)行全部測試vp testvp test src/path/to/file.test.ts只跑指定文件的測試vp run test:watch監(jiān)聽模式跑測試vp run deadcode查找死代碼底層是knip提交前的驗(yàn)證工作流Validation workflowAGENTS.md 要求任何改動在提交前必須依次通過以下四步這是保證倉庫質(zhì)量的門禁vp check—— 一次完成 lint、format 與類型檢查在 vite.config.ts 中還可看到 staged 配置*: vp check --fix意味著暫存文件在提交前會自動執(zhí)行 check 并修復(fù)vp run test—— 全部測試通過vp run deadcode—— 不引入未使用的代碼vp run i18n:extract—— 若新增或修改了任何面向用戶的字符串必須執(zhí)行并提交更新后的英文源目錄catalogs。這四步與 package.json 中的腳本一一對應(yīng)構(gòu)成了從類型 → 風(fēng)格 → 行為 → 資源的完整回歸鏈。進(jìn)程架構(gòu)四個(gè)參與者圍繞一個(gè) WebSocket 中樞AGENTS.md 指出應(yīng)用運(yùn)行三個(gè) OS 進(jìn)程main、server、renderer加上一個(gè)可選的 Counter-Strike 客戶端全部通過本地的 WebSocket 服務(wù)器通信。更詳細(xì)的進(jìn)程分工與接線說明記錄在倉庫的 進(jìn)程通信技能文檔 中其拓?fù)淙缦翬lectron main process ←IPC→ Renderer process (UI) Counter-Strike CLI ? ? ? ? └──────────→ WebSocket server process (daemon) ←───┴───────────┘各進(jìn)程的職責(zé)與入口可以整理為一張表進(jìn)程入口職責(zé)electron-mainsrc/electron-main/main.ts窗口管理、托盤、自動更新、IPC 注冊serversrc/server/start-server.tsWebSocket 中樞守護(hù)進(jìn)程將消息分發(fā)給類型化 handler運(yùn)行后臺任務(wù)分析、下載、視頻隊(duì)列renderersrc/ui/renderer.tsxReact UI只通過 WebSocket 客戶端src/ui/web-socket-client.ts通信preloadsrc/preload/preload.ts通過contextBridge把 Node.js API 橋接給渲染進(jìn)程clisrc/cli/cli.ts獨(dú)立 CLI連接已運(yùn)行的 daemon 或自行拉起一個(gè)attach-or-spawn-daemon.ts幾個(gè)值得強(qiáng)調(diào)的架構(gòu)事實(shí)均可在 進(jìn)程通信技能文檔 中找到證據(jù)server 是一個(gè)可脫離 GUI 的獨(dú)立守護(hù)進(jìn)程daemonGUI 與 CLI 通過daemon.json發(fā)現(xiàn)文件共享同一個(gè) daemonattach-or-spawn 機(jī)制當(dāng)沒有任何客戶端連接且無后臺任務(wù)時(shí)daemon 會空閑退出。所有 WebSocket 消息都是{ name, payload?, uuid? }形式的 JSONserver 將入站消息分發(fā)給類型化 handler并以Reply/ReplyError應(yīng)答。所有消息名枚舉與共享類型集中在src/server/messages/。UI 與 CLI 共享推送通道server 的 push 消息會同時(shí)扇出到 renderer 與所有 CLI 客戶端因此 CLI 發(fā)起的任務(wù)進(jìn)度能實(shí)時(shí)出現(xiàn)在 UI 中反之亦然。與 Counter-Strike 的雙向通信游戲啟動時(shí)通過 C 插件cs2-server-plugin/、csgo-server-plugin/連接 WebSocket server插件上報(bào)事件game-client-message-nameserver 也可下發(fā)命令game-server-message-name典型的命令-響應(yīng)通過 src/server/counter-strike.ts 中的sendMessageToGame完成超時(shí)或未連接時(shí)拋出CounterStrikeNotConnected/CounterStrikeNoResponse錯(cuò)誤。目錄結(jié)構(gòu)代碼應(yīng)該放在哪里AGENTS.md 給出了完整的頂層結(jié)構(gòu)結(jié)合倉庫實(shí)際內(nèi)容可以逐項(xiàng)印證cs2-server-plugin/ # C CS2 server plugin用于控制游戲 csgo-server-plugin/ # C CS:GO server plugin用于控制游戲 src/ cli/ # CLI 相關(guān)代碼 common/ # 所有進(jìn)程共享類型、錯(cuò)誤碼…… electron-main/ # 僅 Electron 主進(jìn)程 node/ # 純 Node.js 代碼可用于任何非 renderer 進(jìn)程 database/ # 按實(shí)體組織的 Kysely 查詢matches/、players/、demos/ … embedded/ # 捆綁 PostgreSQL server 的生命周期管理 settings/ # 應(yīng)用設(shè)置相關(guān)代碼 counter-strike/ # CS 進(jìn)程檢測、游戲交互等 video/ # 視頻處理FFmpeg、HLAE、VirtualDub 集成 filesystem/ # 文件系統(tǒng)工具 preload/ # Electron preload 腳本向 renderer 暴露 Node API server/ # WebSocket server 與消息 handlers handlers/ renderer-process/ # 處理來自 UI 的消息 main-process/ # 處理來自 Electron 主進(jìn)程的消息 ui/ # React renderer store/ # Redux 類型化 hooks 與 reducers components/ # 可復(fù)用 UI 組件 shared/ # UI 工具、顏色、元素 ID feature/ # 每個(gè)功能一個(gè)目錄matches、demos、player、match …幾個(gè)從源碼結(jié)構(gòu)可以推斷的組織原則分層清晰、按進(jìn)程隔離common/是唯一可跨進(jìn)程引用的區(qū)域node/則覆蓋所有非 renderer 場景server/只關(guān)心 WebSocket 消息與 handlerui/純前端。例如共享的error-code.ts位于 src/common/error-code.ts正是所有進(jìn)程共享的典型。feature 目錄聚合在 src/ui 下matches/、demos/、player/、match/、settings/等每個(gè)業(yè)務(wù)域一個(gè)目錄每個(gè)目錄內(nèi)再按職責(zé)拆分 hooks、actions、reducer、組件。實(shí)體化數(shù)據(jù)庫訪問src/node/database 下按matches/、players/、demos/、kills/等實(shí)體組織 Kysely 查詢另設(shè) migrations當(dāng)前含 71 個(gè)遷移文件管理 schema 演進(jìn)。編碼約定把規(guī)范寫進(jìn)規(guī)則而非口頭AGENTS.md 明確要求跟隨倉庫既有模式與 lint 規(guī)則絕不修改 lint 配置來繞過規(guī)則。這也是倉庫把部分約束做成自定義 ESLint 規(guī)則的根本原因。導(dǎo)入別名csdm/*指向src/*所有跨目錄導(dǎo)入必須使用csdm/*別名。該別名在 vite.config.ts 的resolve.alias中定義resolve: { alias: { csdm: srcFolderPath, }, },例如從 UI 中引入 server 消息枚舉寫法是import { RendererClientMessageName } from csdm/server/messages/renderer-client-message-name而不是相對路徑的長串../../../。Styling以 Tailwind 為主、token 為準(zhǔn)組件樣式一律使用Tailwind utility class內(nèi)聯(lián)樣式僅用于動態(tài)值設(shè)計(jì) token 定義在 src/ui/styles/variables.css絕大多數(shù) Tailwind 默認(rèn)值在該文件中被清空只保留項(xiàng)目 token間距、文字、顏色嚴(yán)禁使用p-[7px]這類任意值——項(xiàng)目中不存在這些默認(rèn)工具類。配合 vite.config.ts 中better-tailwindcss/*系列規(guī)則enforce-consistent-class-order、no-duplicate-classes、no-unknown-classes等Tailwind 類名的書寫順序與合法性都在 lint 階段被強(qiáng)制。State managementRedux Toolkit 類型化 hooks全局狀態(tài)使用Redux Toolkit簡單局部狀態(tài)用 React 的useState/useReducer禁止引入新的狀態(tài)管理庫useDispatch與useSelector必須從項(xiàng)目內(nèi)類型化封裝導(dǎo)入而不是直接從react-redux導(dǎo)入。這一約定不僅是文檔要求更被做成了強(qiáng)制 lint 規(guī)則自定義規(guī)則 linter/no-react-redux-import.ts 會攔截react-redux中的useDispatch/useSelector/useStore導(dǎo)入并自動修復(fù)為csdm/ui/store/use-dispatch、csdm/ui/store/use-selector、csdm/ui/store/use-store。類型化封裝的實(shí)際實(shí)現(xiàn)見 src/ui/store/use-dispatch.ts基于useDispatchRedux.withTypesAppDispatch()與 src/ui/store/use-selector.ts基于useSelectorRedux.withTypesRootState()。Logging用全局logger禁止consoleAGENTS.md 規(guī)定使用全局logger一個(gè)自定義ILogger實(shí)例寫入日志文件替代console。兩點(diǎn)關(guān)鍵機(jī)制no-console規(guī)則在整個(gè)項(xiàng)目生效唯一例外是src/cli/CLI 直接面向終端輸出logger在構(gòu)建期注入所有文件無需 import 即可使用——這正是 vite.config.ts 中 lintglobals聲明logger: readonly、以及構(gòu)建時(shí)注入常量的原因。logger 的實(shí)體實(shí)現(xiàn)位于 src/node/logger.ts。Testing與源碼同目錄共置目前只有單元測試集成/E2E 測試留待后續(xù)測試文件與被測源碼同目錄共置命名為*.test.ts必須從vite-plus/test導(dǎo)入describe與it而不是直接從vitest導(dǎo)入。這一點(diǎn)與vp test src/path/to/file.test.ts的命令設(shè)計(jì)一致倉庫中如 exit-daemon.test.ts、attach-or-spawn-daemon.test.ts、sort-sequences-by-start-tick.test.ts 都遵循就近共置的約定。i18nLinguiJS 雙目錄 Crowdin 托管應(yīng)用使用LinguiJS本地化源字符串用英文書寫通過vp run i18n:extract提取到各語言的 catalogrenderer 進(jìn)程的 catalog 為src/ui/translations/{locale}/messages.po主進(jìn)程的 catalog 為src/electron-main/translations/{locale}/*.json主進(jìn)程使用獨(dú)立的 src/electron-main/lingui.config.ts采用 JSON catalog只有英文源目錄en/messages.po與en/messages.json會被提交其余語言在 Crowdin 上管理、構(gòu)建期下載因此被 gitignore 且永不手動提交本地/開發(fā)構(gòu)建若沒有CROWDIN_PERSONAL_TOKEN則跳過翻譯下載、運(yùn)行時(shí)回退英文添加或修改字符串時(shí)只提交英文源絕不手工翻譯.po/.json。多語言行為由根目錄 lingui.config.ts 定義共 9 種語言en、fr、es、pt-BR、zh-CN、zh-TW、de、ru、slsourceLocale為encatalog 指向src/ui/translations/{locale}/messages。UI 側(cè)還有一整套宏使用規(guī)范詳見 i18n 技能文檔優(yōu)先使用編譯期宏lingui/react/macro下的Trans、useLingui、Plural等而非運(yùn)行時(shí)組件——這條同樣被做成了強(qiáng)制 lint 規(guī)則 linter/lingui-js-usage.ts該規(guī)則禁止從lingui/react導(dǎo)入除I18nProvider之外的任何成員并自動將導(dǎo)入源改寫為lingui/react/macro消息保持簡單避免復(fù)雜表達(dá)式它們會被占位符替代非 JSX 場景屬性、alert、函數(shù)參數(shù)用useLingui的t宏數(shù)組/對象中定義消息用msg宏數(shù)量相關(guān)的文案用Plural宏_N語法處理精確數(shù)字匹配日期用useFormatDatehook數(shù)字用Intl.NumberFormat配合當(dāng)前 locale顯式id只在src/electron-main/中使用renderer 內(nèi)嚴(yán)禁手寫 ID由宏自動生成。Git commits約定式提交提交信息使用Conventional Commits格式type(scope): description例如feat(demos): add tickrate column in table。另外明確要求不要把 AI 工具添加為 co-author。小結(jié)一份可執(zhí)行的倉庫規(guī)范回看 AGENTS.md它的價(jià)值不在于羅列規(guī)則而在于每條規(guī)范都能在倉庫中找到對應(yīng)實(shí)現(xiàn)說用vp別用pnpm因?yàn)?package.json 的 scripts 全部經(jīng)由vp或node ./scripts/*.mjs驅(qū)動說別從react-redux直接導(dǎo)入 hooks因?yàn)橛?linter/no-react-redux-import.ts 在 lint 階段強(qiáng)制說別用lingui/react運(yùn)行時(shí)組件因?yàn)橛?linter/lingui-js-usage.ts 自動修復(fù)導(dǎo)入說別用console、用全局logger因?yàn)?vite.config.ts 在構(gòu)建期注入logger且no-console全局生效僅src/cli/豁免說四條提交流程驗(yàn)證因?yàn)関p check、vp test、vp run deadcode、vp run i18n:extract分別對應(yīng)vp check、vp test、knip、lingui extract的真實(shí)腳本。對于想要為這個(gè)項(xiàng)目貢獻(xiàn)代碼或接入其開發(fā)流程的開發(fā)者來說按本文梳理的順序——先理解技術(shù)棧與進(jìn)程架構(gòu)再熟悉命令與目錄最后遵守編碼約定并走完驗(yàn)證工作流——就能以最低成本進(jìn)入一個(gè)高度工程化、規(guī)范即規(guī)則的 TypeScript / Electron / React 代碼庫。贊分享桌面應(yīng)用數(shù)據(jù)分析數(shù)據(jù)可視化【免費(fèi)下載鏈接】cs-demo-managerCompanion application for your Counter-Strike demos.項(xiàng)目地址https://gitcode.com/gh_mirrors/cs/cs-demo-manager點(diǎn)擊查看免費(fèi)下載相關(guān)推薦SkyPilot 開發(fā)者指南從倉庫結(jié)構(gòu)、工程規(guī)范到架構(gòu)模式與提交流程SkyPilot 開發(fā)者指南從倉庫結(jié)構(gòu)、工程規(guī)范到架構(gòu)模式與提交流程 本指南以 SkyPilot 代碼庫中的 CLAUDE.md 開發(fā)文檔為骨架面向在 Sk后端任務(wù)調(diào)度MLOps集群管理mise 倉庫貢獻(xiàn)者開發(fā)指南從 mbx 構(gòu)建緩存、registry 提交流程到源碼架構(gòu)的完整解讀mise 倉庫貢獻(xiàn)者開發(fā)指南從 mbx 構(gòu)建緩存、registry 提交流程到源碼架構(gòu)的完整解讀 mise 是一個(gè)用 Rust 編寫、用于管理開發(fā)環(huán)境、工具版開發(fā)工具CLIInfisical 倉庫工程指南從 Monorepo 架構(gòu)到全棧功能開發(fā)的 CLAUDE.md 權(quán)威解讀Infisical 倉庫工程指南從 Monorepo 架構(gòu)到全棧功能開發(fā)的 CLAUDE.md 權(quán)威解讀 Infisical 是一個(gè)開源的密鑰、證書與特權(quán)訪問后端前端密鑰管理應(yīng)用安全認(rèn)證鑒權(quán)上一篇抖音無水印下載神器3分鐘搞定批量下載的終極秘籍下一篇如何一鍵獲取八大網(wǎng)盤直鏈下載地址完整免費(fèi)指南創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考