WaliGame 2026.11.9__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- waligame-2026.11.9/CHANGELOG.md +693 -0
- waligame-2026.11.9/LICENSE +22 -0
- waligame-2026.11.9/MANIFEST.in +7 -0
- waligame-2026.11.9/NOTICE +17 -0
- waligame-2026.11.9/PKG-INFO +263 -0
- waligame-2026.11.9/README.md +220 -0
- waligame-2026.11.9/README_4.0.2.md +1033 -0
- waligame-2026.11.9/pyproject.toml +104 -0
- waligame-2026.11.9/setup.cfg +4 -0
- waligame-2026.11.9/src/WaliGame.egg-info/PKG-INFO +263 -0
- waligame-2026.11.9/src/WaliGame.egg-info/SOURCES.txt +47 -0
- waligame-2026.11.9/src/WaliGame.egg-info/dependency_links.txt +1 -0
- waligame-2026.11.9/src/WaliGame.egg-info/entry_points.txt +2 -0
- waligame-2026.11.9/src/WaliGame.egg-info/requires.txt +14 -0
- waligame-2026.11.9/src/WaliGame.egg-info/top_level.txt +2 -0
- waligame-2026.11.9/src/Walimaker.py +26 -0
- waligame-2026.11.9/src/waligame/API.py +325 -0
- waligame-2026.11.9/src/waligame/__init__.py +65 -0
- waligame-2026.11.9/src/waligame/_version.py +3 -0
- waligame-2026.11.9/src/waligame/animation.py +77 -0
- waligame-2026.11.9/src/waligame/camera.py +194 -0
- waligame-2026.11.9/src/waligame/collision.py +173 -0
- waligame-2026.11.9/src/waligame/config.py +398 -0
- waligame-2026.11.9/src/waligame/constraints.py +121 -0
- waligame-2026.11.9/src/waligame/cursor.py +16 -0
- waligame-2026.11.9/src/waligame/draw.py +11 -0
- waligame-2026.11.9/src/waligame/draw_options.py +92 -0
- waligame-2026.11.9/src/waligame/error_help.py +429 -0
- waligame-2026.11.9/src/waligame/events.py +164 -0
- waligame-2026.11.9/src/waligame/facilitate.py +22 -0
- waligame-2026.11.9/src/waligame/fonts.py +277 -0
- waligame-2026.11.9/src/waligame/input.py +99 -0
- waligame-2026.11.9/src/waligame/lobby.py +543 -0
- waligame-2026.11.9/src/waligame/lru_cache.py +71 -0
- waligame-2026.11.9/src/waligame/music.py +175 -0
- waligame-2026.11.9/src/waligame/network.py +755 -0
- waligame-2026.11.9/src/waligame/objects.py +988 -0
- waligame-2026.11.9/src/waligame/physics.py +415 -0
- waligame-2026.11.9/src/waligame/py.typed +0 -0
- waligame-2026.11.9/src/waligame/resource_manager.py +333 -0
- waligame-2026.11.9/src/waligame/screen.py +214 -0
- waligame-2026.11.9/src/waligame/settings.py +1 -0
- waligame-2026.11.9/src/waligame/sprite.py +441 -0
- waligame-2026.11.9/src/waligame/static/DialogBox.png +0 -0
- waligame-2026.11.9/src/waligame/static/pymunk_logo_googlecode.png +0 -0
- waligame-2026.11.9/src/waligame/static/walimaker-logo.png +0 -0
- waligame-2026.11.9/src/waligame/test.py +131 -0
- waligame-2026.11.9/src/waligame/textbox.py +350 -0
- waligame-2026.11.9/src/waligame/tiledmap.py +123 -0
|
@@ -0,0 +1,693 @@
|
|
|
1
|
+
# 更新日志
|
|
2
|
+
|
|
3
|
+
本项目从 Walimaker 4.0.2(MIT)演化而来,版本号改为“年.月.第几次修改”。
|
|
4
|
+
|
|
5
|
+
## [2026.11.9] - 2026-11-19
|
|
6
|
+
|
|
7
|
+
### 修复
|
|
8
|
+
- 通用大厅重新显示房主 `房间地址:IP:端口`。
|
|
9
|
+
- 玩家列表改为 4 列紧凑网格,最多显示 16 人;顶部显示人数。
|
|
10
|
+
|
|
11
|
+
## [2026.11.8] - 2026-11-19
|
|
12
|
+
|
|
13
|
+
### 修复
|
|
14
|
+
- 彩色食材大作战:被吃掉后按 Esc 可退出。
|
|
15
|
+
- 关闭后重新加入不再继承旧玩家的死亡状态;服务器玩家编号不再复用。
|
|
16
|
+
- 镜头以自己为中心,世界扩大到 2400×1600,玩家被限制在最大边界内。
|
|
17
|
+
- 新增重连/边界测试。
|
|
18
|
+
|
|
19
|
+
## [2026.11.7] - 2026-11-19
|
|
20
|
+
|
|
21
|
+
### 新增
|
|
22
|
+
- `联机(..., 允许中途加入=True)`:房主开始游戏后,新玩家仍可加入。
|
|
23
|
+
- 房间人数上限从 8 放宽到 16。
|
|
24
|
+
- 示例游戏 `彩色食材大作战.py`:吃彩色食材变大,玩家碰撞时大的吃掉小的,被吃后显示游戏结束。
|
|
25
|
+
- 游戏采用房主权威状态 + 客户端输入,支持多名玩家和中途加入。
|
|
26
|
+
|
|
27
|
+
## [2026.11.6] - 2026-11-19
|
|
28
|
+
|
|
29
|
+
### 新增
|
|
30
|
+
- 通用局域网联机房间:`waligame.network.LanGame` / `联机`。
|
|
31
|
+
- 通用大厅:创建房间、查找房间、房间号、最多人数、玩家名、可选密码、玩家列表、房主开始。
|
|
32
|
+
- 孩子只调用 `net.大厅()`,然后用 `net.发送()` / `net.收到()` 写游戏规则。
|
|
33
|
+
- 网络层仍为 UDP 发现 + TCP 房间/转发;RPS 只是其中一个示例。
|
|
34
|
+
|
|
35
|
+
## [2026.11.5] - 2026-11-18
|
|
36
|
+
|
|
37
|
+
### 安装器
|
|
38
|
+
- 安装前检测旧包:`Walimaker` / `walimaker`(2026.11.1、上游 4.0.2)和 `WalimakerPythonGameEngine`(2023.8.1)。
|
|
39
|
+
- 检测到旧包时询问用户:
|
|
40
|
+
- 选择不卸载:直接退出,不安装 WaliGame;
|
|
41
|
+
- 选择卸载:先 `pip uninstall` 旧包,并清理残留的 `Walimaker/` / `WalimakerPythonGameEngine/` 目录和旧 `*.dist-info`,再安装 WaliGame。
|
|
42
|
+
- 清理只删除旧包目录和旧元数据,不删除 WaliGame 自带的 `Walimaker.py` 别名文件。
|
|
43
|
+
- 新增 `old_guard.py`(check / uninstall);bat 使用它完成检测和卸载。
|
|
44
|
+
|
|
45
|
+
## [2026.11.4] - 2026-11-17
|
|
46
|
+
|
|
47
|
+
### 新增/变更
|
|
48
|
+
- **`Walimaker` 别名并入主包**:安装 WaliGame 后,`from Walimaker import *` / `import Walimaker` 直接等价于 `waligame`,IDLE、任意工作目录都能用,不再需要单独安装 compat 包。
|
|
49
|
+
- 旧 `walimaker` 发行包仍会以同名 `Walimaker/` 目录遮住别名;安装 2026.11.4 前请先 `pip uninstall -y walimaker`。
|
|
50
|
+
- 主 wheel 新增顶层 `Walimaker.py`;`pyproject.toml` 使用 `py-modules = ["Walimaker"]` 打包。
|
|
51
|
+
|
|
52
|
+
## [2026.11.3] - 2026-11-17
|
|
53
|
+
|
|
54
|
+
### 修复
|
|
55
|
+
- **音频失败不再影响游戏**:`setup()` 依次尝试 48000/44100、2/1 声道打开 mixer;全部失败只警告一次并静音继续。
|
|
56
|
+
- `bgmusic()` 返回 `True/False`,不再抛 `mixer not initialized`;`play_snd()` / `music_*()` 在音频不可用时安全跳过。
|
|
57
|
+
- 音乐/音效文件缺失或损坏只警告一次,不中断游戏。
|
|
58
|
+
- **滑滑梯松手后仍跟鼠标**:`MOUSE_BUTTONS` 每帧维护;`get_mouse_clicked()` 自愈;漏掉的松开事件会被清理。
|
|
59
|
+
- `setup()` 的 `dpi_aware` 默认改为 **False**;需要物理像素时传 `True`。
|
|
60
|
+
|
|
61
|
+
### 新增/兼容
|
|
62
|
+
- `from waligame import *` 恢复 `random` / `time` / `os` / `math` / `sys` / `pygame`。
|
|
63
|
+
- 可选兼容层:安装 `compat\waligame_walimaker_compat-2026.11.3-py3-none-any.whl` 后,`from Walimaker import *` 等价于 `from waligame import *`(需先卸载旧 `walimaker`)。
|
|
64
|
+
- 安装脚本:`python`/`py -3` 自动选择、Python 版本/pip 检查、永久清华镜像、升级 pip。
|
|
65
|
+
- 新增 `音频诊断.py`、`audio_available` / `ensure_audio()` / `audio_info()`。
|
|
66
|
+
- 建立 `VERSION_LOG.md` / `版本记录.md`,固定“每次更新必升版本号并记录”的流程。
|
|
67
|
+
|
|
68
|
+
## [2026.11.2] - 2026-11-17
|
|
69
|
+
|
|
70
|
+
### 新增(从 2026.11.1 教学版合并)
|
|
71
|
+
- `every()` / `after()` / `clear_timers()` 计时器;`update_timers()` 在每帧 GROUP 更新前执行。
|
|
72
|
+
- `tag` + `find_all()` / `find()` / `collide_tag()`;`Group` 会清理死亡对象。
|
|
73
|
+
- `clone()`:复制图片/大小/位置/缩放/旋转/颜色/tag/物理属性。
|
|
74
|
+
- `follow()` / `stop_follow()` / `on_screen`。
|
|
75
|
+
- `Score` / `Label` 屏幕 HUD。
|
|
76
|
+
- 没有物理体的对象也支持 `velocity`(像素/帧)。
|
|
77
|
+
- `get_angle` 兼容别名(`angle` 仍是主名)。
|
|
78
|
+
- `key_just_pressed` / `key_just_released` 默认“任意一个”,`require_all=True` 为全部。
|
|
79
|
+
- 控制台隐藏 pygame/pymunk 横幅,首帧打印 `【欢迎使用 WaliGame 2026.11.2】游戏启动成功!`。
|
|
80
|
+
|
|
81
|
+
### 变更
|
|
82
|
+
- 发行名 `WaliGame`,导入包 `waligame`,版本 `2026.11.2`。
|
|
83
|
+
- 保留 4.0.2 的 `Object → GameObject`、多世界、资源管理、60 FPS/CCD、错误助手、字体回退。
|
|
84
|
+
- 依赖:`pygame>=2.5.0`、`pymunk>=6.5.0`、`pytmx>=3.32`。
|
|
85
|
+
- 保留 MIT 许可与来源说明(见 LICENSE / NOTICE);4.0.2 原 README 保留为 README_4.0.2.md。
|
|
86
|
+
|
|
87
|
+
本项目遵循[语义化版本](https://semver.org/lang/zh-CN/)。
|
|
88
|
+
|
|
89
|
+
## [4.0.2] - 2026-09-18
|
|
90
|
+
|
|
91
|
+
### 修复
|
|
92
|
+
|
|
93
|
+
- **`_silence_stderr` 返回类型注解从 `Iterator[None]` 改为 `Generator[None, None, None]`**:
|
|
94
|
+
pyright 1.1.409+ 会提示"Annotating the return type as `-> Iterator[Foo]` with `@contextmanager` is deprecated.
|
|
95
|
+
Use `-> Generator[Foo]` instead"——因为 `@contextmanager` 装饰的函数本质是生成器(用 `yield` 划分 enter/exit),
|
|
96
|
+
`Generator` 比 `Iterator` 更精确。运行时行为完全不变,仅类型注解升级。
|
|
97
|
+
顺手清理 `from typing import ...` 中不再使用的 `Iterator` 导入。
|
|
98
|
+
|
|
99
|
+
## [4.0.1] - 2026-09-18
|
|
100
|
+
|
|
101
|
+
### 修复
|
|
102
|
+
|
|
103
|
+
- **首次加载有问题 PNG 时不再向 stderr 喷 `libpng warning: iCCP: known incorrect sRGB profile` 等 C 库警告**:
|
|
104
|
+
`ResourceManager.load_image()` 加载 PNG / JPEG / TIFF 时,遇到有问题的 `iCCP` / `sRGB` / `EXIF` chunk,
|
|
105
|
+
libpng / libjpeg / libtiff 会**直接通过 C 库的 `fprintf(stderr, ...)` 输出**警告;Python 的
|
|
106
|
+
`warnings.catch_warnings()` 抓不住这种输出(它只过滤 Python 层的 warnings)。
|
|
107
|
+
现在在加载瞬间临时把 fd 2 重定向到 `os.devnull`,退出 `with` 块立即恢复——
|
|
108
|
+
对游戏主循环和其它线程的 stderr 输出无影响(重定向窗口只有微秒级)。
|
|
109
|
+
对 SDL_image 内置解码的 BMP / WEBP / XPM / PNM / PCX / TGA 不做这个重定向(这些格式不会触发 C 库警告,
|
|
110
|
+
重定向只会徒增成本)。如果想看到原本的 libpng 警告用于诊断,可直接 `pygame.image.load()`,绕开 ResourceManager。
|
|
111
|
+
新增 `tests/resource_test.py` 中的 libpng 屏蔽回归检查。
|
|
112
|
+
|
|
113
|
+
## [4.0.0] - 2026-09-18
|
|
114
|
+
|
|
115
|
+
### ⚠️ 破坏性变更
|
|
116
|
+
|
|
117
|
+
- **对象模型合成一条真正的继承链**(对齐 Unity 的 `Object` → `GameObject`):
|
|
118
|
+
|
|
119
|
+
```
|
|
120
|
+
Object 根类:坐标 / 旋转 / 缩放缓存、生命周期、组件槽位 + 组件属性代理
|
|
121
|
+
└─ GameObject 行为与交互:运动命令、方向、音效、对话、帧钩子(+ 三个 mixin)
|
|
122
|
+
├─ Character DYNAMIC
|
|
123
|
+
├─ Sensor KINEMATIC + sensor
|
|
124
|
+
├─ Wall STATIC
|
|
125
|
+
└─ Mouse 跟随鼠标
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
- `NewGameObject` **改名为 `GameObject`**。旧名字保留为别名(`NewGameObject = GameObject`)
|
|
129
|
+
并且仍在 `__all__` 里,`from waligame import *` 与继承它的老代码都不需要改。
|
|
130
|
+
- 原来的内部载体 `GameObject`(`src/waligame/game_object.py`)**提升为根类 `Object`**,
|
|
131
|
+
该模块并入 `objects.py`。若你曾把裸 `GameObject()` 当载体用(3.x 的 README 只在
|
|
132
|
+
`obj._gameObject` 处提过它),请改用 `Object`;注意 `waligame.GameObject` 现在指的是
|
|
133
|
+
**游戏对象基类**。
|
|
134
|
+
- 组件(贴图 / 刚体 / 瓦片刚体)**直接挂在对象上**:`obj.sprite` / `obj.body` /
|
|
135
|
+
`obj.tiledmap_bodies`——4.0 之前必须绕 `obj._gameObject.body`。旧写法仍然可用,
|
|
136
|
+
`_gameObject` 现在返回对象自己。
|
|
137
|
+
- 因此 `isinstance(obj, GameObject)` / `isinstance(obj, Object)` 可以正常用于类型判断。
|
|
138
|
+
- 新增公共名字 `Object`(顶点根类),公共 API 只增不减。
|
|
139
|
+
- **`get_angle` 改名为 `angle`**,并且改为返回 `float`(4.0 之前返回保留一位小数的字符串
|
|
140
|
+
形如 `"12.3"`)。角度仍由朝向向量 `dir` 算出,与贴图旋转角 `rot` 是两回事。
|
|
141
|
+
- 删除五个空壳 dunder:`__len__` / `__getitem__` / `__setitem__`(原本直接
|
|
142
|
+
`raise NotImplementedError`)、`__bool__`(恒 `True`)、`__del__`(空实现)。
|
|
143
|
+
`bool(obj)` 仍然是 `True`,`len(obj)` 由"未实现错误"变成标准的 `TypeError`。
|
|
144
|
+
|
|
145
|
+
### 变更
|
|
146
|
+
|
|
147
|
+
- **`pos` / `rot` / `kill` 现在只在根类 `Object` 定义一次**(此前 `GameObject` 各覆盖一份,
|
|
148
|
+
语义随"你手上是哪个类"而不同):
|
|
149
|
+
|
|
150
|
+
| 写法 | 语义 |
|
|
151
|
+
| --- | --- |
|
|
152
|
+
| `obj.pos = (x, y)` / `goto()` | 瞬移:写缓存与刚体,并**清零速度** |
|
|
153
|
+
| `obj.shift_by((dx, dy))` | 增量位移:写缓存与刚体,**不动速度**(重力继续生效) |
|
|
154
|
+
| `obj.sync_pos(p)` / `sync_rot(r)` | 物理层每帧回写:**只改显示缓存**,不写刚体 |
|
|
155
|
+
|
|
156
|
+
以前在裸 `Object`(或自己继承 `Object`)上写 `rot` 只改缓存、**不写刚体**,会出现
|
|
157
|
+
"贴图转了、碰撞体没转"的静默错位;现在根类本身就是完整实现。
|
|
158
|
+
- **`kill()` 改为模板方法**:根类销毁组件后回调 `_on_kill()`(默认空)。
|
|
159
|
+
子类(如 `GameObject` 要销毁对话框)只需覆盖 `_on_kill()`,不再需要覆盖 `kill()` 并手动
|
|
160
|
+
调用 `Object.kill(self)`——那种写法一旦忘记就不会销毁组件,而且不报错。
|
|
161
|
+
|
|
162
|
+
- **组件属性代理回归根类**:`color` / `red` / `green` / `blue` / `alpha` / `visible` / `show` /
|
|
163
|
+
`hide` / `width` / `height` / `flipx` / `flipy` / `scale` / `layer` / `move_to_front` /
|
|
164
|
+
`move_to_back` / `velocity` / `angular_velocity` / `mass` / `elasticity` / `friction` /
|
|
165
|
+
`apply_force` / `body_scale` 现在定义在 `Object` 上(此前堆在 `GameObject`)。
|
|
166
|
+
它们只读写组件槽位、不需要任何玩法状态,归位后 `Object` = 组件 + 属性代理、
|
|
167
|
+
`GameObject` = 行为与交互,`world` / `name` 也随之上移到根类。
|
|
168
|
+
搬完之后 `GameObject` 只覆盖 `__init__` 与 `_on_kill` 两个钩子,其余 18 个成员
|
|
169
|
+
(运动命令 / 朝向 / 音效 / 对话 / 帧钩子)都是它独有的行为接口。
|
|
170
|
+
|
|
171
|
+
### 修复
|
|
172
|
+
|
|
173
|
+
- **没有贴图时不再抛难懂的 `AttributeError`**:`Character(size=(32, 32))` 这类"只有刚体、
|
|
174
|
+
没有图片"的对象,此前 `obj.color = ...` 会报
|
|
175
|
+
`AttributeError: 'NoneType' object has no attribute 'modified'`,`obj.width` / `obj.flipx()`
|
|
176
|
+
等同理。现在给出一次性中英双语 `RuntimeWarning` 并返回中性值:
|
|
177
|
+
`visible` → `False`,`width`/`height` → `0`,颜色 / 图层 → `None`,写入类调用直接忽略。
|
|
178
|
+
与既有的"无刚体"提示(`velocity` → `None`)保持一致,每个对象只提示一次。
|
|
179
|
+
|
|
180
|
+
### 新增
|
|
181
|
+
|
|
182
|
+
- `tests/behaviour_snapshot_test.py` + `tests/data/behaviour_baseline.json`:**行为快照测试**。
|
|
183
|
+
把整套对象/物理/渲染行为压成 27 项观测(位移与速度语义、旋转、缩放、点/对象/贴图三种碰撞、
|
|
184
|
+
瓦片地图对象层、相机跟随、约束距离、物理子步与防穿透、整帧像素哈希、生命周期),
|
|
185
|
+
用固定假时钟消除 `Screen.update()` 的真实时钟抖动后与基线对拍——重构时"行为有没有变"一眼可见。
|
|
186
|
+
浮点按 `abs_tol=1e-3` 容差比较(跨 pymunk 6/7 的浮点噪声不影响判定),
|
|
187
|
+
布尔/整数/字符串/像素哈希要求完全一致;有意改动用
|
|
188
|
+
`WALIGAME_UPDATE_BASELINE=1 python tests/behaviour_snapshot_test.py` 重生成基线。
|
|
189
|
+
- `Object.shift_by(delta)`:按增量位移且**不清零速度**(内部按键位移 / 滑行动画走它,
|
|
190
|
+
重力等已有速度继续生效);`Object.sync_rot(rot)`:物理层每帧同步角度时只更新缓存与重绘标记,
|
|
191
|
+
**不反写刚体**,与既有的 `sync_pos()` 对称——避免每帧无意义的
|
|
192
|
+
`reindex_shapes_for_body`(宽相重排)。
|
|
193
|
+
- `tests/object_model_test.py`:18 项检查守住继承链、旧名字别名、组件直达、
|
|
194
|
+
`pos`/`x`/`y`(清速度)与 `shift_by`(不清速度)、`rot`(写刚体)与 `sync_rot`(只同步显示)、
|
|
195
|
+
属性代理的归属(只在 `Object` 定义一次)、无贴图 / 无刚体时的"一次性提示 + 中性值"、
|
|
196
|
+
`angle` 为 float、死桩 dunder 已清理,以及"`pos`/`rot`/`kill` 只在根类定义、
|
|
197
|
+
`kill` 会回调 `_on_kill` 钩子"。
|
|
198
|
+
|
|
199
|
+
### 文档
|
|
200
|
+
|
|
201
|
+
- README 适配 PyPI 渲染:目录里的 16 个锚点改为**显式 `<a id="...">`**(PyPI 不给标题生成
|
|
202
|
+
`id`,原先的 GitHub 风格 `#-标题` 在 PyPI 上全是死链),并把会 404 的相对链接 `](LICENSE)`
|
|
203
|
+
改成跳到本页「许可证」小节 / 纯文字说明。已用 PyPI 自己的渲染器(`readme_renderer[md]`)
|
|
204
|
+
验证:17 个锚点全部可解析、无相对链接、21 张表格与 3 个代码块正常渲染;GitHub 侧行为不变。
|
|
205
|
+
|
|
206
|
+
## [3.1.2] - 2026-09-14
|
|
207
|
+
|
|
208
|
+
### 文档
|
|
209
|
+
- **README 全面补全用法**:新增「📖 目录」与完整的「📖 API 参考」——覆盖全部 **86 个公共名字**
|
|
210
|
+
(窗口与主循环、Character/对象模型、物理引擎、约束、相机、TileMap、Sprite 与五种动画策略、
|
|
211
|
+
TextBox/DialogBox、鼠标键盘输入、音频、资源管理、中文报错助手、字体解析、世界与全局状态、
|
|
212
|
+
场景级工具),并新增「🍳 常见任务速查」(12 段可直接抄的代码)与「❓ 常见问题(FAQ)」(9 条)。
|
|
213
|
+
- **修正两处错误说明**:坐标系原点此前写成"窗口左上角"(实际在**窗口中心**、y 轴向上);
|
|
214
|
+
默认重力此前写成"900 像素/秒²"(实际是 **`(0, 0)` 零重力**,必须自己 `set_gravity()`)。
|
|
215
|
+
「核心模块详解」改为按模块的总览表,`Character` 构造方式补充了 `size`/`Sensor`/`Wall`/`Mouse`/`GameObject`。
|
|
216
|
+
|
|
217
|
+
## [3.1.1] - 2026-09-14
|
|
218
|
+
|
|
219
|
+
### 修复
|
|
220
|
+
- **高速物体不再穿过薄碰撞体(隧穿)**:物理是固定步长(1/60 秒)推进,而 pymunk/Chipmunk
|
|
221
|
+
没有连续碰撞检测——一步的位移超过碰撞体厚度就会直接穿过去(实测 10px 厚的墙在 1200 px/s 时穿模)。
|
|
222
|
+
现在 `Screen` 会按“最快的物体一步能走多远”自动把固定步长切成多个子步,保证每个子步的位移不超过
|
|
223
|
+
`world.MAX_STEP_DISTANCE`(默认 8 像素),上限为 `world.MAX_SUBSTEPS`(默认 16)。
|
|
224
|
+
**慢速场景子步数恒为 1**,因此行为与性能都不变;把 `MAX_STEP_DISTANCE` 设为 0 可关闭子步。
|
|
225
|
+
新增 `tests/physics_test.py`(5 项):1200/3000/8000 px/s 不穿薄墙、慢速保持单步、
|
|
226
|
+
子步数随速度增长并被上限截断、关闭后恢复旧行为、静态物体不误触发子步。
|
|
227
|
+
- **`collide()` 混合几何情况不再崩溃**:**贴图对象 vs 纯刚体对象**(例如
|
|
228
|
+
`Character(图片)` 撞 `Wall(size=(200, 40))`)此前会走到 mask 分支并抛
|
|
229
|
+
`AttributeError: 'NoneType' object has no attribute 'image'`。现在按“谁有物理几何”分派:
|
|
230
|
+
只有一方有刚体时,用贴图矩形的**中心 + 四角**对它做点查询(近似判定,足够覆盖
|
|
231
|
+
“角色站在平台上”“子弹打中墙”这类用法);双方都没有几何时明确返回 `False`
|
|
232
|
+
(此前会返回 `None`),并且反向调用(刚体对象 → 贴图对象)同样可用。
|
|
233
|
+
- **中文报错提示不再一律归咎于“忘了 setup()”**:原先任何含 `NoneType` 的 `AttributeError`
|
|
234
|
+
都会提示“对象还没初始化:是不是忘了先调用 setup()?”,像“对象没有贴图”这种错会被误导到
|
|
235
|
+
完全错误的方向。现在只有报错指向 setup() 创建的内部对象(`ALL_SPRITES`/`SCREEN`/`SPACE`/
|
|
236
|
+
`CAMERA`/`TMBG`/`BODIES`/`GROUP`)时才提示 setup(),并新增「这个对象没有贴图」规则。
|
|
237
|
+
|
|
238
|
+
### 改进(物理易踩坑)
|
|
239
|
+
- **没有刚体时物理接口不再静默失效**:`Character(图片)` 不传 `size` 时不会创建刚体,此前
|
|
240
|
+
`velocity` / `angular_velocity` / `apply_force()` / `mass` / `elasticity` / `friction`
|
|
241
|
+
全都**静默无效**(getter 只返回 `None`),初学者几乎不可能发现“我的角色怎么没有重力”。
|
|
242
|
+
现在第一次调用会给出一条中英双语 `RuntimeWarning`,写明正确写法
|
|
243
|
+
(`Character(图片, size=(32, 32))`)与 `set_gravity(0, -1200)`;每个对象只提示一次,不会刷屏。
|
|
244
|
+
- README 的 `Character` 构造方法补充说明「参与物理必须传 `size`、默认零重力」,`Character`
|
|
245
|
+
docstring 同步写明;`examples/README.md` 也加了同样的提醒。
|
|
246
|
+
- `tests/smoke_test.py` 增加回归检查:无刚体时只提示一次、有刚体时不提示。
|
|
247
|
+
|
|
248
|
+
### 新增(示例代码)
|
|
249
|
+
- **`examples/` 目录**:三个可直接运行的完整示例,重点覆盖物理引擎与瓦片地图——
|
|
250
|
+
`physics_basics.py`(重力、STATIC/KINEMATIC/DYNAMIC 三种刚体、`collide`/`separate`、冲量、
|
|
251
|
+
弹性/摩擦/质量、Sensor、物理调试绘制)、`physics_constraints.py`(`connect()` 刚性链 + `Spring()` 弹簧)、
|
|
252
|
+
`tiledmap_basics.py`(`bgpic(TiledMap)` 铺背景 + `create_objects()` 把对象层变成碰撞体与金币,
|
|
253
|
+
带一个可玩的迷你平台跳跃)。附带示例关卡 `examples/assets/level.tmx` 与图集 `tiles.png`(进入 sdist,不进 wheel)。
|
|
254
|
+
- 示例支持 `WALIGAME_EXAMPLE_FRAMES=N` 无显示器自测;新增 `tests/examples_test.py` 用子进程各跑 30 帧,
|
|
255
|
+
保证示例不会腐坏;`scripts/check.py` 的 lint 目标也纳入了 `examples/`。
|
|
256
|
+
- README 增加示例入口与「🧪 示例代码」章节,`examples/README.md` 汇总运行方式与关键 API。
|
|
257
|
+
|
|
258
|
+
## [3.1.0] - 2026-09-14
|
|
259
|
+
|
|
260
|
+
阶段 C 批次 1(教学体验与诚信)+ 批次 2(TileMap 对象层与地图背景)+ 批次 3(约束系统)
|
|
261
|
+
+ 批次 4(相机手感与资源管理)。
|
|
262
|
+
|
|
263
|
+
### 新增(相机与资源)
|
|
264
|
+
- **相机手感三件套**(默认全部关闭,不影响既有项目):
|
|
265
|
+
`camera.shake(amount=8, duration=0.3)` 屏幕抖动(结束后自动归位,`stop_shake()` 可立即停止);
|
|
266
|
+
`camera.deadzone = (半宽, 半高)` 跟随死区(主体在死区内移动时相机不动,超出后保留边距);
|
|
267
|
+
`camera.zoom_to(scl, speed=2.0)` 平滑缩放,以及 `camera.smooth_zoom = True` 让缩放走
|
|
268
|
+
`pygame.transform.smoothscale`(更平滑、稍慢)。
|
|
269
|
+
- **顶层 `preload(assets)`**:批量预加载图片/字体/音效(原先只能用
|
|
270
|
+
`global_var.RESOURCE_MANAGER.preload(...)`)。公共 API 由 641 个名字增至 **642 个**。
|
|
271
|
+
- README 增加「📷 相机手感」与顶层 `preload` 用法。
|
|
272
|
+
|
|
273
|
+
### 修复(资源缓存)
|
|
274
|
+
- **mask 缓存改为弱引用**:原先 key 是 `(surface, threshold)`——**强引用**会把临时 Surface
|
|
275
|
+
永久留在缓存里(等于内存泄漏),而且同一 Surface 的不同 `threshold` 会互相覆盖。
|
|
276
|
+
现在按 Surface 弱引用缓存 `{surface: {threshold: mask}}`:同一 Surface 只构建一次、
|
|
277
|
+
不同阈值各存一份、Surface 被回收后条目自动消失(因此也不需要 LRU 淘汰)。
|
|
278
|
+
- 补 `tests/camera_test.py`(6 项)与 `tests/resource_test.py`(8 项:LRU 淘汰、弱引用 mask、
|
|
279
|
+
`preload` 成功/失败、`unload`/`clear_cache`/`get_cache_info`)。
|
|
280
|
+
|
|
281
|
+
### 新增(约束系统)
|
|
282
|
+
- **`Spring` 现在是真正的弹簧**(`pymunk.DampedSpring`):`Spring(a, b, rest_length=None, stiffness=100,
|
|
283
|
+
damping=10, anchor_a=(0,0), anchor_b=(0,0))`,`rest_length=None` 表示取创建时两物体的实际距离。
|
|
284
|
+
此前 `Spring` 的实现只有 `pass`(空类)。
|
|
285
|
+
- **`connect()` 与 `Connect` 统一为刚性销钉**(`pymunk.PinJoint`):`connect()` 原先用 `GearJoint`
|
|
286
|
+
(耦合角速度,与 `Connect` 的销钉语义矛盾),而且参数取 `a.body`——游戏对象没有这个属性,调用即
|
|
287
|
+
`AttributeError`。现在两者都接受**游戏对象或 `physics.Body`**,自动加入对象所属世界的空间,
|
|
288
|
+
无刚体对象给出中英双语 `TypeError`。
|
|
289
|
+
- **动态瓦片地图改为邻居网格连接**:原先两两连接,n 块瓦片产生 n(n-1)/2 个关节(200 块 ≈ 2 万个),
|
|
290
|
+
现在只连半径内的邻居(默认取最近邻距离中位数 ×1.5,正好覆盖正交与对角邻居;每个刚体最多 8 个),
|
|
291
|
+
邻居查找走均匀网格哈希,因此估算半径与配对都不会退化成 O(n²)。25 块瓦片的关节数 300 → 72。
|
|
292
|
+
- README 增加「🔗 把两个物体连起来(约束)」用法。
|
|
293
|
+
|
|
294
|
+
### 修复(批次 3 过程中暴露)
|
|
295
|
+
- **移动刚体后没有让空间重排**:`Body.set_parent()` 把刚体放到 `parent.pos + offset` 却没有调用
|
|
296
|
+
`reindex_shapes_for_body`,形状的变换缓存停留在旧位置——点查询/碰撞会全部落在移动前的地方
|
|
297
|
+
(瓦片地图对象层尤其明显);更隐蔽的是随后的 `set_pos()` 会因“位置没变”直接跳过重排,永远不会自愈。
|
|
298
|
+
- **新建的 `TiledMapBodies` 不会立即摆放瓦片**:`set_parent()` 只设置组坐标,要等第一次
|
|
299
|
+
`goto()`/`set_pos()` 才归位,这之前所有瓦片叠在原点(碰撞自然查不到)。现在立即按 `pos + offset` 摆放。
|
|
300
|
+
- `create_objects()` 改用“顶点列表 → 单个 POLY 刚体”,避免与 `TiledMapBodies` 的每瓦片偏移叠加两次。
|
|
301
|
+
|
|
302
|
+
### 新增(TileMap / 地图背景)
|
|
303
|
+
- **`bgpic(TiledMap)` 真正渲染地图**:历史实现只把相机尺寸设成地图大小、并不渲染,
|
|
304
|
+
想显示地图必须绕道 `Character(tiledmap)`(文档路径不通);现在会创建地图精灵并渲染。
|
|
305
|
+
`bgpic` 同时支持 `pygame.Surface`,并**返回背景对象**(便于 `bgpic(...).kill()`);
|
|
306
|
+
传入不支持的类型时给出中英双语 `TypeError`(此前是 `AttributeError: 'tuple' object has no attribute '_gameObject'`)。
|
|
307
|
+
- **`TiledMap.create_objects(...)`**:把对象层的对象实例化为游戏对象——每个对象按其顶点生成 POLY 刚体
|
|
308
|
+
(可直接 `obj.collide(...)`/参与物理),TMX 图块对象自动带贴图,也可用 `images={"名字": 图片}` 指定;
|
|
309
|
+
TMX 的名字 / 自定义属性 / 原始对象挂在 `.name` / `.properties` / `.tmx_object` 上。
|
|
310
|
+
另外 `NewGameObject` 现在默认带 `name`(空串)、`properties`(空 dict)、`tmx_object`(None)三个字段。
|
|
311
|
+
- README 新增「🗺️ TileMap:铺成背景 / 取出对象层」用法与 `bgpic` 说明。
|
|
312
|
+
|
|
313
|
+
### 修复(实现批次 2 时暴露)
|
|
314
|
+
- **对象层碰撞体位置偏移一倍**:`_get_objects()` 生成的是**绝对坐标**顶点,而 `TiledMapBodies`
|
|
315
|
+
又会把刚体放到对象自己的位置上,于是位置被叠加两次(对象层碰撞体整体错位)。
|
|
316
|
+
现在顶点改为**相对对象原点**(多边形只翻转 y;矩形按其宽高生成),由刚体位置决定落点。
|
|
317
|
+
- **纯刚体对象(无贴图)每帧被拖回原点**:`GameObject` 的缓存坐标只在有贴图时才更新,
|
|
318
|
+
于是 `Wall._update()` 里的 `self.pos += self._velocity` 会读到陈旧的 `(0, 0)` 并写回刚体,
|
|
319
|
+
把对象拽回原点(同时 `obj.pos` 永远读不到真实位置)。现在缓存坐标无条件更新,
|
|
320
|
+
纯刚体对象(含 `create_objects()` 生成的对象)位置正确。
|
|
321
|
+
|
|
322
|
+
### 变更(行为)
|
|
323
|
+
- **`set_depth(i)` 不再改变调用进程的工作目录**:改为**返回路径字符串**(如 `set_depth(2)` → `"../../"`),
|
|
324
|
+
并发出一次 `DeprecationWarning`。历史实现直接 `os.chdir("../" * i)`——库函数擅自切换 cwd,
|
|
325
|
+
之后所有相对路径(含资源加载)都会跟着漂移,极难排查。需要切换目录请显式 `os.chdir(set_depth(i))`。
|
|
326
|
+
- **`TextBox` 新增主名 `write(text)`**:`print(text)` 保留为**兼容别名**(旧代码与 `demo/` 无需改动),
|
|
327
|
+
但新代码建议用 `write()`,避免遮蔽内建 `print`。
|
|
328
|
+
|
|
329
|
+
### 修复
|
|
330
|
+
- **`key_pressed()` 无参语义**:改为 `any(pygame.key.get_pressed())`。原写法 `1 in pygame.key.get_pressed()`
|
|
331
|
+
效果虽然相同(序列里存的是布尔),但读起来像在判断"键码 1",而且把 `get_pressed()` 调了两次;
|
|
332
|
+
现在语义明确且只取一次状态。
|
|
333
|
+
- **README 诚信化**:把从未实现的"代码热重载 / 可视化编辑器 / 插件系统 / 按钮控件 / 触控 / 3D /
|
|
334
|
+
WebAssembly / 网络多人"从「✨ 特性亮点」移到「🚀 下一步计划(Roadmap)」并加说明;
|
|
335
|
+
「开发效率」改写为真实能力(调试绘制/自动刷新/限速、`py.typed` 类型提示、8 个测试文件与
|
|
336
|
+
`scripts/check.py --matrix` 双版本矩阵);`TextBox` 方法表补充 `write()`。
|
|
337
|
+
- 清理 `demo/.DS_Store`。
|
|
338
|
+
|
|
339
|
+
### 变更(内部结构)
|
|
340
|
+
- **容器抽象统一**:`config.Group` 成为唯一的"按帧更新容器"实现(新增可选更新钩子);
|
|
341
|
+
`physics.BodiesGroup` / `TiledMapBodiesGroup` 退化为它的薄子类,公共名字、行为与更新顺序都不变。
|
|
342
|
+
绘制用的精灵层仍由 pygame 的 `LayeredDirty`(`screen.FullRedrawLayeredDirty`)负责——绘制与图层操作
|
|
343
|
+
是它自带能力,刻意不并入 `Group`。验证:76 项行为快照 + 逐帧像素哈希与重构前**逐字节一致**。
|
|
344
|
+
|
|
345
|
+
## [3.0.0] - 2026-09-14
|
|
346
|
+
|
|
347
|
+
### ⚠️ 破坏性变更
|
|
348
|
+
|
|
349
|
+
3.0.0 引入多世界支持(`World` 贯穿引擎核心与对象创建路径),以下与 2.x 不兼容:
|
|
350
|
+
|
|
351
|
+
- **`Camera` 不再是类级单例**:原先 `Camera(...)` 永远返回同一个实例(`Camera._instances`),
|
|
352
|
+
第二个世界会共用同一个相机;现在每次调用都创建新实例,每个世界有自己的 `world.CAMERA`。
|
|
353
|
+
另外 `Camera()` 不传尺寸时按该世界的窗口尺寸创建,世界还没 `setup()` 时会抛中英双语错误
|
|
354
|
+
(旧代码里写 `self = global_var.CAMERA` 的无效分支已删除)。
|
|
355
|
+
- **`events.rememberClick` 模块级全局移除**:改由世界持有(`world.rememberClick`)。
|
|
356
|
+
该名字从未纳入公共 API(`__all__`),但若你直接引用过 `waligame.events.rememberClick`,请改用 `world.rememberClick`。
|
|
357
|
+
- **`World.ALL_BODIES` 更名为 `World.BODIES`**:前者是历史遗留的死字段(代码实际一直使用 `BODIES`)。
|
|
358
|
+
- **`music_fadeout()` 签名由无参改为 `music_fadeout(ms=1000)`**:旧的无参调用在 pygame 上必然
|
|
359
|
+
`TypeError: function takes exactly 1 argument`,属于修复,但签名发生了变化。
|
|
360
|
+
- **若干边缘行为被修正为正常语义**(原先分别会抛异常或结果错误):
|
|
361
|
+
`SpriteSheet.__repr__`(曾返回 list 导致 `repr()` 报错)、
|
|
362
|
+
`ListSpriteStrategy.__getitem__`(曾访问不存在的 `self.images` → `AttributeError`)、
|
|
363
|
+
`AnimatorStrategy.__len__`(曾抛 `NotImplementedError`,使 `len()`/`bool()` 崩溃)、
|
|
364
|
+
`TiledMap.objects`(曾非幂等,连续访问坐标漂移)、
|
|
365
|
+
`pygame2Cartesian`/`Cartesian2pygame` 的双标量分支(曾把元组当整数,必然 `TypeError`)。
|
|
366
|
+
|
|
367
|
+
> 兼容性:公共 API 名字集合未变(641 个,`from waligame import *` 用法完全兼容);
|
|
368
|
+
> 新增的 `world` 参数一律可选,省略即默认世界 `global_var`,因此**单世界的既有代码无需修改**。
|
|
369
|
+
|
|
370
|
+
### 新增(类型信息与单元测试)
|
|
371
|
+
- **PEP 561 类型信息**:新增 `src/waligame/py.typed`(随 wheel 与 sdist 分发),并为公共 API 补上类型注解
|
|
372
|
+
(`config`/`screen`/`camera`/`events`/`music`/`draw`/`facilitate`/`tiledmap`/`textbox`/`sprite`/`physics`/
|
|
373
|
+
`objects` 三类对象与 mixin)。安装后编辑器与 mypy 能直接提示参数类型,例如
|
|
374
|
+
`setup("800", "600")` 会被标为 `Argument 1 has incompatible type "str"; expected "int"`。
|
|
375
|
+
门禁同时改用仓库 venv 中的 mypy(1.19.1,比 `uvx` 默认那份更严格)以保证质量。
|
|
376
|
+
- 新增 `tests/sprite_test.py`(14 项):`EasySpriteStrategy`/`ListSpriteStrategy`/`AnimatorStrategy`/
|
|
377
|
+
`SpriteSheet`/`TiledMapStrategy` 的读写、帧推进与回绕、状态机(`start_func`/`end_func`/`next_state`)、
|
|
378
|
+
边界与 `Sprite.autos` 策略选择;帧推进通过替换 `sprite.time` 用可控时钟驱动,结果完全可复现。
|
|
379
|
+
- 新增 `tests/tiledmap_test.py`(10 项):测试现场生成最小 TMX 与图集,覆盖地图尺寸、`make_map`/`render`、
|
|
380
|
+
对象层坐标换算与**幂等**、`get_objects(name)` 过滤、`Sprite(TiledMap)`/`Character(TiledMap)` 端到端。
|
|
381
|
+
|
|
382
|
+
### 修复(写测试与加注解时暴露的真实缺陷)
|
|
383
|
+
- `pygame2Cartesian(x, *y)` / `Cartesian2pygame(x, *y)` 的 `*y` 分支把元组当整数参与运算
|
|
384
|
+
(`HEIGHT//2 - y`),该分支一旦被调用必然 `TypeError`(原先是一段永远跑不通的死代码)。
|
|
385
|
+
- `music_fadeout()` 无参调用 pygame 会抛 `TypeError`(pygame 要求传淡出时长);现在签名改为
|
|
386
|
+
`music_fadeout(ms=1000)`,无参调用淡出 1 秒。
|
|
387
|
+
- `ListSpriteStrategy.__getitem__` 访问不存在的 `self.images`,调用即 `AttributeError`(应为 `self._images`);
|
|
388
|
+
`__setitem__` 缺少 `frame` 参数,赋值时只会 `TypeError`——现在支持替换某一帧。
|
|
389
|
+
- `AnimatorStrategy.__len__` 抛 `NotImplementedError`,导致 `len()`、`bool()` 直接崩;构造空状态字典时
|
|
390
|
+
抛 `NameError`。现在 `len()` 返回当前状态帧数,空字典给出中英双语 `ValueError`;并补充 docstring
|
|
391
|
+
说明 `state` 的"待切换/已生效"语义(赋值后需 `update()` 才生效)。
|
|
392
|
+
- `EasySpriteStrategy.__getitem__`/`__setitem__` 签名错误(无法索引/赋值),现在单帧可索引、替换给出明确错误。
|
|
393
|
+
- `SpriteSheet.__repr__` 返回 list(`repr()` 抛 `TypeError: __repr__ returned non-string`),并补 `__len__`。
|
|
394
|
+
- `Sprite.update()` 在未挂到 `GameObject` 时因缺少 `_parent` 抛 `AttributeError`;现在按原点处理,
|
|
395
|
+
独立 `Sprite` 也能安全 `update()`。
|
|
396
|
+
- `TiledMap.objects` 非幂等:坐标换算写在属性里就地修改 `obj.x/obj.y`,每次访问都会再叠加一次偏移
|
|
397
|
+
(连续调用 `get_objects()` 结果漂移);现在只在解析时换算一次。
|
|
398
|
+
|
|
399
|
+
### 新增(多世界 / World 贯穿)
|
|
400
|
+
- **`World` 贯穿到引擎核心、对象创建路径与输入/场景 API**,现在可以创建互不干扰的世界:
|
|
401
|
+
|
|
402
|
+
```python
|
|
403
|
+
from waligame import *
|
|
404
|
+
from waligame.config import World
|
|
405
|
+
|
|
406
|
+
w2 = World()
|
|
407
|
+
setup(800, 600, world=w2) # 只初始化 w2
|
|
408
|
+
hero = Character("hero.png", size=(32, 32), world=w2)
|
|
409
|
+
update(w2) # 只推进 w2
|
|
410
|
+
```
|
|
411
|
+
|
|
412
|
+
支持的接口:`setup(*size, world=w) / update(w) / done(w) / save_screen(name, w)`、
|
|
413
|
+
`Screen(size, world)`、`Camera(size, world)`、`NewGameObject`(及 `Character`/`Sensor`/`Wall`/`Mouse`)、
|
|
414
|
+
`TextBox`/`DialogBox`、`Sprite` 与各动画策略、`Body`/`TiledMapBodies`、
|
|
415
|
+
`events.get_mouse_*` / `key_just_pressed` / `key_input` / `key_just_released`、
|
|
416
|
+
`draw_line` / `set_gravity` / `debug` / `tracer` / `speed` / `random_pos` / `bgpic`、
|
|
417
|
+
`pygame2Cartesian` / `Cartesian2pygame`、`pymunk2Cartesian` / `from_pygame` / `NewDrawOptions`、
|
|
418
|
+
`Connect` / `connect`。**所有 `world` 参数都可省略**,缺省即默认世界 `global_var`(新增
|
|
419
|
+
`config.resolve_world()` 统一处理),因此既有代码与渲染输出**零变化**。
|
|
420
|
+
- `Camera` 不再是类级单例:原先第二个世界会共用同一个相机实例。现在每个世界一个相机
|
|
421
|
+
(`w.CAMERA`),显式 `Camera((w, h))` 会新建实例;在未 `setup()` 的世界创建相机会得到
|
|
422
|
+
中英双语报错,而不是一个半初始化的对象。
|
|
423
|
+
- 新增 `tests/world_test.py`(11 项):两个世界的容器、`setup` 目标、对象归属、`update` 只推进该世界、
|
|
424
|
+
`kill` 不影响他界、每世界一个相机、坐标换算、场景级 API、事件队列、旧用法不变。
|
|
425
|
+
|
|
426
|
+
### 修复(发布脚本,不进入 wheel/sdist)
|
|
427
|
+
- **发布后核验误报失败**(2.3.1 发布时实际触发):刚上传完,PyPI 的 JSON API 已经能看到新版本,
|
|
428
|
+
但 pip/uv 使用的 **simple 索引**仍在缓存/刷新(CDN 滞后),于是复验安装报
|
|
429
|
+
`there is no version of waligame==x.y.z`。现在发布后的索引安装改用 `--refresh`
|
|
430
|
+
(无 uv 时 pip 用 `--no-cache-dir`)并**自动重试 5 次、每次间隔 15 秒**;
|
|
431
|
+
若仍失败,提示会明确写出「此时上传已经成功,多半只是索引仍在刷新」。
|
|
432
|
+
- 新增 **`--verify-only`**:发布已完成(含「上传成功但最后一步核验失败」)时可单独、反复补跑核验,
|
|
433
|
+
不必重新构建或上传;本地没有 `dist/` 产物时自动跳过 sha256 比对。
|
|
434
|
+
用法:`python scripts/release.py --verify-only`
|
|
435
|
+
- 抽出 `install_command()` 便于测试;`tests/release_script_test.py` 增至 9 项检查
|
|
436
|
+
(新增 `--verify-only` 可用性、索引安装必须能绕过缓存)。
|
|
437
|
+
|
|
438
|
+
## [2.3.1] - 2026-09-14
|
|
439
|
+
|
|
440
|
+
阶段 B 第三切片第二部分(对象模型按职责拆成 mixin)+ 本地开发环境改用 uv 管理。
|
|
441
|
+
|
|
442
|
+
### 新增(本地开发 / 测试)
|
|
443
|
+
- **uv 配置管理**:新增 `[dependency-groups] dev`(PEP 735,`uv sync` 默认安装,与 `.[dev]` extra 等价)、
|
|
444
|
+
`.python-version`(3.9)与 `uv.lock`(按 `requires-python` 全范围解析,133 个包)。
|
|
445
|
+
本地一条命令建好隔离环境:`uv sync` → `uv run python scripts/check.py`。
|
|
446
|
+
不使用 uv 时 `pip install -e ".[dev]"` 仍然有效。
|
|
447
|
+
- **`scripts/check.py --matrix`**:用 `uv run --no-project --with pymunk==6.11.1` 现开临时环境,
|
|
448
|
+
自动跑 **pymunk 6.11.1 与最新版两遍**全部测试(整轮约 15 秒),不再需要手动维护两个 venv、
|
|
449
|
+
也不污染当前环境;`--matrix-only` 只跑矩阵。README 增加「本地开发与测试(uv)」章节。
|
|
450
|
+
|
|
451
|
+
### 修复
|
|
452
|
+
- **发布脚本路径拼接缺陷**(`scripts/release.py`):`discover_tests()` 改为返回完整文件名后,
|
|
453
|
+
`run_tests_in()` 仍按「基础名 + `.py`」拼路径,于是在「安装测试」阶段去找 `tests/demo.py` 并中止
|
|
454
|
+
(2.3.1 发布时实际触发)。现在路径不再二次拼接;依赖矩阵提到模块级常量 `PYMUNK_MATRIX`;
|
|
455
|
+
环境自检新增 `verify_test_paths()`,缺失的测试文件在**第 1 步**就报错,而不是等到第 5 步。
|
|
456
|
+
另新增 `tests/release_script_test.py`(6 项检查:测试文件发现与负向用例、版本读取一致性、
|
|
457
|
+
仓库/令牌配置、依赖矩阵覆盖旧版与最新版、产物校验规则),把这类问题挡在单元测试层。
|
|
458
|
+
- `requires-python` 由 `>=3.8` 修正为 **`>=3.8.1`**:3.8.0 起没有任何 flake8 版本可用,
|
|
459
|
+
原声明导致 `uv lock` 依赖求解失败(`flake8>=6.0` 与 Python 3.8.0 无解)。
|
|
460
|
+
运行时依赖(pygame / pymunk / pytmx)不受影响,3.8.x 仍受支持(会被解析到 pymunk 6.x)。
|
|
461
|
+
|
|
462
|
+
### 变更(内部结构)
|
|
463
|
+
- 新增 `waligame/animation.py`(`AnimationMixin`:`frame`/`state`/`dt`/`play_anim`/`set_dt`/
|
|
464
|
+
`set_next_state`/`set_start_func`/`set_end_func`)、`waligame/collision.py`(`CollisionMixin`:
|
|
465
|
+
`collide`/`separate`/`distance`)、`waligame/input.py`(`MouseInputMixin`:`get_mouse_clicked`/
|
|
466
|
+
`get_mouse_just_clicked`/`get_mouse_just_released`/`get_mouse_upon`)。
|
|
467
|
+
`objects.py` 从 798 行降到 606 行,只做组合;`NewGameObject`(及 `Character`/`Sensor`/`Wall`/`Mouse`)
|
|
468
|
+
的方法与语义完全不变,`from waligame import *` 仍导出同样的名字(641 个)。
|
|
469
|
+
- **等价性验证**:重构前后 76 项行为快照(三种碰撞路径——刚体/瓦片刚体/贴图 mask、帧动画与状态机、
|
|
470
|
+
鼠标点击与悬停)以及逐帧整屏像素哈希**逐字节一致**;pymunk 6.11.1 与 7.3.0 双环境全部测试通过。
|
|
471
|
+
- `tests/smoke_test.py` 新增「对象模型 mixin 职责拆分」检查:校验方法归属、
|
|
472
|
+
各对象类都组合了三个 mixin,并防止把已拆出的方法定义回 `objects.py`。
|
|
473
|
+
|
|
474
|
+
### 发现(未修复,已记入 `OPTIMIZATION_PLAN.md` 阶段 C)
|
|
475
|
+
- `separate(Vector2)` 仍会抛 `TypeError: unhashable type`:`_point_collision_dict` 兜底用的是普通 dict,
|
|
476
|
+
而 `pygame.math.Vector2` 不可哈希(传 tuple 正常)。
|
|
477
|
+
- `Character(imgs=[...])`(`ListSpriteStrategy`)没有 `set_next_state`/`set_start_func`/`set_end_func`,
|
|
478
|
+
调用即 `AttributeError`;这三个状态机接口只对 `AnimatorStrategy`(传状态字典)有效。
|
|
479
|
+
|
|
480
|
+
## [2.3.0] - 2026-09-14
|
|
481
|
+
|
|
482
|
+
体积优化:把 28.6 MB 的字体文件从发行包里拿掉,并让“没有字体”不再是崩溃。
|
|
483
|
+
|
|
484
|
+
### 变更(体积)
|
|
485
|
+
- **不再打包字体**:`simkai.ttf`(11.24 MB,TextBox/DialogBox 的默认字体)与
|
|
486
|
+
`simsun.ttc`(17.37 MB,**代码中从未引用**)移出 `src/waligame/static/`,
|
|
487
|
+
保留在仓库 `assets/legacy/`(含取回与子集化说明)。原因有两条:
|
|
488
|
+
1. **体积**:static/ 从 29 MB 降到 148 KB,wheel 从 15.8 MB 降到约 0.4 MB;
|
|
489
|
+
2. **授权**:两个字体都是微软/中易版权字体(字体元数据 nameID 13 明确限制再分发),
|
|
490
|
+
与项目自身的 MIT 许可不兼容,不适合再随包发布。
|
|
491
|
+
- 同时移出从未被引用的 `DialogBox1.png`、`DialogBox2.png`。
|
|
492
|
+
- 新增测试「包内 static/ 体积回归防护」:单个文件 < 3 MB、合计 < 4 MB,
|
|
493
|
+
防止完整版权字体被再次塞回。
|
|
494
|
+
|
|
495
|
+
### 新增
|
|
496
|
+
- **字体解析**(`waligame.fonts`):按 `显式路径 → 环境变量 WALIGAME_FONT →
|
|
497
|
+
包内 static/ → 操作系统中文字体 → pygame 默认字体` 的顺序解析。
|
|
498
|
+
把任意 ttf/ttc/otf 放进 `waligame/static/` 就会被自动使用,无需改代码。
|
|
499
|
+
- `fonts.font_info()`:打印当前字体来源,用于排查“中文显示成方框”;
|
|
500
|
+
`fonts.resolve_font()` / `resolve_font_path()` / `reset_font_cache()` 也对外可用。
|
|
501
|
+
- 跨平台候选字体表:Windows(微软雅黑/黑体/宋体/等线/楷体…)、
|
|
502
|
+
macOS(苹方/冬青黑体/黑体-简/宋体-简…)、Linux(Noto CJK/思源黑体/文泉驿/…)。
|
|
503
|
+
- 新增 `tests/font_test.py`(15 项检查):解析顺序、环境变量、警告只发一次、
|
|
504
|
+
完全无字体时不报错、TextBox/DialogBox 在无字体下仍可创建渲染、损坏字体报错、
|
|
505
|
+
三平台候选表齐全、static/ 体积回归防护。
|
|
506
|
+
|
|
507
|
+
### 修复
|
|
508
|
+
- **字体缺失不再抛异常**:此前 `TextBox` / `DialogBox` 在字体文件不存在时直接
|
|
509
|
+
`RuntimeError`,在没有装中文字体的 Linux / Docker / CI 上必崩。现在回退到系统字体或
|
|
510
|
+
pygame 默认字体,并只发一次中文+英文 `RuntimeWarning`(内容含“中文可能显示为方框”与解决办法)。
|
|
511
|
+
- **损坏字体提前报错**:pygame 构造 `Font` 时不解析字体文件,垃圾文件要等到 `render()`
|
|
512
|
+
才抛 `error: Passed a NULL pointer`(错误出现在画面刷新阶段,极难定位)。
|
|
513
|
+
现在加载时先量一次字宽,把“文件存在但不是字体”提前暴露:
|
|
514
|
+
显式指定的损坏字体给出中英双语 `RuntimeError`,系统/包内字体损坏则静默回退。
|
|
515
|
+
- `TextBox` / `DialogBox` 在未调用 `setup()` 时给出中英双语 `RuntimeError`
|
|
516
|
+
(“创建文本框前必须先调用 setup(宽, 高)”)。此前抛出的是晦涩的
|
|
517
|
+
`TypeError: Sprite.add() argument after * must be an iterable, not NoneType`,
|
|
518
|
+
并且会被中文报错助手误判成“waligame 内部缺陷”。
|
|
519
|
+
- `DialogBox.say(text)` 不传颜色时不再把 `None` 写进颜色(此前直接使用 `DialogBox`
|
|
520
|
+
会在 `update()` 里抛 `TypeError: invalid color argument`;
|
|
521
|
+
经由 `Character.say()` 调用时因为默认传了 `(0,0,0)` 才没暴露)。
|
|
522
|
+
|
|
523
|
+
### 变更(行为)
|
|
524
|
+
- `TextBox(size)` 与 `DialogBox` 默认字体由“包内 simkai.ttf”改为**自动解析**;
|
|
525
|
+
`TextBox(font=None)` 以前表示“pygame 默认字体”,现在表示“自动选择中文字体”
|
|
526
|
+
(解析不到时仍然回落到 pygame 默认字体,与旧行为一致)。
|
|
527
|
+
- `NewGameObject.DialogBox_font` 默认值由字体路径改为 `None`(自动);显式赋值仍然生效。
|
|
528
|
+
- 文本渲染结果可能因平台字体不同而变化(Windows 微软雅黑 / macOS 苹方 / Linux Noto CJK)。
|
|
529
|
+
|
|
530
|
+
## [2.2.0] - 2026-09-13
|
|
531
|
+
|
|
532
|
+
教学增强:中文报错提示。
|
|
533
|
+
|
|
534
|
+
### 新增
|
|
535
|
+
- **中文报错助手**(`waligame.error_help`):在**完整保留英文原始报错**(异常类型、消息、完整 traceback)
|
|
536
|
+
的前提下,于其后追加中文解释(「原因 / 解决 / 参考」)。导入 `waligame` 时自动安装
|
|
537
|
+
(`sys.excepthook`),可用环境变量 `WALIGAME_ERROR_HELP=0` 或 `set_error_help(False)` 关闭;
|
|
538
|
+
`explain_exception(exc)` 可在 `try/except` 中主动获取中文解释。
|
|
539
|
+
- 覆盖 **17 条规则**(对应 20 项自动化检查):缺少依赖、名字未定义(按键/事件常量有专项提示,指向 2.1.0 的修复)、
|
|
540
|
+
忘记 `setup()`、资源文件找不到、音频设备不可用、pymunk 坐标类型错误、pymunk 7 无交点断言、
|
|
541
|
+
`key_pressed("w")` 传字符串、图片类型不支持、`setup()` 参数错误、Tab/空格混用、缩进与语法错误、
|
|
542
|
+
除零、全局变量作用域、递归过深等;若报错发生在 waligame 内部,会给出"可能是框架问题 + 如何反馈"兜底。
|
|
543
|
+
- 框架自身抛错改为**中英双语**:`setup()` 参数校验;未 `setup()` 就创建对象(原先是一个难懂的
|
|
544
|
+
pygame `TypeError`,现在直接提示"请先调用 setup(宽, 高)");`load_image` / `load_font` / `load_sound` 失败提示。
|
|
545
|
+
- 新增 `tests/error_help_test.py`(20 项检查):覆盖规则匹配、钩子输出(英文保留 + 中文追加 + 顺序)、开关与卸载
|
|
546
|
+
往返、双语框架错误、公共 API;测试"已安装的旧版本"时自动跳过。
|
|
547
|
+
|
|
548
|
+
### 变更
|
|
549
|
+
- `scripts/check.py` 改为自动发现 `tests/*_test.py`(新增测试文件无需再登记)。
|
|
550
|
+
- 公共 API 新增 5 个名字:`install_error_help`、`uninstall_error_help`、`set_error_help`、
|
|
551
|
+
`is_error_help_enabled`、`explain_exception`(78 → 83 个框架名字,另有 558 个 pygame 常量)。
|
|
552
|
+
|
|
553
|
+
## [2.1.0] - 2026-09-13
|
|
554
|
+
|
|
555
|
+
阶段 B 第三切片(第一部分):拆分对象模型模块;并修复 2.0.0 引入的按键常量回归。
|
|
556
|
+
|
|
557
|
+
### 修复
|
|
558
|
+
- **恢复 pygame 事件/按键常量的导出**。2.0.0 用 `__all__` 收口公共 API 时遗漏了 `K_*`、`KEYDOWN`、
|
|
559
|
+
`QUIT`、`MOUSEBUTTONDOWN`、`KMOD_*` 等常量,导致既有项目在 `from waligame import *` 之后的
|
|
560
|
+
按键判断失效(例如 `K_SPACE` 未定义)。这些常量现在重新随星号导入提供;但**只补常量**,
|
|
561
|
+
仍不会像 1.x 那样把 `os` / `time` / `random` / `pygame` / `pymunk` 等模块对象一并导出。
|
|
562
|
+
公共 API 现为:**78 个框架名字 + 558 个 pygame 常量 = 636 个**。
|
|
563
|
+
- README 的按键示例原先写作 `key_pressed("w")`(传入字符串会触发 `TypeError`),
|
|
564
|
+
已改为 `K_UP` / `K_LEFT` / `K_SPACE` 等常量。
|
|
565
|
+
- `tests/smoke_test.py` 增加回归用例:校验按键常量已导出、模块对象未导出,且
|
|
566
|
+
`key_pressed(K_SPACE)` / `key_just_pressed(K_LEFT)` 可正常调用。
|
|
567
|
+
|
|
568
|
+
### 变更(内部结构;框架 API 名称与渲染结果不变)
|
|
569
|
+
- `API.py` 从 986 行瘦身为 **211 行门面**:只做三件事——聚合公共 API(`__all__`)、转发各模块入口、
|
|
570
|
+
提供场景级工具函数(`bgpic` / `load_image` / `tracer` / `speed` / `debug` / `set_gravity` / `random_pos`)。
|
|
571
|
+
- 新增 `objects.py`(796 行):`NewGameObject` 及其子类 `Character` / `Sensor` / `Wall` / `Mouse` 的实现。
|
|
572
|
+
- 两个模块级可变全局 `IS_UPDATED` / `SPEED` 收敛进 `World`(`global_var.IS_UPDATED` / `global_var.SPEED`);
|
|
573
|
+
`tracer()` / `speed()` 仍保留同名模块级镜像,既有代码不受影响。
|
|
574
|
+
- `sign()` 移入 `facilitate.py`、`set_mouse_visible()` 移入 `events.py`(拆分后对象模型需要它们,
|
|
575
|
+
这样可避免 `objects.py` 反向依赖 `API.py` 形成循环导入)。
|
|
576
|
+
- 验证:`waligame.__all__` 仍为 78 个名字且无缺失;11 帧像素回归与 1.0.2 基线一致;
|
|
577
|
+
pymunk 6.11.1 与 7.3.0 下冒烟 + demo(含 `waligame-demo` 入口点)测试全通过;
|
|
578
|
+
black / flake8 / mypy 全绿。
|
|
579
|
+
|
|
580
|
+
## [2.0.0] - 2026-09-13
|
|
581
|
+
|
|
582
|
+
阶段 B 第二切片:模块边界与公共 API 收口。
|
|
583
|
+
|
|
584
|
+
> 本版含**破坏性变更**,故按语义化版本升到主版本 2.0.0。
|
|
585
|
+
|
|
586
|
+
### 变更(破坏性)
|
|
587
|
+
- **`from waligame import *` 不再泄漏无关名字**。此前它会把 `os` / `time` / `random` / `math` / `sys` /
|
|
588
|
+
`pygame` / `pymunk` 以及 pygame 的数百个事件与按键常量一并导入用户命名空间(实测约 660 个名字)。
|
|
589
|
+
现在公共 API 由 `waligame.__all__` 显式定义(78 个名字)。依赖这些“顺带可用”名字的代码需要自行导入:
|
|
590
|
+
|
|
591
|
+
```python
|
|
592
|
+
import os, random # 原先靠星号导入顺带可用
|
|
593
|
+
from pygame.locals import K_LEFT, QUIT, KEYDOWN # 事件/按键常量
|
|
594
|
+
```
|
|
595
|
+
|
|
596
|
+
仓库内的 `demo/demo.py` 已同步补上 `import os, random`。
|
|
597
|
+
|
|
598
|
+
### 变更(内部结构)
|
|
599
|
+
- **消除内部星号导入链**:原先 13 个模块都靠 `from .config import *` 拿到 `pygame` / `pymunk` / `os` /
|
|
600
|
+
`time` / `vec` / `global_var` 等,现在全部改为显式导入;`config.py` 收敛为核心
|
|
601
|
+
(`vec`、`to_cp`、`init`、`World`、`global_var`、坐标换算),不再顺带引入 pygame 事件常量。
|
|
602
|
+
- 因此 flake8 得以开启 **F401(未使用导入)** 与 **F821(未定义名)** 检查,并在重构中抓到两处真实缺陷:
|
|
603
|
+
- `API.py` 的鼠标点击 API 用了未导入的 `MOUSEBUTTONDOWN` / `MOUSEBUTTONUP`(调用即 `NameError`)
|
|
604
|
+
- `waligame.test`(`waligame-demo` 入口)用了未导入的 `os`
|
|
605
|
+
- `.flake8` 现在只为“包门面 + 测试/基准脚本”的星号导入关闭 F403/F405。
|
|
606
|
+
|
|
607
|
+
### 新增
|
|
608
|
+
- `scripts/check.py`:本地一键校验(black / flake8 / mypy + 测试),替代托管 CI。
|
|
609
|
+
- `RELEASING.md`:发布流程说明;PyPI 令牌放在本地 `.pypi-token`(已加入 `.gitignore`,权限 600)。
|
|
610
|
+
- `tests/smoke_test.py` 增加鼠标交互 API 覆盖(正是上面 F821 缺陷所在的路径)。
|
|
611
|
+
|
|
612
|
+
### 移除
|
|
613
|
+
- `.github/workflows/ci.yml`(项目不托管在 GitHub,改由 `scripts/check.py` 在本机完成同样的事)。
|
|
614
|
+
- `pyproject.toml` 与 README 中的占位 GitHub 地址(`github.com/yourusername/...`);
|
|
615
|
+
`Project-URL` 现在只指向 PyPI。
|
|
616
|
+
|
|
617
|
+
## [1.1.0] - 2026-09-13
|
|
618
|
+
|
|
619
|
+
阶段 B(结构调整与工程化)第一切片。
|
|
620
|
+
|
|
621
|
+
### 变更(需留意)
|
|
622
|
+
- **`import waligame` 不再有副作用**:`pygame` / `mixer` / `font` 的初始化改由 `setup()`
|
|
623
|
+
(或显式调用 `waligame.init()`)完成。
|
|
624
|
+
- 好处:无显示器 / 无声卡的环境(CI、服务器、纯逻辑测试)可以正常导入本包,
|
|
625
|
+
原先会在导入期抛 `pygame.error`。
|
|
626
|
+
- 注意:若在 `setup()` 之前调用 `bgmusic()`、`load_font()` 等依赖子系统的接口,
|
|
627
|
+
请先调用 `setup()`。
|
|
628
|
+
- 没有可用音频设备时不再中断初始化:`waligame.audio_available` 为 `False`,
|
|
629
|
+
图形与逻辑仍可正常工作(音乐/音效接口会报 pygame 自身的错误)。
|
|
630
|
+
|
|
631
|
+
### 新增
|
|
632
|
+
- `waligame.World`:世界状态容器类;`global_var` 现在是**默认世界实例**
|
|
633
|
+
(名字保留为兼容别名,既有代码无需改动)。
|
|
634
|
+
- `waligame.init()`:幂等的 pygame/mixer/font 初始化入口。
|
|
635
|
+
- 版本号单一来源 `waligame._version.__version__`,`pyproject.toml` 经 dynamic version 读取。
|
|
636
|
+
|
|
637
|
+
### 修复
|
|
638
|
+
- `TiledMapBodies` 中最后一处裸 `except:`:对象创建失败时不再使用未定义的 `body`
|
|
639
|
+
(原先首个对象失败会抛 `NameError`),并去掉内建名 `dict` 的遮蔽、把配对去重从
|
|
640
|
+
O(n³) 的列表扫描改为集合。
|
|
641
|
+
- **`waligame-demo` 入口(`waligame.test:main`)在 pymunk 6/7 下都会崩溃**,两处 API 用法过时:
|
|
642
|
+
`space.add(list)` 需展开为 `space.add(*list)`;`Vec2d(seq)` 需展开为 `Vec2d(*seq)`。
|
|
643
|
+
新增的入口点集成测试会真正启动该命令并确认其持续运行、无异常。
|
|
644
|
+
|
|
645
|
+
### 工程化
|
|
646
|
+
- 新增 `.flake8`、`[tool.black]`、`[tool.mypy]`、`[tool.pytest.ini_options]` 配置,并补充 `dev` 依赖说明。
|
|
647
|
+
- 新增 `tests/conftest.py`:pytest 环境下自动使用 SDL dummy 驱动,测试无需手动设环境变量。
|
|
648
|
+
- 新增 GitHub Actions CI 骨架:Ubuntu/macOS/Windows × Python 3.9–3.13 × pymunk 6.11.1/7.3.0。
|
|
649
|
+
|
|
650
|
+
## [1.0.3] - 2026-09-13
|
|
651
|
+
|
|
652
|
+
阶段 A(性能与正确性)。
|
|
653
|
+
|
|
654
|
+
### 性能
|
|
655
|
+
- 精灵变换结果按视觉状态缓存,取消每帧无条件 `.copy()`:200×512² 精灵
|
|
656
|
+
`update()+draw()` 16.17 → 6.15 ms/帧。
|
|
657
|
+
- 相机画面无变化时整帧跳过重绘与上屏(静态场景 ~0.6 → 0.005 ms/帧);
|
|
658
|
+
`scl == 1` 时省掉整屏重采样。
|
|
659
|
+
- 物理不再每帧把刚体位置回写自身:100 刚体 reindex 103 次/帧 → **0**。
|
|
660
|
+
- `collide()` 接入 `ResourceManager.get_mask()` 缓存:0.92 → 0.003 ms/次。
|
|
661
|
+
- `TextBox` / `DialogBox` 按内容缓存渲染结果,层级只在内容变化时调整。
|
|
662
|
+
- 物理改用固定步长累加器,与渲染帧率解耦(原 `step(1/60)` 与 `tick(40)` 不匹配,
|
|
663
|
+
实际以 0.67 倍速运行)。
|
|
664
|
+
|
|
665
|
+
### 修复
|
|
666
|
+
- **pymunk 7 兼容**:`ContactPointSet` 在无交点时会断言失败,`Body.collide()` /
|
|
667
|
+
`TiledMapBodies.collide()` 现按"未碰撞"处理(pymunk 6.11.1 与 7.3.0 双版本验证)。
|
|
668
|
+
- **pygame 脏矩形启发式**:`LayeredDirty` 自动切换模式会让静态 `TextBox`/`DialogBox`
|
|
669
|
+
只被部分绘制(文字消失),新增 `FullRedrawLayeredDirty` 固定全量 blit。
|
|
670
|
+
- `cursor.py` 导入了不存在的 `.event` 模块且未导入 `Sensor`/`TextBox`。
|
|
671
|
+
- `test.py` 缺少 `config` 导入、静态资源路径依赖 cwd,导致 `waligame-demo` 入口不可用。
|
|
672
|
+
- `music_queue()` 缺少参数、`music_set_endevent()` 无法取消、`draw_options.from_pygame()`
|
|
673
|
+
调用了未定义的 `to_pygame()`。
|
|
674
|
+
- `global_var.set_value/get_value` 恒操作名为 `var` 的属性;`play_snd` 的 20 路音效上限未生效。
|
|
675
|
+
- mask 缓存以 `id(surface)` 为 key 会串味且不同阈值互相覆盖;`separate()` 改用弱引用字典,
|
|
676
|
+
避免长期运行内存增长。
|
|
677
|
+
|
|
678
|
+
### 工程
|
|
679
|
+
- 目录改为标准 `src/` 布局,新增 `tests/`、`benchmarks/`(均不参与打包)。
|
|
680
|
+
|
|
681
|
+
## [1.0.2] - 2026-09-10
|
|
682
|
+
|
|
683
|
+
### 修复
|
|
684
|
+
- 修复 pygame `Vector2` 直接传给 pymunk 导致 `TypeError: initializer for ctype 'struct cpVect' ...`:
|
|
685
|
+
新增 `config.to_cp()`,所有坐标边界统一转换。
|
|
686
|
+
- 兼容 pymunk 6 的 `PointQueryInfo.distance`(原先取 `[0]` 得到的是 shape)。
|
|
687
|
+
- `NewGameObject` 默认 `body_type` 为 pymunk 常量时无法工作。
|
|
688
|
+
- 补齐打包元数据(`pyproject.toml` / `README.md` / `LICENSE` / `MANIFEST.in`),
|
|
689
|
+
移除指向不存在模块的入口点(`waligame-editor`、`waligame.plugins`)。
|
|
690
|
+
|
|
691
|
+
## [1.0.1] - 2026-04-13
|
|
692
|
+
|
|
693
|
+
首个公开版本。
|