create-serena-memory-for-component
为任意组件或模块创建/更新 Serena memory 的工作流与格式规范。用于用户要求“源码级梳理并写入 Serena memory”的场景，例如“对 X 进行源码级梳理并写入 Y.md”，或者“分析 X 并生成Serena memory”。适用于组件类/接口名或模块名（如 O
Open source Repository Open in the app JSON README (API)
About
为任意组件或模块创建/更新 Serena memory 的工作流与格式规范。用于用户要求“源码级梳理并写入 Serena memory”的场景，例如“对 X 进行源码级梳理并写入 Y.md”，或者“分析 X 并生成Serena memory”。适用于组件类/接口名或模块名（如 OACModule_*），并要求输出包含概述/职责/涉及文件/架构/依赖/注意事项/调用方等章节。
Details
- Kind
- Agent skills
- Topic
- AI, RAG & memory
- Publisher
- hzqst
- Origin
- majiayu
- Category
- ferramentas
- Stars
- 252
- Forks
- 47
- Last push
- 2026-09-09T16:00:12Z
- Repository state
- ativo
- Language
- C++
- License
- MIT
- Added
- 2026-09-02 18:12:10
- Updated
- 2026-09-02 18:12:10
- Origin id
hzqst/metahooksv/development/create-serena-memory-for-component@main
README
# MetaHookSv This is a porting of [MetaHook](https://github.com/nagist/metahook) for SvEngine (GoldSrc engine modified by Sven Co-op Team), as a client-side modding framework, Mainly to keep you a good game experience in Sven Co-op or any other GoldSrc based games. Most of plugins are still compatible with vanilla GoldSrc engine. please check each plugin's doc for plugin compatibility. [中文README](READMECN.md) ### Compatibility (metahook loader only) | Engine | | | ---- | ---- | | GoldSrc_blob (3248~4554) | √ | | GoldSrc_legacy (< 6153) | √ | | GoldSrc_new (8684 ~) | √ | | SvEngine (8832 ~) | √ | | GoldSrc_HL25 (>= 9884) | √ | ## Download [GitHub Release](https://github.com/hzqst/MetaHookSv/releases) * `MetaHookSv-windows-x86.zip` for most users. * `MetaHookSv-windows-x86-blob-support.zip` for legacy GoldSrc engine with buildnum < 4554. ## Risk of VAC ? There is no VAC ban reported yet. The binaries or executables of Sven Co-op are not signed with digital signatures thus no integrity check from VAC would be applied for them. ## FAQ 1. Why the game process hangs up / freeze occasionally for few seconds when playing on legacy / pirated version of GoldSrc game ? A: This is because Valve uses `gethostbyname` with an non-existing hostname to query master servers. which is known to block the whole game loop for few seconds if the hostname is not available. You can either add `-nomaster` to launch paramaters to prevent engine from querying invalid hostname or add `-steam` launch paramaters to force engine to use a valid master server source (which probably not gonna work on pirated game). 2. Why the game process hangs up for tens of seconds on exiting / on restarting ? A: This is because ThreadGuard.dll is waiting for Valve's network threads or similiar things to exit before actually exiting the game. See [ThreadGuard](https://github.com/hzqst/MetaHookSv#threadguard) for more details. 3. Why I got black-screen in the main menu? A. The [SDL3-over-SDL2 compatibility layer](https://github.com/libsdl-org/sdl2-compat) is not working well with software-rendering mode. please switch to OpenGL mode by adding `-gl` in the launch parameter. 4. What if game crashes due to out of memory ? Try launch parameter: `-metahook_early_unload_mirrored_dll` (This saves ~120MB system memory) Try ConVars: `r_studio_lazy_load 1`, `r_leaf_lazy_load 1` 5. Why the terrain become all black when `sv_cheats 1` ? Try `r_lightmap 1`. ## One Click Installation (GUI Installer) 1. Download from [GitHub Release](https://github.com/hzqst/MetaHookSv/releases), then unzip it. 2. Run `Build-Output\MetahookInstaller.exe`, and click `install` (or choose the desired game before installing) 3. Launch game from either the generated shortcut `MetaHook for SvenCoop.lnk` or Steam game library. * Run `MetaHook for [GameName].lnk` for games other than Sven Co-op. * Other games follow the same instruction, don't forget to choose the desired game before installing. ## One Click Installation (Windows batch script) 1. Download from [GitHub Release](https://github.com/hzqst/MetaHookSv/releases), then unzip it. 2. Run `scripts\install-to-SvenCoop.bat` (or `scripts\install-to-(WhateverGameYouWant).bat`, depends on which you are going to play) 3. Launch game from either the generated shortcut `MetaHook for SvenCoop.lnk` * Run `MetaHook for [GameName].lnk` for games other than Sven Co-op. * Other games follow the same instruction. * You should have your Steam running and own the game in your game library otherwise the [SteamAppsLocation](toolsrc/README.md) will probably not going to find GameInstallDir. ## Manual Installation 1. Download from [GitHub Release](https://github.com/hzqst/MetaHookSv/releases), then unzip it. 2. All required executable and resource files are in `Build` folder, copy [whatever you want](Build/README.md) to `\SteamLibrary\steamapps\common\Sven Co-op\`. 3. Go to `\SteamLibrary\steamapps\common\Sven Co-op\svencoop\metahook\configs\`, rename `plugin_svencoop.lst` (or `plugin_goldsrc.lst`) to `plugin.lst` (depending on the engine you are going to run) 4. Rename `MetaHook.exe` to `(ModDirectory).exe`, Let's say `svencoop.exe` for Sven Co-op. or `cstrike.exe` for Counter-Strike. * Use `MetaHook_blob.exe` instead of `MetaHook.exe` if you are on a legacy GoldSrc engine with buildnum < 4554. * Plugins can be disabled or enabled in `\SteamLibrary\steamapps\common\Sven Co-op\svencoop\metahook\configs\plugins.lst` * The `Build/SDL3.dll` is for full IME candidates support as SDL2 does not pust IME candidate events to engine at all. * The `Build/SDL3.dll` is loaded by [SDL3-over-SDL2 compatibility layer](https://github.com/libsdl-org/sdl2-compat), which means you will have to overwrite SDL2.dll with `Build/SDL2.dll` to get SDL3 working properly. ## Build Requirements 1. [Visual Studio 2022, with vc143 toolset](https://visualstudio.microsoft.com/) 2. [CMake](https://cmake.org/download/) 3. [Git for Windows](https://gitforwindows.org/) ## Build Instruction Let's assume that you have all requirements installed correctly. 1. `git clone --recursive https://github.com/hzqst/MetaHookSv` to somewhere that doesn't contain space in the directory path. 2. Run `scripts\build-MetaHook.bat`, wait for metahook exe to generate. The generated exe should be under `Build` if no error(s) occurs. 3. Run `scripts\build-Plugins.bat`, wait for all plugins to generate. All generated dlls should be under `Build\svencoop\metahook\plugins\` if no error(s) occurs. ## Debugging 1. `git clone --recursive https://github.com/hzqst/MetaHookSv` to somewhere that doesn't contain space in the directory path. 2. Run `scripts\debug-SvenCoop.bat` (or `scripts\debug-(WhateverGameYouWant).bat`, depends on which game you are going to debug with) 3. Open `MetaHook.sln` with Visual Studio IDE, set specified project as launch project, compile the project, then press F5 to start debugging. * Other games follow the same instruction. * You should restart Visual Studio IDE to apply changes to debugging profile if Visual Studio IDE was running. ## MetaHook Docs [Docs](docs/MetaHook.md) [中文文档](docs/MetaHookCN.md) ## Plugins ### VGUI2Extension VGUI2Extension acts as a VGUI2 modding framework, providing capability for other plugins to install hooks / patches on VGUI2 components. [DOC](docs/VGUI2Extension.md) [中文文档](docs/VGUI2ExtensionCN.md) ### CaptionMod A plugin that adds closing-captioning, HUD text translatation, HiDpi support and Source2007-style chat dialog to game. [DOC](docs/CaptionMod.md) [中文文档](docs/CaptionModCN.md) ### BulletPhysics A plugin that transform player model into ragdoll when player is dead or being caught by barnacle. [DOC](docs/BulletPhysics.md) [中文文档](docs/BulletPhysicsCN.md) ### MetaRenderer A graphic enhancement plugin that modifiy the original render engine. You can even play with 200k epolys models and still keep a high framerate. [DOC](docs/Renderer.md) [中文文档](docs/RendererCN.md) ### StudioEvents This plugin can block studio-event sound spamming with controllable cvars. [DOC](docs/StudioEvents.md) [中文文档](docs/StudioEventsCN.md) ### SteamScreenshots (Sven Co-op / GoldSrc post-25th update) This plugin intercepts `snapshot` command and replace it with `ISteamScreenshots` interface which will upload the snapshot to Steam Screenshot Manager. ### SCModelDownloader (Sven Co-op only) This plugin downloads missing player models from https://wootguy.github.io/scmodels/ automatically and reload them once mdl files are ready. Cvar : `scmodel_autodownload 0 / 1` Automatically download missing model from scmodel database. Cvar : `scmodel_downloadlatest 0 / 1` Download latest version of this model if there are multiple ones with different version. ### PrecacheManager This plugin provides a console command `fs_dump_precaches` to dump precache resource list into `[ModDirectory]\maps\[mapname].dump.res`. * The SoundSystem from Sven Co-op uses `soundcache.txt` instead of engine's precache system to precache sound files. ### ThreadGuard This plugin intercepts Valve's Win32Thread creation and wait for all threads to exit before unloading the backed module, in case Valve's thread code gets running when the backed module is unloaded. Managed modules that may create new threads and quit without waiting for thread termination : `hw.dll`, `GameUI.dll`, `ServerBrowser.dll` ### ResourceReplacer This plugin replaces in-game resources (mainly model and sound files) at runtime with customizable replace list files without actually manipulating the files, just like what Sven Co-op does with [gmr](https://wiki.svencoop.com/Mapping/Model_Replacement_Guide) and [gsr](https://wiki.svencoop.com/Mapping/Sound_Replacement_Guide) files. [DOC](docs/ResourceReplacer.md) [中文文档](docs/ResourceReplacerCN.md) ### SCCameraFix (Sven Co-op only) This plugin fixes camera glitching in spectator-view for Sven Co-op. The updated spectator-view code credits to [halflife-updated](https://github.com/SamVanheer/halflife-updated) ### Better Spray (Sven Co-op / GoldSrc post-25th update) BetterSpray is a plugin for MetaHookSV that enhances Sven Co-op and GoldSrc’s spray system with support for high-res images, dynamic reloading and cloud sharing. https://github.com/hzqst/BetterSpray ### ABCEnchance (third-party) (Sven Co-op only) ABCEnchance is a metahook plugin that provides experience improvement for Sven co-op. 1. CSGO style health and ammo HUD 2. Annular weapon menu 3. Dynamic damage indicator 4. Dynamic crosshair 5. Minimap which is rendered at real time 6. Teammate health, armor and name display with floattext. 7. Some useless blood efx https://github.com/DrAbcrealone/ABCEnchance ### HUDColor (third-party) (Sven Co-op only) Changing HUD colors in game. Also as a good template for you to build your own plugin. https://github.com/hzqst/HUDColor ### MetaAudio (third-party) (GoldSrc only) This is a plugin for GoldSrc that adds OpenAL support to its sound system. This fork fixes some bugs and uses Alure instead of OpenAL directly for easier source management. Since SvEngine uses FMOD as it's sound system, you really shouldn't use this plugin in Sven Co-op. https://github.com/LAGonauta/MetaAudio * MetaAudio blocks goldsrc engine's sound system and replaces with it's own sound engine. You should always put `MetaAudio.dll` on top of any other plugins that rely on goldsrc engine's sound system (i.e CaptionMod) in the `plugins.lst` to prevent those plugins from being blocked by MetaAudio. ### Trinity-EngineSv (third-party) (GoldSrc only) This is a Trinity Engine porting for Counter Strike 1.6 Client-Side part of the mod it´s introduced as a metahook plugin. Server-Side part of the mod it´s done with a modifidied reGame dll. https://github.com/ollerjoaco/Trinity-EngineSv ### Better Spray (third-party) BetterSpray is a plugin for MetaHookSV that enhances Sven Co-op’s spray system with support for multiple images, true aspect ratios, and dynamic reloading. https://github.com/KazamiiSC/BetterSpray-Sven-Coop