diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 85ff995d..e207c27c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,7 +1,9 @@ -# 向 SecRandom 贡献代码 +# 贡献指南 ❤️感谢您向 SecRandom 做出贡献，您可以为 SecRandom 项目做出包括但不限于反馈 Bug、提出功能请求、贡献代码等贡献。在进行贡献前，请务必阅读以下指南。 +**语言选择** [ **✔简体中文** | [English](resources/CONTRIBUTING_EN.md) | [繁體中文](resources/CONTRIBUTING_ZH_TW.md) ] + ## 反馈 Bug 如果在使用 SecRandom 的过程中遇到 Bug，可以在 GitHub Issues 中提交 Bug 反馈。 @@ -24,7 +26,7 @@ |------|-----------|------| | 编程语言 | Python 3.13.5 | 项目的主要开发语言 | | 包管理器 | uv | 依赖管理和虚拟环境创建 | -| UI 框架 | PySide6 + Fluent Design | 现代化桌面应用界面开发 | +| UI 框架 | PySide6 + PyQt-Fluent-Widgets | 现代化桌面应用界面开发 | | 日志管理 | loguru | 高效的日志记录 | | 数据处理 | numpy & pandas | 数据处理和分析 | | 语音合成 | edge-tts | 文本转语音功能 | @@ -48,12 +50,14 @@ - 点击右上角的 "Fork" 按钮，创建您自己的仓库副本 2. **克隆仓库** + ```bash git clone https://github.com/您的用户名/SecRandom.git cd SecRandom ``` 3. **添加上游仓库** + ```bash git remote add upstream https://github.com/SECTL/SecRandom.git ``` @@ -137,14 +141,6 @@ SecRandom 项目使用 GitHub Actions 进行自动构建和发布，配置文件 - 在 commit 消息中包含 `开始打包` 关键词 - 示例：`git commit -m "新增功能 开始打包"` -## 📞 联系方式 - -如果您在贡献过程中遇到任何问题或需要帮助，可以通过以下方式联系我们： - -- 🔗 GitHub Issues：[提交问题](https://github.com/SECTL/SecRandom/issues) -- 💬 QQ 群：833875216 -- 📧 邮箱：lzy.12@foxmail.com - --- 感谢您对 SecRandom 项目的支持和贡献！让我们一起打造更好的公平随机抽取系统！ 🚀 diff --git a/README.md b/README.md index 2acaa0f8..4b43b003 100644 --- a/README.md +++ b/README.md @@ -42,9 +42,7 @@ - [🎯 为什么选择公平抽取](#-为什么选择公平抽取) - [🌟 核心亮点](#-核心亮点) -- [🛠️ 技术栈](#%EF%B8%8F-技术栈) - [📥 下载](#-下载) -- [🚀 快速开始](#-快速开始) - [📸 软件截图](#-软件截图) - [🙏 贡献者](#-贡献者和特别感谢) - [💝 捐献支持](#-捐献支持) @@ -104,10 +102,14 @@
📸 软件截图展示 ✨ -![点名界面](./resources/ScreenShots/主界面_抽人_浅色.png) -![抽奖界面](./resources/ScreenShots/主界面_抽奖_浅色.png) -![历史记录](./resources/ScreenShots/主界面_抽人历史记录_浅色.png) -![设置界面](./resources/ScreenShots/设置_抽人设置_浅色.png) +
+ +点名界面
点名界面
+抽奖界面
抽奖界面
+历史记录
历史记录
+抽取设置
抽取设置
+ +
@@ -162,9 +164,7 @@ 查看我们的贡献指南来了解更多内容： -- [简体中文](./CONTRIBUTING.md) -- [English](./resources/CONTRIBUTING_EN.md) -- [繁體中文](./resources/CONTRIBUTING_ZH_TW.md) +- [简体中文贡献指南](./CONTRIBUTING.md) ## ✨ Star历程 diff --git a/resources/CONTRIBUTING_EN.md b/resources/CONTRIBUTING_EN.md index 0084c481..fc37d5b1 100644 --- a/resources/CONTRIBUTING_EN.md +++ b/resources/CONTRIBUTING_EN.md @@ -1,7 +1,11 @@ -# Contributing to SecRandom +# Contributing Guidelines ❤️ Thank you for contributing to SecRandom! You can contribute to the SecRandom project in various ways, including but not limited to reporting bugs, submitting feature requests, and contributing code. Please read the following guidelines before contributing. +**Language** [ [简体中文](../CONTRIBUTING.md) | **✔English** | [繁體中文](./CONTRIBUTING_ZH_TW.md) ] + +> The Readme you are currently reading is **translated by AI** and reviewed by our developers. If you find any errors, please report it. + ## Reporting Bugs If you encounter a bug while using SecRandom, you can report it in GitHub Issues. @@ -24,7 +28,7 @@ Understanding the project's technology stack will help you get started faster: |----------|----------------|---------| | Programming Language | Python 3.13.5 | Main development language of the project | | Package Manager | uv | Dependency management and virtual environment creation | -| UI Framework | PySide6 + Fluent Design | Modern desktop application interface development | +| UI Framework | PySide6 + PyQt-Fluent-Widgets | Modern desktop application interface development | | Log Management | loguru | Efficient logging | | Data Processing | numpy & pandas | Data processing and analysis | | Text-to-Speech | edge-tts | Text-to-speech functionality | @@ -48,12 +52,14 @@ Ensure your system has the following software installed: - Click the "Fork" button in the upper right corner to create your own copy of the repository 2. **Clone the Repository** + ```bash git clone https://github.com/your-username/SecRandom.git cd SecRandom ``` 3. **Add Upstream Repository** + ```bash git remote add upstream https://github.com/SECTL/SecRandom.git ``` @@ -134,16 +140,8 @@ The SecRandom project uses GitHub Actions for automated building and publishing, You can trigger builds in the following ways: 1. **Commit Message Trigger**: - - Include the keyword `開始打包` (Start Packaging) in the commit message - - Example: `git commit -m "Add new feature 開始打包"` - -## 📞 Contact Information - -If you encounter any issues or need help during the contribution process, you can contact us through the following channels: - -- 🔗 GitHub Issues: [Submit an Issue](https://github.com/SECTL/SecRandom/issues) -- 💬 QQ Group: 833875216 -- 📧 Email: lzy.12@foxmail.com + - Include the keyword `开始打包` (Start Packaging) in the commit message + - Example: `git commit -m "Add new feature 开始打包"` --- diff --git a/resources/CONTRIBUTING_ZH_TW.md b/resources/CONTRIBUTING_ZH_TW.md index 4b8be4a3..1b341cbe 100644 --- a/resources/CONTRIBUTING_ZH_TW.md +++ b/resources/CONTRIBUTING_ZH_TW.md @@ -1,7 +1,11 @@ -# 向 SecRandom 貢獻代碼 +# 貢獻指南 ❤️感謝您向 SecRandom 做出貢獻，您可以為 SecRandom 專案做出包括但不限於反饋 Bug、提出功能請求、貢獻代碼等貢獻。在進行貢獻前，請務必閱讀以下指南。 +**語言選擇** [ [简体中文](../CONTRIBUTING.md) | [English](./CONTRIBUTING_EN.md) | **✔繁體中文** ] + +> 本 Readme **由 AI 翻譯**，並由我們的開發人員審核。如果您發現任何錯誤，請向我們報告。 + ## 反饋 Bug 如果在使用 SecRandom 的過程中遇到 Bug，可以在 GitHub Issues 中提交 Bug 反饋。 @@ -24,7 +28,7 @@ |------|-----------|------| | 程式設計語言 | Python 3.13.5 | 專案的主要開發語言 | | 包管理器 | uv | 依賴管理和虛擬環境建立 | -| UI 框架 | PySide6 + Fluent Design | 現代化桌面應用介面開發 | +| UI 框架 | PySide6 + PyQt-Fluent-Widgets | 現代化桌面應用介面開發 | | 日誌管理 | loguru | 高效的日誌記錄 | | 數據處理 | numpy & pandas | 數據處理和分析 | | 語音合成 | edge-tts | 文本轉語音功能 | @@ -48,12 +52,14 @@ - 點擊右上角的 "Fork" 按鈕，建立您自己的倉庫副本 2. **克隆倉庫** + ```bash git clone https://github.com/您的使用者名/SecRandom.git cd SecRandom ``` 3. **添加上游倉庫** + ```bash git remote add upstream https://github.com/SECTL/SecRandom.git ``` @@ -134,16 +140,8 @@ SecRandom 專案使用 GitHub Actions 進行自動構建和發布，配置文件 您可以通過以下方式觸發構建： 1. **提交消息觸發**： - - 在 commit 消息中包含 `開始打包` 關鍵詞 - - 示例：`git commit -m "新增功能 開始打包"` - -## 📞 聯繫方式 - -如果您在貢獻過程中遇到任何問題或需要幫助，可以通過以下方式聯繫我們： - -- 🔗 GitHub Issues：[提交問題](https://github.com/SECTL/SecRandom/issues) -- 💬 QQ 群：833875216 -- 📧 郵箱：lzy.12@foxmail.com + - 在 commit 消息中包含 `开始打包` 關鍵詞 + - 示例：`git commit -m "新增功能 开始打包"` --- diff --git a/resources/README_EN.md b/resources/README_EN.md index 7d9910b6..7548512d 100644 --- a/resources/README_EN.md +++ b/resources/README_EN.md @@ -22,7 +22,7 @@ [![bilibili](https://img.shields.io/badge/-Bilibili%7C%E9%BB%8E%E6%B3%BD%E6%87%BF-%23FB7299?style=for-the-badge&logo=bilibili)](https://space.bilibili.com/520571577) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg?style=for-the-badge)](https://opensource.org/licenses/GPL-3.0) -[简体中文](../README.md) | **✔English** | [繁體中文](./README_ZH_TW.md) +**Language** [ [简体中文](../README.md) | **✔English** | [繁體中文](./README_ZH_TW.md) ]
@@ -47,9 +47,7 @@ - [🎯 Why Choose Fair Selection](#-why-choose-fair-selection) - [🌟 Core Features](#-core-features) -- [🛠️ Technology Stack](#%EF%B8%8F-technology-stack) - [📥 Download](#-download) -- [🚀 Quick Start](#-quick-start) - [📸 Software Screenshots](#-software-screenshots) - [🙏 Contributors and Special Thanks](#-contributors-and-special-thanks) - [💝 Support Us](#-support-us) @@ -109,11 +107,14 @@ Traditional random selection often has the problem of "repeatedly selecting cert
📸 Software Screenshots Display ✨ -![Selection Interface](./ScreenShots/主界面_抽人_浅色.png) -![Lottery Interface](./ScreenShots/主界面_抽奖_浅色.png) -![History Records](./ScreenShots/主界面_抽人历史记录_浅色.png) -![Settings Interface](./ScreenShots/设置_抽人设置_浅色.png) +
+ +Pick Interface
Pick Interface
+Lottery Interface
Lottery Interface
+History Records
History Records
+Pick Settings
Pick Settings
+
## 🙏 Contributors and Special Thanks @@ -166,8 +167,6 @@ If you find SecRandom helpful, you're welcome to support our development work! Check out our Contributing Guidelines to learn more: - [English Contributing Guidelines](./CONTRIBUTING_EN.md) -- [简体中文 Contributing Guidelines](../CONTRIBUTING.md) -- [繁體中文 Contributing Guidelines](./CONTRIBUTING_ZH_TW.md) ## ✨ Star History diff --git a/resources/README_ZH_TW.md b/resources/README_ZH_TW.md index 1171fe35..28a55e1a 100644 --- a/resources/README_ZH_TW.md +++ b/resources/README_ZH_TW.md @@ -22,7 +22,7 @@ [![bilibili](https://img.shields.io/badge/-UP%E4%B8%BB%EF%BD%9C黎泽懿-%23FB7299?style=for-the-badge&logo=bilibili)](https://space.bilibili.com/520571577) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg?style=for-the-badge)](https://opensource.org/licenses/GPL-3.0) -[简体中文](../README.md) | [English](./README_EN.md) | **✔繁體中文** +**語言選擇** [ [简体中文](../README.md) | [English](./README_EN.md) | **✔繁體中文** ] ![Code Contribution Statistics](https://repobeats.axiom.co/api/embed/7d42538bcd781370672c00b6b6ecd5282802ee3d.svg "Code Contribution Statistics Chart") @@ -34,7 +34,7 @@ > > GNU GPLv3 具有 Copyleft 特性，這意味著您可以修改 SecRandom 的原始碼，但**必須也以 GNU GPLv3 許可證開源修改後的版本** --------- -> [!note] +> [!NOTE] > > **SecRandom v2** 將會在 2026/01/01 (GMT +8:00 中國標準時間) 左右 發布！ > @@ -44,9 +44,7 @@ - [🎯 為何選擇公平選擇](#-為何選擇公平選擇) - [🌟 核心亮點](#-核心亮點) -- [🛠️ 技術棧](#%EF%B8%8F-技術棧) - [📥 下載](#-下載) -- [🚀 快速開始](#-快速開始) - [📸 軟體截圖](#-軟體截圖) - [🙏 貢獻者與特別感謝](#-貢獻者與特別感謝) - [💝 支持我們](#-支持我們) @@ -106,11 +104,17 @@
📸 軟體截圖展示 ✨ -![點名介面](./ScreenShots/主界面_抽人_浅色.png) -![抽獎介面](./ScreenShots/主界面_抽奖_浅色.png) -![歷史記錄](./ScreenShots/主界面_抽人历史记录_浅色.png) -![設定介面](./ScreenShots/设置_抽人设置_浅色.png) +> [!WARNING] +> 目前SecRandom暫不支援繁體中文，您所看到的界面以簡體中文顯示。 + +
+點名界面
點名界面
+抽獎界面
抽獎界面
+歷史記錄
歷史記錄
+抽取設置
抽取設置
+ +
## 🙏 貢獻者與特別感謝 @@ -162,8 +166,6 @@ 查看我們的貢獻指南了解更多資訊： -- [简体中文貢獻指南](../CONTRIBUTING.md) -- [English貢獻指南](./CONTRIBUTING_EN.md) - [繁體中文貢獻指南](./CONTRIBUTING_ZH_TW.md) ## ✨ Star 歷程 diff --git a/resources/ScreenShots/en_us/history.png b/resources/ScreenShots/en_us/history.png new file mode 100644 index 00000000..d3795335 Binary files /dev/null and b/resources/ScreenShots/en_us/history.png differ diff --git a/resources/ScreenShots/en_us/lottery.png b/resources/ScreenShots/en_us/lottery.png new file mode 100644 index 00000000..26169f73 Binary files /dev/null and b/resources/ScreenShots/en_us/lottery.png differ diff --git a/resources/ScreenShots/en_us/pick.png b/resources/ScreenShots/en_us/pick.png new file mode 100644 index 00000000..09254841 Binary files /dev/null and b/resources/ScreenShots/en_us/pick.png differ diff --git a/resources/ScreenShots/en_us/pick_settings.png b/resources/ScreenShots/en_us/pick_settings.png new file mode 100644 index 00000000..2b1c9a5c Binary files /dev/null and b/resources/ScreenShots/en_us/pick_settings.png differ diff --git a/resources/ScreenShots/zh-cn/history.png b/resources/ScreenShots/zh-cn/history.png new file mode 100644 index 00000000..37074a41 Binary files /dev/null and b/resources/ScreenShots/zh-cn/history.png differ diff --git a/resources/ScreenShots/zh-cn/lottery.png b/resources/ScreenShots/zh-cn/lottery.png new file mode 100644 index 00000000..593e620a Binary files /dev/null and b/resources/ScreenShots/zh-cn/lottery.png differ diff --git a/resources/ScreenShots/zh-cn/pick.png b/resources/ScreenShots/zh-cn/pick.png new file mode 100644 index 00000000..3eb7b445 Binary files /dev/null and b/resources/ScreenShots/zh-cn/pick.png differ diff --git a/resources/ScreenShots/zh-cn/pick_settings.png b/resources/ScreenShots/zh-cn/pick_settings.png new file mode 100644 index 00000000..92a71aa0 Binary files /dev/null and b/resources/ScreenShots/zh-cn/pick_settings.png differ diff --git "a/resources/ScreenShots/\344\270\273\347\225\214\351\235\242_\346\212\275\344\272\272_\346\265\205\350\211\262.png" "b/resources/ScreenShots/\344\270\273\347\225\214\351\235\242_\346\212\275\344\272\272_\346\265\205\350\211\262.png" deleted file mode 100644 index e1f8fdc1..00000000 Binary files "a/resources/ScreenShots/\344\270\273\347\225\214\351\235\242_\346\212\275\344\272\272_\346\265\205\350\211\262.png" and /dev/null differ diff --git "a/resources/ScreenShots/\344\270\273\347\225\214\351\235\242_\346\212\275\344\272\272\345\216\206\345\217\262\350\256\260\345\275\225_\346\265\205\350\211\262.png" "b/resources/ScreenShots/\344\270\273\347\225\214\351\235\242_\346\212\275\344\272\272\345\216\206\345\217\262\350\256\260\345\275\225_\346\265\205\350\211\262.png" deleted file mode 100644 index dcddbd21..00000000 Binary files "a/resources/ScreenShots/\344\270\273\347\225\214\351\235\242_\346\212\275\344\272\272\345\216\206\345\217\262\350\256\260\345\275\225_\346\265\205\350\211\262.png" and /dev/null differ diff --git "a/resources/ScreenShots/\344\270\273\347\225\214\351\235\242_\346\212\275\345\245\226_\346\265\205\350\211\262.png" "b/resources/ScreenShots/\344\270\273\347\225\214\351\235\242_\346\212\275\345\245\226_\346\265\205\350\211\262.png" deleted file mode 100644 index 441908b5..00000000 Binary files "a/resources/ScreenShots/\344\270\273\347\225\214\351\235\242_\346\212\275\345\245\226_\346\265\205\350\211\262.png" and /dev/null differ diff --git "a/resources/ScreenShots/\350\256\276\347\275\256_\346\212\275\344\272\272\350\256\276\347\275\256_\346\265\205\350\211\262.png" "b/resources/ScreenShots/\350\256\276\347\275\256_\346\212\275\344\272\272\350\256\276\347\275\256_\346\265\205\350\211\262.png" deleted file mode 100644 index 23376f7e..00000000 Binary files "a/resources/ScreenShots/\350\256\276\347\275\256_\346\212\275\344\272\272\350\256\276\347\275\256_\346\265\205\350\211\262.png" and /dev/null differ