claudeplus/mdTemplet/debug.md

Debug / Pitfalls

按工具 / 主题分节：## <tool> 为二级分组，具体坑用 ### YYYY-MM-DD 简述 + 症状 / 原因 / 规避 三联。同工具的坑逐步往下追加。

eza

2026-04-21 --tree 无路径参数静默空输出

• 症状: eza --tree --git-ignore --level=2 输出空, exit 0
• 原因: eza tree 模式需要显式路径参数
• 规避: 总是加 .（或其他路径）

broot

2026-04-21 无法在非交互环境使用

• 症状: broot --cmd ":pt;:q" 报 Termimad Error: IO error: No such device
• 原因: broot 需要 TTY, 设计就是交互工具
• 规避: CLI/Claude Code 场景直接用 eza + fd + rg
• 附注: 首次运行会自动 patch ~/.bashrc 和 ~/.zshrc 注入 br 函数

repomix

2026-04-21 大仓库 token 预算

• 症状: nexus4cc (203M 磁盘) 经 .gitignore 过滤后仍 144k tokens
• 原因: 前端单文件（如 Terminal.tsx 21k tokens）累积
• 规避: > 100k tokens 的仓库按子目录切片 (repomix frontend/src -o /tmp/fe.xml)