@xiaoqiong0v0/opencode-sound-notify 1.1.8 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -39,6 +39,10 @@ npm install @xiaoqiong0v0/opencode-sound-notify
39
39
  "debounceMs": {
40
40
  "permission.asked": 5000
41
41
  },
42
+ // 子任务(sub-session)中仍触发提示音的事件列表,默认仅权限请求
43
+ "childEvents": ["permission.asked"],
44
+ // Termux 音频流类型,仅 Termux 生效(media/alarm/notification/ring/system/voice)
45
+ "streamType": "media",
42
46
  // 语言: "zh" 或 "en"
43
47
  "lang": "en",
44
48
  // 是否启用
@@ -54,6 +58,8 @@ npm install @xiaoqiong0v0/opencode-sound-notify
54
58
  | `defaultDebounceMs` | `30000` | 全局默认防抖间隔 |
55
59
  | `minIntervalMs` | `3000` | 全局最小间隔,所有声音不能小于此值,设为 0 关闭 |
56
60
  | `debounceMs` | `{}` | 按事件单独配置,key=事件名,value=防抖间隔(ms) |
61
+ | `childEvents` | `["permission.asked"]` | 子任务中仍触发提示音的事件列表,其他事件静默 |
62
+ | `streamType` | `"media"` | Termux 音频流类型,仅 Termux 生效 |
57
63
  | `lang` | `"en"` | 语言设置 |
58
64
  | `enabled` | `true` | 总开关 |
59
65
 
@@ -62,8 +68,8 @@ npm install @xiaoqiong0v0/opencode-sound-notify
62
68
  | 事件 | 内置文件 | 音效 |
63
69
  |------|----------|------|
64
70
  | `session.idle` | `assets/default.wav` | 默认 |
65
- | `session.error` | `assets/error.wav` | 短促蜂鸣 |
66
- | `permission.asked` | `assets/ask.wav` | 双音提醒 |
71
+ | `session.error` | `assets/session.error.wav` | 短促蜂鸣 |
72
+ | `permission.asked` | `assets/permission.asked.wav` | 双音提醒 |
67
73
 
68
74
  ## 支持的事件
69
75
 
@@ -91,3 +97,12 @@ npm install @xiaoqiong0v0/opencode-sound-notify
91
97
  | Windows | PowerShell SoundPlayer |
92
98
  | macOS | `afplay` |
93
99
  | Linux | `paplay` (PulseAudio) / `aplay` (ALSA) |
100
+ | Termux (Android) | play-audio(OpenSL ES,需 pkg install play-audio) |
101
+
102
+ ### Termux (Android)
103
+
104
+ ```bash
105
+ pkg install play-audio
106
+ ```
107
+
108
+ Termux 上通过 `play-audio`(OpenSL ES) 播放,默认走 `media` 音频流(可用 `streamType` 切换)。若无声,请检查手机对应音频流的音量(如媒体音量)。
@@ -10,6 +10,14 @@ const __filename = fileURLToPath(import.meta.url);
10
10
  const __dirname = dirname(__filename);
11
11
  const ASSET_DIR = join(__dirname, "..", "assets");
12
12
  const DEFAULT_SOUND = join(ASSET_DIR, "default.wav");
13
+ // 事件 → 内置音频文件映射
14
+ const BUILTIN_SOUNDS = {
15
+ "session.idle": "default.wav",
16
+ "session.error": "session.error.wav",
17
+ "permission.asked": "permission.asked.wav",
18
+ };
19
+ // Termux 默认前缀目录
20
+ const TERMUX_PREFIX = "/data/data/com.termux/files/usr";
13
21
  const log = createLogger("sound-notify");
