# pi-deepseek-startup

DeepSeek 品牌启动页 for [Pi](https://pi.dev) 编码代理：鲸鱼启动画面、动画鲸鱼工作指示器，以及配套的 DeepSeek 主题。一个命令即可安装全部三件套。

包含：

| 内容 | 类型 | 位置 |
| --- | --- | --- |
| DeepSeek 启动页 | 启动页（由适配器加载） | `pages/deepseek.ts` |
| startup-ui 适配器 | Pi 扩展 | `extensions/startup-ui.ts` |
| DeepSeek 主题 | 主题 | `themes/deepseek.json` |

## 预览

安装后启动 Pi 看到的 DeepSeek 启动页效果：

![DeepSeek 启动页示例](1.png)

## 安装

```bash
pi install npm:pi-deepseek-startup
```

安装后重启 Pi（或新开会话），启动页会自动生效，并把终端主题切换为 DeepSeek 蓝。

> 如果你已经在用独立的 `startup-ui` 适配器，请勿同时安装本包——它会自带一个同名的适配器，二者会重复注册。
> 只想用页面和主题的话，手动把 `pages/deepseek.ts` 复制到 `~/.pi/agent/extensions/startup-ui/`，把 `themes/deepseek.json` 复制到 `~/.pi/agent/themes/` 即可，无需安装本包。

## 使用

```bash
/setStartUI          # 选择/切换启动页（deepseek、off、reload、status）
/setStartUI deepseek # 直接切到 DeepSeek 启动页
/setStartUI off      # 恢复 Pi 默认界面
/setStartUI status   # 查看适配器状态
```

离开 DeepSeek 启动页时会自动把主题恢复为 `dark`（见 `pages/deepseek.ts` 中的 `NORMAL_THEME`，可改成你自己的主题名）。

## 开发 / 本地试用

不发布也能本地试用：

```bash
pi install ./pi-deepseek-startup     # 本地路径安装
# 或仅本次运行：
pi -e ./pi-deepseek-startup
```

## 发布到 npm

```bash
cd pi-deepseek-startup
npm login                 # 登录你的 npm 账号
npm publish --access public
```

发布后任何人都能 `pi install npm:pi-deepseek-startup`。包名在 `package.json` 的 `name` 字段，可自行改名（建议保留 `pi-` 前缀）。

## 目录结构

```
pi-deepseek-startup/
├── package.json              # pi 清单：extensions + themes
├── extensions/
│   └── startup-ui.ts         # 适配器（发现/调度启动页）
├── pages/
│   └── deepseek.ts           # DeepSeek 启动页
└── themes/
    └── deepseek.json         # DeepSeek 主题
```

页面文件放在 `pages/` 而非 `extensions/`，是因为 Pi 会把 `extensions/` 下的 `.ts` 当作扩展入口加载，而页面文件只是被适配器读取的数据，不是扩展入口。