unifiles-mcp: Skill for Cursor

Windows PowerShell 工作流

在 Windows PowerShell 环境下执行命令和操作的工作流指南。

核心原则

环境约束

• OS: Windows 11
• Shell: PowerShell 5.1 / 7+
• Python: 必须使用项目虚拟环境 .\.venv\Scripts\

路径规范

• 代码中 (Python): 始终使用正斜杠 / 或 pathlib.Path
• 终端命令中: 注意反斜杠 \ 的兼容性

编码设置

必须设置 UTF-8

执行任何可能输出中文的命令前，必须设置 UTF-8 编码：

chcp 65001; [Console]::OutputEncoding = [System.Text.UTF8Encoding]::UTF8

完整命令模板

chcp 65001; [Console]::OutputEncoding = [System.Text.UTF8Encoding]::UTF8; <your-command>

虚拟环境管理

激活虚拟环境

.\.venv\Scripts\Activate.ps1

检查 Python 版本

.\.venv\Scripts\python.exe --version

安装依赖

.\.venv\Scripts\Activate.ps1; pip install -r requirements.txt

开发依赖：

.\.venv\Scripts\Activate.ps1; pip install -e ".[dev]"

命令执行

链式命令

使用分号 ; 分隔多个命令：

chcp 65001; .\.venv\Scripts\Activate.ps1; python script.py

设置环境变量

$env:VAR_NAME = "value"

检查命令是否存在

Get-Command python -ErrorAction SilentlyContinue

文件操作

创建目录

New-Item -ItemType Directory -Path "path/to/dir"

创建多级目录：

New-Item -ItemType Directory -Path "path/to/dir" -Force

读取文件

Get-Content file.txt

或使用别名：

cat file.txt

写入文件

"content" | Out-File -FilePath "file.txt" -Encoding UTF8

检查文件/目录是否存在

Test-Path "path/to/file"

删除文件

Remove-Item "path/to/file"

删除目录（递归）

Remove-Item "path/to/dir" -Recurse -Force

禁止使用的命令

❌ 严禁使用 Linux 专属命令

• export → 使用 $env:VAR = "value"
• ls -la → 使用 Get-ChildItem 或 ls
• touch → 使用 New-Item -ItemType File
• rm -rf → 使用 Remove-Item -Recurse -Force
• source → 使用 . 或 &
• make → 使用 PowerShell 脚本或直接命令

Python 命令执行

执行 Python 脚本

.\.venv\Scripts\Activate.ps1; python script.py