附件下载前缀插件

为论坛附件下载自动添加可配置前缀，支持自定义分隔符与实时预览，下载时自动应用规则。

功能概述

• 用户下载附件时，系统自动在原文件名前拼接管理员配置的前缀

• 仅修改下载时的输出文件名，不改动服务器存储的源文件名称与路径

• 支持两种前缀格式：

  • 包装模式：括号包裹前缀，如 【前缀名】文件名.rar、[前缀名]文件名.rar

  • 分隔符模式：分隔符连接，如 前缀名_文件名.rar、前缀名-文件名.rar

• 自动过滤前缀中的非法文件名字符（\ / : * ? " < > |）

• 后台实时预览最终下载文件名效果

• 配置即时生效，无需清理缓存

安装与卸载

安装

1. 将 navgcn_attach_prefix 目录上传至 plugin/ 目录

2. 进入后台 → 插件管理 → 找到「附件下载前缀插件」→ 点击安装

3. 安装完成后，插件默认前缀为空，不影响现有下载功能

卸载

1. 进入后台 → 插件管理 → 找到「附件下载前缀插件」→ 点击卸载

2. 卸载将清除所有插件配置数据，不影响附件文件

后台配置

1. 进入后台 → 插件管理 → 附件下载前缀插件 → 设置

2. 下载前缀：输入前缀内容，支持中文、英文、数字及常规符号

3. 包装样式：选择是否用括号包裹前缀（如 【前缀名】、[前缀名]），选择"无包装"则使用分隔符

4. 分隔符：无包装时，选择前缀与文件名之间的分隔符，支持自定义输入

5. 效果预览：实时展示当前配置下的下载文件名效果

6. 点击「保存设置」即时生效

注意事项

• 前缀为空时，附件下载保持原始文件名，不影响论坛正常下载功能

• 前缀中的非法文件名字符（\ / : * ? " < > |）会自动过滤

• 分隔符若选择「自定义」，需在右侧输入框中填写自定义分隔符

• 选择包装样式后，分隔符设置自动隐藏（包装模式下不使用分隔符）

• 仅拥有管理权限的用户（gid=1 或 gid=2）可访问配置页面

常见问题

Q: 配置前缀后，旧附件下载是否也会生效？ A: 是的，配置即时生效，所有附件下载（包括旧附件）都会自动应用前缀规则。

Q: 前缀是否会影响服务器上存储的文件？ A: 不会，仅修改下载时浏览器收到的文件名（Content-Disposition 头），服务器存储的源文件名称和路径完全不变。

Q: 支持哪些下载方式？ A: 同时支持附件下载（attach-download）和附件提取（attach-fetch）两种方式。

更新日志

v1.0.0 (2026-07-23)

• 初始版本发布

• 支持下载文件名自动添加前缀

• 支持两种前缀格式：包装模式（【前缀】文件名）和分隔符模式（前缀_文件名）

• 支持多种分隔符选择与自定义输入

• 后台实时预览效果

• 自动过滤非法文件名字符