@euhenio/pi-buddy 0.0.0-stage → 1.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,52 @@
1
- # Temporary Holding Version
1
+ # @euhenio/pi-buddy
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Тамагочи для [pi](https://pi.dev): питомец живёт в полосе справа от поля ввода и реагирует на работу агента — идёт, пока агент работает, виляет хвостом после успешного хода, грустит на ошибках, засыпает в простое.
4
+
5
+ ![preview](preview.png)
6
+
7
+ ## Установка
8
+
9
+ ```bash
10
+ pi install ./pi-buddy # из локальной папки
11
+ pi install git:github.com/<you>/pi-buddy@v1.0.0 # из git
12
+ pi install npm:@euhenio/pi-buddy # из npm
13
+ ```
14
+
15
+ Попробовать без установки: `pi -e ./pi-buddy`.
16
+
17
+ > Если раньше расширение лежало файлом в `~/.pi/agent/extensions/buddy.ts` — удалите тот файл,
18
+ > иначе будут две команды `/buddy`. Питомец сохранится: его состояние в `~/.pi/agent/buddy.json`.
19
+
20
+ ## Анимация
21
+
22
+ У каждого питомца — пиксельный спрайт и 16 кадров: моргание, свои «фирменные» движения в простое
23
+ (кот машет хвостом и умывается, утка кивает, сова подмигивает, дракон пускает дымок…), ходьба,
24
+ пока агент работает, прыжки от радости, позы «лежит», «грустит» и «спит» с дыханием.
25
+ Смена анимаций идёт через базовую стойку, без резких скачков. В простое питомец иногда
26
+ сам берёт любимую игрушку.
27
+
28
+ ## Команды
29
+
30
+ | Команда | Что делает |
31
+ |---|---|
32
+ | `/buddy` | показать / спрятать |
33
+ | `/buddy choose [вид]` | выбрать питомца: ВЕО (пиксели), немецкая овчарка, блоб, кот, утка, призрак, сова, аксолотль, дракон — все пиксельные, с анимацией |
34
+ | `/buddy feed` `pet` `nap` | покормить, погладить, уложить |
35
+ | `/buddy play [предмет]` | поиграть любимой игрушкой: у каждого их две (мячик и косточка, клубок и мышка, фрисби и канат…) |
36
+ | `/buddy name <кличка>` | дать имя |
37
+ | `/buddy stats` | статистика |
38
+ | `/buddy dock` `compact` `big` `top` | где и как показывать |
39
+ | `/buddy mute` `unmute` | болтовня выкл/вкл |
40
+ | `/buddy anim on\|off\|auto` | анимация (auto — не мешает прокрутке вне fullscreen) |
41
+ | `/buddy pxcolor fg\|bg\|auto` | отрисовка пиксельного пса (fg — для терминала IntelliJ) |
42
+ | `/buddy learn [тема\|пожелание]` | модель pi придумает новые фразы |
43
+ | `/buddy phrases` / `phrases clean` | файл своих фраз / убрать те, что не прозвучат (длинные, не та поза) |
44
+
45
+ В чате можно попросить агента: «добавь питомцу фраз про Kafka» — он вызовет инструмент `buddy_phrases`.
46
+
47
+ ## Файлы
48
+
49
+ - `~/.pi/agent/buddy.json` — состояние питомца
50
+ - `~/.pi/agent/buddy-phrases.json` — свои и выученные фразы
51
+
52
+ Расширение само в сеть не ходит; к модели pi обращаются только `/buddy learn` и инструмент `buddy_phrases`.