Skip to content

README.ms.md

Latest commit

 

History

History
119 lines (83 loc) · 6.54 KB

README.ms.md

File metadata and controls

119 lines (83 loc) · 6.54 KB
Raw

pi-web (Remote Control Your Pi)

Pandu ejen pengekodan pi 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 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.

Warning

pi-web kini dalam beta. Perkara akan berubah dan rosak!

Tip

Baru di sini? Baca panduan pengguna → untuk lawatan penuh ciri, langkah pemasangan, dan petua. (Bahasa lain →)

Tangkapan Skrin

Desktop
Desktop

Mobile PWA
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

pi install npm:@ygncode/pi-web@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.

Integrasi Pi

Selepas pi install npm:@ygncode/pi-web@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:@ygncode/pi-web@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.

Pembangunan

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