# HacknetOS

**Repository Path**: ngcb/HacknetOSng

## Basic Information

- **Project Name**: HacknetOS
- **Description**: No description available
- **Primary Language**: C++
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HacknetOS

基于 [Hacknet](https://hacknet-os.com) 的终端黑客模拟游戏，使用 Python 重写。

[English document](readme.md)

## ✨ 特性

- 复古终端风格的黑客模拟游戏
- 与真实 UN*X 极为相似的 Shell 环境和文件系统
- 每个破解工具都有独特的 ASCII 动画
- 完整的存读档系统
- 中英文国际化支持
- 跨平台 (Windows / macOS / Linux)

## ✈️ 快速开始

### 环境要求

- Python 3.10+
- pygame

### 安装运行

```bash
pip install pygame
cd hacknetos
python main.py
```

## 🎮 操作说明

| 按键 | 功能 |
|------|------|
| 输入 + 回车 | 执行命令 |
| ↑ / ↓ | 菜单导航 / 命令历史 |
| Tab | 自动补全命令 |
| ESC | 暂停菜单 (存档 / 读档 / 退出) |

## 📁 项目结构

```
hacknetos/
├── main.py              # 入口 & 游戏主循环
├── app.py               # 应用核心
├── terminal.py           # 终端会话 & 命令处理
├── renderer.py           # pygame 终端渲染器
├── menu.py               # 主菜单 & 暂停菜单
├── filesystem.py         # 虚拟文件系统
├── server.py             # 服务器节点
├── email.py              # 邮件系统
├── command.py            # 命令定义
├── i18n.py               # 国际化
├── save.py               # 存读档
├── mission.py            # 任务检查服务
├── world_loader.py       # 游戏世界 JSON 加载
├── starter.py            # 默认世界生成
├── bg_task_manager.py    # 后台任务管理
├── bg_tasks/             # 后台任务 (破解动画等)
├── ascii_art.py          # ASCII 艺术加载
├── data/                 # 游戏世界数据
└── ASCII/                # ASCII 艺术文件
```

## 🪧 游戏命令

| 命令 | 说明 |
|------|------|
| `help` | 显示命令列表 |
| `connect [IP]` | 连接到服务器 |
| `dc` | 断开连接 |
| `scan` | 扫描关联节点 |
| `nmap` | 扫描目标安全状态 |
| `ls` | 列出文件 |
| `cd [目录]` | 切换目录 |
| `cat [文件]` | 查看文件内容 |
| `rm [文件]` | 删除文件 |
| `mv [源] [目标]` | 移动文件 |
| `scp [源] [目标]` | 跨服务器复制文件 |
| `PortHack` | 端口破解 |
| `SSHCrack` / `FTPBounce` / `HTTPCrack` / `SMTPCrack` | 服务破解 |
| `ps` | 查看运行中任务 |
| `kill [PID]` | 终止任务 |
| `mailbox` | 打开邮箱 |
| `netmap` | 网络拓扑图 |
| `save [文件]` / `load [文件]` | 存读档 |
| `clear` | 清屏 |

## ❤ 如何贡献

欢迎提交 Bug 报告、功能建议和 Pull Request。修改代码前请先 fork 并创建功能分支。

## 特别感谢

剧本和创意来自: [Hacknet](https://hacknet-os.com)

如果你喜欢这类游戏, 一定要去试试原版!

## Copyright

Copyright 2022 EdgeNeko  
Licensed under GPLv3 license.