v1.1.2 看门狗隐藏启动修复

修复

• 看门狗计划任务每分钟弹出黑框命令行窗口：启动器由「.cmd 批处理 + python.exe」改为「VBS 隐藏启动器 + pythonw.exe」（窗口样式 0，完全无窗口）；旧 .cmd 启动器重装时自动清理
• watchdog install 新增 --dir 参数：多副本场景显式指定看门狗服务的正本安装，避免从开发目录执行时误指

升级说明

• 已安装用户：numalarm update，或直接重新运行 numalarm watchdog install（自动替换启动器与计划任务，无需其他操作）

v1.1.1 社区反馈修复（4 issues）

社区反馈修复

感谢 @zhangxingyu-1213 的四份高质量报告（#1 #2 #3 #4）：

• 修复 pywin32==306 无 Python 3.13 wheel 导致的安装/更新失败（#4）：三处锁定改为 pywin32>=307；依赖安装失败不再中断整个安装器流程，报错附 Python 3.13 提示
• 修复 numalarm test 假阳性（#2）：第 3 步回退主面板内嵌会话时明确标注「未确认会话」，校准输出提示先关闭目标聊天窗口
• 拨打结果新增 data.judgment 字段（#3）：template=状态模板精确判定 / threshold_fallback=时长阈值回退（附回退原因）
• CLI call 新增 --json（单行 JSON 机器可读输出）与 --force（单次豁免防抖）；SDK/HTTP 同步新增 force 参数，HTTP 新增 reason 字段（#3）
• doctor 新增音频默认设备检查（#1）：默认扬声器被虚拟声卡抢占、默认录音未指向 CABLE Output 均给出明确提示；零依赖 ctypes 实现

升级说明

• 已安装用户：进入技能目录运行 numalarm update，或重新运行 python install.py --yes
• 全新安装：python install.py 一键完成，或见 README

v1.1.0 一键安装器、多副本体检与收拢

主要更新

• 新增 install.py 一键安装器：仅标准库、幂等可重复执行、--dry-run 零副作用、--yes 非交互；自动判定当前宿主并只向该宿主注册 hook（非交互默认不注册——涉及真实拨打）
• 新增多副本体检与收拢：numalarm installs [--json] [--apply]；安装时自动发现其他 numalarm 副本，可复用其 config.yaml 与已校准模板（覆盖前自动备份到 ~/.numalarm/backups）
• hook install / hook uninstall / watchdog install / watchdog uninstall 新增 --host / --settings 作用域（默认仍为全部已探测宿主；NUMALARM_HOOK_SCOPE=current 可切为仅当前宿主）；计划任务保持全机唯一
• 修复 watchdog uninstall 误删拨打类 hook：hook 按命令分类（拨打/心跳），卸载只删各自类型；无法分类的条目宁留不误删并提示
• 修复窗口匹配可能误配外部窗口（浏览器标签标题恰好含「QQ」/目标昵称）：窗口查找/激活/等待全面支持进程过滤；同步修复负坐标窗口导致的图片匹配静默失败、超宽窗口无法归位、激活后尺寸异常
• 修复 call_elapsed_seconds 在接听/拒绝路径固定为 0；hold 跳过的日志与返回文案不再误报「用户在电脑前」
• doctor 增强：新增 [提示] 行；检查 hook 命令指向目录是否存在（缺失即 FAIL）、多副本报告、运行环境与生效配置；配置解析错误不再静默（ConfigManager.load_error）
• hook 命令优先内嵌安装目录内 .venv 的解释器（免黑框）；update 改为同时刷新拨打+心跳 hook、校验依赖同步退出码、修复非 Windows 虚拟环境路径
• requirements.txt 添加 UTF-8 BOM：修复中文注释在 GBK 默认编码环境下 pip 解析报 UnicodeDecodeError（无需改动注释）
• 非 UTF-8 输出流兼容：英文区域 Windows（cp1252 管道/重定向）下打印中文不再崩溃（stdout/stderr 错误处理器降级为 replace；console_scripts 入口点改指 main，控制台脚本与 python -m 两条路径均生效）；install.py --json 摘要统一 ASCII 转义
• 文档与 CI：README 新增「安装范围与全机副作用」「多副本体检与收拢」，SKILL.md 清理过时条目；CI 纳入 install.py（编译 / ruff / --help 冒烟）

升级说明

• 已安装用户：进入技能目录运行 numalarm update（自动保留 config.yaml 与校准模板，并刷新已注册的拨打 hook）；更新后在技能目录 .venv 内补跑一次 pip install -e .，命令行入口的最新兼容修复即可一并生效（不影响 hook 与自动拨打）
• 全新安装：直接 python install.py，或使用 README 的「小白一键安装提示词」

验证

