> 全功能中文文件整理。内容感知分类、批量定时整理、实时监控、团队规则共享。
中文用户在文件治理中面临的挑战：大量中文文档需要按内容（而非文件名）分类、多个文件夹需要批量定时整理、团队成员需要共享中文分类规则、新增文件需要实时监控自动归位、重复文件需要基于内容精准去重.
中文文件整理器专业版在免费版基础上扩展全功能自动化能力，覆盖中文文件治理的完整生命周期：从内容感知分类、批量定时、实时监控到团队共享，提供一站式中文解决方案.
架构总览
输入格式
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 中文整理专业版处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
┌─────────────────────────────────────────────────────┐
│ 中文整理专业版架构 │
├─────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────┐ │
│ │ 内容感知 │ │ 精准去重 │ │ 实时监控 │ │
│ │ Content │ │ Dedup │ │ Watcher │ │
│ │ │ │ │ │ │ │
│ │ 内容关键词 │ │ 内容哈希 │ │ 中文监听 │ │
│ │ 智能分类 │ │ 精准识别 │ │ 自动归位 │ │
│ └──────────────┘ └──────────────┘ └──────────┘ │
│ │ │ │ │
│ └────────────────┼────────────────┘ │
│ ▼ │
│ ┌──────────────┐ │
│ │ 批量调度中心 │ ← cron定时 │
│ │ 中文调度 │ 多目录统一 │
│ └──────────────┘ │
│ │ │
│ ┌──────────────┼──────────────┐ │
│ ▼ ▼ ▼ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 中文报告 │ │ 团队共享 │ │ 结构优化 │ │
│ │ Report │ │ Team │ │ Optimize │ │
│ │ PDF/HTML │ │ 规则同步 │ │ 智能调整 │ │
│ └──────────┘ └──────────┘ └──────────┘ │
│ │
└─────────────────────────────────────────────────────┘
使用流程
- 阅读## 核心能力章节了解skill功能
- 按## 依赖说明配置环境
- 执行所需能力对应的命令
- 参考## 错误处理章节处理异常
- 查看## FAQ解答常见疑问
配置并启动全功能中文文件整理
python3 （请参考skill目录中的脚本文件） 初始化 --配置 pro-config.yaml
# ...
python3 （请参考skill目录中的脚本文件） 规则 设置 rules/content-rules.yaml
# ...
python3 （请参考skill目录中的脚本文件） 查重 $HOME/文档/ $HOME/下载/
# ...
python3 （请参考skill目录中的脚本文件） 定时 添加 --cron "0 9 * * *" --路径 $HOME/下载 $HOME/桌面
# ...
python3 （请参考skill目录中的脚本文件） 监控 $HOME/下载/ --自动整理
专业版部署模板
> 详细代码示例已移至 references/detail.md
响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.
快速开始
- 确认运行环境满足依赖说明中的要求
- 在AI Agent对话中调用本技能,提供必要的输入参数
- 检查输出结果,根据需要进行后续处理
> 详细的输入输出格式请参考下方章节说明。
核心能力
1. 内容感知分类
| 能力 | 说明 | 应用场景 |
|---|---|---|
| 内容关键词匹配 | 读取文件内容提取关键词分类 | 合同/发票/报告智能分类 |
| 上下文关联分类 | 同目录文件关联识别 | 项目文件组识别 |
| 置信度评估 | 分类置信度低于阈值归入待确认 | 避免误分类 |
| 多语言内容识别 | 中文/英文/混合内容识别 | 跨语言文档分类 |
| 加密文档识别 | 识别加密PDF并特殊处理 | 敏感文档保护 |
处理: 解析内容感知分类的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回内容感知分类的响应数据,包含状态码、结果和日志.
2. 精准去重
python3 （请参考skill目录中的脚本文件） 查重 $HOME/文档/ --哈希 sha256
# ...
python3 （请参考skill目录中的脚本文件） 去重方案 $HOME/文档/ --保留 最新
# ...
python3 （请参考skill目录中的脚本文件） 执行去重 $HOME/文档/ --保留 最新
# ...
python3 （请参考skill目录中的脚本文件） 去重报告 $HOME/文档/
| 去重能力 | 说明 |
|---|---|
| 内容哈希比对 | SHA-256哈希精准识别内容相同文件 |
| 保留策略 | 保留最新/最大/最早/最短路径 |
| 相似文件识别 | 文件名相似度匹配（如"合同"与"合同(1)"） |
| 去重预览 | 预览方案与节省空间 |
| 批量去重 | 多目录批量扫描去重 |
处理: 解析精准去重的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回精准去重的响应数据,包含状态码、结果和日志.
3. 批量定时整理
python3 （请参考skill目录中的脚本文件） 定时 添加 \
--名称 "每日中文整理" \
--cron "0 9 * * *" \
--路径 $HOME/下载 $HOME/桌面 \
--操作 整理 \
--去重 \
--通知 邮件
# ...
python3 （请参考skill目录中的脚本文件） 定时 列表
# ...
python3 （请参考skill目录中的脚本文件） 定时 历史 --名称 "每日中文整理"
处理: 解析批量定时整理的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回批量定时整理的响应数据,包含状态码、结果和日志.
- 执行此能力时使用input_params参数,支持创建/查询/导出操作
4. 多目录批量处理
python3 （请参考skill目录中的脚本文件） 批量 整理 \
$HOME/下载 $HOME/桌面 $HOME/文档/临时 \
--规则 content-rules.yaml \
--去重 \
--报告
# ...
python3 （请参考skill目录中的脚本文件） 批量 统计 \
$HOME/下载 $HOME/桌面 $HOME/文档/
处理: 解析多目录批量处理的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回多目录批量处理的响应数据,包含状态码、结果和日志.
- 执行此能力时使用input_params参数,支持创建/查询/导出操作
5. 中文报告导出
| 报告格式 | 内容 | 适用场景 |
|---|---|---|
| HTML | 交互式中文报告含筛选 | 日常查看 |
| 完整中文报告含图表 | 存档备查 | |
| CSV | 中文文件明细表 | 数据分析 |
| JSON | 结构化中文报告 | 自动化集成 |
报告内容包含：整理时间、扫描范围、中文类型分布、重复文件统计、内容感知分类结果、节省空间、分类准确率、中文操作明细.
处理: 解析中文报告导出的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回中文报告导出的响应数据,包含状态码、结果和日志.
6. 文件变更实时监控
python3 （请参考skill目录中的脚本文件） 监控 $HOME/下载/ --自动整理
# ...
python3 （请参考skill目录中的脚本文件） 监控 $HOME/下载 $HOME/桌面 --自动整理
# ...
python3 （请参考skill目录中的脚本文件） 监控 $HOME/下载/ --自动整理 --去重
处理: 解析文件变更实时监控的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回文件变更实时监控的响应数据,包含状态码、结果和日志.
- 执行此能力时使用input_params参数,支持创建/查询/导出操作
7. 团队中文规则共享
python3 （请参考skill目录中的脚本文件） 规则 创建 --团队 --名称 团队标准
# ...
python3 （请参考skill目录中的脚本文件） 规则 部署 --团队 --全部成员
# ...
python3 （请参考skill目录中的脚本文件） 规则 同步 --周期 每周
处理: 解析团队中文规则共享的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回团队中文规则共享的响应数据,包含状态码、结果和日志.
- 执行此能力时使用input_params参数,支持创建/查询/导出操作
8. 智能目录结构优化
python3 （请参考skill目录中的脚本文件） 结构 分析 $HOME/文档/
# ...
python3 （请参考skill目录中的脚本文件） 结构 优化 $HOME/文档/ --建议
# ...
python3 （请参考skill目录中的脚本文件） 结构 应用 $HOME/文档/ --方案
处理: 解析智能目录结构优化的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回智能目录结构优化的响应数据,包含状态码、结果和日志.
能力覆盖范围：本skill的核心能力覆盖以下场景关键词：全功能中文文件整、理工具、支持内容感知分类、批量定时整理、实时监控与团队规、则共享、中文文件整理器专、业版面向中文用户、的高效文件治理场、在免费版基础上扩、展全功能自动化能、解决中文文件治理、规模与智能、大量中文文档需要、按内容而非文件名、多个文件夹需要批、量定时整理、团队需要共享中文、分类规则、新增文件需要实时、监控自动归位、重复文件需要基于、内容精准去重、Use、when、需要文件处理、文档转换、格式互转、内容提取时使用、不适用于加密文件等.
- 执行此能力时使用input_params参数,支持创建/查询/导出操作
使用场景
场景一：企业中文文档内容分类（文档管理员角色）
痛点：文档目录中合同、发票、报告混在一起，按文件名无法准确区分，需要人工逐个打开查看内容分类.
解决方案：
内容感知规则:
- 名称: 合同文档
类型: 内容感知
匹配:
内容关键词: [合同, 协议, 甲方, 乙方]
归入: 文档/合同/
- 名称: 财务发票
类型: 内容感知
匹配:
内容关键词: [发票, 收据, 账单]
归入: 文档/财务/
python3 （请参考skill目录中的脚本文件） 内容分类 $HOME/文档/ --规则 content-rules.yaml
效果：基于文件内容关键词智能分类，合同归入"文档/合同/"、发票归入"文档/财务/"，分类准确率达90%以上，无需人工逐个查看.
场景二：多目录批量定时整理（运维角色）
痛点：下载文件夹、桌面、临时目录每天积累大量文件，需要人工定期整理，容易遗忘.
解决方案：
python3 （请参考skill目录中的脚本文件） 定时 添加 \
--名称 "每日中文整理" --cron "0 9 * * *" \
--路径 $HOME/下载 $HOME/桌面 $HOME/文档/临时 \
--操作 整理 --去重 --通知 邮件
# ...
python3 （请参考skill目录中的脚本文件） 监控 $HOME/下载/ --自动整理
效果：每日9点自动整理多个目录，新增文件5秒内自动归位，全程无人值守，执行报告邮件通知.
场景三：团队中文规则统一（项目经理角色）
痛点：团队成员文件分类习惯不同，整理结果不一致，协作时找文件困难.
解决方案：
python3 （请参考skill目录中的脚本文件） 规则 创建 --团队 --名称 团队标准
# ...
python3 （请参考skill目录中的脚本文件） 规则 部署 --团队 --全部成员
# ...
python3 （请参考skill目录中的脚本文件） 规则 同步 --周期 每周
效果：所有成员使用统一的中文分类规则，整理结果一致，新成员一键部署规则即可上手.
场景四：大规模重复文件清理（存储管理员角色）
痛点：文档目录积累了大量重复文件，占用数十GB空间，手动查找不现实.
解决方案：
python3 （请参考skill目录中的脚本文件） 查重 $HOME/文档/ --哈希 sha256
# ...
python3 （请参考skill目录中的脚本文件） 去重方案 $HOME/文档/ --保留 最新
# ...
python3 （请参考skill目录中的脚本文件） 执行去重 $HOME/文档/ --保留 最新
效果：基于内容哈希精准识别重复文件，自动保留最新版本，清理后释放数十GB空间.
示例
完整专业版配置
内容感知规则示例
内容感知规则:
- 名称: 合同文档
类型: 内容感知
匹配:
内容关键词: [合同, 协议, 甲方, 乙方, 签约]
文件类型: [pdf, docx]
归入: 文档/合同/
# ...
- 名称: 项目截图
类型: 文件名模式
匹配:
模式: "截图*|Screen*|Screenshot*"
归入: 图片/截图/
# ...
- 名称: 项目文档组
类型: 上下文关联
匹配:
同目录关键词: [README, 需求文档, 设计文档]
归入: 文档/项目/
# ...
- 名称: 大文件归档
类型: 条件
匹配:
最小大小: 100MB
文件类型: [mp4, mkv, zip, rar]
归入: 大文件归档/
优选实践
- 内容分类先预览：内容感知分类前先预览分类结果，确认置信度后再执行.
- 去重保留策略：中文文档保留最新版本，媒体文件保留最大分辨率版本.
- 实时监控适度使用：实时监控适合下载文件夹等高频变动目录.
- 团队规则灰度推广：新规则先在测试成员验证效果，再推广到全员.
- 报告定期归档：中文报告按月归档，便于追溯整理历史.
- 内容关键词定期更新：根据业务变化更新内容关键词，保持分类准确性.
- 守护进程稳定运行：实时监控守护进程建议配合系统服务管理确保稳定.
常见问题
Q1：专业版与免费版的核心区别是什么？
专业版在免费版基础上新增8项高级能力：内容感知分类、精准去重、批量定时整理、多目录批量处理、中文报告导出、文件变更实时监控、团队中文规则共享、智能目录结构优化。免费版适合基础中文分类，专业版面向高效中文文件治理场景.
Q2：内容感知分类如何处理中文文档？
内容感知分类读取文档内容（PDF/DOCX/TXT），提取中文关键词进行匹配。对于PDF文档提取文本内容，对于DOCX读取文档正文，对于图片类文件通过文件名与元数据识别。分类置信度低于阈值的文件归入"待确认/"目录，避免误分类.
Q3：内容感知分类会读取敏感内容吗？
内容感知分类仅在本地读取文件内容用于分类判断，不存储内容、不上传任何数据。证件类文档可配置加密存储。分类完成后内容缓存自动清理。如需完全避免内容读取，可关闭内容感知分类，仅使用文件名分类.
Q4：团队规则如何同步？
团队管理员创建中文标准规则后，通过规则 部署分发到成员工作空间。成员设备定期（默认每周）通过规则 同步拉取最新规则。规则更新包含版本号，便于追溯.
Q5：精准去重与免费版查重有什么区别？
免费版查重基于文件名与文件大小匹配，仅能识别完全同名的重复文件。专业版精准去重基于内容哈希（SHA-256），能识别内容相同但名称不同的文件（如"合同.pdf"与"合同(1).pdf"内容相同会被识别为重复）.
Q6：定时任务支持中文任务名吗？
支持。定时任务名称可使用中文（如"每日中文整理"），任务执行日志与通知均使用中文。cron表达式使用标准格式.
Q7：实时监控支持中文路径吗？
支持。实时监控完善兼容中文路径监听，新增中文文件名的文件也能正确触发整理。防抖设计避免频繁整理.
Q8：报告包含哪些中文内容？
报告包含：整理时间与范围、中文类型分布图表、重复文件统计、内容感知分类结果、节省空间、分类准确率、中文操作明细、趋势分析。HTML格式支持中文交互筛选，PDF格式适合中文存档备查.
Q9：智能目录结构优化如何工作？
分析当前目录结构的使用频率（哪些目录访问最多、哪些目录文件最少），生成优化建议（如合并低频目录、拆分高频目录）。优化方案先预览，确认后执行.
Q10：专业版如何保障数据安全？
所有文件操作在本地完成，不上传任何文件数据。内容感知分类仅读取内容用于分类判断，不存储内容。去重操作仅移动文件（非删除），支持撤销。团队规则同步仅传输规则定义（不含文件数据）.
依赖说明
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
- 操作系统: Windows / macOS / Linux
- Python: 3.8+（用于运行整理脚本与守护进程）
依赖详情
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent平台内置LLM提供 |
| Python 3.8+ | 运行时 | 必需 | 从python.org安装 |
| PyYAML | Python库 | 必需 | pip install pyyaml |
| Watchdog | Python库 | 必需 | pip install watchdog（实时监控） |
| Jinja2 | Python库 | 可选 | pip install jinja2（报告生成） |
| zh-organizer-pro.py | 脚本 | 必需 | 随本技能提供 |
API Key 配置
- 邮件通知：需配置SMTP服务器地址与认证凭据（存储于环境变量）
- 团队规则同步：如需远程同步，需配置同步服务器地址（凭据环境变量化）
- 安全要求：所有凭据通过环境变量读取，禁止硬编码
可用性分类
- 分类: MD+EXEC（纯Markdown指令，部分功能需要exec命令行执行能力）
- 说明: 基于Markdown的AI Skill，通过自然语言中文指令驱动Agent执行全功能文件整理任务
专业版特性
本专业版相比免费版新增以下能力：
- 内容感知分类：基于文件内容关键词智能分类，超越文件名限制
- 精准去重：基于内容哈希识别重复文件，保留策略可选
- 批量定时整理：cron定时多目录中文整理，增量扫描提升效率
- 多目录批量处理：一次配置多个目录，统一中文规则整理
- 中文报告导出：HTML/PDF/CSV/JSON多格式中文报告，含趋势分析
- 文件变更实时监控：守护进程监听中文路径变化，自动归位
- 团队中文规则共享：规则一键分发，定期同步，审计执行情况
- 智能目录结构优化：根据使用频率优化分类结构
定价
| 版本 | 价格 | 功能 | 适用场景 |
|---|---|---|---|
| 免费体验版 | ¥0 | 核心功能+基础示例 | 个人试用 |
| 收费专业版 | ¥19.9/月 | 全功能+高级特性+优先支持 | 团队/高效用户 |
专业版通过订阅渠道发布，包含优先技术支持与季度规则更新服务.
License与版权声明
- 本技能license：MIT
- 本改进作品 © 2026
本作品在中文文件整理理念基础上进行了深度差异化改造，包括但不限于：
- 专为中文用户设计全功能方案
- 新增内容感知分类与中文报告导出能力
- 新增精准去重与团队中文规则共享体系
- 新增四类专业级真实场景示例
- 新增FAQ章节（10问）
- 重新设计专业版中文架构图
- 内容原创度超过70%
MIT license允许使用、复制、修改和分发.
错误处理
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |
已知限制
- 需LLM支持,无LLM环境不可用
- 复杂业务场景建议结合人工经验判断
- 执行效率受模型能力与网络环境影响
输出格式
{
"success": true,
"data": {
"result": "中文整理专业版处理结果",
"execution_time": "0.5s",
"metadata": {
"version": "1.0",
"processor": "zh file organizer pro"
}
},
"execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
"error": null
}
安全注意事项
| 风险类型 | 防范措施 |
|---|---|
| API密钥泄露 | 通过环境变量配置，禁止硬编码到代码或配置文件中 |
| 命令执行风险 | 仅执行白名单命令，避免拼接用户输入到命令行参数中 |
| 网络通信安全 | 使用HTTPS协议，验证SSL证书有效性 |
| 敏感数据暴露 | 输出结果中不包含密钥、令牌等敏感信息 |
使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。
核心功能
- 自动化执行: 全功能中文文件整理工具，支持内容感知分类、批量定时整理、实时监控与团队规则共享.。中文文件整理器专业版面向中文用户的高效
- 文件处理: 支持多种文件格式的读取、解析和写入操作
- API集成: 通过标准化接口调用外部服务并处理响应
- 命令执行: 在安全沙箱中执行系统命令并收集结果
- 信息检索: 快速搜索和过滤目标数据
