karuo-ai/01_卡资（金）/金仓_存储备份/Handy中文语音/SKILL.md

name, description, group, memory_palace_path, memory_palace_slot, triggers, owner, version, updated, related

name	description	group	memory_palace_path	memory_palace_slot	triggers	owner	version	updated	related
Handy中文语音	macOS/Windows Handy 中文语音+语音唤醒卡若AI Agent（⌘1/Ctrl+1）。触发词：Handy、卡若AI语音、语音唤醒、呼叫卡若AI、全局语音、⌘1、Ctrl+1、SenseVoice、按住说话。	金	卡若记忆宫殿/金殿/金仓厢/听写台	本机按住说话，中文落字；纠错在 Cursor 回廊洗字	Handy、全局语音、卡若AI语音、语音唤醒、呼叫卡若AI、喊卡若AI、Windows Handy、⌘1、Ctrl+1、语音输入、SenseVoice、按住说话、Handy中文、handy_apply、语音Agent	金仓	1.4	2026-07-12	01_卡资（金）/金仓_存储备份/Cursor持久对话/SKILL.md 02_卡人（水）/水溪_整理归档/语音转写纠错/SKILL.md 运营中枢/参考资料/闽南话语音_ASR纠错机制.md 运营中枢/参考资料/卡若闽南口音_ASR纠错库.json

Handy中文语音（G25b · 金仓）

一句话：macOS（Apple Silicon · ⌘1 · CoreML）与 Windows（x64/ARM64 · Ctrl+1 · DirectML）用 Handy 0.8.3 + SenseVoice 按住说话→先回廊洗字再自动输入（如 纯客宝→存客宝）；五笔输入法不变。

适用场景

场景	做法
新装 / 重装 Handy	脚本/install_all.sh 或安装包 双击安装.command
又变英文 / auto	先 killall -9 handy，再跑 handy_apply_chinese_macos.sh，UI 里语言改简体中文
与豆包 / Murmur 迁移	本 Skill 为当前真源；豆包 IME 已卸
卡若 ASR 纠错	⌘1 粘贴前即洗字（handy_apply_chinese_macos.sh）；官网/Agent 同步 W03b；只展示洗后文
语音唤 Agent	说「卡若AI + 任务」或「火炬/金仓 + 任务」→ pipeline 静默 Hub / 官网（见下）
语音 · 需求整理	先说 小乖/乖乖/小宝，再说「整理需求 …」→ 直投 Hub 语音·需求整理（不粘贴输入框；见 setup_handy_voice_exec_wake.sh）

一键安装（Agent / 终端）

bash "/Users/karuo/Documents/个人/卡若AI/01_卡资（金）/金仓_存储备份/Handy中文语音/脚本/install_all.sh"

可分发安装包（4、火_工具开发/工具/Handy中文语音/）：

平台	解压后双击	ZIP
macOS	Handy中文语音-安装包-macOS-v1.0/双击安装Handy中文语音.command	Handy中文语音_macOS_安装包_YYYYMMDD.zip
Windows	Handy中文语音-安装包-Windows-v1.0/双击安装Handy中文语音.bat	Handy中文语音_Windows_安装包_YYYYMMDD.zip

打包（Mac 上执行，产出双平台 zip）：bash …/Handy中文语音/脚本/build_package.sh

语音唤醒 · 卡若AI Agent 插件（G25b+）

口述 「卡若AI …」 或 成员名 + 任务（如「火炬 查 Agent 接口」）→ 不粘贴，改为：

1. 回廊洗字（卡若闽南口音_ASR纠错库.json）
2. 有 Hub → init/reply/continue；有 ~/.karuo/agent.json → POST /api/team/run；均无则只粘贴洗后文，不弹窗
3. 本机 Mongo voice_transcripts 记 raw/corrected（可选，失败静默）

文件	作用
运营中枢/工作台/脚本/karuo_voice_pipeline.py	统一流水线真源
运营中枢/工作台/脚本/karuo_voice_agent_plugin.py	薄封装
…/脚本/handy_paste_or_karuo_agent.sh / .bat	Handy external_script 入口
Handy中文语音/脚本/setup_voice_agent_plugin.ps1	Windows 推荐 一键接入
Handy中文语音/脚本/setup_voice_agent_plugin.sh	macOS（external_script 有风险，默认跳过）
references/语音唤醒卡若AI.md	唤醒词与接线说明
references/语音唤醒需求整理.md	W05b 需求整理 唤醒词与接线
运营中枢/工作台/脚本/karuo_voice_requirement_plugin.py	仅需求整理薄封装
…/脚本/handy_voice_requirement.sh	Handy 可选 external_script

# macOS 稳定投递（Handy 转写进剪贴板后）：
pbpaste | python3 "/Users/karuo/Documents/个人/卡若AI/运营中枢/工作台/脚本/karuo_voice_agent_plugin.py"

