SublimeHistoryClear

简体中文 ENGLISH

一个用于 Sublime Text 的轻量级插件，在程序关闭时自动清空用户的历史记录，包括文件、文件夹、查找与替换等历史项，从而保护隐私与保持工作环境整洁。

特性

• 自动检测 Sublime Text 版本（Sublime Text / Sublime Text 3）；
• 支持清理以下记录：
  • file_history
  • folder_history
  • find_history
  • replace_history
• 递归遍历配置文件结构；
• 以格式化方式回写 JSON，保持文件可读性；
• 异常处理完整，避免因文件占用导致错误。

目录结构

Sublime Text/Packages/User/
├── SublimeHistoryClear.py

安装与使用

1. 将 SublimeHistoryClear.py 放入 Sublime Text 的 Packages/User/ 目录；
2. 重启 Sublime Text；
3. 插件会在程序关闭时自动执行清理操作；
4. 查看控制台输出以确认清理结果。

使用说明

• 插件在关闭 Sublime 时自动触发；
• 若发现日志输出“无法读取文件”，表示文件可能被系统占用；
• 支持 Windows 环境，通过 APPDATA 环境变量定位 Session 文件路径。

开发与构建

• 语言：Python 3.x（Sublime 插件环境）
• 关键模块：sublime, sublime_plugin, os, json
• 无需额外依赖，直接加载即可运行。

兼容性与已知问题

• 仅支持 Windows 系统；
• 不支持 Sublime Text Portable 版本；
• macOS/Linux 下路径结构不同，后续可添加支持。

版本与升级

2025-10-14版本更新：

• 首次发布版本；
• 新增自动清理 Session.sublime_session 和 Auto Save Session.sublime_session；
• 优化递归清理逻辑；
• 增加文件占用处理与错误提示。

……以往更新不再记录……

许可证与署名（允许商用，但必须注明出处）

为确保"允许商用 + 必须署名"，本项目采用双许可证：

1. 代码 — Apache License 2.0 © 2025 Hellowind

   • 允许商业使用。要求在分发中保留 LICENSE 与 NOTICE 信息（版权与许可说明）。
   • 在你的分发包中加入 NOTICE（示例）：

     本产品包含 "HelloAGENTS"（作者：Hellowind），依据 Apache License 2.0 授权。
     

2. 文档（README/PROJECTWIKI/图表） — CC BY 4.0 © 2025 Hellowind

   • 允许商业使用，但必须署名；需给出许可链接并标注是否做了修改。
   • 复用文档时建议的署名例句：

     文本/图表改编自 "HelloAGENTS" —— © 2025 Hellowind，CC BY 4.0。
     

3. 统一署名建议（代码与文档皆可）：

     HelloAGENTS — © 2025 Hellowind. 代码：Apache-2.0；文档：CC BY 4.0。