# toolkit

**Repository Path**: gpk12/toolkit

## Basic Information

- **Project Name**: toolkit
- **Description**: 开发高频的脚本和自用lib的问工具集
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-24
- **Last Updated**: 2026-10-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dev-hub-toolkit

个人高频开发工具集 — 日常脚本与可复用库。

## 快速开始

**初始化环境**（uv + Python 3.12 + ruff + ipython）

curl:

```powershell
curl.exe -L -o init.ps1 https://gitee.com/gpk12/toolkit/raw/master/scripts/env/init.ps1
```

irm:

```powershell
irm https://gitee.com/gpk12/toolkit/raw/master/scripts/env/init.ps1 | iex
```

**创建项目骨架**（pyproject.toml + .venv）

curl:

```powershell
curl.exe -L -o scaffold.ps1 https://gitee.com/gpk12/toolkit/raw/master/scripts/project-init/scaffold.ps1
```

irm:

```powershell
irm https://gitee.com/gpk12/toolkit/raw/master/scripts/project-init/scaffold.ps1 | iex
```

**配置项目 Jupyter 环境**（ipykernel + jupytext）

curl:

```powershell
curl.exe -L -o jupyter.ps1 https://gitee.com/gpk12/toolkit/raw/master/scripts/project-init/jupyter.ps1
```

irm:

```powershell
irm https://gitee.com/gpk12/toolkit/raw/master/scripts/project-init/jupyter.ps1 | iex
```

> 首次执行可能需要：`Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`
> irm 方式如出现 `#` 开头报错，是 UTF-8 BOM 标记被 iex 误解析，不影响执行

## 完整仓库（需要 launcher 脚本时）

```powershell
git clone https://gitee.com/gpk12/toolkit.git
```

**打包 Windows 可执行文件**（PyInstaller 单文件/目录模式）

```powershell
git clone https://gitee.com/gpk12/toolkit.git
cd toolkit\scripts\build
pack.bat
```

> 产物输出到 `o/dist`，中间文件在 `o/build`

## 脚本一览

| 脚本 | 用途 | 单独下载 |
|------|------|---------|
| `scripts/env/init.ps1` | 安装 uv + Python + ruff + ipython | ✅ |
| `scripts/project-init/scaffold.ps1` | 创建项目骨架 | ✅ |
| `scripts/project-init/jupyter.ps1` | 配置项目 Jupyter 环境 | ✅ |
| `scripts/misc/vscode-clean.ps1` | 彻底清理 VSCode 配置 | ✅ |
| `scripts/build/pack.bat` | PyInstaller 打包（单文件/目录模式） | ❌ 需 git clone |
| `scripts/launcher/opencode.ps1` | OpenCode 启动菜单 | ❌ 需 git clone |
| `scripts/launcher/agents.ps1` | 多 Agent 启动器 | ❌ 需 git clone |
| `lib/` | 可复用库模块 | ❌ 需 git clone |

## 使用示例

```powershell
# 新电脑初始化
.\scripts\env\init.ps1

# 创建新项目
.\scripts\project-init\scaffold.ps1 -Name my-project

# 在项目目录配置 Jupyter
cd my-project
.\scripts\project-init\jupyter.ps1
```

## 版本号规范

每个 `.ps1` 文件头部格式：

```powershell
# v0.1.0
#Requires -Version 5.1
# 简短描述
```

`.bat` 脚本使用 `rem` 注释，不带版本头，配置集中在脚本顶部的配置区。

## 仓库

- **Gitee（主源）**：https://gitee.com/gpk12/toolkit

## License

自用项目。