@foxden-app/foxclaw 0.5.48 → 0.5.49

package/.env.example

@@ -56,17 +56,23 @@ CODEX_CLI_BIN=/absolute/path/to/codex
 # Optional Telegram voice summaries.
 # When enabled, completed final answers get a "listen" button and /voice can
 # generate Telegram voice messages. SSH mode runs TTS and ffmpeg conversion on
-# the speech host; HTTP mode calls VOICE_TTS_URL and converts locally.
+# your own speech host; HTTP mode calls your own VOICE_TTS_URL and converts
+# locally. FoxClaw does not ship with a public TTS backend.
 # VOICE_TTS_ENABLED=false
+# HTTP backend example: compatible service exposing /v1/tts/custom or
+# /v1/tts/design and returning WAV audio. Local ffmpeg is required.
+# VOICE_TTS_MODE=http
+# VOICE_TTS_URL=http://127.0.0.1:18081
+# VOICE_TTS_TOKEN=
+# VOICE_FFMPEG_BIN=ffmpeg
+# SSH backend example: remote host has the compatible service, token in its
+# service .env, and ffmpeg available on the remote host.
 # VOICE_TTS_MODE=ssh
-# VOICE_TTS_SSH_HOST=thinkbook16p
-# VOICE_TTS_SSH_DIR=/home/wuya/dev/qwen-speech-server
+# VOICE_TTS_SSH_HOST=<ssh-host>
+# VOICE_TTS_SSH_DIR=/path/to/qwen-speech-server
 # VOICE_TTS_DESIGN_INSTRUCT=用自然清晰的中文女声朗读，语速适中。
 # VOICE_SUMMARY_BUTTON_ENABLED=true
 # VOICE_TEXT_LIMIT=2800
-# VOICE_TTS_URL=https://tts.foxden.app
-# VOICE_TTS_TOKEN=
-# VOICE_FFMPEG_BIN=ffmpeg
 
 # Optional: standard HTTP(S) proxy for Telegram and ChatGPT/Codex backend requests.
 # Put these in the same env file that `foxclaw start` installs into systemd/launchd.

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable FoxClaw changes are listed here. Each release note is bilingual so GitHub Releases and the npm package are useful to both Chinese and English readers.
 
+## 0.5.49 - 2026-06-20
+
+### 中文
+- 将 Telegram 总结语音后端彻底改为用户自配：默认不再内置 `thinkbook16p`、`tts.foxden.app` 或任何私有 TTS 服务地址。
+- 启用语音后如果缺少 `VOICE_TTS_URL` 或 `VOICE_TTS_SSH_HOST`/`VOICE_TTS_SSH_DIR`，会明确提示配置缺失，而不是尝试连接开发者私有服务。
+- 更新 `.env.example`，把 HTTP/SSH 语音后端写成通用占位示例，明确 FoxClaw 不随包提供公共 TTS 后端。
+
+### English
+- Made the Telegram voice-summary backend fully user-configured: FoxClaw no longer embeds `thinkbook16p`, `tts.foxden.app`, or any private TTS service endpoint as a product default.
+- When voice is enabled without `VOICE_TTS_URL` or `VOICE_TTS_SSH_HOST`/`VOICE_TTS_SSH_DIR`, FoxClaw now reports the missing configuration instead of trying a developer-private service.
+- Updated `.env.example` to show generic HTTP/SSH backend placeholders and state that FoxClaw does not ship with a public TTS backend.
+
 ## 0.5.48 - 2026-06-20
 
 ### 中文

package/dist/config.d.ts

@@ -67,8 +67,8 @@ export interface AppConfig {
     voiceTtsMode: 'http' | 'ssh';
     voiceTtsUrl: string | null;
     voiceTtsToken: string | null;
-    voiceTtsSshHost: string;
-    voiceTtsSshDir: string;
+    voiceTtsSshHost: string | null;
+    voiceTtsSshDir: string | null;
     voiceTtsDesignInstruct: string;
     voiceFfmpegBin: string;
     voiceSummaryButtonEnabled: boolean;

package/dist/config.js

@@ -98,11 +98,11 @@ export function loadConfig() {
         authSyncTempDir: process.env.AUTH_SYNC_TEMP_DIR || DEFAULT_AUTH_SYNC_TEMP_DIR,
         authAutoDeleteNeedsRepair: boolEnv('AUTH_AUTO_DELETE_NEEDS_REPAIR', false),
         voiceTtsEnabled: boolEnv('VOICE_TTS_ENABLED', false),
-        voiceTtsMode: parseVoiceTtsMode(process.env.VOICE_TTS_MODE || (process.env.VOICE_TTS_URL?.trim() ? 'http' : 'ssh')),
-        voiceTtsUrl: optional('VOICE_TTS_URL') ?? 'https://tts.foxden.app',
+        voiceTtsMode: parseVoiceTtsMode(process.env.VOICE_TTS_MODE || (process.env.VOICE_TTS_SSH_HOST?.trim() ? 'ssh' : 'http')),
+        voiceTtsUrl: optional('VOICE_TTS_URL'),
         voiceTtsToken: optional('VOICE_TTS_TOKEN'),
-        voiceTtsSshHost: process.env.VOICE_TTS_SSH_HOST?.trim() || 'thinkbook16p',
-        voiceTtsSshDir: process.env.VOICE_TTS_SSH_DIR?.trim() || '/home/wuya/dev/qwen-speech-server',
+        voiceTtsSshHost: optional('VOICE_TTS_SSH_HOST'),
+        voiceTtsSshDir: optional('VOICE_TTS_SSH_DIR'),
         voiceTtsDesignInstruct: process.env.VOICE_TTS_DESIGN_INSTRUCT?.trim() || '用自然清晰的中文女声朗读，语速适中。',
         voiceFfmpegBin: process.env.VOICE_FFMPEG_BIN?.trim() || 'ffmpeg',
         voiceSummaryButtonEnabled: boolEnv('VOICE_SUMMARY_BUTTON_ENABLED', true),

package/dist/voice/tts.js

@@ -105,6 +105,12 @@ async function convertToOggOpus(input, ffmpegBin) {
     }
 }
 async function synthesizeViaSsh(text, config) {
+    if (!config.voiceTtsSshHost) {
+        throw new Error('VOICE_TTS_SSH_HOST is not configured');
+    }
+    if (!config.voiceTtsSshDir) {
+        throw new Error('VOICE_TTS_SSH_DIR is not configured');
+    }
     const encodedText = Buffer.from(text, 'utf8').toString('base64');
     const script = String.raw `set -euo pipefail
 TEXT="$(printf '%s' "$1" | base64 -d)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxden-app/foxclaw",
-  "version": "0.5.48",
+  "version": "0.5.49",
   "description": "Foxden local execution claw for controlling Codex from trusted chat interfaces.",
   "type": "module",
   "main": "dist/main.js",