pi-web (Remote Control Your Pi)
[](https://github.com/timmygod/pi-web/stargazers)
[](https://www.npmjs.com/package/@timmygod/pi-web-local)
[](../../LICENSE)
[](https://t.me/+NJvFOTTa0wNjNTc9)
[English](../../README.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [中文](README.zh.md) · [日本語](README.ja.md) · [Bahasa Indonesia](README.id.md) · **Bahasa Melayu** · [Tiếng Việt](README.vi.md) · [ไทย](README.th.md) · [Filipino](README.fil.md) · [မြန်မာ](README.my.md) · [ភាសាខ្មែរ](README.km.md) · [ລາວ](README.lo.md)
---
Pandu ejen pengekodan [pi](https://pi.dev) anda dari telefon, tablet, atau komputer riba — di mana-mana sahaja dalam rangkaian anda, atau dari jauh melalui Tailscale.
Ia adalah PWA penuh, jadi anda boleh memasangnya dan menggunakannya seperti aplikasi asli pada mana-mana peranti. Anggaplah ia sebagai ruang kerja AI peribadi anda sendiri — seperti Cowork Claude, tetapi dengan pelbagai model — berbual merentas model, mengekod dari telefon anda, atau jadikannya sebagai [pembantu peribadi](../en/personal-assistant.md) yang hidup pada mesin anda.
Jadikannya milik anda: tukar tema dan fon, dan gunakannya dalam bahasa anda sendiri — pi-web disertakan dengan pelbagai bahasa dan anda boleh menambah bahasa anda sendiri. Lebih banyak ciri akan datang, tetapi ia tidak akan menjadi gemuk: apa-apa yang anda tidak perlukan boleh dimatikan dalam tetapan.
## Mengapa edisi model tempatan ini?
pi-web asal kekal sebagai asas upstream untuk ciri dan pembetulan yang dikongsi. Edisi ini mengekalkan pengalaman tersebut, kemudian menambah lapisan kebolehpercayaan untuk model yang berjalan pada mesin anda sendiri atau di tempat lain pada LAN anda—di mana penjanaan sering lebih perlahan, memori adalah terhad, dan konteks yang panjang boleh menghentikan sesi yang sihat.
| Kawasan | pi-web upstream | Edisi ini |
|------|-----------------|--------------|
| Dasar model/runtime | Kelakuan pi-web standard | Mod **Auto / Local / Cloud** setiap sesi, dengan pengesanan tempatan sedar hujung dan ganti tangan manual yang kekal |
| Pengendalian konteks panjang | Kelakuan pemampatan pi biasa | Local Mode memampat secara proaktif pada **65%** dan menyemak semula dalam gelung panggilan alat yang panjang sebelum permintaan pembekal lain |
| Keselamatan pemampatan | Ringkasan standard | Titik pemeriksaan bergolek terhad, satu penulisan semula yang lebih ketat untuk output tidak sah/terhad, dan pengesanan tiada kemajuan dan bukannya pemampatan semula tanpa henti |
| Larian terganggu | Pengendalian pekerja dan ralat biasa | Pemulihan terhad untuk limpahan konteks, penghentian hanya-pemikiran, dan gangguan pengangkutan terpilih, dengan pemutus gelung yang kekal |
| Penyelamatan manual | Butiran konteks standard | **Force Compact** kekal tersedia sebagai laluan pemulihan eksplisit tanpa memadam perbualan |
| Keserasian dan keluaran | Projek asal dan baris keluaran | Langkah keselamatan tempatan sahaja kekal di belakang Local Mode; Cloud Mode mengekalkan kelakuan upstream, dan perubahan upstream disemak dan dikeluarkan di sini secara bebas |
Ini bukan penulisan semula atau pengganti untuk upstream. Ia adalah profil operasi yang diselenggara secara sengaja untuk orang yang menginginkan privasi dan kawalan model tempatan tanpa menerima sesi berjalan lama yang rapuh. Lihat [panduan pengguna](../en/README.md) untuk aliran kerja berorientasikan pengguna dan [pembangunan edisi model tempatan](../../docs/dev/local-llm-development.md) untuk pelaksanaan dan dasar penyegerakan.
> [!WARNING]
> pi-web kini dalam **beta**. Perkara akan berubah dan rosak!
> [!TIP]
> Baru di sini? **[Baca panduan pengguna →](../en/README.md)** untuk lawatan penuh ciri, langkah pemasangan, dan petua. ([Bahasa lain →](../README.md))
## Tangkapan Skrin
Desktop
Mobile PWA
## Bagaimana Ia Saling Melengkapi
```
pi (terminal) Pelayar (telefon / tablet / komputer riba)
│ │
│ menulis JSONL │ HTTP + SSE
▼ ▼
~/.pi/agent/sessions/ ←─── pi-web (pelayan HTTP Go)
│
┌─────────────────┼─────────────────┐
│ │ │
pi --mode rpc fsnotify tailscale serve
(pekerja sembang (muat semula (HTTPS jauh
per-sesi) langsung) melalui MagicDNS)
```
- **pi** menulis JSONL perbualan ke `~/.pi/agent/sessions/` semasa ia bekerja.
- **pi-web** ialah pelayan Go yang membaca fail tersebut, memaparkannya dalam pelayar, dan menstrim kemas kini langsung melalui SSE.
- Pekerja **pi --mode rpc** mengendalikan sembang yang dimulakan oleh pelayar — satu per sesi, dihapuskan selepas 10 minit melahu.
- **fsnotify** memantau direktori sesi supaya pelayar memuat semula dalam milisaat selepas output baharu.
- **Tailscale Serve** menerbitkan pelayan localhost sebagai titik akhir HTTPS pada tailnet anda.
## Pasang
```bash
pi install npm:@timmygod/pi-web-local@beta
```
Itu sahaja — ia memuat turun binari yang sepadan, menyediakan permulaan automatik, dan mendaftarkan perintah `/web`, `/pi-web`, `/remote`, dan `/refresh`.
Setelah dipasang, buka `http://127.0.0.1:31415` dalam pelayar anda. Dari pi, gunakan `/web` untuk membuka sesi semasa dalam pelayar anda dengan serta-merta. Jika Tailscale sedang berjalan pada mesin anda, pi-web secara automatik menerbitkan titik akhir HTTPS pada tailnet anda — gunakan `/remote` dari pi untuk mendapatkan kod QR dan URL untuk mana-mana peranti pada tailnet anda.
> **Akses jauh macOS:** Pasang dan buka Tailscale secara interaktif, luluskan gesaan pentadbir dan log masuk. Kemudian jalankan `/pi-web restart`, diikuti dengan `/remote`.
Untuk pemasangan manual, muat turun binari, atau binaan dari sumber, lihat [user-docs/install.md](../en/install.md).
## Integrasi Pi
Selepas `pi install npm:@timmygod/pi-web-local@beta`, anda mendapat:
| Perintah | Fungsinya |
|----------|-----------|
| `/web` | Buka sesi semasa dalam pelayar anda (sedar SSH: langkau pelayar dan tunjukkan URL sahaja) |
| `/pi-web` | Tunjukkan status, versi, mula/henti/mula semula pelayan, atau kemas kini |
| `/remote` | Tunjukkan kod QR dan URL untuk akses jauh melalui Tailscale |
| `/refresh` | Tarik mesej baharu yang ditulis dari pelayar jauh kembali ke sesi terminal |
**Penajukan automatik** sesi dibina ke dalam pi-web sendiri dan dikonfigurasikan pada halaman `/settings`. Ia **dihidupkan secara lalai** dan menamakan sesi secara automatik. Anda boleh memilih:
- **Bila untuk menajuk** — sekali setiap sesi, atau pada setiap mesej baharu (lalai).
- **Model tajuk** — **heuristik perkataan terbina dalam percuma dan pantas (tiada AI)** secara lalai, atau pilih model (cth. yang kecil/pantas) untuk tajuk yang lebih pintar, ditulis oleh model.
Pakej ini juga memasang binari pi-web ke `~/.pi/agent/bin/pi-web` dan menyediakan permulaan automatik semasa log masuk.
## Permulaan Automatik Semasa Log Masuk
Perintah `pi install npm:@timmygod/pi-web-local@beta` menyediakan ini secara automatik:
| OS | Mekanisme |
|----|-----------|
| macOS | launchd plist di `~/Library/LaunchAgents/com.pi-web.plist` |
| Linux | systemd user service di `~/.config/systemd/user/pi-web.service` |
Untuk menetapkan token untuk akses jauh, cipta `~/.config/pi-web/env`:
```
PI_WEB_TOKEN=token-anda-di-sini
```
Untuk butiran lanjut (persediaan manual, port tersuai, ikatan bukan loopback), lihat [user-docs/install.md](../en/install.md).
## Pembangunan
```bash
make setup # pasang kebergantungan frontend dan muat turun modul Go
make check # ujian/pembinaan frontend + ujian/vet Go
make build # setup jika perlu, bina frontend, kemudian bina ./pi-web
```