docs: 为全部13个源码模块和5个测试文件添加简体中文注释

- 每个文件补充模块级 docstring、类/函数 docstring、关键逻辑行内注释
- 注释风格："中文说明" 或 # 中文说明
- 代码结构和逻辑完全不变

a1_swap_mod_packer/core.py

@@ -1,3 +1,9 @@
+"""核心公开 API 模块。
+
+作为 a1_swap_mod_packer 包的统一入口，通过 __all__ 列表集中导出
+所有对外公开的符号（类、函数、常量），方便外部调用者从一个模块导入所有所需接口。
+"""
+
 from __future__ import annotations
 
 from .archive import GCODE_MEMBER_RE, MD5_MEMBER_RE, list_gcode_members
@@ -57,6 +63,7 @@ from .planning import (
     three_mf_summary_from_mapping,
 )
 
+# 公开 API：集中管理所有对外的符号导出
 __all__ = [
     "DEFAULT_INSERT_BEFORE_MARKER",
     "DEFAULT_OUTPUT_PATTERN",