面向OpenClaw代理的内容感知文件管理。按内容（不仅是文件名）搜索文件，通过哈希查找重复文件，按类型自动分类，检测文件类型。
智能文件QQQ停止猜测文件所在之处
功能概述
智能文件QQQ停止猜测文件所在之处是一项面向实际任务的技能，主要用于开始按文件包含的内容查找文件；代理文件操作是盲目的；
核心要点
- name "*.js" 只匹配文件名；
- grep 只搜索。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用与执行
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
结果检查与注意事项
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
智能文件 ⚡
停止凭猜测寻找文件位置。直接按文件内容定位目标。
问题所在
Agent 的文件操作是“盲目的”。find . -name "*.js" 仅匹配文件名，grep 仅搜索文本内容。目前没有任何工具能将你正在查找的内容与文件实际包含的内容关联起来。
Smart Files 通过一个工具、零依赖，彻底解决这一问题。
⚠️ 重要警告
破坏性操作
--organize分析文件类别，但不会自动移动文件--rename默认为预演模式（dry run）；需显式指定--force才会真正执行重命名--cleanup仅提供分析结果 —— 不执行任何删除操作，除非用户明确触发 首次使用这些模式时，请务必先不带--force运行，以预览将发生的变更。
路径边界与 --force 覆盖机制
默认情况下，所有操作均被限制在 workspace 根目录范围内。--dir 参数接受路径输入；若所传路径超出 workspace 范围，该工具将拒绝执行并自动回退至 workspace 根目录。传入 --force 可绕过此边界限制 —— 请谨慎使用。
操作日志
监听模式（--watch）会在 memory/smart-files-journal.json 维护一份日志，记录文件哈希值及检测到的变更。该文件在进程重启后仍保持持久化。
快速上手
按内容搜索文件（而不仅是文件名）
node skills/smart-files/smart-files.js --search "database connection"
在整个 workspace 中搜索所有文件的实际内容，而非仅限文件名。返回按相关性排序的结果，并附带匹配上下文片段。
查找重复文件
node skills/smart-files/smart-files.js --dedup
基于 SHA-256 哈希值识别重复文件，并按文件大小和路径分组展示。
自动分类文件
node skills/smart-files/smart-files.js --organize /path/to/dir
将文件自动归类为：code、data、docs、media、archives、images、other。
文件元数据与类型识别
node skills/smart-files/smart-files.js --info /path/to/file
显示文件大小、类型、行数、词数、最后修改时间，以及自动识别的内容类型。
清理分析
node skills/smart-files/smart-files.js --cleanup /path/to/dir
识别临时文件、大文件（>1MB）及重复文件组。
Workspace 概览
node skills/smart-files/smart-files.js --status
统计总文件数、总大小、扩展名分布、最大尺寸文件等信息。
重命名文件
node skills/smart-files/smart-files.js --rename script.js app.js
支持上下文感知的重命名。默认为预演模式 —— 仅显示将要发生的变更。
功能特性
内容感知型搜索
- 搜索文件真实内容，而非仅限文件名
- 支持词级匹配，可处理部分单词及特殊字符
- 结果按相关性得分排序（1.0 表示完全匹配）
- 返回匹配项周围的上下文片段
- 自动跳过二进制文件
重复文件检测
- 基于 SHA-256 的内容哈希（非仅文件名）
- 按文件大小进行预筛选，提升性能
- 将内容完全一致的文件归为同一组
- 展示各重复文件的大小与完整路径
自动分类
- 基于内容的文件类型识别
- 支持类别：code、data、docs、media、archives、images、other
- 适用于任意目录，不仅限于 workspace
清理分析
- 识别临时/备份文件（如 .tmp、~、.bak 等）
- 标记大文件（>1MB）
- 报告重复文件组
- 扫描整个目录树
文件信息
- 自动识别内容类型（JSON、Python、HTML、SQL、Markdown 等）
- 提供行数、词数、大小等统计信息
- 显示最后修改时间与创建时间
配置
无需任何配置，开箱即用。
覆盖 workspace 根目录：
--dir /path/to/workspace
性能表现
- 自动跳过二进制文件
- 重复检测前按大小预筛选（dedup）
- 单文件内容扫描上限为 10MB
- 搜索结果最多返回 20 条匹配项
Agent 协议
当 Agent 需执行文件操作时：
- 查找文件 → 使用
--search替代find或grep - 执行清理 → 使用
--cleanup识别待清理项 - 删除前确认 → 使用
--dedup先找出重复文件 - 理解文件 → 使用
--info获取元数据与类型信息 - 组织整理 → 使用
--organize对目录进行自动分类
安全性
- 路径校验 —— 拒绝 workspace 根目录之外的路径
- 二进制文件检测 —— 自动跳过非文本文件
- 大小限制 —— 单文件扫描上限为 10MB
- 符号链接安全 —— 使用标准 fs 操作
对比分析
| 工具 | 搜索对象 | 速度 | 安装要求 |
|---|---|---|---|
find |
仅文件名 | 快 | 无 |
grep |
文本内容 | 中等 | 无 |
| Smart Files | 内容 + 元数据 | 快 | 无 |
| ripgrep | 文本内容 | 快 | 需安装 |
| fd | 文件名 | 快 | 需安装 |
Smart Files 将内容感知搜索、去重、清理与元数据获取整合于单一工具之中。
设计原则
- 零配置 —— 开箱即用，无需任何配置
- 零依赖 —— 纯 Node.js 实现，不依赖任何 npm 包
- 默认安全 —— 自动跳过二进制文件，严格遵守大小限制
- 完全透明 —— 所有操作均明确报告
- 高性能 —— 针对 workspace 规模的文件操作优化
热门AI工具
相关专题
本专题从实际API接口调试场景出发，讲解Postman身份认证的完整配置流程，包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查，帮助用户正确完成接口授权与访问验证。
0
2026.11.06
围绕Postman HTTP请求头配置展开，讲解Headers选项的具体使用方式，包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法，帮助用户解决接口调试过程中遇到的请求头配置问题。
0
2026.11.06
详细介绍Postman接口请求的创建与发送方法，涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看，帮助用户掌握Postman接口请求的完整操作流程。
0
2026.11.06
DBeaver数据导入专题，整理Excel、CSV、SQL、TXT等常见文件的数据导入方法，涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作，帮助用户将本地文件中的数据写入数据库，并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。
0
2026.11.05
DBeaver安全防护专题，围绕数据库连接安全、账号密码保护和访问权限管理展开，整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法，同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项，帮助用户提高数据库日常管理的安全性。
0
2026.11.05
本专题聚焦DBeaver数据库连接配置与管理，覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库，整理相应的连接设置方法，并提供驱动缺失、认证失败和连接异常等问题的排查方向。
0
2026.11.04
本专题围绕XORM框架的结构体映射展开，说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充，并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节，拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择，讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式，并补充容器与兼容数据库的适配经验。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节，拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择，讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式，并补充容器与兼容数据库的适配经验。
0
2026.11.04
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.7万人学习
共6课时 | 54.7万人学习
