电子工具箱 (Electronics Toolkit)

电子工具箱 (Electronics Toolkit) 是一款专为电子工程师、学生和爱好者设计的专业网页应用。它集成了常用的电子电路计算工具，提供直观的图形化界面、实时计算功能以及交互式图表。

🔗 在线演示: 点击这里访问 GitHub Pages 部署版本

---

🛠️ 功能模块 (Features)

本项目包含以下核心计算模块：

1. 🔌 串联与并联电路计算 (Series & Parallel Circuit)

基础的电阻网络分析工具。

• 串联模式: 计算总电阻、总电流，以及每个电阻的分压 (Voltage Drop) 和功率。
• 并联模式: 计算总电阻、总电流，以及每个电阻的分流 (Current Flow) 和功率。
• 特点:
  • 支持动态添加/删除电阻。
  • 支持切换电源输入类型（已知总电压 或 已知总电流）。
  • 提供直观的柱状图可视化，展示电压/电流分布。
  • 支持 kΩ, MΩ 等单位切换。

2. 🎨 色环电阻计算器 (Resistor Color Code)

交互式的电阻色环识别工具。

• 支持模式: 4 环电阻 (常用) 和 5 环电阻 (精密)。
• 可视化: 逼真的电阻 SVG 渲染，颜色随选择实时变化。
• 智能过滤: 自动屏蔽无效的色环组合（例如第一环不能为黑色）。
• 结果: 自动格式化阻值并显示误差范围。

3. ➗ 电阻分压计算器 (Voltage Divider)

基于欧姆定律的分压电路设计工具。

• 双向计算: 输入任意 3 个参数 (Vin, R1, R2, Vout)，自动计算第 4 个未知参数。
• 场景:
  • 已知电阻求输出电压。
  • 已知目标电压反推电阻阻值。
• 图示: 清晰的电路拓扑图，标明 Vout 采样点。

4. 💡 LED 限流电阻计算器 (LED Resistor)

帮助您安全点亮 LED。

• 预设: 内置常用 LED (红、绿、蓝、白、黄) 的典型压降值。
• 计算: 根据电源电压和 LED 电流，计算所需的串联电阻值及功率。
• 提示: 计算结果包含电阻功率建议，防止电阻过热烧毁。

5. 📦 欧姆定律计算器 (Ohm's Law)

电子学的核心公式计算。

• 全能计算: 输入 电压(V)、电流(I)、电阻(R)、功率(P) 中的任意两个，自动计算其余两个。
• 高亮显示: 自动高亮显示计算得出的数值，方便区分已知量和未知量。

6. 🌊 RC 滤波器与延时 (RC Filter & Time Constant)

包含两个子功能：

• 滤波器 (Filter): 计算 RC 低通电路的截止频率 ($f_c$) 和时间常数 ($\tau$)。支持已知频率反推电阻或电容。
• 延时/充放电 (Delay):
  • 计算电容充电到特定电压所需的时间。
  • 生成可视化的电容充电曲线图 ($V_c$ vs Time)。
  • 计算 $1\tau$ 到 $5\tau$ 的关键节点。

7. 🔋 电池寿命计算器 (Battery Life)

估算电池供电设备的续航时间。

• 参数: 输入电池容量 (mAh) 和设备平均功耗 (mA)。
• 转换效率: 可调节放电效率系数 (默认 0.85)，模拟真实世界的能量损耗、温度影响及电池老化情况。
• 结果: 输出“天/小时/分钟”格式的预估时间。

---

💻 本地开发 (Development)

本项目使用 Vite 构建。

环境要求

• Node.js (版本 18+ 推荐)
• npm

安装步骤

1. 克隆仓库：

   git clone https://github.com/your-username/electronics-toolkit.git
   cd electronics-toolkit

2. 安装依赖：

   npm install

3. 启动开发服务器：

   npm run dev

   打开浏览器访问显示的的本地链接 (通常是 http://localhost:5173)。

构建与部署

构建生产版本：

npm run build

构建产物将生成在 dist 目录下。

---

🚀 部署 (Deployment)

本项目已配置 GitHub Actions 自动部署流程。

1. 确保您的 GitHub 仓库设置中，Settings -> Pages 的 Source 设置为 GitHub Actions。
2. 每次推送到 main 或 master 分支时，.github/workflows/deploy.yml 会自动运行：
   • 安装依赖
   • 执行构建
   • 将 dist 文件夹部署到 GitHub Pages

---

🤝 贡献 (Contributing)

欢迎提交 Issue 或 Pull Request 来改进这个工具箱！

1. Fork 本仓库
2. 创建您的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

---

📄 许可证 (License)

Distributed under the MIT License. See LICENSE for more information.

Copyright © 2025 movecall. All Rights Reserved.

Made with ❤️ by movecall