前言¶
DSH 的扩展理念是“一切皆插件”,社区目录是独立站点,与 DeepSeek / 幻方没有官方从属关系。对智能体开发者和开源贡献者来说,向外部仓库提交 PR 时,常见的问题不只是“怎么写完”,还包括:这个 PR 是否值得提交、提交后处于什么状态、下一步该采取什么动作。
PR Genius 是 zsxh1990 维护的一个插件,定位为基于历史反模式和成功模式的 PR 评估与建议工具。
这是什么¶
PR Genius 面向专业 OSS 贡献者和 AI agents,资料中给出的定位是“Outbound PR CRM”。它的对象是提交给其他仓库的 PR,并提供跨仓库 PR 列表、状态分类、陈旧检测和行动建议等能力。
已核实的基础信息如下:
- 插件名:
zsxh1990/pr-genius - 维护者:
zsxh1990 - 许可证:MIT
- Python 要求:3.10+
- README frontmatter:
conforms_to: OKF v0.1 (Sudhakaran88/okf-conformance) + agent_guidelines extension package.json中声明:dsh.bundle.patch: ./cordis.patch.yml
核心功能¶
资料中列出的能力如下:
- Outbound PR CRM for professional OSS contributors and AI agents
- Cross-repo PR list
- Status classification,共 9 种状态
- Stale detection
- Action suggestions
- Repo-specific policy
- Snapshot & transitions
- Daily status heartbeat
- 1355 loaded patterns across 61 repos
- 8 MCP tools
安装与启用¶
Python 包安装¶
资料给出的安装命令是:
pip install prgenius-core
DSH 插件线索¶
package.json 中出现了 DSH 相关的 bundle 配置:
"dsh": {
"bundle": {
"patch": "./cordis.patch.yml"
}
}
资料未出现明确的官方 DSH 安装命令,因此本文不按名称拼接 dsh plugin add 类命令。
MCP 配置¶
MCP 配置示例如下:
{
"mcpServers": {
"pr-genius": {
"command": "python",
"args": ["-m", "prgenius", "mcp", "serve"]
}
}
}
典型用法¶
下面命令均来自资料示例。
分析 PR¶
python3 -m prgenius analyze "feat: add feature" --repo org/repo --body "Fixes #123"
使用 coach¶
python3 -m prgenius coach "feat: add feature" --repo org/repo
使用 triage¶
python3 -m prgenius triage "docs: typo" --repo org/repo --diff-stat "docs/faq.md | 3 ++-"
状态跟踪¶
python3 -m prgenius status --author zsxh1990
profile writeback¶
python3 -m prgenius profile writeback --author zsxh1990
GitHub Action¶
在 workflow 中可引用:
- uses: zsxh1990/pr-genius/.github/actions/pr-genius-check@v1
资料说明权限要求:需要 contents: read;当 comment_mode != never 时,需要 issues: write。
comment_mode 的取值为:
neverhigh_riskalways
旧字段 comment_on_high_risk 仍受支持。
适用场景与注意¶
这个插件适合以下场景:
- 经常向其他仓库提交 PR
- 需要跨仓库查看自己提交的 PR
- 需要对 PR 状态进行分类和陈旧检测
- 希望获得行动建议
- 希望把 PR 评估能力接入 MCP 或 GitHub Action
使用前需要注意:
- 插件以当前 DSH 进程权限运行。安装前应检查源码、依赖和 MIT 许可证。
- 资料中版本线索不一致,固定版本前需要核对实际发布物。
- GitHub Action 的评论行为受
comment_mode控制,配置权限时按实际使用需求设置。
结尾¶
PR Genius 的价值在于把“要不要提、提后处于什么状态、下一步该做什么”变成可运行的检查和评估。
- GitHub 仓库:https://github.com/zsxh1990/pr-genius
- 插件目录页线索:https://www.skillhub.cn/plugins/zsxh1990/pr-genius