# hosttools

**Repository Path**: guiyang_zephyr/hosttools

## Basic Information

- **Project Name**: hosttools
- **Description**: No description available
- **Primary Language**: HTML
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-14
- **Last Updated**: 2026-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Zephyr Host Tools 镜像与修复文档

本仓库收录在国内网络环境下使用 **VS Code「Zephyr Workbench」扩展（v3.0.4）** 安装主机工具链（Host Tools）时，常见问题的解决文档与镜像配置。

> ⚠️ 本仓库为**贵阳培训临时镜像/文档仓库**，仅供本次培训、调试使用，后续可能下线，请勿长期依赖。

## 文档索引

| 文档 | 解决的问题 |
| --- | --- |
| [VS Code「Workbench for Zephyr」安装 Host Tools 时下载指向国内镜像（gitee-码云）](./ZephyrHostToolsMirrorConfig.md) | Host Tools 从 GitHub / 7-zip.org / msys2 等境外站点下载**缓慢、卡滞、超时**。通过修改 `tools.yml` 把下载地址改到国内 gitee 镜像 + 配置 pip 阿里云镜像。 |
| [修复 Zephyr Workbench Host Tools Manager 安装失败问题](./FixHostToolManagerInstall.md) | 安装时 `install.ps1` 报错 `Get-ItemProperty : Specified cast is not valid`（检测 7-Zip 读取注册表抛 `InvalidCastException`）。提供安全的注册表查询函数与 patch。 |
| [Host Tools 显示「安装成功 / Up to date」，但依赖未装全（需 Reinstall 一次）](./HostToolsInstallPitfall.md) | 界面 Status 显示 **Up to date**、各项 installed，但 Python venv / pip 依赖其实没装全（如 `Activate.ps1` 缺失）。点 **Reinstall host tools** 重装一次即可解决。 |

## 两类问题的区别

- **下载慢/卡滞** → 是网络/源的问题 → 看[镜像配置文档](./ZephyrHostToolsMirrorConfig.md)。
- **脚本直接报错退出** → 是 `install.ps1` 注册表查询的兼容性 Bug → 看[安装失败修复文档](./FixHostToolManagerInstall.md)。
- **界面显示成功、实际依赖没装全** → Status 是 Up to date 但 venv/pip 依赖残缺 → 看[「假成功」陷阱文档](./HostToolsInstallPitfall.md)，**Reinstall 一次**即可。

三者可同时应用：先改 `tools.yml` 指向国内镜像，再修复 `install.ps1`；若装完界面显示成功却仍报错，则 Reinstall 一次补齐 Python 依赖。

## 目录结构

```text
.
├── README.md                          # 本文件
├── ZephyrHostToolsMirrorConfig.md     # gitee 国内镜像配置说明
├── FixHostToolManagerInstall.md       # install.ps1 安装失败修复说明
├── HostToolsInstallPitfall.md         # 「显示成功但依赖没装全」陷阱说明
├── scripts/                           # 可下载的修复脚本/补丁
│   ├── install-fix.ps1                # ✅ 已应用修复的 install.ps1（直接下载替换）
│   └── install.ps1.patch             # patch 补丁文件
├── pictures/                          # 文档配图
│   ├── HostToolInstallFail.png        # 修复前截图
│   ├── HostToolInstallFix.png         # 修复后截图
│   └── HostToolPitfall.png            # 「假成功」陷阱截图
└── LICENSE
```

## 快速下载

- 📥 修复版安装脚本：[`scripts/install-fix.ps1`](scripts/install-fix.ps1)
- 📥 Patch 补丁：[`scripts/install.ps1.patch`](scripts/install.ps1.patch)