开源项目评分标准说明文档

1. 概述

本评分系统旨在全面评估开源项目的质量、活跃度和成熟度。评分体系包含多个维度，每个维度都有其特定的评分标准和改进建议。

2. 评分维度

2.1 基础要素评分

开源许可证评分

• 满分标准: 使用标准开源许可证(MIT/Apache/GPL等) - 100分
• 不合格标准: 无许可证 - 0分
• 改进建议: 建议使用标准的开源许可证以明确项目的使用条款和限制

2.2 问题处理评分

未解决issue评分

• 优秀: 未解决issue较少 (80-100分)
• 良好: 未解决issue较多 (60-80分)
• 待改进: 未解决issue很多 (0-60分)
• 改进建议: 保持适度的未解决issue数量,及时处理重要issue

已解决issue评分

• 优秀: 已解决issue很多 (80-100分)
• 良好: 已解决issue较多 (60-80分)
• 待改进: 已解决issue较少 (0-60分)
• 改进建议: 提高issue解决率,保持良好的问题跟踪和处理机制

2.3 安全性评分

包含四个等级的安全警告评分：

• 低风险安全警告 (100分/0分)
• 中等风险安全警告 (100分/0分)
• 高风险安全警告 (100分/0分)
• 严重风险安全警告 (100分/0分)

每个等级的评分标准：

• 满分标准: 无相应级别警告
• 不合格标准: 存在多个相应级别警告
• 改进建议: 根据风险等级优先处理安全问题，确保项目安全性

2.4 社区活跃度评分

Star数评分

• 优秀: Star很多 (80-100分)
• 良好: Star较多 (60-80分)
• 待改进: Star较少 (0-60分)
• 改进建议: 提高项目影响力,完善文档和功能以吸引更多用户关注

关注者评分

• 优秀: 关注者很多 (80-100分)
• 良好: 关注者较多 (60-80分)
• 待改进: 关注者较少 (0-60分)
• 改进建议: 增加项目曝光度,保持更新以维持用户关注度

Fork数评分

• 优秀: 分支数很多 (80-100分)
• 良好: 分支数较多 (60-80分)
• 待改进: 分支数较少 (0-60分)
• 改进建议: 鼓励社区贡献,完善协作指南以促进分支开发

2.5 开发活跃度评分

提交次数评分

• 优秀: 提交次数很多 (80-100分)
• 良好: 提交次数较多 (60-80分)
• 待改进: 提交次数较少 (0-60分)
• 改进建议: 保持稳定的开发活跃度,定期提交代码更新

开发者数量评分

• 优秀: 开发者数量很多 (80-100分)
• 良好: 开发者数量较多 (60-80分)
• 待改进: 开发者数量较少 (0-60分)
• 改进建议: 扩大开发团队,培养核心贡献者

发布版本数评分

• 优秀: 发布版本数很多 (80-100分)
• 良好: 发布版本数较多 (60-80分)
• 待改进: 发布版本数较少 (0-60分)
• 改进建议: 建立规范的版本发布流程,保持稳定的迭代节奏

3. 总体成熟度评分

• 优秀: 项目成熟,维护良好 (80-100分)
• 良好: 项目稳定,有待改进 (60-80分)
• 一般: 项目基本可用,需要加强维护 (40-60分)
• 待改进: 项目初期或疏于维护 (0-40分)
• 改进建议: 根据各项分值改进薄弱环节,提高项目整体质量

4. 评分使用建议

1. 定期进行评分，跟踪项目发展状况
2. 针对低分项优先改进
3. 关注安全警告，及时处理安全问题
4. 持续完善文档和社区建设
5. 保持稳定的更新和维护频率

5.接口文档

接口名称

项目成熟度分析接口

接口路径

/maturityAnalyse/

请求方法

GET

请求参数

参数名	类型	是否必填	描述
owner	string	是	GitLink 仓库拥有者
repository	string	是	GitLink 仓库名称

示例请求

bash


复制代码
GET /maturityAnalyse/?owner=xuos&repository=xiuos

返回格式

返回数据为 JSON 格式，结构如下：

