Notebooklm 故障排查

# NotebookLM 技能故障排除指南 ## 快速修复表 | 错误 | 解决方案 | |-------|----------| | ModuleNotFoundError | 使用 `python scripts/run.py [script].py` | | 身份验证失败 | 设置时浏览器必须可见 | | 浏览器崩溃 | `python scripts/run.py cleanup_manager.py --preserve-library` | | 达到速率限制 | 等待 1 小时或切换账号 | | 未找到笔记本 | `python scripts/run.py notebook_manager.py list` | | 脚本无法工作 | 始终使用 run.py 包装器 | ## 关键：始终使用 run.py 大多数问题可以通过使用 run.py 包装器来解决： bash # ✅ 正确 - 始终： python scripts/run.py auth_manager.py status python scripts/run.py ask_question.py --question "..." # ❌ 错误 - 切勿： python scripts/auth_manager.py status # ModuleNotFoundError! ## 常见问题与解决方案 ### 身份验证问题 #### 未经身份验证错误 Error: Not authenticated. Please run auth setup first. **解决方案：** bash # 检查状态 python scripts/run.py auth_manager.py status # 设置身份验证 (浏览器必须可见！) python scripts/run.py auth_manager.py setup # 用户必须手动登录 Google # 如果设置失败，尝试重新身份验证 python scripts/run.py auth_manager.py reauth #### 身份验证频繁过期 **解决方案：** bash # 清除旧的身份验证 python scripts/run.py cleanup_manager.py --preserve-library # 全新身份验证设置 python scripts/run.py auth_manager.py setup --timeout 15 # 使用持久化浏览器配置文件 export PERSIST_AUTH=true #### Google 阻止自动化登录 **解决方案：** 1. 使用专用的 Google 账号进行自动化 2. 如果可用，启用“安全性较低的应用访问权限” 3. 始终使用可见浏览器： bash python scripts/run.py auth_manager.py setup # 浏览器必须可见 - 用户手动登录 # 不存在无头模式参数 - 调试请使用 --show-browser ### 浏览器问题 #### 浏览器崩溃或挂起 TimeoutError: Waiting for selector failed **解决方案：** bash # 杀死挂起的进程 pkill -f chromium pkill -f chrome # 清理浏览器状态 python scripts/run.py cleanup_manager.py --confirm --preserve-library # 重新身份验证 python scripts/run.py auth_manager.py reauth #### 未找到浏览器错误 **解决方案：** bash # 通过 run.py 安装 Chromium (自动) python scripts/run.py auth_manager.py status # run.py 将自动安装 Chromium # 或者如果需要，手动安装 cd ~/.claude/skills/notebooklm source .venv