# pi-ghost-autocomplete

[English](README.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [中文](README.zh-CN.md) | [日本語](README.ja.md) | [Português](README.pt-BR.md) | [Italiano](README.it.md) | [Русский](README.ru.md)

[Pi 编程助手](https://pi.dev/)（`@earendil-works/pi-coding-agent`）的行内幽灵文本自动补全。

当你在 Pi 提示符中输入时，LLM 会预测当前行最可能的续写，并在光标右侧
以灰色"幽灵文本"显示。按**右箭头**接受。

**多语言支持**（Session 52）：Unicode 感知的分词处理中文、日文、韩文
脚本，以及德语变音符号和法语重音。基于寄存器的路由确保散文以原始
语言补全，而不会被重新定义为编程指令。

## 快速开始

### 1. 获取 Mercury Edit 2 API 密钥

```bash
export INCEPTION_API_KEY="你的密钥"
```

### 2. 安装扩展

```bash
pi install npm:pi-ghost-autocomplete
```

### 3. 启动 Pi

```bash
pi
```

## 配置

| 变量 | 默认值 | 效果 |
| --- | --- | --- |
| `PI_GHOST_DISABLED` | 未设置 | 设为 `1` 禁用 |
| `PI_GHOST_PROVIDER` | Mercury Edit 2 | `cloud`、`local` 或 `router` |
| `INCEPTION_API_KEY` | — | API 密钥 |
| `PI_GHOST_CHAT_MAX_TOKENS` | `256` | 聊天令牌上限 |
| `PI_GHOST_CHAT_TEMPERATURE` | `0.75` | 聊天温度 |

> 完整配置参考请参阅[英文 README](README.md#configuration)。

## 寄存器路由

| 寄存器 | 分支 | 系统提示词 |
| --- | --- | --- |
| `code` | **FIM** | 补全代码/命令/路径 |
| `agent-message` | **聊天** | 「继续写给助手的消息」 |
| `general-prose` | **聊天** | 「自然地续写文本，保持相同语言」 |

```bash
PI_GHOST_PROVIDER=router INCEPTION_API_KEY=你的密钥 pi ...
```

## 命令

| 命令 | 效果 |
| --- | --- |
| `/ghost` | 显示配置 |
| `/ghost on` | 本次会话启用 |
| `/ghost off` | 本次会话禁用 |

> 完整文档：[英文 README](README.md) 和 [`docs/`](docs/)。