{
    "data": {
        "scores": {
            "license_score": {
                "score": 100,
                "description": "开源许可证评分",
                "criteria": {
                    "100": "使用标准开源许可证(MIT/Apache/GPL等)",
                    "0": "无许可证"
                },
                "suggestion": "建议使用标准的开源许可证以明确项目的使用条款和限制"
            },
            "open_issue_score": {
                "score": 1,
                "description": "未解决issue评分",
                "criteria": {
                    "80-100": "未解决issue较少",
                    "60-80": "未解决issue较多",
                    "0-60": "未解决issue很多"
                },
                "suggestion": "保持适度的未解决issue数量,及时处理重要issue"
            },
            "closed_issue_score": {
                "score": 0,
                "description": "已解决issue评分",
                "criteria": {
                    "80-100": "已解决issue很多",
                    "60-80": "已解决issue较多",
                    "0-60": "已解决issue较少"
                },
                "suggestion": "提高issue解决率,保持良好的问题跟踪和处理机制"
            },
            "low_advisory_score": {
                "score": 100,
                "description": "低风险安全警告评分",
                "criteria": {
                    "100": "无低风险警告",
                    "0": "多个低风险警告"
                },
                "suggestion": "定期检查并修复安全隐患,即使是低风险问题也应重视"
            },
            "moderate_advisory_score": {
                "score": 100,
                "description": "中等风险安全警告评分",
                "criteria": {
                    "100": "无中等风险警告",
                    "0": "多个中风险警告"
                },
                "suggestion": "优先处理中等风险安全问题,避免安全隐患扩大"
            },
            "high_advisory_score": {
                "score": 100,
                "description": "高风险安全警告评分",
                "criteria": {
                    "100": "无高风险警告",
                    "0": "多个高风险警告"
                },
                "suggestion": "高风险安全问题必须立即处理,可考虑发布安全补丁版本"
            },
            "critical_advisory_score": {
                "score": 100,
                "description": "严重风险安全警告评分",
                "criteria": {
                    "100": "无严重风险警告",
                    "0": "多个严重风险警告"
                },
                "suggestion": "严重安全问题需要紧急修复并及时通知用户更新"
            },
            "stars_score": {
                "score": 42,
                "description": "项目Star数评分",
                "criteria": {
                    "80-100": "Star很多",
                    "60-80": "Star较多",
                    "0-60": "Star较少"
                },
                "suggestion": "提高项目影响力,完善文档和功能以吸引更多用户关注"
            },
            "watching_score": {
                "score": 100,
                "description": "项目关注者评分",
                "criteria": {
                    "80-100": "关注者很多",
                    "60-80": "关注者较多",
                    "0-60": "关注者较少"
                },
                "suggestion": "增加项目曝光度,保持更新以维持用户关注度"
            },
            "fork_score": {
                "score": 53,
                "description": "项目分支数评分",
                "criteria": {
                    "80-100": "分支数很多",
                    "60-80": "分支数较多",
                    "0-60": "分支数较少"
                },
                "suggestion": "鼓励社区贡献,完善协作指南以促进分支开发"
            },
            "commits_number_score": {
                "score": 100,
                "description": "提交次数评分",
                "criteria": {
                    "80-100": "提交次数很多",
                    "60-80": "提交次数较多",
                    "0-60": "提交次数较少"
                },
                "suggestion": "保持稳定的开发活跃度,定期提交代码更新"
            },
            "developer_number_score": {
                "score": 100,
                "description": "开发者数量评分",
                "criteria": {
                    "80-100": "开发者数量很多",
                    "60-80": "开发者数量较多",
                    "0-60": "开发者数量较少"
                },
                "suggestion": "扩大开发团队,培养核心贡献者"
            },
            "release_number_score": {
                "score": 100,
                "description": "发布版本数评分",
                "criteria": {
                    "80-100": "发布版本数很多",
                    "60-80": "发布版本数较多",
                    "0-60": "发布版本数较少"
                },
                "suggestion": "建立规范的版本发布流程,保持稳定的迭代节奏"
            },
            "overall_maturity_score": {
                "score": 76.61538461538461,
                "description": "总体成熟度评分",
                "criteria": {
                    "80-100": "项目成熟,维护良好",
                    "60-80": "项目稳定,有待改进",
                    "40-60": "项目基本可用,需要加强维护",
                    "0-40": "项目初期或疏于维护"
                },
                "suggestion": "根据各项分值改进薄弱环节,提高项目整体质量"
            }
        }
    }
}

返回字段说明

• data

  : 返回的数据对象。

  • scores

    : 各项评分的详细信息。

    • license_score: 开源许可证评分。
    • open_issue_score: 未解决 issue 的评分。
    • closed_issue_score: 已解决 issue 的评分。
    • low_advisory_score: 低风险安全警告评分。
    • moderate_advisory_score: 中等风险安全警告评分。
    • high_advisory_score: 高风险安全警告评分。
    • critical_advisory_score: 严重风险安全警告评分。
    • stars_score: 项目 Star 数评分。
    • watching_score: 项目关注者评分。
    • fork_score: 项目分支数评分。
    • commits_number_score: 提交次数评分。
    • developer_number_score: 开发者数量评分。
    • release_number_score: 发布版本数评分。
    • overall_maturity_score: 总体成熟度评分。