chore: 更新公告

This commit is contained in:
sansan 2025-12-09 13:07:58 +08:00
parent 2c5ae229b3
commit e4d609b389
2 changed files with 100 additions and 73 deletions

View File

@ -1,27 +1,7 @@
> ## ⚠️ Important Announcement (December 2025)
>
> Due to rapid growth in forks, GitHub has contacted me about server infrastructure strain. **This project and all forks may experience access difficulties.**
>
> - ✅ **Recommended**: [Docker Deployment](#6-docker-deployment) (data stored locally, no restrictions)
> - ❌ **Suspended**: Fork deployment, GitHub Actions, GitHub Pages
>
> <details>
> <summary>👉 Click for details</summary>
>
> **Issue Explanation:**
> - Original design used GitHub Actions to periodically fetch news and save to the repository, essentially using GitHub as a "cloud database"
> - With many forks running simultaneously, servers couldn't handle the load; GitHub engineering team is working on fixes
>
> **Future Plans:**
> - Exploring new approach: keep Actions for fetching and notifications, but no longer save data to repository, use external storage instead
>
> Thanks for understanding! Feedback: [Issues](https://github.com/sansan0/TrendRadar/issues)
>
> </details>
<div align="center" id="trendradar">
> **📢 Announcement:** After communicating with GitHub officials, "One-Click Fork Deployment" will be restored after compliance adjustments are completed. Please stay tuned for **v4.0.0** update
<a href="https://github.com/sansan0/TrendRadar" title="TrendRadar">
<img src="/_image/banner.webp" alt="TrendRadar Banner" width="80%">
</a>
@ -63,34 +43,67 @@
</div>
> This project is designed to be lightweight and easy to deploy
<details>
<summary>⚠️ Click to expand: <strong>Fork Guide: Docs, Resource Limits & Deployment Options</strong></summary>
<br>
**📄 Documentation Version:**
<details>
<summary>🚨 <strong>【MUST READ】Important Announcement: The Correct Way to Deploy This Project</strong></summary>
If you use this project via **Fork**, you might be viewing outdated documentation. Fork copies the documentation version at that time, but the original project may have been updated.
<br>
**👉 [Click to View Latest Official Documentation](https://github.com/sansan0/TrendRadar?tab=readme-ov-file)**
> **⚠️ December 2025 Urgent Notice**
>
> Due to a surge in Fork numbers causing excessive load on GitHub servers, **GitHub Actions and GitHub Pages deployments are currently restricted**. Please read the following instructions carefully to ensure successful deployment.
**How to Tell?** Check the repository address at the top of the page:
- `github.com/your-username/TrendRadar` ← Your forked version
- `github.com/sansan0/TrendRadar` ← Latest official version
### 1. ✅ Only Recommended Deployment Method: Docker
**This is currently the most stable solution, free from GitHub restrictions.** Data is stored locally and won't be affected by GitHub policy changes.
* 👉 [Jump to Docker Deployment Tutorial](#6-docker-deployment)
---
**🛡️ Resource Limits & Safety Tips:**
### 2. If You Were Planning to Fork This Project...
GitHub provides limited Actions resources per account. To avoid being flagged for abuse and risking account suspension:
To reduce pressure on GitHub servers, **please DO NOT directly click the "Fork" button!**
- **Platform Count**: Keep it around **10 platforms** — more platforms consume more resources
- **Run Frequency**: Minimum interval of **30 minutes** — more frequent runs are unnecessary
- **Fair Use**: GitHub Actions is designed for lightweight scheduled tasks, not high-frequency crawlers
Please use the **"Use this template"** feature instead of Fork:
💡 **Want more freedom?** Try [🐳 Docker Deployment](#6-docker-deployment) on your own server with no restrictions.
1. **Click** the green **[Use this template]** button in the top right corner of the original repository page.
2. **Select** "Create a new repository".
**Why do this?**
* **❌ Fork**: Copies complete history records. Many forks running simultaneously will trigger GitHub risk control.
* **✅ Use this template**: Creates a completely new independent repository without historical baggage, more server-friendly.
---
### 3. About New Data Storage
The new version will use **Cloudflare R2** to store news data, ensuring data persistence.
**⚠️ Configuration Prerequisites:**
According to Cloudflare platform rules, activating R2 requires binding a payment method.
- **Purpose:** Identity verification only (Verify Only), no charges will be incurred.
- **Payment:** Supports credit cards or PayPal (China region).
- **Usage:** R2's free tier is sufficient to cover this project's daily operation, no payment required.
---
### 4. 📅 Future Plans & Documentation Reading Notes
> **Future Plans:**
> - Exploring new approach: keep Actions for fetching and pushing, but no longer save data to repository, use external storage instead.
**⚠️ Reading Note:**
Given that the above plans mean **Fork deployment mode may return in a new form in the future**, and the workload to fully revise documentation is massive, we have temporarily retained the old descriptions.
**At the current stage, if "Fork" related expressions still appear in subsequent tutorials, please ignore them or understand them as "Use this template"**.
👉 **[Click here to view TrendRadar's latest official documentation](https://github.com/sansan0/TrendRadar?tab=readme-ov-file)**
</details>

View File

@ -1,27 +1,7 @@
> ## ⚠️ 重要公告2025年12月
>
> 由于 Fork 数量激增GitHub 官方已联系我,当前运行方式对服务器造成压力。**本项目及所有 Fork 可能出现访问困难。**
>
> - ✅ **推荐**[Docker 部署](#6-docker-部署)(数据存本地,不受限制)
> - ❌ **暂停**Fork 部署、GitHub Actions、GitHub Pages
>
> <details>
> <summary>👉 点击查看详情</summary>
>
> **问题说明:**
> - 原设计通过 GitHub Actions 定时抓取新闻并保存到仓库,相当于把 GitHub 当"云端数据库"
> - 大量 Fork 同时运行服务器承受不住GitHub 工程团队正在修复
>
> **后续计划:**
> - 探索新方案:保留 Actions 用于抓取和推送,但不再将数据保存到仓库,改用外部存储
>
> 感谢理解!问题反馈:[Issues](https://github.com/sansan0/TrendRadar/issues) 或公众号
>
> </details>
<div align="center" id="trendradar">
> **📢 公告:** 经与 GitHub 官方沟通,完成合规调整后将恢复"一键 Fork 部署",请关注 **v4.0.0** 版本的更新
<a href="https://github.com/sansan0/TrendRadar" title="TrendRadar">
<img src="/_image/banner.webp" alt="TrendRadar Banner" width="80%">
</a>
@ -65,31 +45,65 @@
> 本项目以轻量,易部署为目标
<details>
<summary>⚠️ 点击展开:<strong>Fork 须知:文档更新、资源限制与部署建议</strong></summary>
<br>
**📄 文档版本说明:**
<details>
<summary>🚨 <strong>【必读】重要公告:本项目的正确部署姿势</strong></summary>
如果你是通过 **Fork** 使用本项目,你看到的可能是旧版文档。因为 Fork 时会复制当时的文档版本,但原项目可能已更新。
<br>
**👉 [点击查看最新官方文档](https://github.com/sansan0/TrendRadar?tab=readme-ov-file)**
> **⚠️ 2025年12月紧急通知**
>
> 由于 Fork 数量激增导致 GitHub 服务器压力过大,**GitHub Actions 及 GitHub Pages 部署目前已受限**。为确保顺利部署,请务必阅读以下说明。
**如何判断?** 看页面顶部的仓库地址:
- `github.com/你的用户名/TrendRadar` ← 你 fork 的版本
- `github.com/sansan0/TrendRadar` ← 最新官方版本
### 1. ✅ 唯一推荐部署方式Docker
**这是目前最稳定、不受 GitHub 限制的方案。** 数据存储在本地,不会因为 GitHub 策略调整而失效。
* 👉 [跳转到 Docker 部署教程](#6-docker-部署)
---
**🛡️ 资源限制与安全提示:**
### 2. 如果你本打算 Fork 本项目...
GitHub 为每个账号提供的 Actions 资源是有限额的。为了避免被官方判定为滥用而面临封号风险,请注意:
为了减少对 GitHub 服务器的压力,**请千万不要直接点击 "Fork" 按钮!**
- **监控平台数量**:建议控制在 **10 个左右**,过多平台会消耗更多资源
- **执行频率**:建议最短间隔为 **30 分钟**,过于频繁无实际意义
- **合理使用**GitHub Actions 适合轻量级定时任务,而非高频爬虫
请务必使用 **"Use this template"** 功能来替代 Fork
💡 **想要更自由地使用?** 推荐 [🐳 Docker 部署](#6-docker-部署),在自己的服务器上运行。
1. **点击**原仓库页面右上角的绿色的 **[Use this template]** 按钮。
2. **选择** "Create a new repository"。
**为什么要这样做?**
* **❌ Fork**:复制完整历史记录,大量 Fork 同时运行会触发 GitHub 风控。
* **✅ Use this template**:创建的是一个全新的独立仓库,没有历史包袱,对服务器更友好。
---
### 3. 关于新版数据存储的说明
新版将使用 **Cloudflare R2** 存储新闻数据,以保证持久化。
**⚠️ 配置前置条件:**
根据 Cloudflare 平台规则,开通 R2 需绑定支付方式。
- **目的:** 仅作身份验证Verify Only不产生扣费。
- **支付:** 支持信用卡或国区 PayPal。
- **用量:** R2 的免费额度足以覆盖本项目日常运行,无需付费。
---
### 4. 📅 后续计划与文档阅读说明
> **后续计划:**
> - 探索新方案:保留 Actions 用于抓取和推送,但不再将数据保存到仓库,改用外部存储。
**⚠️ 阅读注意:**
鉴于上述计划意味着 **Fork 部署模式未来可能会以新形式回归**,且当前全面修改文档工作量巨大,我们暂时保留了旧版描述。
**在当前阶段,若后续教程中仍出现 "Fork" 相关表述,请一律忽略或将其理解为 "Use this template"**。
👉 **[点击此处查看 TrendRadar 最新官方文档](https://github.com/sansan0/TrendRadar?tab=readme-ov-file)**
</details>