@xdfnet/ispeak 1.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xdfnet
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,194 @@
+# iSpeak
+
+![Version](https://img.shields.io/badge/version-1.6.1-blue)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Go Version](https://img.shields.io/badge/Go-1.26-blue)](https://golang.org/dl/)
+![Platform](https://img.shields.io/badge/platform-macOS-green)
+
+iSpeak 让 AI 编程助手开口说话。你写代码，它播结果——眼睛休息，耳朵来听。
+
+适合 Claude Code 或 Codex 常驻后台的开发者。AI 完成任务后自动播报；你发新消息时，旧播报立即中断，不花冤枉钱。
+
+## 效果示例
+
+```
+# 默认音色：温柔女声
+ispeak "Pull request 已合并，3 个测试通过"
+
+# Claude 模式：专属音色
+ispeak-claude "Code review 完成，发现 2 处可优化"
+
+# Codex 模式：另一种音色
+ispeak-codex "构建完成，耗时 12 秒"
+```
+
+## 为什么选 iSpeak
+
+| 问题 | 方案 |
+|------|------|
+| AI 生成多条回复，TTS 账单飞涨 | 新消息只保留最新待合成任务，避免无效合成 |
+| 回复快慢不一，音频播报乱序 | 单 speak worker，FIFO 顺序稳定 |
+| 修改配置要重启服务 | 热更新：编辑 `config.json` 立即生效 |
+| 默认音色太无聊 | 来源专属音色，Claude 和 Codex 声音不同 |
+
+## 快速上手
+
+**npm 安装：**
+
+```bash
+npm i -g @xdfnet/ispeak
+```
+
+当前 npm 安装会在本机编译 `ispeakd`，需要已安装 Go。没有 `ffplay` 时会自动回退 `afplay`；推荐安装 `ffmpeg` 获得流式播放：
+
+```bash
+brew install ffmpeg
+```
+
+**源码安装：**
+
+```bash
+git clone https://github.com/xdfnet/iSpeak.git && cd iSpeak && make install
+```
+
+安装时手动输入 API Key，然后验证：
+
+```bash
+ispeak status
+ispeak test "iSpeak 准备好了"
+```
+
+## 工作原理
+
+```
+你："重构 auth 模块"
+        │
+        ▼
+┌─────────────────────────────────────────────────────┐
+│  ispeakd — Mac 上常驻的守护进程                      │
+│                                                       │
+│   通过 Unix Socket 接收文本                          │
+│         │                                            │
+│         ▼                                           │
+│   任务引擎                                           │
+│   （pending_synth → speaking → delete）              │
+│         │                                            │
+│         ▼                                           │
+│   单 Worker 流式链路                                 │
+│   （SSE audio chunk → 播放器 stdin）                  │
+│         │                                            │
+│         ▼                                           │
+│   流式播放器                                         │
+│   （优先 ffplay stdin，无 ffplay 回退 afplay）         │
+└─────────────────────────────────────────────────────┘
+```
+
+**任务状态流转：**
+```
+pending_synth → speaking → delete
+```
+
+## 全部命令
+
+```bash
+ispeak "消息"    # 播报
+ispeak status    # 服务状态
+ispeak restart   # 重启服务
+ispeak version   # 版本
+```
+
+语音专属快捷命令（指向 ispeak 的软链接）：
+```bash
+ispeak-claude "消息"   # Claude 专属音色
+ispeak-codex "消息"    # Codex 专属音色
+```
+
+## 配置说明
+
+`~/.config/iSpeak/config.json`：
+
+```json
+{
+  "apiKey": "你的火山引擎 API Key",
+  "endpoint": "https://openspeech.bytedance.com/api/v3/tts/unidirectional",
+  "defaultVoice": {
+    "voice_type": "zh_female_mizai_uranus_bigtts",
+    "resourceId": "seed-tts-2.0"
+  },
+  "sourceVoices": {
+    "claude": {
+      "voice_type": "zh_female_tianmeitaozi_uranus_bigtts",
+      "resourceId": "seed-tts-2.0"
+    },
+    "codex": {
+      "voice_type": "zh_male_shaonianzixin_uranus_bigtts",
+      "resourceId": "seed-tts-2.0"
+    }
+  }
+}
+```
+
+音色库参考 [火山引擎 TTS 控制台](https://console.volcengine.com/tts)，填写对应的 `voice_type` 和 `resourceId` 即可。
+
+## 集成说明
+
+### Claude Code
+
+在 `~/.claude/settings.json` 中添加 Stop Hook：
+
+```json
+{
+  "hooks": {
+    "Stop": [{
+      "hooks": [{
+        "type": "command",
+        "command": "bash $HOME/.config/iSpeak/hook-speak.sh claude",
+        "timeout": 30
+      }]
+    }]
+  }
+}
+```
+
+### Codex
+
+在 `~/.codex/hooks.json` 中添加 Stop Hook：
+
+```json
+{
+  "hooks": {
+    "Stop": [{
+      "hooks": [{
+        "type": "command",
+        "command": "bash $HOME/.config/iSpeak/hook-speak.sh codex",
+        "timeout": 30
+      }]
+    }]
+  }
+}
+```
+
+## 开发命令
+
+```bash
+make build      # 编译 ispeakd
+make install    # 安装并启动服务（自动自检）
+make deploy     # 安装 + 部署配置文件（不覆盖已有配置）
+make uninstall  # 卸载（停止服务 + 删除文件）
+make clean      # 清理编译产物
+make help       # 显示帮助
+```
+
+## 文件路径
+
+| 文件 | 用途 |
+|------|------|
+| `~/Library/LaunchAgents/com.iSpeak.plist` | macOS 自动启动服务 |
+| `~/.config/iSpeak/ispeak.sock` | Unix Socket |
+| `~/.config/iSpeak/ispeak.log` | 日志（轮转） |
+| `~/.config/iSpeak/config.json` | 你的 API Key 和音色配置 |
+| `~/.config/iSpeak/hook-speak.sh` | Claude/Codex Hook 脚本 |
+
+## License
+
+MIT — 随便用，随便改。

package/configs/com.iSpeak.plist

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.iSpeak</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>BINARY_PATH_PLACEHOLDER</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>/tmp/iSpeak.log</string>
+    <key>StandardErrorPath</key>
+    <string>/tmp/iSpeak.log</string>
+</dict>
+</plist>

package/configs/config.example.json

@@ -0,0 +1,18 @@
+{
+  "apiKey": "your-api-key",
+  "endpoint": "https://openspeech.bytedance.com/api/v3/tts/unidirectional",
+  "defaultVoice": {
+    "voice_type": "zh_female_mizai_uranus_bigtts",
+    "resourceId": "seed-tts-2.0"
+  },
+  "sourceVoices": {
+    "claude": {
+      "voice_type": "zh_female_tianmeitaozi_uranus_bigtts",
+      "resourceId": "seed-tts-2.0"
+    },
+    "codex": {
+      "voice_type": "zh_male_shaonianzixin_uranus_bigtts",
+      "resourceId": "seed-tts-2.0"
+    }
+  }
+}

package/configs/hook-speak.sh

@@ -0,0 +1,76 @@
+#!/bin/bash
+# Stop Hook: 从 transcript 文件中提取本次会话所有 Claude 回复文本
+# iAgent 调用 Claude 时设 ISPEAK_SKIP=1，此时跳过（iAgent 自己播）
+[[ "$ISPEAK_SKIP" == "1" ]] && exit 0
+
+# 来源参数: claude 或 codex
+SOURCE="${1:-claude}"
+
+SOCK="$HOME/.config/iSpeak/ispeak.sock"
+LOG="$HOME/.config/iSpeak/hook.log"
+
+input=$(cat)
+
+# 从 stdin JSON 提取 transcript 路径和最后一条消息
+# 简单 JSON 解析（不依赖 python3）
+transcript=$(echo "$input" | sed -n 's/.*"transcript_path"\s*:\s*"\([^"]*\)".*/\1/p')
+last_msg=$(echo "$input" | sed -n 's/.*"last_assistant_message"\s*:\s*"\([^"]*\)".*/\1/p')
+
+all_text="$last_msg"
+
+# 如果有 transcript 文件，提取最近 30 秒内的所有 assistant 消息
+if [[ -n "$transcript" && -f "$transcript" ]]; then
+  # 计算 30 秒前的时间戳（毫秒）
+  cutoff=$(($(date +%s) * 1000 - 30000))
+
+  # 用 awk 解析 JSON lines，提取 role=assistant 且 timestamp > cutoff 的 text
+  extra=$(awk -v cutoff="$cutoff" '
+    {
+      # 提取 timestamp
+      if (match($0, /"timestamp"\s*:\s*[0-9]+/)) {
+        ts = substr($0, RSTART, RLENGTH)
+        gsub(/[^0-9]/, "", ts)
+        ts = int(ts)
+        if (ts < cutoff) next
+      }
+
+      # 提取 role
+      if (match($0, /"role"\s*:\s*"assistant"/)) {
+        # 提取 content（可能是字符串或数组）
+        if (match($0, /"content"\s*:\s*\[/)) {
+          # 数组形式，提取所有 text 字段
+          gsub(/[^{]*\[/, "", $0)
+          gsub(/\].*/, "", $0)
+          while (match($0, /"text"\s*:\s*"[^"]*"/)) {
+            t = substr($0, RSTART, RLENGTH)
+            gsub(/"text"\s*:\s*"/, "", t)
+            gsub(/"$/, "", t)
+            if (t != "") print t
+            $0 = substr($0, RSTART + RLENGTH)
+          }
+        } else if (match($0, /"content"\s*:\s*"\([^"]*\)"/)) {
+          t = substr($0, RSTART, RLENGTH)
+          gsub(/"content"\s*:\s*"/, "", t)
+          gsub(/"$/, "", t)
+          if (t != "") print t
+        }
+      }
+    }
+  ' "$transcript" 2>/dev/null | sort -u | tr '\n' ' ')
+
+  if [[ -n "$extra" ]]; then
+    all_text="$extra"
+  fi
+fi
+
+echo "=== $(date) ===" >> "$LOG"
+echo "SOURCE: $SOURCE" >> "$LOG"
+echo "TEXT_LEN: ${#all_text}" >> "$LOG"
+echo "PREVIEW: ${all_text:0:150}" >> "$LOG"
+
+if [[ -n "$all_text" && -S "$SOCK" ]]; then
+  printf "{source:%s}%s" "$SOURCE" "$all_text" | nc -U -w5 "$SOCK" 2>> "$LOG"
+  echo "SPOKE: OK" >> "$LOG"
+else
+  echo "SPOKE: SKIP" >> "$LOG"
+fi

package/go.mod

@@ -0,0 +1,5 @@
+module iSpeak
+
+go 1.26.2
+
+require gopkg.in/natefinch/lumberjack.v2 v2.2.1

package/go.sum

@@ -0,0 +1,4 @@
+golang.org/x/net v0.40.0 h1:79Xs7wF06Gbdcg4kdCCIQArK11Z1hr5POQ6+fIYHNuY=
+golang.org/x/net v0.40.0/go.mod h1:y0hY0exeL2Pku80/zKK7tpntoX23cqL3Oa6njdgRtds=
+gopkg.in/natefinch/lumberjack.v2 v2.2.1 h1:bBRl1b0OH9s/DuPhuXpNl+VtCaJXFZ5/uEFST95x9zc=
+gopkg.in/natefinch/lumberjack.v2 v2.2.1/go.mod h1:YD8tP3GAjkrDg1eZH7EGmyESg/lsYskCTPBJVb9jqSc=