# CyberDoctor

**Repository Path**: cycle-studio/cyber-doctor

## Basic Information

- **Project Name**: CyberDoctor
- **Description**: 焊电路模拟器
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-08
- **Last Updated**: 2025-05-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 赛博焊接 - 芯片电路游戏

这是一个赛博朋克风格的芯片电路焊接游戏。玩家控制焊接枪在芯片表面上移动，连接各种电路节点以获取分数。

## 游戏规则

- 焊接枪（屏幕中心的圆点）会自动沿当前方向移动
- 使用**方向键左右**或**A/D键**控制焊接枪的方向（每次旋转90度）
- 触碰节点可获得分数：小节点15分，大节点5分
- 如果撞到屏幕边缘，游戏立即结束
- 如果焊接枪碰到自己之前走过的路径，游戏也会立即结束
- 游戏时间根据配置文件设定（默认60秒）
- 尽可能多地连接节点以获得高分！

## 特性

- 赛博朋克视觉风格
- 流畅的动画效果
- 电路连接视觉反馈
- 动态节点生成系统
- 计分和计时系统
- 可配置的游戏参数
- 响应式设计，适应不同屏幕尺寸
- 模块化代码结构

## 如何运行

### 开发环境

1. 克隆仓库到本地
   ```
   git clone https://github.com/your-username/cyber-soldering-game.git
   cd cyber-soldering-game
   ```

2. 使用本地服务器运行项目
   ```
   # 使用Python简易服务器
   python -m http.server
   
   # 或使用Node.js的http-server
   npx http-server
   ```

3. 在浏览器中访问 `http://localhost:8000` 或对应端口

### 生产环境

1. 在浏览器中直接打开`index.html`文件
2. 点击"开始游戏"按钮
3. 使用方向键左右或A/D键控制焊接枪

## 游戏配置

游戏参数可通过`constInfo.csv`配置文件进行修改：

- `gameTime`: 单局游戏时间（秒）
- `cursorSpeed`: 焊接枪移动速度

修改配置文件后，刷新游戏页面即可应用新设置。

## 项目结构

```
cyber-soldering-game/
├── index.html           # 主HTML文件
├── style.css            # 样式表
├── game.js              # 游戏主入口
├── constInfo.csv        # 游戏配置文件
├── modules/             # 游戏模块
│   ├── GameConfig.js    # 配置管理模块
│   ├── SolderingGun.js  # 焊接枪逻辑
│   ├── NodeManager.js   # 节点管理模块
│   ├── Renderer.js      # 渲染模块
│   └── UIManager.js     # UI管理模块
└── README.md            # 项目说明
```

## 技术栈

- JavaScript (ES6+)
- HTML5 Canvas
- CSS3
- 模块化开发（ES Modules）

## 未来优化建议

### 构建工具

为提高开发效率和代码质量，可考虑添加以下构建工具：

1. **Webpack/Rollup/Vite**: 打包和模块化管理
   ```
   npm install webpack webpack-cli --save-dev
   ```

2. **Babel**: 转译 ES6+ 代码以提高兼容性
   ```
   npm install @babel/core @babel/preset-env --save-dev
   ```

3. **ESLint**: 代码质量检查
   ```
   npm install eslint --save-dev
   ```

4. **Prettier**: 代码格式化
   ```
   npm install prettier --save-dev
   ```

### 资源优化

- 使用图像精灵（Sprite Sheets）减少请求
- 压缩CSS和JavaScript文件
- 使用WebP格式图像
- 实现资源懒加载

### 功能扩展

- 添加难度级别
- 增加特殊节点和障碍物
- 实现游戏成就系统
- 添加背景音乐和音效
- 增加多语言支持

## 贡献指南

欢迎贡献代码或提出改进建议！请遵循以下步骤：

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

## 许可证

本项目采用MIT许可证 - 详情见 [LICENSE](LICENSE) 文件