Agency Phone v2：新功能、新应用及性能提升

v2 新增了什么

Agency Phone v2 represents the biggest update since the original launch. Based on extensive community feedback and months of development, this release brings a completely redesigned interface, new applications, deeper framework integration, and further performance improvements. Every aspect of the phone has been refined to deliver a more immersive and polished experience for players.

重新设计的用户界面

v2界面采用现代玻璃拟态设计语言，动画更流畅，视觉层次更清晰。主屏幕现在支持可定制壁纸和应用图标排列，允许玩家个性化手机。通知系统完全重构，新增通知中心，按应用分组提醒，支持直接从通知执行快速操作。整体外观和感觉使游戏内手机更接近玩家对真实智能手机的期望。

新应用

多个新应用扩展了玩家使用手机的功能。专用图库应用允许玩家保存和查看游戏内截图。笔记应用提供了一个简单但有效的方式来存储角色扮演中的信息。改进的银行应用带有交易历史和转账功能，为玩家提供完整的移动银行体验。市场应用支持玩家间的物品列表，创造了新的经济角色扮演层。

性能改进

虽然 Agency Phone 已经保持了 0.00ms 的空闲使用率，v2 进一步优化了活跃使用场景。应用加载系统已重新架构为懒加载，这意味着应用只有在实际打开时才初始化其 UI 组件。这减少了手机打开时的内存占用，并带来更快的应用切换。NUI 通信层已简化，减少了客户端与界面之间触发的事件数量。

升级路径

现有 Agency Phone 用户可通过标准 Tebex 下载流程更新至 v2。迁移设计旨在保留现有数据，包括联系人、消息和通话记录。详细的迁移指南可在文档中找到，Agency Scripts Discord 团队随时准备协助解决升级问题。建议先在开发服务器上测试更新，以确保与您的自定义配置兼容后再部署到生产环境。

v2版本的安装与设置

从v1升级到v2遵循标准的Tebex下载更新流程。从你的Tebex库中拉取新版本，替换服务器上的资源文件夹，然后重启。迁移脚本位于 sql/migrate_v1_to_v2.sql 处理架构变更，重启资源前对现有数据库运行一次。现有联系人、消息历史和通话记录均被保留。

如果您首次在 v2 上安装 Agency-Phone，请导入 phone.sql，将资源文件夹拖入，并添加 ensure agency-phone 到 server.cfg. 资源自动检测 QBCore 或 ESX。独立设置在 config.lua 中实现适配器。

v2 中的配置选项

v2的config.lua与v1配置完全向后兼容，并为新功能增加了选项：

• 壁纸库，指定允许的壁纸 URL 或启用玩家上传 CDN 端点。
• 应用图标布局，网格大小（4x5，4x6）及玩家是否可重新排列应用位置。
• 通知中心行为，最大存储通知数，滑动关闭阈值，每个应用的快速操作按钮。
• 图库存储，截图 CDN 端点和每玩家存储配额（MB）。
• 市场设置，列表过期时间，是否需要管理员批准列表，以及交易手续费百分比。
• 银行应用集成，连接QBCore银行、ESX银行或自定义银行功能。
• 懒加载，应用使用懒初始化（v2中默认全部启用）以及是否在打开手机时预加载特定应用。

v2 中的框架兼容性

v2 维持与 v1 相同的框架适配器模式。如果您在 v1 中自定义了适配器，您的更改将继续生效，适配器接口保持不变。v2 中新增的应用（图库、笔记、市场）均通过相同的适配器函数路由。新功能无需新的框架特定实现。

为什么 v2 重新设计对角色扮演很重要

v1手机已是市场上性能最好的FiveM手机。v2的重新设计解决了另一个问题：手机外观与真实智能手机感觉之间的差距。重新设计的主屏幕支持可定制壁纸和可重新排列的应用图标，是玩家首先注意到的变化，但它真正实现的是让玩家拥有手机个性。感觉个性化的手机是玩家作为角色投资的道具。

通知中心重新设计对日常游戏影响最大。在v1中，通知以吐司形式出现后消失。在v2中，通知累积于中心，带快速操作：可直接从通知接受/拒绝来电，无需打开短信应用即可回复消息，批准市场交易。减少每个操作打开菜单次数，整个游戏过程中显著提升手机使用流畅度。

市场应用开启了此前需角色外协调的完整经济层。想卖物品给其他玩家的玩家可在市场上挂单；买家浏览并购买，无需离开手机。谈判在私信中进行，取货协调在短信中完成。整个交易均为角色内行为，这正是交易转化为RP的关键。

v2 中未改变的内容

核心性能特征没有改变，因为没有必要。0.00ms 的空闲使用率、框架无关的适配器模式、惰性加载架构，这些是 v2 UI 的基础。我们添加了新的画廊、笔记和市场应用，而没有触及性能层。v2 在功能上更丰富，但资源使用并不增加。

联系人、短信和通话应用在v2中视觉上进行了刷新，但功能相同。依赖v1中特定行为、线程、群组短信、通话记录的玩家，在v2中能找到相同的行为，且视觉表现更佳。迁移对成熟社区来说平滑，因为我们没有改变已正常工作的内容。

关于 v2 的常见问题

如果v2在我的服务器上出现问题，我可以回退到v1吗？

是的，v1版本的下载仍保留在您的Tebex库中。您的v1数据库模式兼容，迁移SQL仅添加表，不修改现有表。回退意味着切换回v1资源文件夹并忽略新表。虽然不理想，但如果v2部署初期出现关键兼容性问题，这是安全的。

市场应用是否需要特殊后端设置？

市场使用现有的oxmysql数据库，无需额外后端。列表存储于新的 phone_marketplace 由迁移SQL创建的表。市场完全包含在服务器内，无外部API依赖。

管理员可以管理市场列表吗？

是的。在config.lua中启用审批模式，新列表会出现在通过Agency-Admin或电话自带管理面板（管理员标志玩家可访问）的审核队列中。建议用于防止玩家试图列出禁止物品或通过市场规避游戏内经济限制的服务器。

同一账户下不同角色的画廊存储是否共享？

默认情况下，图库存储是按角色而非账户。截图与拍摄它的角色关联。对于希望在多角色系统中共享截图的玩家，请设置 Config.GalleryByAccount = true 使用玩家标识符代替角色标识符作为存储键。

需求

• FiveM 服务器（QBCore、ESX 或独立）
• oxmysql
• 拥有有效 Agency-Phone 许可证的 cfx.re 账户
• 图库功能的照片CDN端点（可选，未配置时回退为仅URL）