背景
README 和 API 文档已经说明辅助功能权限、屏幕录制、CDP 端口、快照有效期和 unknown 结果等概念,但用户遇到问题时仍缺少按症状组织的排查路径。
建议
补充一份故障排查文档,覆盖权限不足、Swift 或 Node.js 版本不满足、CDP 端口归属未确认、快照过期、目标不唯一、用户活动或锁冲突,以及写入后结果为 unknown 等情况。
验收标准
- 每类问题都有复现条件、排查命令、预期输出和下一步处理方式。
- 明确 unknown 不等于未执行,禁止通过盲目重试掩盖未知结果。
- 将文档入口加入 README、API.md 或对应参考文档。
背景
README 和 API 文档已经说明辅助功能权限、屏幕录制、CDP 端口、快照有效期和 unknown 结果等概念,但用户遇到问题时仍缺少按症状组织的排查路径。
建议
补充一份故障排查文档,覆盖权限不足、Swift 或 Node.js 版本不满足、CDP 端口归属未确认、快照过期、目标不唯一、用户活动或锁冲突,以及写入后结果为 unknown 等情况。
验收标准