{"id":23206911,"url":"https://github.com/lianglliu/auto-green","last_synced_at":"2025-10-25T07:42:37.387Z","repository":{"id":37280152,"uuid":"372014328","full_name":"LiangLliu/auto-green","owner":"LiangLliu","description":"自动保持 GitHub 提交状态常绿","archived":false,"fork":false,"pushed_at":"2024-10-30T00:54:00.000Z","size":100,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-10-30T02:55:52.523Z","etag":null,"topics":["auto-green","github","github-actions","utils"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LiangLliu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-29T15:59:37.000Z","updated_at":"2024-10-30T00:54:04.000Z","dependencies_parsed_at":"2023-12-07T02:27:11.340Z","dependency_job_id":"67bd5391-ac8e-421d-b2a4-401d06bcbdca","html_url":"https://github.com/LiangLliu/auto-green","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LiangLliu%2Fauto-green","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LiangLliu%2Fauto-green/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LiangLliu%2Fauto-green/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LiangLliu%2Fauto-green/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LiangLliu","download_url":"https://codeload.github.com/LiangLliu/auto-green/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230310238,"owners_count":18206471,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["auto-green","github","github-actions","utils"],"created_at":"2024-12-18T17:16:03.731Z","updated_at":"2025-10-25T07:42:37.363Z","avatar_url":"https://github.com/LiangLliu.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# auto-green\n\n[![Build Status](https://github.com/LiangLliu/auto-green/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/LiangLliu/auto-green/actions)\n\n🌍 **语言**: **中文** | [English](README_EN.md)\n\n自动保持 GitHub 提交状态常绿。\n\n\u003e a commit a day keeps your girlfriend away.\n\n## 原理\n\n使用 GitHub Actions 的定时任务功能，每隔一段时间自动执行 `git commit`，提交信息为 \"a commit a day keeps your girlfriend\naway\"\n，灵感来自知乎问题[在 GitHub 上保持 365 天全绿是怎样一种体验？](https://www.zhihu.com/question/34043434/answer/57826281)\n下某匿名用户的回答：\n\n\u003e 曾经保持了 200 多天全绿，但是冷落了女朋友，一直绿到现在。\n\n## 使用\n\n- 点右上角 **Use this template** 按钮复制本 GitHub 仓库，**:warning: 千万不要 Fork，因为 fork 项目的动态并不会让你变绿 :\n  warning:**\n- 修改 [ci.yml 文件的第 19、20 行](https://github.com/LiangLliu/auto-green/blob/master/.github/workflows/ci.yml#L19) 为自己的\n  GitHub 邮箱和用户名\n- (可选)\n  你可以通过修改 [ci.yml 文件的第 8 行](https://github.com/LiangLliu/auto-green/blob/master/.github/workflows/ci.yml#L8)\n  来调整频率\n\n**重要提醒**：\n\n- 确保你的仓库是 **Public** 的，私有仓库的提交不会在 GitHub 个人首页显示为绿色\n- 本项目使用 `GITHUB_TOKEN` 进行身份验证，这是 GitHub Actions 自动提供的，无需额外配置\n\n计划任务语法有 5 个字段，中间用空格分隔，每个字段代表一个时间单位。\n\n```plain\n┌───────────── 分钟 (0 - 59)\n│ ┌───────────── 小时 (0 - 23)\n│ │ ┌───────────── 日 (1 - 31)\n│ │ │ ┌───────────── 月 (1 - 12 或 JAN-DEC)\n│ │ │ │ ┌───────────── 星期 (0 - 6 或 SUN-SAT)\n│ │ │ │ │\n│ │ │ │ │\n│ │ │ │ │\n* * * * *\n```\n\n每个时间字段的含义：\n\n| 符号  | 描述   | 举例                                |\n|-----|------|-----------------------------------|\n| `*` | 任意值  | `* * * * *` 每天每小时每分钟              |\n| `,` | 值分隔符 | `1,3,4,7 * * * *` 每小时的 1 3 4 7 分钟 |\n| `-` | 范围   | `1-6 * * * *` 每小时的 1-6 分钟         |\n| `/` | 每    | `*/15 * * * *` 每隔 15 分钟           |\n\n**注**：\n\n- 由于 GitHub Actions 的限制，如果设置为 `* * * * *` 实际的执行频率为每 5 分钟执行一次\n- 默认设置为每日 UTC 时间 0:00 执行一次 (`0 0 * * *`)\n- GitHub Actions 对于定时任务可能有延迟，实际执行时间可能会有几分钟的偏差\n\n## 注意事项\n\n- **环保提醒**：虽然这个项目很有趣，但请适度使用。过度的无意义提交可能会被视为垃圾信息\n- **学习导向**：建议将此项目作为学习 GitHub Actions 的起点，而不是长期保持绿色的唯一方式\n- **真实贡献**：最好的绿色方块来自于真实的代码贡献和有意义的项目\n\n## 工作原理\n\n本项目通过以下步骤实现自动提交：\n\n1. **定时触发**：GitHub Actions 根据 cron 表达式定时执行\n2. **环境准备**：在 Ubuntu 环境中检出代码\n3. **Git 配置**：设置提交者信息\n4. **身份验证**：使用 GitHub 提供的 `GITHUB_TOKEN` 进行认证\n5. **同步代码**：拉取最新代码避免冲突\n6. **空提交**：执行 `git commit --allow-empty` 创建空提交\n7. **推送更改**：将提交推送到远程仓库\n\n## 常见问题\n\n**Q: 为什么要使用\"Use this template\"而不是 Fork？**\nA: GitHub 只会显示你拥有或作为协作者的仓库中的贡献。Fork 的仓库不会计入你的贡献图表，除非你向原项目提交代码。\n\n**Q: 这会影响我的 GitHub 统计数据吗？**\nA: 会的，它会在你的贡献图表上显示绿色方块。但不会影响仓库洞察中的实际代码贡献统计。\n\n**Q: 这是否违反了 GitHub 的服务条款？**\nA: 这个项目不违反 GitHub 的服务条款，但请负责任地使用，不要滥用。\n\n## License\n\n[auto-green](https://github.com/LiangLliu/auto-green) is released under the MIT License. See the\nbundled [LICENSE](./LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flianglliu%2Fauto-green","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flianglliu%2Fauto-green","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flianglliu%2Fauto-green/lists"}