文档(运行): 登记连接池可选配置节与默认值口径

docs/运行手册.md

@@ -38,6 +38,7 @@ ps -p "$pid" -o command=
 
 - 版本化范围：`配置/本机正式.toml`、`配置/本机维护.toml` 保存非敏感配置及受控引用；仅创建文件不代表已经提交 Git。
 - 本机受控根：`~/.local/share/muse/正式环境/`（目录 0700，凭据文件 0600）。三个数据库角色分别使用 `muse_app.连接.txt`、`muse_eval.连接.txt`、`muse_maint.连接.txt`；工作台使用 `工作台口令.txt`。
+- 可选连接池参数：在 `["数据库"."连接池"]` 节声明 `最大连接`（1–100）与 `等待秒`（0.1–60.0）可显式覆盖默认值（生产 4、评测 2，等待 2.0 秒）；只调优当次部署的借还行为，不改变数据库目标身份。
 - infra 凭据副本：SSH `个人-minione-ubuntu-infra-4c16g120g`，目录 `/opt/infra/private/muse-agent-example/`。恢复时复制所需文件到本机受控根并核对权限；禁止输出凭据内容到日志或提交明文凭据。
 - 正式连接仅使用 PG `100.64.0.8:5433`，带 `keepalives=1 keepalives_idle=15 keepalives_interval=5 keepalives_count=3`。Redis 与本项目无关。
 - 原迁移目录中的库外原文、草稿和切换回执尚未找回。当前文件根是恢复后新建的目录，不代表原文件资产已恢复。

部署/应用.example.toml

@@ -3,6 +3,12 @@
 "取值方式" = "受控存储"
 "位置" = "/run/secrets/muse_db"
 
+# 可选：连接池参数显式覆盖；未声明时按用途取默认（生产 4、评测 2，等待 2.0 秒）。
+# 仅调优当次部署的借还行为，不改变数据库目标身份。
+# ["数据库"."连接池"]
+# "最大连接" = 8
+# "等待秒" = 2.0
+
 ["运行"]
 "用途" = "production"
 

配置/应用.example.toml

@@ -4,6 +4,12 @@
 # 相对地址以配置文件所在目录为起点。
 "位置" = "数据库连接.txt"
 
+# 可选：连接池参数显式覆盖；未声明时按用途取默认（生产 4、评测 2，等待 2.0 秒）。
+# 仅调优当次部署的借还行为，不改变数据库目标身份。
+# ["数据库"."连接池"]
+# "最大连接" = 8
+# "等待秒" = 2.0
+
 ["资源"]
 # 从 工具/环境预检.py 的 resource_build_id 取得，不能只写发布标签。
 "发布身份" = "<固定资源构建身份>"