# pi-cc-theme

[中文](#中文)

Full TUI theme companion to [pi-cc-header](https://github.com/eriiic7z/pi-cc-header) — animated Pi logo header bundled with a blue accent color scheme.

## Features

- 14-frame pixel-animated Pi logo header
- All pi-cc-header commands and configuration fully available
- Blue accent theme (accent, syntax highlight, links)
- All other TUI colors inherit your existing theme
- Auto clear-screen and quiet startup on every session

## Commands

| Command | Description |
| --- | --- |
| `/hl` | Toggle IBM-style horizontal stripes |
| `/hc r/o/y/g/b/p/w` | Set logo color |
| `/hv` | Cycle version color: OFF → Pi only → Pi+ver |
| `/hg` | Toggle 24-bit gradient |
| `/htg` | Enable / disable pi-cc-header |
| `/hdf` | Reset to developer defaults |

### Disabled state

When disabled (`/htg`), all style commands are locked to prevent blind configuration. Use `/htg` again to re-enable.

`/reload` and restart preserve the enabled/disabled state.

## Auto behavior

- Force `quietStartup = true` on every session start
- Force clear scrollback on every session start

## Syncing from pi-cc-header

### One-time setup

```bash
git remote add upstream git@github.com:eriiic7z/pi-cc-header.git
```

### Sync

```bash
git fetch upstream
git merge upstream/main
```

### Resolve conflicts

`package.json`, `README.md`, `CHANGELOG.md` will conflict after every merge.
Keep pi-cc-theme's versions:

```bash
git checkout --theirs package.json README.md CHANGELOG.md
git add package.json README.md CHANGELOG.md
git commit -m "merge upstream/main"
```

Other files (e.g. `extensions/pi-cc-header.ts`) merge automatically.

## Credits

Logo animation adapted from [pi.dev/install.sh](https://pi.dev/install.sh).

---

## 中文

[pi-cc-header](https://github.com/eriiic7z/pi-cc-header) 的配套全 TUI 主题——动画 Pi logo header + 蓝色配色方案。

## 功能

- 14 帧像素 Pi logo 动画 header
- 完整保留 pi-cc-header 的所有命令和配置功能
- 蓝色强调色主题（accent、语法高亮、链接）
- 其余 TUI 颜色继承你已有的主题
- 每次启动强制清屏并静默启动

## 命令

| 命令 | 说明 |
| --- | --- |
| `/hl` | 开关 IBM 横线 |
| `/hc r/o/y/g/b/p/w` | 设置 logo 颜色 |
| `/hv` | 切换版本号颜色模式 |
| `/hg` | 开关渐变 |
| `/htg` | 启用 / 禁用 pi-cc-header |
| `/hdf` | 恢复开发者默认配置 |

### 禁用状态

禁用后（`/htg`），所有样式命令会被锁定，防止盲操配置。重新执行 `/htg` 即可恢复。

`/reload` 和重启均保持当前的启用/禁用状态。

## 自动行为

- 每次启动强制 `quietStartup = true`
- 每次启动强制清屏

## 从 pi-cc-header 同步

### 一次性设置

```bash
git remote add upstream git@github.com:eriiic7z/pi-cc-header.git
```

### 同步

```bash
git fetch upstream
git merge upstream/main
```

### 解决冲突

merge 后 `package.json`、`README.md`、`CHANGELOG.md` 会发生冲突。保留 pi-cc-theme 的版本：

```bash
git checkout --theirs package.json README.md CHANGELOG.md
git add package.json README.md CHANGELOG.md
git commit -m "merge upstream/main"
```

其他文件（如 `extensions/pi-cc-header.ts`）会自动合并。

## 致谢

Logo 动画取自 [pi.dev/install.sh](https://pi.dev/install.sh)。