# Deployment Release

> 部署與發布指引 - 用於建置 Go CLI、打包應用程式、版本管理、發布流程和更新文件 Use when this capability is needed.

- Skill: `tomevault-io/deployment-release` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/deployment-release`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/deployment-release/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/deployment-release

---


# 部署與發布 Skill

## 何時使用此 Skill

當需要：
1. **建置 Go CLI**（編譯 classifier.exe）
2. **打包應用程式**（包含所有相依檔案）
3. **版本管理**（更新版本號、CHANGELOG）
4. **發布新版本**（GitHub Release）

## 建置流程

### 1. 建置 Go CLI

```bash
# Windows
go build -o classifier.exe ./cmd/scanner

# 最佳化建置
go build -ldflags "-s -w" -o classifier.exe ./cmd/scanner
```

> 請建置 `./cmd/scanner` 套件，不要直接指定 `main.go`。

### 2. 執行測試

```bash
# Python 測試
python -m pytest tests/ -v

# Go 測試
go test ./... -v
```

### 3. 更新版本

編輯：`run.py`
```python
# 版本：v6.0.0 → v6.0.1（舉例）
```

### 4. 打包檔案

```
發布檔案/
├── classifier.exe
├── run.py
├── requirements.txt
├── config.ini
├── README.md
├── src/
├── data/
└── logs/
```

若要產生 Windows GUI 發行檔，可使用：

```bash
python -m PyInstaller --clean --noconfirm "女優分類系統_修復版.spec"
```

PyInstaller 只會建立 GUI EXE；若要讓發行資料夾保留 Go 加速功能，需另外複製最新的 `classifier.exe` 到 `dist/`。

## 版本管理

### 語義化版本 (SemVer)

```
v6.0.0
│ │ │
│ │ └─ 修補版本（Bug 修復）
│ └─── 次版本（新功能）
└───── 主版本（重大變更）
```

### CHANGELOG 格式

```markdown
## [5.4.4] - 2025-01-15

### 新增
- 新增 MGS 番號支援

### 修正
- 修復 Journal 損壞問題

### 變更
- 優化搜尋效能
```

## 相關檔案

- `run.py` - 主程式進入點（版本號）
- `CHANGELOG.md` - 變更日誌
- `README.md` - 使用說明

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/cy5407) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->