arxiv MCP 服务未加载
ResolvedContext: 用户要求查 arXiv 上 Mersenne 论文
Symptom: ToolSearch 返回 No matching deferred tools found；mcp__arxiv__* 工具不可用
Root cause: .mcp.json 配置了 arxiv MCP 但当前会话未加载
Resolution
回退到 .claude/skills/arxiv/ skill
Issues & solutions
Problems encountered during development, their root causes, and how they were resolved (or where they're still open).
Open
No open issues.
Resolved
Apple sandbox 拦截 arxiv.org
ResolvedContext: 尝试 WebFetch / curl 访问 arXiv API 与 PDF
Symptom: HTTP 403 Forbidden，提示 Domain blocked by Apple Claude Code security sandbox
Root cause: arxiv.org 与 export.arxiv.org 不在 dangerous_allowed_domains.csv
Resolution
用户手动添加 arxiv.org 到 /Users/l/.claude/apple/dangerous_allowed_domains.csv
arxiv API rate-limit 长时间封禁
ResolvedContext: 首次连接 arxiv 时多次 burst 请求失败
Symptom: 正确解封后仍持续返回 14 字节 'Rate exceeded' 响应；sleep 60s/120s 后重试无效
Root cause: 失败的 burst 触发 arxiv 软封禁（15-30 分钟以上），User-Agent 不规范使惩罚加重
Resolution
停 15-30 分钟期间一次都不碰 arxiv；后续改用规范 User-Agent + 4 秒间隔；冷却后单次请求成功
files.pythonhosted.org 被 sandbox 拦截
ResolvedContext: 想用 uv run --with arxiv 调用 arxiv Python 库
Symptom: uv 抓取 arxiv-4.0.0-py3-none-any.whl.metadata 失败 — tunnel error
Root cause: files.pythonhosted.org 不在 allowlist（pypi.org 在但 files 子域不在）
Resolution
改用 curl 直连 arXiv API + 规范 User-Agent + 4s 间隔
zsh for 循环未拆分空格分隔变量
ResolvedContext: 用 bash for id in $ids 下载多个 arxiv PDF
Symptom: zsh 把整个 ids 字符串当一个值；curl 对拼接成的 URL 请求失败 http=000
Root cause: zsh 默认 NO_SH_WORD_SPLIT；与 bash 行为不同
Resolution
用数组：ids=(...) ; for id in "${ids[@]}"; do ... done
Bash sandbox 阻止 ps 命令
ResolvedContext: 想确认是否有 lingering curl 进程
Symptom: ps aux 报 'operation not permitted: ps' / Tool blocked by sandbox
Root cause: ps 不在 tool_allowlist.csv
Resolution
改用 pgrep -lf 列出进程信息