# Windows（配置 external_script 后按住 Ctrl+1 直接说）：
# …\setup_voice_agent_plugin.ps1

依赖：G22b 持久对话 Hub 已 install.sh 且 curl -s 127.0.0.1:13458/api/health 为 ok。

标准流水线

① arm64 Handy（禁 brew cask x86）
② 下载 sense-voice-int8（~228MB）
③ 禁用 parakeet 英文模型目录
④ 写入 settings_store.json（zh-Hans + ⌘1 + ctrl_v + coreml）
⑤ 启动 Handy → UI 核对「简体中文」与 SenseVoice 活跃
⑥ 按住 ⌘1 试句 → 看 handy.log

脚本索引

脚本	平台
Handy中文语音/脚本/install_all.sh	macOS 总装
…/脚本/handy_install_arm64.sh	macOS arm64 DMG
…/脚本/handy_apply_chinese_macos.sh	macOS 写配置
…/脚本/handy_install_windows.ps1	Windows 静默安装 exe
…/脚本/handy_apply_chinese_windows.py + .ps1	Windows 写配置
Handy中文语音/脚本/handy_download_sensevoice.ps1	Windows 下模型
…/脚本/build_package.sh	打 macOS + Windows 双 zip

Windows 要点

项	值
配置	%APPDATA%\com.pais.handy\settings_store.json
快捷键	control_left+1（Ctrl+1 按住说话）
加速	ort_accelerator=directml
依赖	安装脚本需 Python 3；安装 Handy 建议 管理员 运行 bat
界面速查	references/Handy设置界面速查_Windows.md

Handy 设置界面（macOS · 必须 UI 点一次语言）

打开：菜单栏 Handy 图标 → 设置 或 ⌘ ,

左侧	位置	目标值
模型	已下载 → SenseVoice 卡片	活跃
通用	SenseVoice 设置 → 语言	简体中文（勿「自动」）
通用	转录快捷键	⌘1（点框后按 ⌘+1）
通用	按住说话	开
高级 → 应用	开机启动	关（防双实例冲配置）
高级 → 输出	粘贴方式	剪贴板 (Cmd+V)（勿外部脚本）
高级 → 应用	实验性功能	开 → 实验性 → ONNX 加速

目标配置（磁盘键）

路径：~/Library/Application Support/com.pais.handy/settings_store.json

键	值
selected_model	sense-voice-int8
selected_language	zh-Hans
paste_method	ctrl_v
external_script_path	null
bindings.transcribe.current_binding	command_left+1
push_to_talk	true
autostart_enabled	false
ort_accelerator	coreml

模型目录：~/Library/Application Support/com.pais.handy/models/sense-voice-int8/
日志：~/Library/Logs/com.pais.handy/handy.log

与回廊洗字（W03b）分工

环节	负责
语音→文字	Handy + SenseVoice
误听→正写	卡若闽南口音_ASR纠错库.json
纠错执行点	Cursor 每轮 apply_karuo_voice_corrections.py（W03b）
Handy输入插件	macOS 0.8.3 用 $1 接收原转写；插件纠错、等待焦点恢复并自动执行 ⌘V

验收

1. tail -30 ~/Library/Logs/com.pais.handy/handy.log 含 zh-Hans、sense-voice-int8
2. 记事本按住 ⌘1 说「卡若语音输入测试」→ 松开 → 粘贴为中文
3. 五笔输入法未被 Handy 修改

排障速查

现象	处理
英文乱码 / yu pizza yin	语言被改回 auto → UI 改简体中文 + 重跑 handy_apply_chinese_macos.sh
转录为空	多为 x86 Handy → 重装 handy_install_arm64.sh
配置写了又变	killall -9 handy（进程名小写 handy）；关开机启动；勿开外部脚本
两个 Handy	活动监视器只留一个；autostart_enabled=false

详见 evolution/gotchas.md、references/Handy设置界面速查.md。

Gotchas（摘要）

• 禁止 brew install --cask handy（易 x86）
• macOS 仅允许使用已验证的 handy_macos_asr_paste.sh；Handy 0.8.3 ExternalScript 只传 $1 且忽略 stdout，插件必须自行输入

2026-07-12 输入阶段纠错

Handy 已可在文字进入当前输入框前调用卡若AI统一词库：

语音 → SenseVoice转写 → 卡若闽南口音_ASR纠错库.json → 洗后文字 → 当前输入框

交互铁律：松开语音键后，Handy 自动把洗后文字写入当前焦点对话框；用户不需要再按 ⌘V。默认 auto_submit=false，只填入、不自动发送，便于发送前检查。

启用或修复命令：

bash "脚本/enable_karuo_asr_correction_macos.sh"

验收例句：“打开纯客宝后台”必须输入为“打开存客宝后台”。

• 禁止 killall Handy 当唯一手段（应 killall -9 handy）
• 语言必须在 UI 确认，仅改 JSON 可能被启动覆盖