============================================================
  ZhinanAI Win7 专区 - 修复工具包
  版本: v1.0
  适用: Windows 7 SP1 (x64)
  网站: zhinanai.zhinanbang.cn/win7
============================================================

▎ 这是什么?

  ZhinanAI 在 Windows 7 系统上安装后可能出现"有文件但无法启动"
  的问题。这是因为:

    • PowerShell 2.0 版本过旧, 安装脚本静默失败
    • Hermes 运行时未初始化
    • PATH 环境变量存在重复/冲突

  本工具包可以自动诊断并修复这些问题。

============================================================
▎ 文件说明
============================================================

  修复工具.bat      - 主入口 (双击运行)
                     兼容所有 Windows 版本, 自动检测环境

  诊断-Win7.ps1     - 详细诊断报告生成器
                     兼容 PS 2.0, 生成完整的系统诊断报告

  修复-Win7.ps1     - 自动修复脚本
                     需要 PS 5.1+ 和管理员权限
                     自动: 清理PATH → 验证工具 → 初始化Hermes

  README-Win7专区.txt - 本文件

============================================================
▎ 快速开始
============================================================

  【一键修复】
    1. 右键点击「修复工具.bat」→ 以管理员身份运行
    2. 选择 [1] 自动修复
    3. 如果提示 PowerShell 版本过低, 参照下方「手动升级」步骤
    4. 修复完成后重启计算机

  【仅诊断】
    1. 双击「修复工具.bat」
    2. 选择 [2] 生成详细诊断报告
    3. 将生成的诊断报告发送给技术支持

============================================================
▎ 手动升级 PowerShell (WMF 5.1)
============================================================

  如果自动修复提示 PowerShell 版本过低, 需要先手动升级:

  ▸ 步骤 A: 安装 .NET Framework 4.5.2
  ─────────────────────────────────
  1. 检查是否已安装:
     打开 CMD, 执行:
       reg query "HKLM\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" /v Release

     如果返回的 Release 值 >= 379893, 说明已安装, 跳到步骤 B。

  2. 如未安装, 下载:
     https://download.microsoft.com/download/E/2/1/E21644B5-2DF2-47C2-91BD-63C560427900/NDP452-KB2901907-x86-x64-AllOS-ENU.exe

  3. 运行安装程序, 完成后重启。

  ▸ 步骤 B: 安装 WMF 5.1
  ─────────────────────────────────
  1. 下载 Win7 x64 版本:
     https://download.microsoft.com/download/6/F/5/6F5FF66C-6775-42B0-86C4-47D41F2DA187/Win7AndW2K8R2-KB3191566-x64.zip

  2. 解压 ZIP, 运行里面的 .msu 文件

  3. 安装完成后, 必须重启计算机

  4. 验证:
     打开 CMD, 执行:
       powershell -Command "$PSVersionTable.PSVersion"

     应显示 Major=5, Minor=1

  5. 重新运行本修复工具

============================================================
▎ 手动修复步骤 (供高级用户)
============================================================

  如果不想升级 PowerShell, 可以手动操作:

  ▸ 第一步: 清理重复 PATH
  ─────────────────────────────────
  1. 打开: 控制面板 → 系统 → 高级系统设置 → 环境变量
  2. 在「用户变量」的 PATH 中, 删除旧的 D:\ZhinanAI\* 条目
  3. 保留 C:\Users\...\AppData\Local\ZhinanAI\* 条目
  4. 点击确定保存

  ▸ 第二步: 初始化 Hermes
  ─────────────────────────────────
  1. 打开 CMD, 执行:
       cd /d %LOCALAPPDATA%\ZhinanAI\packages\hermes

  2. 查找 hermes 入口:
       dir /s /b hermes*.exe
       dir /s /b package.json

  3. 如果有 hermes.exe:
       hermes.exe setup --init --yes

  4. 如果是 Node.js 项目:
       %LOCALAPPDATA%\ZhinanAI\packages\node\node.exe init.js

  ▸ 第三步: 运行初始化脚本
  ─────────────────────────────────
  1. 执行:
       cd /d %LOCALAPPDATA%\ZhinanAI\scripts
       dir *.ps1

  2. 找到 first-run-*.ps1 或 hermes-*.ps1, 执行:
       powershell -ExecutionPolicy Bypass -File <脚本名>

  ▸ 第四步: 切换镜像源 (中国大陆用户)
  ─────────────────────────────────
  如果下载依赖时速度慢或连接失败, 可能需要切换镜像源:

  • Python pip 清华源:
    %LOCALAPPDATA%\ZhinanAI\packages\python\python.exe -m pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

  • npm 淘宝源:
    %LOCALAPPDATA%\ZhinanAI\packages\node\npm.cmd config set registry https://registry.npmmirror.com

============================================================
▎ 常见问题
============================================================

  Q: 运行修复工具后仍然无法启动?
  A: 请运行「诊断-Win7.ps1」生成详细报告, 发送给技术支持。
     同时检查:
     - 是否以管理员身份运行了修复工具
     - 内存是否充足 (建议至少 2GB 可用)
     - 杀毒软件是否拦截了 Hermes 进程

  Q: 提示"无法连接到 api.open.bigmodel.cn"?
  A: 这是 ZhinanAI 调用 AI 模型所需的 API 端点。可能原因:
     - 网络代理配置问题
     - 防火墙拦截
     - TLS 1.2 未启用 (Win7 默认未启用)
     解决方法: 参照下方「启用 TLS 1.2」章节

  Q: 我的电脑内存只有 2GB 怎么办?
  A: AI Agent 运行需要较多内存。建议:
     - 关闭其他程序, 释放内存
     - 增加虚拟内存: 系统属性 → 高级 → 性能设置 → 高级 →
       虚拟内存 → 更改 → 自定义大小 → 初始 4096, 最大 8192
     - 考虑升级到 8GB 物理内存

============================================================
▎ 启用 TLS 1.2 (Win7)
============================================================

  Windows 7 默认不启用 TLS 1.2, 可能导致 AI API 调用失败。
  按以下步骤启用:

  1. 下载 MicrosoftEasyFix51044.msi:
     https://download.microsoft.com/download/0/6/5/0658B1A7-6D2E-474F-BC2C-D69E5B9E9A68/MicrosoftEasyFix51044.msi

  2. 运行安装, 重启计算机。

  或者手动修改注册表 (以管理员身份运行 CMD):

    reg add "HKLM\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client" /v DisabledByDefault /t REG_DWORD /d 0 /f

    reg add "HKLM\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client" /v Enabled /t REG_DWORD /d 1 /f

    reg add "HKLM\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server" /v DisabledByDefault /t REG_DWORD /d 0 /f

    reg add "HKLM\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server" /v Enabled /t REG_DWORD /d 1 /f

  修改后必须重启计算机。

============================================================
▎ 系统要求
============================================================

  最低配置:
    操作系统:  Windows 7 SP1 (x64)
    PowerShell: 5.1 (安装 WMF 5.1 后)
    .NET:       4.5.2+
    内存:       4GB (建议 8GB)
    磁盘:       1GB 可用空间

  推荐配置:
    操作系统:  Windows 10/11 (x64)
    内存:       8GB+
    网络:       稳定的互联网连接

============================================================
▎ 技术支持
============================================================

  网站:  zhinanai.zhinanbang.cn
  Win7专区: zhinanai.zhinanbang.cn/win7

  反馈问题时请提供:
    • 诊断报告 (由「诊断-Win7.ps1」生成)
    • 修复日志 (由「修复-Win7.ps1」生成)
    • 错误截图

============================================================
  ZhinanAI Team @ 2026
============================================================