升级后建议运行 numalarm doctor（含新增的一致性检查）与 numalarm test <目标>；完整用例见 TESTS.md。

v1.0.3 移除桌面快捷方式，聚焦 Agent 自动提醒

变更

• 移除桌面快捷方式功能：纯人工入口，与 Agent 自动提醒主线无关；手动呼叫可直接对 Agent 说「打给某人」
• numalarm uninstall 保留对旧版本已创建快捷方式的清理能力，升级后不留垃圾文件
• doctor 的 pywin32 检查项更名「语音提醒」（pywin32 现服务于接听后语音提醒的 SAPI 合成）
• config.example.yaml / config.yaml 模板 / SKILL.md / README / TESTS.md 同步清理全部快捷方式相关内容，接入方式由四种调整为三种

升级说明

• 已安装用户：进入技能目录运行 numalarm update；若曾创建桌面快捷方式，运行 numalarm uninstall 按提示清理
• 全新安装：见 README「快速开始」或「小白一键安装提示词」

v1.0.2 任务完成自动响铃与硬崩溃兜底

主要更新

• Hook 注册事件新增 Stop（Agent 回合结束=任务交付时刻）：配合在位检测实现「人离开电脑后任务完成自动响铃；人在电脑前零打扰」
• 新增 numalarm hold 暂停机制：等待子代理/CI 等「自动继续回合」免打扰，需要用户操作或最终交付时 --clear 恢复，到期自动失效防漏提醒
• 新增看门狗（可选）：PreToolUse 心跳 + 计划任务每分钟检查，Agent 硬崩溃（强杀/无响应被杀）导致 hook 失效时自动拨打兜底；心跳协议跨宿主通用
• SKILL.md 新增用户口头开关映射：「本次不使用/恢复提醒」一句话开关全部提醒层（hold 对约定层/Stop hook/看门狗同时生效）
• 小白提示词全面幂等化：装到一半中断后重复输入提示词可断点续装，不重复安装任何文件；虚拟声卡安装前先枚举音频设备检测是否已存在
• config 自动发现新增安装目录级：技能目录安装无需设置环境变量
• config.example.yaml 逐项详注：作用/默认/单位/何时调整/注意事项 + 常用场景速查，新增 watchdog 配置段
• 卸载流程补长期记忆清理提醒；README 全面修订（去特定宿主化、其他 Agent 接入指引、更新/卸载/看门狗章节）

升级说明

• 已安装用户：进入技能目录运行 numalarm update（自动保留 config.yaml 与校准模板）
• 升级后运行一次 numalarm hook install 获得新增的 Stop 事件注册；需要硬崩溃兜底再运行 numalarm watchdog install
• 全新安装：见 README「快速开始」或「小白一键安装提示词」

验证

升级后建议运行 numalarm doctor 与 numalarm test <目标>；完整用例见 TESTS.md。

v1.0.1 接听后语音提醒与在位检测

主要更新

• 新增「接听后语音提醒」（可选）：对方接听后自动播放固定语音（如「任务有新进展，请前往电脑查看」），播完自动挂断；Windows SAPI 离线合成 + 虚拟声卡注入，未装声卡自动降级
• 新增「用户在位检测」：人在电脑前（键鼠活跃）自动跳过拨打，离开后自动恢复；重拨中途回来自动停止
• 新增 numalarm update 一键更新：先检查有无新版本（无则提示已最新），更新时自动保留 config.yaml 与校准模板
• 新增 numalarm uninstall 一站式卸载清理，配合独立虚拟环境实现零残留
• 新增 numalarm doctor 环境自检；numalarm hook --settings 支持任意兼容宿主
• 修复：手动 CLI 误受在位检测限制；窗口拖出屏幕导致语音按钮无法匹配；对方秒拒被误判无人接听而不停重拨；新版 pyscreeze 空消息异常绕过重试

升级说明

• 已安装用户：进入技能目录运行 numalarm update（自动保留 config.yaml 与校准模板）
• 全新安装：见 README「快速开始」或「小白一键安装提示词」

验证

升级后建议运行 numalarm doctor 与 numalarm test <目标>；完整用例见 TESTS.md。

v1.0.0 首个公开版本

首个公开版本

• 核心拨打流程：QQ 进程校验 → 唤起主面板 → 搜索好友（剪贴板支持中文）→ 图片匹配定位语音按钮 → 模拟点击拨打
• 无人接听自动重拨 / 防抖 / 全局互斥（同一时间仅一路拨打）
• 四种接入方式：Python SDK / HTTP REST / CLI / Windows 桌面快捷方式
• 宿主 Hook 集成：Agent 停下等待用户时自动拨打
• 全配置化，附 doctor 环境自检、test 校准、init 初始化向导

安装

见 README「快速开始」，或直接使用 README 中的「小白一键安装提示词」。

验证

见 TESTS.md。