Debatium-tool - 专业辩论赛计时工具

商业前请获得许可谢谢！ 虽然是ai辅助开发 但是作者在电脑前消耗了12+12小时，两个周六

• 欢迎fork🔱 & star⭐⭐⭐⭐⭐

项目简介

Debatium-tool 是一个基于 Zerlight/Debatium 的再制作版本，专为辩论赛设计的计时工具。

项目截图

• 项目地址：leebro7/Debatium-tool

部署

🚀 部署方式

📌 在线体验

• Codespaces 在线体验（live-server）

---

🌍 正式版部署

部署平台	按钮
Netlify 部署
Vercel 部署
Cloudflare Workers 部署
Fleek 部署
4EVERLAND 部署
Railway 部署
Render 部署
Koyeb 部署

Nginx部署

1. 将项目文件复制到Nginx静态文件目录

# 克隆项目
git clone https://github.com/leebro7/Debatium-tool.git
# 复制到Nginx目录
sudo cp -r Debatium-tool/* /var/www/html/

2. Nginx配置示例

server {
    listen 80;
    server_name your-domain.com;  # 替换为您的域名

    root /var/www/html;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    # 启用gzip压缩
    gzip on;
    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
}

3. 重启Nginx

sudo nginx -t  # 检查配置
sudo systemctl restart nginx  # 重启Nginx

---

🔍 预览版部署

部署平台	按钮
Netlify 预览部署
Vercel 预览部署
Cloudflare Workers 预览部署
Fleek 预览部署
4EVERLAND 预览部署
Railway 预览部署
Render 预览部署
Koyeb 预览部署

---

📥 下载发布版本

主要特性

🎨 界面优化

• 左右分栏布局（宽屏）
• 动态背景效果
• 环节提示系统
• 结束动画特效

⏱️ 计时规则

• 立论/质询环节（30s）
  • 仅剩5秒短鸣提示 (ding.wav)
• 小结环节
  • 30秒长鸣 (ding3.mp3)
  • 5秒短鸣 (ding.wav)
• 自由辩论
  • 30秒长鸣 (ding3.mp3)
  • 5秒短鸣 (ding.wav)

💡 快捷键与触控屏特殊优化

快捷键可以自定义

• PageDown: 继续/跳过
• PageUp: 结束自由辩论
• P: 暂停计时
• B: 手动响铃

同时我们提供了 点击按钮的方式 因为作者亲身感受触控屏进行班级辩论赛的不便 所以作者提供了 点击按钮的方式 来代替 快捷键

branch

• main 主分支 稳定版
• preview 预览分支 不稳定版

快速开始

1. 克隆仓库

git clone https://github.com/leebro7/Debatium-tool.git

1. 直接打开 index.html 请部署服务端！

项目结构

Debatium-tool/
├── css/
│   ├── main.css              # 主样式文件
│   └── jQuery.countdownTimer.css
├── js/
│   ├── main.js              # 主逻辑文件
│   ├── setting.js           # 设置相关
│   └── jquery-3.6.0.min.js
├── pages/
│   ├── home.html           # 主页面
│   ├── counter.html        # 计时器页面
│   └── spare.html          # 准备页面
├── assets/
│   ├── ding.wav           # 短提示音
│   └── ding3.mp3          # 长提示音
└── index.html             # 入口文件

配置与开始

• 打开 index.html 文件
• 按照提示填写所需配置
• 点击开始按钮，开始辩论

特色功能

🎯 精准计时

• 专业级计时精度
• 多种提示音效
• 自定义计时规则

🔔 智能提醒

• 环节切换自动提示
• 剩余时间语音播报
• 关键时间点铃声提醒

💻 多平台支持

• 触控屏优化设计
• 响应式界面布局
• 键盘快捷键支持

⚙️ 高度可定制

• 自定义提示音效
• 可配置计时规则

更新日志

v1.2.0

点击展开

• Fix:
  • 修复class: timer-warning timer-crucial无法正常显示问题
  • 时间显示删除小时单位
• Change:
  • 优化了UI
  • 进度条更新300ms
  • 优化了注释
• Unknown:
  • 由于多次暂停 导致时间倍数问题 疑似修复 待测试 未复现

v1.2.1

点击展开

- Fix - v1.2.0 Unknown 已经被修复 - Change - 统一时间精度MM:ss.SS - 立论陈词环节改为35s默认 - Add - 时间前进、回滚、以及时间重置功能 - feature - 增加结算和统计界面 - css优化（主要是virtual-key） - setting.html尚未配置新增的快捷键

v1.2.2

点击展开

- Add v1.2.1 快捷键添加 重复快捷键提示弹窗 css 优化 - Feature 增加快捷键配置界面 提供更详细的统计数据展示 - Fix 因为选择重复快捷键引发的问题，限制每个功能仅有一个快捷键

v1.2.3

点击展开

- Add README.md 添加了一键部署链接（Netlify、Vercel、Cloudflare Workers 等）和 Codespaces 预览链接 package.json action:自动release > 本版本无实际更新，仅包含文档更新或CI/CD流程改进

v1.2.5

点击展开

Add 统计界面 环节回滚 action:minimize main.js Fix: 时间重置改变有效时间，已修订

---

致谢

• 原项目作者：Zerlight/Debatium
• 开发者：Leebro
• AI 助手：GitHub Copilot、v0.dev
• IDE: Visual Studio Code、Trae
• 部署 vercel netify 等

许可证

本项目基于 GPL-3.0 License 许可证开源。

欢迎贡献代码、报告问题或提出改进建议。请遵循项目的代码风格和提交指南。 邮箱EMAIL:lcyz14@proton.me

Star History

© 2025 Leebro. All rights reserved.