【开源自荐】since-cutoff：找出编码模型在你锁定的依赖版本上会写错的 API，用类型检查验证过的 AGENTS.md 提示修复

• 项目名称：since-cutoff

• 项目地址：https://github.com/MohammadHijjawi97/since-cutoff （中文说明：README.zh-CN.md）

• 项目简介：编码模型只见过训练截止前的库版本。since-cutoff 读取 lockfile，静态对比模型截止时与你锁定版本的 API 差异，测出模型会写错的调用，再生成经类型检查验证的 AGENTS.md 提示修复。

• 核心特点：

  • scan：支持 uv / Poetry / PDM / Pipenv / requirements 等 lockfile，用 griffe 静态对比每个依赖在模型截止日期时的版本和你锁定的版本，列出被删除的函数、被移除的参数和 PEP 702 弃用。不调用模型，不需要 API key。
  • run：用需要这些 API 的小任务测试模型（无工具、无文档），再用 basedpyright 针对新旧两个版本分别做类型检查，区分"过时 / 写错 / 已弃用 / 正确"。不让另一个 LLM 打分。
  • 生成的每条说明只有在示例代码通过你锁定版本的类型检查时才会保留，并在留出任务上复测是否真的有效。生成的代码从不执行。
  • 实测（一个 9 个依赖的示例项目，样本小，仅作演示）：Claude Haiku 4.5 在 5 个被测库中有 3 个写出过时用法，加上说明后留出任务正确率 14% → 57%；Claude Opus 4.6 为 5% → 65%。
  • 可作为 Claude Code 插件、MCP 服务器（uvx since-cutoff mcp，Cursor 等 MCP 客户端可用）或 GitHub Action 使用；模型支持 Anthropic、OpenAI、DeepSeek、OpenRouter、Ollama 及任何 OpenAI 兼容接口。

• 快速开始：

uvx since-cutoff scan          # 不调用模型，不需要 API key
uvx since-cutoff run --apply   # 测试模型，把验证过的说明写入 AGENTS.md

• 项目截图：

我是这个项目的作者。MIT 开源，目前只支持 Python（TypeScript 在计划中），欢迎试用和提 issue。