HelloGitHub Vol.117 精选：39 个入门级开源项目全解析（含 4 段可运行示例代码）

• 技术博客
• 文档
• 知识库

【免费下载链接】HelloGitHub

:octocat: 分享 GitHub 上有趣、入门级的开源项目。Share interesting, entry-level open source projects on GitHub.

项目地址：https://gitcode.com/GitHub_Trending/he/HelloGitHub

点击查看免费下载

本文围绕 HelloGitHub 第 117 期英文月刊 content/en/HelloGitHub117.md 展开，逐项解析 39 个 GitHub 上"有趣、入门级"的开源项目，覆盖 C、C#、C++、Go、Java、JavaScript、Kotlin、PHP、Python、Rust、Swift、AI 与 Other 共 13 个分类，并完整保留其中 4 段可直接复制运行的示例代码（Alpine.js、tinypdf、huggingface_hub、ragas）。读完本文，你将系统掌握本期月刊推荐的项目全貌，并了解这些项目在 HelloGitHub 月刊体系中的定位、收集来源与生成机制，可直接按需选用、上手体验。

一、本期概览：HelloGitHub 第 117 期的内容结构

HelloGitHub 是一份每月 28 号更新的开源月刊，定位是"分享 GitHub 上有趣、入门级的开源项目"，旨在让读者用很短的时间感受到开源的魅力。本仓库中的英文版月刊按期号存放于 content/en/ 目录，第 117 期对应文件为 content/en/HelloGitHub117.md，文中明确标注"Updated on the 28th of each month"。

本期共收录39 个项目，分布如下：

分类	项目数	代表项目
C	2	Hexecute、TaskExplorer
C#	3	BetterLyrics、LiteMonitor、Screenbox
C++	1	iDescriptor
Go	4	gitmal、goose、kaiju、unregistry
Java	2	fesod、jib
JavaScript	5	alpine、ChatLab、dev、ogame-vue-ts、tinypdf
Kotlin	2	komi-store、Xed-Editor
PHP	1	monica
Python	5	devpush、Fast-F1、gmail-cleaner、PasteMD、rendercv
Rust	2	check-if-email-exists、hl
Swift	1	port-killer
AI	5	banana-slides、beads、huggingface_hub、LLM-RL-Visualized、ragas
Other	5	blog-post-workflow、FreeDomain、HiSH、I-wanna-clean-keyboard、MySpeed、UpSnap

注：Other 分类原文列出 6 个条目（No.34–39），本期实际推荐总数以原文为准。

从分类覆盖看，本期既包含系统工具类（任务管理器、硬件监控、端口释放）、也包含开发者基础设施类（数据库迁移、镜像同步、容器镜像构建），还紧跟 AI 浪潮收录了 5 个 AI 相关项目。这与 README_en.md 中"内容包括热门项目、入门级项目、让生活更美好的工具、书籍、学习笔记、企业级项目等"的定位一致，符合"面向新手程序员、编程爱好者和开源社区爱好者"的目标读者群。

二、月刊机制：从 GitHub 热点收集到统一模板生成

在深入项目之前，先了解你正在阅读的这份月刊是如何诞生的，这有助于理解后续所有条目的信息粒度。

2.1 收集源头：GitHub Bot 自动抓取今日热点

仓库的 script/github_bot/github_bot.py 实现了月刊的项目收集脚本。核心流程是：

1. 拉取事件流：调用 GitHub API 的received_events接口（https://api.github.com/users/{username}/received_events），以配置账号收到的 Watch（Star）事件为数据源。GitHub 规定默认每页 30 条、最多 300 条，脚本通过循环 10 页get_all_data()拉满全部 300 条数据。
2. 过滤条件：check_condition()只保留type == 'WatchEvent'且payload.action == 'started'的事件，同时排除"自己项目"的 Star 事件，并按DAY = 1做时间窗口过滤（默认最近 1 天）。
3. Star 数阈值：get_stars()逐个请求仓库详情获取stargazers_count，通过STARS = 100临界值过滤掉低热度项目，最终按 star 数从高到低排序（sorted(..., key=itemgetter('repo_stars'), reverse=True)）。
4. 邮件推送：send_email()使用smtplib.SMTP_SSL()连接 QQ 邮箱 SMTP（smtp.qq.com:465），将整理好的 HTML 表格（包含头像、用户名、项目名、Star 日期、Star 数量）发送到配置的接收邮箱。

