mirror of
https://github.com/xushier/HD-Icons.git
synced 2026-09-15 04:44:04 +08:00
Compare commits
2
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 github-actions[bot]
|
865abf1be5 | ||
|
xushier
|
f2265cf358 |
@@ -0,0 +1,55 @@
|
|||||||
|
name: Build
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
paths:
|
||||||
|
- "inbox/**"
|
||||||
|
- "scripts/**"
|
||||||
|
- ".github/workflows/build.yml"
|
||||||
|
workflow_dispatch:
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: write
|
||||||
|
|
||||||
|
concurrency:
|
||||||
|
group: build
|
||||||
|
cancel-in-progress: false
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
build:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- name: 检出仓库
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: 安装 Python
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.12"
|
||||||
|
|
||||||
|
- name: 安装依赖
|
||||||
|
run: |
|
||||||
|
pip install Pillow
|
||||||
|
if ! command -v rsvg-convert >/dev/null 2>&1; then
|
||||||
|
sudo apt-get update -qq
|
||||||
|
sudo apt-get install -y -qq librsvg2-bin
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: 构建
|
||||||
|
id: build
|
||||||
|
env:
|
||||||
|
TINYPNG_KEY: ${{ secrets.TINYPNG_KEY }}
|
||||||
|
run: python scripts/build.py --repo .
|
||||||
|
|
||||||
|
- name: 提交并推送
|
||||||
|
run: |
|
||||||
|
git config user.name "github-actions[bot]"
|
||||||
|
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
|
||||||
|
git add -A
|
||||||
|
if git diff --cached --quiet; then
|
||||||
|
echo "没有需要提交的变更"
|
||||||
|
else
|
||||||
|
git commit -m "ci: 自动构建（新增 ${{ steps.build.outputs.added }} 个图标）"
|
||||||
|
git push
|
||||||
|
fi
|
||||||
-222
@@ -1,222 +0,0 @@
|
|||||||
<div align="center">
|
|
||||||
<img src="hd-icons.png" alt="logo" width="200">
|
|
||||||
<h1>HD-Icons：高清仪表盘图标</h1>
|
|
||||||
<p><em>1024×1024 超清分辨率 · 无损压缩优化 · 多种样式适配</em></p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<div align="center">
|
|
||||||
<!-- 徽章区域 -->
|
|
||||||
[](https://github.com/xushier/HD-Icons/stargazers)
|
|
||||||
[](https://github.com/xushier/HD-Icons/network)
|
|
||||||
[](https://github.com/xushier/HD-Icons/issues)
|
|
||||||
[](https://github.com/xushier/HD-Icons/blob/master/LICENSE)
|
|
||||||
|
|
||||||
<!-- 统计信息 -->
|
|
||||||
[](https://github.com/xushier/HD-Icons/releases)
|
|
||||||
[](https://github.com/xushier/HD-Icons/commits/main)
|
|
||||||
[](https://github.com/xushier/HD-Icons)
|
|
||||||
|
|
||||||
<!-- CDN 徽章 -->
|
|
||||||
[](https://www.jsdelivr.com/package/gh/xushier/HD-Icons)
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<div align="center">
|
|
||||||
|
|
||||||
<!-- 快速导航 -->
|
|
||||||
<div>
|
|
||||||
<a href="#-项目简介"><strong>📖 项目简介</strong></a> •
|
|
||||||
<a href="#-使用说明三种方式"><strong>🚀 使用说明</strong></a> •
|
|
||||||
<a href="#-图标预览"><strong>✨ 图标预览</strong></a> •
|
|
||||||
<a href="https://github.com/xushier/HD-Icons/issues/new/choose"><strong>🎯 请求图标</strong></a>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- 活动图表 -->
|
|
||||||
<div>
|
|
||||||
<img align="center" alt="GitHub activity" src="https://repobeats.axiom.co/api/embed/94fe9f2a6c0bccb6dd42c71e49b6e83fc46aecf4.svg">
|
|
||||||
</div>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
<!-- GETTING STARTED -->
|
|
||||||
|
|
||||||
## 📝 项目简介
|
|
||||||
|
|
||||||
> 🎯 **使命**：为 Unraid Docker 容器和各类仪表盘应用提供高质量、标准化的图标解决方案
|
|
||||||
|
|
||||||
### ✨ 核心特性
|
|
||||||
|
|
||||||
| 特性 | 描述 |
|
|
||||||
|------|-----|
|
|
||||||
| 🖼️ **超清分辨率** | 1024×1024 像素，确保在任何尺寸下都清晰锐利 |
|
|
||||||
| 🗜️ **无损压缩** | 所有图标经过无损压缩，体积更小，质量不变 |
|
|
||||||
| 🎨 **优化显示** | 图标主体适当放大，满足各种使用场景 |
|
|
||||||
| 📁 **多样样式** | 提供 `border-radius`（圆角矩形）、 `circle`（圆形）和 `svg`（矢量）三种风格 |
|
|
||||||
| 🔄 **持续更新** | 不定期添加新图标，满足不断增长的需求 |
|
|
||||||
|
|
||||||
### 🎯 适用场景
|
|
||||||
|
|
||||||
本项目最初为 `Unraid Docker` 容器图标展示而设计，现已扩展支持多种仪表盘应用、部分APP及其他用途：
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
| 应用程序 | 描述 | 链接 | 备注 |
|
|
||||||
|----------|------|------|------|
|
|
||||||
| **FlatNas** | 新晋现代化仪表盘 | [🔗](https://github.com/Garry-QD/FlatNas) | 开源免费 |
|
|
||||||
| **Sun-Panel** | 适合国人体质的现代化仪表盘 | [🔗](https://github.com/hslr-s/sun-panel) | 1.3.0及之前版本开源，新版Pro授权99永久 |
|
|
||||||
| **Dashy** | 现代化仪表盘 | [🔗](https://github.com/Lissy93/dashy) | 开源免费 |
|
|
||||||
| **Homer Dashboard** | 简洁的静态主页 | [🔗](https://github.com/bastienwirtz/homer) | 开源免费 |
|
|
||||||
| **Heimdall** | 应用程序仪表盘 | [🔗](https://github.com/linuxserver/Heimdall) | 开源免费 |
|
|
||||||
| **Organizr(v2)** | 组织管理工具 | [🔗](https://github.com/causefx/Organizr) | 开源免费 |
|
|
||||||
| **Flame** | 自托管仪表盘 | [🔗](https://github.com/pawelmalak/flame) | 开源免费 |
|
|
||||||
| **SUI** | 简单用户界面 | [🔗](https://github.com/jeroenpardon/sui) | 开源免费 |
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### 🌟 社区支持
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
| 平台 | 账号/群组 | 链接 |
|
|
||||||
|------|-----------|------|
|
|
||||||
| **B站** | 小迪课代表 | [🎬 传送门](https://space.bilibili.com/32313260) |
|
|
||||||
| **公众号** | 小迪同学 | 📱 微信搜索关注 |
|
|
||||||
| **QQ群** | 647605169 | 💬 加入讨论 |
|
|
||||||
| **微信群** | dxyxddsbds（备注加群） | 📱 添加微信入群 |
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
> 💡 **需要新图标？** [点击这里提交请求](https://github.com/xushier/HD-Icons/issues/new/choose) 🎯
|
|
||||||
|
|
||||||
## 📖 使用说明（三种方式）
|
|
||||||
|
|
||||||
### 🐳 Docker 部署图标展示容器使用（强烈推荐）
|
|
||||||
|
|
||||||
> 🚀 **项目地址**：[HD-Icons-docker](https://github.com/xushier/HD-Icons-docker)
|
|
||||||
>
|
|
||||||
> 💡 **优势**：自动同步更新、一键复制、移动端适配、自定义上传
|
|
||||||
|
|
||||||
#### 🌟 功能展示
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
| 功能 | 预览 |
|
|
||||||
|------|------|
|
|
||||||
| **☀️ 日间模式** | <img src="day.png" alt="日间模式" width="400"> |
|
|
||||||
| **🌙 夜间模式** | <img src="night.png" alt="夜间模式" width="400"> |
|
|
||||||
| **📱 移动端适配** | <img src="mobile.png" alt="移动端自适应" height="400"> |
|
|
||||||
| **📋 一键复制** | <img src="copy.png" alt="单击复制地址" height="400"> |
|
|
||||||
| **📤 自定义上传** | <img src="upload.png" alt="自定义图片上传" height="400"> |
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### 🔗 远程链接使用（自动同步更新）
|
|
||||||
|
|
||||||
#### 📋 GitHub 原始链接
|
|
||||||
|
|
||||||
> 🌐 **适用场景**：可直接访问 GitHub 的用户
|
|
||||||
>
|
|
||||||
> 📝 **格式**：`https://raw.githubusercontent.com/xushier/HD-Icons/main/border-radius/图标名称.png`
|
|
||||||
>
|
|
||||||
> 🔗 **项目地址**：[HD-Icons](https://github.com/xushier/HD-Icons)
|
|
||||||
|
|
||||||
#### ⚡ CDN 加速链接
|
|
||||||
|
|
||||||
> 🚀 **适用场景**：无法直接访问 GitHub 但需要使用 GitHub 图标源的用户
|
|
||||||
>
|
|
||||||
> 📝 **格式**：`https://cdn.jsdelivr.net/gh/xushier/HD-Icons/border-radius/图标名称.png`
|
|
||||||
>
|
|
||||||
> 💡 **优势**：全球 CDN 加速，访问速度更快
|
|
||||||
|
|
||||||
> 📌 **使用提示**：将上述链接中的 `图标名称` 替换为实际图标文件名即可。[📋 查看所有图标](#-图标预览)
|
|
||||||
|
|
||||||
### 📱 移动应用使用
|
|
||||||
|
|
||||||
> 🎯 **支持应用**：Yamby、Hills 等安卓 APP
|
|
||||||
>
|
|
||||||
> 📦 **图标包地址**：`https://raw.githubusercontent.com/xushier/HD-Icons/main/icons.json`
|
|
||||||
>
|
|
||||||
> ⚠️ **注意**：如无响应，请开启代理环境或自行部署
|
|
||||||
>
|
|
||||||
> 🚀 **自部署方案**：[HD-Icons-docker](https://github.com/xushier/HD-Icons-docker)
|
|
||||||
|
|
||||||
## ✨ 图标预览
|
|
||||||
|
|
||||||
> 🎨 **持续更新中**：当前共计 0 个，数量不断增加，欢迎提交新图标请求
|
|
||||||
|
|
||||||
### 📦 圆角矩形图标
|
|
||||||
<div align="center">
|
|
||||||
<img src="_icons-radius.jpg" alt="圆角矩形图标集合" width="90%">
|
|
||||||
</div>
|
|
||||||
|
|
||||||
### ⭕ 圆形图标
|
|
||||||
<div align="center">
|
|
||||||
<img src="_icons-circle.jpg" alt="圆形图标集合" width="90%">
|
|
||||||
</div>
|
|
||||||
|
|
||||||
### 🎨 SVG 矢量图标
|
|
||||||
<div align="center">
|
|
||||||
|
|
||||||
<!-- SVG 图标预览区域 -->
|
|
||||||
|
|
||||||
<!-- 此处将自动生成 SVG 图标预览 -->
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
<!-- LEGAL -->
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🤝 支持与赞助
|
|
||||||
|
|
||||||
<div align="center">
|
|
||||||
<p><strong>！！！项目批量使用请告知！！！</strong></p>
|
|
||||||
<p><strong>💝 感谢您的支持，让这个项目持续发展！</strong></p>
|
|
||||||
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<td align="center">
|
|
||||||
<img src="_DONATE_A.jpg?raw=true" alt="支付宝赞助" width="300">
|
|
||||||
<p><strong>支付宝</strong></p>
|
|
||||||
</td>
|
|
||||||
<td align="center">
|
|
||||||
<img src="_DONATE_W.jpg?raw=true" alt="微信赞助" width="300">
|
|
||||||
<p><strong>微信支付</strong></p>
|
|
||||||
</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
<p><em>赞助时请备注「图标」，感谢您的慷慨支持！</em></p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
## 📜 免责声明
|
|
||||||
|
|
||||||
> ⚖️ **法律声明**：本仓库中图像的（几乎）所有产品名称、商标和注册商标均为其各自所有者的财产。仪表盘导航用户仅将本仓库中的所有图像用于识别目的。
|
|
||||||
>
|
|
||||||
> 📝 **使用说明**：这些图像文件中出现的名称、商标和品牌的使用不表示认可。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
<div align="center">
|
|
||||||
|
|
||||||
### 🌟 项目统计
|
|
||||||
|
|
||||||
[](https://star-history.com/#xushier/HD-Icons&Date)
|
|
||||||
|
|
||||||
### 📊 项目活跃度
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
<div align="center">
|
|
||||||
<p><strong>🎯 如果这个项目对您有帮助，请给个 ⭐ Star 支持一下！</strong></p>
|
|
||||||
<p><em>Made with ❤️ by xushier</em></p>
|
|
||||||
</div>
|
|
||||||
@@ -1,53 +0,0 @@
|
|||||||
import pathlib
|
|
||||||
from pathlib import Path
|
|
||||||
|
|
||||||
root = pathlib.Path(__file__).parent.resolve()
|
|
||||||
template_path = root / "_TEMPLATE.md"
|
|
||||||
readme_path = root / "README.md"
|
|
||||||
|
|
||||||
|
|
||||||
# def generate_img_tag(file,folder,radius):
|
|
||||||
# return f'<div style="width: 105px;text-align: center;display: inline-block;font-size: 12px;margin: 5px;"><img style="border: 1.5px dashed white;border-radius: {radius};" src="{folder}/{file.name}" alt="{file.stem}" /><br/>{file.stem}</div>'
|
|
||||||
|
|
||||||
def generate_img_tag(file,folder):
|
|
||||||
return f'<img src="{folder}/{file.name}" alt="{file.stem}" width="95">'
|
|
||||||
|
|
||||||
imgs = sorted(Path("./border-radius").glob("*.png"))
|
|
||||||
img_tags = [generate_img_tag(x,"border-radius") for x in imgs]
|
|
||||||
circle_imgs = sorted(Path("./circle").glob("*.png"))
|
|
||||||
circle_img_tags = [generate_img_tag(x,"circle") for x in circle_imgs]
|
|
||||||
svg_imgs = sorted(Path("./svg").glob("*.svg"))
|
|
||||||
svg_img_tags = [generate_img_tag(x,"svg") for x in svg_imgs]
|
|
||||||
all_nums = len(img_tags) + len(circle_img_tags) + len(svg_img_tags)
|
|
||||||
|
|
||||||
# Read the template file
|
|
||||||
with open(template_path, "r", encoding="UTF-8") as f:
|
|
||||||
lines = f.readlines()
|
|
||||||
|
|
||||||
# Find the line that starts with "<!-- ICONS -->"
|
|
||||||
# for line in lines:
|
|
||||||
# if line.startswith("<!-- START BORDER-RADIUS ICONS -->"):
|
|
||||||
# line_number = lines.index(line)
|
|
||||||
# break
|
|
||||||
# for line in lines:
|
|
||||||
# if line.startswith("<!-- START CIRCLE ICONS -->"):
|
|
||||||
# circle_line_number = lines.index(line)
|
|
||||||
# break
|
|
||||||
for line in lines:
|
|
||||||
if line.startswith("<!-- SVG 图标预览区域 -->"):
|
|
||||||
svg_line_number = lines.index(line)
|
|
||||||
break
|
|
||||||
|
|
||||||
# Insert the icons after the line
|
|
||||||
# lines.insert(line_number + 1, " ".join(img_tags))
|
|
||||||
# lines.insert(circle_line_number + 2, " ".join(circle_img_tags))
|
|
||||||
lines.insert(svg_line_number + 3, " ".join(svg_img_tags))
|
|
||||||
|
|
||||||
lines = ["> 🎨 **持续更新中**：当前共计 " + str(all_nums) + " 个，数量不断增加，欢迎提交新图标请求" if '> 🎨 **持续更新中**：当前共计 0 个，数量不断增加，欢迎提交新图标请求' in i else i for i in lines]
|
|
||||||
|
|
||||||
# Write the new file
|
|
||||||
with open(readme_path, "w", encoding="UTF-8") as f:
|
|
||||||
f.write("".join(lines))
|
|
||||||
f.write("\n")
|
|
||||||
|
|
||||||
print("文件已更新!")
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 457 KiB After Width: | Height: | Size: 556 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 3.2 MiB After Width: | Height: | Size: 4.4 MiB |
Binary file not shown.
|
After Width: | Height: | Size: 2.2 MiB |
+2
-2
@@ -1,8 +1,8 @@
|
|||||||
{
|
{
|
||||||
"name": "小迪的HD-Icons",
|
"name": "小迪的HD-Icons",
|
||||||
"description": "当前数量：1754，更新于：2026-02-01 21:43:36。不定期更新，有需求欢迎提交：github.com/xushier/HD-Icons",
|
"description": "当前数量：1754，更新于：2026-08-27 13:45:23。不定期更新，有需求欢迎提交：github.com/xushier/HD-Icons",
|
||||||
"total_count": 1754,
|
"total_count": 1754,
|
||||||
"update_at": "2026-02-01 21:43:36",
|
"update_at": "2026-08-27 13:45:23",
|
||||||
"icons": [
|
"icons": [
|
||||||
{
|
{
|
||||||
"name": "115-drive-1",
|
"name": "115-drive-1",
|
||||||
|
|||||||
@@ -0,0 +1,4 @@
|
|||||||
|
@echo off
|
||||||
|
chcp 65001 >nul
|
||||||
|
powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0publish.ps1" %*
|
||||||
|
pause
|
||||||
+52
@@ -0,0 +1,52 @@
|
|||||||
|
# HD-Icons 一键发布脚本
|
||||||
|
# 用法：把新图标放入 inbox/ 对应子文件夹后，双击 publish.bat（或运行本脚本）
|
||||||
|
# 可选参数：.\publish.ps1 -Message "自定义提交说明"
|
||||||
|
|
||||||
|
param([string]$Message = "")
|
||||||
|
|
||||||
|
$ErrorActionPreference = "Stop"
|
||||||
|
Set-Location $PSScriptRoot
|
||||||
|
|
||||||
|
# 定位 git（git 不在 PATH 时使用常见安装路径）
|
||||||
|
$git = "git"
|
||||||
|
if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
|
||||||
|
$fallback = "C:\Program Files\Git\cmd\git.exe"
|
||||||
|
if (Test-Path $fallback) { $git = $fallback } else {
|
||||||
|
Write-Host "[错误] 未找到 git，请安装 Git 或将其加入 PATH" -ForegroundColor Red
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# 检查 inbox 是否有新文件
|
||||||
|
$inboxStatus = & $git status --porcelain -- inbox
|
||||||
|
if (-not $inboxStatus) {
|
||||||
|
Write-Host "inbox 中没有新图标，无需发布。" -ForegroundColor Yellow
|
||||||
|
exit 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# 从文件名自动生成提交说明
|
||||||
|
$names = @($inboxStatus | ForEach-Object {
|
||||||
|
$_.Substring(3).Trim() -replace '^inbox/', ''
|
||||||
|
} | ForEach-Object { [System.IO.Path]::GetFileNameWithoutExtension($_) -replace '-\d+$', '' } | Sort-Object -Unique)
|
||||||
|
$prefixes = ($names | Select-Object -First 8) -join ", "
|
||||||
|
if ($names.Count -gt 8) { $prefixes += " 等" }
|
||||||
|
$fileCount = ($inboxStatus | Measure-Object).Count
|
||||||
|
if (-not $Message) {
|
||||||
|
$Message = "新增 $fileCount 个图标：$prefixes"
|
||||||
|
}
|
||||||
|
|
||||||
|
Write-Host "本次发布：$Message" -ForegroundColor Cyan
|
||||||
|
& $git add -A
|
||||||
|
& $git commit -m $Message
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
Write-Host "[错误] 提交失败" -ForegroundColor Red
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
& $git push
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
Write-Host "[错误] 推送失败，请检查网络或凭据" -ForegroundColor Red
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
Write-Host ""
|
||||||
|
Write-Host "已推送到 GitHub，Actions 将自动完成压缩、入库、索引、README 与预览图更新。" -ForegroundColor Green
|
||||||
|
Write-Host "进度查看：https://github.com/xushier/HD-Icons/actions"
|
||||||
@@ -0,0 +1,409 @@
|
|||||||
|
#!/usr/bin/env python3
|
||||||
|
# -*- coding: utf-8 -*-
|
||||||
|
"""
|
||||||
|
HD-Icons 一键构建脚本（本地 / GitHub Actions 通用）
|
||||||
|
|
||||||
|
流程：
|
||||||
|
1. 校验 inbox 新文件命名
|
||||||
|
2. TinyPNG 无损压缩 inbox 中的 PNG（SVG 不压缩）
|
||||||
|
3. 分发入库：inbox 文件移入对应目录，重名按"同前缀最大序号+1"自动改名
|
||||||
|
4. 全量重建 icons.json（输出格式与历史版本完全一致）
|
||||||
|
5. 更新 README.md 中的数量标记 <!--ICONS:xxx-->
|
||||||
|
6. 重新生成三张合并预览图（_icons-radius.jpg / _icons-circle.jpg / _icons-svg.jpg）
|
||||||
|
|
||||||
|
用法：
|
||||||
|
python scripts/build.py --repo .
|
||||||
|
|
||||||
|
环境变量：
|
||||||
|
TINYPNG_KEY TinyPNG API 密钥（inbox 有 PNG 时必需；GitHub 上配置为 Secret）
|
||||||
|
HDICONS_FONT 预览图标签字体路径（可选，默认自动查找）
|
||||||
|
"""
|
||||||
|
|
||||||
|
import argparse
|
||||||
|
import base64
|
||||||
|
import json
|
||||||
|
import os
|
||||||
|
import re
|
||||||
|
import shutil
|
||||||
|
import subprocess
|
||||||
|
import sys
|
||||||
|
import tempfile
|
||||||
|
import urllib.error
|
||||||
|
import urllib.request
|
||||||
|
from datetime import datetime
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
FOLDERS = ["border-radius", "circle", "svg"]
|
||||||
|
RAW_BASE = "https://raw.githubusercontent.com/xushier/HD-Icons/main"
|
||||||
|
IMAGE_EXTS = {".png", ".jpg", ".jpeg", ".svg", ".gif"}
|
||||||
|
|
||||||
|
NAME_RE = re.compile(r"^[a-z0-9]+(-[a-z0-9]+)*$")
|
||||||
|
NUM_SUFFIX_RE = re.compile(r"-\d+$")
|
||||||
|
README_MARKER_RE = re.compile(r"(<!--ICONS:(\w+)-->)(.*?)(<!--/ICONS:\2-->)")
|
||||||
|
|
||||||
|
# 预览图排版参数
|
||||||
|
PREVIEW = {
|
||||||
|
"icon": 128, # 单个图标缩略尺寸
|
||||||
|
"cols": 15, # 每行图标数
|
||||||
|
"gap_x": 30, # 水平间距
|
||||||
|
"gap_y": 62, # 垂直间距（含文件名文字区域）
|
||||||
|
"pad": 20, # 四周留白
|
||||||
|
"text_size": 17, # 文件名字号
|
||||||
|
"bg": (244, 246, 249),
|
||||||
|
"fg": (62, 66, 72),
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
def log(msg):
|
||||||
|
print(msg, flush=True)
|
||||||
|
|
||||||
|
|
||||||
|
def warn(msg):
|
||||||
|
print(f"[警告] {msg}", file=sys.stderr, flush=True)
|
||||||
|
|
||||||
|
|
||||||
|
def fail(msg):
|
||||||
|
print(f"[错误] {msg}", file=sys.stderr, flush=True)
|
||||||
|
sys.exit(1)
|
||||||
|
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------- 1. 校验 inbox
|
||||||
|
|
||||||
|
def validate_inbox(repo):
|
||||||
|
"""检查 inbox 内新文件的类型与命名，返回 (errors, warnings, files)。"""
|
||||||
|
errors, warnings, files = [], [], {}
|
||||||
|
for folder in FOLDERS:
|
||||||
|
inbox_dir = repo / "inbox" / folder
|
||||||
|
items = []
|
||||||
|
if not inbox_dir.is_dir():
|
||||||
|
files[folder] = items
|
||||||
|
continue
|
||||||
|
expected = ".svg" if folder == "svg" else ".png"
|
||||||
|
for f in sorted(inbox_dir.iterdir()):
|
||||||
|
if f.name == ".gitkeep" or not f.is_file():
|
||||||
|
continue
|
||||||
|
if f.suffix.lower() != expected:
|
||||||
|
errors.append(f"inbox/{folder}/ 只接受 {expected} 文件，发现：{f.name}")
|
||||||
|
continue
|
||||||
|
if not NAME_RE.match(f.stem):
|
||||||
|
errors.append(f"命名不合法（仅允许小写字母/数字/连字符）：{f.name}")
|
||||||
|
continue
|
||||||
|
if not NUM_SUFFIX_RE.search(f.stem):
|
||||||
|
warnings.append(f"{f.name} 未以数字结尾，建议形如 name-1 的命名")
|
||||||
|
items.append(f)
|
||||||
|
files[folder] = items
|
||||||
|
return errors, warnings, files
|
||||||
|
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------- 2. TinyPNG 压缩
|
||||||
|
|
||||||
|
def tinify(path, key):
|
||||||
|
"""调用 TinyPNG API 压缩单个 PNG，返回 (压缩前字节数, 压缩后字节数, 已用额度)。"""
|
||||||
|
data = path.read_bytes()
|
||||||
|
req = urllib.request.Request("https://api.tinify.com/shrink", data=data)
|
||||||
|
req.add_header("Authorization",
|
||||||
|
"Basic " + base64.b64encode(f"api:{key}".encode()).decode())
|
||||||
|
with urllib.request.urlopen(req, timeout=180) as resp:
|
||||||
|
info = json.loads(resp.read().decode())
|
||||||
|
quota = (resp.headers.get("Compression-Count")
|
||||||
|
or resp.headers.get("X-Compression-Count"))
|
||||||
|
with urllib.request.urlopen(info["output"]["url"], timeout=180) as r:
|
||||||
|
out = r.read()
|
||||||
|
if len(out) < len(data):
|
||||||
|
path.write_bytes(out)
|
||||||
|
return len(data), path.stat().st_size, quota
|
||||||
|
|
||||||
|
|
||||||
|
def compress_inbox(files, key):
|
||||||
|
saved = 0
|
||||||
|
quota = None
|
||||||
|
pngs = files["border-radius"] + files["circle"]
|
||||||
|
for f in pngs:
|
||||||
|
try:
|
||||||
|
before, after, quota = tinify(f, key)
|
||||||
|
except urllib.error.HTTPError as e:
|
||||||
|
if e.code == 429:
|
||||||
|
fail("TinyPNG 本月免费额度已用完（500 张/月），本次未做任何改动")
|
||||||
|
fail(f"压缩失败 {f.name}：HTTP {e.code} {e.reason}")
|
||||||
|
except (urllib.error.URLError, OSError) as e:
|
||||||
|
fail(f"压缩失败 {f.name}：网络错误 {e}")
|
||||||
|
saved += before - after
|
||||||
|
log(f" {f.name}: {before // 1024}KB -> {after // 1024}KB")
|
||||||
|
msg = f"共压缩 {len(pngs)} 张，节省 {saved // 1024}KB"
|
||||||
|
if quota:
|
||||||
|
msg += f"（本月已用 {quota}/500）"
|
||||||
|
log(msg)
|
||||||
|
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------- 3. 分发入库
|
||||||
|
|
||||||
|
def available_name(target_dir, name):
|
||||||
|
"""若目标已存在同名文件，按"同前缀最大序号+1"改名，否则保持原名。"""
|
||||||
|
if not (target_dir / name).exists():
|
||||||
|
return name
|
||||||
|
stem, ext = Path(name).stem, Path(name).suffix
|
||||||
|
prefix = NUM_SUFFIX_RE.sub("", stem)
|
||||||
|
max_num = 0
|
||||||
|
for f in target_dir.iterdir():
|
||||||
|
m = re.fullmatch(re.escape(prefix) + r"-(\d+)", f.stem)
|
||||||
|
if m and f.suffix.lower() == ext.lower():
|
||||||
|
max_num = max(max_num, int(m.group(1)))
|
||||||
|
n = max_num + 1
|
||||||
|
while (target_dir / f"{prefix}-{n}{ext}").exists():
|
||||||
|
n += 1
|
||||||
|
return f"{prefix}-{n}{ext}"
|
||||||
|
|
||||||
|
|
||||||
|
def dispatch(repo, files):
|
||||||
|
moved = []
|
||||||
|
for folder, items in files.items():
|
||||||
|
if not items:
|
||||||
|
continue
|
||||||
|
target = repo / folder
|
||||||
|
for f in items:
|
||||||
|
new_name = available_name(target, f.name)
|
||||||
|
if new_name != f.name:
|
||||||
|
log(f" 重名处理：{folder}/{f.name} -> {new_name}")
|
||||||
|
shutil.move(str(f), str(target / new_name))
|
||||||
|
moved.append(f"{folder}/{new_name}")
|
||||||
|
return moved
|
||||||
|
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------- 4. icons.json
|
||||||
|
|
||||||
|
def build_icons_json(repo):
|
||||||
|
"""全量重建 icons.json，逻辑与历史脚本一致（含跨目录重名加后缀的去重行为）。"""
|
||||||
|
icons, used = [], set()
|
||||||
|
counts = {"radius": 0, "circle": 0, "svg": 0}
|
||||||
|
for folder in FOLDERS:
|
||||||
|
d = repo / folder
|
||||||
|
if not d.is_dir():
|
||||||
|
warn(f"文件夹不存在，跳过：{folder}")
|
||||||
|
continue
|
||||||
|
for file in sorted(d.iterdir()):
|
||||||
|
if not (file.is_file() and file.suffix.lower() in IMAGE_EXTS):
|
||||||
|
continue
|
||||||
|
name = file.stem
|
||||||
|
original = name
|
||||||
|
url = f"{RAW_BASE}/{folder}/{file.name}"
|
||||||
|
counter = 1
|
||||||
|
while name in used:
|
||||||
|
name = f"{original}-{counter}"
|
||||||
|
counter += 1
|
||||||
|
used.add(name)
|
||||||
|
icons.append({"name": name, "url": url})
|
||||||
|
counts[{"border-radius": "radius", "circle": "circle", "svg": "svg"}[folder]] += 1
|
||||||
|
|
||||||
|
update_at = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
|
||||||
|
data = {
|
||||||
|
"name": "小迪的HD-Icons",
|
||||||
|
"description": (f"当前数量：{len(icons)}，更新于：{update_at}。"
|
||||||
|
"不定期更新，有需求欢迎提交：github.com/xushier/HD-Icons"),
|
||||||
|
"total_count": len(icons),
|
||||||
|
"update_at": update_at,
|
||||||
|
"icons": icons,
|
||||||
|
}
|
||||||
|
(repo / "icons.json").write_text(
|
||||||
|
json.dumps(data, ensure_ascii=False, indent=4) + "\n", encoding="utf-8")
|
||||||
|
counts["total"] = len(icons)
|
||||||
|
return counts
|
||||||
|
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------- 5. README 标记
|
||||||
|
|
||||||
|
def update_readme(repo, counts):
|
||||||
|
readme = repo / "README.md"
|
||||||
|
if not readme.is_file():
|
||||||
|
warn("README.md 不存在，跳过数量更新")
|
||||||
|
return
|
||||||
|
text = readme.read_text(encoding="utf-8")
|
||||||
|
|
||||||
|
def repl(m):
|
||||||
|
key = m.group(2)
|
||||||
|
if key in counts:
|
||||||
|
return m.group(1) + str(counts[key]) + m.group(4)
|
||||||
|
warn(f"README 中存在未知标记 ICONS:{key}")
|
||||||
|
return m.group(0)
|
||||||
|
|
||||||
|
readme.write_text(README_MARKER_RE.sub(repl, text), encoding="utf-8")
|
||||||
|
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------- 6. 预览图
|
||||||
|
|
||||||
|
def load_font(size):
|
||||||
|
from PIL import ImageFont
|
||||||
|
candidates = [
|
||||||
|
os.environ.get("HDICONS_FONT"),
|
||||||
|
str(Path(__file__).resolve().parent / "fonts" / "DejaVuSans.ttf"),
|
||||||
|
"/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf",
|
||||||
|
"C:/Windows/Fonts/segoeui.ttf",
|
||||||
|
"C:/Windows/Fonts/arial.ttf",
|
||||||
|
]
|
||||||
|
for c in candidates:
|
||||||
|
if c and Path(c).is_file():
|
||||||
|
try:
|
||||||
|
return ImageFont.truetype(c, size)
|
||||||
|
except OSError:
|
||||||
|
pass
|
||||||
|
warn("未找到可用字体，预览图将使用默认位图字体")
|
||||||
|
return ImageFont.load_default()
|
||||||
|
|
||||||
|
|
||||||
|
def rasterize_svg(svg_path, size, cache_dir):
|
||||||
|
"""把 SVG 光栅化为 PNG（依次尝试 rsvg-convert / resvg / cairosvg），失败返回 None。"""
|
||||||
|
out = cache_dir / (svg_path.stem + ".png")
|
||||||
|
if out.exists():
|
||||||
|
return out
|
||||||
|
cmds = []
|
||||||
|
if shutil.which("rsvg-convert"):
|
||||||
|
cmds.append(["rsvg-convert", "-w", str(size), "-h", str(size),
|
||||||
|
"-o", str(out), str(svg_path)])
|
||||||
|
if shutil.which("resvg"):
|
||||||
|
cmds.append(["resvg", "--width", str(size), "--height", str(size),
|
||||||
|
str(svg_path), str(out)])
|
||||||
|
for cmd in cmds:
|
||||||
|
try:
|
||||||
|
if subprocess.run(cmd, capture_output=True, timeout=60).returncode == 0 \
|
||||||
|
and out.exists():
|
||||||
|
return out
|
||||||
|
except (OSError, subprocess.TimeoutExpired):
|
||||||
|
pass
|
||||||
|
try:
|
||||||
|
import cairosvg
|
||||||
|
cairosvg.svg2png(url=str(svg_path), write_to=str(out),
|
||||||
|
output_width=size, output_height=size)
|
||||||
|
if out.exists():
|
||||||
|
return out
|
||||||
|
except Exception:
|
||||||
|
pass
|
||||||
|
return None
|
||||||
|
|
||||||
|
|
||||||
|
def merge_preview(repo, folder, out_name):
|
||||||
|
"""把目录内全部图标合并为一张带文件名标注的 JPEG 预览图。"""
|
||||||
|
from PIL import Image, ImageDraw
|
||||||
|
import textwrap
|
||||||
|
|
||||||
|
src = repo / folder
|
||||||
|
files = sorted(f for f in src.iterdir()
|
||||||
|
if f.is_file() and f.suffix.lower() in IMAGE_EXTS)
|
||||||
|
if not files:
|
||||||
|
warn(f"{folder}/ 为空，跳过预览图 {out_name}")
|
||||||
|
return
|
||||||
|
|
||||||
|
font = load_font(PREVIEW["text_size"])
|
||||||
|
cell_w = PREVIEW["icon"] + PREVIEW["gap_x"]
|
||||||
|
cell_h = PREVIEW["icon"] + PREVIEW["gap_y"]
|
||||||
|
rows = (len(files) + PREVIEW["cols"] - 1) // PREVIEW["cols"]
|
||||||
|
width = PREVIEW["cols"] * cell_w - PREVIEW["gap_x"] + 2 * PREVIEW["pad"]
|
||||||
|
height = rows * cell_h - PREVIEW["gap_y"] + 2 * PREVIEW["pad"]
|
||||||
|
|
||||||
|
sheet = Image.new("RGB", (width, height), PREVIEW["bg"])
|
||||||
|
draw = ImageDraw.Draw(sheet)
|
||||||
|
|
||||||
|
cache_dir = Path(tempfile.mkdtemp(prefix="hdicons_"))
|
||||||
|
skipped = 0
|
||||||
|
try:
|
||||||
|
for i, f in enumerate(files):
|
||||||
|
row, col = divmod(i, PREVIEW["cols"])
|
||||||
|
x = col * cell_w + PREVIEW["pad"]
|
||||||
|
y = row * cell_h + PREVIEW["pad"]
|
||||||
|
|
||||||
|
if f.suffix.lower() == ".svg":
|
||||||
|
raster = rasterize_svg(f, 512, cache_dir)
|
||||||
|
if raster is None:
|
||||||
|
skipped += 1
|
||||||
|
continue
|
||||||
|
f = raster
|
||||||
|
try:
|
||||||
|
icon = Image.open(f).convert("RGBA")
|
||||||
|
except OSError as e:
|
||||||
|
warn(f"无法读取 {f.name}：{e}")
|
||||||
|
skipped += 1
|
||||||
|
continue
|
||||||
|
icon = icon.resize((PREVIEW["icon"], PREVIEW["icon"]),
|
||||||
|
Image.Resampling.LANCZOS)
|
||||||
|
sheet.paste(icon, (x, y), icon)
|
||||||
|
|
||||||
|
wrapped = "\n".join(textwrap.wrap(f.stem, width=16))
|
||||||
|
bbox = draw.textbbox((0, 0), wrapped, font=font)
|
||||||
|
text_w = bbox[2] - bbox[0]
|
||||||
|
draw.text((x + (PREVIEW["icon"] - text_w) // 2,
|
||||||
|
y + PREVIEW["icon"] + 4),
|
||||||
|
wrapped, font=font, fill=PREVIEW["fg"])
|
||||||
|
finally:
|
||||||
|
shutil.rmtree(cache_dir, ignore_errors=True)
|
||||||
|
|
||||||
|
rendered = len(files) - skipped
|
||||||
|
if rendered < len(files):
|
||||||
|
# 预览图必须包含全部图标，有遗漏时不覆盖已有图片，避免生成残缺预览
|
||||||
|
warn(f"{folder} 有 {skipped} 个文件未能渲染（SVG 光栅化不可用或文件损坏），"
|
||||||
|
f"本次跳过写入 {out_name}，保留现有版本")
|
||||||
|
return
|
||||||
|
out_path = repo / out_name
|
||||||
|
sheet.save(out_path, format="JPEG", quality=78, dpi=(128, 128))
|
||||||
|
log(f" {out_name}: {len(files)} 个图标，{sheet.width}x{sheet.height}")
|
||||||
|
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------- 主流程
|
||||||
|
|
||||||
|
def main():
|
||||||
|
parser = argparse.ArgumentParser(description="HD-Icons 一键构建")
|
||||||
|
parser.add_argument("--repo", default=".", help="仓库根目录")
|
||||||
|
parser.add_argument("--skip-compress", action="store_true",
|
||||||
|
help="跳过 TinyPNG 压缩（仅调试用）")
|
||||||
|
args = parser.parse_args()
|
||||||
|
repo = Path(args.repo).resolve()
|
||||||
|
|
||||||
|
log("== 1/6 校验 inbox ==")
|
||||||
|
errors, warnings, inbox_files = validate_inbox(repo)
|
||||||
|
for w in warnings:
|
||||||
|
warn(w)
|
||||||
|
if errors:
|
||||||
|
for e in errors:
|
||||||
|
warn(e)
|
||||||
|
fail("inbox 存在问题，已中止（所有文件保持原样）")
|
||||||
|
|
||||||
|
png_count = len(inbox_files["border-radius"]) + len(inbox_files["circle"])
|
||||||
|
svg_count = len(inbox_files["svg"])
|
||||||
|
total_inbox = png_count + svg_count
|
||||||
|
log(f"inbox 共 {total_inbox} 个新文件（PNG {png_count}，SVG {svg_count}）")
|
||||||
|
|
||||||
|
if png_count and not args.skip_compress:
|
||||||
|
key = os.environ.get("TINYPNG_KEY", "").strip()
|
||||||
|
if not key:
|
||||||
|
fail("inbox 中有 PNG 但未设置 TINYPNG_KEY"
|
||||||
|
"（GitHub 上需在 Settings -> Secrets 中配置）")
|
||||||
|
log("== 2/6 TinyPNG 无损压缩 ==")
|
||||||
|
compress_inbox(inbox_files, key)
|
||||||
|
else:
|
||||||
|
log("== 2/6 跳过压缩（无 PNG 或指定 --skip-compress）==")
|
||||||
|
|
||||||
|
log("== 3/6 分发入库 ==")
|
||||||
|
moved = dispatch(repo, inbox_files)
|
||||||
|
for m in moved:
|
||||||
|
log(f" + {m}")
|
||||||
|
|
||||||
|
log("== 4/6 重建 icons.json ==")
|
||||||
|
counts = build_icons_json(repo)
|
||||||
|
log(f"总数 {counts['total']}（圆角矩形 {counts['radius']} / "
|
||||||
|
f"圆形 {counts['circle']} / SVG {counts['svg']}）")
|
||||||
|
|
||||||
|
log("== 5/6 更新 README 数量标记 ==")
|
||||||
|
update_readme(repo, counts)
|
||||||
|
|
||||||
|
log("== 6/6 生成预览图 ==")
|
||||||
|
merge_preview(repo, "border-radius", "_icons-radius.jpg")
|
||||||
|
merge_preview(repo, "circle", "_icons-circle.jpg")
|
||||||
|
merge_preview(repo, "svg", "_icons-svg.jpg")
|
||||||
|
|
||||||
|
gh_output = os.environ.get("GITHUB_OUTPUT")
|
||||||
|
if gh_output:
|
||||||
|
with open(gh_output, "a", encoding="utf-8") as f:
|
||||||
|
f.write(f"added={len(moved)}\n")
|
||||||
|
|
||||||
|
log(f"完成！本次新增 {len(moved)} 个图标。")
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
main()
|
||||||
Binary file not shown.
Reference in New Issue
Block a user