文件分类器

Organizer是一个基于语义分类(AI支持或关键字回退)的CLI工具,用于扫描目录并将文件分类到指定文件夹中。

  • by adityachavhan01
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 adityachavhan01/context-based-organiser-using-mcp-

使用说明

Organizer--基于内容的文件分类程序

此存储库包含一个小型CLI工具,该工具扫描目录,使用语义分类(AI支持或关键字回退),并将文件组织到 organized/<category>/ 在中发送每个文件的元数据时使用文件夹 .organizer_scan.jsonl.

快速启动

  1. 安装依赖项:
pip install -r requirements.txt
  1. (可选)启动本地MCP服务器以集中模型访问:
python -m src.mcp_server
# or: uvicorn src.mcp_server:app --host 127.0.0.1 --port 8000
  1. 使用MCP服务器运行组织者:
python -m src.cli --path "C:\path\to\files" --organize --use-mcp --mcp-host "http://127.0.0.1:8000"
  1. 或者在没有MCP的情况下本地运行(直接Anthropic或回退):
python -m src.cli --path "C:\path\to\files" --organize

配置

  • ANTHROPIC_API_KEY 环境变量——仅当您需要AI驱动的分类时才设置此变量(否则系统将以回退模式运行)。
  • --compute-hash --计算文件的SHA256(增加运行时成本)。
  • --limit N --最多扫描 N 文件(可用于快速测试)。

下一步去哪里看

  • src/cli.py --CLI编排
  • src/scanner.py --文件系统扫描和预览
  • src/ai_categorizer.py --模型访问和回退逻辑
  • src/mcp_server.py --FastAPI服务器(可选)