PandaX v0.7.1 - Code Audit and File Protection

PandaX v0.7.1 — Release Notes

Release date: 2026-09-10
Status: Stable
Python: 3.8+
Platforms: Windows / macOS / Linux

---

🎯 What's New

PandaX v0.7.1 是 v0.7.0 之后的安全与稳定性加固版本。重点是消除 v0.7.0 引入的几处安全漏洞、改进错误处理鲁棒性、并完成剩余模块的国际化（i18n）覆盖。

🐛 Bug 修复（11 个）

P0 安全类

• Bug #1: desktop_icon.py 5 处 os.system 命令注入
  → 用 ctypes.windll.kernel32.SetFileAttributesW 直接调 Windows API
• Bug #17: cli.py 5 处 f-string JSON 注入（用户输入含反斜杠/双引号时破坏 JSON）
  → 全部改用 json.dumps(..., ensure_ascii=False)

P1 鲁棒性

• Bug #16: cli.py 6 处 json.loads 无 try/except
  → 加 (JSONDecodeError, OSError) 捕获，友好错误 + 正确 return code
• Bug #18: cli.py 3 处 subprocess.run 无 TimeoutExpired 捕获
  → 加 try/except，超时返回 None 或 124（标准 timeout exit code）

P1 i18n

• Bug #11/12/10/13: cli.py 4 处硬编码中文/英文 + 死代码
  → 全用 t() 替换，移除 in dir(__builtins__) 永远为 False 的 dead branch

P2 i18n 化

• desktop_icon.py + gitignore_helper.py 加 i18n 集成（之前 2 个模块完全无 i18n）

P3 测试

• test_i18n.py 加 8 个回归测试：
  • t() with backslash / double quote / CJK / None / extra kwargs
  • zh-CN ↔ en keys parity 严格相等
  • 扫描 src/pandax 全部 t() 调用，断言 0 个 undefined key

🌍 i18n 同步

• zh-CN 248 keys ↔ en 246 keys（修复前 zh-CN 缺 11 个 key + 几个 key 不一致）
• 新增 16 个 key（zh-CN + en 各 8 份）

📊 测试结果

全部 340 个测试通过
  - baseline 332 + 新增 8 个 t() 鲁棒性测试
0 个 missing keys (修复前 11 个)
66 个 dead keys (已记录，不影响功能)

📦 安装

pip（推荐）

pip install pandax==0.7.1

下载安装包

下载附件 PandaX-0.7.1-install.zip，解压后运行：

Windows:

.\install.bat

macOS / Linux:

bash install.sh

源码开发模式

git clone https://github.com/hellob1889/PandaX.git
cd PandaX
pip install -e .

🛡️ 安全声明

v0.7.1 是第一个经过对抗式复查的版本：

• 所有用户输入路径都通过 AST 复查确认 try/except 正确
• 所有 subprocess.run 都加 TimeoutExpired
• 所有 JSON 序列化都使用 json.dumps 而非 f-string
• 所有国际化字符串都通过 t() 而非硬编码

🐞 已知问题

• P3: _DEFAULT_FP_PASSWORD = "0000" 是演示默认值，生产环境必须用环境变量覆盖（已有测试守门）
• P3: D:\软件\Git\cmd\git.exe 仍是 Windows 上 Git 路径的候选 fallback（已在 examples/ 中改为 shutil.which("git")，但 src/pandax/ 中保留作为 fallback）

🤝 贡献

欢迎提交 Issue 和 PR：

• 仓库: https://github.com/hellob1889/PandaX
• 文档: README.md
• 审计防御层: 7 层（L1 file chmod → L7 CI）

📝 License

MIT