# 1. 安装
git clone <your-repository-url>          # 替换为你的仓库地址
cd netdisk-organizer-mcp
pip install -e .

# 2. 配置 token（见「获取 Access Token」）
export BAIDU_NETDISK_ACCESS_TOKEN="你的AccessToken"
export NETDISK_BACKEND="official"        # 默认值，可省略

# 3. 启动 MCP server（stdio）
python server.py

┌─────────────────────────────────────────────────────────────┐
│  你的 agent（WorkBuddy / Trae / 任何标准 MCP 客户端）          │
└───────────────┬─────────────────────────────────────────────┘
                │  stdio MCP
┌───────────────▼─────────────────────────────────────────────┐
│  netdisk-organizer-mcp  （本仓库 · 二楼 · 整理智能）          │
│   pan_scan/events/ask/stat/issues  ·  pan_move/undo/history  │
│   pan_profile  ·  pan_mkdir/save/quota/semantic              │
└───────────────┬─────────────────────────────────────────────┘
                │  委托（OfficialDataClient / BaiduBackend）
┌───────────────▼─────────────────────────────────────────────┐
│  官方数据层（地基 · 百度维护 · 标准 MCP）                     │
│   file_list / file_move / upload_by_url / get_quota /        │
│   file_semantics_search / make_dir ...                       │
└─────────────────────────────────────────────────────────────┘

git clone <your-repository-url>
cd netdisk-organizer-mcp
pip install -e .          # 或 uv sync
# 若用 sdk 兜底后端（NETDISK_BACKEND=sdk）：
pip install -e ".[sdk]"

{
  "mcpServers": {
    "netdisk-organizer": {
      "command": "python",
      "args": ["/absolute/path/to/netdisk-organizer-mcp/server.py"],
      "env": {
        "BAIDU_NETDISK_ACCESS_TOKEN": "你的AccessToken",
        "NETDISK_BACKEND": "official",
        "NETDISK_DATA_MCP_URL": "https://mcp-pan.baidu.com/sse"
      }
    }
  }
}

pip install requests
python tools/get_baidu_token.py --app-key 你的AppKey --app-secret 你的SecretKey
# 打开打印的验证 URL，登录百度账号授权 → 脚本自动拿到 access_token / refresh_token

netdisk-organizer-mcp/
├── server.py                 # MCP stdio server 入口，工具路由
├── index.py                  # 语义层：扫描/事件聚类/检索/体检
├── ops.py                    # 安全层：move/undo/history + journal
├── io_ops.py                 # 数据层薄封装（委托官方）
├── backend.py                # 后端抽象（Official/Baidu/Local）
├── tools/
│   └── get_baidu_token.py    # OAuth 设备码取 token 脚本
├── profiles/
│   ├── __init__.py           # profile 加载器 + 严格校验
│   ├── default.profile.json  # 内置默认偏好
│   └── schema.json           # JSON Schema
├── openapi_client/           # vendored 官方 SDK（sdk 兜底模式用）
├── pyproject.toml
├── .env.example              # 环境变量模板
└── .gitignore

pip install -e ".[dev]"
python -m pytest -q