功能

• 为单个附件独立配置下载权限，支持 6 种权限类型：

  • public 公开（默认）

  • login 登录可见

  • credit 积分购买（按 enabled_credits_types 与 default_price 配置扣费）

  • vip VIP 专属（按 vip_gids 用户组列表放行）

  • reply 回复可见（用户在该附件所属主题下有回帖）

  • group 指定用户组（按 permission_params.gids 放行）

• 购买与退款：用户积分扣费购买后写入 xnx_attach_access_purchase（UNIQUE KEY (aid,uid)）；退款时 status=0 但保留记录，重新购买走 ON DUPLICATE KEY UPDATE 复原

• 豁免规则：管理员（gid=1/2）与附件作者（attach.uid）自动放行

• 下载拦截：在 attach_download_start hook 拦截下载入口，未通过 checkAccess 直接 message(-1) 阻止

• 多入口注入：

  • 发帖/编辑帖时附件列表 model_post_file_list_html_end 注入「权限配置」按钮

  • 主题页 thread_end.htm / 帖子页 post_ref_thread_after.htm 渲染权限标识与解锁提示

  • 帖子 JS post_js.htm / 主题 JS thread_js.htm 注入购买/查询交互

• 级联清理：删帖（model_thread_delete_start / model_post_delete_start）时自动清理对应附件的权限记录

• 后台路由 admin_attach_access 提供统计/管理面板（仅 gid=1/2）

• 前台路由 attach-access-purchase（POST 扣费购买）/ attach-access-status（GET 查询访问状态）

• 缓存：权限数据与购买状态均使用「版本号 + 数据」双层缓存（版本号 86400 秒、数据 3600 秒），写操作通过 bumpPermissionVersion / bumpPurchasedVersion 失效

文件结构

plugin/xnx_attach_access/
├── conf.json
├── install.php / uninstall.php
├── model/AttachAccessService.php
├── route/
│   ├── admin_attach_access.php  (后台统计/管理面板)
│   └── attach_access.php        (前台 purchase / status 接口)
├── hook/
│   ├── model_inc_file.php
│   ├── model_route_table_end.php
│   ├── index_route_case_end.php
│   ├── admin_index_route_case_end.php
│   ├── attach_start.php
│   ├── attach_download_start.php     (下载入口拦截)
│   ├── attach_assoc_post_end.php
│   ├── model_attach_create_end.php
│   ├── model_post_delete_start.php
│   ├── model_post_update_end.php
│   ├── model_post_file_list_html_end.php
│   ├── model_thread_delete_start.php
│   ├── post_js.htm
│   ├── post_ref_thread_after.htm
│   ├── thread_end.htm
│   ├── thread_js.htm
│   ├── lang_zh_cn_bbs.php
│   ├── lang_zh_tw_bbs.php
│   └── lang_en_us_bbs.php
├── view/htm/
│   ├── setting.htm
│   ├── attach_access_modal.htm
│   └── attach_access_post_card.htm
└── static/js/
    ├── post_attach_access.js
    └── thread_attach_access.js

配置流程

1. 后台启用插件（自动建 xnx_attach_access 权限表 + xnx_attach_access_purchase 购买表，写入 6 种类型与默认 VIP 用户组 2/4）

2. 进入「插件设置」勾选启用的权限类型、允许的积分类型、默认价格、VIP 用户组

3. 用户在发帖/编辑帖时点击附件旁「权限配置」按钮 → 弹窗选择类型与参数（如积分价格、用户组）

4. 测试：游客访问附件下载链接 → 提示「请先登录 / 需回复 / 需购买」；登录/回复/购买后下载放行；作者或管理员直接放行