关于 deepsource
deepsource 是用于查询 DeepSource 仓库分析结果的命令行技能,适合检查代码审查问题、漏洞和分析状态。它支持按严重性、类别、路径以及 PR、提交或分支筛选,并可输出 JSON。
主要功能
- 01查询代码审查问题并筛选
- 02查看安全等维度的评分卡
- 03按严重性筛选漏洞
- 04检查仓库状态与分析记录
- 05按 PR、提交或分支限定结果
- 06输出机器可读 JSON
适用场景
- 01定位指定路径中的严重代码问题
- 02查看某个 PR 的安全漏洞
- 03核对提交对应的分析评分
- 04检查仓库分析是否已运行
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ deepsourcecorp/ skills --skill deepsource安装后在 Claude Code 中输入/deepsource确认已加载。
详细介绍
DeepSource CLI
身份验证
deepsource auth login
目标
获取代码审查问题
deepsource issues --output json
按严重性、类别或路径缩小范围:
deepsource issues --severity critical,major --output json
deepsource issues --category security,bug-risk --output json
deepsource issues --path src/auth --output json
deepsource issues --severity critical --category security --limit 20 --output json
限定到 PR 或分支:
deepsource issues --pr 42 --output json
deepsource issues --default-branch --output json
获取报告卡
deepsource report-card --output json
返回安全性、可靠性、复杂度、代码卫生、覆盖率的等级(A-F)和分数,以及综合评分。
限定到 PR 或提交:
deepsource report-card --pr 42 --output json
deepsource report-card --commit abc123 --output json
获取漏洞
deepsource vulnerabilities --output json
按严重性筛选:
deepsource vulnerabilities --severity critical,high --output json
限定到 PR 或分支:
deepsource vulnerabilities --pr 42 --output json
deepsource vulnerabilities --default-branch --output json
检查分析状态
deepsource repo status --output json
deepsource runs --output json
deepsource runs --commit abc123 --output json
repo status 显示激活状态和已配置的分析器。runs 显示最近的分析运行历史。
关键模式
- 自动检测: 在 git 仓库内,CLI 会自动检测仓库和当前分支。在仓库外或要指定其他仓库时,请使用
--repo。使用范围标志(--pr、--commit、--default-branch)可覆盖自动检测的分支。 - 始终使用
--output json获取机器可读的输出。 - 仓库格式:
--repo provider/owner/name— 支持的提供商:gh、gl、bb、ads。 - 范围标志不可同时使用:
--commit、--pr和--default-branch不能组合使用。省略这三个标志即可使用自动检测。
文档
完整 CLI 文档:https://deepsource.com/docs/developers/cli/installation
运行 deepsource <command> --help 查看详细的标志参考。
评论
支持 Markdown