Organizer--基于内容的文件分类程序
此存储库包含一个小型CLI工具,该工具扫描目录,使用语义分类(AI支持或关键字回退),并将文件组织到 organized// 在中发送每个文件的元数据时使用文件夹 .organizer_scan.jsonl.
快速启动
- 安装依赖项:
pip install -r requirements.txt- (可选)启动本地MCP服务器以集中模型访问:
python -m src.mcp_server
# or: uvicorn src.mcp_server:app --host 127.0.0.1 --port 8000- 使用MCP服务器运行组织者:
python -m src.cli --path "C:\path\to\files" --organize --use-mcp --mcp-host "http://127.0.0.1:8000"- 或者在没有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服务器(可选)