2.2 统一模板：make_content 批量生成月刊

script/make_content/make_content.py 用于解决"每期月刊通用部分需手动维护"的问题。脚本以template.md为模板，通过两个占位符完成替换：

• {{ hello_github_content }}（CONTENT_FLAG）：替换为当期项目内容
• {{ hello_github_num }}（NUM_FLAG）：替换为期号

入口main()接收命令行参数：传入一位数字自动补零（如4→04），传入all则遍历目录批量生成所有期号。每次运行产出HelloGitHub{num}.md，这正是本仓库 content/en/HelloGitHub117.md 这类文件的生成路径。

因此，本期 39 个项目条目的"编号 + 项目名 + 一句话介绍 + 配图"的统一格式，均来自该模板体系，保证了各期月刊的版式一致性。

三、C 与 C++：桌面端系统工具

3.1 Hexecute（No.1，C）——Wayland 鼠标手势启动器

Hexecute是一款基于 Wayland 的桌面鼠标手势启动器，通过绘制图案快速启动应用程序。它最突出的特点是添加新手势只需一条命令 + 重复绘制三次，操作简单直观；所有手势数据存储在 JSON 文件中，方便编辑、备份与迁移。适合喜欢"少敲键盘、多动鼠标"的 Linux 桌面用户。

3.2 TaskExplorer（No.2，C）——比系统自带更强大的 Windows 任务管理器

TaskExplorer是 Windows 平台的高级任务管理工具。相比系统自带的"任务管理器"，它能实时展示更细致的进程信息，包括线程栈（thread stacks）、文件句柄（file handles）、网络连接等维度，适合排查进程异常占用、定位资源泄漏等场景。

3.3 iDescriptor（No.6，C++）——跨平台 iOS 设备管理工具

iDescriptor是一款免费开源的跨平台 iPhone/iPad 管理工具，支持 Windows、Linux、macOS。功能包括文件管理、照片导入、虚拟定位、AirPlay 屏幕镜像、USB 线缆真伪检测等。对有 iOS 设备管理需求但不想依赖 iTunes 的用户是不错的替代品。

四、Go：数据库迁移、游戏引擎与镜像同步

本期 Go 分类共 4 个项目，覆盖了从数据库运维到游戏开发的多个方向。

4.1 gitmal（No.7）——Git 仓库一键转静态网站

gitmal用 Go 开发，可把一个 Git 仓库转换为静态网站。它解析仓库的文件结构、提交历史、代码内容，提供类似 GitHub 的浏览体验（浏览代码、查看提交记录），非常适合用于个人开源项目代码展示或团队内部代码分享。

4.2 goose（No.8）——开箱即用的数据库迁移工具

goose是一款 Go 数据库迁移工具，支持CLI 与第三方库两种使用模式：常规迁移用 SQL 文件即可，复杂迁移逻辑可编写 Go 代码。兼容Postgres、MySQL、ClickHouse等数据库。对 Go 后端项目而言，goose 是"开箱即用"的迁移方案，相比手写迁移脚本有更规范的版本管理。

4.3 kaiju（No.9）——Go + Vulkan 的高性能游戏引擎

kaiju是用 Go 语言和 Vulkan 图形 API 构建的 2D/3D 游戏引擎，允许开发者直接用 Go 开发游戏。内置可视化编辑器、Soloud 音频库、Bullet3 物理引擎，主打高渲染性能与低内存占用，降低了 Go 开发者进入游戏开发的门槛。

4.4 unregistry（No.10）——像 rsync 一样同步 Docker 镜像

unregistry解决一个真实痛点：在没有外部容器镜像仓库（registry）的情况下，把本地 Docker 镜像推到远程服务器。它通过简单的docker push命令实现，并且只传输缺失的镜像层，比docker save/load传输整包更省流量、更快。适合内网环境、离线机房等场景。

五、Java 与 Kotlin：JVM 生态的实用组件

5.1 fesod（No.11，Java）——告别 OOM 的电子表格处理库

