Windows 全栈维护

你运行在 Windows 10 原生环境，Git Bash 终端。所有 Windows 问题统一从这里处理。

环境速查

• Hermes 家目录：D:\Hermes
• 软件目录：D:\sofeware\
• 缓存目录：D:\sofeware\cache\
• 用户文件夹：D:\All\（文档/下载/音乐/图片/视频已迁移）
• Python：D:\sofeware\python\cpython-3.11-windows-x86_64-none\python.exe
• venv Python：D:\Hermes\hermes-agent\.venv\Scripts\python.exe
• 屏幕分辨率：1536x864
• FFmpeg：D:\sofeware\ffmpeg\bin\

零、代理加速（Clash Verge / 魔戒）

用户使用魔戒机场 + Clash Verge ReV v2.5.1。代理端口：

• HTTP 代理：127.0.0.1:7897（主用）

Clash Verge 安装包：D:/sofeware/cache/Clash.Verge_2.5.1_x64-setup.exe（v2.5.1，2026-07-04 通过 gh-proxy.com 下载）

验证代理可用：

curl -s --connect-timeout 5 -x http://127.0.0.1:7897 "https://github.com" -o /dev/null -w "%{http_code}"

使用代理下载：

curl -x http://127.0.0.1:7897 -L -o "输出文件" "URL"

Python 走代理：

import urllib.request
proxy = urllib.request.ProxyHandler({'https': 'http://127.0.0.1:7897'})
urllib.request.install_opener(urllib.request.build_opener(proxy))

无代理时用 GitHub 镜像：ghfast.top 或 gh-proxy.com（格式：https://镜像/https://github.com/...）

详见 references/clash-verge-proxy.md。

一、应用程序数据 junction 迁移（C→D）

把 AppData 用户数据搬到 D 盘，用 junction 透明链接。

通用步骤

# 1. 关闭应用
cmd //c "taskkill /f /im <进程名>.exe"

# 2. 创建目标
mkdir -p "/d/sofeware/cache/<AppName>/"

# 3. 搬数据
cp -r "$HOME/AppData/Roaming/<Vendor>/<Dir>" "/d/sofeware/cache/<AppName>/"
rm -rf "$HOME/AppData/Roaming/<Vendor>/<Dir>"

# 4. 建 junction（只能用 PowerShell！）
powershell -Command "New-Item -Path 'C:\Users\<user>\AppData\Roaming\<Vendor>\<Dir>' -ItemType Junction -Target 'D:\sofeware\cache\<AppName>\<Dir>'"

Pitfall：Git Bash 下 mklink 不可用

cmd //c 'mklink /J ...' 和 cmd.exe /c "mklink /J ..." 均不稳定，会启动交互式 cmd。

正确做法：用 PowerShell 的 New-Item -ItemType Junction。

验证

ls -la "<junction路径>/"    # 能看到目标内容 = 成功

用户文件夹迁移验证

通过"属性→位置"迁移后检查注册表：

reg query "HKCU\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders"

应看到 Personal → D:\All\文档、My Music → D:\All\音乐 等。

PATH 不需要手动改，Windows 自动更新 Shell Folders 注册表。

二、卸载残留检查

应用卸载后按此清单扫描：

# 安装目录
ls "/d/sofeware/<AppName>"
ls "/c/Program Files/<AppName>"
ls "/c/Program Files (x86)/<AppName>"

# 用户数据
ls "$HOME/AppData/Roaming/<Vendor>/<AppName>"
ls "$HOME/AppData/Local/<Vendor>/<AppName>"

# 公共数据
ls "/c/ProgramData/<AppName>"

# 注册表
reg query "HKLM\SOFTWARE\<Vendor>\<AppName>"
reg query "HKCU\SOFTWARE\<Vendor>\<AppName>"

# 服务
sc query <ServiceName>

# 开始菜单
ls "/c/ProgramData/Microsoft/Windows/Start Menu/Programs/" | grep -i <keyword>

注意：HKLM\SOFTWARE\Microsoft\Office\Common 是 Windows 系统级残留，不影响使用，可忽略。

三、Office ClickToRun 修复

症状：所有 Office 应用报"操作系统当前的配置不能运行此应用程序"

根因：系统重置后 AppX 注册丢失，加上 Windows 10 家庭中文版无 AppVClient。

诊断流程

# 1. 文件完整性
ls "/c/Program Files/Microsoft Office/root/Office16/WINWORD.EXE"

# 2. 许可证状态（空白 = 许可证丢失）
cscript //Nologo "/c/Program Files/Microsoft Office/root/Office16/OSPP.VBS" /dstatus

# 3. ClickToRun 服务
sc query ClickToRunSvc

# 4. App-V 状态（1060 = 未安装）
sc query AppVClient

修复（按推荐度）

A. GUI 联机修复（最可靠） Win+I → 应用 → Microsoft 365 → 修改 → 联机修复

B. IntegratedOffice.exe

"/c/Program Files/Common Files/Microsoft Shared/ClickToRun/IntegratedOffice.exe" culture=zh-cn repair=Quick

C. MAS 重新激活

powershell -Command "irm https://get.activated.win | iex"
# 交互式，选 Office 激活选项

防止复发

MSYS_NO_PATHCONV=1 schtasks /Change /TN "Microsoft\Office\Office Startup Maintenance" /Disable

四、系统优化：进程审计 + 自启项管理

清点内存大户和自启项，砍掉不必要的后台进程。

4.1 内存占用排行

Get-Process | Sort-Object WorkingSet64 -Descending | 
  Select-Object -First 25 Name,Id,@{N="MemMB";E={[math]::Round($_.WorkingSet64/1MB,1)}} |
  Format-Table -AutoSize

