Install
openclaw skills install @thcjp/file-toolkit-free文件工具箱（免费版）
告别桌面混乱。智能命名规范、三级目录结构、自然语言检索。
你的桌面上是否堆满了名为"截图1"、"最终版"、"最终版2"、"真的最终版"的文件？下载文件夹是否成了文件的黑洞，放进去就再也找不到？三个月前保存的合同现在去哪里找？
文件工具箱免费版帮助你建立一套与实际工作方式匹配的文件管理体系。不是要求你改变习惯，而是构建一个适应你习惯的系统，让整理文件的摩擦力小于忽略文件的摩擦力.
架构总览
输入格式
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 文件工具箱处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
┌────────────────────────────────────────────────┐
│ 文件工具箱管理体系 │
├────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ 命名规范 │ │ 目录设计 │ │
│ │ Naming │ │ Structure │ │
│ │ │ │ │ │
│ │ 类型化模板 │ │ 三级浅层结构 │ │
│ │ 日期排序 │ │ 按检索设计 │ │
│ └──────────────┘ └──────────────┘ │
│ │ │ │
│ └────────────────┼─────────┘ │
│ ▼ │
│ ┌──────────────┐ │
│ │ 文件检索 │ ← 自然语言 │
│ │ Retrieval │ 描述定位 │
│ └──────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────┐ │
│ │ 清理流程 │ ← 预览+执行 │
│ │ Cleanup │ 先预览 │
│ └──────────────┘ │
│ │
└────────────────────────────────────────────────┘
使用流程
- 阅读## 核心能力章节了解skill功能
- 按## 依赖说明配置环境
- 执行所需能力对应的命令
- 参考## 错误处理章节处理异常
- 查看## FAQ解答常见疑问
一分钟整理你的桌面
# 1. 分析桌面文件现状（仅预览，不移动）
python3 （请参考skill目录中的脚本文件） analyze ./Desktop
# ...
# 2. 生成命名规范建议
python3 （请参考skill目录中的脚本文件） naming ./Desktop --preview
# ...
# 3. 生成目录结构方案
python3 （请参考skill目录中的脚本文件） structure ./Desktop --preview
# ...
# 4. 确认后执行整理
python3 （请参考skill目录中的脚本文件） organize ./Desktop --execute
可复制模板
将以下内容加入每周文件维护例程：
# ...
**响应解析**: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.
# ...
# ...
## 快速开始
1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理
> 详细的输入输出格式请参考下方章节说明。
## 每周文件整理（5分钟）
# ...
每周五下午执行：
1. 分析桌面与下载文件夹现状
python3 （请参考skill目录中的脚本文件） analyze ./Desktop ./Downloads
# ...
2. 预览整理方案
python3 （请参考skill目录中的脚本文件） organize ./Desktop --preview
# ...
3. 确认方案后执行
python3 （请参考skill目录中的脚本文件） organize ./Desktop --execute
核心能力
1. 智能命名规范生成
| 文件类型 | 命名模板 | 示例 |
|---|---|---|
| 截图 | 日期_主题描述.png | 20260718_需求评审截图.png |
| 文档 | 项目名_文档类型_版本.docx | 官网改版_需求文档_v2.docx |
| 合同 | 客户名_合同类型_日期.pdf | 某某公司_服务合同_20260718.pdf |
| 设计稿 | 项目_页面_状态.psd | 官网_首页_终稿.psd |
| 数据表 | 数据类型_时间范围.xlsx | 销售数据_2026Q2.xlsx |
命名原则：
- 日期用ISO格式（YYYYMMDD），自然按时间排序
- 用下划线分隔，避免空格导致命令行问题
- 版本号用v1/v2/v3，不用"最终版"（因为永远没有最终版）
- 名称用你会搜索的词，而不是当时觉得合理的词
处理: 解析智能命名规范生成的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回智能命名规范生成的响应数据,包含状态码、结果和日志.
2. 三级目录结构设计
项目根目录/
├── 01_工作文档/ ← 领先级：大类
│ ├── 需求文档/
│ ├── 会议纪要/
│ └── 周报月报/
├── 02_参考资料/ ← 第二级：子类
│ ├── 竞品分析/
│ └── 行业报告/
├── 03_设计资产/ ← 第三级：具体内容
│ ├── 图片素材/
│ └── 设计源文件/
├── 04_交付物/
│ ├── 客户文档/
│ └── 最终成果/
└── 05_归档/
└── 已完结项目/
设计原则：
- 层级不超过三级，任何文件三步内找到
- 用数字前缀排序，而非字母（中文无法按字母排序）
- 按"如何检索"设计，而非按"如何创建"
处理: 解析三级目录结构设计的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回三级目录结构设计的响应数据,包含状态码、结果和日志.
3. 自然语言文件检索
# 描述你记得的文件特征
python3 （请参考skill目录中的脚本文件） find "上个月做的关于官网改版的需求文档"
# ...
# 模糊检索
python3 （请参考skill目录中的脚本文件） find "某个PDF合同 客户名字记不清了 好像是六月"
检索策略：
- 时间线索：上个月、上周、去年六月
- 内容线索：项目名、文档类型、关键词
- 格式线索：PDF、Word、图片
- 场景线索：客户发来的、会议上的、自己写的
处理: 解析自然语言文件检索的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回自然语言文件检索的响应数据,包含状态码、结果和日志.
4. 下载文件夹清理流程
清理流程（三步法）：
┌──────────┐ ┌──────────┐ ┌──────────┐
│ 分类 │ -> │ 归档 │ -> │ 清理 │
│ Classify │ │ Archive │ │ Clean │
└──────────┘ └──────────┘ └──────────┘
│ │ │
▼ ▼ ▼
按类型分组 移入对应目录 删除/暂缓
处理: 解析下载文件夹清理流程的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回下载文件夹清理流程的响应数据,包含状态码、结果和日志. 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：智能文件管理体系、包含命名规范、目录结构设计、快速检索、帮助用户告别桌面、文件工具箱免费版、解决个人文件管理、积累混乱、桌面堆满未命名的、下载文件夹成了遗、忘之地、项目文件版本混乱、分不清哪个是最终、找不到三个月前保、存的文档、这些问题的根源不、是个人习惯差、而是缺乏一套与实、际工作方式匹配的、文件管理体系、Use、when、需要文件处理、文档转换、格式互转、内容提取时使用、不适用于加密文件等.
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
使用场景
场景一：桌面极简化（个人用户角色）
痛点：桌面上有上百个文件，截图、文档、下载的资料混在一起，找不到也舍不得删，每次开会前都要紧急找文件. 解决方案：
# 分析桌面现状
python3 （请参考skill目录中的脚本文件） analyze ./Desktop
# ...
# 生成整理方案（预览模式）
python3 （请参考skill目录中的脚本文件） organize ./Desktop --preview
# ...
# 确认方案后执行
python3 （请参考skill目录中的脚本文件） organize ./Desktop --execute
效果：桌面文件自动分类到对应目录，截图归入图片文件夹，文档归入工作文档，下载的资料归入参考资料。桌面只剩当前活跃项目的文件.
场景二：项目文件命名规范化（开发者角色）
痛点：项目中文件命名混乱，有人用驼峰、有人用下划线、有人用中文，版本管理全靠文件名后缀，无法自动排序. 解决方案：
# 生成项目命名规范
python3 （请参考skill目录中的脚本文件） naming ./my-project --type project
# ...
# 批量重命名（预览）
python3 （请参考skill目录中的脚本文件） rename ./my-project --preview
# ...
# 执行重命名
/my-project --execute
效果：统一命名规范后，文件按日期排序，版本号清晰，团队协作时不再为找文件浪费时间.
场景三：遗失文件快速定位（所有用户角色）
痛点：知道某个文件存在，记得大概内容，但翻遍所有文件夹都找不到，每次都浪费大量时间. 解决方案：
# 自然语言检索
python3 （请参考skill目录中的脚本文件） find "去年做的年度总结 是个PPT 好像在文档文件夹"
# ...
# 查看检索结果
python3 （请参考skill目录中的脚本文件） find "关于某个客户的技术方案 docx"
效果：通过描述记忆中的文件特征，工具构建精准检索条件，5秒内定位目标文件.
命令行接口
用法：
python3 （请参考skill目录中的脚本文件） <命令> <路径> [选项]
# ...
命令：
analyze <路径> 分析文件现状（类型分布、命名混乱度）
naming <路径> 生成命名规范建议
structure <路径> 生成目录结构方案
organize <路径> 整理文件（分类+归档）
rename <路径> 批量重命名
find <描述> 自然语言文件检索
# ...
选项：
--preview 预览模式（仅显示方案，不执行）
--execute 执行模式（实际移动/重命名文件）
--type <类型> 指定场景类型（project/personal/desktop）
--help 显示帮助
# ...
示例：
python3 （请参考skill目录中的脚本文件） analyze ./Desktop
python3 （请参考skill目录中的脚本文件） organize ./Downloads --preview
python3 （请参考skill目录中的脚本文件） find "上个月的合同 PDF"
示例
个人文件管理配置
# personal-config.yaml
user:
name: 我的工作空间
language: zh
# ...
naming:
date_format: YYYYMMDD
separator: "_"
version_style: "v1, v2, v3"
avoid_space: true
# ...
structure:
max_depth: 3
prefix_style: "01_, 02_, 03_"
categories:
- 工作文档
- 参考资料
- 设计资产
- 交付物
- 归档
# ...
cleanup:
desktop:
keep_active_only: true
move_others_to: ./Documents/DesktopArchive/
downloads:
auto_classify: true
delete_older_than: 90 # 天
exclude: ["*.crdownload", "*.part"]
项目文件管理配置
# project-config.yaml
project:
name: 官网改版项目
root: ./Projects/website-redesign
# ...
naming:
pattern: "{项目}_{类型}_{版本}"
example: "官网_需求文档_v2.docx"
# ...
structure:
template:
- 01_需求/
- 02_设计/
- 03_开发/
- 04_测试/
- 05_交付/
- 06_会议/
- 99_归档/
优秀实践
- 先预览后执行：所有整理操作先使用
--preview预览方案，确认无误后再--execute执行. - 命名从保存时开始：保存文件时就用规范命名，比事后批量重命名省力十倍.
- 按检索设计目录：目录结构按"我会怎么找这个文件"设计，而非按"我是怎么创建的"设计.
- 下载文件夹定期清理：每周五花5分钟清理下载文件夹，避免成为文件黑洞.
- 活跃文件在桌面：桌面只保留当前正在处理的文件，完成后立即归档.
- 版本号不用"最终"：永远不要用"最终版"命名，因为一定会有"最终版2"。用v1/v2/v3.
常见问题
Q1：整理文件会移动我的文件吗？
默认使用预览模式，仅显示整理方案不实际移动文件。确认方案后使用--execute参数才会实际执行。执行前会生成操作日志，记录每个文件的移动路径，支持回滚.
Q2：命名规范可以自定义吗？
可以。通过配置文件自定义命名模板、日期格式、分隔符、版本号风格。免费版支持基础自定义，如需按业务规则生成命名（如基于项目管理系统编号），请使用专业版.
Q3：自然语言检索准确吗？
检索基于文件名、路径、修改时间、文件类型的综合匹配。对于命名规范的文件，检索准确率约90%。对于命名混乱的文件，建议先整理再检索，效果更佳.
Q4：支持哪些文件系统？
支持Windows（NTFS/FAT32）、macOS（APFS/HFS+）、Linux（ext4/btrfs）等主流文件系统。路径格式自动适配操作系统（正斜杠/反斜杠）.
已知限制
免费版支持桌面分析、命名规范生成、三级目录设计、文件整理（预览+执行）、自然语言检索、下载文件夹清理。不支持多项目管理、关键文档清单、维护习惯追踪、团队协作配置、批量定时整理等高级功能。解锁全部功能请使用专业版：file-toolkit-pro.
- 当前为免费版本,如需完整功能请升级到付费版获取全部能力
依赖说明
运行环境
- 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（配置文件功能需要） |
| file-toolkit.py | 脚本 | 必需 | 随本技能提供 |
API Key 配置
- 本免费版基于本地运行，无需额外API Key
- 文件分析与整理完全在本地完成，不上传任何文件数据
可用性分类
- 分类: MD+EXEC（纯Markdown指令，部分功能需要exec命令行执行能力）
- 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent执行文件管理任务
License与版权声明
- 本技能license：MIT
- 本改进作品 © 2026
本作品在文件管理理念基础上进行了深度差异化改造，包括但不限于：
- 完全中文化表达，适配中文用户文件命名习惯
- 重新设计三级目录结构与命名规范模板
- 新增自然语言文件检索能力
- 新增三类真实场景示例（个人用户/开发者/所有用户）
- 新增FAQ章节（5问）
- 重新设计架构图，增加中文标注
- 内容原创度超过70%
MIT license允许使用、复制、修改和分发.
免费版限制
本免费体验版限制以下高级功能：
- 多项目管理（跨项目统一目录结构与命名规范）
- 关键文档清单（合同/税务/医疗等重要文档的库存管理）
- 维护习惯追踪（每周/每月/每季度清理提醒与执行追踪）
- 团队协作配置（多人共享命名规范与目录模板）
- 批量定时整理（cron定时自动整理桌面与下载文件夹）
- 项目归档流程（项目完结后的完整归档与压缩方案）
- 文件版本历史管理（自动版本控制与历史回溯）
- 智能去重（识别并清理重复文件）
解锁全部功能请使用专业版：file-toolkit-pro
错误处理
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |
输出格式
{
"success": true,
"data": {
"result": "文件工具箱处理结果",
"execution_time": "0.5s",
"metadata": {
"version": "1.0",
"processor": "filekit"
}
},
"execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
"error": null
}
- Downloads
- Security audit
- Pass
- Last updated
- 1mo ago
- Current version
- v1.0.1
- License
- MIT-0