fesod是 Apache 基金会下的高性能、低内存 Java 电子表格处理库，基于 Apache POI 优化封装，通过流式读取有效避免大文件处理时的 OOM 问题。处理超大 Excel 文件的 Java 项目可以直接替换/升级此库。

5.2 jib（No.12，Java）——免 Dockerfile 的 Java 应用镜像构建工具

jib是 Google 开源的 Java 应用容器镜像构建工具，无需安装 Docker、无需编写 Dockerfile即可构建镜像，提供Maven/Gradle 插件、Java 库、CLI多种使用方式，可无缝嵌入现有 Java 构建流程，显著简化容器化过程。

5.3 komi-store（No.18，Kotlin）——跨平台的开源应用商店客户端

komi-store用 Kotlin 开发的跨平台开源应用商店客户端，支持一键发现热门开源项目、下载安装包（APK、EXE、DMG 等）、追踪已安装应用并提示更新。相当于一个"开源应用的分发入口"。

5.4 Xed-Editor（No.19，Kotlin）——Android 上的代码编辑器

Xed-Editor是开源 Android 文本/代码编辑器：内置Termux 终端可运行 Python 和 Node.js，支持200+ 编程语言的语法高亮、自动缩进、文件管理等功能。移动端写代码的场景非常适用。

六、JavaScript 前端：从轻量框架到零依赖 PDF 生成

本期 JavaScript 分类信息量最大，其中两个项目附带了完整代码示例，务必亲手运行。

6.1 alpine（No.13）——极简 JavaScript 交互框架（含示例）

alpine是为前端交互设计的极简轻量框架，语法类似 Vue 但无需任何构建工具，直接在 HTML 中引入即可使用。它既解决了 jQuery 繁琐的 DOM 操作，又避免了 Vue/React 的复杂性与性能开销，非常适合"前后端分离的轻量项目"或"只需少量动态行为的页面"，例如表单处理、弹窗（modal）、手风琴菜单等。

原文给出了一段可直接运行的示例：

<div x-data="{ count: 0 }"> <button x-on:click="count++">Increment</button> <span x-text="count"></span> </div>

代码要点：

• x-data声明一个响应式数据作用域，{ count: 0 }即初始状态；
• x-on:click="count++"绑定点击事件并更新数据；
• x-text="count"把元素文本与count绑定，数据变化自动刷新视图。

把这段代码放进任意 HTML 页面并引入 alpine 脚本，即可得到一个"点击自增"的交互组件——这是体验"声明式交互 + 零构建"最快的方式。

6.2 ChatLab（No.14）——开箱即用的聊天记录分析工具

ChatLab是本地优先（locally-first）的聊天记录分析工具，无需把数据上传云端（AI 功能除外），支持SQL 查询、AI 智能挖掘、回顾个人聊天历史。注重隐私的用户可以放心使用。

6.3 dev（No.15）——知名 Web 编辑器 CodeMirror 的核心开发仓库

dev是知名 Web 代码编辑器组件CodeMirror的核心开发仓库，可通过 npm 安装，快速构建可扩展、易用的代码编辑器，支持语法高亮、自动补全、错误提示、代码折叠等功能。需要在自己网页里嵌入代码编辑能力的开发者，应直接关注此仓库。

6.4 ogame-vue-ts（No.16）——文本宇宙策略游戏

ogame-vue-ts用 TypeScript + Vue 3 构建的文本宇宙策略游戏，灵感来自经典 OGame《银河帝国》。玩家在星系中建设行星/月球、研发科技、组建舰队与防御、进攻其他星球、招募军官。适合想学习"Vue 3 大型项目组织方式"的开发者边玩边学。

6.5 tinypdf（No.17）——压缩到 3.3KB 的零依赖 PDF 生成库（含示例）

tinypdf是 TypeScript 编写的 PDF 生成库：核心代码不足 400 行，体积仅 3.3KB，刻意去掉了自定义字体、图片、压缩等非必需功能，适合生成发票、收据、证书等简单文档。

原文示例（Node.js 环境）：

