# SDD-calc_v2

**Repository Path**: bitpg/sdd-calc_v2

## Basic Information

- **Project Name**: SDD-calc_v2
- **Description**: 使用SDD开发范式，实现计算器-v2。仓库中包含了本次开发中完整的propmt和对话
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-23
- **Last Updated**: 2026-06-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 计算器

基于 raylib + C 的 Windows 桌面计算器，支持加、减、乘、除四则运算。

## 功能

- 加、减、乘、除四则运算
- 鼠标点击按钮输入
- 键盘快捷键（数字键、+、-、*、/、Enter、Backspace、Esc）
- 双行显示：上行表达式、下行结果
- 小数输入（每个操作数唯一小数点）
- 正负号切换（±）
- 全部清除 (C)、清除当前 (CE)、退格 (←)
- 结果四舍五入保留两位小数
- 除零错误弹窗提示
- 连续运算支持

## 构建

### 环境要求

- Windows
- [w64devkit](https://github.com/skeeto/w64devkit) 或 MinGW-w64（GCC）
- [raylib](https://www.raylib.com/) 5.5

### 编译

```sh
cd build
make
```

编译产物为 `build/calculator.exe`。

### 运行单元测试

```sh
cd build
make test
```

## 使用

### 鼠标操作

点击界面上的按钮进行输入。

### 键盘快捷键

| 按键 | 操作 |
|------|------|
| `0`-`9` | 数字输入 |
| `.` | 小数点 |
| `+` | 加法 |
| `-` | 减法 |
| `*` | 乘法 |
| `/` | 除法 |
| `Enter` | 计算结果 |
| `Backspace` | 退格 |
| `Escape` / `Delete` | 全部清除 |

### 交互流程

1. 输入第一个数字
2. 选择运算符
3. 输入第二个数字
4. 按 `=`（或 Enter）计算结果
5. 可继续选择新运算符进行连续运算

## 项目结构

```
├── build/
│   └── Makefile        # 构建脚本
├── src/
│   ├── main.c          # 入口，主循环，鼠标/键盘事件分发
│   ├── calc.h / calc.c # 计算引擎（四则运算、四舍五入、输入缓冲区）
│   ├── ui.h / ui.c     # 界面绘制（显示区、按钮网格、错误弹窗）
│   ├── input.h / input.c # 交互状态机（5 状态流转）
│   └── test_calc.c     # 单元测试
├── spec.md             # 需求规格说明书
├── plan.md             # 执行规划
├── tasks.md            # 任务清单
└── prompt.md           # 开发全程提示词记录
```

## 许可

MIT