Windows 7 AI 工作站 —— 从零搭建指南
⚠️ 重要说明:本技能的特殊性
这不是一个让 Agent 自动执行的技能。
其他技能(如知乎搜索、FFmpeg 转码)是 Agent 已经跑起来后帮你干活的。但这个技能不同——你的电脑是 Windows 7,AI 软件本身还没装好,Agent 根本不存在,没法帮你点鼠标或运行命令。
所以这份文档需要你(人类用户)自己阅读并手动操作。 Agent 最多只能告诉你"下一步该做什么",或者给你一段脚本让你复制粘贴到 CMD/PowerShell 里手动执行。
每一步我都会标注:
- 🔧 手动操作:需要你自己在电脑上做
- 💻 命令行:打开 CMD 或 PowerShell 手动输入
- 🤖 Agent 可用:AI 软件跑起来后,Agent 可以帮你做
第一步:确认系统环境
🔧 手动操作
1.1 确认 Windows 版本和位数
打开 CMD(按 Win+R,输入 cmd,回车),输入:
ver
确认输出包含:
- Windows [7] — 是 Windows 7
- Service Pack 1 — 已安装 SP1(必须!没有 SP1 后续全部白搭)
- 版本号应为 6.1.7601
再确认 64 位:
wmic os get OSArchitecture
输出应为 64-bit。32 位也能用但建议 64 位(某些工具只有 x64 版本)。
1.2 检查关键系统补丁
💻 命令行
这些补丁是 VxKex 和现代应用运行的基础,缺少会导致各种诡异错误:
| 补丁 | 用途 | 必须 |
|---|---|---|
| KB4474419 | UCRT 通用 C 运行时更新(Visual C++ 运行库基础) | ✅ 必须 |
| KB2533623 | 部分场景需要的旧版运行时组件 | 按需 |
| KB2670838 | 部分场景需要的兼容性组件 | 按需 |
检查方法:
wmic qfe list brief | findstr "KB4474419"
如果没有输出,说明没装。去 Microsoft Update 或微软官网搜索补丁号下载安装。
⚠️ 注意:Win7 的官方安全更新已在 2020 年停止,如果系统较旧可能缺很多补丁。建议先跑一次 Windows Update 把能装的都装上。
1.3 安装 Visual C++ 运行库
🔧 手动操作
VxKex 和部分工具依赖 Visual C++ 运行库。去微软官网下载:
Visual C++ Redistributable for Visual Studio 2015-2022
- 64 位系统下载
vc_redist.x64.exe - 如果不确定是否 32 位程序也需要,
vc_redist.x86.exe也装一个
安装完重启电脑。
1.4 升级 PowerShell 到 5.1
🔧 手动操作
Windows 7 自带的 PowerShell 是 2.0 版本,太老了,很多现代脚本和 cmdlet 不支持。必须升级到 5.1。
第一步:安装 .NET Framework 4.8(PowerShell 5.1 的前置依赖)
去微软官网下载并安装:
.NET Framework 4.8 Runtime
- 64 位系统下载
ndp48-x86-x64-allos-enu.exe(或对应语言版本) - 安装完可能需要重启
⚠️ 如果系统已有 .NET 4.5.2+ 也可以,但建议直接装 4.8(向后兼容)。
第二步:下载 WMF 5.1 安装包
去微软官网下载 Windows Management Framework 5.1:
WMF 5.1 Download
下载后解压会得到多个文件,根据你的系统选对应的:
| 文件名 | 适用系统 |
|---|---|
| Win7AndW2K8R2-KB3191566-x64.zip | ✅ Win7 64位(用这个) |
| Win7-KB3191566-x86.zip | Win7 32位 |
| Win8.1-KB3191564-x86.msu | Win8.1 32位 |
| Win8.1AndW2K12R2-KB3191564-x64.msu | Win8.1 64位 |
| W2K12-KB3191565-x64.msu | Win2012 64位 |
我们只需要 Win7AndW2K8R2-KB3191566-x64.zip(64 位系统)。
第三步:以管理员身份运行 PowerShell 安装
- 右键开始菜单 → "Windows PowerShell(管理员)"
- 先修改脚本执行策略:
Set-ExecutionPolicy RemoteSigned -Force - 把
Win7AndW2K8R2-KB3191566-x64.zip解压到一个目录(如D:\temp\wmf51\) - 在管理员 PowerShell 中运行:
D:\temp\wmf51\Install-WMF5.1.ps1 - 等待安装完成
第四步:重启电脑
安装 WMF 5.1 后必须重启。
第五步:验证
重启后打开 CMD,输入:
powershell -Command "$PSVersionTable.PSVersion.ToString()"
应显示 5.1.xxxxx。
1.5 总结检查清单
| 项目 | 要求 | 状态 |
|---|---|---|
| Windows 7 SP1 (6.1.7601) | 必须 | ☐ |
| 64 位系统 | 推荐 | ☐ |
| KB4474419 | 必须 | ☐ |
| Visual C++ 2015-2022 运行库 | 必须 | ☐ |
| .NET Framework 4.8 | 必须(PowerShell 5.1 前置) | ☐ |
| PowerShell 5.1 | 必须(从 2.0 升级) | ☐ |
全部打勾后才能进入下一步。
第二步:安装 VxKex 兼容层
🔧 手动操作
VxKex 是让 Windows 10 应用程序能在 Windows 7 上运行的核心组件。没有它,Cherry Studio / ChatBox 都打不开。
⚠️ VxKex 是安装包,不是绿色便携软件。 需要正式安装到系统中(默认装到 C:\Program Files\VxKex),不能像其他工具那样随便放个目录就行。
2.1 下载 VxKex
官方 GitHub 仓库:https://github.com/i486/VxKex
从 Releases 页面下载安装包(.exe)。
⚠️ GitHub 连接问题:如果你在国内或网络环境不好,GitHub 可能打不开或下载很慢。替代方案:
- 使用 GitHub 镜像站(如 ghproxy.com 等)
- 让朋友帮忙下载后 U 盘拷贝
- 在 Gitee 等平台搜索是否有镜像
2.2 安装 VxKex
🔧 手动操作
- 双击下载的安装包
.exe - 按照安装向导完成安装(默认安装到
C:\Program Files\VxKex) - 安装完成后重启电脑(建议,确保兼容层驱动完全加载)
安装后,Windows 会多出一个"VxKex 兼容性管理器"之类的系统功能。之后你可以通过右键任意 .exe → 属性 → 兼容性来为特定程序启用 VxKex 兼容层。
2.3 版本对应关系
| VxKex 版本 | 支持的 Cherry Studio |
|---|---|
| 1.1.2.1428 | 1.7.15 |
| 1.2.1.2229 | 1.9.13(当前推荐搭配) |
VxKex 在持续更新,每次大版本升级都会扩大 Win7 兼容的软件范围。如果将来 AI 软件出新版,可能需要更新 VxKex。
第三步:下载 AI 软件(便携版)
🔧 手动操作
3.1 选择 AI 软件
目前有两个主要选项:
| 软件 | 官网 | 部署方式 | 说明 |
|---|---|---|---|
| Cherry Studio | https://cherryai.com.cn/ | ZIP 便携版(解压即用) | 功能更丰富,支持 MCP、技能、多模型 |
| ChatBox | 官网/GitHub | 安装包(需正式安装) | 更轻量简洁,安装后同样需要 VxKex 兼容层适配 |
3.2 版本选择(以 Cherry Studio 为例)
| 版本 | 推荐度 | 说明 |
|---|---|---|
| 1.9.13 | ⭐⭐⭐ 强烈推荐 | Win7 上最稳定,token 消耗正常 |
| 2.0.14 | ⭐ 不推荐 | 能跑但 token 消耗极高(多路思考并行),预算有限别用 |
| 1.7.15 | ⭐⭐ 可用 | 较旧但稳定 |
3.3 下载方式
Cherry Studio:
⚠️ 只下载 ZIP 绿色便携版(Portable),不要下载安装版。安装版会尝试注册系统服务、写入注册表,在 Win7 + VxKex 下会失败。
ChatBox:
ChatBox 是安装包形式,需要正式安装(类似 VxKex)。安装完成后,同样需要给它的主程序 .exe 启用 VxKex 兼容层(见第四步)。
3.4 放置位置
Cherry Studio(解压):放到路径中不含中文和特殊字符的位置,推荐:
D:\program files\cherrystudio\
ChatBox(安装):按安装向导默认位置即可(通常在 C:\Program Files\ChatBox 或类似路径),记下安装后的主程序 .exe 完整路径,第四步配置兼容层时要用。
为什么 Cherry Studio 推荐放 D 盘?
- C 盘通常是系统盘,空间可能不够
- D 盘通常空间更大
- 某些权限设置下 D 盘读写更顺畅
Cherry Studio 目录结构:
D:\program files\cherrystudio\
├── cherrystudio.exe ← 主程序
├── data\
│ └── Data\
│ ├── Agents\ ← Agent 配置和记忆
│ └── Skills\ ← 技能文件
└── resources\ ← 应用资源
第四步:为各程序启用 VxKex 兼容层
🔧 手动操作
VxKex 安装后,需要对每个需要兼容的 .exe 单独启用兼容层。方法是右键文件 → 属性 → 兼容性选项卡。
4.1 给 AI 软件启用兼容层
- 找到 AI 软件的主程序文件:
- Cherry Studio:D:\program files\cherrystudio\cherrystudio.exe(便携版,你解压的位置)
- ChatBox: 安装后在开始菜单或安装目录找主程序 .exe(通常是C:\Program Files\ChatBox\chatbox.exe或类似路径) - 右键该 .exe → 属性
- 切换到 "兼容性" 选项卡(或 VxKex 相关的选项卡)
- 勾选/启用 VxKex 兼容层
- 点"确定"保存
4.2 给 FFmpeg 启用兼容层(重要!)
FFmpeg 新版本已不能在 Win7 原生运行,必须单独启用兼容层:
- 找到
D:\program files\ffmpeg\bin\ffmpeg.exe - 右键 → 属性 → 兼容性
- 启用 VxKex 兼容层
- 点"确定"
⚠️ 如果还有 ffprobe.exe 也在同目录,建议也一起加上。
4.3 其他可能需要兼容层的工具
| 工具 | 是否需要 | 说明 |
|---|---|---|
| Node.js (node.exe) | 建议加 | 新版 Node.js 可能依赖 Win10 API |
| curl / wget | 一般不需要 | 较老的工具通常原生兼容 |
| Python | 一般不需要 | 3.7 及以下版本原生支持 Win7 |
| GCC / 7-Zip / WinRAR | 一般不需要 | 纯本地工具,无系统 API 依赖 |
不确定就都加上,加了不会有害,只是多一层兼容处理。
4.4 重启电脑
配置完所有程序的兼容层后重启电脑。这一步很重要,跳过可能导致兼容层不生效。
4.5 测试启动
重启后双击 AI 软件的 .exe 启动。如果能正常打开界面,说明兼容层配置成功。
如果打不开,常见原因:
- VxKex 版本和 AI 软件版本不匹配
- 杀毒软件拦截了 VxKex
- 路径中有中文
- 缺少 Visual C++ 运行库(回第一步检查)
- 忘记重启电脑
第五步:配置 MCP 工具
🔧 手动操作
AI 软件启动后,进入设置界面配置 MCP(Model Context Protocol)工具。MCP 是 Agent 能"动手干活"的基础——没有它,Agent 只能聊天不能操作文件。
5.1 启用内置 MCP 工具
在设置中找到 MCP 相关选项,启用以下工具:
| MCP 工具 | 用途 | 必须启用 |
|---|---|---|
| Cherry Claw (claw) | 核心调度:定时任务、通知、配置管理 | ✅ 必须 |
| Filesystem | 文件系统读写:创建/编辑/删除文件 | ✅ 必须 |
| Python Execute | Pyodide Python 沙箱(无需安装 Python) | 推荐 |
| Skills | 技能管理 | 推荐 |
| Browser | 网页浏览 | 可选 |
5.2 配置 Filesystem 权限(关键步骤)
这是最容易漏的一步。 默认情况下 Filesystem 只能访问工作目录,Agent 看不到你放在 D 盘的工具。
在 Filesystem 配置中,将工作区根目录设置为:
D:\program files
这样 Agent 才能读取和操作 D 盘下的所有工具文件。
5.3 加载本技能
在 AI 软件的技能管理中,找到 win7-ai-workstation 技能并手动加载/启用它。
5.4 验证 MCP 连接
在对话中让 Agent 执行一个简单的命令试试:
> "帮我运行一下 echo hello"
如果 Agent 回复了 hello,说明 MCP 链路通了。
第六步:初始化验证
🤖 Agent 可用
AI 软件跑起来、MCP 配好后,让 Agent 运行环境验证脚本:
> "运行一下 check-environment.ps1 看看我的系统环境"
或者直接告诉 Agent:
> "检查一下我的系统环境和已安装的工具"
Agent 会执行 scripts/check-environment.ps1,输出包括:
- 系统版本、位数
- 所有工具的版本(curl/wget/python/node/gcc/7z/rar/ffmpeg)
- TLS 安全协议状态
- 网络连通性
- PowerShell 内置能力测试
根据输出来判断哪些工具还需要部署。
第七步:部署工具链
🔧 手动操作(下载和放置)+ 🤖 Agent 可用(验证和调用)
把所有工具统一部署在 D:\program files\ 下。每个工具都是独立的绿色压缩包,不需要"安装"。
7.1 工具路径规划
所有工具的路径、版本和调用方式最终会记录在 references/tool-paths.md 中(第八步由 Agent 根据你的实际安装情况生成)。
部署时把工具放在你习惯的位置即可,推荐统一放 D:\program files\ 下方便管理。具体放哪、用什么路径,等你装好后告诉 Agent,它会帮你记到 tool-paths.md 里。
7.2 各工具下载来源
| 工具 | 下载地址 | 注意事项 |
|---|---|---|
| curl | https://curl.se/download.html → Windows 选 "curl.exe" i686-w64-mingw32 构建 | 选 x86 版本(i686),不是 x64!x64 版本在 Win7+VxKex 下容易报 DLL 缺失 |
| wget | https://gitlab.com/gnuwin32/wget 或 MSYS2 包管理器 | 用新版 1.21+,旧版 1.10 不支持 HTTPS。文件名注意大小写(新版可能是 Wget.exe 大写 W) |
| Python | https://www.python.org/downloads/ → Windows installer → 选 "Install Now" 后改 portable 模式,或直接下载 embeddable zip | 3.7+ 即可。不需要 pip 装第三方包(Pyodide MCP 可补充) |
| Node.js | https://nodejs.org/dist/ → 选 node-vXX-win-x64.zip 绿色包 |
解压即用,不需要安装器 |
| GCC | CodeBlocks 自带 MinGW bundle:https://www.codeblocks.org/ → 下载时勾选 MinGW | 一次性全齐(gcc + g++ + mingw32-make + cmake + ar + ld) |
| FFmpeg | https://www.gyan.dev/ffmpeg/builds/ → 选 ffmpeg-release-essentials.zip |
⚠️ FFmpeg 新版本已不能在 Win7 原生运行,必须在 VxKex 中添加 FFmpeg 并启用兼容层 |
| 7-Zip | https://www.7-zip.org/ → 下载 .zip 绿色版 | 解压即用 |
| WinRAR | https://www.win-rar.com/ → 下载 .zip 绿色版 | 解压即用 |
7.3 部署方法(以 curl 为例)
- 从上面的地址下载
- 解压到
D:\program files\curl\ - 确保最终路径是
D:\program files\curl\curl.exe - 打开 CMD 测试:
"D:\program files\curl\curl.exe" --version
能看到版本号就说明放对了
其他工具同理:下载 → 解压到目标路径 → CMD 里用完整路径测试。
7.4 FFmpeg 的 VxKex 特殊配置
⚠️ FFmpeg 比较特殊:新版 FFmpeg(2024+)已经不能在 Windows 7 上原生运行了,必须通过 VxKex 兼容层。
操作步骤:
1. 先把 FFmpeg 解压到 D:\program files\ffmpeg\
2. 右键 D:\program files\ffmpeg\bin\ffmpeg.exe → 属性 → 兼容性
3. 启用 VxKex 兼容层
4. 如果有 ffprobe.exe 也在同目录,同样加上
5. 重启电脑
6. 测试:CMD 中输入 "D:\program files\ffmpeg\bin\ffmpeg.exe" -version
能显示版本号不代表转码一定正常——VxKex 兼容性有上限,复杂转码任务可能出问题。遇到异常属于已知限制。
7.5 验证所有工具
💻 命令行:打开 CMD,逐一测试:
"D:\program files\curl\curl.exe" --version
"D:\program files\wget\Wget.exe" --version
"D:\program files\python\python.exe" --version
"D:\program files\nodejs\node.exe" --version
"D:\program files\codeblocks\MinGW\bin\gcc.exe" --version
"D:\program files\7z\7z.exe" ?
"C:\Program Files\WinRAR\Rar.exe" ?
"D:\program files\ffmpeg\bin\ffmpeg.exe" -version
全部能输出版本号 = 工具链部署完成。
也可以让 Agent 运行验证脚本:
> "运行 check-environment.ps1 验证一下所有工具"
第八步:教 Agent 记住工具路径
🔧 手动操作(告诉 Agent)
工具都放好了,但 Agent 不知道它们在哪。你需要告诉 Agent 工具的绝对路径和调用方式。
8.1 调用规范
这些工具都不在系统 PATH 中,Agent 必须用绝对路径 + PowerShell 调用符:
# 格式:& '完整路径' 参数1 参数2
& '<工具完整路径>' <参数...>
具体每个工具的路径和常用调用示例见 references/tool-paths.md(第八步生成后自动包含)。
8.2 让 Agent 记住并生成工具路径文件
在 AI 软件对话中告诉 Agent 你实际安装的工具路径(每个人可能不同):
> "我的电脑是 Windows 7,以下工具不在 PATH 中,需要用绝对路径调用:
> - curl: D:\program files\curl\curl.exe
> - wget: D:\program files\wget\Wget.exe
> - python: D:\program files\python\python.exe
> - node: D:\program files\nodejs\node.exe
> - gcc: D:\program files\codeblocks\MinGW\bin\gcc.exe
> - ffmpeg: D:\program files\ffmpeg\bin\ffmpeg.exe(需 VxKex 兼容层)
> - 7z: D:\program files\7z\7z.exe
> - rar: C:\Program Files\WinRAR\Rar.exe
> 请把这些信息记录到你的 FACT.md 中,以后调用时用绝对路径。"
Agent 会自动更新记忆文件,后续会话就能记住了。
8.3 生成 tool-paths.md
🤖 Agent 可用
告诉 Agent:
> "根据我刚才给你的工具路径信息,在 win7-ai-workstation 技能的 references/ 目录下创建一个 tool-paths.md 文件,把所有工具的路径、版本、调用示例都记录下来,方便以后查找。"
Agent 会生成 references/tool-paths.md,包含:
- 系统信息(OS 版本、架构、PowerShell 版本)
- 每个工具的完整路径和版本
- PowerShell 调用示例
- 常用选项速查(curl/wget/ffmpeg/7z/rar)
这个文件是你的专属配置,不同用户的工具路径可能不同。如果以后升级了某个工具或换了位置,告诉 Agent 更新这个文件就行。
第九步:日常使用
🤖 Agent 可用
到这里,你的 Win7 AI 工作站就搭好了。日常使用中 Agent 可以帮你:
| 任务 | Agent 用什么 |
|---|---|
| 下载文件 | curl / wget |
| 数据处理(JSON/CSV/XML) | PowerShell 内置 / Python (Pyodide) |
| 文件压缩/解压 | 7-Zip / WinRAR |
| 音视频处理 | FFmpeg(VxKex) |
| C/C++ 编译 | GCC |
| 运行 Python/Node 脚本 | python.exe / node.exe |
| 网络请求 | curl / wget / PowerShell Invoke-RestMethod |
| 文件批量操作 | PowerShell 脚本 |
内置脚本参考
技能 scripts/ 目录下包含经过 Win7 实测验证的 PowerShell 脚本模板。
重要:这些脚本是给 Agent 参考复用的,不是让用户手动跑的。用户手动操作时直接用上面的 CMD 命令就行。Agent 加载技能后会自动参考这些脚本来构造正确的 PowerShell 调用。
| 脚本 | 用途 |
|---|---|
| check-environment.ps1 | 全面环境验证(系统+工具+TLS+网络+PS能力) |
| http-download.ps1 | HTTP/HTTPS 文件下载(自动选 curl/wget) |
| http-request.ps1 | PowerShell 内置 HTTP 请求(GET/POST/HEAD/check) |
| file-ops.ps1 | SHA256/Base64/ZIP/JSON校验/CSV统计 |
| file-batch.ps1 | 文件批量操作(搜索/重命名/复制/移动/列表/统计) |
| archive.ps1 | 7z/RAR 压缩解压 |
| ffmpeg-transcode.ps1 | 视频转码/提取音频/裁剪/压缩 |
| run-python.ps1 | Python 脚本执行器 |
| run-node.ps1 | Node.js 脚本执行器 |
| compile-c.ps1 | C/C++ GCC 编译 |
Win7 已知坑(踩过的都记在这里)
| 坑 | 原因 | 规避方法 |
|---|---|---|
$Input/$Output 做参数名导致解析失败 |
PowerShell 保留自动变量 | 改用 $Src/$Dst 等普通名称 |
| ZIP 创建报"文件被另一进程占用" | Win7 下 New-Item/Set-Content 短暂持有目录句柄 |
先写临时文件再 Move-Item,加 200ms 延迟 |
powershell -File 子进程挂起 |
VxKex 环境下嵌套 PowerShell 不稳定 | 用 & powershell -NoProfile ... 方式调用 |
| HTTPS 请求超时 | Win7 默认只开 SSL3/TLS1.0 | 脚本开头必须设 [Net.ServicePointManager]::SecurityProtocol = Tls12 |
| 路径含空格报错 | PowerShell 字符串拼接丢失引号 | 始终用 Join-Path 或单引号包裹完整路径 |
| GBK 终端无法输出 emoji | Windows 中文版控制台编码限制 | 脚本中避免使用特殊 Unicode 字符 |
| MASM 等 16 位 DOS 工具完全不可用 | Windows 7 不再原生支持 16 位程序 | 不要尝试,直接用现代替代方案 |
| Cherry Studio 安装版无法运行 | 安装程序依赖 Win10 系统组件 | 只用便携版(ZIP 绿色包) |
| v2.x token 消耗暴增 | 多路思考并行 + 多次工具调用架构 | 日常用 1.9.13,偶尔尝鲜 2.x |
| FFmpeg 新版不能在 Win7 原生运行 | 新动态链接库依赖 Win10 API | 必须在 VxKex 中添加 FFmpeg 并启用兼容层 |
| 缺少 KB4474419 导致 VxKex 报错 | UCRT 通用 C 运行时未更新 | 第一步必须先装补丁 |
| 缺少 Visual C++ 运行库 | VxKex 和部分工具依赖 | 第一步安装 VC++ 2015-2022 |
PowerShell 内置能力速查
以下功能不需要任何外部工具,PowerShell 5.1 自带:
- 文件系统操作(创建/读写/遍历目录)
- SHA256/Base64/JSON/XML/CSV 处理
- ZIP 压缩解压(System.IO.Compression)
- 正则表达式/字符串处理
- HTTP GET(Invoke-RestMethod,需先设 TLS 1.2)
- 系统信息查询/时间戳/GUID
疑难解答(FAQ)
操作过程中遇到问题时,先对照这里排查。按你卡在哪一步找对应的 Q&A。
第一步相关:系统环境
Q: 我的 Windows 7 没有 SP1,只有原版 6.1.7600?
A: 必须先安装 SP1。去微软官网搜索 "Windows 7 Service Pack 1" 下载安装。没有 SP1 后面所有补丁和兼容层都装不上。
Q: 怎么确认 KB4474419 装了没有?
A: CMD 输入 wmic qfe list brief | findstr "KB4474419",有输出就是装了。没输出的话去 Microsoft Update 手动搜索安装。
Q: Visual C++ 运行库装了几个版本的冲突怎么办?
A: 不会冲突。微软的 VC++ 运行库是共存的,可以同时装 2015、2017、2019、2022 多个版本。直接装最新的 2015-2022 包就行,它包含了 2015/2017/2019/2022 全部运行时。
Q: .NET Framework 4.8 安装失败提示"此更新不适用于你的计算机"?
A: 通常是系统太旧,缺前置补丁。先跑一遍 Windows Update 把所有可用更新装上,再重试 .NET 4.8 安装。
Q: PowerShell 升级后还是显示 2.0?
A: 三个常见原因:
1. 没重启——WMF 5.1 装完必须重启才生效
2. 打开了旧的 CMD 窗口——重启前打开的 CMD 还是老版本,关掉重开一个
3. 选错了 WMF 文件——64 位系统要用 Win7AndW2K8R2-KB3191566-x64.zip,不是 x86 版本
Q: 运行 Install-WMF5.1.ps1 时报错"禁止运行脚本"?
A: 忘了先执行 Set-ExecutionPolicy RemoteSigned -Force。在管理员 PowerShell 里先跑这条命令,再运行安装脚本。
第二步相关:VxKex
Q: GitHub 打不开 / 下载 VxKex 很慢?
A: 三种办法:
1. 用 GitHub 镜像加速站(搜索 "ghproxy" 或 "github 加速")
2. 让网络好的朋友帮忙下载,U 盘拷过来
3. 在 Gitee 等平台搜有没有人做了镜像
Q: VxKex 安装后重启,桌面多了个图标但不知道怎么用?
A: VxKex 不需要你手动"打开"它来运行程序。它的工作原理是:右键任意 .exe → 属性 → 兼容性选项卡,在那里勾选启用 VxKex 兼容层。之后双击那个 .exe 就会自动通过 VxKex 运行。
Q: 右键 .exe 属性里看不到"兼容性"或 VxKex 选项?
A: 说明 VxKex 没装好。重新运行 VxKex 安装包,确认安装成功。如果装了还是看不到,可能是杀软拦截了 VxKex 的系统组件注册,暂时关杀软重装试试。
第三步相关:AI 软件
Q: Cherry Studio 下载下来有两个 .exe,该点哪个?
A: 点主程序 cherrystudio.exe(或 CherryStudio.exe)。另一个通常是卸载器或辅助工具,不用管。
Q: 我下了安装版(Setup.exe),能直接用吗?
A: 不能。 安装版会尝试写注册表、装服务,在 Win7+VxKex 下会失败或产生残留。必须用 ZIP 绿色便携版。如果已经误装了,卸载干净后重新下载 ZIP 版。
Q: 解压后双击 cherrystudio.exe 闪退/没反应?
A: 大概率是没给这个 .exe 启用 VxKex 兼容层。回第四步:右键 cherrystudio.exe → 属性 → 兼容性 → 启用 VxKex → 确定 → 再试。
第四步相关:兼容层配置
Q: 给 cherrystudio.exe 启用了 VxKex,双击还是打不开?
A: 逐步排查:
1. 重启了吗? 启用兼容层后建议重启
2. 路径有中文吗? D:\程序\cherrystudio\ 这种不行,改成 D:\program files\cherrystudio\
3. 杀软拦截? 暂时完全关闭杀毒软件(不是只关实时防护,是退出整个程序),再试
4. VxKex 版本对吗? Cherry Studio 1.9.13 需要 VxKex 1.2.1.2229+
5. VC++ 运行库装了吗? 回第一步检查
Q: FFmpeg 加了兼容层,ffmpeg -version 能出来,但转码就报错?
A: 这是 VxKex 的已知限制。FFmpeg 新版本依赖的某些 Win10 API 在 VxKex 下不完全兼容。简单操作(提取音频、查看信息)通常没问题,复杂转码(多滤镜链、GPU 加速)可能出错。遇到这种情况属于正常现象,不是你的操作问题。
Q: 我需要给每个工具都加 VxKex 兼容层吗?
A: 不一定。一般规则:
- 必须加:FFmpeg(新版不能在 Win7 原生跑)
- 建议加:Node.js(新版可能依赖 Win10 API)
- 不用加:curl、wget、Python 3.7、GCC、7-Zip、WinRAR(这些本身支持 Win7)
- 不确定就加上,不会有害
第五步相关:MCP 配置
Q: MCP 在哪里设置?找不到入口?
A: Cherry Studio 中通常在 设置 → MCP / 工具 / 插件 之类的菜单里。不同版本菜单位置略有不同,找带 "MCP" 或 "Tools" 字样的选项。ChatBox 是安装版,配置方式和 Cherry Studio 类似,在设置里找对应的工具/扩展选项即可。
Q: Filesystem 工作区设成了 D:\program files,但 Agent 还是说"权限不足"?
A: 确认两件事:
1. 路径写的是 D:\program files(不是 D:\program files\ 带斜杠,也不是 D:/program files 用正斜杠)
2. 修改后重启 Cherry Studio 才生效
Q: 怎么加载 win7-ai-workstation 技能?
A: 在 Cherry Studio 的 技能管理 界面找到它,点击启用/加载。如果列表里没有,确认技能文件夹确实在 data\Data\Skills\win7-ai-workstation\ 目录下且有 SKILL.md 文件。
第六步相关:初始化验证
Q: Agent 运行 check-environment.ps1 说"找不到文件"?
A: 两个可能:
1. 技能没加载成功——Agent 不知道脚本在哪
2. Filesystem 工作区没配对——Agent 看不到 D 盘的文件
先确认技能已加载,再确认 Filesystem 工作区是 D:\program files。
Q: 验证脚本显示某个工具 "N/A not found"?
A: 说明那个工具还没部署,或者路径不对。回第七步,把缺失的工具下载放好,再让 Agent 重新验证。
第七步相关:工具部署
Q: curl --version 报 "not a valid Win32 application"?
A: 你下载的是 x64 版本,Win7+VxKex 下不兼容。重新下载 i686-w64-mingw32(x86)版本。
Q: wget 下载 https:// 的网站报 "Unsupported scheme"?
A: 你用的是旧版 wget(1.10),不支持 HTTPS。换新版 Wget.exe(1.21+),或者直接改用 curl(curl 对 HTTPS 支持更好)。
Q: Python 版本太低(3.5/3.6),很多库不支持?
A: 3.7 是最低要求。去 python.org 下载 3.7.x 或更高版本的 embeddable zip 包替换。注意不要装太新的版本(3.12+),那些可能又依赖 Win10 API 了。
Q: GCC 编译时报 "mingw32-make: command not found"?
A: mingw32-make 不在 PATH 里。用完整路径调用:& 'D:\program files\codeblocks\MinGW\bin\mingw32-make.exe'。或者确认你用的 CodeBlocks MinGW bundle 里确实有这个文件。
Q: 工具都放好了,CMD 里测试都能输出版本号,但 Agent 调用时还是报错?
A: 最常见的原因是 Agent 用的路径和你实际放置的路径不一致。打开 references/tool-paths.md 核对一下路径是否完全匹配(包括大小写、空格、盘符)。
第八步相关:教 Agent
Q: 告诉了 Agent 工具路径,但新开对话后又忘了?
A: Agent 的记忆存在 FACT.md 里。如果新对话还是忘了,可能是:
1. FACT.md 没保存成功——让 Agent 读一下自己的 FACT.md 确认内容在
2. 对话太长被截断了——开个新对话,第一句就说"读取你的 FACT.md 确认工具路径"
Q: tool-paths.md 里记录的路径和我实际的不一样?
A: 直接告诉 Agent 正确的路径,让它更新 tool-paths.md。比如:"我的 curl 实际上在 E:\tools\curl.exe,更新一下 tool-paths.md"。
通用问题
Q: 操作到一半想重来,怎么清理?
A: 各步骤独立,可以单独重做某一步:
- 重装 VxKex:控制面板卸载 → 重新安装
- 重装 AI 软件:删除 D:\program files\cherrystudio\ 整个目录 → 重新解压
- 重装某个工具:删除对应目录 → 重新下载解压
- 不需要重装系统的情况下,以上操作互不影响
Q: 我能只装部分工具吗?比如只要 curl 和 Python?
A: 完全可以。工具之间没有依赖关系,按需部署就行。第七步的速查表标了优先级,高优先级的先装,按需的以后再加。
Q: 整个过程大概需要多长时间?
A: 顺利的话 1-2 小时(主要时间花在下载和重启上)。如果网络慢或反复排错,可能半天。建议找一个完整的下午来做,中间要重启好几次。
参考资料
- 工具路径详细记录:
references/tool-paths.md(第八步初始化后由 Agent 生成) - VxKex GitHub:https://github.com/i486/VxKex
- Cherry Studio 官网:https://cherryai.com.cn/
- curl 下载:https://curl.se/download.html
- wget 下载:https://gitlab.com/gnuwin32/wget
- Python 下载:https://www.python.org/downloads/
- Node.js 下载:https://nodejs.org/dist/
- FFmpeg 下载:https://www.gyan.dev/ffmpeg/builds/
- 7-Zip 下载:https://www.7-zip.org/
- WinRAR 下载:https://www.win-rar.com/
- Visual C++ 运行库:https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist