# BinaryViz

**Repository Path**: benechen/binary-viz

## Basic Information

- **Project Name**: BinaryViz
- **Description**: 《计算机组成原理》可视化学习平台
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-10
- **Last Updated**: 2026-05-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 计算机组成原理, 可视化, 布尔代数, 数据表示, 运算方法与运算器

## README

<h1 style="display: flex; align-items: center; justify-content: space-between; flex-wrap: wrap;">
  <span>BinaryViz — 二进制计算可视化学习平台</span>
  <img src="icon/GGA.png" width="120" height="120" style="flex-shrink: 0;">
</h1>
## 项目生成工具：

本项目 基于 GenericAgent 智能体生成。

### GenericAgent项目地址：
https://github.com/lsdefine/GenericAgent

本项目灵感来自图码：https://www.totuma.cn/en

## 项目介绍：
> 计算机组成原理 · 交互式动画教学工具

BinaryViz 是基于 **FastAPI** 的交互式动画学习平台，专注于计算机组成原理中二进制计算与数据表示的**可视化呈现**。
将二进制运算过程拆解为**位级微步骤动画**，帮助学习者直观理解底层计算原理。

---

## 🚀 使用 uv 快速启动

```bash
# 安装 uv（如未安装）
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# 配置环境并启动
cd D:\00synchronize\binary-viz
uv sync
uvicorn main:app --host 0.0.0.0 --port 8000
```

打开 http://localhost:8000

## 使用 pip 启动

```bash
cd D:\00synchronize\binary-viz
python -m venv .venv
.venv\Scripts\activate
pip install fastapi uvicorn
uvicorn main:app --host 0.0.0.0 --port 8000
```

---

## 📦 模块一览

| 分类 | 子模块 |
|------|--------|
| 🔌 布尔代数与逻辑电路 | 基本逻辑门、行波进位加法器、卡诺图化简、多路选择器 |
| 📊 数据表示 | 原码/反码/补码、定点数、IEEE 754 浮点分解、ASCII/Unicode、BCD码、格雷码、差错检测 |
| 🧮 运算方法与运算器 | 整数加减法、整数乘除法、浮点运算 |

---

## 🛠️ 技术栈

- **后端**: FastAPI + Uvicorn
- **前端**: 原生 HTML/CSS/JS，Canvas 2D 渲染
- **字体**: Space Grotesk（标题）+ JetBrains Mono（代码）
- **主题**: 亮/暗模式，WCAG AA 对比度合规
- **动画**: requestAnimationFrame 状态机引擎

---

## 📄 License

MIT