# pi-fun-placeholder

给 [pi](https://pi.dev) 输入框加随机的趣味提示语。每次会话启动随机选一条，输入框为空时以浅灰色显示在光标之后。中英文各 20+ 条。

## 语言模式

默认 **auto（自动识别）**：检测系统语言环境（`LANG` / `LC_ALL` / `LC_CTYPE`），`zh*` → 中文池，其他 → English 池。

用命令随时切换（选择会持久化到 `~/.pi/agent/fun-placeholder.json`，重启后依然生效）：

| 命令 | 效果 |
| --- | --- |
| `/placeholder` | 查看当前状态与用法 |
| `/placeholder auto` | 恢复自动识别（默认） |
| `/placeholder zh` | 只显示中文提示语 |
| `/placeholder en` | 只显示英文提示语 |
| `/placeholder all` | 中英混合随机 |
| `/placeholder off` | 关闭提示语（输入框恢复正常） |

## 安装

从 npm（发布后）：

```bash
pi install npm:pi-fun-placeholder
```

从本地目录或 git：

```bash
pi install /path/to/pi-fun-placeholder
pi install git:github.com/<you>/pi-fun-placeholder@v1.0.0
```

试试但不持久安装（当前运行一次）：

```bash
pi -e ./index.ts
```

重启 / 重载 pi 后生效（扩展目录中的扩展可 `/reload`，package 安装的扩展重启后生效）。

## 卸载

```bash
pi remove npm:pi-fun-placeholder
```

## 自定义提示语

编辑 `index.ts` 中的 `ZH_PLACEHOLDERS` / `EN_PLACEHOLDERS` 数组，中英文可以随意增删。改完重载 pi 即可（本地安装时直接改包内文件；npm 安装时需发新版本）。

## 从源码开发

源码即运行代码（pi 直接加载 TS，无需构建）。

## 发布

```bash
npm login          # 需要你的 npm 账号
npm version patch  # 或 minor / major
npm publish
```

发布前确认 `package.json` 中 `keywords` 含 `pi-package`（供 pi.dev 画廊收录）、LICENSE 持有者信息已填写。

## License

MIT（见 [LICENSE](./LICENSE)）