# @snowdreamtech/unigo-windows-x64 中文文档

规范地址：https://npmcn.com/package/%40snowdreamtech/unigo-windows-x64/

版本：0\.4\.0
npm 元数据更新时间：2026-11-02T11:45:54.401Z
中文译文更新时间：2026-11-02T12:34:49.760Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40snowdreamtech/unigo-windows-x64
原文对照：https://npmcn.com/package/%40snowdreamtech/unigo-windows-x64/?lang=original
项目主页：https://github.com/snowdreamtech/unigo
源码仓库：https://github.com/snowdreamtech/unigo

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：14.8 MB，5 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-07-05T02:03:39.449Z
- 最新版本发布：2026-11-02T11:45:54.085Z
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

Windows x64的unigo二进制文件

## 安装

```sh
npm install @snowdreamtech/unigo-windows-x64
```

也可以使用：`pnpm add @snowdreamtech/unigo-windows-x64`、`yarn add @snowdreamtech/unigo-windows-x64`、`bun add @snowdreamtech/unigo-windows-x64`

## README

# UniGo网站

[![CI Pipeline](https://img.shields.io/github/actions/workflow/status/snowdreamtech/UniGo/ci.yml?branch=main&label=CI%20Pipeline)](https://github.com/snowdreamtech/UniGo/actions/workflows/ci.yml) [![CD Pipeline](https://img.shields.io/github/actions/workflow/status/snowdreamtech/UniGo/cd.yml?branch=main&label=CD%20Pipeline)](https://github.com/snowdreamtech/UniGo/actions/workflows/cd.yml) [![GitHub Pages](https://img.shields.io/github/actions/workflow/status/snowdreamtech/UniGo/pages.yml?branch=main&label=Docs&logo=github)](https://github.com/snowdreamtech/UniGo/actions/workflows/pages.yml) [![CodeQL](https://img.shields.io/github/actions/workflow/status/snowdreamtech/UniGo/codeql.yml?branch=main&label=CodeQL&logo=github)](https://github.com/snowdreamtech/UniGo/actions/workflows/codeql.yml) [![Multi-OS Verified](https://img.shields.io/badge/Verified-Linux%20%7C%20macOS%20%7C%20Windows-blue)](https://github.com/snowdreamtech/UniGo/actions/workflows/ci.yml) [![Security Audit](https://img.shields.io/badge/Security-Zizmor%20%7C%20Trivy%20%7C%20Gitleaks-brightgreen)](https://github.com/snowdreamtech/UniGo/actions/workflows/ci.yml) [![SBOM Available](https://img.shields.io/badge/SBOM-Available-success)](https://github.com/snowdreamtech/UniGo/releases/latest) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/license/MIT) [![Release](https://img.shields.io/github/v/release/snowdreamtech/UniGo?logo=github&sort=semver)](https://github.com/snowdreamtech/UniGo/releases/latest) [![Dependabot Enabled](https://img.shields.io/badge/Dependabot-Enabled-brightgreen?logo=dependabot)](https://github.com/snowdreamtech/UniGo/blob/main/.github/dependabot.yml) [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit) [![GitHub Stars](https://img.shields.io/github/stars/snowdreamtech/UniGo?style=social)](https://github.com/snowdreamtech/UniGo) [![GitHub Issues](https://img.shields.io/github/issues/snowdreamtech/UniGo)](https://github.com/snowdreamtech/UniGo/issues) [![Code Size](https://img.shields.io/github/languages/code-size/snowdreamtech/UniGo)](https://github.com/snowdreamtech/UniGo)

[英语](https://npmcn.com/package/%40snowdreamtech/unigo-windows-x64/README.md) | [简体中文](https://npmcn.com/package/%40snowdreamtech/unigo-windows-x64/README_zh-CN.md)

UniGo是一个快速、灵活的企业级Golang CLI模板，灵感来自UniRTM和helloworld。它为在Go中构建现代命令行应用程序提供了坚实的基础，具有美观的终端输出、结构化日志记录、内置缓存和全面的CI/CD管道。

## 🌟特性

-   **现代CLI架构**：使用Go 1.24+和Cobra构建，提供结构化和可扩展的命令行应用程序框架。
-   **美丽的输出**:利用 `pterm` 用于丰富、多彩和交互式的终端输出。
-   **结构化的日志**：内置对Go标准的支持 `slog` 用于高性能结构化日志的包。
-   **健壮的工具**：包括内置命令，如 `doctor`， `self-update`， `cache`， `config`, `license`.
-   **质量三重保证**： 100%的代码纯度通过IDE检查、预提交钩子和GitHub Actions集成质量门强制执行。
-   **跨平台的准备**：在macOS、Linux和Windows上无缝运行。

## ️建筑与设计

### 概述

当开始新的Go CLI项目时，UniGo被设计用来解决样板问题。它标准化了开发环境、体系结构模式和开箱即用的自动化管道。

### 核心组件

-   **CLI框架**:利用 `spf13/cobra` 和 `spf13/viper` 强大的命令解析和配置管理。
-   **UI &日志**:综合 `pterm` 用于UI组件和 `slog` 用于结构化事件日志记录。
-   **数据库和缓存**： sqlite支持(通过 `modernc.org/sqlite`)本地缓存和事务性数据存储。
-   **任务编排**：配置有 `UniRTM` 用于管理本地开发工作流（检测、测试、验证）。

## 📖使用指南

### 先决条件

-   **运行时**： Go（>= 1.24）。
-   **Git**：需要全局安装git。
-   **UniRTM**：任务执行和编排所需。

### 安装

**通过NPM**：

```sh-session
npm install -g @snowdreamtech/unigo
```

**通过PyPI**：

```sh-session
pip install snowdreamtech-unigo
```

### 快速入门

1.  **安装UniRTM**:确保 `unirtm` 安装在您的系统上。
2.  **初始化**： `unirtm run setup` （引导核心依赖项和钩子）。
3.  **安装**： `unirtm run install` （安装项目依赖项）。
4.  **验证**： `unirtm run verify` （确保一切都是绿色的）。
5.  **构建**： `go build -o unigo main.go`

### 可用命令

-   `unigo version`：打印版本号
-   `unigo doctor`：检查系统健康并诊断问题
-   `unigo self-update`：升级到最新版本
-   `unigo cache`：管理本地缓存
-   `unigo config`：管理配置
-   `unigo license`：管理版权许可头文件

## 推荐操作指南

### 用于检查表

1.  运行 `unirtm run verify` 确保所有质量检验关都是绿色的（运行格式化程序、检查程序、测试和安全审计）。
2.  确保 `CHANGELOG.md` 是更新。

### 故障排除

-   **问题**： `unirtm run verify` 由于测试错误而失败。
    -   **解决方案**确保你的代码通过所有Go语言的单元测试。unix强制执行严格的覆盖和竞争条件检查。
-   **问题**：预提交钩子失败。
    -   **解决方案**钩子通常会自动修复问题（比如格式）。保存修改后的文件并再次提交。

## 🔒安全注意事项

### 安全模型

-   **审计日志记录**：在此期间执行所有关键操作和安全扫描 `verify` 使用以下工具完成任务 `trivy`， `gitleaks`, `govulncheck`.
-   **依赖关系管理**：由Dependabot提供支持，以确保所有依赖项保持最新和安全。

## 🧑‍💻开发指南

### 本地开发设置

```bash
git clone https://github.com/snowdreamtech/UniGo.git
cd UniGo
unirtm run setup
unirtm run install
```

### 🚀代理使用场景

这个 `GITHUB_PROXY` (默认值: `https://gh-proxy.sn0wdr1am.com/`)针对特定的网络加速场景进行了优化。对于不受支持的协议（如Git）误用它将导致错误。

| 场景 | 支持吗? | 示例/说明 |
| :-- | :-- | :-- |
| **发布文件** | ✅是的 | `.../releases/download/v1.0/tool.zip` |
| **源档案** | ✅是的 | `.../archive/master.zip` 或者 `.tar.gz` |
| **直接文件链接** | ✅是的 | `.../blob/master/filename` |
| **Git克隆** | ❌ **否** | 做。 **不** 使用 `git clone` 或者 `insteadOf` 配置。 |
| **项目文件夹** | ❌ **否** | 不支持通过代理浏览/克隆。 |

> \[!重要的) 为了防止破坏工具链(如 `unirtm`)，该模板通过该代理显式禁用Git重定向。它仅用于脚本中的直接HTTP下载。

## 📄许可证

本项目在 **MIT许可证**. 版权所有(c) 2026-至今 [SnowdreamTech Inc .)](https://github.com/snowdreamtech) 看到 [许可证](https://npmcn.com/package/%40snowdreamtech/unigo-windows-x64/LICENSE) 文件以获取完整的许可文本。

## 明星的历史

[![Star History Chart](https://api.star-history.com/image?repos=snowdreamtech/UniGo&type=date&legend=top-left)](https://www.star-history.com/?repos=snowdreamtech%2FUniGo&type=date&legend=top-left)

## 常见问题

### @snowdreamtech/unigo-windows-x64 是什么？

Windows x64的unigo二进制文件

### 如何安装 @snowdreamtech/unigo-windows-x64？

在项目目录运行 npm install @snowdreamtech/unigo-windows-x64，或使用 pnpm add / yarn add / bun add。

### @snowdreamtech/unigo-windows-x64 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/snowdreamtech\_\_unigo-windows-x64 是否存在。

### @snowdreamtech/unigo-windows-x64 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @snowdreamtech/unigo-windows-x64 可以商用吗？

@snowdreamtech/unigo-windows-x64 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @snowdreamtech/unigo-windows-x64 还在维护吗？

最新版本 0\.4\.0 发布于 2026/11/02（1 天前）；至今共发布 12 个版本，其中过去 12 个月发布了 12 个；首次发布于 2026/07/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

