dootask/resources/ai-kb/zh/howto/system-setting/file.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
system-setting.file.howto	文件设置（打包下载权限）	howto	system-setting	admin	zh	文件设置 打包下载 文件夹打包 打包权限 谁能下载文件夹 文件批量下载 限制打包下载			需要系统管理员权限	这页只控制「文件夹打包下载」的访问名单，不控制单文件下载 单文件下载没有黑白名单，权限全部由文件本身的可见范围决定 SYSTEM_SETTING=disabled 时不能修改	v1.7.90

文件设置（打包下载权限）

入口

桌面端：左上角头像 →「系统设置」→「文件」。 对应后端：POST api/system/setting/file，参数 type=save。

是什么

仅控制「文件夹批量打包下载」入口的可见范围。原因是大文件夹打包会占大量磁盘和带宽，需要按需限制。

普通的单文件预览、下载、分享逻辑由文件本身的可见用户/权限决定，不在本页设置。

字段说明

• permission_pack_type — 打包下载授权策略：
  • all — 所有用户都能用打包下载（默认）
  • admin — 仅系统管理员
  • user — 仅 permission_pack_userids 名单内的用户
  • close — 全员禁用打包下载
• permission_pack_userids — 数组，type=user 时生效的白名单（用户 ID 列表）

服务端只接受这 2 个字段，其他键被自动剔除。

操作步骤

1. 进入「文件」设置页
2. 选择策略：默认开放 / 仅管理员 / 指定人员 / 关闭
3. 「指定人员」模式下从用户选择器勾选成员
4. 点击「保存」即生效

影响范围

• 文件中心 / 项目附件 / 群聊文件等所有「文件夹批量下载」入口都遵守此设置
• 即使有打包权限，被打包的文件仍需用户对单个文件有可见权限，无权部分会自动跳过

不支持

• 不区分按项目 / 部门设置（全局一刀切）
• 不支持按文件大小阈值决定是否允许打包
• 不影响单文件下载（单文件下载由文件可见性独立决定）