Fivemanage SDK 面向 FiveM 服务器，通过 exports.fmsdk 提供截图、图片上传与集中式日志能力，日志可发送至 Fivemanage 仪表盘。
用途与主要能力：截取玩家客户端或服务端画面的截图，上传已有图片文件或缓冲区，以及按数据集（dataset）发送分级日志。截图相关导出依赖 screenshot-basic。
使用方式：资源文件夹必须命名为 fmsdk，直接放在 resources/ 下，不支持放在分类子文件夹。screenshot-basic 需在 server.cfg 中于 fmsdk 之前 ensure。API 密钥以 ConVar 形式写入 server.cfg（FIVEMANAGE_MEDIA_API_KEY、FIVEMANAGE_LOGS_API_KEY），不要放入 config.json，且仅设置所使用功能对应的密钥。
按场景选择导出：玩家自身客户端截图用 exports.fmsdk:takeImage({ ... })；从服务端截取某玩家画面用 exports.fmsdk:takeServerImage(playerSource, { ... })；上传已有图片用 exports.fmsdk:uploadImage(buffer, { ... })。日志方面，exports.fmsdk:Log(dataset, level, message, metadata) 用于指定级别，Info/Warn/Error(dataset, message, metadata) 为固定级别简写，LogMessage 为旧版接口。takeImage 属于客户端侧，takeServerImage 与 uploadImage 属于服务端侧。metadata 中应包含 playerSource / targetSource，以便 SDK 自动附加玩家标识，也可加入 name、description 便于检索。建议按关注点划分数据集，如 economy、anticheat、admin_actions。可在 fmsdk 的 config.json 中启用自动事件日志。切勿将 API 令牌暴露给 NUI，客户端上传应使用预签名 URL。
适用场景：需要为 FiveM 服务器统一收集玩家截图与日志、并在仪表盘检索的运维或反作弊场景。
限制：安装顺序、文件夹命名和密钥位置有硬性要求，放错位置或顺序会导致功能不可用；令牌不得进入前端；官方文档见 https://docs.fivemanage.com/fivem-sdk/installation。