wgnr-ai/wgnr-pi
GitHub: wgnr-ai/wgnr-pi
一个双引擎网页 UI,整合本地 Pi 编程代理与云端免费 AI 聊天,解决会话管理与高效编码辅助问题。
Stars: 0 | Forks: 0
# wgnr-pi
**一个双引擎网页 UI,用于 [Pi Coding Agent](https://github.com/badlogic/pi-mono) —— 搭载 [kelle.ai](https://kelle.ai) 提供的免费 AI 聊天**
  
## 快速开始
```
npx wgnr-pi@latest
```
然后在浏览器中打开 [http://localhost:4815](http://localhost:4815)。
## 要求
- [Node.js](https://nodejs.org/) 18+
- 已安装 [Pi Coding Agent](https://github.com/badlogic/pi-mono)(执行 `npm install -g @mariozechner/pi-coding-agent`)
## 功能
### Pi 引擎(本地)
- **会话管理** — 支持按日期分组的浏览、重命名、归档、恢复与删除会话
- **实时流式响应** — 实时观看逐步生成的助手回复
- **模型选择器** — 完整弹窗,支持搜索、提供者分组与视觉能力检测
- **思考等级** — 可切换思考强度(关闭 → 极简 → 低 → 中 → 高)
- **图像支持** — 粘贴或附加图像以供视觉模型使用
- **斜杠命令** — 带全部注册 Pi 命令的自补全面板
- **Markdown 渲染** — 完整 GFM 语法,支持高亮、表格、引用块
- **会话统计** — Token 统计、成本追踪与上下文用量
- **导出功能** — 可将任意会话导出为 JSON
- **移动端适配** — 完整 PWA,支持侧边栏弹窗,适配任意设备
- **自动重启** — macOS launchd 服务,实现后台运行
### kelle.ai 引擎(云端)
由 [kelle.ai](https://kelle.ai) 提供支持的免费 AI 聊天,通过跨站嵌入集成。业务团队 — 四位专业 AI 代理 — 将你的问题路由至合适的专家:
- **品牌策略师** — 定位、信息、竞品分析、品牌语调
- **AI 采用专家** — AI 工具、自动化、实施路线图
- **增长与分析专家** — KPI、仪表盘、转化漏斗、活动衡量
- **内容与文案专家** — 标题、邮件、落地页、广告文案、社媒帖子
支持记忆、会话历史、TTS、文档生成等功能。无需配置 — 直接点击 kelle.ai 标签页即可。
## 配置
所有设置通过环境变量控制:
| 变量 | 默认值 | 说明 |
|---|---|---|
| `WGPI_PORT` | `4815` | 服务端口 |
| `WGPI_HOST` | `0.0.0.0` | 绑定主机 |
| `WGPI_CWD` | `$HOME` | Pi 的工作目录 |
| `WGPI_PI_BIN` | `pi` | Pi 二进制文件路径 |
| `WGPI_KELLE_URL` | `https://agents.kelle.ai` | kelle.ai 基础 URL |
| `WGPI_KELLE_API_KEY` | — | kelle.ai API 密钥(第二阶段) |
## CLI
```
wgnr-pi # Start with defaults
WGPI_PORT=8080 WGPI_CWD=/path wgnr-pi # Custom port and directory
```
## 键盘快捷键
| 按键 | 操作 |
|---|---|
| `Enter` | 发送消息 |
| `Shift+Enter` | 换行 |
| `Escape` | 中止 / 关闭 |
| `Ctrl+N` | 新建聊天 |
| `Ctrl+T` | 切换思考显示 |
| `/` | 斜杠命令 |
| `?` | 帮助 |
## macOS 自动启动
```
# 安装为 launchd 服务(登录时自动启动)
./wgnr-pi.sh install
# 控制
./wgnr-pi.sh start # Start the service
./wgnr-pi.sh stop # Stop the service
./wgnr-pi.sh restart # Restart
./wgnr-pi.sh status # Check if running
./wgnr-pi.sh log # Tail logs
./wgnr-pi.sh dev # Run in foreground
```
## 开发
```
git clone https://github.com/wgnr-ai/wgnr-pi.git
cd wgnr-pi
npm install
npm run dev
```
无需构建步骤,无框架。仅使用原生 JavaScript、Express 与 WebSockets。
## 架构
```
Browser ←WebSocket→ server.js ←JSON-RPC→ pi --mode rpc
↕
/api/kelle/*
↕
agents.kelle.ai (Phase 2)
```
## 为何选择 wgnr-pi?
| 功能 | wgnr-pi | [pi-web](https://github.com/ravshansbox/pi-web) |
|---|---|---|
| 双引擎(Pi + 云端 AI) | ✅ | ❌ |
| 会话归档与恢复 | ✅ | ❌ |
| 会话重命名 | ✅ | ❌ |
| 支持搜索的模型选择器 | ✅ | 基础 |
| 思考等级控制 | ✅ | ❌ |
| 图像粘贴与附加 | ✅ | ❌ |
| 斜杠命令面板 | ✅ | ❌ |
| 完整会话历史 | ✅ | ❌ |
| 导出为 JSON | ✅ | ❌ |
| 移动端 PWA | ✅ | 部分支持 |
| launchd 自动启动 | ✅ | ❌ |
| 零构建步骤 | ✅ | Vite + React + Tailwind |
| 依赖数量 | 4 | 10+ |
## 许可证
[MIT](LICENSE) © [WGNR](https://wgnr.co)
由 [wgnr.ai](https://wgnr.ai) 构建 · 免费 AI 聊天由 [kelle.ai](https://kelle.ai) 提供
标签:4个依赖, AI聊天, AI采用, GFM, GNU通用公共许可证, kelle.ai, macOS launchd, Mac自动启动, Markdown渲染, MITM代理, Node.js, Pi Coding Agent, SEO: AI chat web interface, SEO: Pi Coding Agent UI, SEO: PWA, SEO: wgnr-pi, SEO: 无框架前端, Web界面, 云端引擎, 会话存档, 会话恢复, 会话管理, 低依赖, 免费AI聊天, 双引擎, 后端开发, 命令面板, 品牌战略, 图像粘贴, 增长分析, 思考级别控制, 数据可视化, 斜杠命令, 无构建步骤, 无框架, 本地引擎, 模型搜索, 模型选择器, 移动PWA, 移动响应, 语法高亮, 跨站点嵌入, 附件上传