🌍 语言 : 中文 | English
自动保持 GitHub 提交状态常绿。
a commit a day keeps your girlfriend away.
使用 GitHub Actions 的定时任务功能,每隔一段时间自动执行
git commit
,提交信息为 "a commit a day keeps your girlfriend
away"
,灵感来自知乎问题
在 GitHub 上保持 365 天全绿是怎样一种体验?
下某匿名用户的回答:
曾经保持了 200 多天全绿,但是冷落了女朋友,一直绿到现在。
重要提醒 :
GITHUB_TOKEN
进行身份验证,这是 GitHub Actions 自动提供的,无需额外配置
计划任务语法有 5 个字段,中间用空格分隔,每个字段代表一个时间单位。
┌───────────── 分钟 (0 - 59)
│ ┌───────────── 小时 (0 - 23)
│ │ ┌───────────── 日 (1 - 31)
│ │ │ ┌───────────── 月 (1 - 12 或 JAN-DEC)
│ │ │ │ ┌───────────── 星期 (0 - 6 或 SUN-SAT)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
* * * * *
每个时间字段的含义:
由于 GitHub Actions 的限制,如果设置为 * * * * * 实际的执行频率为每 5 分钟执行一次
默认设置为每日 UTC 时间 0:00 执行一次 (0 0 * * *)
GitHub Actions 对于定时任务可能有延迟,实际执行时间可能会有几分钟的偏差
环保提醒:虽然这个项目很有趣,但请适度使用。过度的无意义提交可能会被视为垃圾信息
学习导向:建议将此项目作为学习 GitHub Actions 的起点,而不是长期保持绿色的唯一方式
真实贡献:最好的绿色方块来自于真实的代码贡献和有意义的项目
本项目通过以下步骤实现自动提交:
定时触发:GitHub Actions 根据 cron 表达式定时执行
环境准备:在 Ubuntu 环境中检出代码
Git 配置:设置提交者信息
身份验证:使用 GitHub 提供的 GITHUB_TOKEN 进行认证
同步代码:拉取最新代码避免冲突
空提交:执行 git commit --allow-empty 创建空提交
推送更改:将提交推送到远程仓库
Q: 为什么要使用"Use this template"而不是 Fork?
A: GitHub 只会显示你拥有或作为协作者的仓库中的贡献。Fork 的仓库不会计入你的贡献图表,除非你向原项目提交代码。
Q: 这会影响我的 GitHub 统计数据吗?
A: 会的,它会在你的贡献图表上显示绿色方块。但不会影响仓库洞察中的实际代码贡献统计。
Q: 这是否违反了 GitHub 的服务条款?
A: 这个项目不违反 GitHub 的服务条款,但请负责任地使用,不要滥用。
auto-green is released under the MIT License. See the
bundled LICENSE file for details.