系统设置
后台系统设置保存到数据库，当前实例保存后即可使用新值。邮件服务也在后台配置：SMTP 密码加密保存，读取配置时只显示是否已设置。数据库连接、监听地址和实例密钥仍属于启动配置。
站点与注册
| 设置键 | 默认值 | 用途 |
|---|---|---|
site.name | Obsidian Arc | 站点名称 |
site.description | 空 | 站点说明 |
site.browser_title | 空 | 浏览器标签页标题；空值使用 site.name |
site.auth_card_position | center | 登录与注册卡片停靠位置；可选 center、left 或 right |
about.title / about.body | 空 | 关于页面标题与 Markdown 详细介绍；空值使用内置内容 |
home.notice | 空 | 首页通知横条上的一行字（最多 300 字符），登录前也可见 |
home.notice_body | 空 | 点开横条后的 Markdown 正文（最多 4000 字符） |
home.notice_tone | info | 横条样式：info 或 warning |
home.notice_dismissible | true | 是否允许关闭通知 |
update.check | true | 超级管理员打开后台时，是否向 GitHub 查询新版本并在后台提醒；每 12 小时最多查询一次，关闭后服务器不会向 GitHub 发出任何请求 |
registration.enabled | true | 是否开放注册 |
registration.default_group | 空 | 注册分组覆盖值；未设置时使用默认组 |
registration.require_email | false | 注册是否要求邮箱 |
registration.verify_email | false | 是否要求邮件验证；开启后新账户必须提供邮箱，需先配置并测试邮件服务 |
registration.email_domains | 空 | 允许注册的邮箱域名 |
注册频率、Turnstile 和模型审核见注册与安全。
「安全 → 邮件服务」保存 SMTP 主机、端口、加密方式、账号、发件人及站点公开地址，并向指定地址发送测试邮件。先保存配置再测试；未保存的草稿不会用于测试邮件。密码输入留空表示保留原密码，清除密码需要明确选择。邮件把验证链接和六位验证码发给同一个收件人；链接需在页面点击确认，两者任一成功，另一种方式同时失效。
「安全 → 临时邮箱检测」可填写付费 UserCheck API 密钥并启用检测。后台预填一组常用邮箱域名免检列表，可增删；域名按完整名称匹配，免检域名完全跳过 UserCheck，包括对该域名中个别临时地址的识别。名单外的邮箱使用 UserCheck 邮箱接口；只在返回 disposable: true 时拒绝。密钥加密保存，输入框留空会保留原密钥。管理员还可选择 UserCheck 超时、限流或不可用时让注册继续，或暂停注册并提示稍后重试；默认为后者。测试按钮会实际调用付费接口，五分钟内只能执行一次。
| 设置键 | 默认值 | 用途 |
|---|---|---|
security.signup_review_restrict_hours | 24 | restrict 注册的 API 限制时长；0 表示手动解除 |
security.chat_challenge_requests | 0 | 聊天速度窗口内允许的请求数；0 表示关闭 |
security.chat_challenge_window_seconds | 60 | 聊天速度统计窗口 |
security.chat_challenge_clear_minutes | 30 | 一次验证通过后的免验证时间 |
浏览器标题与 PWA
| 设置键 | 默认值 | 用途 |
|---|---|---|
pwa.name | 空 | 安装提示中的应用名称；空值使用 site.name |
pwa.short_name | 空 | 主屏幕图标下方显示的简称；空值使用上面解析出的应用名称 |
pwa.description | 空 | 安装提示中的说明；空值使用 site.description |
pwa.theme_color | #18181b | 浏览器外观着色，格式为 #rrggbb |
pwa.background_color | #18181b | 应用加载时图标背后的颜色，格式为 #rrggbb |
pwa.icon_url | 空 | 应用图标；只接受本站的相对路径或 data: 内联图片，空值使用内置图标 |
site.browser_title 决定浏览器标签页标题，已登录浏览器会在保存后立即更新，无需刷新页面。pwa.* 决定安装为应用（PWA）时的名称、说明和外观，由 GET /manifest.webmanifest 提供给浏览器，该接口无需登录即可访问。
图标地址的限制并非疏漏：页面的图片安全策略只允许本站路径和内联的 data: 图片，指向其他域名的地址会被浏览器静默忽略，因此保存时直接拒绝。
首页与对话
| 设置键 | 默认值 | 用途 |
|---|---|---|
landing.mode | login | 登录页、内置官网首页、介绍页或访客对话 |
landing.intro | 空 | 介绍页 HTML，经过允许列表处理 |
landing.trial_enabled | false | 开启访客试用 |
landing.trial_turns | 3 | 试用轮数，最高 20 |
landing.trial_model | 空 | 试用模型 |
chat.default_system_prompt | 空 | 默认系统提示词 |
chat.max_turns | 40 | 发送给上游的历史范围上限 |
chat.allow_archive | true | 是否允许用户归档会话 |
访客试用只在 landing.mode=chat 时提供。site 是程序自带的官网首页，内容由程序提供，不读取 landing.intro；介绍页支持受控 HTML，首页通知则是纯文本，三者格式不同。详见访客试用。
API 与额度
| 设置键 | 默认值 | 用途 |
|---|---|---|
api.enabled | false | 全站 API 开关，也限制管理员 |
quota.admins_bypass | true | 管理员是否绕过额度限制 |
quota.usage_display | absolute | 具体数值、已用比例或剩余比例；额度窗口和赠金条都按它措辞 |
quota.max_concurrent | 4 | 全站最大并发流式请求数限制；0 表示不限 |
API 开关与额度豁免是两项独立设置。用户组还需要 api_access 权限；额度上限在全局、用户组或用户策略中配置。
工作台草稿与保存
后台系统设置具备草稿自动暂存能力（settingsDraft）：
- 当在表单中修改多项设置而未点击“保存”时，即使切换到后台其他页面或关闭标签页，修改内容也会暂存在本地存储中。
- 再次进入系统设置时会自动检测未保存的草稿，提示是否恢复草稿或丢弃，防止误触导致输入丢失。
附件保留与清理
| 设置键 | 默认值 | 用途 |
|---|---|---|
attachments.max_mb | 6 | 单文件大小上限，最高 64 MB；同样适用于 /v1 接口的图片 |
attachments.retain | false | 发送后是否保留上传图片数据 |
attachments.purge_after_days | 0 | 按年龄清理；0 不启用 |
attachments.purge_daily_at | 空 | 每日清理时间，格式 HH:MM |
attachments.orphan_minutes | 60 | 未关联消息的附件保留分钟数 |
开启保留后，按天与定时清理仍可删除附件数据。每日清理不是普通的临时文件整理：确认要清理的范围后再启用。
自动清理由后台周期任务执行，不保证恰好在指定分钟开始。手动清理前也应阅读界面确认内容。
导入与导出
设置可以导出为 JSON，再通过导入入口应用到实例。导入会校验可写字段，对不适用内容给出处理结果。
设置导出不是实例备份，不包含完整的用户、会话和服务商凭据。恢复站点数据应使用数据库备份。
多实例注意事项
业务设置在进程内缓存。当前实现没有跨进程自动刷新机制：通过一个实例保存设置，不代表其他实例的内存值也立即更新。
多实例部署时需要明确安排重新加载或重启，不能把数据库已经更新当作所有进程已同步。