Skip to content

Latest commit

 

History

History
118 lines (82 loc) · 11.6 KB

File metadata and controls

118 lines (82 loc) · 11.6 KB

pi-web (Remote Control Your Pi)

បើកបរភ្នាក់ងារសរសេរកូដ pi របស់អ្នកពីទូរសព្ទ ថេប្លេត ឬកុំព្យូទ័រយួរដៃ — គ្រប់ទីកន្លែងនៅលើបណ្តាញរបស់អ្នក ឬពីចម្ងាយតាមរយៈ Tailscale។

វាជា PWA ពេញលេញ ដូច្នេះអ្នកអាចដំឡើងវា និងប្រើវាដូចជាកម្មវិធីដើមនៅលើឧបករណ៍ណាមួយ។ គិតថាវាជាកន្លែងធ្វើការ AI ផ្ទាល់ខ្លួនរបស់អ្នក — ដូចជា Cowork របស់ Claude ប៉ុន្តែមានម៉ូដែលផ្សេងៗ — ជជែកឆ្លងម៉ូដែល សរសេរកូដពីទូរសព្ទរបស់អ្នក ឬប្រែក្លាយវាទៅជាជំនួយការផ្ទាល់ខ្លួនដែលរស់នៅលើម៉ាស៊ីនរបស់អ្នក។

ធ្វើឱ្យវាក្លាយជារបស់អ្នក៖ ប្តូរស្បែក និងពុម្ពអក្សរ ហើយប្រើវាជាភាសារបស់អ្នកផ្ទាល់ — pi-web ភ្ជាប់មកជាមួយភាសាច្រើន ហើយអ្នកអាចបន្ថែមភាសាផ្ទាល់ខ្លួនរបស់អ្នកបាន។ មុខងារជាច្រើនទៀតកំពុងមកដល់ ប៉ុន្តែវានឹងមិនធ្វើឱ្យធុញទេ៖ អ្វីដែលអ្នកមិនត្រូវការ អាចបិទបាននៅក្នុងការកំណត់។

Warning

pi-web បច្ចុប្បន្នស្ថិតក្នុងដំណាក់កាល beta។ អ្វីៗនឹងផ្លាស់ប្តូរ និងខូច!

Tip

ថ្មីនៅទីនេះ? អានការណែនាំអ្នកប្រើ → សម្រាប់ដំណើរទស្សនាពេញលេញនៃមុខងារ ជំហានដំឡើង និងគន្លឹះនានា។ (ភាសាផ្សេងទៀត →)

រូបថតអេក្រង់

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 កម្មករគ្រប់គ្រងការជជែកដែលផ្តួចផ្តើមដោយកម្មវិធីរុករក — មួយក្នុងមួយសម័យ បិទបន្ទាប់ពីទំនេរ ១០ នាទី។
  • fsnotify ឃ្លាំមើលថតសម័យ ដូច្នេះកម្មវិធីរុករកផ្ទុកឡើងវិញក្នុងរយៈពេលមីលីវិនាទីនៃលទ្ធផលថ្មី។
  • Tailscale Serve ផ្សព្វផ្សាយម៉ាស៊ីនបម្រើ localhost ជាចំណុចបញ្ចប់ HTTPS នៅលើ tailnet របស់អ្នក។

ដំឡើង

pi install npm:@ygncode/pi-web@beta

នោះហើយជាវា — វាទាញយក binary ដែលត្រូវគ្នា រៀបចំការចាប់ផ្តើមដោយស្វ័យប្រវត្តិ និងចុះឈ្មោះពាក្យបញ្ជា /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។

សម្រាប់ការដំឡើងដោយដៃ ការទាញយក binary ឬការបង្កើតពីកូដប្រភព សូមមើល user-docs/install.md។

សមាហរណកម្ម Pi

បន្ទាប់ពី pi install npm:@ygncode/pi-web@beta អ្នកទទួលបាន៖

ពាក្យបញ្ជា អ្វីដែលវាធ្វើ
/web បើកសម័យបច្ចុប្បន្ននៅក្នុងកម្មវិធីរុករករបស់អ្នក (យល់ដឹងពី SSH៖ រំលងកម្មវិធីរុករក និងបង្ហាញតែ URL)
/pi-web បង្ហាញស្ថានភាព កំណែ ចាប់ផ្តើម/បញ្ឈប់/ចាប់ផ្តើមឡើងវិញម៉ាស៊ីនបម្រើ ឬធ្វើបច្ចុប្បន្នភាព
/remote បង្ហាញកូដ QR និង URL សម្រាប់ការចូលប្រើពីចម្ងាយតាមរយៈ Tailscale
/refresh ទាញសារថ្មីដែលសរសេរពីកម្មវិធីរុករកពីចម្ងាយ ត្រឡប់ចូលទៅក្នុងសម័យ terminal

ការដាក់ចំណងជើងដោយស្វ័យប្រវត្តិ នៃសម័យត្រូវបានបង្កើតឡើងនៅក្នុង pi-web ផ្ទាល់ និងកំណត់រចនាសម្ព័ន្ធនៅលើទំព័រ /settings។ វាត្រូវបាន បើកតាមលំនាំដើម និងដាក់ឈ្មោះសម័យដោយស្វ័យប្រវត្តិ។ អ្នកអាចជ្រើសរើស៖

  • ពេលណាត្រូវដាក់ចំណងជើង — ម្តងក្នុងមួយសម័យ ឬរាល់សារថ្មី (តាមលំនាំដើម)។
  • ម៉ូដែលចំណងជើង — ឥតគិតថ្លៃ រហ័ស វិធីពាក្យដែលភ្ជាប់មកជាមួយ (មិនប្រើ AI) តាមលំនាំដើម ឬជ្រើសរើសម៉ូដែល (ឧ. តូច/លឿន) សម្រាប់ចំណងជើងដែលសរសេរដោយម៉ូដែលឆ្លាតជាង។

កញ្ចប់នេះក៏ដំឡើង binary pi-web ទៅកាន់ ~/.pi/agent/bin/pi-web និងរៀបចំការចាប់ផ្តើមដោយស្វ័យប្រវត្តិនៅពេលចូលប្រព័ន្ធ។

ការចាប់ផ្តើមដោយស្វ័យប្រវត្តិនៅពេលចូលប្រព័ន្ធ

ពាក្យបញ្ជា pi install npm:@ygncode/pi-web@beta រៀបចំវាដោយស្វ័យប្រវត្តិ៖

OS យន្តការ
macOS launchd plist នៅ ~/Library/LaunchAgents/com.pi-web.plist
Linux systemd user service នៅ ~/.config/systemd/user/pi-web.service

ដើម្បីកំណត់ token សម្រាប់ការចូលប្រើពីចម្ងាយ បង្កើត ~/.config/pi-web/env៖

PI_WEB_TOKEN=your-token-here

សម្រាប់ព័ត៌មានលម្អិតបន្ថែម (ការរៀបចំដោយដៃ ច្រកផ្ទាល់ខ្លួន ការភ្ជាប់មិនមែន loopback) សូមមើល user-docs/install.md។

ការអភិវឌ្ឍ

make setup   # ដំឡើង frontend deps និងទាញយក Go modules
make check   # frontend test/build + Go test/vet
make build   # setup បើចាំបាច់ បង្កើត frontend បន្ទាប់មកបង្កើត ./pi-web