้ขๅไธชไบบๅผๅ่
็ pi ๆก้ข GUI๏ผๅจ Electron ้่ท pi SDK๏ผๅค็จ ~/.pi/agent ็่ฎค่ฏใ้
็ฝฎไธไผ่ฏ JSONL๏ผ็จๆถ้ด็บฟใๅทฅๅ
ทๅก็ใๆนๅจๅฎกๆฅๅๆฉๅฑๅ
ผๅฎนๅฑๆฟไปฃ็ป็ซฏ้้ฃๅฅ TUI ไบคไบใ
ไธๅฅ่ฏ๏ผpi ็ๆฐๅฃณโโๅ ๆ ธไปๆฏ pi๏ผ็้ขๆขๆๆก้ข๏ผๆฉๅฑๅจ็ป็ซฏ้็ๅผน็ชๅๅก็๏ผ็ฑๅ ผๅฎนๅฑ็ฟป่ฏๆ็ชๅฃ UI๏ผไธๆนไฝ ๅทฒๅฎ่ฃ ็ๆฉๅฑๅ ใ
- ๅฏน่ฏๅ
ๅฎนใๅทฅๅ
ท่ฐ็จ่ฎฐๅฝใๅๆฏไธๅ็ผฉไฟกๆฏ๏ผ้ฝไปฅ pi ๅๅจ
~/.pi/agent/sessions/้็ JSONL ไผ่ฏๆไปถไธบๅใ - ๆก้ข็ซฏไธๅฆๅปบไธๅฅใ่ๅคฉ่ฎฐๅฝๆฐๆฎๅบใๆฅๆฟไปฃ pi๏ผๆฌๅฐๅชๅญ็ชๅฃๅธๅฑใๆ่ฟ้กน็ฎใๆฉๅฑๅผๅ ณใ้้ ๅจ่ฆ็็ญๅบ็จๅๅฅฝใ
- ๅฅฝๅค๏ผ็ป็ซฏ pi ไธๆก้ข pi ๅฏไปฅๆฅ็ๅไธๆกไผ่ฏ็จ๏ผๅธ่ฝฝๆก้ขไนไธไธขๅฏน่ฏๅๅฒใ
- ๆจกๅ่ดฆๅทใ
settings.jsonใๆฉๅฑๅ ๅ่กจ๏ผpackages๏ผใ้กน็ฎไธ.pi/่ตๆบ๏ผไธไฝ ๅจ็ป็ซฏ็จ็ pi ๅไธๅฅ่ทฏๅพไธ่งๅใ - ๆก้ขๅจ ่ฎพ็ฝฎ โ Pi ้ๆน็้กนไผๅๅๅ
จๅฑ
settings.json๏ผไธ็ป็ซฏไธ่ด๏ผ๏ผSkills ๅผๅ ณ็ญไน่ฝๅจๅ จๅฑ้ ็ฝฎ้๏ผ่ไธๆฏๅชๅจๆก้ข็งๆๆไปถ้ใๅๅฏ็จใใ
- ๆฉๅฑๅจ็ป็ซฏ้ๅธธ็จ TUI๏ผ้ๆฉใ็กฎ่ฎคใ้ฎๅทใๅทฅๅ
ท็ปๆๅก็ใ
/ๅฝไปค่ฟ้ ็ฝฎ๏ผใๆก้ขๆฒกๆ็ป็ซฏ็ปๅธใ - ๅ ผๅฎนๅฑ๏ผๅจๅบ็จๅ ้จ็ปไธๆฅๆถๆฉๅฑ็ UI ่ฏทๆฑ๏ผ่ฝฌๆ Electron ๅฏน่ฏๆกใๆถ้ด็บฟๅก็ใ่ฎพ็ฝฎ่กจๅใ
- ้้ ๅจ๏ผๆฏไธชๆฉๅฑไธไปฝใๅจๆก้ขไธๆไนๆพ็คบใๆไน้ ใๅชไบๅฝไปค็นๆฎๅค็ใ็่ฏดๆ๏ผๅ ็ฝฎๅจๅบ็จ้๏ผ้ซ็บง็จๆทๅฏ็จ JSON ่ฆ็๏ผใ
- ๅๅ๏ผไธๅจๆฉๅฑ npm ๅ ใไธ fork pi๏ผๅทฎๅผๅๅจ้้ ๅจ่ฏดๆๅๆๆกฃ้ใ
- ็ป AI ๅ้้
ๅจ๏ผ่งไปๅบ
doc/๏ผadapter-authoring-guide.mdๅฏๆดไปฝๅ็ปๆจกๅๅฎๅถadapter.json๏ผใ
| ้กน | ่ฏดๆ |
|---|---|
| Node.js | 18+๏ผๆจ่ 20+๏ผ |
| npm | ไธไปๅบ package-lock.json ไธ่ด |
| Electron | 35+ |
| ็ณป็ป | Windows 10+ ไธบไธป้ช่ฏ็ฏๅข๏ผmacOS / Linux ๅฏๆๅปบ |
pi ไพง้ๅทฒ้
็ฝฎ่ฎค่ฏ๏ผ~/.pi/agent/auth.json ๆๅๅๅ็ฏๅขๅ้๏ผใๆฉๅฑไธ็ป็ซฏ pi ๅ
ฑ็จ ~/.pi/agent/settings.json๏ผ่ฅ็ป็ซฏ่ฝ็จ็ๆฉๅฑๅจๆก้ขๅทฅๅ
ทๅ่กจ้ๆฒกๆ๏ผ่ง ่ฎพ็ฝฎ โ ๆฉๅฑ ๅๆญฅ packages ๅนถ้ๅฏๅๅฐไผ่ฏใ
git clone https://github.com/justhil/pi-app.git
cd pi-app
npm install
npm run dev้ฆๆฌกไฝฟ็จ
- ็ฃ็้กน็ฎ๏ผไพงๆ ใๆๅผ้กน็ฎใ้ๅทฅไฝ็ฎๅฝใ
- ไธดๆถๅฏน่ฏ๏ผใๅฏน่ฏๅๅบใๆฐๅปบๆฒ็ฎฑ๏ผไธ็ๅฎไปๅบ้็ฆป๏ผๅทฅๅ ท cwd ๅจๅบ็จ็จๆทๆฐๆฎ็ฎๅฝไธ๏ผใ
- ไผ่ฏ๏ผๅ่กจไธญ้ๅๅฒไผ่ฏๆ
+ๆฐๅปบ๏ผๅณ้ฎๅฏ้ๅฝๅ/ๅ ้ค๏ผ็ฃ็้กน็ฎไผๆน pi ไผ่ฏๆไปถ๏ผใ - ่พๅ
ฅๅบ๏ผๅ่ฝฆๅ้๏ผ
/ๆๆ ๅฝไปค๏ผโโ่ฐๅๆฌไผ่ฏๅ้ๅๅฒ๏ผ่งไธ่กจ๏ผ๏ผ่ฟ่กไธญๅฏ็ปง็ปญๅ๏ผๆ้่ท่ฟ๏ผ๏ผๆๅ ฅๆไปถๆ+้้ไปถ๏ผๅฏ็ฒ่ดดๅพ็ใๅฏน่ฏๅบๆฏๆ KaTeX ๅ ฌๅผ๏ผ$$โฆ$$ใ\( โฆ \)็ญ๏ผใ - ๅณๆ ๏ผๆนๅจๅฎกๆฅใ่ฟ่ก็ถๆใไธไธๆใไผ่ฏๆ ๏ผ็ญๅ pi
/treeๅผ่ทณ่ฝฌ๏ผใ็ฉบ็ฝ่พๅ ฅๆถ ๅๅป Esc ๅฏๆๅผไผ่ฏๆ ๆตฎๅฑใ
ๅธธ่ง้ฎ้ข
| ็ฐ่ฑก | ๅปบ่ฎฎ |
|---|---|
| ็ฝๅฑ / ็้ขไธๆดๆฐ | ๅ node_modules/.vite ๅ npm run dev |
| ๆฉๅฑๅจ่ฎพ็ฝฎ้่ฝ็ๅฐ๏ผๅฏน่ฏ้ๆฒกๆๅทฅๅ ท | ่ฎพ็ฝฎ โ ๆฉๅฑ๏ผ็กฎ่ฎคๅทฒๅๅ
ฅ packages ๅนถ้ๅฏไผ่ฏ๏ผ็ใๅฝๅๅทฒๅ ่ฝฝๅทฅๅ
ทใๅ่กจ |
| ๅๆขไผ่ฏๆ ข | ๅ ๅ ่ฝฝๆ่ฟไธๆฎตๅๅฒ๏ผๅ็ฌฌไธๆกๆถๆฏๅๅๅฎๆด็ปๅฎไผ่ฏ๏ผ่ฎพ่ฎกๅฆๆญค๏ผ |
ๆๅ
Windows๏ผnpm run icon:export && npm run package:winใ
| ๆไฝ | ๅฟซๆท้ฎ / ๆนๅผ | ่ฏดๆ |
|---|---|---|
| ๅ้ๆถๆฏ | Enter |
ๅ้ๅฝๅ่พๅ
ฅๆกๅ
ๅฎน๏ผShift+Enter ๆข่ก |
| ๅ้ๅๅฒ | โ / โ |
ๅจ่พๅ
ฅๆก็ฉบใๅ
ๆ ๅจ้กถๆ ผๆๅ
จๆ้ไธญๆถ๏ผโ ็ฟป็ๆฌๅทฅไฝๅบ+ไผ่ฏไธๆ่ฟๅ้่ฟ็ๅ
ๅฎน๏ผโ ๅพๆดๆฐ็ฟปใ็ฌฌไธๆฌก โ ๅไผๆๅฝๅ่็จฟๆๅญ๏ผๅคฑ็ฆๆ่ฟๅ
ฅๅๅฒๆถๅๅ
ฅ๏ผไธๆๆฏไธชๅญๅญ๏ผ๏ผโ ๅๅฐๆๆฐๅฏๆขๅค่ฟไปฝ่็จฟใๆๆ ่กฅๅ
จๆๅผๆถ โโ ไป็จไบ้ๅฝไปค |
| ๆๅๆ้ | Alt+โ |
Agent ่ฟ่กไธญๅทฒๆ้ๆถๆฏๆๅ่พๅ ฅๆกๅๅนถ็ผ่พ |
| ๅๆญข็ๆ | Esc๏ผๅๆฌก๏ผ |
Agent ่ฟ่กไธญๆไธไธ Esc ไธญๆญขๅฝๅ่ฝฎๆฌก |
| ไผ่ฏๆ / ๅ้ | Esc Esc๏ผๅๅป๏ผ |
่พๅ ฅๆกไธบ็ฉบๆถๅๅป Esc ๆๅผไผ่ฏๆ ๆตฎๅฑ๏ผๅฏ่ทณ่ฝฌๅฐไปปๆๅๅฒ่็น |
| ๆๆ ๅฝไปค | / |
่พๅ
ฅ / ่งฆๅๅฝไปค่กฅๅ
จ๏ผๆฉๅฑๅฝไปคใ/newใ/tree ็ญ๏ผ |
| ้ๅ ๆไปถ | ๆๆฝๅฐ่พๅ ฅๆก | ไปๆไปถ็ฎก็ๅจๆๅ
ฅๆไปถ่ชๅจ้ๅ ไธบๅผ็จ๏ผไนๅฏ็น + ๆ้ฎ้ๆฉ |
| ็ฒ่ดดๅพ็ | Ctrl+V |
ๅช่ดดๆฟๆๅพ็ๆถ็ฒ่ดดๅฐ่พๅ ฅๆก๏ผ่ชๅจ่ฝฌไธบ multimodal ่พๅ ฅ |
| ๆ้่ท่ฟ | ่ฟ่กไธญ็ปง็ปญ่พๅ ฅ | Agent ่ฟ่กๆถๅ้็ๆถๆฏๆ้๏ผๅฝๅ่ฝฎๆฌก็ปๆๅ่ชๅจ่ท่ฟ |
| ๆถๆฏๅ้ | ๆฌๅๆถๆฏ โ Undo ๅพๆ | ๆถ้ด็บฟๆถๆฏๆฌๅๅบ็ฐๅ้ๆ้ฎ๏ผ็นๅป่ทณ่ฝฌๅฐ่ฏฅๆถๆฏ่็น |
| ๅคๅถๆถๆฏ | ๆฌๅๆถๆฏ โ Copy ๅพๆ | ๅคๅถๆถๆฏ็บฏๆๆฌๅฐๅช่ดดๆฟ |
| ๆจกๅๅๆข | ่พๅ ฅๅบๅบ้จ pill | ็นๅปๆจกๅๅๅๆขๅฝๅไผ่ฏๆจกๅ |
| ๆ่็ญ็บง | ่พๅ ฅๅบๅบ้จ pill | ็นๅปๅๆข thinking level |
| ไพงๆ ๅผๅ ณ | ้กถๆ ๅทฆไพงๅพๆ | ๆๅ / ๅฑๅผๅทฆไพง้กน็ฎๆ |
| ๅณๆ ๅผๅ ณ | ้กถๆ ๅณไพงๅพๆ | ๆๅ / ๅฑๅผๅณไพง้ขๆฟๆ |
| ไพงๆ ๆๆฝ่ฐๅฎฝ | ๆๅจๅๅ็็บฟ | ๅทฆๆ ๅณ็ผใๅณๆ ๅทฆ็ผๅฏๆๅจ่ฐๆดๅฎฝๅบฆ |
| ไผ่ฏๅณ้ฎ่ๅ | ๅณ้ฎไผ่ฏๆก็ฎ | ้ๅฝๅ / ๅ ้คไผ่ฏ |
| ๆฉๅฑๅผน็ช | ่ชๅจๅผนๅบ | ๆฉๅฑ่ฏทๆฑ้ๆฉ/็กฎ่ฎค/้ฎๅทๆถ่ชๅจๅผน็ช๏ผๅฏ็นใ็จๅไฝ็ญใๆ่ตท๏ผๆถ้ด็บฟๅฏใ็ปง็ปญไฝ็ญใ |
ๅฏน่ฏไธญ็้่ฏฏๅฑ็คบ๏ผๆจกๅ/API ๅคฑ่ดฅใไธๆธธ empty_streamใ่ชๅจ้่ฏ่ๅฐฝ๏ผๅฆ Aborted after 1 retry attempt๏ผใ็จๆทไธญๆญข๏ผRequest was aborted๏ผ็ญ๏ผไผๅจๆถ้ด็บฟๆๅ
ฅ็บข่ฒ/็ฅ็่ฒ ่ฟ่กๅบ้ ๅก็๏ผๅนถๆพ็คบๆด็ๅ็ๅฎๆดๆฅ้๏ผๅซ JSON ๅ
็ server_error ๆๆก๏ผใๅณๆ Run ็ถๆไผๆ ไธบๅคฑ่ดฅ๏ผๅ้ๅคฑ่ดฅไปไผ toastใๅ้ๅคฑ่ดฅใใ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ้กถๆ ๏ผๆฒๆตธๆจกๅผ๏ผ๏ผไพงๆ ๅผๅ
ณ ยท ้กน็ฎ/ไผ่ฏๆ ้ข ยท ่ฟ่ก็ถๆ ยท ็ชๅฃๆ้ฎ โ
โโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโค
โ ๅทฆๆ โ ไธญ้ด๏ผๆถ้ด็บฟ๏ผไธ๏ผ+ ๆตฎๅจ่พๅ
ฅๅบ๏ผไธ๏ผ โ ๅณๆ ๏ผๅฏๆถ่ตท๏ผ โ
โ โ โ โ
โ ็ฃ็้กน็ฎๆ โ ็จๆท / ๅฉๆ / ๅทฅๅ
ท่ก / ๆ่้พ โ ๅฎกๆฅยท่ฟ่กยท โ
โ ไผ่ฏๅ่กจ โ โ ไธไธๆยทๆ โฆ โ
โ ๅฏน่ฏๅๅบ โ โ โ
โโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโ
- ่ฎพ็ฝฎ๏ผ็ฌ็ซๅ จๅฑ้กต๏ผ๏ผๅธธ่งใๅค่งใPiใๆฉๅฑใๆก้ข้้ ๅจใSkillsใๆ็คบ่ฏใ
- ๅๆดปๅจ cwd๏ผ็ฃ็่ทฏๅพๆๆฒ็ฎฑ๏ผ๏ผๆ่ฟ้กน็ฎ๏ผๅฏๅจๅฏๆขๅคไธๆฌก็ฎๅฝใ
- ๅๅฒๆถๆฏไปๅฐพ้จๆ้ๅ ่ฝฝ๏ผๅๆขไผ่ฏๅ ๆพ็คบๆ่ฟไธๆฎต๏ผๅฎๆดไผ่ฏๅจๅ้ๆๆ ่ทณ่ฝฌๆถๅ็ปๅฎใ
- ไผ่ฏๆ ๏ผๅณๆ ๆๅๅป Esc ๆตฎๅฑ๏ผ่็น่ทณ่ฝฌๅๅฐ่ฏฅๅๆฏ๏ผ็จๆทๆถๆฏ่็นๅฏๆๅๆๅกซๅ่พๅ ฅๆกใๆ git ไปๅบๆถ pi-rewind ๆฉๅฑไผ่ฏข้ฎๆฏๅฆๅๆถๅ้ๆไปถใ
- ๆถ้ด็บฟ๏ผๆตๅผ Markdownใๅทฅๅ ทๆๅ ่กใๅ็ๅทฅๅ ท็ diff/้ซไบฎ้ข่งใ
- ๆฉๅฑๅทฅๅ ท๏ผๅฑ็คบไธๅผน็ช็ฑๅ ผๅฎนๅฑ + ้้ ๅจๅณๅฎ๏ผไธไธ่๏ผใ
- ๆจกๅ / ๆ่็ญ็บงๅจ่พๅ ฅๅบๅๆข๏ผๅ จๅฑ pi ๅๆฐๅจ ่ฎพ็ฝฎ โ Piใ
| ้กต้ข | ไฝ็จ |
|---|---|
| ๅธธ่ง / ๅค่ง | ๅฏๅจใไธป้ข |
| Pi | ้ป่ฎคๆจกๅใๅ็ผฉใ้่ฏ็ญ๏ผๅๅ settings.json๏ผ๏ผไฟๅญ้ป่ฎคๆจกๅไผๅๆญฅๅฐๅฝๅไผ่ฏๅฎ้
่ฏทๆฑๆจกๅ |
| ๆจกๅ | ็ผ่พ ~/.pi/agent/models.json๏ผไพๅบๅ้ข่ฎพใๆๅ่ฟ็ซฏๆจกๅ็ฎๅฝใๆฌๅฐๆจกๅๅๆฐ๏ผไธ้กน็ฎๆ ๅ
ณ๏ผ |
| ๆฉๅฑ | ๅทฒๆขๆตๆฉๅฑใๅฝๅไผ่ฏๅฎ้ ๅ ่ฝฝ็ๅทฅๅ ท |
| ๆก้ข้้ ๅจ | ๆฏๆฉๅฑ็ๅ ผๅฎน่ฏดๆใ้ ็ฝฎ่กจๅ |
| Skills | ๅฏ็จ/็ฆ็จ๏ผdesktopSkillOverrides๏ผ |
| ๆ็คบ่ฏ | ้กน็ฎไธไธๆ / pi ๅ ็ฝฎ / ๆจกๆฟ / ๆไปถๆณจๅ ฅ๏ผ็ผ่พไธ็ๆฌๅ้ |
ๅพๅค pi ๆฉๅฑไพ่ต็ป็ซฏ TUIใ่ฅๆฏไธชๆฉๅฑๅๅไธๅฅๆก้ข UI๏ผๅบ็จไผ้พไปฅ็ปดๆคใ
ๅ ผๅฎนๅฑ่ด่ดฃ๏ผ
- ๅจๅๅฐ pi ไผ่ฏไธๅๅฐ็ชๅฃไน้ด่ฝฌๅ๏ผๅทฅๅ ท่ฟๅบฆไธ็ปๆใๆฉๅฑๅผน็ช๏ผ้ๆฉ/็กฎ่ฎค/้ฎๅท/ๅฎกๅพ็ญ๏ผใ้ ็ฝฎ่ฏปๅ๏ผไปๅฐฝ้ๅๆฉๅฑ่ชๅทฑ็้ ็ฝฎๆไปถ๏ผใ
- ไธไฟฎๆนๆฉๅฑๅฎ่ฃ ็ฎๅฝ้็ไปฃ็ ๏ผไธไฟฎๆน pi SDK ๆบ็ ใ
้้ ๅจ๏ผๆฏไธชๆฉๅฑไธไปฝ๏ผ่ฏดๆ๏ผ
| ๅ ๅฎน | ็จๆทๅฏ่งไฝ็ฝฎ |
|---|---|
| ้ ็ฝฎ้กนไธ่ฏปๅไฝ็ฝฎ | ่ฎพ็ฝฎ โ ๆก้ข้้ ๅจ โ ่ฏฅๆฉๅฑ |
| ๅทฅๅ ท็ปๆๅฆไฝๅฑ็คบ | ๆถ้ด็บฟๅทฅๅ ท่ก๏ผๅ่กจใ้ข่งใๅฏผๅบ้พๆฅ็ญ๏ผ |
| ้่ฆไธญ้ไบๅจ็ๅทฅๅ ท | ๅฏน่ฏไธญๅผน็ช๏ผ็น้ๅๅฏน่ฏ็ปง็ปญ |
้จๅ /ๅฝไปค |
ๆๅผ้ ็ฝฎ้กตใๆ็คบ๏ผๆๆ pi ๅ้ป่พๆง่ก |
ๅ
็ฝฎ้้
้ๅบ็จๅๅธ๏ผๅฏๅจ ~/.pi/desktop/adapters/ ๆ้กน็ฎ .pi/desktop/adapters/ ๆพ JSON ่ฆ็๏ผ้ซ็บง๏ผใ
้้
ๅจ JSON ไธๅทฅๅ
ทๅกๆจกๆฟ๏ผๆฏไธชๆฉๅฑไธไปฝ *.adapter.json๏ผๅน้
ๅ
ๅ / ๅทฅๅ
ทๅใ้
็ฝฎ้กตใๆๆ ่ฏญไน๏ผใๆถ้ด็บฟๅฑ็คบ็ฑ toolCard.template ๆฅ่กจ๏ผdefault / list / media / tree / kv / hashline๏ผhashline ๅ่ฎฎ่พๅบ๏ผๅฎ็ฐไฝไบ src/extension-compat/renderer/๏ผๆ ้ๅจ src/renderer ๅๆไปถๅๅๆฏ๏ผใๅฎ่ฃ
ๆฉๅฑๅ้ๅจ settings.json ็ packages ไธญๅฏ็จ๏ผๅนถ้ๅฏ Workerใ
ไปฅไธ้้
ๅจๅทฒๅ
็ฝฎๅจๅบ็จไธญ๏ผๅฏนๅบๆฉๅฑ้ๅจ ~/.pi/agent/settings.json ็ packages ไธญๅฎ่ฃ
ๆ็ๆ๏ผใ็ป็ซฏๅฎ่ฃ
็คบไพ๏ผpi install npm:pi-subagentsใpi install git:github.com/justhil/pi-search๏ผnpm ๅ
็จ npm:๏ผGitHub ็จ git:๏ผไธไธ่กจใๆฉๅฑๅ
ใๅๅ
ๅไธ่ด๏ผใ
| ้้ ๅจ | ๆฉๅฑๅ | ่ฏดๆ |
|---|---|---|
| Trellis | trellis |
้กน็ฎไปปๅก้ขๆฟ๏ผๅช่ฏป sidePanel๏ผ่ฏปๅ .trellis/๏ผ |
| pi-rewind | pi-rewind |
Git ๆฃๆฅ็นๅ้๏ผไผ่ฏๆ ่ทณ่ฝฌๆถ่ฏข้ฎๆฏๅฆๆขๅคๆไปถ |
| Ask User Question | @juicesharp/rpiv-ask-user-question |
็ปๆๅ้ฎ็ญๅผน็ช |
| Image Gen | pi-image-gen |
ๅพ็็ๆ / ๅฎกๆฅๅผน็ช |
| Multimodal Vision | pi-multimodal-proxy |
ๅคๆจกๆ่ง่งไปฃ็ |
| Markdown Preview | pi-markdown-preview |
Markdown ๅฎๆถ้ข่งๅก็ |
| Studio | pi-studio |
Studio REPL ้ๆ |
| Fast Context | pi-fast-context |
ๅฟซ้ไธไธๆๆฃ็ดข |
| Subagents | pi-subagents |
ๅญ Agent ๆดพๅไธ็ฎก็ |
| Cache Optimizer | pi-cache-optimizer |
็ผๅญไผๅ้ ็ฝฎ |
| Skills Manager | @vanillagreen/pi-skills-manager |
Skills ็ฎก็้ ็ฝฎ UI |
| MCP Adapter | pi-mcp-adapter |
MCP ๆๅกๅจ้้ |
| Context Viewer | @agnishc/edb-context-viewer |
ไธไธๆๆฅ็ๅจ |
| FFF | @ff-labs/pi-fff |
fuzzy ๆไปถๆฅๆพ |
| Sync | @narumitw/pi-sync |
ไผ่ฏๅๆญฅ้ ็ฝฎ |
| Continue | pi-continue |
็ปง็ปญๅฏน่ฏ้ ็ฝฎ |
| Goal | pi-goal |
็ฎๆ ็ฎก็ |
| BTW | pi-btw |
ๆๆณจ่ฎฐๅฝ |
| Simplify | pi-simplify |
ไปฃ็ ็ฎๅๅปบ่ฎฎ |
| Advisor | @juicesharp/rpiv-advisor |
้กพ้ฎๅปบ่ฎฎๅผน็ช |
| Observational Memory | pi-observational-memory |
่งๅฏ่ฎฐๅฟ้ ็ฝฎ |
| Tool Display | pi-tool-display |
ๅทฅๅ ทๅฑ็คบๅก็ |
| Hashline Edit | @jerryan/pi-hashline-edit |
ๅๅธ้ๅฎ read/edit/insert/grep + ๆถ้ด็บฟ hashline ้ข่ง |
| Agents.md | pi-agentsmd |
AGENTS.md ็ฎก็้ ็ฝฎ |
| ACE Tool | pi-ace-tool |
ACE ๅทฅๅ ท้ๆ |
| Sequential Thinking | @feniix/pi-sequential-thinking |
้กบๅบๆ่้ ็ฝฎ |
| Aegis | aegis |
Aegis ๅทฅไฝๆตๅผๆ |
| TPS Extensions | @kinarajv/pi-tps-extensions |
TPS ๆฉๅฑ้ ็ฝฎ |
| Nano Context | pi-nano-context |
็บณ็ฑณไธไธๆ |
| Powerline Footer | pi-powerline-footer |
ๅบๆ ็ถๆ่ก |
| Amp Themes | amp-themes |
Amp ไธป้ข |
| Curated Themes | @victor-software-house/pi-curated-themes |
็ฒพ้ไธป้ข |
| Themes Bundle | @firstpick/pi-themes-bundle |
ไธป้ขๅ้ |
| Pi Search | pi-search |
ๆ็ดขๅทฅๅ ท |
ไธ็ป็ซฏ pi
| ่ฝๅ | ็ป็ซฏ pi | pi Desktop |
|---|---|---|
| ๅฏน่ฏไธ session | TUI | ๅพๅฝขๆถ้ด็บฟ + ่พๅ ฅๅบ |
| ๆฉๅฑๅผน็ช | ็ป็ซฏ็ปไปถ | ๅ ผๅฎนๅฑ โ ็ชๅฃ |
| ๆฉๅฑ้ ็ฝฎ | TUI / ๆไปถ | ่ฎพ็ฝฎ โ ้้ ๅจ๏ผไปๅๆฉๅฑๅธธ็จ้ ็ฝฎๆไปถ๏ผ |
| Skills / ๆ็คบ่ฏ | ็ฎๅฝ + settings | ่ฎพ็ฝฎ้ไธญ็ฎก็ + ๆฌๅฐไฟฎ่ฎขๅๅฒ |
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ็้ข (React) โ ๆถ้ด็บฟใ่พๅ
ฅๅบใ่ฎพ็ฝฎใๆฉๅฑๅผน็ชๅฎฟไธป โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ preload ็ฝๅๅ IPC
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ไธป่ฟ็จ โ ็ชๅฃใๅบ็จ้
็ฝฎใๆฒ็ฎฑ/ๆไปถใ้้
ๅจ้
็ฝฎๅ็ซฏใไผ่ฏๆ ๆไปถ่งฃๆ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Pi ๅๅฐ่ฟ็จ โ pi SDKใๅ ่ฝฝๆฉๅฑใไบไปถไธ UI ่ฏทๆฑ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
ๆฐๆฎ่ฝ็น
| ๆฐๆฎ | ไฝ็ฝฎ |
|---|---|
| ไผ่ฏไธ่ฟ่กๅๅฒ | ~/.pi/agent/sessions/๏ผpi JSONL๏ผ |
| ่ฎค่ฏไธๅ จๅฑ pi ่ฎพ็ฝฎ | ~/.pi/agent/ |
| ๅบ็จๅๅฅฝ๏ผไธป้ขใไพงๆ ๅฎฝๅบฆ็ญ๏ผ | ๆฌๆบ electron-store |
| ๆ็คบ่ฏ/ๆ่ฝ็ผ่พๅฟซ็ ง | ~/.pi/agent/desktop-revisions/ |
| ไธดๆถๅฏน่ฏๆฒ็ฎฑ | ๅบ็จ userData/sandbox-workspaces/ |
pi-app/
โโโ README.md
โโโ package.json
โโโ electron.vite.config.ts # main / preload / renderer / worker ๆๅปบ
โโโ electron-builder.yml # ๅฎ่ฃ
ๅ
โโโ resources/
โ โโโ icon.svg # ๅบ็จๅพๆ ๆบ๏ผnpm run icon:export โ build/icon.png๏ผ
โ
โโโ packages/
โ โโโ shared/ # IPC ๆนๆณๅใAppEventใZod ๆ ก้ช๏ผๅๅ็ซฏๅ
ฑ็จ๏ผ
โ
โโโ src/
โ โโโ main/ # Electron ไธป่ฟ็จ
โ โ โโโ index.ts # ๅ
ฅๅฃใ็ชๅฃใ่ชๅจๆๅผไธๆฌก้กน็ฎ
โ โ โโโ ipc.ts # ipc:* ๅค็ๅฝๆฐ
โ โ โโโ worker-manager.ts # Pi ๅๅฐ่ฟ็จ็ๅฝๅจๆไธ่ฏทๆฑ
โ โ โโโ config-store.ts # ๅบ็จๆฌๅฐ้
็ฝฎ
โ โ โโโ sandbox-workspaces.ts # ๅฏน่ฏๅๅบๆฒ็ฎฑ
โ โ โโโ session-tree-from-file.ts # ๆช็ปๅฎไผ่ฏๆถไป JSONL ่ฏปๆ
โ โ โโโ pi-resources-editor.ts # Skills/ๆ็คบ่ฏ็ฃ็่ฏปๅ
โ โ โโโ resource-revisions.ts # ็ผ่พ็ๆฌๅ้
โ โ โโโ workspace-task-panel-reader.ts # ๅณๆ ๅ่ฏญ workspace-trellis
โ โ โโโ side-panel-registry.ts # adapter sidePanel.stateProvider
โ โ โโโ โฆ
โ โ
โ โโโ preload/ # contextBridge ๆด้ฒ็ป็้ข็ๅฎๅ
จ API
โ โ
โ โโโ worker/ # Pi ๅๅฐ่ฟ็จ๏ผutilityProcess๏ผ
โ โ โโโ index.ts # createAgentSessionใๆถๆฏๅค็
โ โ โโโ desktop-ui-bridge.ts # ๆฉๅฑ ctx.ui โ ๅ็ป็้ข
โ โ
โ โโโ extension-compat/ # โ
ๆฉๅฑๅ
ผๅฎนๅฑ
โ โ โโโ builtin/*.adapter.json # ๅๆฉๅฑๅ
็ฝฎ้้
ๆ่ฟฐ
โ โ โโโ adapter-loader.ts # ๅๅนถๅ
็ฝฎไธ็จๆท่ฆ็
โ โ โโโ adapter-backend.ts # ้
็ฝฎ่ฏปๅใๆขๆตใ้็จๅจไฝ
โ โ โโโ extension-probe.ts # ๆซๆๅทฒๅฎ่ฃ
ๆฉๅฑ
โ โ โโโ โฆ
โ โ
โ โโโ renderer/ # React ็้ข
โ โโโ index.html
โ โโโ src/
โ โโโ app/ # ๅฃณๅฑใไธๆ ๅธๅฑ
โ โโโ features/ # ๆๅ่ฝๅๅ
โ โ โโโ timeline/ # ๆถ้ด็บฟใMarkdownใๅทฅๅ
ท้ข่ง
โ โ โโโ composer/ # ่พๅ
ฅๅบใๆๆ ใๆจกๅ้ๆฉ
โ โ โโโ review/ # ๆนๅจๅฎกๆฅ
โ โ โโโ run/ context/ trellis/ rewind/
โ โ โโโ settings/ # ่ฎพ็ฝฎๅ้กต
โ โ โโโ extension-ui/ # ๆฉๅฑๅผน็ชใ้้
ๅจ้
็ฝฎ่กจๅ
โ โ โโโ workspace/ # ไพงๆ ้กน็ฎไธไผ่ฏ
โ โโโ components/ui/ # shadcn ๅบ็ก็ปไปถ
โ โโโ stores/ # Zustand๏ผๅซๆไน
ๅ UI ็ถๆ๏ผ
โ โโโ lib/ # IPC ๅฎขๆท็ซฏใไผ่ฏๅๆขใๅๅฒๅ้กต
โ โโโ locales/ # i18n
โ โโโ styles/ # globals.cssใๅจๆ token
โ
โโโ scripts/ # ๅพๆ ๅฏผๅบ็ญๆๅปบ่ๆฌ
ๆน็้ข โ ไผๅ
src/renderer/src/features/ใ
ๆน IPC ๆๆฒ็ฎฑ/่ตๆบๆไปถ โ src/main/ + packages/shared/ใ
ๆน pi ไผ่ฏ่กไธบ โ src/worker/ใ
ๆฐๆฉๅฑๆก้ขๆฏๆ โ src/extension-compat/builtin/ ๅขๅ ้้
JSONใ
| ๅฝไปค | ่ฏดๆ |
|---|---|
npm run dev |
ๅผๅๆจกๅผ |
npm run build |
ๆๅปบ main / preload / renderer / worker |
npm run typecheck |
TypeScript ๆฃๆฅ |
npm run icon:export |
resources/icon.svg โ build/icon.png |
npm run package:win |
Windows NSIS ๅฎ่ฃ
ๅ
+ ไพฟๆบ็๏ผdist/๏ผ |
GitHub Release๏ผCI๏ผ
- ๅทฅไฝๆต๏ผ
.github/workflows/release.yml - ๆจ้ๆ ็ญพ
v*๏ผๅฆv0.1.0๏ผๆ Actions ้ๆๅจ Run workflow๏ผๅจ Windows ไธๆๅปบๅนถไธไผ ๏ผpi Desktop-Setup-<version>-x64.exe๏ผๅฎ่ฃ ๅ ๏ผpi Desktop-Portable-<version>-x64.exe๏ผไพฟๆบๅ ๏ผ
- ๆๆ ็ญพ็คบไพ๏ผ
git tag v0.1.0 && git push origin v0.1.0
Electron 35 ยท electron-vite ยท React 18 ยท TypeScript ยท Tailwind ยท shadcn/Radix ยท Zustand ยท TanStack Query ยท i18next ยท react-markdown ยท Shiki ยท @earendil-works/pi-coding-agent ^0.79 ยท electron-store ยท better-sqlite3 ยท electron-updater
MIT
- LinuxDo โ ็คพๅบ่ฎจ่ฎบไธๅ้ฆ