Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CITATION.cff
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
cff-version: 1.2.0
message: "If you use GitHub Risers rankings or data, please cite it as below."
title: "GitHub Risers: GitHub trending repositories ranked by star growth"
abstract: "A script-generated leaderboard that ranks GitHub repositories by stars gained per day (last 7, 30 and 365 days) instead of total stars, grouped by category with AI as the main board. Data comes from the GitHub API and is refreshed twice a day."
abstract: "A script-generated leaderboard that ranks GitHub repositories by stars gained per day (last 7, 30 and 365 days) instead of total stars, grouped by category with AI as the main board. Data comes from the GitHub API and is refreshed daily."
type: dataset
authors:
- alias: "jammyfu"
Expand Down
39 changes: 21 additions & 18 deletions CURRENT_PLAN.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,41 +2,44 @@

## Plan ID

PLAN-007
PLAN-008

## Goal

Complete every missing detailed translation and one-line hook in the current ranking across all five languages, while preserving existing translations and all API-derived data.
Make the public GitHub first screen easier for visitors to understand, open the live boards, and star the project, while adding a profile README draft and aligning leftover twice-daily public copy.

## In Scope

- Current-source entries in `data/translation_library.json`
- Generated README and details pages via `tools/render_readme.py`
- Completeness, terminology, existing-entry preservation and publication checks
- Generated README first-screen copy via `tools/i18n.py` and `tools/render_readme.py`
- Folded star-history charts on README boards
- `docs/github-profile-draft.md` unpublished draft for a `jammyfu/jammyfu` profile
- Public cadence wording in `llms.txt`, `docs/llms.txt`, and `CITATION.cff`
- Tests and governance records for those copy changes

## Out of Scope

- Star data, ranking order, historical snapshot data, source descriptions, existing translations, model configuration, unrelated copy or automation redesign
- Ranking, star-fetch, and workflow logic
- Hand-editing ranking data or history snapshots
- Merging to `main`
- Creating `jammyfu/jammyfu` or changing the GitHub About field by API
- Private repositories, star farming, invented usage or capability claims

## Tasks