hint：在 git-bash 里跑 PowerShell 时 $_ 会被 bash 转义，建议用 execute_code 工具调用 subprocess.run(['powershell.exe', ...])。

4.2 自启项三件套

注册表 Run 键：

reg query "HKCU\SOFTWARE\Microsoft\Windows\CurrentVersion\Run"
reg query "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Run"

登录触发的计划任务：

Get-ScheduledTask | Where-Object { $_.Triggers | Where-Object { $_.Enabled -and ($_.CimClass.CimClassName -match 'BootTrigger|LogonTrigger|StartupTrigger') } } | Select-Object TaskName,TaskPath,State

自动启动的服务：

Get-Service | Where-Object { $_.StartType -eq 'Automatic' -and $_.Status -eq 'Running' } | Select-Object Name,DisplayName

4.3 常见可砍项

Pitfall：schtasks 在 MSYS 下的编码问题

schtasks /query 输出含中文时 git-bash 识别为 binary，必须加 MSYS_NO_PATHCONV=1 前缀，或直接用 PowerShell 的 Get-ScheduledTask。

Pitfall：wmic 已废弃

Windows 10/11 新版移除了 wmic.exe，用 PowerShell Get-CimInstance 或 Get-ScheduledTask 替代。

详见 references/process-audit-and-startup.md。

五、磁盘清理

C 盘检查：D:\Hermes\scripts\clean_cache.py 每 10 天清 5GB 缓存。

大文件定位

用 Python 替代 du（Git Bash 的 du 在 Windows 上极慢）：

import os
def get_dir_size(path):
    total = 0
    for dirpath, dirnames, filenames in os.walk(path):
        for f in filenames:
            fp = os.path.join(dirpath, f)
            try:
                total += os.path.getsize(fp)
            except OSError:
                pass
    return total

常见吃 C 盘大户

• 微信（xwechat）：%APPDATA%\Tencent\xwechat\ ~808MB
• 企业微信（WXWork）：%APPDATA%\Tencent\WXWork\
• QQ：%APPDATA%\Tencent\QQ\
• 腾讯系 AppData 合计约 2.2GB

六、Hermes 环境迁移

从 WSL 或另一台机器迁移 Hermes 到 Windows 原生。

备份提取

# WSL 备份在 tar.gz，MSYS 下必须 cp 到 /tmp 再解压
cp "E:/backups/hermes-home.tar.gz" /tmp/
cd /tmp/hermes_restore && tar xzf /tmp/hermes-home.tar.gz

恢复清单

• config.yaml、AGENTS.md、.env（凭证）
• profiles/*/memories/、profiles/*/config.yaml
• MCP 服务器配置

WSL → Windows 路径转换

/home/zhengxin/... → D:\... 或 C:\Users\28672\...

七、Windows 常见 Pitfall 速查

八、相关参考文件

• references/office-repair.md — Office 详细修复记录（含 2026-06-30 系统重置案例）
• references/wps-data-migration.md — WPS 数据迁移详细步骤
• references/continuous-voice-mode.md — 连续语音模式配置
• references/huggingface-cache-windows.md — HF 缓存 + 国内网络
• references/voice-ffplay-path.md — ffplay PATH 修复
• references/voice-tts-stt-race-fix.md — TTS/STT 竞态修复
• references/china-pypi-mirrors.md — 国内 PyPI 镜像
• references/c-drive-cleanup.md — C 盘清理清单
• references/vs-build-tools-verify.md — VS Build Tools 安装验证
• references/dev-tools-install.md — Windows 开发工具安装（MinGW/JDK 下载+解压+环境变量，ZIP优先，MSI避坑）
• references/edge-browser-automation.md — Edge 浏览器自动化（Playwright + mcp-chrome）
• references/agent-browser-setup.md — agent-browser Windows 安装全流程（下载/续传/代理/Chrome 运行时）
• references/zip-manual-extraction.md — 损坏 ZIP 手动提取技术
• references/process-audit-and-startup.md — 进程审计 + 自启项管理命令速查
• references/clash-verge-proxy.md — Clash Verge 代理配置 + GitHub 镜像下载
• references/computer-use-uwp-limitation.md — cua-driver 无法后台启动 UWP 应用
• references/computer-use-vision-fix.md — SOS 截图报 400 错误：视觉模型配置修复
• references/bailian-cli-setup.md — 阿里云百炼 CLI 安装、配置、API 对接全流程
• references/free-api-status.md — 国产大模型免费 API 逆向状态追踪（即梦/DeepSeek/Kimi/豆包等）
• references/openclaw-setup.md — OpenClaw + 百炼 Coding Plan 部署配置

九、浏览器自动化与桌面操控

详见 references/edge-browser-automation.md。

快速入口

Pitfall：computer_use 无法启动 UWP 应用

详见 references/computer-use-uwp-limitation.md。

cua-driver 后台模式下点击任务栏 UWP 应用图标（汽水音乐、腾讯视频等）不会启动。Win+搜索、PowerShell Start-Process 均无效。让用户手动打开 UWP 应用，打开后 cua-driver 可正常操作其窗口。

Pitfall：browser-use 包名陷阱

PyPI 上 browser-use（连字符）是 CLI 工具而非 AI Agent 库，安装会降级 openai/pydantic/rich，破坏 Hermes。不要装。直接用 Playwright。

十、损坏 ZIP 修复

详见 references/zip-manual-extraction.md。

当 zipfile.ZipFile() 和 shutil.unpack_archive() 都报 "not a zip file" 但文件头正确（PK\x03\x04）时，手动遍历 local file headers 逐个提取文件数据。