用途:opensrc 用于把依赖库的源码拉到本地,让 AI 代理能阅读实现细节而非仅看类型定义。当需要理解类型无法体现的内部行为、调试库的异常表现、学习知名实现的模式,或验证函数对边界情况的处理时,就适合取源码;若只是简单的 API 用法问题,文档或类型已能回答,则不必取源码。
主要能力:核心命令 opensrc path <pkg> 输出缓存源码的绝对路径,未缓存时会自动抓取;进度输出到 stderr,路径输出到 stdout,因此可在子 shell 中以 $(opensrc path ...) 方式使用。示例:rg "parse" $(opensrc path zod)、cat $(opensrc path zod)/src/types.ts、find $(opensrc path zod) -name "*.test.ts"。支持 npm 包、PyPI(pypi:requests)、crates.io(crates:serde)以及仓库(facebook/react),可一次传入多个包。
版本解析:npm 包会从 package-lock.json、pnpm-lock.yaml、yarn.lock 等锁文件自动识别已安装版本,可用 --cwd 从其他项目解析;PyPI 与 crates.io 使用显式版本或最新版;仓库可用 @ref 或 #ref 固定分支、标签或提交,如 opensrc path zod@3.22.0、opensrc path owner/repo@v1.0.0、opensrc path owner/repo#main。
缓存管理:源码全局缓存在 ~/.opensrc/,可用 OPENSRC_HOME 覆盖。opensrc list 查看全部缓存(--json 输出 JSON);opensrc remove zod 移除包,opensrc remove facebook/react 移除仓库;opensrc clean 清空全部,也可用 --npm、--pypi、--crates、--packages、--repos 限定清理范围。限制方面,资料未提供错误处理、网络代理、私有仓库鉴权等细节。