# yo-scripts

**Repository Path**: phyloong/yo-scripts

## Basic Information

- **Project Name**: yo-scripts
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-14
- **Last Updated**: 2026-08-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# yo-scripts

中文 | [English](README.en.md)

PowerShell 个人配置脚本集合。

## 项目简介

yo-scripts 是一个用于个性化 PowerShell 环境的脚本集合，包含常用的别名、环境配置和自定义函数，帮助提升命令行工作效率。

## 包含内容

- **DOLLAR_PROFILE.ps1** - 入口脚本（PSReadLine 配置 + 加载其他脚本）
- **core/** - 核心脚本子目录，入口会自动加载其中的所有 `*.ps1`：
  - **aliases.ps1** - 自定义命令别名
  - **envsetup.ps1** - 环境变量设置
  - **functions.ps1** - 自定义 PowerShell 函数
- **setup.ps1** - 一键配置脚本：把入口自动写入 `$PROFILE`（幂等）

## 使用方法

### 方式零：一键脚本

在仓库根目录运行（用 `pwsh` 还是 `powershell.exe` 取决于要配置哪个宿主的 `$PROFILE`）：

```powershell
pwsh -File .\setup.ps1
```

脚本会自动定位本仓库下的 `powershell\DOLLAR_PROFILE.ps1`、在当前宿主的 `$PROFILE` 末尾追加一行 dot-source（若文件不存在则自动创建），并以一个可识别的注释标记包裹。**幂等**——重复运行会检测到已配置并跳过，不会重复追加。仓库可以放在任意位置。

可选参数：`-ProfilePath <path>` 显式指定要修改的 profile 文件（默认当前会话的 `$PROFILE`）。

### 方式一：一行加载（推荐）

克隆仓库后，在你的 PowerShell 配置文件 `$PROFILE` 中加一行即可（运行 `echo $PROFILE` 查看其路径，不存在则先创建；把 `<仓库路径>` 替换为仓库的绝对路径）：

```powershell
. "<仓库路径>\powershell\DOLLAR_PROFILE.ps1"
```

该入口会自动加载仓库 `core/` 子目录下的核心脚本；并从 `$PROFILE` 所在目录加载 `.completions/`、`.profiles/` 子目录中的脚本（机器本地的补全与片段）。仓库可放在任意位置，无需把仓库脚本复制到 `$PROFILE` 所在目录。

### 方式二：手动加载单个脚本

```powershell
cd <仓库路径>
. .\powershell\core\envsetup.ps1
. .\powershell\core\aliases.ps1
. .\powershell\core\functions.ps1
```

## 许可证

MIT License