> For the complete documentation index, see [llms.txt](https://ak-scripts.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ak-scripts.gitbook.io/docs/yi-lai/markdown/jie-shao.md).

# 介绍

## 🎮 **ak-lib · 通用 UI & 工具框架**

> 💠 **版本：** `1.0.5` 
>
> 👨‍💻 **作者：**`阿𝐊`\
> 🧩 **支持框架：** `ESX` / `QBCore` / `QBX` / `OX` / `Standalone`\
> 💎 **设计风格：** `Glass/Solid/Hybrid`（三种风格UI）

### 🧭 **概述**

**`ak-lib`** 是一款专为 **FiveM 生态** 打造的 **通用 UI 与工具框架**。\
它为开发者与服务器提供 **八大核心 UI 模块** ，**九大功能模块** 与 **完整交互体系**，\
在性能与美学之间，找到最佳平衡。

> “让每一个交互，都有设计感；\
>   让每一个插件，都有灵魂。”

### 🧩 核心模块

<table><thead><tr><th width="184.5556640625">模块</th><th width="190.33349609375">功能</th><th>特色</th></tr></thead><tbody><tr><td>🔔 <strong>Notify</strong></td><td>通知系统</td><td>动态堆叠 · 时长配置 · 音效控制</td></tr><tr><td>🪧 <strong>TextUI</strong></td><td>屏幕提示</td><td>键位提示 · 自动隐藏 · 图标支持</td></tr><tr><td>⏳ <strong>Progress</strong></td><td>进度条系统</td><td>条形/圆形动画 · 道具绑定 · 可取消</td></tr><tr><td>📋 <strong>Menu</strong></td><td>菜单系统</td><td>鼠标/键盘操作 · 多层菜单 · 模块化结构</td></tr><tr><td>✍️ <strong>Input</strong></td><td>输入系统</td><td>表单验证 · 多字段输入 · 下拉框</td></tr><tr><td>💬 <strong>Dialog</strong></td><td>对话系统</td><td>确认/取消 · 超时回调 · 队列机制</td></tr><tr><td>🎯 <strong>Skillbar</strong></td><td>技能条系统</td><td>难度控制 · 成功判定 · 多轮挑战</td></tr><tr><td>🧭 <strong>Radial</strong></td><td>环形菜单</td><td>快捷键 · 动态菜单 · 队列显示</td></tr></tbody></table>

#### ⚙️ 功能类模块（9 个）

<table><thead><tr><th width="200">模块</th><th width="142">功能</th><th>特色</th></tr></thead><tbody><tr><td>🌉 <strong>Framework</strong></td><td>框架桥接</td><td>ESX/QBCore/QBX/OX 统一接口 · 自动检测</td></tr><tr><td>🔄 <strong>Callback</strong></td><td>回调/RPC 系统</td><td>客户端-服务端通信 · 多返回值 · 超时处理 · 错误处理</td></tr><tr><td>⏱️ <strong>Cooldown/Throttle</strong></td><td>冷却节流</td><td>操作冷却时间 · 频率限制 · 自动清理 · 调试统计</td></tr><tr><td>🔒 <strong>State</strong></td><td>状态锁定</td><td>玩家状态管理 · 多锁支持 · 服务端同步 · 自动清理</td></tr><tr><td>🎯 <strong>Target</strong></td><td>交互目标</td><td>ox_target/qb-target 统一接口 · 实体/模型/区域支持</td></tr><tr><td>📦 <strong>Inventory</strong></td><td>库存系统</td><td>多库存系统桥接 · 统一操作接口 · 自动检测</td></tr><tr><td>🌐 <strong>Locales</strong></td><td>本地化</td><td>自动扫描依赖资源 · 嵌套 key 支持 · 热加载</td></tr><tr><td>📝 <strong>Debug/Logger</strong></td><td>日志系统</td><td>统一日志格式 · 多级别日志 · 检测信息收集</td></tr><tr><td>⚙️ <strong>Settings</strong></td><td>设置系统</td><td>玩家自定义配置 · UI 风格切换 · 偏好保存</td></tr></tbody></table>

### ⚙️ **特点**

<table><thead><tr><th width="250.4444580078125">类别</th><th>描述</th></tr></thead><tbody><tr><td>⚡ <strong>极致性能优化</strong></td><td>前端帧占用低于 <strong><code>0.01ms</code></strong>，几乎零延迟交互</td></tr><tr><td>🎨 <strong>统一视觉体系</strong></td><td><code>Glass/Solid/Hybrid</code> （三种风格UI）</td></tr><tr><td>🧩 <strong>模块化架构</strong></td><td>任意模块可单独启用或禁用</td></tr><tr><td>🌏 <strong>多语言支持</strong></td><td>支持 <strong><code>zh-CN</code> / <code>en</code></strong>  等语言(你可以随意添加你的语言)</td></tr><tr><td>🔊 <strong>音效反馈系统</strong></td><td>可自定义不同模块的音效与触发规则</td></tr><tr><td>🧠 <strong>框架支持</strong></td><td>本脚本是独立运行的高度自定义UI库</td></tr><tr><td>🔧 <strong>集中化配置</strong></td><td>所有参数统一于 <code>config.lua</code> 管理</td></tr><tr><td>🧱 <strong>跨资源兼容</strong></td><td>可独立运行，也可为任意脚本提供 UI 能力</td></tr></tbody></table>

### 🧠 **作者寄语**

> “**`ak-lib`** 是所有插件的灵魂底座。\
> 它让通知、进度、菜单不再只是功能，而是一种体验。\
> 希望每个服务器，都能拥有属于自己的灵魂与温度。”

### 📜 **作者信息**

| 项目              | 信息                                          |
| --------------- | ------------------------------------------- |
| 👨‍💻 **作者**    | 阿𝐊                                         |
| 📧 **邮箱**       | [335214456@qq.com](mailto:undefined)        |
| 💬 **QQ交流群**    | [711172225](https://qm.qq.com/q/SCLEZvqlWw) |
| 🛒 **Tebex 商店** | <https://ak-scripts.tebex.io>               |

### 💎 **更多来自 ak-scripts**

> ✨ `ak-lib` 是 `ak-scripts` 全系列插件的基础框架。\
> &#x20;     了解更多原创作品与商业资源，请访问：\
> 🔗 **Tebex 商店**：<https://ak-scripts.tebex.io>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ak-scripts.gitbook.io/docs/yi-lai/markdown/jie-shao.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.