agentscope-ai / agentscope-ai/QwenPaw
[Feature]: 待审批时发出系统提示音 / Play system notification sound when tool call requires human approval
- Vorherrschende Sprache
- TypeScript
- Sterne
- 35k
- Forks
- 3.1k
- Ø Merge
- 1 T. 13 Std.
- Gemergte PRs (30 T.)
- 228
Beschreibung
## 问题描述 / Problem
当 QwenPaw 执行危险操作(CRITICAL/HIGH 级别)进入**待审批流程**时,用户只能通过**视觉**方式得知——要么盯着控制台页面,要么看着频道里的文字提示。
如果用户离开电脑、切到别的窗口、或者没一直盯着屏幕,就完全不知道有操作在等审批,导致流程卡住。
## 建议方案 / Proposed Solution
增加一个配置项,在进入待审批流程时触发系统通知/提示音,让用户**不用一直盯着屏幕**也能知道需要批准或拒绝。
### 具体思路
1. **跨平台配置项**:在 `agent.json` 中加一个可选字段,例如:
```json
{
"approval_notification_sound": true
}
```
默认 `false`(保持当前行为,不产生声音),用户按需开启。
2. **Windows 系统**:播放系统提示音(`SystemSounds.Asterisk`)或通过 Windows Toast Notification 弹窗+声音
3. **macOS 系统**:通过 `osascript` 显示通知并附带声音,或播放系统内置提示音(如 `Ping.aiff`)
4. **Linux 系统**:通过 `paplay` 或 `aplay` 播放提示音
5. **可选增强**:支持自定义提示音路径,让用户选自己喜欢的音效
### 使用场景 / Use Case
- 用户让 QwenPaw 执行一个耗时的多步任务,然后切到其他窗口工作
- QwenPaw 遇到危险操作,停下来等审批
- **现状**:用户不知道,任务卡住,直到用户偶然切回控制台才看到
- **期望**:系统发出提示音/通知,用户立即知道,回来批准/拒绝,任务继续
## 补充信息 / Additional Context
相关的安全审批文档:https://qwenpaw.agentscope.io/docs/security
Beitragsleitfaden
Rechercherichtung
The issue does not name files, tests, or an approval entry point. Start by locating the approval-flow handling and agent.json configuration, then review the named Windows, macOS, and Linux notification or audio mechanisms. Done means an opt-in setting, disabled by default, signals the user when a dangerous tool call awaits approval on the supported platforms.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- python
- Bereich
- desktop
- Issue-Typ
- Feature
- Schwierigkeit
- 4/5
- Geschätzter Aufwand
- 3-5 Tage
- Aktivitätsstatus
- Ruhig
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 35/100