Repository navigation
文件标签管理器 v26 —— 用标签管理本地文件
★ 用标签管理本地文件的 Windows 工具 ——
不用再靠"文件夹套文件夹"来整理。
★ 这是第一个公开版本。
★ 下载
| 文件 | 说明 |
|---|---|
| 文件标签管理器.exe | ★ 双击就跑，不用装 Python（93 MB） |
★ 系统要求：Windows 10 / 11（64 位）
★ 它能做什么
- 给文件打标签 —— 一个文件可以贴多个标签，随手改
- 按标签找文件 —— 点标签就筛出来，多个标签可以叠加
- 标签星图 —— 标签之间的父子关系画成图，直接拖
- 自动标签 —— 按文件名 / 路径规则自动打
- 文件索引 —— 给目录建索引，几十万文件也秒查
- 悬浮球 —— 桌面上一个小球，显示网速 / 硬盘 / 内存，左键出菜单
- 深色模式 —— 晚上不刺眼
- 插件系统 —— 别人可以写插件加功能，不用改主程序
- 多语言 —— ★ 中文 / English 已经能整个程序切换
★ 怎么用（30 秒上手）
① 打开程序 → 「Browse…」选一个文件夹
② 左边是分类、中间是文件列表、右边是标签库
③ 选中文件 → 点标签 → 就打上了
④ 点标签库里的标签 → 只看打了这个标签的文件
⑤ 拖悬浮球到顺手的位置 → 以后一直在那儿
★ 详细说明：见仓库里的 看这里-文件夹说明.md
★★ 换语言
设置（Settings）→ 🌐 语言 / Language → English
→ 它问"要重启吗" → 点"是"
★ 重启之后整个界面就是英文的（包括悬浮球、菜单、报错弹窗）。
★★ 想加别的语言？不用改代码 ——
复制 语言/en_US.json 改成 ru_RU.json（俄语）/ fr_FR.json（法语）…
翻译好丢进 语言/ 目录就行，程序会自己认出来。
（★ 没翻的会自动显示中文，不会空白、不会报错。）
★★ 你的数据在哪儿（重要）
★ 所有数据都在你自己电脑上，程序不会往外传。
| 内容 | 位置 |
|---|---|
| 设置 | %USERPROFILE%\.file_tagger_settings.json |
| 数据库 | 由设置里的 data_dir 指定（你自己选） |
| 打包成 exe 后 | %LOCALAPPDATA%\AIxiede\ |
★ 唯一的联网功能是 CloudDrive2 集成 ——
它连的是你自己电脑上的网盘客户端（localhost），不经过任何服务器。
★★ 已知问题（说在前面）
① 杀毒软件可能误报（★ 最常见的坑）
★ 为什么：Python 打包的 exe 会把内容解压到 %TEMP% 再运行 ——
这个行为跟某些病毒一模一样，所以很容易被误报。
★ 会怎样：Windows Defender 可能直接删掉，360 / 火绒可能弹窗拦截。
★ 怎么办：
- ★ 这是误报，不是真的有病毒（源代码全在仓库里，可以自己看）
- 加白名单，或者用源码跑（
python AIxiede.py）
② PDF / Office 预览
★ 需要额外装库（pymupdf / python-docx / openpyxl）——
★ 这个 exe 里没带（体积原因）。不装也能用，只是 PDF / Office 文件不能预览。
③ 7-Zip
★ 装了 7-Zip 才能直接看压缩包里面是什么。没装也不影响别的功能。
★ 关于"AI 参与编写"
★ 这个项目的大量代码由 AI（DeepSeek）辅助生成 —— 我不隐瞒这一点。
★ 但也说清楚：
- 需求、设计、取舍、测试标准都是人定的
- AI 是"打字快的那双手"，决定做什么、做成什么样的是人
- ★ 项目里有个
文档/错题本（157 条），记录了每个踩过的坑和教训
★ 用了 AI 不丢人，隐瞒来源才是问题。
★ 许可
GNU AGPL-3.0 —— 见 LICENSE。
★ 通俗说：
- ✔ 可以随便用（包括公司里用）
- ✔ 可以改、可以分发
- ★ 但改了之后如果拿去做"网络服务"，必须把改动也开源
- ★ 而且要保留原作者署名
★ 欢迎参与
★ 最缺的就是英文翻译和别的语言****（现在英文覆盖 89%）。
★★ 不用懂代码 —— 编辑 语言/en_US.json，加一行 "中文": "English", 就行。
★ 或者：提 issue（说清楚"怎么复现"，比"坏了"有用一百倍）。
★ 详见 CONTRIBUTING.md。
★ 用标签管理文件，别再靠文件夹套文件夹了。
★ 觉得有用的话，欢迎提 issue、补翻译、写插件 —— 这比给钱更有用。