实时监控目录
默认监控桌面，也可以改成指定路径；新文件创建、修改或重命名后进入整理队列。
ClassIsland 桌面文件整理插件
让桌面文件，自动回到该去的地方。
Archive-Agent 为 ClassIsland 场景打造，实时监控桌面或指定目录，通过关键字、扩展名、文件名匹配规则与可选 LLM 分类， 将新出现的文件自动整理到对应文件夹。它关注的是可控、可撤销、可通知的桌面归档流程，而不是一次性的手动清理。
Watch实时监控
Rules关键字规则
FallbackLLM 分类
History历史与撤销
HostClassIsland 插件
桌面文件不会自己变整齐
下载、截图、作业文档、临时表格和班级材料会不断堆到桌面上。Archive-Agent 把这些新文件放进可配置的整理流程， 让规则先处理确定情况，再让智能分类补上模糊场景。
防抖后处理
等待文件写入稳定后再执行，减少下载中、复制中或保存中的文件被提前移动。
规则优先命中
关键字、扩展名、文件名模式和优先级共同决定目标文件夹。
可选智能兜底
规则未命中时，可调用 OpenAI 兼容 API，根据文件名与内容预览推荐目录。
通知与记录
整理后可显示通知、打开目标位置，并在操作历史中保留结果用于查看和撤销。
从发现文件到归档完成
Archive-Agent 的整理流程是可解释的：先观察文件变化，再匹配规则，必要时再启用智能分类，最后执行文件操作并记录结果。
监听文件变化
FileSystemWatcher 捕获桌面或指定目录中的新文件、修改和重命名事件。
排队与防抖
相同文件不会重复入队，并在防抖延迟后统一处理。
匹配整理规则
根据关键字、扩展名、匹配模式和优先级找到目标目录。
执行文件操作
支持整理、移动、复制等操作，并尊重覆盖现有文件等配置。
反馈与撤销
发布通知、写入历史，也可以打开文件管理器定位整理后的文件。
多种方法识别桌面文件
规则是第一层，智能分类是兜底层。确定的文件用确定规则处理，模糊的文件才交给模型判断，减少不必要的调用。
关键字与文件名
支持词匹配、前缀、后缀、完整匹配和子串匹配，适合“报告”“截图”“作业”等常见整理规则。
扩展名与优先级
可以针对 PDF、图片、表格、文档等扩展名建立规则，并通过优先级解决多规则命中。
LLM 与内容预览
可选发送文件名和文本预览给 OpenAI 兼容模型，用于判断没有明确关键字的文件。
自动整理，也要可控
文件移动是高风险操作，所以 Archive-Agent 把可靠性放在流程里：规则可配置、覆盖可关闭、历史可查看、失败可通知。
覆盖控制
默认不覆盖目标位置已有文件，避免自动整理时误伤已有资料。
操作历史
每次整理都保留时间、文件、匹配规则和状态，便于回看归档结果。
撤销与通知
支持撤销整理操作，成功或失败都可以通过 ClassIsland 通知体系反馈给用户。
为 ClassIsland 场景设计
Archive-Agent 是 ClassIsland 插件。它把桌面文件整理、通知、自动化触发和设置页集成进 ClassIsland 环境， 适合教室电脑、班级资料和日常下载文件的持续整理。
插件内完成配置
在设置页配置监控路径、实时监控、通知、打开文件管理器、定时触发、关键字规则和智能匹配引擎。
也能接入自动化
- 整理成功或失败可触发 ClassIsland 自动化。
- 支持定时扫描监控目录并整理文件。
- 文件整理后可打开目标位置并高亮文件。
把桌面清理变成稳定的后台流程。
Archive-Agent 用规则处理确定性，用智能分类处理模糊性，让 ClassIsland 环境里的桌面文件持续保持可整理、可追踪、可撤销。
helemazuba-boop/Archive-Agent