# 2026-06-08 — 脚本执行完成提示音可配置

## 摘要

将原先硬编码在 `App.vue` 的双音提示改为系统设置项，支持关闭/三种音色，并可试听。

## 动机

用户需在「设置」中控制脚本执行结束时的浏览器提示音，而非写死在代码里。

## 涉及文件

- `frontend/src/utils/scriptCompleteSound.ts` — 音色预设与播放
- `frontend/src/composables/useScriptCompleteSound.ts` — 与 MySQL 设置同步
- `frontend/src/App.vue` — 使用 composable
- `frontend/src/pages/SettingsPage.vue` — 「界面提示」卡片
- `server/api/settings.py` — `script_exec_complete_sound` 白名单与枚举校验

## 设置项

| Key | 可选值 | 默认 |
|-----|--------|------|
| `script_exec_complete_sound` | `off` / `beep_short` / `beep_double` / `chime_soft` | `beep_double`（未配置时） |

API：`PUT /api/settings/script_exec_complete_sound` `{ "value": "beep_double" }`

## 迁移 / 重启

- 无需迁移；首次保存时写入 `settings` 表
- 仅前端热更新即可试听；后端需 reload 以识别新白名单键

## 验证

- 设置 → 界面提示 → 切换音色并「试听」
- 触发脚本执行完成，确认按所选音色播放或关闭
