diff --git a/.gitignore b/.gitignore
index 00ec01d..13083fb 100644
--- a/.gitignore
+++ b/.gitignore
@@ -9,6 +9,17 @@ __pycache__
 *.pyo
 *.pyd
 
+# 工具缓存与本地工作目录——不进版本库，也不该进分发包
+# (.pytest_cache/.ruff_cache 此前漏配：跑一次测试就会在 git status 里冒出来，
+#  一旦有人习惯性 `git add -A` 就会被提交)
+.pytest_cache/
+.ruff_cache/
+.pyright/
+.workbuddy/
+
+# _mkpkg.py 会在项目根写入打包标记文件（内容为文件数/体积或 public 标记）
+_pkg_ok.txt
+
 # 运行时敏感数据与私有文档——公开包买家若将本项目纳入 git 管理，
 # 以下内容绝不能进版本库（用户数据库/网易云 Cookie/日志/审计文档）
 data/