deadends.dev

deadends.dev 是一个面向 AI 智能体的结构化失败知识基础设施，核心目标是阻止 AI 智能体重复已知失败——既包括代码错误，也包括现实世界中的国家特定规则。

用途

AI 助手常犯两类错误：一是尝试已知无效的代码修复，二是给出看似合理但不符合当地法规或文化的全球通用答案。deadends.dev 针对这两类问题提供结构化知识库，帮助智能体避免重复失败。

主要能力

• 代码错误知识库：包含 2,089 条条目，覆盖 51 个领域，记录当智能体遇到 ModuleNotFoundError、CUDA OOM、CrashLoopBackOff 等错误时不应尝试的修复方案。
• 国家范围现实规则：包含 250+ 条条目，覆盖 52 个国家，涉及签证规则（ETA/eVisitor、NZeTA、电子签证、入境卡）、银行要求、法律红线（如冒犯君主罪、§86a、第 301 条）、文化禁忌（如筷子插饭、中国送钟、韩国红笔写名）、食品安全（各国自来水安全）、紧急电话、驾驶规范（左侧通行）、住房合同等。
• 确定性查询：相同查询返回相同答案，无幻觉。
• 国家范围限定：ID 格式为 {domain}/{slug}/{env}，env 携带国家代码（kr、jp、us、de 等），同一禁忌可针对不同司法管辖区给出不同答案。
• 一手来源：每个国家条目均引用政府网站、大使馆或可验证报道，无“基于一般知识”的答案。
• 社区验证：修复成功率根据真实结果报告更新。
• 亚毫秒级响应：本地正则匹配，无需 API 往返。
• 错误转换图：4,330+ 条边连接相关错误。
• 数据质量仪表板：公开所有指标，包括 2,204 条规范条目、54 个领域、39+ 个国家。

使用方式

• MCP 服务器：可添加到 Claude Desktop 或 Cursor 的配置文件中，或通过 Smithery 安装（无需本地设置）。
• Antigravity（Google AI IDE）：作为远程 MCP 服务器添加，无需认证，使用 serverUrl（而非 url）。
• PyPI 包：deadends-dev。
• API：/api/v1/index.json。
• 网站：deadends.dev。
• GitHub 仓库：https://github.com/dbwls99706/deadends.dev。

适用场景

• AI 编程助手遇到常见代码错误时，查询不应尝试的修复方案。
• 涉及跨国业务、旅行、法律、文化合规的 AI 应用，需要本地化准确答案。
• 开发者构建需要避免已知失败的智能体工作流。

限制

• 并非覆盖所有错误，缺失案例可通过 issue/PR/report_outcome 快速补充。
• 设计上优先实战解决（dead end/workaround），而非深度解释。
• 可靠性因领域/案例而异，高风险变更建议与官方文档/供应商指南交叉验证。
• 国家条目由人工审核（review_status: human_reviewed），无 LLM 批量生成。
• 自动收集数据为候选，最终由维护者审核后纳入。

版本与许可

• 当前版本 v0.10.0，国家覆盖扩展至 52 个国家。
• 代码采用 MIT 许可，数据采用 CC BY 4.0 许可。
• 基准测试：20 个错误场景，Precision@1=90%，MRR=0.935。