记忆

smart-files

Content-aware file management for workspace files: search (content snippets opt-in via --snippets), dedup, organize, rename, file metadata inspection, and continuous watch mode. Watch mode persists a journal (paths/hashes/sizes/ timestamps/change events) to memory/smart-files-journal.json and can monitor paths outside the workspace when --force is passed. All file mutations (organize/rename) require --force and are dry-run by default.

它能做什么

Secure file search, dedup, organize, and rename for workspace files.

技能文档

Smart Files v2.2.0

**NOTE: Search mode reads file contents. Content snippets are hidden by default; use --snippets to show them.

Security Audit Remediation (2026-07-22)

Fix 1: --force flag now reaches watch mode

Before: watchDirectory() ignored --force, checked process.argv directly After: --force is properly passed as fourth parameter to watchDirectory()

Fix 2: Content snippets now opt-in (default hidden)

Content snippets are hidden by default — only paths and match scores shown. Add --snippets to show matched content. --quiet is retained for backward compatibility (same effect as default).

Fix 3: Documentation alignment (remediation)

clawhub.yaml and SKILL.md now both properly describe watch mode and journaling features, and declare explicit permissions. Tests remain in the repo under test/ (excluded from the published bundle via .gitignore/clawhub.yaml packaging).

Fix 4: Documentation alignment

clawhub.yaml and SKILL.md now both properly describe watch mode and journaling features.

Fix 5: Explicit privacy warnings in SKILL.md

Prominent warnings about content exposure risk and safe usage patterns.

Fix 6: Watch mode boundary documented

Clear documentation that watch mode with --force monitors arbitrary filesystem paths.

Fix 7: Journal disclosure documented

Clear documentation that watch mode persists file paths, hashes, and timestamps to memory/smart-files-journal.json.

Commands

--search [--snippets] — Content-aware search (snippets opt-in with --snippets)
--dedup — Duplicate detection by SHA-256
--organize — Read-only file categorization
--info — File metadata and type detection
--cleanup — Read-only cleanup analysis
--status — Workspace overview
--rename [--force] — Rename (dry run by default)
--watch [interval] [--force] — Filesystem monitoring (long-running)
--quiet — Keep content snippets hidden (same as default behavior)
--force — Override workspace boundary (use with caution)

Safe Usage Examples

# Privacy-safe: only paths shown (default behavior)
node smart-files.js --search "query"

# Show matched content snippets
node smart-files.js --search "query" --snippets

# Watch workspace (safe, default behavior)
node smart-files.js --watch ./src 30

# Watch external path (use with caution)
node smart-files.js --watch /path --force

Safety Defaults

Feature	Default	Override
Binary files	Skipped	Cannot override
File size limit	10MB	Cannot override
Search results cap	20	Cannot override
Workspace boundary	Enforced	--force
Watch mode scope	Workspace	--force
Rename mode	Dry run	--force
Content snippets	Hidden (opt-in)	--snippets

file-organizer

Sort and organize files in a directory by type or by modification date, with dry-run preview, duplicate-name handling, and an auto-generated organization report. Use when the user wants to clean up, sort, categorize, or organize files in a folder, or asks for a file classification/overview report.

Smart Backup

Intelligent file backup with compression and verification. Backup, sync, verify integrity, dedup, and restore. Manifest tracking. Zero external dependencies.

3 次安装

Smart Downloader

Smart file downloader with multi-threading, resumable downloads, and progress display

my-content-organizer

Organize workspace files by type, extension, and date. Use when: workspace is cluttered, need to sort downloads, clean up screenshots, organize media files, or prepare files for archival/backup.

1 次安装

Firefly Folder Organize

AI File Organizer for Firefly AI Folder. Local AI file analysis, auto-categorization, smart renaming, auto-tagging, deduplication, semantic search, progress...

Ai Folder Organize

AI File Organizer for Firefly AI Folder. Local AI file analysis, auto-categorization, smart renaming, auto-tagging, deduplication, semantic search, progress monitoring, and virtual directory plans. / 萤核智能文件夹AI整理助手。支持本地AI文件分析、智能分类与命名、自动打标、查重去重、全文搜索、进度监控与独创多维虚拟目录整理方案。