项目协作规则

基本原则

• 禁止添加任何回退逻辑（fallback）。
• 禁止添加掩盖根因的“胶水代码”。
• 默认采用单一路径、可预测行为；未经明确要求，不引入隐式分支。

失败处理

• 失败应直接暴露，不做静默兜底。
• 错误信息必须清晰、可定位，日志应包含关键上下文。
• 发现问题优先修复根因，不通过绕路方案规避。

变更约束

• 小步修改，保持最小必要改动。
• 不在未被要求的范围内扩散改动。
• 规则优先级：用户明确要求 > 本文件约束。

文档索引

• 页面 URL、命令功能和当前位置要求记录在 docs/boss-url-map.md。
• 修改导航、命令入口、当前位置校验或 help 文案前，先查阅并同步更新该文档。

Puppeteer evaluate 约束（重要）

• 在工具代码中，避免使用 page.evaluate(() => { ... }) / page.waitForFunction(() => { ... }) 的函数写法。
• 统一改为字符串脚本写法（如 page.evaluate("(() => { ... })()")），避免构建后注入辅助符号导致浏览器上下文报错 __name is not defined。
• 出现 __name is not defined 时，优先检查最近新增的 evaluate / waitForFunction 回调并改成字符串脚本，不要加兜底掩盖问题。