80 lines
2.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
id: system-setting.general.howto
title: 通用设置
type: howto
feature: system-setting
scope: admin
locale: zh
aliases:
- 通用设置
- 注册开关
- 是否允许注册
- 邀请码
- 密码策略
- 消息撤回时长
- 消息编辑时长
- 自动归档
- 系统名称
- 欢迎语
- 上传大小限制
related_tools: []
related_pages: []
prerequisites:
- 需要系统管理员权限
- 部署的环境变量 SYSTEM_SETTING 不能是 disabled否则禁止修改
negative:
- SYSTEM_SETTING=disabled 时所有系统设置都不能改(演示环境常用)
- 自动归档天数限制为 1-100 天,超出会报错
- 邀请码留空会自动生成随机码,不能完全关闭"凭码注册"模式
last_verified: v1.7.90
---
# 通用设置
## 入口
桌面端:左上角头像 →「系统设置」→「通用」。
对应后端:`POST api/system/setting`,参数 `type=save` 提交。
## 关键字段(按主题分组)
**注册与登录**
- `reg` — 注册策略:`open` / `close` / `invite`
- `reg_identity` — 新注册用户默认身份(`normal` / `temp`
- `reg_invite` — 邀请码(留空自动生成)
- `login_code` — 登录验证码策略
- `password_policy` — 密码强度(`simple` / `complex`
**项目与任务**
- `project_invite` / `project_add_permission` / `project_add_userids` — 项目创建与邀请权限
- `auto_archived` / `archived_day` — 任务自动归档与天数1-100
- `task_visible` / `task_default_time` / `task_user_limit` — 任务默认值
- `unclaimed_task_reminder*` — 未认领任务提醒
- `task_ai_auto_analyze` — 任务 AI 自动分析(需 ai 插件)
- `department_owner_project_view` — 部门负责人是否能看下属项目
- `todo_set_permission` — 设置 todo 权限
**消息与群组**
- `chat_information` — 群成员入群提示
- `anon_message` / `e2e_message` — 匿名 / 端到端加密
- `msg_rev_limit` / `msg_edit_limit` — 撤回/编辑时长上限(分钟)
- `all_group_mute` / `all_group_autoin` — 全员群免打扰 / 自动入群
- `user_private_chat_mute` / `user_group_chat_mute` — 默认免打扰
**媒体与上传**
- `convert_video` / `compress_video` — 视频转码与压缩
- `image_compress` / `image_quality` / `image_save_local` — 图片处理
- `file_upload_limit` — 单文件上传大小MB
**外观**
- `system_alias` / `system_welcome` — 系统名称别名与欢迎语
## 操作步骤
1. 进入「系统设置」→「通用」
2. 按表单逐项填写(不在白名单内的字段会被服务端自动剔除)
3. 点击「保存」,服务端落库到 `setting` 表(`system` 分组)
4. 提示「保存成功」即生效,无需重启
## 不支持
- 无法在 `SYSTEM_SETTING=disabled` 环境保存(一律拒绝)
- 注册开关只有 3 个枚举值,不支持「按邮箱白名单」直接配置