系统参数
本页列出「系统参数」页的每一项：含义、默认值和取值范围。
使用方式
- 参数按分组排列，每项右侧是数字步进框，单位写在框后。
- 修改后该项前出现圆点，页面底部出现「已修改 N 项」保存条，点「保存」提交或「放弃」还原。未保存就离开页面时浏览器会提醒。
- 保存后立即对新请求生效（「机器心跳间隔」除外，见下文），并写入 审计记录，记录每项的旧值和新值。
- 超出取值范围的值会被拒绝保存。
标有「群默认」的三项是群级参数的全局默认值：群管理员可以在群设置里为本群单独调整，没调整的群沿用这里的值。
账号
| 参数 | 默认 | 说明 |
|---|---|---|
| 开放自助注册 | 关闭 | 开启后登录页显示注册入口，注册即成为普通成员；关闭后只能由管理员 创建账号。开关即时生效，不需要点保存。同一 IP 每小时最多注册 5 个账号 |
同步与锁
| 参数 | 默认 | 范围 | 说明 |
|---|---|---|---|
| 持锁 Bot 断线后自动释放锁 | 60 秒 | 1–3600 | 预留参数，当前版本不生效 |
| 开启强制同步 · 延迟阈值 | 120 ms | 1–10000 | 当前只用于 机器 页：延迟高于此值的机器标红 |
| 开启强制同步 · 带宽阈值 | 10 Mbps | 0.1–10000 | 当前只用于机器页：带宽低于此值的机器标红 |
运行与会话
| 参数 | 默认 | 范围 | 说明 |
|---|---|---|---|
| 会话恢复失败时补送群消息数 | 50 条 | 1–500 | Bot 恢复之前的会话时，一并备好最近若干条群消息，会话恢复不了时补给新会话；实际条数不超过下一项 |
| 每轮随消息附带的群聊上下文 | 20 条 | 1–200 | 每轮运行随 @ 消息一起发给 Bot 的群消息上限（该 Bot 上次运行之后的新消息）；更早的消息 Bot 可以通过内置工具自己去读 |
| 提问卡片每张题数上限 | 4 题 | 1–4 | 当前版本不生效，每张提问卡片固定最多 4 题 |
附件
| 参数 | 默认 | 范围 | 说明 |
|---|---|---|---|
| 单个附件大小上限 | 50 MB | 1–50 | 上传单个附件的大小上限 |
| 每条消息附件数 | 10 个 | 1–10 | 一条消息最多带几个附件 |
TIP
调大附件上限时，记得同步检查反向代理的请求体大小限制，见 反向代理。
机器连接
| 参数 | 默认 | 范围 | 说明 |
|---|---|---|---|
| 机器心跳间隔 | 15 秒 | 5–120 | daemon 向服务器发送心跳的间隔。服务器启动时读取，修改后需重启服务器才生效；环境变量 GONGGONG_HEARTBEAT_SEC 优先于此参数 |
| 机器离线判定（连续未收到心跳） | 3 次 | 2–10 | 连续这么多个心跳间隔没收到心跳，就判定机器离线 |
数据保留
| 参数 | 默认 | 范围 | 说明 |
|---|---|---|---|
| 完整运行过程保留 | 30 天 | 1–3650 | 运行结束超过这么多天后，删除该轮的完整过程（思考、工具调用、输出）和 diff；运行卡片上的摘要保留。服务器每小时清理一次 |
| 服务器备份（每日）保留 | 7 天 | 1–365 | 当前不生效：备份脚本固定保留最近 7 份，见 备份与恢复 |
| 删群后存档保留 | 30 天 | 1–365 | 群被解散后存档的保留天数，群 页据此显示「N 天后清除」 |
群与 Bot 默认值
| 参数 | 默认 | 范围 | 说明 |
|---|---|---|---|
| 权限审批等待（分区模式）· 群默认 | 30 分钟 | 1–1440 | Bot 发起权限请求后，等 Bot 主人批准的时间；超时自动拒绝，见 审批与提问 |
| 接力链长上限 · 群默认 | 3 跳 | 1–10 | Bot 在回复里 @ 另一个 Bot 接力时，一条接力链最多传递几次 |
| Bot 离线时请求等待上线 · 群默认 | 30 分钟 | 1–1440 | Bot 所在机器离线时，请求排队等待机器上线的时间；超时后请求作废并通知触发人 |
| Bot 并发上限 · 新建默认 | 2 个 | 1–10 | 新建 Bot 时「并发上限」的初始值；已有 Bot 不受影响 |
其他
不在上面分组里的参数显示在「其他」分组：
| 参数 | 默认 | 范围 | 说明 |
|---|---|---|---|
| 预览无人访问后自动关闭 | 24 小时 | 1–720 | 预览连续这么久没人打开就自动关闭，并停止没有其他预览在用的托管服务，见 结果预览 |
| 预览公开链接最长有效期 | 30 天 | 1–365 | 生成公开链接时可选的最长有效期，见 公开分享 |