import { pdf } from 'tinypdf' import { writeFileSync } from 'fs' const doc = pdf() doc.page((ctx) => { ctx.rect(50, 700, 200, 40, '#2563eb') // blue rectangle ctx.text('Hello PDF!', 60, 712, 24, { color: '#ffffff' }) ctx.line(50, 680, 250, 680, '#000000', 1) // black line }) writeFileSync('output.pdf', doc.build())

代码要点：

• pdf()创建文档对象，doc.page(cb)打开一个页面并注入绘图上下文ctx；
• ctx.rect(x, y, w, h, color)绘制矩形，ctx.text(str, x, y, size, opts)绘制文本，ctx.line(...)绘制线条；
• doc.build()返回 PDF 二进制数据，配合writeFileSync落盘生成output.pdf。

这一"极简 API + 零依赖"的设计哲学，与 alpine 的"轻量优先"思路一脉相承，也是本期 JavaScript 分类的两大亮点。

七、PHP 与 Python：Web 应用与效率工具

7.1 monica（No.20，PHP）——开源个人关系管理系统

monica基于 Laravel + Vue.js 构建的开源个人关系管理系统（PRM），用于记录与亲友的互动细节：人情往来、生日提醒、事件安排等。对"想研究 Laravel 全家桶落地"的 PHP 开发者是很好的参考项目。

7.2 devpush（No.21，Python）——自托管 PaaS，Vercel 的开源替代

devpush是开源的自托管 Web 应用部署平台，定位为Vercel 的替代方案：在你自己的服务器上，通过git push 自动完成应用构建与部署，支持 Python、Node.js、PHP 等多种语言。想摆脱云厂商绑定、自己掌控部署链路的团队值得关注。

7.3 Fast-F1（No.22，Python）——F1 赛事数据分析库

Fast-F1是获取与分析 F1 赛事数据的 Python 库，支持查询比赛成绩、赛程、圈速、轮胎、遥测（telemetry）、天气等数据，内置 API 请求与结果解析的缓存机制，配合 Pandas 和 Matplotlib 使用，适合 F1 数据分析和教学场景。

7.4 gmail-cleaner（No.23，Python）——隐私优先的 Gmail 收件箱清理工具

gmail-cleaner是开源、注重隐私的 Gmail 批量清理工具，基于FastAPI提供 Web 界面，支持批量退订、删除、归档、标签管理、邮件信息导出。邮箱堆积成山的用户可用它快速整理收件箱。

7.5 PasteMD（No.24，Python）——AI 内容一键粘贴进 Word

PasteMD是 Python 编写的 Windows 托盘工具：自动把剪贴板中来自网页 AI 的Markdown/富文本回复，通过 Pandoc 转换为 DOCX，并直接插入当前 Word/WPS 光标位置。写文档时引用 AI 输出的场景非常实用。

7.6 rendercv（No.25，Python）——像写代码一样做简历

rendercv是基于 Typst 的简历生成器，面向程序员、学生和科研人员：写一个纯文本 YAML 文件，一键生成排版精美的专业 PDF 简历。简历内容与样式分离的设计，让"改简历"从手动排版变成改配置。

八、Rust 与 Swift：命令行与 macOS 小工具

8.1 check-if-email-exists（No.26，Rust）——不发邮件验证邮箱

check-if-email-exists是 Rust 开发的邮箱验证工具：通过正则、DNS、SMTP多重检查判断邮箱有效性，全程不发送邮件，支持API 与 CLI两种使用方式。批量验证邮箱、清理无效地址等场景直接可用。

8.2 hl（No.27，Rust）——高性能命令行日志查看器

hl是 Rust 编写的高性能命令行日志查看与处理器，能把JSON 和 logfmt格式的结构化日志转换为带高亮、易读的格式。排查线上问题时比裸看日志更高效。

8.3 port-killer（No.28，Swift）——macOS 一键释放端口

port-killer是 macOS 原生菜单栏工具：自动检测监听中的 TCP 端口，一键结束占用进程。对"端口被占用又找不到进程"的日常开发痛点，它提供了最直接的解决方案。

九、AI 分类：PPT 生成、模型记忆、HF 客户端与 RAG 评测

本期 AI 分类收录 5 个项目，其中 2 个附带了代码示例，是 AI 工程化方向的必读内容。

9.1 banana-slides（No.29）——AI 驱动 PPT 生成

banana-slides基于 Nano Banana Pro API，根据用户的想法、大纲或文档（PDF、Markdown）自动生成结构清晰、排版规整的 PPT，并支持通过对话调整内容。做汇报材料时的效率利器。

9.2 beads（No.30）——AI 编程工具的记忆系统

beads是专为 AI 编程工具设计的记忆系统：采用Git + JSON 作为持久化存储，为 AI 编程 Agent 提供长期、结构化的记忆，解决长周期复杂编程任务中的上下文丢失问题。对正在构建 AI Agent 工具链的开发者很有参考价值。

9.3 huggingface_hub（No.31）——Hugging Face 官方 Python 客户端（含示例）

huggingface_hub是 Hugging Face 平台的官方开源 Python 客户端，提供模型、数据集、Spaces 的下载、上传与管理能力。

原文示例展示了最常用的下载用法：

from huggingface_hub import hf_hub_download hf_hub_download( repo_id="deepseek-ai/DeepSeek-V3.2", filename="config.json" )

代码要点：

• hf_hub_download是下载单个文件的入口函数；
• repo_id指定仓库标识（如deepseek-ai/DeepSeek-V3.2），filename指定仓库内文件路径（如config.json）；
• 该函数自带缓存与断点续传能力，重复下载不会重复消耗流量。

任何需要"在代码里拉取 HF 模型/数据集"的 Python 项目，都绕不开这个官方客户端。

9.4 LLM-RL-Visualized（No.32）——大模型原理图解

LLM-RL-Visualized包含100+ 张大模型技术原理示意图，系统讲解大模型与强化学习：覆盖LLM/VLM 大模型架构、训练算法（RL、RLHF、GRPO、DPO、SFT、CoT）、性能优化、RAG等主题。是学习大模型原理的"图解教材"。

9.5 ragas（No.33）——RAG 应用自动化评测框架（含示例）

ragas是专为评测与优化 RAG 应用而生的开源框架，提供客观、可量化的评测结果，并支持自动生成测试数据集。

原文示例展示了如何创建自定义评测指标：

import asyncio from ragas.metrics.collections import AspectCritic from ragas.llms import llm_factory # Setup your LLM llm = llm_factory("gpt-4o") # Create a metric metric = AspectCritic( name="summary_accuracy", definition="Verify if the summary is accurate and captures key information.", llm=llm ) # Evaluate test_data = { "user_input": "summarise given text\nThe company reported an 8% rise in Q3 2024, driven by strong performance in the Asian market. Sales in this region have significantly contributed to the overall growth. Analysts attribute this success to strategic marketing and product localization. The positive trend in the Asian market is expected to continue into the next quarter.", "response": "The company experienced an 8% increase in Q3 2024, largely due to effective marketing strategies and product adaptation, with expectations of continued growth in the coming quarter.", } score = await metric.ascore( user_input=test_data["user_input"], response=test_data["response"] ) print(f"Score: {score.value}") print(f"Reason: {score.reason}")

代码要点：

• llm_factory("gpt-4o")创建评测用的 LLM 实例；
• AspectCritic以"命名指标 + 自然语言定义"的方式自定义评测标准（本例为summary_accuracy摘要准确性）；
• metric.ascore(user_input, response)是异步评测入口，返回包含value（分数）与reason（理由）的结果对象；
• 评测无需构建完整 RAG 链路即可对"输入-输出"对打分，适合在开发早期快速验证生成质量。

这套"用 LLM 评判 LLM 输出"的范式，正是 RAG 应用质量闭环的关键一环。

十、Other 分类：从 GitHub Action 到网络与桌面小工具

10.1 blog-post-workflow（No.34）——GitHub Profile 动态同步

blog-post-workflow是一个 GitHub Action 工具：自动把最新的博客文章或其他 RSS 订阅内容同步到 GitHub 个人主页（Profile）或项目 README，让主页保持"常更常新"。

10.2 FreeDomain（No.35）——免费域名申请服务

FreeDomain由非营利组织 DigitalPlat 发起，为个人和组织提供免费域名注册服务，注册后可托管到 Cloudflare、Hostry 等 DNS 提供商。想低成本拥有一个自定义域名的人可以了解。

10.3 HiSH（No.36）——在鸿蒙上跑 Linux Shell

HiSH是专为 HarmonyOS（鸿蒙）设计的 Linux 模拟器与 Shell 工具：可在鸿蒙设备上运行完整的 Linux 环境，把手机/平板变成轻便的 Linux 开发终端。鸿蒙生态开发者值得关注。

10.4 I-wanna-clean-keyboard（No.37）——防误触的键盘锁定工具

I-wanna-clean-keyboard是基于 AutoHotkey 开发的 Windows 工具，可一键临时屏蔽笔记本键盘与鼠标输入，界面简洁优雅，适合擦键盘、记笔记、吃东西时防止误触，尤其适合笔记本用户。

10.5 MySpeed（No.38）——开箱即用的网速测试工具

MySpeed是开源轻量级网络速度监控统计工具：支持定时测速并生成统计图表，历史数据最长保留 30 天。长期观测家庭/办公网络质量非常合适。

10.6 UpSnap（No.39）——局域网设备唤醒工具

UpSnap是自托管的 Wake-on-LAN（网络唤醒）Web 应用：支持一键唤醒局域网内设备、端口状态监控、定时自动开机、网络设备自动发现。需要远程唤醒家中/办公室电脑的场景直接可用。

十一、如何进一步深入：从本期月刊到源码级学习

如果你被本期某个项目吸引，建议按以下路径深入，这也是 HelloGitHub 月刊的"正确打开方式"：

1. 先看演示图：月刊条目下方的配图直观展示了项目运行效果，可快速判断是否符合需求；
2. 再读仓库 README：每个项目在 GitHub 上都有完整文档，重点关注安装方式与 Quick Start；
3. 动手运行示例：本期 alpine、tinypdf、huggingface_hub、ragas 四段代码均可直接复制运行，是"5 分钟内上手"的最佳入口；
4. 参考相邻期号：在 content/en/ 目录中，content/en/HelloGitHub116.md 与 content/en/HelloGitHub118.md 分别为上一期与下一期，连续阅读可形成对开源生态的持续感知；
5. 理解月刊生成机制：若你对"月刊本身"感兴趣，可阅读 script/github_bot/github_bot.py（热点收集）与 script/make_content/make_content.py（模板生成），了解开源月刊背后的自动化流水线。

结语

本期 HelloGitHub Vol.117 的 39 个项目覆盖了桌面工具、开发者基础设施、前端轻量方案与 AI 工程化四大主线：有像 alpine、tinypdf 这样"极简哲学"的代表作，也有像 goose、jib、unregistry 这样解决真实工程痛点的"瑞士军刀"，还有 huggingface_hub、ragas 这类 AI 时代的"新基建"。无论你处于哪个技术栈、哪个学习阶段，都能从中找到适合自己的下一个动手项目——这正是 HelloGitHub 想传递的："兴趣是最好的老师"。

赞分享

• 技术博客
• 文档
• 知识库

【免费下载链接】HelloGitHub

:octocat: 分享 GitHub 上有趣、入门级的开源项目。Share interesting, entry-level open source projects on GitHub.

项目地址：https://gitcode.com/GitHub_Trending/he/HelloGitHub

点击查看免费下载

相关推荐

• HelloGitHub 第 80 期：39 个入门级开源项目精选指南（含可复现示例）

  HelloGitHub 第 80 期：39 个入门级开源项目精选指南（含可复现示例） 本文以 HelloGitHub 开源项目精选月刊的第 80 期为对象，系统

  技术博客文档知识库

• ATB 加速库对外头文件与库文件说明：CANN AscendTransformerBoost 接口依赖与链接实践指南

  ATB 加速库对外头文件与库文件说明：CANN AscendTransformerBoost 接口依赖与链接实践指南 本指南以 CANN ascend tran

  技术博客文档知识库

• 为 elizaOS Agent 接入 Hindsight 长期记忆：@vectorize-io/hindsight-eliza 插件实战指南

  为 elizaOS Agent 接入 Hindsight 长期记忆：@vectorize io/hindsight eliza 插件实战指南 本指南基于当前仓库

  技术博客文档知识库