pi-web (Remote Control Your Pi)

[![GitHub stars](https://img.shields.io/github/stars/timmygod/pi-web?style=flat&logo=github&label=stars&cacheSeconds=86400)](https://github.com/timmygod/pi-web/stargazers) [![npm downloads](https://img.shields.io/npm/dw/@timmygod/pi-web-local?label=downloads/wk&color=2ea043&cacheSeconds=86400)](https://www.npmjs.com/package/@timmygod/pi-web-local) [![license MIT](https://img.shields.io/npm/l/@timmygod/pi-web-local?label=license&color=0a7bbb&cacheSeconds=86400)](../../LICENSE) [![Telegram](https://img.shields.io/badge/Telegram-Join-26A5E4?logo=telegram&logoColor=white)](https://t.me/+NJvFOTTa0wNjNTc9) ![platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-555) [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](README.ms.md) · [Tiếng Việt](README.vi.md) · [ไทย](README.th.md) · [Filipino](README.fil.md) · [မြန်မာ](README.my.md) · [ភាសាខ្មែរ](README.km.md) · **ລາວ**
ຂັບເຄື່ອນ [pi](https://pi.dev) ໂຕແທນຂຽນໂຄ້ດຂອງທ່ານຈາກໂທລະສັບ, ແທັບເລັດ, ຫຼື ແລັບທັອບ — ທຸກບ່ອນໃນເຄືອຂ່າຍຂອງທ່ານ, ຫຼື ທາງໄກຜ່ານ Tailscale. ມັນເປັນ PWA ເຕັມຮູບແບບ, ດັ່ງນັ້ນທ່ານສາມາດຕິດຕັ້ງ ແລະ ໃຊ້ມັນຄືກັບແອັບພື້ນເມືອງໃນທຸກອຸປະກອນ. ຄິດວ່າມັນເປັນພື້ນທີ່ເຮັດວຽກ AI ສ່ວນຕົວຂອງທ່ານ — ຄ້າຍກັບ Cowork ຂອງ Claude, ແຕ່ມີຫຼາຍໂມເດວ — ສົນທະນາຂ້າມໂມເດວ, ຂຽນໂຄ້ດຈາກໂທລະສັບຂອງທ່ານ, ຫຼື ປ່ຽນມັນເປັນ [ຜູ້ຊ່ວຍສ່ວນຕົວ](../en/personal-assistant.md) ທີ່ອາໄສຢູ່ໃນເຄື່ອງຂອງທ່ານ. ປັບແຕ່ງມັນໃຫ້ເປັນຂອງທ່ານ: ປ່ຽນຮູບແບບສີສັນ ແລະ ຟອນ, ແລະ ໃຊ້ມັນໃນພາສາຂອງທ່ານເອງ — pi-web ມາພ້ອມກັບຫຼາຍພາສາ ແລະ ທ່ານສາມາດເພີ່ມພາສາຂອງທ່ານໄດ້. ຄຸນສົມບັດເພີ່ມເຕີມກຳລັງຈະມາ, ແຕ່ມັນຈະບໍ່ໃຫຍ່ເກີນໄປ: ສິ່ງໃດກໍຕາມທີ່ທ່ານບໍ່ຕ້ອງການສາມາດປິດໄດ້ໃນການຕັ້ງຄ່າ.
## ເປັນຫຍັງຈຶ່ງເປັນເວີຊັນແບບຈຳລອງທ້ອງຖິ່ນນີ້? pi-web ຕົ້ນສະບັບຍັງຄົງເປັນພື້ນຖານ upstream ສຳລັບຟີເຈີ ແລະ ການແກ້ໄຂທີ່ແບ່ງປັນກັນ. ເວີຊັນນີ້ຮັກສາປະສົບການນັ້ນໄວ້, ຈາກນັ້ນເພີ່ມຊັ້ນຄວາມໜ້າເຊື່ອຖືສຳລັບແບບຈຳລອງທີ່ເຮັດວຽກຢູ່ເທິງເຄື່ອງຂອງທ່ານເອງ ຫຼື ຢູ່ບ່ອນອື່ນໃນ LAN ຂອງທ່ານ—ບ່ອນທີ່ການສ້າງມັກຈະຊ້າກວ່າ, ຄວາມຈຳມີຈຳກັດ, ແລະ ບໍລິບົດທີ່ຍາວອາດເຮັດໃຫ້ session ທີ່ປົກກະຕິຢຸດຊະງັກ. | ຂົງເຂດ | pi-web upstream | ເວີຊັນນີ້ | |------|-----------------|--------------| | ນະໂຍບາຍແບບຈຳລອງ/runtime | ພຶດຕິກຳ pi-web ມາດຕະຖານ | ໂໝດ **Auto / Local / Cloud** ຕໍ່ session, ພ້ອມດ້ວຍການກວດສອບທ້ອງຖິ່ນທີ່ຮູ້ຈັກ endpoint ແລະ ການແທນທີ່ດ້ວຍມືທີ່ຖາວອນ | | ການຈັດການບໍລິບົດຍາວ | ພຶດຕິກຳການຫຍໍ້ pi ປົກກະຕິ | Local Mode ຫຍໍ້ໂດຍກະຕຸລິຍະທີ່ **65%** ແລະ ກວດສອບອີກຄັ້ງພາຍໃນວົງຈອນການເອີ້ນເຄື່ອງມືທີ່ຍາວ ກ່ອນການຮ້ອງຂໍຜູ້ໃຫ້ບໍລິການອື່ນ | | ຄວາມປອດໄພຂອງການຫຍໍ້ | ສະຫຼຸບມາດຕະຖານ | ຈຸດກວດສອບທີ່ໝູນວຽນມີຂອບເຂດ, ການຂຽນໃໝ່ທີ່ເຂັ້ມງວດກວ່າໜຶ່ງຄັ້ງສຳລັບຜົນໄດ້ຮັບທີ່ບໍ່ຖືກຕ້ອງ/ຖືກຈຳກັດ, ແລະ ການກວດສອບບໍ່ມີຄວາມຄືບໜ້າແທນທີ່ການຫຍໍ້ໃໝ່ບໍ່ມີທີ່ສິ້ນສຸດ | | ການເຮັດວຽກທີ່ຖືກຂັດຂວາງ | ການຈັດການ worker ແລະ ຂໍ້ຜິດພາດປົກກະຕິ | ການຟື້ນຟູທີ່ມີຂອບເຂດສຳລັບບໍລິບົດເກີນຂອບເຂດ, ການຢຸດຄິດຢ່າງດຽວ, ແລະ ການຂັດຂວາງການຂົນສົ່ງທີ່ເລືອກ, ພ້ອມດ້ວຍຕົວຕັດວົງຈອນທີ່ຖາວອນ | | ການຊ່ວຍເຫຼືອດ້ວຍມື | ລາຍລະອຽດບໍລິບົດມາດຕະຖານ | **Force Compact** ຍັງສາມາດໃຊ້ໄດ້ເປັນເສັ້ນທາງການຟື້ນຟູທີ່ຊັດເຈນໂດຍບໍ່ລຶບລ້າງການສົນທະນາ | | ຄວາມເຂົ້າກັນໄດ້ ແລະ ການເຜີຍແຜ່ | ໂຄງການຕົ້ນສະບັບ ແລະ ເສັ້ນທາງການເຜີຍແຜ່ | ມາດຕະການປ້ອງກັນສຳລັບທ້ອງຖິ່ນເທົ່ານັ້ນຍັງຄົງຢູ່ຫຼັງ Local Mode; Cloud Mode ຮັກສາພຶດຕິກຳ upstream, ແລະ ການປ່ຽນແປງ upstream ຖືກທົບທວນ ແລະ ເຜີຍແຜ່ຢູ່ທີ່ນີ້ຢ່າງເປັນເອກະລາດ | ນີ້ບໍ່ແມ່ນການຂຽນໃໝ່ ຫຼື ການແທນທີ່ສຳລັບ upstream. ນີ້ແມ່ນໂປຣໄຟລ໌ການເຮັດວຽກທີ່ຖືກບຳລຸງຮັກສາໂດຍມີຈຸດປະສົງ ສຳລັບຄົນທີ່ຕ້ອງການຄວາມເປັນສ່ວນຕົວ ແລະ ການຄວບຄຸມແບບຈຳລອງທ້ອງຖິ່ນ ໂດຍບໍ່ຍອມຮັບ session ທີ່ເຮັດວຽກຢູ່ດົນທີ່ບໍ່ໝັ້ນຄົງ. ເບິ່ງ[ຄູ່ມືຜູ້ໃຊ້](../en/README.md)ສຳລັບ workflow ທີ່ເນັ້ນຜູ້ໃຊ້ ແລະ [ການພັດທະນາເວີຊັນແບບຈຳລອງທ້ອງຖິ່ນ](../../docs/dev/local-llm-development.md)ສຳລັບການນຳໃຊ້ ແລະ ນະໂຍບາຍການຊິງໂຄຣໄນ. > [!WARNING] > pi-web ປັດຈຸບັນຢູ່ໃນສະຖານະ **beta**. ສິ່ງຕ່າງໆຈະມີການປ່ຽນແປງ ແລະ ອາດຈະເສຍ! > [!TIP] > ມາໃໝ່ບໍ? **[ອ່ານຄູ່ມືຜູ້ໃຊ້ →](../en/README.md)** ສຳລັບການທົວຄຸນສົມບັດເຕັມຮູບແບບ, ຂັ້ນຕອນການຕິດຕັ້ງ, ແລະ ເຄັດລັບ. ([ພາສາອື່ນໆ →](../README.md)) ## ພາບໜ້າຈໍ
Desktop
ເດັສທັອບ

Mobile PWA
PWA ມືຖື
## ວິທີການເຮັດວຽກຮ່ວມກັນ ``` pi (terminal) Browser (phone / tablet / laptop) │ │ │ writes JSONL │ HTTP + SSE ▼ ▼ ~/.pi/agent/sessions/ ←─── pi-web (Go HTTP server) │ ┌─────────────────┼─────────────────┐ │ │ │ pi --mode rpc fsnotify tailscale serve (per‑session (live reload) (remote HTTPS chat worker) via MagicDNS) ``` - **pi** ຂຽນ JSONL ການສົນທະນາລົງໃນ `~/.pi/agent/sessions/` ໃນຂະນະທີ່ມັນເຮັດວຽກ. - **pi-web** ແມ່ນເຊີບເວີ Go ທີ່ອ່ານໄຟລ໌ເຫຼົ່ານັ້ນ, ສະແດງຜົນໃນເບົາຣ໌ເຊີຣ໌, ແລະ ສະຕີມການອັບເດດສົດຜ່ານ SSE. - **pi --mode rpc** ຕົວປະມວນຜົນຈັດການການສົນທະນາທີ່ເລີ່ມຈາກເບົາຣ໌ເຊີຣ໌ — ໜຶ່ງຕໍ່ໜຶ່ງເຊສຊັນ, ຖືກຍົກເລີກຫຼັງຈາກບໍ່ມີການເຄື່ອນໄຫວ 10 ນາທີ. - **fsnotify** ເຝົ້າຕິດຕາມໄດເຣັກທໍຣີເຊສຊັນ ເພື່ອໃຫ້ເບົາຣ໌ເຊີຣ໌ໂຫຼດໃໝ່ພາຍໃນມິນລິວິນາທີຫຼັງຈາກມີຜົນລັບໃໝ່. - **Tailscale Serve** ເຜີຍແຜ່ເຊີບເວີ localhost ເປັນຈຸດໝາຍປາຍທາງ HTTPS ເທິງ tailnet ຂອງທ່ານ. ## ການຕິດຕັ້ງ ```bash pi install npm:@timmygod/pi-web-local@beta ``` ພຽງເທົ່ານີ້ — ມັນດາວໂຫຼດໄບນາຣີທີ່ກົງກັນ, ຕັ້ງຄ່າການເລີ່ມອັດຕະໂນມັດ, ແລະ ລົງທະບຽນຄຳສັ່ງ `/web`, `/pi-web`, `/remote`, ແລະ `/refresh`. ເມື່ອຕິດຕັ້ງແລ້ວ, ເປີດ `http://127.0.0.1:31415` ໃນເບົາຣ໌ເຊີຣ໌ຂອງທ່ານ. ຈາກ pi, ໃຊ້ `/web` ເພື່ອເປີດເຊສຊັນປັດຈຸບັນໃນເບົາຣ໌ເຊີຣ໌ຂອງທ່ານທັນທີ. ຖ້າ Tailscale ກຳລັງເຮັດວຽກຢູ່ໃນເຄື່ອງຂອງທ່ານ, pi-web ຈະເຜີຍແຜ່ຈຸດໝາຍປາຍທາງ HTTPS ເທິງ tailnet ຂອງທ່ານໂດຍອັດຕະໂນມັດ — ໃຊ້ `/remote` ຈາກ pi ເພື່ອຮັບລະຫັດ QR ແລະ URL ສຳລັບອຸປະກອນໃດໆເທິງ tailnet ຂອງທ່ານ. > **ການເຂົ້າເຖິງຈາກໄລຍະໄກໃນ macOS:** ຕິດຕັ້ງ ແລະ ເປີດ Tailscale ແບບໂຕ້ຕອບ, ອະນຸມັດຄຳຮ້ອງຂໍສິດຜູ້ບໍລິຫານ ແລະ ເຂົ້າສູ່ລະບົບ. ຈາກນັ້ນໃຫ້ແລ່ນ `/pi-web restart` ແລ້ວຕາມດ້ວຍ `/remote`. ສຳລັບການຕິດຕັ້ງແບບກຳນົດເອງ, ການດາວໂຫຼດໄບນາຣີ, ຫຼື ການສ້າງຈາກຊອສໂຄ້ດ, ເບິ່ງ [user-docs/install.md](../en/install.md). ## ການເຊື່ອມໂຍງກັບ Pi ຫຼັງຈາກ `pi install npm:@timmygod/pi-web-local@beta`, ທ່ານຈະໄດ້ຮັບ: | ຄຳສັ່ງ | ສິ່ງທີ່ມັນເຮັດ | |---------|--------------| | `/web` | ເປີດເຊສຊັນປັດຈຸບັນໃນເບົາຣ໌ເຊີຣ໌ຂອງທ່ານ (ຮັບຮູ້ SSH: ຂ້າມເບົາຣ໌ເຊີຣ໌ ແລະ ສະແດງພຽງ URL) | | `/pi-web` | ສະແດງສະຖານະ, ເວີຊັນ, ເລີ່ມ/ຢຸດ/ເລີ່ມໃໝ່ເຊີບເວີ, ຫຼື ອັບເດດ | | `/remote` | ສະແດງລະຫັດ QR ແລະ URL ສຳລັບການເຂົ້າເຖິງທາງໄກຜ່ານ Tailscale | | `/refresh` | ດຶງຂໍ້ຄວາມໃໝ່ທີ່ຂຽນຈາກເບົາຣ໌ເຊີຣ໌ທາງໄກກັບເຂົ້າມາໃນເຊສຊັນເທີມິນອລ | ການ **ຕັ້ງຊື່ອັດຕະໂນມັດ** ຂອງເຊສຊັນຖືກສ້າງຢູ່ໃນ pi-web ເອງ ແລະ ຕັ້ງຄ່າໄດ້ທີ່ໜ້າ `/settings`. ມັນ **ເປີດໃຊ້ຕາມຄ່າເລີ່ມຕົ້ນ** ແລະ ຕັ້ງຊື່ເຊສຊັນໂດຍອັດຕະໂນມັດ. ທ່ານສາມາດເລືອກ: - **ເວລາໃດທີ່ຈະຕັ້ງຊື່** — ຄັ້ງດຽວຕໍ່ເຊສຊັນ, ຫຼື ທຸກຄັ້ງທີ່ມີຂໍ້ຄວາມໃໝ່ (ຄ່າເລີ່ມຕົ້ນ). - **ໂມເດວຕັ້ງຊື່** — ໃຊ້ການວິເຄາະຄຳສັບທີ່ສ້າງມາໃນຕົວຟຣີ, ທັນທີ **(ບໍ່ໃຊ້ AI)** ຕາມຄ່າເລີ່ມຕົ້ນ, ຫຼື ເລືອກໂມເດວ (ເຊັ່ນ ໂຕນ້ອຍ/ໄວ) ສຳລັບຊື່ທີ່ຂຽນໂດຍໂມເດວທີ່ສະຫຼາດກວ່າ. ແພັກເກດຍັງຕິດຕັ້ງໄບນາຣີ pi-web ໄປທີ່ `~/.pi/agent/bin/pi-web` ແລະ ຕັ້ງຄ່າການເລີ່ມອັດຕະໂນມັດເມື່ອເຂົ້າສູ່ລະບົບ. ## ການເລີ່ມອັດຕະໂນມັດເມື່ອເຂົ້າສູ່ລະບົບ ຄຳສັ່ງ `pi install npm:@timmygod/pi-web-local@beta` ຕັ້ງຄ່າສິ່ງນີ້ໂດຍອັດຕະໂນມັດ: | OS | ກົນໄກ | |----|-----------| | macOS | launchd plist ທີ່ `~/Library/LaunchAgents/com.pi-web.plist` | | Linux | systemd user service ທີ່ `~/.config/systemd/user/pi-web.service` | ເພື່ອຕັ້ງໂທເຄັນສຳລັບການເຂົ້າເຖິງທາງໄກ, ສ້າງ `~/.config/pi-web/env`: ``` PI_WEB_TOKEN=your-token-here ``` ສຳລັບລາຍລະອຽດເພີ່ມເຕີມ (ການຕັ້ງຄ່າແບບກຳນົດເອງ, ພອດທີ່ກຳນົດເອງ, ການຜູກທີ່ບໍ່ແມ່ນ loopback), ເບິ່ງ [user-docs/install.md](../en/install.md). ## ການພັດທະນາ ```bash make setup # ຕິດຕັ້ງ dependencies ຝັ່ງໜ້າບ້ານ ແລະ ດາວໂຫຼດ Go modules make check # ທົດສອບ/ສ້າງຝັ່ງໜ້າບ້ານ + Go test/vet make build # ຕັ້ງຄ່າຖ້າຈຳເປັນ, ສ້າງຝັ່ງໜ້າບ້ານ, ແລ້ວສ້າງ ./pi-web ```