blairmichaelg/sudo-rug

[](LICENSE) [](https://www.python.org/) [](https://textual.textualize.io/) [](https://rich.readthedocs.io/) ``` _ _ | | | | | | _ _ __| | ___ _ __ _ _ __ _ | | | | | | / _` | / _ \ | '__| | | | | / _` | |_| | |_| | | (_| || (_) | | | | |_| || (_| | (_) \__,_| \__,_| \___/ |_| \__,_| \__, | __/ | liquidate.exe |___/ ``` # sudo-rug ## 这是什么？ sudo-rug 是一款完全在终端中运行的单人 roguelite 游戏。你将扮演一名虚构的链上黑暗森林中的匿名操作者——这是一个充斥着 meme 代币、掠夺性机器人、浅薄审计和偏执 OpSec 的世界。 你开局身无分文，只有一个钱包、一小笔初始资金，以及访问模拟 DEX 的权限。你可以部署代币、注入流动性池、雇佣机器人来拉高交易量、进行市场交易，并决定是踏踏实实做项目还是卷款跑路。这个世界按照区块节拍运行。市场在波动。热度在积累。调查员在逼近。 这款游戏不是黑客模拟器，也不是一个玩笑。它是一款愤世嫉俗、基于技术逻辑的模拟游戏，展现了链上黑暗森林的真实运作方式——剥离至最核心的机制，使其具备可玩性，并作为终端应用发布。这里没有真实的区块链。没有真实的资金。一切都是模拟的。 目标：在你的热度达到 100 之前，使净资产达到 50,000 美元。简单的前提。黑暗的执行。 ## 功能特性 ### ✅ 已实现（阶段 1 — 当前） - **终端 shell** — 具备自定义解析器、帮助系统和命令历史的完整命令行界面 - **区块时钟** — 基于区块节拍（每个约 2 秒）推进的异步世界模拟；机器人与市场活动并发运行 - **钱包系统** — 单个钱包实时追踪 USD 及所有已部署代币的余额 - **代币部署** — 使用自定义代码和供应量部署 meme 代币 - **恒定乘积 AMM** — 真实的 `x * y = k` 数学模型，真实的滑点，真实的手续费捕获（0.3%） - **流动性池** — 注入池子，与之交易，观察价格影响的发生 - **机器人系统** — 消耗预算雇佣机器人，使其在 N 个区块内执行真实的 AMM 交易以拉升价格 - **热度系统** — 每次操作都会增加热度；热度随区块衰减；一旦越过阈值，世界就会注意到你 - **OpSec 修正值** — 降低所有操作的有效热度增加值 - **状态面板** — 实时侧边栏，显示资金、持仓、池子价格、热度条、OpSec 评级和活动机器人 - **滚动事件日志** — 展示区块事件、机器人交易、市场波动和警报的拟真终端信息流 - **胜负条件** — 达到资金目标即可获胜；让热度达到 100 则游戏结束 ### 🔜 计划中（里程碑 2+） - 保存 / 加载游戏状态 - 更丰富的机器人 AI（卖方机器人、MEV 机器人、套利者） - 热度事件（调查、千钧一发、贿赂机会） - OpSec 升级物品（VPN、混币器、一次性钱包） - 审计系统（花钱进行浅层审计，降低热度并解锁信誉） - 命令历史 + Tab 补全 - 多个同步运行的市场 - 阶段 2：协议部署、借贷市场、TVL 挖矿 - 阶段 3：内存池可见性、漏洞利用、治理攻击、闪电贷 - 场景包：灵感来自 DAO 被黑事件、Ronin、Mango、Terra、FTX 式的崩溃 ## 演示 ``` ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ ▓ ▓ ▓ liquidate.exe v0.1 ▓ ▓ sudo_rug terminal interface ▓ ▓ ▓ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Block #0 | Capital: $1,000.00 | Heat: 0.0 > deploy meme --ticker REKT --supply 1000000 ✓ Deployed REKT — supply: 1,000,000 Heat +4.8 > pool create --token REKT --base-amount 500 --token-amount 500000 ✓ Pool REKT/USD created Initial price: $0.001000 | Heat +1.9 > bots run --budget 200 --duration 10 ✓ Bots deployed on REKT/USD Budget: $200.00 over 10 blocks (~$20.00/block) Heat +2.9 # 11 bot: bought 18,432.10 on REKT/USD for $20.00 (price: $0.001094) # 12 bot: bought 16,891.44 on REKT/USD for $20.00 (price: $0.001197) # 13 ⚠ Whispers on CT. Someone noticed your wallet activity. > liquidity pull --market REKT/USD ☠ RUG EXECUTED on REKT/USD Recovered: $684.32 USD + 423,184 tokens Heat +28.5 ⚠ ``` *[完整截图 / 录制即将推出 — 欢迎贡献]* ## 设置与安装 ### 环境要求 - Python 3.11 或更高版本 - 支持 ANSI 颜色的终端（Windows Terminal、iTerm2、任何现代 Linux 终端） ### 安装 ``` # Clone repo git clone https://github.com/blairmichaelg/sudo-rug.git cd sudo-rug # 创建 virtual environment（推荐） python -m venv .venv # Activate # Windows: .\.venv\Scripts\Activate.ps1 # macOS / Linux: source .venv/bin/activate # 安装 package 和 dependencies pip install -e . ``` ### 运行 ``` sudo-rug ``` 或者直接运行： ``` python -m sudo_rug ``` ## 命令参考 | 命令 | 语法 | 描述 | |---------|--------|-------------| | `help` | `help` 或 `help ` | 显示所有命令或某一命令的详细帮助 | | `status` | `status` | 显示游戏状态：资金、持仓、热度、OpSec、池子、机器人 | | `wallet` | `wallet` | 显示所有货币的钱包余额 | | `deploy meme` | `deploy meme --ticker --supply ` | 向你的钱包部署一个新的 meme 代币 | | `pool create` | `pool create --token --base-amount --token-amount ` | 注入一个 TICKER/USD AMM 池 | | `trade buy` | `trade buy --market /USD --amount ` | 使用 USD 购买代币 | | `trade sell` | `trade sell --market /USD --amount ` | 卖出代币换取 USD | | `bots run` | `bots run --budget --duration ` | 雇佣机器人在 N 个区块内产生交易量 | | `liquidity pull` | `liquidity pull --market /USD` | 撤出池中的所有流动性（卷款跑路） | | `wait` | `wait --blocks ` | 推进 N 个区块；机器人执行交易，热度衰减 | | `logs` | `logs` | 显示最近 20 条事件日志 | | `quit` | `quit` | 退出游戏 | ### 热度参考 每次操作都会增加你的热度等级（0–100）。一旦达到 100，调查员就会追踪到你的钱包。游戏结束。 | 操作 | 基础热度增加值 | |--------|----------------| | 部署代币 | +5 | | 创建池子 | +2 | | 交易 | +1 | | 运行机器人 | +3 | | 撤出流动性（跑路） | +30 | | 每个区块（衰减） | −0.5 | 热度增益会根据你的 OpSec 评级进行折减：`effective_heat = base * (1.0 - opsec * 0.5)` ## 阶段路线图 ### 阶段 1 — 混混 *(当前)* 你是匿名的、身无分文的，只能艰难求生。部署 meme 代币，注入池子，用机器人拉升价格，进行交易，然后决定是踏实建设还是卷款跑路。在热度达到 100 之前达到 5 万美元。这个世界对你的生死漠不关心。 ### 阶段 2 — 架构师 *(计划中)* 你拥有了资金和信誉。部署借贷协议、收益金库、合成资产。管理 TVL。吸引追逐收益的用户。治理现在成为一种武器。你可以审计其他协议——或者利用它们的漏洞。 ### 阶段 3 — 掠食者 *(计划中)* 你获得了对内存池的访问权限。你能在交易落地前看到它们。闪电贷、预言机操纵、治理接管和协同利用漏洞都成为可能。黑暗森林在猎杀你，你也在猎杀他人。受真实协议失败案例启发的事件：DAO、Ronin、Mango、Terra、Curve、FTX。 ### 本地设置 ``` git clone https://github.com/blairmichaelg/sudo-rug.git cd sudo-rug python -m venv .venv && source .venv/bin/activate # or Activate.ps1 on Windows pip install -e ".[dev]" python -m pytest tests/ -v ``` ### PR 指南 - 保持 PR 焦点集中。每个 PR 只做一项改动。 - 提交前运行测试。不要破坏测试套件。 - 如果你正在添加新命令，请在 `tests/test_commands.py` 中为其添加测试。 - 杜绝框架无序扩张。保持模块小型化，并降低抽象数量。 ## 免责声明 **sudo-rug 是一款虚构的模拟游戏。** 未连接任何真实区块链。不存在任何真实代币。没有任何真实资金的往来。所有的市场、价格、机器人和事件完全是模拟的。与任何真实协议、漏洞利用或事件的相似之处仅出于游戏设计目的，不构成对任何现实世界活动的认可或指导。 ## 许可证 [MIT](LICENSE) © 2026 Michael Blair

标签：CLI游戏, Deploy Tokens, DEX, Hunt Exploits, Meme代币, Python, Rich, Roguelite游戏, Textual, TUI, Web3, 交易机器人, 代币部署, 加密经济, 加密货币, 区块链, 区块链模拟, 单人游戏, 命令行界面, 在线安全, 无后门, 智能合约, 暗黑森林, 流动性池, 游戏开发, 策略游戏, 管理热度, 终端UI, 终端游戏, 网络安全, 网络安全教育, 虚拟货币, 计算机取证, 误配置预防, 赛博朋克, 逆向工具, 隐私保护, 骗局模拟, 黑产, 黑客, 黑客文化, 黑客模拟