企业官网建设流程全解析

• 文档
• 知识库

本篇技术指南以本仓库的 CHANGELOG.rst 为切入点，解读 awesome-aws 项目 0.1.0 首次发布的完整背景：它既是一份"精选 AWS 资源清单"（涵盖 SDK、命令行工具、开源仓库、教程与社交资源），也附带一个用于自动维护仓库评分（Fiery Meter of AWSome）的 Python 模块。读完本文，你将理解该项目的版本约定、评分规则的源码实现，以及文档与发布流水线的运行方式。

Changelog 核心内容：版本 0.1.0（2015-12-21）

CHANGELOG.rst 是全仓库版本记录的权威文件，其正文部分完整记录如下：

• 版本号：0.1.0
• 发布日期：2015-12-21
• 变更内容：Initial release（首次发布）

需要说明的是，这份 Changelog 的开头并不是普通的变更说明，而是完整嵌入了项目 README 的导览内容（包括 The Fiery Meter of AWSome 评分标准、awesome-aws Python 模块说明、以及覆盖 SDK、开源仓库、教程、社交资源等全部条目的 Index 索引），随后才是上述版本条目。这与仓库的发布脚本设计直接相关，详见下文"发布与文档工作流"一节。

首次发布的项目形态：一份可自动校对的精选 AWS 资源清单

从 Changelog 中嵌入的项目说明可以看出，0.1.0 首次发布交付的核心资产是一份结构化的精选清单（curated list），收录范围包括：

• SDKs and Samples：Android、C++、Clojure、Go、iOS、IoT、Java、JavaScript、Haskell、OCaml、Perl、PHP、Python、Ruby、Scala、Xamarin、Unity、.NET 等 18 类官方 SDK 与示例；
• Command Line Tools：通用命令行接口（CLI）与 Windows PowerShell 工具；
• IDE Toolkits：Eclipse Toolkit 与 Visual Studio Toolkit；
• Open Source Repos：按 AWS 服务维度组织的开源仓库，覆盖 API Gateway、CloudFormation、CloudWatch、DynamoDB、Elastic Beanstalk、ECS、Lambda、Redshift、Route 53、S3、SNS、SQS 等，并额外提供 Data、DevOps、Security、Accompanying、Miscellaneous 等横向分类；
• Guides, Books, Documentation, and Training：入门指南、综合指南、书籍、白皮书、官方文档与培训资源；
• Social：博客、Twitter 影响者、Facebook 主页、YouTube 频道、LinkedIn 群组、Subreddit 与会议；
• Latest KPIs and Stats与Appendix of Core Services：AWS 核心服务附录，按 Compute、Networking、Analytics、Storage、Databases 等领域组织。

上述分类即 CHANGELOG.rst 中 Index 一节的完整结构；对应完整内容维护在 README.md 中。

Fiery Meter of AWSome：仓库"火苗"评分的五档标准

项目对收录仓库采用独特的可视化评分体系——The Fiery Meter of AWSome，按 GitHub Star 数量分五档：

档位	Star 区间	火苗标记
1 档	0100+ Stars
2 档	0200+ Stars
3 档	0500+ Stars
4 档	1000+ Stars
5 档	2000+ Stars

Changelog 中同时说明：未进入 Fiery Meter 的仓库依然可能很出色（详见 CONTRIBUTING.md 中 "A Note on Repo AWSomeness" 一节），火苗数量只是收录质量的量化参考。

评分规则的底层实现在 awesome/awesome.py 的score_repo方法中，逻辑与上表严格对应：

if stars < 100: score = 0 elif stars < 200: score = 1 elif stars < 500: score = 2 elif stars < 1000: score = 3 elif stars < 2000: score = 4 else: score = 5

该实现同时具备"幂等更新"特性：update_repo_score（同文件 L137-L156）会先统计当前行中已有的:fire:数量作为cached_score，只有当新分数与缓存分数不同时才执行行内替换，避免对同一行做无谓的重复写入。

awesome-aws Python 模块：自动维护评分准确性的机制

Changelog 中专门介绍了awesome-awsPython 模块：它定期扫描清单中的仓库，以维持 Fiery Meter of AWSome 评分的准确性。这是 0.1.0 发布中最具工程价值的部分，其核心工作流在 awesome/awesome.py 中可完整还原：

1. 逐行解析：process_line（L68-L90）用正则r'(https://github.com/[^)]*)'识别 README 中的 GitHub 仓库链接；
2. 排除名单：__init__中维护repos_exclude_score名单（如项目自身、sindresorhus/awesome、#占位链接等），命中即跳过评分；
3. 调用 GitHub API：对每个仓库链接，通过 awesome/lib/github.py 封装的 GitHub API 获取stargazers_count；
4. 失效检测：若 API 返回null.NullObject，将该链接记入repos_broken，并在运行结束时以红色输出到终端（print_repos_broken，L61-L66）；
5. 结果写回：rock_it（L92-L111）读取 README、逐行处理后写回原文件，并打印剩余 API 速率配额（Rate limit）。

对应测试见 tests/mock_github.py（用MockGitHubApi模拟 API，ratelimit_remaining固定为 9000）与 tests/test_awesome.py，可验证评分与失效链接检测逻辑。

发布与文档工作流：Changelog 为何"身兼数职"

0.1.0 之后，Changelog 与 README 的同步由 scripts 目录下的 Shell 脚本驱动，这也解释了 CHANGELOG.rst 为何内含完整 README 内容：

• scripts/create_changelog.sh：先用gitchangelog从 Git 提交历史生成CHANGELOG_DRAFT，再通过pandoc将 CHANGELOG.md 从 Markdown 转换为 RST 格式输出到CHANGELOG.rst；
• scripts/set_changelog_as_readme.sh：将README.md临时改名备份，再把CHANGELOG.rst复制为README.md，使 README 与 Changelog 保持同一份内容；
• scripts/set_changelog_as_readme_undo.sh：恢复被备份的README.md；
• scripts/create_readme_rst.sh：用 pandoc 将 Markdown 版 README 转为 RST（输出到文档站点目录），保证 PyPI 与文档站点的格式一致性。

因此，当前仓库中的 CHANGELOG.md 与 CHANGELOG.rst 是同一份变更记录的两种格式载体，后者是发布时对外呈现的正式版本。

版本号与打包约定：0.1.0 如何贯穿全项目

0.1.0 版本号在整个仓库中保持单一来源，可从源码结构确认：

• 版本号唯一定义在 awesome/init.py：__version__ = '0.1.0'；
• setup.py 通过from awesome.__init__ import __version__引入该版本号，并以此注册version参数；同时声明click、githubcli、colorama等运行依赖，并通过entry_points将控制台命令awesome绑定到awesome.awesome_cli:AwesomeCli.cli；
• CHECKLIST.md 的发布检查清单明确要求：发布新版本时需在awesome/__init__.py中递增版本号——这正是 0.1.0 版本管理约定在仓库中的落地位置。

小结

CHANGELOG.rst 记录的唯一正式版本 0.1.0（2015-12-21）定义了 awesome-aws 项目的初始形态：一份按 AWS 服务体系组织的精选资源清单、一套以 Star 数为依据的五档火苗评分标准，以及一个能够自动扫描仓库、检测失效链接并回写评分的 Python 模块。版本号0.1.0以单一定义（awesome/init.py）贯穿打包（setup.py）与发布检查（CHECKLIST.md），而 Changelog 与 README 的双格式同步则由 scripts 目录下的脚本流水线保障。对希望了解"精选清单类开源项目如何自维护质量"的读者而言，0.1.0 的这一整套机制至今仍值得参考。

• 文档
• 知识库