codeitall

codeitall — Rust API 行为预言机

为 AI 编码 Agent 构建、版本固定的 Rust 包 API 行为预言机。提供五种确定性工具，由 Postgres 底层数据库提供支持，其中包含 66,549,370 条 pattern_records，以及涵盖 7 类任务（日期时间、时长、base64、JSON 严格与宽松模式、JWT 验证、AEAD 加密/解密、恒定时间比较）的 107 次成功探测运行。

托管、免费、无需注册： https://api.codeitall.dev

此仓库是 codeitall 的公开界面——API 参考、OpenAPI 规范、“面向 AI Agent”页面，以及各分类页面。摄取器/索引器和服务端源码不再分发；你通过查询托管 API 使用 codeitall，而不是自行运行它。

它能解答什么

与文档 RAG 的区别在于：底层数据库记录的是运行时行为（函数在一组规范输入上实际如何运行，依据经验观测得出），而不只是文档所述内容（文档声称函数如何运行）。它旨在弥合文档与运行时之间的差距——撤回状态、RustSec 安全公告、弃用后的重命名，以及跨实现行为表。

工具

工具	用途
answer_api_question	解答开放式 Rust API 问题；确定性路由（基于规则，不使用 LLM），并在必要时回退到 bge-m3 余弦检索。
signature_search	已知签名形式（fn(&str) -> Result<Vec<u8>, _>）；获取按相关性排序的候选函数，以及 crate、下载量和撤回状态。
behavior_lookup	查询特定的 (crate, fn_name)；逐字获取探测观测表——每行包含 (input, outcome=ok|err|panic, value_or_error)。
compare_implementations	查询任务类别（例如“base64 crates”）；获取并列的跨实现行为表。
find_modern_equivalent	查询可能已弃用的调用；获取当前规范替代方案，以及撤回/安全公告记录。

确定性约定

请求与响应之间不会经过生成式 LLM。 每个响应都由 SQL 和确定性模板生成；热路径中唯一的模型是 bge-m3，它是用于余弦回退检索的确定性文本→向量嵌入器（相同输入 → 相同向量 → 相同命中结果）。此不变量由回归测试固定。

快速入门

# Mint a free anonymous key (no email, no signup):
curl -sX POST https://api.codeitall.dev/v1/keys \
  -H 'content-type: application/json' -d '{}'

# Ask a question (HTTP REST):
curl -sX POST https://api.codeitall.dev/v1/answer_api_question \
  -H 'content-type: application/json' \
  -d '{"question":"how do I parse a duration string in rust"}'

每种工具都提供 GET 别名（供仅支持浏览的客户端使用）；signature_search 还接受 shape_b64（base64url）参数，避免 URL 重新编码时破坏类型签名字符。

访问方式

• MCP — 通过 https://api.codeitall.dev/mcp 使用 SSE/HTTP（Bearer 密钥），自托管时也可使用 stdio。
• HTTP REST — POST/GET /v1/<tool>。
• OpenAPI 3.1 — openapi.json（线上地址：https://api.codeitall.dev/openapi.json）。

此仓库中的文档

• for-ai-agents.html — 定位说明、工具列表、密钥代码片段（线上地址：https://api.codeitall.dev/for-ai-agents.html）。
• api-reference.html / api-reference.md — 自动生成的工具参考，以及范围/覆盖情况。
• agents/ — 每个探测类别各有一个页面。

费用与限制

免费。每个 IP 的密钥签发上限为每天 10 个，每个密钥的配额为每天 10,000 次。没有付费套餐、不收集邮箱、无需注册。