金币 → 人民币

用户将金币按设定汇率兑换为人民币余额

人民币 → 金币

用户将人民币余额按设定汇率兑换为金币

实时预览

输入兑换数量时前端实时计算预估结果

手续费

支持按百分比收取手续费，从兑换目标中扣除

交易记录

用户可查看历史兑换记录，支持分页

积分日志

兑换操作自动写入积分日志，可在积分记录页查看

用户组权限

后台可限定允许兑换的用户组，不选则全员可用

功能开关

后台可一键关闭兑换功能，前台入口自动隐藏

金币→人民币汇率

多少金币兑换 1 元人民币

10

人民币→金币汇率

1 元人民币兑换多少金币

1

最低金币兑换

单次兑换最低金币数量

1

最低人民币兑换

单次兑换最低人民币金额【强烈建议设置为1】！！！！

0.01

手续费比例

按百分比从兑换目标中扣除

0%

允许兑换的用户组

限制可参与兑换的用户组

全部

启用兑换

功能总开关

开启

必填字段完整（name/brief/version/bbs_version/installed/enable）

✅

version 三位制（1.0.0）

✅

bbs_version 两位制（1.1）

✅

hooks_rank 键名与 hook 文件名一致（含扩展名）

✅

dependencies 为合法对象

✅

installed 和 enable 为 0（插件已激活）已检查修改！

✅

!defined('DEBUG') AND exit 守卫

✅

CREATE TABLE IF NOT EXISTS 幂等

✅

DEFAULT CHARSET=utf8mb4

✅

SHOW COLUMNS + ALTER TABLE 字段升级幂等

✅

db_sql_find 有 保留 db_sql_find 注释

✅

setting_set 初始化默认配置

✅

CacheHelper::registerKeys() 注册缓存键

✅

末尾 xn_unlink 清理 tmp/model.min.php

✅

文件名用 uninstall.php（标准拼写）

✅

DROP TABLE IF EXISTS 幂等

✅

setting_delete 清理配置

✅

$gid != 1 && $gid != 2 && $gid != 3 权限检查（含版主）

✅

POST 有 CsrfService::check()

✅

param() 取值已做类型转换

✅

使用 admin_plugin_setting_url('navgcn_exchange') 重定向

✅

通过 Service 类存取设置

✅

汇率/限额参数校验完整

✅

!defined('DEBUG') AND exit 守卫

✅

静态方法模式

✅

db_find / db_count / db_insert / db_update 优先使用

✅

$db->sqlFindOne() 有 保留 db_sql_find_one 注释

✅

SQL 参数 intval() 转义

✅

事务 BEGIN/COMMIT/ROLLBACK 完整

✅

db_insert 后检查返回值

✅

用户缓存清理（cache_delete + $g_static_users）

✅

使用 user_read_cache 获取用户信息

✅

setting_get / setting_set 直接存取数组（无 JSON 中转）

✅

手续费仅从目标端扣除（无双重收费）

✅

所有消息使用 lang() 多语言

✅

direction_label 使用 lang()（非硬编码）

✅

credits_log.reason 写入中文文本（credits_event_name() 兼容）

✅

getUserLogs 使用 CacheHelper::remember() 缓存

✅

兑换成功后 CacheHelper::pluginDeletePrefix() 清除缓存

✅

CacheHelper::remember() 中 $plugin 参数与 pluginDeletePrefix() 一致

✅

setting.htm 首尾 include ADMIN_PATH header/footer

✅

my_navg_exchange.htm 首尾 include APP_PATH header/footer

✅

表单有 CsrfService::input()

✅

Card 使用 x-card class

✅

前端 JS 使用 XN.toast() / XN.confirm() / XN.post()（非 jQuery）

✅

无 Alpine.js / htmx 冲突

✅

使用 Tabler Icons（ti ti-xxx）

✅

url() 使用路由表键名（非硬编码 URL 模式）

✅

无 APP_PATH 生成 <script src> / <link href>

✅

无 static/*.js 文件中写 PHP 代码

✅

所有 UI 文本使用 lang() 多语言（无硬编码中文）

✅

无 border-bottom / border-top，改用 <hr> 分隔

✅

JS 预览/确认文本通过 lang() 注入

✅

所有语言键使用 navg_exchange_ 前缀

✅

覆盖了所有功能场景（前端/后台/JS/日志）的翻译

✅

自定义路由通过 hook/model_route_table_end.php 注册

✅

{page} 占位符用于分页

✅

分页 URL 使用 route_url('navg_exchange_page', [])

✅

后台路由通过 hook/admin_index_route_case_end.php 注册

✅

PHP hook 文件以 <?php exit; 开头

✅

.htm hook 文件以 <?php 开头（非 <?php exit;）

✅

无 return; 在 hook 顶层作用域中

✅

my_end.php 中 exit; 有 // ponytail: 注释说明

✅

hook 文件名（含扩展名）与 conf.json 一致

✅

无 htmlspecialchars 裸写

✅

无 jQuery

✅

表名/变量/语言键/设置键均带插件前缀（navg_exchange）

✅

插件缓存使用 CacheHelper 统一管理

✅

CacheHelper::registerKeys() 已注册缓存键

✅