skilluno 1.12.1__py3-none-any.whl

skilluno-1.12.1.dist-info/METADATA

@@ -0,0 +1,291 @@
+Metadata-Version: 2.4
+Name: skilluno
+Version: 1.12.1
+Summary: 一个基于 Python 的 UNO 卡牌游戏框架
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.0
+Dynamic: license-file
+
+![Python Tests](https://github.com/zhuyiming0208/SkillUNO/actions/workflows/test.yml/badge.svg)
+![License](https://img.shields.io/badge/license-MIT-blue.svg)
+![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)
+
+# SkillUNO
+
+> 一个基于 Python 的 UNO 卡牌游戏框架，支持 Mod 化技能、赛季、成就、回放、热座模式、CLI 商店与网页版商店。
+
+*(部分代码由 AI 辅助生成)*
+
+---
+
+## 目录
+
+- [游戏截图](#游戏截图)
+- [特性](#特性)
+- [快速开始](#快速开始)
+- [使用方式](#使用方式)
+  - [交互式菜单](#交互式菜单)
+  - [CLI 子命令](#cli-子命令)
+- [模组系统](#模组系统)
+  - [安装社区模组](#安装社区模组)
+  - [制作自己的模组](#制作自己的模组)
+- [网页版商店](#网页版商店)
+- [项目结构](#项目结构)
+- [开发](#开发)
+- [兼容性](#兼容性)
+- [文档](#文档)
+- [许可证](#许可证)
+
+---
+
+## 游戏截图
+
+![游戏界面 1](https://cdn.jsdelivr.net/gh/zhuyiming0208/SkillUNO@main/docs/screenshots/gameplay1.jpg)
+
+![游戏界面 2](https://cdn.jsdelivr.net/gh/zhuyiming0208/SkillUNO@main/docs/screenshots/gameplay2.jpg)
+
+---
+
+## 特性
+
+| 特性 | 说明 |
+|---|---|
+| **事件驱动技能系统** | 技能通过订阅游戏事件（GAME_START / TURN_START / BEING_ADDED_CARDS 等）触发，支持自动与手动激活 |
+| **赛季系统** | 内置 S1 经典 / S2 被动觉醒 / S3 同盟 / S4 补丁 四个官方赛季，含 30+ 技能 |
+| **Mod 化扩展** | 支持社区作者发布自定义赛季与技能，通过 CLI 商店或网页商店安装 |
+| **成就系统** | 内置成就 + 隐藏成就，记录在存档中，跨局累计 |
+| **完整对局回放** | 每局可录制，支持交互式回放，逐事件查看 |
+| **热座模式** | 2~4 人本地轮流同屏操作 |
+| **统计面板** | 玩家胜率排行、技能使用次数、牌型频率、对局统计 |
+| **可选彩色 UI** | 基于 `rich` 库，未安装时自动降级为纯文本 |
+| **CLI 模组商店** | 交互式菜单 + 命令行子命令双入口 |
+| **网页版商店** | 深色终端风，支持浏览、搜索、查看详情、一键安装命令 |
+
+---
+
+## 快速开始
+
+### 方式一：可编辑安装（推荐）
+
+```bash
+git clone https://github.com/zhuyiming0208/SkillUNO.git
+cd SkillUNO
+pip install -e .
+skilluno
+```
+
+方式二：不安装，直接运行
+
+```bash
+git clone https://github.com/zhuyiming0208/SkillUNO.git
+cd SkillUNO
+PYTHONPATH=src python -m uno.main
+```
+
+方式三：Termux（Android）
+
+```bash
+pkg install python git
+git clone https://github.com/zhuyiming0208/SkillUNO.git
+cd SkillUNO
+pip install -e .
+skilluno
+```
+
+Termux 提示：软键盘没有方向键，商店内使用 u/d/l/r 代替上下左右，~ 代替 Esc。
+
+---
+
+使用方式
+
+交互式菜单
+
+```bash
+skilluno
+```
+
+进入主菜单：
+
+```
+SkillUNO vX.Y.Z
+1. 新游戏
+2. 回放录像
+3. 统计面板
+4. 模组商店
+0. 退出
+```
+
+· 新游戏：选择赛季组合、房间规则、是否录制
+· 回放：从 src/uno/records/ 里选择录像播放
+· 统计面板：读取存档与回放，显示胜率排行、技能使用、牌型频率
+· 模组商店：浏览、搜索、安装、卸载、启用/禁用模组（按 W 打开网页版）
+
+CLI 子命令
+
+```bash
+skilluno mod list                  # 列出全部模组
+skilluno mod search <关键词>        # 模糊搜索
+skilluno mod info <ID>             # 查看模组详情
+skilluno mod install <ID>          # 下载 + 验证 + 启用
+skilluno mod uninstall <ID>        # 卸载
+skilluno mod list-collections      # 列出模组集
+skilluno mod install-collection <ID>   # 一键安装模组集
+skilluno mod --help                # 查看帮助
+```
+
+---
+
+模组系统
+
+安装社区模组
+
+方式一：CLI 商店
+
+```bash
+skilluno
+# 选 4 进入商店
+# 按 S 搜索、Enter 查看详情、I 安装
+```
+
+方式二：命令行
+
+```bash
+skilluno mod install EXAMPLE
+```
+
+方式三：网页版商店
+
+访问 https://zhuyiming0208.github.io/SkillUNO/ ，复制安装命令。
+
+安全机制
+
+下载的模组经过多重验证：
+
+1. URL 白名单：只允许 raw.githubusercontent.com 和 cdn.jsdelivr.net
+2. 大小限制：单文件 ≤ 5MB
+3. 静态验证：用 ast.parse 解析 SEASON_ID，绝不 import 执行
+4. 隔离区：下载到 mods/_pending/，用户显式确认后才启用
+5. 备份：覆盖已安装模组前先备份 .bak
+
+制作自己的模组
+
+见 模组制作指南。
+
+---
+
+网页版商店
+
+网址：https://zhuyiming0208.github.io/SkillUNO/
+
+纯静态 HTML/CSS/JS，无构建依赖。包含：
+
+· 首页：官方模组 + 精选模组 + 模组集
+· 列表页：全部模组 + 搜索
+· 详情页：模组信息、依赖、权限声明、一键复制安装命令
+· 模组集：浏览和批量安装
+
+源码位于 web/ 目录。改完后：
+
+```bash
+cd web
+python -m http.server 8000
+# 浏览器访问 http://localhost:8000
+```
+
+---
+
+项目结构
+
+```
+SkillUNO/
+├── docs/                  项目文档
+│   ├── DEVELOPER_GUIDE.md
+│   ├── FAQ.md
+│   ├── VersionBriefHistory.md
+│   └── screenshots/
+├── mods/                  模组元数据
+│   ├── mod_idx.json       第三方模组索引
+│   ├── official.json      官方模组列表
+│   ├── S1~S4.json         官方赛季元数据
+│   ├── example.json       示例模组
+│   └── collections.json   模组集
+├── src/uno/               核心代码
+│   ├── core.py            游戏核心（牌、玩家、回合、事件）
+│   ├── season1~4.py       官方赛季技能
+│   ├── skills_uno.py      技能加载器
+│   ├── achievements.py    成就系统
+│   ├── archive.py         存档读写
+│   ├── replay.py          回放录制与播放
+│   ├── stats.py           统计面板
+│   ├── ui.py              UI 抽象（ConsoleUI / RichUI / NullUI）
+│   ├── mod_index.py       模组索引读取
+│   └── mod_store/         CLI 模组商店
+│       ├── menu.py / search.py / detail.py / history_view.py
+│       ├── downloader.py / validator.py
+│       ├── uninstaller.py / updater.py
+│       └── cli.py         命令行子命令
+├── tests/                 测试（700+ 用例）
+├── web/                   网页版商店
+├── tools/bump.py          版本号升级工具
+└── .github/workflows/     CI（测试 + 网页部署）
+```
+
+---
+
+开发
+
+运行测试
+
+```bash
+python -m pytest tests/ -v
+```
+
+带覆盖率：
+
+```bash
+python -m pytest tests/ --cov=src/uno --cov-report=term-missing
+```
+
+贡献
+
+欢迎提交 Issue 或 PR。添加新功能时请：
+
+1. 保持测试覆盖率
+2. 更新 docs/VersionBriefHistory.md
+3. 用 setver X.Y.Z 升级版本号
+
+版本号工具
+
+```bash
+setver 1.13.0 --new-entry "新功能说明"
+```
+
+（setver 是 tools/bump.py 的别名，需自行配置）
+
+---
+
+兼容性
+
+项 支持
+Python 3.10 / 3.11 / 3.12 / 3.14
+平台 Linux / macOS / Android (Termux) / Windows
+可选依赖 rich（彩色 UI）
+
+---
+
+文档
+
+· 开发者指南
+· FAQ
+· 从小白到高手
+· 版本历史
+· 模组制作
+
+---
+
+许可证
+
+MIT

skilluno-1.12.1.dist-info/RECORD

@@ -0,0 +1,46 @@
+skilluno-1.12.1.dist-info/licenses/LICENSE,sha256=fjj5026cQR7rwfl5vh4nFmllfGKsgtJt7eOUaB9J_TM,1070
+uno/__init__.py,sha256=bIfXiAO75WU_3FEyu_zf3qEikXKCMNxrs9XtUBx8noQ,31
+uno/achievements.py,sha256=IdySkCjVMK4EGaGMuLek-D2j7z5figwpxxZjtAQ03FY,3473
+uno/archive.py,sha256=uRPU5d-FAYKVZtRKnpsNguN8Kgtj85afSp06u1OX9VM,2177
+uno/combo_base.py,sha256=E4JhpGfbc7Qh5Dj_gvgp7-s_EgANTvw01BSR3tRMhMA,179
+uno/core.py,sha256=xxy-FcGnn0eAH4kQc7BOygnQfqGDFhe67Lvd4bZpp4k,36594
+uno/enabled.py,sha256=80FaUYYOO2wKdbgKXvNKhiLk0ejYfG6u1wiv7oiVS2c,1851
+uno/main.py,sha256=GSUNrW9vuTs79-Mcm_J3SSRpMqre5M1ywyTYkc2J7yY,4235
+uno/mod_index.py,sha256=XiCmc9hFukX39rkPiJs8R2pLLsLgfMcQXSCp3Xm0BAY,7452
+uno/paths.py,sha256=vuyX89G5lnAv1y_PJNDN-2W0KYrOmORr6In2zMkCb8w,333
+uno/presets.py,sha256=uv51GpZt5U0nj2BWbEEy4hpSJagA7jJO1eHihGfrtuE,1977
+uno/replay.py,sha256=lBNIkgniiL93HQ7a5lguALWKN0YPeD3wkYDs9OyxWm8,5402
+uno/season1.py,sha256=G9NkFNIcbAV6OXdnzyyc8b1XkT8qFLAW6dOPA5JrduY,22533
+uno/season2.py,sha256=FuaKebshGoU4M3w_ejIiKO_cLI44jzleUQ9RgcwmJGo,20092
+uno/season3.py,sha256=mi66k9iL7RR_6c3tdIkc1uzOCjsOsyPoDroiME3edhs,67
+uno/season4.py,sha256=rNzrJ4gHpwM27yDP8nIouq7DSYZ6a5M7N9G2sCR61ss,17979
+uno/skills_uno.py,sha256=BRyL7E-nMdLPjMTK9qecfPWgTCkQygzw3GHGpWLQs_s,6094
+uno/stats.py,sha256=RG9xE495pQwBMdNk72ZjmWJR2Vmme-f8O_VLKZOr65U,11164
+uno/ui.py,sha256=S-kF4uPglw1rDqDyW5jnwobpov7cV8GnSXMVoXUPQOI,2827
+uno/mod_store/__init__.py,sha256=q7V-HBTGugbrCdKQInXQzdreoUzMatL-uIB9_H853BI,112
+uno/mod_store/cli.py,sha256=lzdyop1uMPBPMIn70ZmLPCX6L23CrZZsR9qxIBYUu7s,12532
+uno/mod_store/collection_view.py,sha256=4UEAtTn-YbdShMyLzHb0smjV0nj65fEiTo_ss1Mk4Xo,2297
+uno/mod_store/collections.py,sha256=FBK6db3lyok6sA8_jV7YPsIAcRW7xVQxjjq275gNp1U,1376
+uno/mod_store/confirm.py,sha256=0B5YMUDvLW-_-_zhetdfyGQhm5djMgAkWNELfIyYZ40,5009
+uno/mod_store/context.py,sha256=kRFMH55IvugJnvYViRYht4no2yQP8x-dHYOjvbEn4M8,243
+uno/mod_store/detail.py,sha256=HWGcaLBpzauXnSmQCRSDXPHvkCx0FYiw5pw3NWSuM-o,5154
+uno/mod_store/downloader.py,sha256=odlGqQwcsRrAYL79rcmbNH1N4eorf08b_eKX3h_J-Dc,7649
+uno/mod_store/enable.py,sha256=rUeOBi1Uv2fpyR1C1lzyRwNXyJDtlvnzOI2Ev5WWui4,1883
+uno/mod_store/history.py,sha256=gRi9t46Y--ZB762yyw2vhCJgxGGDm08-9mbkBSR93vk,2968
+uno/mod_store/history_view.py,sha256=Y9OleHq3hWMg2p7A9sHjYu-1yIyvonb73GoSL94sHc0,3516
+uno/mod_store/input_handler.py,sha256=tWl5TGFDI0_GcoAcA4IGPwj4ZNnO6NzSTd9s2E2RxP8,5600
+uno/mod_store/main.py,sha256=Szu2AhVaDIh4e7Zwsetc57SIUmcKWQ3PR5qkVmy3Zn0,1828
+uno/mod_store/menu.py,sha256=G0qUFpsUjrgTeq--w3JVvCFBK049E1M71JWZEnoP6YY,8772
+uno/mod_store/render.py,sha256=vWX5q84rU-_LrCZ7GckcpbryKfg-fTNBMZ5AR9eZ49k,4137
+uno/mod_store/router.py,sha256=60iMDy-xMzT4JUggtMzuZTphxXTOJUlHzVgGUZJkzgU,13186
+uno/mod_store/search.py,sha256=Gsj9_GWjf-dnQkrWJjNInFO31jv83W6oN1D-4bzUSbg,4586
+uno/mod_store/uninstall_confirm.py,sha256=_o3cK-N350zFBBoUKp4duAt01OmsDyEHUpq_8OzCaTc,2275
+uno/mod_store/uninstaller.py,sha256=u_ZxDDsZ_oGDu4jT4syARChig5uzEhsQ1BPY9KlMI0w,1590
+uno/mod_store/updater.py,sha256=sVhIvOUDXaX7rH3Q2MZRLvUeAE8GOhgFVu0auGjaseY,3447
+uno/mod_store/validator.py,sha256=DgPH9ogLgWvAjLuwmHJB_oDHI0bb8kOI_XqBVHrNnlQ,2726
+uno/mod_store/web_open.py,sha256=x_kfnyKlvsoYLLm_7fUjvn0a53s9umACRqxm-5IzNis,617
+skilluno-1.12.1.dist-info/METADATA,sha256=nQnv2yo0rc8yk0KflUKfNo_pCAaOL_MwiQNiEgdPjvA,7480
+skilluno-1.12.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+skilluno-1.12.1.dist-info/entry_points.txt,sha256=bREmTDYdBvyzvaT4RbKiS2Ur3kri3gRtflGCf5_GntQ,42
+skilluno-1.12.1.dist-info/top_level.txt,sha256=2fhtNLCw4x9ZX7CTLAbHez8Y6jK5-HD1MotnSKhE4hA,4
+skilluno-1.12.1.dist-info/RECORD,,

skilluno-1.12.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

skilluno-1.12.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+skilluno = uno.main:cli

skilluno-1.12.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zhuyiming0208
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

skilluno-1.12.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+uno

uno/__init__.py

@@ -0,0 +1 @@
+# 空文件，标记 uno 为包

uno/achievements.py

@@ -0,0 +1,105 @@
+from abc import ABC, abstractmethod
+
+class Achievement(ABC):
+    def __init__(self, id: str, name: str, description: str, hidden: bool = False):
+        self.id = id
+        self.name = name
+        self.description = description
+        self.hidden = hidden
+
+    @abstractmethod
+    def check(self, game, events: list) -> bool:
+        pass
+
+    def __repr__(self):
+        return f"{self.name}({self.id})"
+
+
+class Comeback1v3Achievement(Achievement):
+    def __init__(self):
+        super().__init__('comeback_1v3', '一穿三', '在只剩自己一人的情况下逆转获胜')
+
+    def check(self, game, events):
+        human = game.players[0]
+        if any(e['type'] == 'player_eliminated' and e['player'] == human.name for e in events):
+            return False
+        all_others_eliminated = all(
+            any(e['type'] == 'player_eliminated' and e['player'] == p.name for e in events)
+            for p in game.players if p != human
+        )
+        if not all_others_eliminated:
+            return False
+        if not any(e['type'] == 'game_end' and e.get('winner') == human.name for e in events):
+            return False
+        return True
+
+
+class CounterMasterAchievement(Achievement):
+    def __init__(self):
+        super().__init__('counter_master', '反制大师', '单局成功反制 3 次以上')
+
+    def check(self, game, events):
+        counter_events = [
+            e for e in events
+            if e['type'] == 'skill_use' and e.get('skill_name') in ('破万法', '储能')
+        ]
+        return len(counter_events) >= 3
+
+
+class InstantKillAchievement(Achievement):
+    def __init__(self):
+        super().__init__('instant_kill', '秒杀', '在对手起手阶段就使其手牌超过 15 张')
+
+    def check(self, game, events):
+        for e in events:
+            if e['type'] == 'player_eliminated' and e.get('turn_number', 0) <= 2:
+                if e.get('reason') == 'hand_limit':
+                    return True
+        return False
+
+
+class NoDrawVictoryAchievement(Achievement):
+    def __init__(self):
+        super().__init__(
+            'no_draw_victory',
+            '被遗忘的战术',
+            '你从未主动抽取过一张牌，仿佛早已预知一切。',
+            hidden=True
+        )
+
+    def check(self, game, events):
+        human = game.players[0]
+        if not any(e['type'] == 'game_end' and e.get('winner') == human.name for e in events):
+            return False
+        draw_events = [e for e in events if e['type'] == 'draw_card' and e.get('player') == human.name]
+        return len(draw_events) == 0
+
+
+def get_core_achievements():
+    """工厂函数：每次调用返回全新的成就类列表"""
+    return [
+        Comeback1v3Achievement,
+        CounterMasterAchievement,
+        InstantKillAchievement,
+        NoDrawVictoryAchievement,
+    ]
+
+
+class AchievementManager:
+    def __init__(self, game, achievement_classes):
+        self.game = game
+        self.achievements = [cls() for cls in achievement_classes]
+
+    def add_achievements(self, achievement_classes):
+        for cls in achievement_classes:
+            self.achievements.append(cls())
+
+    def evaluate(self, events):
+        achieved = set()
+        for ach in self.achievements:
+            try:
+                if ach.check(self.game, events):
+                    achieved.add(ach.name)
+            except Exception as e:
+                print(f"[成就] 评估 {ach.name} 时出错：{e}")
+        return achieved

uno/archive.py

@@ -0,0 +1,63 @@
+import os
+import json
+import base64
+
+ARCHIVE_FILE = os.path.join(os.path.dirname(__file__), 'archive.txt')
+
+def load_archive():
+    if not os.path.exists(ARCHIVE_FILE):
+        return {}
+    try:
+        with open(ARCHIVE_FILE, 'r', encoding='utf-8') as f:
+            encoded = f.read()
+            if not encoded:
+                return {}
+            decoded = base64.b64decode(encoded).decode('utf-8')
+            data = json.loads(decoded)
+            # 兼容旧存档：确保每个玩家都有 achievements 列表
+            for name in data:
+                if 'achievements' not in data[name]:
+                    data[name]['achievements'] = []
+            return data
+    except Exception as e:
+        print(f"[存档] 读取失败，使用空存档。错误：{e}")
+        return {}
+
+def save_archive(data):
+    try:
+        json_str = json.dumps(data, ensure_ascii=False, indent=2)
+        encoded = base64.b64encode(json_str.encode('utf-8')).decode('ascii')
+        with open(ARCHIVE_FILE, 'w', encoding='ascii') as f:
+            f.write(encoded)
+    except Exception as e:
+        print(f"[存档] 保存失败。错误：{e}")
+
+def update_record(name: str, won: bool, achievements: list = None):
+    data = load_archive()
+    if name not in data:
+        data[name] = {'wins': 0, 'losses': 0, 'achievements': []}
+    if won:
+        data[name]['wins'] += 1
+    else:
+        data[name]['losses'] += 1
+    if achievements:
+        existing = set(data[name].get('achievements', []))
+        for ach in achievements:
+            existing.add(ach)
+        data[name]['achievements'] = list(existing)
+    save_archive(data)
+    print(f"[存档] {name} 的战绩已更新。")
+
+def show_record(name: str):
+    data = load_archive()
+    if name in data:
+        wins = data[name]['wins']
+        losses = data[name]['losses']
+        total = wins + losses
+        rate = f"{wins/total*100:.7f}%" if total > 0 else "N/A"
+        print(f"{name} 战绩：{wins}胜 {losses}负，胜率 {rate}")
+        ach = data[name].get('achievements', [])
+        if ach:
+            print(f"  成就：{', '.join(ach)}")
+    else:
+        print(f"{name} 尚无战绩记录。")

uno/combo_base.py

@@ -0,0 +1,7 @@
+from abc import ABC, abstractmethod
+
+class ComboBase(ABC):
+    @abstractmethod
+    def execute(self, player, skill_manager, game):
+        """执行组合技效果"""
+        pass