[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80157":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":13,"stars30d":13,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":15,"rankGlobal":8,"rankLanguage":8,"license":16,"archived":17,"fork":17,"defaultBranch":18,"hasWiki":19,"hasPages":17,"topics":20,"createdAt":8,"pushedAt":8,"updatedAt":21,"readmeContent":22,"aiSummary":23,"trendingCount":14,"starSnapshotCount":14,"syncStatus":24,"lastSyncTime":25,"discoverSource":26},80157,"FileToolkit","AKYMYK\u002FFileToolkit","AKYMYK",null,"Python",52,5,48,1,0,39.93,"MIT License",false,"main",true,[],"2026-06-12 04:01:26","# FileToolkit\n\n一个轻量级、多功能的文件处理工具箱，支持文件加密、编码转换、批量重命名、哈希计算、文件分割合并、备份清理及目录分析等 **10 多项独立功能**。  \n既可作为**命令行工具**直接使用，也可作为Python 库被其他项目引用。\n\n## 主要功能\n\n| 功能 | 描述 | 所属模块 |\n|------|------|----------|\n| 加密\u002F解密 | 使用 AES-CBC 对任意文件加密\u002F解密 | `encryptor.py` |\n| 编码转换 | 自动检测编码并转换为 UTF-8\u002FGBK 等 | `converter.py` |\n| 批量重命名 | 前缀、后缀、序号、替换、正则等规则 | `renamer.py` |\n| 哈希计算 | 计算 MD5\u002FSHA1\u002FSHA256\u002FSHA512 并验证 | `hasher.py` |\n| 文件分割\u002F合并 | 按大小或份数分割文件，再合并还原 | `splitter.py` |\n| 备份 | 备份文件或目录，支持时间戳 | `backup.py` |\n| 目录清理 | 删除空目录、临时文件、过期文件、指定后缀文件 | `cleaner.py` |\n| 文件信息 | 统计目录大小、各后缀数量、最大文件、文件时间 | `fileinfo.py` |\n\n所有功能既可通过命令行单独调用，也可在 Python 代码中 `import filetoolkit` 直接使用。\n\n## 安装\n\n### 方式一：从源码安装（推荐）\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FAKYMYK\u002FFileToolkit.git\ncd FileToolkit\npip install .\n```\n\n安装后将获得 `filetoolkit` 命令行工具。\n\n### 方式二：直接使用（开发者模式）\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FAKYMYK\u002FFileToolkit.git\ncd FileToolkit\npip install -r requirements.txt\npython -m filetoolkit.cli --help\n```\n\n### 依赖\n\n- Python >= 3.8\n- pycryptodome（文件加密）\n- chardet（编码检测）\n\n详见 [requirements.txt].\n\n## 命令行使用示例\n\n所有命令均以 `filetoolkit` 开头，后跟子命令。省略 `--help` 可查看每个子命令的详细信息。\n\n### 加密\n```bash\nfiletoolkit encrypt --input secret.docx --output secret.enc --password mypassword\n```\n\n### 解密\n```bash\nfiletoolkit decrypt --input secret.enc --output decrypted.docx --password mypassword\n```\n\n### 编码转换（自动检测源编码）\n```bash\nfiletoolkit convert --input gbk_article.txt --output utf8_article.txt --to utf-8\n```\n\n### 批量重命名（预览模式）\n```bash\nfiletoolkit rename --folder .\u002Fphotos --prefix vacation_ --start-index 1 --preview\n```\n\n### 哈希计算\n```bash\nfiletoolkit hash --input archive.zip --algorithm sha256\n```\n\n### 文件分割（按 10MB 每个块）\n```bash\nfiletoolkit split --input bigfile.tar.gz --size 10485760\n```\n\n### 文件合并\n```bash\nfiletoolkit merge --parts bigfile.tar.gz.part0001 bigfile.tar.gz.part0002 --output bigfile.tar.gz\n```\n\n### 备份目录（自动加时间戳）\n```bash\nfiletoolkit backup --input .\u002Fdocs --backup-dir .\u002Fbackups\n```\n\n### 清理临时文件（仅预览）\n```bash\nfiletoolkit clean temp --directory .\u002Fproject --execute  # 加 --execute 真正执行\n```\n\n### 目录报告\n```bash\nfiletoolkit fileinfo report --directory .\u002Fdata\n```\n\n### 查看文件时间信息\n```bash\nfiletoolkit fileinfo age --file .\u002FREADME.md\n```\n\n## 作为库引用（第三方调用）\n\n```python\nfrom filetoolkit.encryptor import encrypt_file\nfrom filetoolkit.hasher import compute_hash\nfrom filetoolkit.cleaner import delete_temp_files\n\n# 加密文件\nencrypt_file(\"report.pdf\", \"report.enc\", \"secure123\")\n\n# 计算文件哈希\nprint(compute_hash(\"report.pdf\"))\n\n# 清理临时文件（干运行）\ndeleted = delete_temp_files(\"\u002Ftmp\", dry_run=True)\nprint(deleted)\n```\n\n更多接口可直接参考各模块函数签名。\n\n## 项目结构\n\n```\nFileToolkit\u002F\n├── README.md\n├── LICENSE\n├── requirements.txt\n├── setup.py\n├── filetoolkit\u002F\n│   ├── __init__.py\n│   ├── cli.py                \n│   ├── encryptor.py\n│   ├── converter.py\n│   ├── renamer.py\n│   ├── hasher.py\n│   ├── splitter.py\n│   ├── backup.py\n│   ├── fileinfo.py\n│   ├── cleaner.py\n│   ├── utils.py\n│   ├── exceptions.py\n│   └── constants.py\n└── tests\u002F                    \n    ├── test_encryptor.py\n    ├── test_converter.py\n    ├── test_renamer.py\n    ├── test_hasher.py\n    ├── test_splitter.py\n    ├── test_backup.py\n    ├── test_fileinfo.py\n    └── test_cleaner.py\n```\n\n## 安全声明\n\n本项目**未植入任何恶意代码**，不会：\n\n- 访问网络\n- 读取或修改用户指定范围之外的任何文件\n- 执行动态代码（无 `exec`, `eval`, `os.system` 调用等）\n- 偷偷上传数据或记录键盘鼠标\n\n安全测试方法见 [SECURITY.md].\n\n## 许可协议\n\n本项目采用 [MIT License](.\u002FLICENSE)。欢迎自由使用、修改及引用。\n\n## 贡献\n\n欢迎通过 Issue 和 Pull Request 参与改进。任何引用本项目的衍生作品请在 README 中标注原始仓库地址。\n","FileToolkit 是一个轻量级、多功能的文件处理工具箱，支持文件加密、编码转换、批量重命名、哈希计算、文件分割合并、备份清理及目录分析等 10 多项独立功能。核心功能包括使用 AES-CBC 加密文件、自动检测并转换文件编码、按规则批量重命名文件、计算多种哈希值、按大小或份数分割和合并文件、备份文件或目录以及清理临时文件等。该项目既可作为命令行工具直接使用，也可作为 Python 库被其他项目引用。适用于需要高效管理和处理文件的各种场景，如数据备份、文件加密、批量文件操作等。",2,"2026-06-11 03:59:28","CREATED_QUERY"]