python-toolbox Files

✨ 新功能：4 项、🐛 Bug 修复：1 项

变更日志

对比范围 v2.0.5 → v2.0.6

✨ 新功能

• 侧边栏折叠动画支持子控件淡入淡出及快捷键

  • 折叠时子控件随宽度动画同步淡出（150ms），展开后淡入
  • 折叠态按钮左侧加 primary 色装饰线，提示可点击展开
  • 新增 Ctrl+B 快捷键切换侧边栏
  • 按钮增加 :pressed 按压态反馈
  • 修复展开淡入期间动画对象被 GC 导致内容不可见的问题
  • 修复快速折叠/展开时 opacity effect 残留导致控件闪烁的问题
  • 修复展开淡入期间动画状态未锁定导致的竞态问题

• 侧边栏折叠按钮改用 QPainter 绘制矢量图标

  • 用 QPainterPath 绘制圆角 chevron 箭头，替代 Unicode 字符 ◀/▶
  • 箭头背后增加半透明圆角容器背景（pill/badge 样式）
  • 使用主题 primary 色作为图标颜色，hover 时加亮
  • 通过 eventFilter 实现 hover 时图标颜色切换
  • 按钮 hover 背景改用 primary 半透明 tint，与图标协调
  • 修复初始化时 _current_theme 未设置的问题

• 文件夹选择控件改为只读并支持拖拽

  • 新增 DirectoryDropLineEdit 类，继承 QLineEdit
  • 内置只读模式，防止用户手动编辑
  • 支持从文件资源管理器拖拽文件夹到输入框
  • 提取 _set_folder() 私有方法，统一 browse 和拖拽的路径设置逻辑

• 文件列表增加拖拽提示水印和按钮旁标签

  1. 表格容器改为 QStackedWidget，空表时显示居中的水印提示： 「拖拽文件到此处，或点击下方「添加文件」」，有文件后自动消失
  2. 按钮区域右侧增加「💡 支持拖拽」小标签，持续提醒用户
  3. 水印和标签均随主题切换更新颜色，与表格样式一致

🐛 Bug 修复

• 修复 FileListPanel 在 QStackedWidget 中拖拽失效

  表格放入 QStackedWidget 后，空表时表格隐藏导致不接收拖拽事件。 水印可见但未安装事件过滤器，拖拽无任何响应。 修复： 1. 水印 widget 调用 setAcceptDrops(True) 2. 在 watermark_widget 和 table 上均安装事件过滤器 3. eventFilter 同时处理两者，并增加 DragMove 事件支持

📝 文档更新

• 更新文档并修复 SelectableLabel 合规问题

  CLAUDE.md: - ToolboxWindow 侧边栏描述增加折叠/展开、动画、快捷键说明 - 新增 SidebarToggleIcon 到共享组件表 - menu_system.py 标注为 legacy demo README.md: - 通用特性新增「侧边栏折叠」 toolbox.py: - logo_text、version_label 改用 SelectableLabel（Rule 7 合规）

• fix MD047 trailing newline in CODE_OF_CONDUCT.md and CONTRIBUTING.md
• 添加社区标准文件（CODE_OF_CONDUCT、CONTRIBUTING、Issue/PR 模板）

📦 其他变更

• release v2.0.6

  • 更新 APP_VERSION 至 2.0.6
  • CHANGELOG.md 新增 v2.0.6 条目，链接移至文件末尾
  • 用户手册.md 同步更新版本号和操作说明
  • version_info.txt 同步版本号
  • CLAUDE.md 新增 cliff.toml 路径和发布流程说明
  • 新增 cliff.toml：git-cliff changelog 生成配置

• 将拖拽提示整合到「添加文件」按钮文字中

  按钮文字从「添加文件」改为「添加文件(💡支持拖拽)」， 移除独立的 drag_hint 标签，UI 更简洁。

• Merge pull request [#9] from yansheng836/dependabot/pip/pillow-gte-12.3.0

  chore(deps): update pillow requirement from >=12.2.0 to >=12.3.0

• Merge pull request [#8] from yansheng836/dependabot/pip/pymupdf-gte-1.28.0

  chore(deps): update pymupdf requirement from >=1.27.2.3 to >=1.28.0

• update pillow requirement from >=12.2.0 to >=12.3.0

  Updates the requirements on pillow to permit the latest version. - Release notes - Changelog - Commits

  ---

  updated-dependencies: - dependency-name: pillow dependency-version: 12.3.0 dependency-type: direct:production ... Signed-off-by: dependabot[bot] support@github.com

• update pymupdf requirement from >=1.27.2.3 to >=1.28.0

  Updates the requirements on pymupdf to permit the latest version. - Release notes - Changelog - Commits

  ---

  updated-dependencies: - dependency-name: pymupdf dependency-version: 1.28.0 dependency-type: direct:production ... Signed-off-by: dependabot[bot] support@github.com

• Merge pull request [#6] from yansheng836/dependabot/pip/pyinstaller-gte-6.21.0

  chore(deps): update pyinstaller requirement from >=6.20.0 to >=6.21.0

• update pyinstaller requirement from >=6.20.0 to >=6.21.0

  Updates the requirements on pyinstaller to permit the latest version. - Release notes - Changelog - Commits

  ---

  updated-dependencies: - dependency-name: pyinstaller dependency-version: 6.21.0 dependency-type: direct:production ... Signed-off-by: dependabot[bot] support@github.com

下载

相关链接

• 官方网站
• 问题反馈
• 更新日志