- [x] Audit repository requirements, current source hashes and missing language/hook fields
- [x] Fill the missing detailed translations and short hooks using the glossary and existing guards
- [x] Independently review all new wording and prove no old translated field changed
- [x] Regenerate pages and verify zero translation/hook gaps across all current categories
- [ ] Publish the completed content and verify CI and Pages on the resulting commit
- [x] Confirm README vs About cadence: README stays daily without clocks; About is owner-managed and already daily
- [x] First screen: clear value, live-board entry, quick use; fold README star-history charts
- [x] Add `docs/github-profile-draft.md` (Chinese and English; verified public projects only)
- [x] Align leftover public twice-daily wording in `llms.txt` and `CITATION.cff`
- [x] Run `python3 tools/verify.py` and `python3 tools/next_plan.py --check`
- [x] Open an unmerged pull request (https://github.com/jammyfu/github-risers/pull/21; not merged)

## Verification

- `python3 tools/i18n_pipeline.py --translate --hooks --dry-run`
- `python3 tools/newcomer_i18n.py --strict`
- `python3 tools/verify.py`
- `python3 tools/verify.py --daily`
- `python3 tools/next_plan.py --check`
- Compare all previously stored translation fields and API data with the base commit

## Next Candidates

- Observe the next unattended scheduled update and same-day duplicate suppression
- Consider making the operator completeness check cover hooks as well as translations without blocking raw-data refreshes
- Thin newcomer boards and the acceleration column remain in `TODO_BACKLOG.md`
- Owner may copy `docs/github-profile-draft.md` into `jammyfu/jammyfu` if they choose to publish it
- Observe the next unattended daily update after any authorized merge
- Do not treat a failed profile-repo fetch as proof that the repository is missing
1,354 changes: 1,026 additions & 328 deletions README.ja.md

Large diffs are not rendered by default.

1,354 changes: 1,026 additions & 328 deletions README.ko.md

Large diffs are not rendered by default.

1,354 changes: 1,026 additions & 328 deletions README.md

Large diffs are not rendered by default.

1,354 changes: 1,026 additions & 328 deletions README.zh-Hans.md

Large diffs are not rendered by default.

1,354 changes: 1,026 additions & 328 deletions README.zh-Hant.md

Large diffs are not rendered by default.

2 changes: 2 additions & 0 deletions TODO_BACKLOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@

## Later

- [ ] Owner can copy `docs/github-profile-draft.md` into `jammyfu/jammyfu` if they choose to publish it
- [x] Owner set the GitHub About description to daily
- [ ] Candidate discovery for tracked projects with owner approval

## Risks / Blockers
Expand Down
69 changes: 69 additions & 0 deletions docs/github-profile-draft.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
# GitHub profile README draft (not published)

This file is a bilingual draft for a `jammyfu/jammyfu` profile README. It is **not** live. Copying this text into GitHub Risers does not publish a homepage.

个人主页仓的存在性与访问权限尚未独立核实;本文件仅为未发布草案。

The existence and access of the profile repository have not been independently verified; this file is an unpublished draft only.

Do not treat the copy below as a live profile, a usage report, or a list of private work. Only public repositories and public URLs already verified on GitHub / the open web are listed. No star counts, traffic numbers, trophies, or invented background.

## GitHub Risers About field (repo settings, not this PR)

GitHub Risers **README / FAQ / FACTS** already say the boards update **daily**, without naming a timezone or time slot. Operator clocks stay in `docs/DAILY_UPDATE.md`.

The GitHub **About** description is repository settings, not stored in this repo. The owner has already set it to updated daily. This draft does not change it.

---

## 中文草案

做实用 AI 工具、游戏开发技能与创作工具,让你也能复现。

### 先看这三个公开项目

1. **[Open Game Skills](https://github.com/jammyfu/open-game-skills)**
开源的游戏 Agent 技能包:手感、战斗、镜头与引擎适配。用一句话描述你要做的游戏,agent 按技能调度。

2. **[GitHub Risers](https://github.com/jammyfu/github-risers)**
GitHub 涨星榜:按每天新增星标(而不是总星标)给仓库排名。AI 为主榜。在线看:[jammyfu.github.io/github-risers](https://jammyfu.github.io/github-risers/)

3. **[MagMark](https://github.com/jammyfu/MagMark)**
面向中文与中英混排的 Markdown 排版与导出。在线体验:[magmark.cn](https://magmark.cn/)(当前是 beta)

### 其他公开仓库

- [ComfyUI_PaintingCoderUtils](https://github.com/jammyfu/ComfyUI_PaintingCoderUtils) — ComfyUI 自定义节点,用于图像和文本工作流
- [reverse-engineering-atlas](https://github.com/jammyfu/reverse-engineering-atlas) — 逆向工程项目地图(游戏反编译 / 重编译、工具与工作流)

### 作品与账号

- 作品体验:[bubufu.com](https://bubufu.com)
- X:[@laofu](https://x.com/laofu)

---

## English draft

I make practical AI tools, game-development skills, and creative tools that you can reproduce.

### Start with these public projects

1. **[Open Game Skills](https://github.com/jammyfu/open-game-skills)**
An open-source agent skill pack for game feel, combat, camera, and engine adapters. Describe the game in plain language; the dispatcher loads skills.

2. **[GitHub Risers](https://github.com/jammyfu/github-risers)**
GitHub repos ranked by stars gained per day, not total stars. AI first. Live boards: [jammyfu.github.io/github-risers](https://jammyfu.github.io/github-risers/)

3. **[MagMark](https://github.com/jammyfu/MagMark)**
Magazine-grade Markdown layout and CJK typography. Try it at [magmark.cn](https://magmark.cn/) (beta).

### More public repositories

- [ComfyUI_PaintingCoderUtils](https://github.com/jammyfu/ComfyUI_PaintingCoderUtils) — ComfyUI custom nodes for image and text workflows
- [reverse-engineering-atlas](https://github.com/jammyfu/reverse-engineering-atlas) — a map of reverse-engineering projects, tools, and workflows

### Site and X

- Work: [bubufu.com](https://bubufu.com)
- X: [@laofu](https://x.com/laofu)
2 changes: 1 addition & 1 deletion docs/llms.txt
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# GitHub Risers (GitHub 涨星榜)

> GitHub trending repositories ranked by star growth (stars gained per day), not total stars. AI is the main board; developer tools, security, web, infrastructure, design and data have their own boards, each with a 7-day "hottest new repos" list. Numbers come from the GitHub API only. Updated twice a day: 00:00 Beijing time and 00:00 Los Angeles time. READMEs in English, 简体中文, 繁體中文, 日本語, 한국어. MIT license. Open source, no telemetry. Not affiliated with GitHub.
> GitHub trending repositories ranked by star growth (stars gained per day), not total stars. AI is the main board; developer tools, security, web, infrastructure, design and data have their own boards, each with a 7-day "hottest new repos" list. Numbers come from the GitHub API only. Updated daily. READMEs in English, 简体中文, 繁體中文, 日本語, 한국어. MIT license. Open source, no telemetry. Not affiliated with GitHub.

GitHub Risers is a script-generated leaderboard, not a manual editorial list. It is not a star-buying or promotion service and does not use generative AI to compute rankings.

Expand Down
4 changes: 2 additions & 2 deletions docs/project-governance/ACCEPTANCE.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

- Every project has stars/day for 7, 30 and 365 days or is listed as missing with the API error
- Rankings in order: week, month, year, total (last)
- Each project shows a star-history SVG in every README
- Each project shows a star-history SVG in every README; README ranking tables keep numbers first and fold the charts in `<details>`
- README.md is English; zh-Hans, zh-Hant, ja, ko exist; each has the switcher on its first line
- No analytics/tracking script anywhere (`tests/test_repo.py::ZeroTelemetryTests`)
- `daily-update.yml` and `tools/local_daily.sh` exist; `docs/DAILY_UPDATE.md` states whether Actions can run and why
Expand All @@ -22,7 +22,7 @@

- The `updated` badge is dynamic (`shields.io` JSON → `data/stats.json` `today_utc`); i18n templates contain no `YYYY-MM-DD`
- The stamp line is written from `stats.generated_at` on every `python3 tools/render_readme.py` run
- First screen states what the list is, that it updates daily, how numbers are computed, and how to use or contribute
- First screen states what the list is, that it updates daily, where the live boards are, how to use them, how numbers are computed, and how to use or contribute. Public README copy does not name a timezone or time slot.

## Phase 4: harness

Expand Down
7 changes: 7 additions & 0 deletions docs/project-governance/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# CHANGELOG.md

## 2026-11-07 (public first screen)

- README first screen now states the value, the live-board URL, and three quick-use steps before the category leaders.
- Star-history charts on README boards are folded; ranking tables keep the numbers. Full top 20 remains in `latest/`.
- `llms.txt` and `CITATION.cff` now say daily, matching FAQ/FACTS/README. GitHub About is owner-managed and already daily.
- Added `docs/github-profile-draft.md` as an unpublished bilingual draft for a profile README. It does not assert that `jammyfu/jammyfu` is missing. GitHub About is owner-managed and already daily.

## 2026-11-07 (complete current translations)

- Completed detailed descriptions and short hooks for all current ranking entries in English, Simplified Chinese, Traditional Chinese, Japanese and Korean.
Expand Down
7 changes: 7 additions & 0 deletions docs/project-governance/DECISIONS.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,6 +102,13 @@
- The immediate refresh used the existing production workflow. The owner subsequently authorized merging PR #19 and correcting the stale Pages schedule copy. Public English and Simplified Chinese copy says daily without exact clock claims; visible text and structured metadata stay aligned.


## 2026-11-07 — public first screen vs GitHub About cadence

- Public README, FAQ, FACTS, HOW_IT_WORKS, Pages, `llms.txt` and `CITATION.cff` say the boards update daily and do not name a timezone or time slot. Operator clocks stay in `docs/DAILY_UPDATE.md`.
- The GitHub About description is not in git. The owner has already set it to daily; this repository does not change that field.
- README ranking tables show numbers first. Star-history SVGs stay in the file, folded in `<details>`, so the first screen stays scannable without dropping the existing chart contract.
- `docs/github-profile-draft.md` is an unpublished draft for a `jammyfu/jammyfu` profile README. A failed fetch does not prove the profile repository is missing; existence and access have not been independently verified here.

## 2026-11-07 — translation completion is separate from data freshness

- A successful API refresh or permissive daily verification is not evidence that translation is complete. Completion requires zero missing detailed-description and hook languages across every current category, plus a source-language audit for English output.
Expand Down
10 changes: 10 additions & 0 deletions docs/project-governance/WORKLOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,6 +98,16 @@
- Merge the exact verified final head after its CI passes. No formal review approval is submitted. Next operational check: confirm main CI/Pages deployment, then observe the next unattended schedule run for refresh and duplicate suppression.


## 2026-11-07 — public first screen and profile draft (PLAN-008)

- README already said daily with no timezone. Public `llms.txt` and `CITATION.cff` were still on the old twice-daily wording and were aligned to daily without clocks. The owner later set GitHub About to daily; this repo does not edit that field.
- First screen now leads with live boards and a three-step quick use. Star-history SVGs remain in every README, folded under `<details>`. No ranking data, workflows, or star numbers were hand-edited.
- Added `docs/github-profile-draft.md` (Chinese and English) for a `jammyfu/jammyfu` profile. It lists only verified public projects and URLs. A failed fetch is not proof the profile repo is missing; the draft now says existence and access were not independently verified, and that the file is unpublished.
- Verification: `python3 tools/verify.py` green (233 tests); `python3 tools/verify.py --daily` and `python3 tools/next_plan.py --check` green.
- Unmerged PR: https://github.com/jammyfu/github-risers/pull/21
- `jammyfu/open-game-skills` and `jammyfu/MagMark` README first-screen edits exist on local branches only. `git push` returned 403 (`Permission to jammyfu/<repo>.git denied to cursor[bot]`). ManagePullRequest is this repository only; no substitute API was used. GitHub About remains an owner settings change.
- Correction on the same PR: `docs/github-profile-draft.md` no longer asserts that `jammyfu/jammyfu` does not exist. A failed fetch is not proof of absence. The draft now says existence and access were not independently verified, and that the file is unpublished. About was already set to daily by the owner.

## 2026-11-07 — complete current ranking translations (PLAN-007)

- The current ranking had 38 missing detailed descriptions and 39 repos with missing hook languages. API/data success did not mean translation completeness; the previous completion report left this work unfinished.
Expand Down
2 changes: 1 addition & 1 deletion llms.txt
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# GitHub Risers (GitHub 涨星榜)

> GitHub trending repositories ranked by star growth (stars gained per day), not total stars. AI is the main board; developer tools, security, web, infrastructure, design and data have their own boards, each with a 7-day "hottest new repos" list. Numbers come from the GitHub API only. Updated twice a day: 00:00 Beijing time and 00:00 Los Angeles time. READMEs in English, 简体中文, 繁體中文, 日本語, 한국어. MIT license. Open source, no telemetry. Not affiliated with GitHub.
> GitHub trending repositories ranked by star growth (stars gained per day), not total stars. AI is the main board; developer tools, security, web, infrastructure, design and data have their own boards, each with a 7-day "hottest new repos" list. Numbers come from the GitHub API only. Updated daily. READMEs in English, 简体中文, 繁體中文, 日本語, 한국어. MIT license. Open source, no telemetry. Not affiliated with GitHub.

GitHub Risers is a script-generated leaderboard, not a manual editorial list. It is not a star-buying or promotion service and does not use generative AI to compute rankings.

Expand Down
6 changes: 3 additions & 3 deletions tests/test_i18n_remaining.py
Original file line number Diff line number Diff line change
Expand Up @@ -82,9 +82,9 @@ def test_a_description_that_changes_back_is_a_hit_again(self):

def test_table_uses_translation_per_language_and_original_without_one(self):
c = lib_of("o/r", "Original text", **{"zh-Hans": "原文的译文"})
self.assertIn("<br>原文的译文", render_readme.new_table(ITEMS, "zh-Hans", c))
self.assertIn("<br>Original text", render_readme.new_table(ITEMS, "ko", c))
self.assertIn("<br>Original text", render_readme.new_table(ITEMS, "zh-Hans", {}))
self.assertIn("<br>原文的译文", render_readme.new_table(ITEMS, "zh-Hans", c)[0])
self.assertIn("<br>Original text", render_readme.new_table(ITEMS, "ko", c)[0])
self.assertIn("<br>Original text", render_readme.new_table(ITEMS, "zh-Hans", {})[0])


class ProblemsTests(unittest.TestCase):
Expand Down
Loading
Loading