[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80779":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":10,"openIssues":12,"contributorsCount":11,"subscribersCount":11,"size":11,"stars1d":11,"stars7d":11,"stars30d":11,"stars90d":11,"forks30d":11,"starsTrendScore":11,"compositeScore":11,"rankGlobal":8,"rankLanguage":8,"license":13,"archived":14,"fork":14,"defaultBranch":15,"hasWiki":16,"hasPages":14,"topics":17,"createdAt":8,"pushedAt":8,"updatedAt":18,"readmeContent":19,"aiSummary":20,"trendingCount":11,"starSnapshotCount":11,"syncStatus":21,"lastSyncTime":22,"discoverSource":23},80779,"prism-organizer","J-Akiru5\u002Fprism-organizer","J-Akiru5",null,"Python",39,0,1,"MIT License",false,"main",true,[],"2026-06-12 02:04:06","# 🔮 Prism Organizer\n\n> A portable, beautiful CLI tool that scans, analyzes, and organizes files on Windows.\n\n[![Python 3.8+](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpython-3.8+-blue.svg)](https:\u002F\u002Fpython.org)\n[![Platform: Windows](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-Windows-0078d7.svg)]()\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green.svg)]()\n[![npm v1.2.2](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fprism-organizer?color=red)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fprism-organizer)\n\n## Features\n\n- **🔍 Scan & Analyze** — Detailed reports with file type breakdown, largest files, duplicates, junk, and more\n- **📁 Sort by Type** — Organize files into category folders (Images, Documents, Videos, Code, etc.)\n- **📅 Sort by Date** — Organize files into `YYYY\u002FMonth\u002F` folders\n- **🔎 Duplicate Detection** — 3-phase detection (size → partial hash → SHA-256) finds exact duplicates fast\n- **🖼️ Near-Duplicate Images** — Perceptual hashing finds visually similar images\n- **🧹 Cleanup** — Remove temp files, lock files, incomplete downloads, large installers\n- **☁️ Cloud Drive Detection** — Auto-detects OneDrive, Google Drive, Dropbox, etc. and skips them\n- **📝 Custom Rules** — Define your own rules in YAML to organize files your way\n- **🤖 AI Classification** — AI-powered category suggestions with interactive setup wizard\n- **🔄 Undo** — Every operation is logged and fully reversible\n- **👁️ Dry-Run Preview** — Always previews before making changes\n- **⚡ Parallel Processing** — Multi-threaded scanning and hashing\n- **🎨 Beautiful Terminal UI** — Rich tables, panels, progress bars with a cyan\u002Fpurple theme\n- **🎮 Interactive TUI Dashboard** — Arrow-key menus, checkboxes, live panels (`prism-organizer tui`)\n- **👀 Watch Mode** — Real-time directory monitoring with auto-organization\n- **📅 Scheduled Tasks** — Windows Task Scheduler integration\n\n## Quick Start\n\n**No Python required.** The npm installer auto-downloads a standalone binary on first run.\n\n### Installation\n\n```bash\n# ── NPM (Recommended — zero setup) ───────────────────\nnpm install -g prism-organizer\n# On first run, a ~30MB standalone binary is downloaded automatically.\n# After that: no Python, no pip, no dependencies needed.\n\n# ── Pip (for Python users) ────────────────────────────\npip install git+https:\u002F\u002Fgithub.com\u002FJ-Akiru5\u002Fprism-organizer.git\n\n# ── Clone & Develop ───────────────────────────────────\ngit clone https:\u002F\u002Fgithub.com\u002FJ-Akiru5\u002Fprism-organizer.git\ncd prism-organizer && pip install -e .\n```\n\n### Uninstall\n\n```bash\n# Remove the npm package\nnpm uninstall -g prism-organizer\n\n# Remove cached data (logs, backups, binary)\nrm -rf ~\u002F.prism-organizer\n```\n\n> **Note:** The npm package installs a Node.js wrapper that manages Python automatically.\n> If Python is not installed at npm install time, the package will install successfully\n> and show instructions for installing Python separately.\n\n### Verify Installation\n```bash\nprism-organizer --version\nprism-organizer --help\n```\n\n### Get Help\n\n```bash\n# Full help system with quick-start, command ref, safety, AI setup\nprism-organizer help\n\n# Specific topics\nprism-organizer help --topic quickstart\nprism-organizer help --topic tui\nprism-organizer help --topic config\nprism-organizer help --topic safety\nprism-organizer help --topic ai\nprism-organizer help --topic commands\n```\n\n> **Screenshots** of the TUI dashboard and scan reports are available on the\n> [GitHub Releases page](https:\u002F\u002Fgithub.com\u002FJ-Akiru5\u002Fprism-organizer\u002Freleases).\n\n---> **PATH Troubleshooting**: If the command isn't recognized, run: `python -m prism_organizer --help`\n\n## Usage\n\n### Scan a Directory\n```bash\nprism-organizer scan ~\u002FDownloads\nprism-organizer scan ~\u002FDownloads --verbose -w 8\n```\n\n### Sort Files\n```bash\nprism-organizer sort ~\u002FDownloads                  # Sort by type (default)\nprism-organizer sort ~\u002FDownloads --by date        # Sort by modification date\n```\n\n### Find Duplicates\n```bash\nprism-organizer dupes ~\u002FDownloads                 # Report only\nprism-organizer dupes ~\u002FDownloads --clean          # Report + prompt to remove\nprism-organizer dupes ~\u002FDownloads --perceptual     # Also find visually similar images\nprism-organizer dupes ~\u002FDownloads --clean --perceptual\n```\n\n### Clean Junk Files\n```bash\nprism-organizer clean ~\u002FDownloads\n```\n\n### Custom Rules\n```bash\nprism-organizer rules ~\u002FDownloads\n```\n\n### Undo\n```bash\nprism-organizer undo            # Undo last operation\nprism-organizer undo --list     # List recent operations\n```\n\n### AI Classification\n```bash\nprism-organizer ai-setup                            # 🆕 Interactive AI setup wizard\nprism-organizer ai-classify ~\u002FDownloads             # Suggest categories\nprism-organizer ai-classify ~\u002FDownloads --rename     # Also suggest filenames\n```\n\n### Watch Mode\n```bash\nprism-organizer watch ~\u002FDownloads                    # Auto-sort new files\nprism-organizer watch ~\u002FDownloads --action clean     # Auto-clean new files\nprism-organizer watch ~\u002FDownloads --action all       # Sort + clean\n```\n\n### Scheduled Tasks\n```bash\nprism-organizer schedule add ~\u002FDownloads --command sort --interval daily --at 09:00\nprism-organizer schedule list\nprism-organizer schedule remove\n```\n\n## Interactive TUI Dashboard\n\nLaunch the full interactive dashboard with arrow-key menus and live panels:\n\n```bash\nprism-organizer tui\n```\n\nThe TUI provides:\n- **Arrow-key navigation** — select directories, commands, and options with arrow keys\n- **Live panels** — activity log, quick stats, and menu side-by-side\n- **Keyboard shortcuts** — every function is a single keystroke away\n- **Zero subcommand memorization** — discover all features from the menu\n\n```\n╔══════════════════════════════════════════════════════╗\n║  🔮  Prism Organizer v1.2.0                         ║\n║  scan  |  sort  |  dupes  |  clean  |  rules  |  ai ║\n╠══════════════════════════╦═══════════════════════════╣\n║  📋  Main Menu           ║  📊  Quick Stats         ║\n║  🔍 [1]  Scan directory  ║  Downloads: 247 files    ║\n║  📁 [2]  Sort files      ║  Desktop: 89 files       ║\n║  🔎 [3]  Find duplicates ║                          ║\n║  🧹 [4]  Clean junk      ║  📜  Activity Log        ║\n║  📝 [5]  Apply rules     ║  12:34 Sorted 15 files   ║\n║  🤖 [6]  AI classify     ║  12:30 Cleaned 3 items   ║\n║  👀 [7]  Watch mode      ║  12:25 Dupe check: 2 grp ║\n║  ↩️ [8]  Undo last       ║                          ║\n║  ⚙️ [9]  Setup AI        ║                          ║\n║  [S] Schedule  [H] Help  [Q] Quit                   ║\n╚══════════════════════════╩═══════════════════════════╝\n```\n\n> Use `--no-interactive` to disable arrow-key prompts and use plain text input:\n> ```bash\n> prism-organizer sort ~\u002FDownloads --no-interactive\n> ```\n\n## 🤖 AI Integration\n\nPrism Organizer supports **three AI providers**. Set up in seconds with the interactive wizard:\n\n```bash\nprism-organizer ai-setup\n```\n\n| Provider | Cost | Privacy | Setup |\n|----------|------|---------|-------|\n| **OpenAI** | Pay-per-use | Cloud | API key required |\n| **Ollama** | Free | 100% Local | `ollama pull llama3.2` |\n| **LM Studio** | Free | 100% Local | Download + GUI |\n\n📖 **Full guide:** [docs\u002FAI_SETUP.md](docs\u002FAI_SETUP.md)\n\n### Quick Config Example (Ollama)\n```yaml\nai:\n  enabled: true\n  provider: \"ollama\"\n  model: \"llama3.2\"\n  # No api_key needed — runs entirely on your machine\n```\n\n## Configuration\n\nConfig stored at `~\u002F.prism-organizer\u002Fconfig.yaml`. Auto-created on first run.\n\n### Key Settings\n\n| Setting | Description | Default |\n|---------|-------------|---------|\n| `default_paths` | Directories to organize | Downloads, Desktop |\n| `categories` | Extension-to-category mappings | 13 categories |\n| `junk_patterns` | Patterns for auto-cleanup | ~$*, *.crdownload, etc. |\n| `duplicates.perceptual_threshold` | Hamming distance for near-dupes | `5` |\n| `ai.enabled` | Enable AI classification | `false` |\n| `ai.provider` | LLM provider (`openai`, `ollama`, `lmstudio`) | `openai` |\n| `ai.min_confidence` | Minimum confidence to apply suggestions | `0.7` |\n| `watcher.cooldown_seconds` | Min time between watch actions | `10` |\n| `watcher.min_file_age_seconds` | Wait before acting on new files | `5` |\n\n## Safety Features\n\n- **🔒 Dry-run by default** — Every command shows a preview before executing\n- **📦 Backups before delete** — Files go to `.prism-organizer_backup\u002F` first\n- **📝 Full operation logs** — Every action logged to `~\u002F.prism-organizer\u002Flogs\u002F`\n- **↩️ Undo support** — Reverse any operation with `prism-organizer undo`\n- **☁️ Cloud drive protection** — Auto-skips synced folders\n- **🤖 AI always suggests, never acts** — Classifications go through preview\u002Fconfirm\n\n### 🛡️ Privacy & Data Handling\n\nPrism Organizer is designed to be local-first, respecting your privacy and secure data processing:\n- **Zero Remote Telemetry**: No usage stats, error reports, or telemetry leave your machine.\n- **Local Operational Logs**: Full undo-history transaction logs contain absolute file paths, stored entirely locally under `~\u002F.prism-organizer\u002Flogs\u002F`.\n- **AI Privacy Guardrails**:\n  - **Local AI Providers** (Ollama, LM Studio) run fully offline on your own hardware.\n  - **Cloud AI Providers** (OpenAI) only receive filenames, extensions, and optionally short text previews (first 500 characters). Full binary\u002Fmedia files are never read or transmitted.\n  - **AI Preview Opt-Out**: Set `disable_previews: true` in your config to prevent reading\u002Fsending file contents entirely, or pass the `--no-ai` flag to disable all AI-powered suggestions.\n- For complete policy and data handling details, see [SECURITY.md](SECURITY.md).\n\n## Troubleshooting\n\n### npm install fails \u002F Python not found\n\nThe npm package will install successfully even without Python. You'll see a warning:\n\n```\n⚠ Python 3.8+ is not found on your PATH.\nℹ   Install Python from: https:\u002F\u002Fpython.org\u002Fdownloads\u002F\n```\n\nInstall Python, then run the tool normally. The pip package will be installed automatically on first use.\n\n### Command not found after install\n\n```bash\n# Try running directly with Python:\npython -m prism_organizer --help\n\n# Or reinstall globally:\npip install git+https:\u002F\u002Fgithub.com\u002FJ-Akiru5\u002Fprism-organizer.git\n```\n\n### Permission errors on scanned directories\n\nRun as administrator, or target directories you own (Downloads, Desktop, Documents).\n\n## Project Structure\n\n```\nprism_organizer\u002F\n├── cli.py           # CLI commands and argument parsing\n├── config.py        # Configuration loader\n├── scanner.py       # Filesystem analyzer (parallel)\n├── sorter.py        # Sort by type\u002Fdate\n├── duplicates.py    # 3-phase + perceptual duplicate detection\n├── rules.py         # Custom rule engine\n├── cleaner.py       # Junk file cleanup\n├── cloud_drives.py  # Cloud drive detection\n├── preview.py       # Dry-run preview UI\n├── executor.py      # File operations + logging\n├── undo.py          # Undo\u002Frollback\n├── display.py       # Rich-themed display layer\n├── interactive.py   # Arrow-key menus, checkboxes, wizards\n├── tui.py           # Interactive TUI dashboard\n├── ai.py            # AI-powered classification & renaming\n├── ai_setup.py      # Interactive AI setup wizard\n├── watcher.py       # Real-time watcher + scheduler\n└── utils.py         # Shared utilities\ndocs\u002F\n└── AI_SETUP.md      # Complete AI setup guide\n```\n\n## Changelog\n\n### v1.2.0 (Stable)\n- **Fixed:** npm install no longer fails when Python is missing (exits cleanly with instructions)\n- **Fixed:** Binary download from GitHub Releases now handles HTTP redirects\n- **Fixed:** Version mismatch between setup.py, package.json, and __init__.py\n- **Fixed:** `{counter}` placeholder in rename rules no longer causes KeyError\n- **Fixed:** Rich markup tags no longer render as literal text in TUI input prompts\n- **Fixed:** Archive operations no longer silently overwrite existing zip files\n- **Fixed:** Perceptual duplicate sorting no longer crashes if files are deleted mid-scan\n- **Added:** Interactive AI setup wizard (`prism-organizer ai-setup` \u002F TUI key `[9]`)\n- **Added:** AI setup documentation (`docs\u002FAI_SETUP.md`)\n- **Added:** Test step in CI\u002FCD pipeline (runs before build\u002Fpublish)\n- **Improved:** Removed unused imports across multiple modules\n- **Improved:** Added watcher defaults to config\n\n### v1.1.0\n- Initial public release with full feature set\n\n## License\n\nMIT License © 2026 Syntaxure Labs\n","Prism Organizer 是一个适用于 Windows 的便携且美观的命令行工具，用于扫描、分析和组织文件。其核心功能包括基于文件类型或日期进行分类整理、检测并处理重复文件与近似图像、清理临时文件等。此外，该工具还支持自定义规则、AI 分类建议、操作日志记录及回滚、实时预览以及多线程处理等功能，并提供了一个美观的终端用户界面和交互式文本用户界面。特别适合需要高效管理和优化本地文件存储空间的个人用户或小团队使用。",2,"2026-06-11 04:02:18","CREATED_QUERY"]