{“content”:”---\nname: hf-model-download-windows\ndescription: 通过 SSH 远程从 HuggingFace 下载大模型到 Windows PC\n---\n# HuggingFace 模型下载到 Windows PC\n\n## 背景\n通过 SSH 远程从 HuggingFace 下载大模型到 Windows PC。UI-TARS-1.5-7B 有 7 个 safetensor 文件（每个 ~2GB）。\n\n## 关键信息\n- PC SSH 用户名: Sozo（不是 ida 的 u0_a553）\n- 模型路径: D:\\Models\\UI-TARS-1.5-7B\n- HF Token: 参考 memory 中的 hf_token\n- 模型: ByteDance-Seed/UI-TARS-1.5-7B（19 个文件，约 14 GB）\n\n## 命令\n\n### 方法1: hf download（推荐）\ncmd\nset HF_TOKEN=<token>\nhf download ByteDance-Seed/UI-TARS-1.5-7B --local-dir D:\\Models\\UI-TARS-1.5-7B\n\n\n### 方法2: Python snapshot_download\npython\nfrom huggingface_hub import snapshot_download\nsnapshot_download(\n repo_id=\"ByteDance-Seed/UI-TARS-1.5-7B\",\n local_dir=\"D:/Models/UI-TARS-1.5-7B\",\n token=\"<token>\",\n)\n\n\n### 方法3: aria2c 多线程下载\ncmd\naria2c -x 8 \"https://huggingface.co/ByteDance-Seed/UI-TARS-1.5-7B/resolve/main/model-00001-of-00007.safetensors\" -d D:/Models/UI-TARS-1.5-7B -o model-00001-of-00007.safetensors --header=\"Authorization: Bearer <token>\"\n\n\n## 已知问题\n\n### hf download 卡在 “Fetching X files: 0%“\n- 症状：命令启动成功，进程存在，网络连接正常，但永远卡在 0%\n- 原因：HuggingFace CDN 对未授权请求限速，token 可能未正确传递\n- 解决：确保 HF_TOKEN 环境变量设置正确\n\n### snapshot_download 进程静默退出\n- 症状：Python 进程运行一段时间后静默退出，没有错误信息\n- 解决：用 subprocess + check_output 捕获输出\n\n### git clone credential manager 报错\n\ngit: credential-cache..die: Invalid credential proto\n\n- 解决：禁用 credential helper git config --global credential.helper \"\"\n\n### PowerShell SSH 转义问题\n- 单引号内的 ~ 不会展开\n- 变量在单引号内不展开\n- 解决：用双引号，特殊字符用反引号转义\n\n## 监控命令\npowershell\n# 检查进程\nGet-Process python | Select-Object Id, StartTime, @{N='MB';E={[math]::Round($_.WorkingSet/1MB)}}\n\n# 检查下载进度\nGet-ChildItem D:/Models/UI-TARS-1.5-7B -File | Measure-Object -Property Length -Sum\n\n# 检查网络连接\nnetstat -an | Select-String \"18.67.181.*ESTABLISHED\"\n\n# 检查 XET 日志\nGet-ChildItem C:/Users/Sozo/.cache/huggingface/xet/logs -File | Sort-Object LastWriteTime -Descending\n\n\n## HuggingFace CLI\n- huggingface-cli 已废弃\n- 新命令是 hf（如 hf download）\n”}