chore: import upstream snapshot with attribution

docs/advanced/configuration.md

@@ -0,0 +1,37 @@
+# 配置系统详解
+
+## 概述
+
+系统采用多层配置架构，模型配置由网页界面管理，应用配置基于 Pydantic + TOML。
+
+## 配置层级
+
+```
+代码默认值 → TOML 文件 → 环境变量
+   (低)                      (高)
+```
+
+## 模型配置
+
+由网页统一管理，详见 [模型配置](../intro/model-config.md)。
+
+## 应用配置
+
+配置项定义于 `backend/package/yuxi/config/app.py`，用户修改保存至 `saves/config/base.toml`。
+
+### 修改配置
+
+```python
+from yuxi.config import config
+
+config.default_model = "provider-id:model-id"
+config.save()
+```
+
+配置会在保存 `base.toml` 后写入 Redis 快照（`yuxi:runtime_config`）。快照包含可运行时同步的公开配置字段，不包含 `_` 开头的内部属性和 `save_dir`；API/worker 进程在启动时各拉起一个后台同步线程，按 5 秒间隔从该快照刷新内存值，读取端无需感知。Redis 不可用时继续使用当前内存值。
+
+`save_dir` 是启动期内部路径配置，不在管理员配置中展示，也不支持通过管理员配置接口、`base.toml` 或运行时 Redis 快照修改。sandbox 相关配置仍属于启动期敏感配置，运行中的已初始化组件不承诺完整热更新，修改后需要重启服务保证生效。
+
+## 常见问题
+
+**配置文件损坏**：删除 `saves/config/base.toml`，系统将重新生成默认配置。