14
22
  const SAMPLE_CFG = `{
15
23
  // 默认提示音文件路径,留空使用内置 default.wav
@@ -30,6 +38,10 @@ const SAMPLE_CFG = `{
30
38
  "debounceMs": {
31
39
  "permission.asked": 5000
32
40
  },
41
+ // 子任务(sub-session)中仍触发提示音的事件列表,默认仅权限请求
42
+ "childEvents": ["permission.asked"],
43
+ // Termux 音频流类型,仅 Termux 生效(media/alarm/notification/ring/system/voice)
44
+ "streamType": "media",
33
45
  // 语言: "zh" 或 "en"
34
46
  "lang": "en",
35
47
  // 是否启用
@@ -51,6 +63,7 @@ const TX = {
51
63
  mute_save: { zh: "save=true 同时写入配置文件持久化", en: "save=true also persist to config file" },
52
64
  save_ok: { zh: "已保存到配置文件 {path}", en: "Saved to config {path}" },
53
65
  save_fail: { zh: "保存失败: {msg}", en: "Save failed: {msg}" },
66
+ termux_no_player: { zh: "Termux 未找到 play-audio,请先执行: pkg install play-audio", en: "play-audio not found in Termux, install it: pkg install play-audio" },
54
67
  };
55
68
  const T = (key, params) => {
56
69
  const entry = TX[key] || { zh: key, en: key };
@@ -79,6 +92,8 @@ function loadCfg() {
79
92
  minIntervalMs: raw.minIntervalMs ?? 3000,
80
93
  defaultDebounceMs: raw.defaultDebounceMs || 30000,
81
94
  debounceMs: raw.debounceMs,
95
+ childEvents: raw.childEvents || ["permission.asked"],
96
+ streamType: raw.streamType || "media",
82
97
  enabled: raw.enabled !== false,
83
98
  };
84
99
  LANG = raw.lang === "zh" ? "zh" : "en";
@@ -99,7 +114,26 @@ catch (e) {
99
114
  const eventTimestamps = new Map();
100
115
  const subSessions = new Set();
101
116
  let globalLastPlay = 0;
117
+ // 判断是否运行在 Termux(Android) 环境
118
+ function isTermux() {
119
+ return process.platform === "android"
120
+ || !!process.env.TERMUX_VERSION
121
+ || (process.env.PREFIX || "").includes("com.termux");
122
+ }
123
+ // 查找 Termux 内的命令绝对路径,找不到返回 null
124
+ function findTermuxBin(name) {
125
+ const prefix = process.env.PREFIX || TERMUX_PREFIX;
126
+ const p = join(prefix, "bin", name);
127
+ return existsSync(p) ? p : null;
128
+ }
102
129
  function getPlayerArgs(sound) {
130
+ if (isTermux()) {
131
+ const player = findTermuxBin("play-audio");
132
+ if (!player)
133
+ return null;
134
+ const streamArgs = cfg.streamType ? ["-s", cfg.streamType] : [];
135
+ return [player, ...streamArgs, sound];
136
+ }
103
137
  switch (process.platform) {
104
138
  case "win32":
105
139
  return ["powershell", "-NoProfile", "-Command",
@@ -123,7 +157,8 @@ function resolveSound(eventType) {
123
157
  return custom;
124
158
  if (cfg.sound && existsSync(cfg.sound))
125
159
  return cfg.sound;
126
- const builtin = join(ASSET_DIR, `${eventType === "session.idle" ? "default" : eventType.replace("session.", "")}.wav`);
160
+ const file = BUILTIN_SOUNDS[eventType] || `${eventType}.wav`;
161
+ const builtin = join(ASSET_DIR, file);
127
162
  if (existsSync(builtin))
128
163
  return builtin;
129
164
  return DEFAULT_SOUND;
@@ -136,7 +171,7 @@ function play(eventType) {
136
171
  }
137
172
  const args = getPlayerArgs(path);
138
173
  if (!args) {
139
- log.error(T("unsupported_platform", { platform: process.platform }));
174
+ log.error(isTermux() ? T("termux_no_player") : T("unsupported_platform", { platform: process.platform }));
140
175
  return Promise.resolve(false);
141
176
  }
142
177
  const [cmd, ...cmdArgs] = args;
@@ -193,7 +228,7 @@ export const SoundNotify = async () => {
193
228
  return;
194
229
  }
195
230
  const sid = event.properties?.sessionID;
196
- if (sid && subSessions.has(sid))
231
+ if (sid && subSessions.has(sid) && !cfg.childEvents?.includes(event.type))
197
232
  return;
198
233
  if (shouldPlay(event.type))
199
234
  play(event.type);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xiaoqiong0v0/opencode-sound-notify",
3
- "version": "1.1.8",
3
+ "version": "1.3.0",
4
4
  "type": "module",
5
5
  "description": "OpenCode plugin: play notification sounds on session events (idle, error, permission asked).",
6
6
  "files": [
File without changes
File without changes