Percy Notch 0.2.8 · 刘海提醒与审批助手

一、适用范围
• macOS 13 或更新版本。通用二进制包含 Apple Silicon（M 系列）和 Intel 两种架构。
• 本版在 Apple Silicon / macOS 15.5 做过运行测试；Intel 为交叉编译，未在 Intel 实机上验收。
• 需要另外安装并运行目标应用。原生提问和删除确认识别针对中文 目标应用（已验证版本 5.7.6），不是 另一兼容客户端。
• 不是通用弹窗点击器。目标应用的界面或辅助功能结构发生变化后，可能不再匹配；请回原应用处理。

二、首次安装
1. 解压后将“Percy Notch.app”拖到“应用程序”。不要在压缩包、临时目录或只读磁盘映像中直接配置 Hook。
2. 打开应用。它主要显示在屏幕顶部与菜单栏，不会打开一个普通主窗口，也不会常驻 Dock。
3. 点击顶部提醒区域，再点调节图标；或从菜单栏图标进入“接入设置”。
4. 此分享包是本地 ad-hoc 签名，未经过 Apple Developer ID 公证。若 macOS 阻止打开，先确认提供者及文件来源，再按系统“隐私与安全性”中的提示选择“仍要打开”。若显示已损坏、恶意软件警告，或组织策略禁止，停止安装并联系提供者；不要关闭 Gatekeeper、SIP 或清除系统安全属性来强行运行。

三、后台提问提醒
• 设置中的“后台等待回答时，在刘海提醒”默认开启。
• 在“系统设置 → 隐私与安全性 → 辅助功能”中允许 Percy Notch。只授权本应用，不需要给终端或其他助手授权，也无需安装诊断工具。
• 保持目标应用窗口打开，切到其他应用即可；不要用 ⌘H 隐藏或最小化目标应用。
• 支持的待回答题卡稳定出现后，刘海显示题目和页码。“去回答”仅切回目标应用，不会选择、输入、翻页、跳过或提交。
• 同一问题主动收起后不会循环弹出。真实 1/1 卡片已获用户确认，多页实际变体未逐项现场验证。

四、删除确认与普通工具审批
• 若需要在刘海处理原生批量删除卡，单独开启“在刘海显示真实的批量删除确认卡”，并授权辅助功能。
• 仅支持已明确适配的“允许本次删除 / 取消删除”卡片；显式点击后会重新校验原窗口、按钮与完整上下文。不能完整读取或状态变化时拒绝代点。
• 普通工具权限请求需要另外安装 Hook：先将应用放在固定位置，再在接入设置中选 目标应用、预览并确认安装；若原进程缓存配置，保存工作后自行重启目标应用。
• 只接入 PermissionRequest，不逐条拦截普通 Bash，不自动允许，也不更改目标应用的全局权限模式。
• 不要复制别人的目标应用配置。每台 Mac 都应在自己的账户下安装 Hook 与授权。

五、后台本轮结束提醒（新增）
• 进入设置的“本轮结束提醒（独立 Hook）”，点击“安装结束提醒接入…”，确认后开启。分享包不带任何人的开关或配置，新用户默认关闭。
• 已验证目标应用5.7.6 会发出同会话、同一轮的 UserPromptSubmit → FinalStop(completed) 事件；这项检测本身不需要辅助功能权限。
• 只提醒接入并开启后新开始的轮次：在目标应用发出任务后切到其他应用，后台正常结束时显示“本轮已结束”。已经完成或接入前就开始的任务不补报。
• 默认约4秒自动收起，短期未读保留至结束后30秒；鼠标停留时不打断阅读，切换工作区应用可能清除提醒。审批、回执和等待回答的提醒优先。
• “打开 目标应用”只激活原应用，不自动选择会话、提交答案或执行任务；“知道了”只消除本地提醒。
• 失败、取消、中断、缺字段、无法配对和前台结束不作为完成提示。只表示本轮结束，不保证云端视频生成、上传、后台队列等全部完成，更不替代对产物质量的检查。
• 自然完成已取得真实事件样本；异常/子代理等边界主要通过静态实现核查与合成回归验证，未逐项现场验收。不兼容版本保守地不提醒。
• 关闭开关停止监听，不改目标应用的任务；要从配置中移除通知命令，请用“移除结束提醒接入…”。不会移除审批 Hook。

六、更新、移动与卸载
• 更新前从设置底部退出旧助手；有待审请求时先自行处理，或明确交回目标应用。不要同时运行多个副本。
• 本地签名更新后，辅助功能授权可能失效。必要时在系统设置中移除旧条目，再通过“+”重新添加新应用，由你手动授权。
• 应用路径变化后，需在新位置的设置中重新安装本应用 Hook，使路径更新；不会覆盖其他 Hook 或密钥。
• 卸载前在设置中分别移除本应用的审批接入和结束提醒接入，再退出助手并撤销它的辅助功能权限。退出助手不会退出目标应用，也不会自动批准任务。

七、隐私与分发内容
• 本包只有应用和本说明。不含任何用户配置、聊天、诊断报告、密钥、开发研究资料或私人配置备份。
• 不截图、不上传命令或题面；原生检测只访问目标应用的辅助功能树。普通 Hook 通过本机同用户私有 Unix socket 通信。
• 结束提醒使用另一条本机通知通道，只传会话/轮次等不透明标识、事件类型、结束原因与时间；不保留 Hook 中的提问/回复正文、不打开聊天记录文件，不在磁盘积累通知历史。开发期脱敏探针已与分享应用分离，不随包提供。
• 配置安装会在接收者自己账户下创建仅该用户可读的备份，其中可能含该用户已有密钥；不要分享这些备份。
• 本应用与腾讯、目标应用、Coucou 无隶属关系，不是官方客户端。刘海交互设计参考 Coucou（https://github.com/Louis-CFM/coucou）；图标使用本项目用户提供的设计。
