Gwergilius/Enclave-Terminal-Breach

# Enclave Terminal Breach **English** | [Magyar] [][releases] [![License-MIT-badge]][License-MIT] [![.NET-badge]][Dotnet] [][quality-gate-status-url] [][coverage-url] 多平台 Fallout 终端破解助手 - 从 SPARROW 原型到 ECHELON 部署的完整演进。 ## 🎮 这是什么？ 一款**终端破解助手**应用程序，旨在帮助解决 Bethesda 的《辐射》系列游戏（Fallout 3、Fallout: New Vegas、Fallout 4 和 Fallout 76）中的终端破解迷你游戏。 **重要提示：** 这并非该迷你游戏本身的重制版。而是一个外部辅助工具，用于分析密码模式并建议最佳猜测。 ## 🚀 项目状态 **当前阶段：** 📝 文档与规划 | 组件 | 状态 | |-----------|--------| | 文档 | 🚧 进行中 | | 架构 | 🚧 进行中 | | SPARROW (DOS PoC) | 🚧 进行中 | | RAVEN (Console) | 📋 已计划 | | GHOST (Web/Blazor) | 📋 已计划 | | ECHELON (MAUI Mobile) | 📋 已计划 | ## 📚 项目演进 本仓库记录了完整的开发演进过程： 1. **Excel Prototype** (Pre-SPARROW) - 使用 VBA 宏的研究阶段 2. **SPARROW** - DOS 3.11 概念验证 3. **RAVEN** - 具有屏幕定位功能的控制台应用程序 4. **GHOST** - Web/SIGNET 部署 5. **ECHELON** - 移动端 Pip-Boy 版本 每个阶段都代表了一个重要的架构里程碑，最终达成 ECHELON v2.1.7 部署。 ## 🏗️ 技术栈 - **.NET 10.0** - 主要框架 - **C# 12.0** - 编程语言 - **MAUI** - 跨平台移动 UI - **Blazor** - 渐进式 Web 应用 - **xUnit** - 单元测试 - **ReqNRoll** - 集成/E2E 测试 - **Playwright** - UI 测试 ## 📖 文档 - [Project History] - 完整的 ECHELON 背景故事（即将推出） - [Algorithm] - 密码排除算法（即将推出） - [Architecture] - 系统设计文档（即将推出） - [Coding Standards] - 开发指南（即将推出） ## 📁 源代码 文件夹结构在 **[src/README][src README]** 中描述（平台：**dotnet**、excel-prototype；未来：python、typescript）。.NET 解决案位于 **src/dotnet/** 下。从 `src/dotnet/Enclave.Echelon.slnx` 打开解决方案，并从 **src/dotnet/** 运行构建： ``` cd src/dotnet dotnet build Enclave.Echelon.slnx ``` 关于**代码覆盖率**和质量，请参阅 [tools/coverage/README](tools/coverage/README.md)。覆盖率徽章由 [SonarCloud](https://sonarcloud.io) 提供（对公开仓库免费）；在 SonarCloud 上添加项目后设置 `SONAR_TOKEN` 密钥。 ## 🔄 CI / Pipeline GitHub Actions (`.github/workflows/ci.yml`)： - **Push**（任何分支）：构建、单元测试和覆盖率运行；**失败不会阻断**（你可以推送未完成的工作并仍查看结果）。在 main 分支上，当测试通过时，GitVersion 输出版本号。 - **Pull request**（至 main/master）：构建、单元测试和覆盖率是**阻断性**的；如果构建/测试失败，或行覆盖率低于 80% 或分支覆盖率低于 95%，运行将**失败**。 ### 从提交 / PR 消息生成版本 版本升级由功能分支上的**提交消息**以及合并时的 **PR 标题/描述**驱动。在 `GitVersion.yml` 中配置。**不允许直接提交到 main**（例如 Changelog 更新等除外）。 | 上下文 | 默认值 | 触发条件 | 示例 | |--------|--------|---------|--------| | **Commit**（在功能分支上） | 仅构建号 (`0.1.0+5` → `+6`) | 主题中包含 `patch(scope):` | `patch(fix): correct validation` → 补丁升级 | | **PR merge** (Squash and merge) | **Minor**（新功能） | 主题以 `feat:` 或 `feat(scope):` 开头 | `feat: add Password model` → 次版本升级 | | **PR merge** | **Major**（破坏性） | 主题包含 `breaking-change:` 或 `BREAKING CHANGE:` | `breaking-change: remove API` → 主版本升级 | | **PR merge** | **Patch**（仅修复） | 主题以 `patch:` 或 `patch(scope):` 开头 | `patch: fix typo` → 补丁升级 | 对 PR 使用 **Squash and merge**，以便 PR 标题成为合并提交消息，GitVersion 可以应用上述规则。 ## 🤝 贡献 这是一个个人作品集项目，但欢迎反馈和建议！请参阅 [.cursor/rules/][Coding Standards] 中的编码标准以获取贡献指南。 ## 📜 许可证 本项目采用 MIT 许可证授权 - 详情请参阅 [LICENSE] 文件。 ## 🎯 致谢 - [Bethesda Game Studios][Bethesda] 提供 Fallout 系列 - [Fallout community][Fallout Wiki] 提供灵感 - [RobCo Industries][RobCo]（虚构）提供我们要攻破的 UOS - [Hackinal][hackinal] 和 [Jetholt Hacking][jetholt-hacking] 提供基于浏览器的迷你游戏以测试算法 ## 关于开发者 **Gwergilius (Gergely Tóth)** 热衷于 Fallout 背景故事和软件架构的跨平台 .NET 开发者。 本项目展示了： - 跨平台开发（Console、Blazor、MAUI） - MVVM 架构 - 背景故事驱动的设计（虚构追随功能） - PHOSPHOR 抽象层（灵感来自虚构技术） *"我在 Vault-Tec 存储设施中发现了 Krane 博士的笔记。事实证明 PHOSPHOR 不仅仅是虚构——它是优秀的软件架构。所以我构建了它。"* ## 联系方式 - GitHub: [@gwergilius][Gwergilius-Github] - LinkedIn: [Gwergilius][Gwergilius-LinkedIn] **免责声明：** 这是一个粉丝项目，与 Bethesda Softworks 或 Bethesda Game Studios 无关。

标签：Bethesda, Blazor, C# 12, DNS解析, DOS, DOS头擦除, Fallout, MAUI, .NET 10, PWA, 单词消除, 多人体追踪, 密码破解, 小游戏助手, 开源项目, 控制台应用, 游戏辅助, 特征检测, 算法优化, 终端黑客, 解密工具, 辐射游戏, 逻辑推理