@thesashadev/girl-agent 0.1.0 → 0.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/CHANGELOG.md +20 -0
- package/README.md +184 -170
- package/dist/cli.js +473 -168
- package/package.json +65 -64
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 0.1.2 — communication realism update
|
|
4
|
+
|
|
5
|
+
Дата: 2026-05-05
|
|
6
|
+
|
|
7
|
+
- Hotfix: профили из wizard теперь сохраняются раньше, а список профилей больше не показывает недосохранённые папки без `config.json`.
|
|
8
|
+
- Добавлены жизненные стили общения: **Нормальная**, **Милая**, **Альтушка**, **Залипала**, **Болтушка**.
|
|
9
|
+
- Добавлен `CommunicationProfile` с настройками уведомлений, стиля сообщений, инициативы и life sharing.
|
|
10
|
+
- Presence, reply timing, bubbles, ignore chance и proactive agenda теперь учитывают профиль общения.
|
|
11
|
+
- Wizard и CLI получили настройку communication profile.
|
|
12
|
+
- Runtime `:status` и `:debug` показывают профиль общения.
|
|
13
|
+
- Команда `:log` стала удобнее и поддерживает выбор дня/лимита вывода.
|
|
14
|
+
- Старый `vibe` автоматически нормализуется в новый формат.
|
|
15
|
+
|
|
16
|
+
## 0.1.1 — stability baseline
|
|
17
|
+
|
|
18
|
+
- Базовый публичный релиз с Telegram bot/userbot режимами.
|
|
19
|
+
- Persona, speech, relationship state, memory, conflict и agenda-модули.
|
|
20
|
+
- Документация по установке, конфигурации, реализм-модулям и troubleshooting.
|
package/README.md
CHANGED
|
@@ -1,170 +1,184 @@
|
|
|
1
|
-
|
|
2
|
+
|
|
3
|
+
[website]: https://girl-agent.com
|
|
4
|
+
[docs]: https://docs.girl-agent.com
|
|
5
|
+
|
|
6
|
+
**[website]** · **[docs]**
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
Это только бета-версия. Со временем будет дорабатыватся.
|
|
10
|
+
Со всеми проблемами и багами пишите в Issues.
|
|
11
|
+
ТГ создателя - @voided_net
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## Содержание
|
|
16
|
+
|
|
17
|
+
- [Быстрый старт](#быстрый-старт)
|
|
18
|
+
- [Что под капотом](#что-под-капотом)
|
|
19
|
+
- [Почему не просто GPTs или промпт](#почему-не-просто-gpts-или-промпт)
|
|
20
|
+
- [Changelog](./CHANGELOG.md)
|
|
21
|
+
- [Безопасность](#безопасность)
|
|
22
|
+
- [Лицензия](#лицензия)
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## О проекте
|
|
27
|
+
|
|
28
|
+
Она не отвечает на каждое сообщение. Иногда читает и молчит. Иногда ставит реакцию. Иногда отвечает через час, потому что была занята или просто не хотела.
|
|
29
|
+
|
|
30
|
+
Это не баг. Так задумано.
|
|
31
|
+
|
|
32
|
+
`girl-agent` — ИИ-девушка, которая ведёт себя в переписке как человек. Со сном, настроением, расписанием, памятью и характером. Без "конечно, я понимаю" и ChatGPT-повадок.
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## Быстрый старт
|
|
37
|
+
|
|
38
|
+
**Через NPX (рекомендуется):**
|
|
39
|
+
|
|
40
|
+
```powershell
|
|
41
|
+
npx @thesashadev/girl-agent
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Wizard задаст пару вопросов — имя, возраст, Telegram-подключение, LLM-ключ. Всё.
|
|
45
|
+
|
|
46
|
+
Если профиль уже есть:
|
|
47
|
+
|
|
48
|
+
```powershell
|
|
49
|
+
npx @thesashadev/girl-agent --profile=arina
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
**Из исходников:**
|
|
53
|
+
|
|
54
|
+
```powershell
|
|
55
|
+
git clone https://github.com/TheSashaDev/girl-agent.git
|
|
56
|
+
cd girl-agent
|
|
57
|
+
npm install
|
|
58
|
+
npm run dev
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## Что под капотом
|
|
64
|
+
|
|
65
|
+
Поведение собирается из нескольких слоёв, а не из одного промпта.
|
|
66
|
+
|
|
67
|
+
- 📱 **Она не всегда онлайн** — паттерн присутствия зависит от персонажа: кто-то в телефоне круглые сутки, кто-то заходит раз в час, кто-то только вечером.
|
|
68
|
+
- 😴 **Ночью спит** — можно разбудить через `:wake`, но без команды шанс ответа низкий.
|
|
69
|
+
- 📅 **Расписание дня** — у каждого дня есть расписание: пары, работа, дорога, свободное время. Если она на занятиях, телефон может быть недоступен.
|
|
70
|
+
- ❤️ **Отношения** — пять счётчиков: интерес, доверие, привлекательность, раздражение, неловкость. Меняются от каждого диалога. Высокое раздражение — чаще игнор и холод.
|
|
71
|
+
- 📈 **Стадии сближения** — отношения проходят стадии: от "дала тг, но холодная" до "давно вместе". Стадия влияет на тепло, флирт, длину ответов.
|
|
72
|
+
- ⚠️ **Конфликты** — если давить, спамить или нарушать границы — включается конфликт. Она может замолчать на часы или дни.
|
|
73
|
+
- 🧠 **Память** — важные события пишутся в `long-term.md` и всплывают в будущих диалогах.
|
|
74
|
+
- 🚫 **Anti-AI** — промпт запрещает markdown, "конечно", "я понимаю", эмодзи-ряды, вопросы в конце сообщений и всё, что палит ChatGPT.
|
|
75
|
+
- 👤 **Userbot mode** — настоящий Telegram-аккаунт через MTProto. Умеет читать сообщения, ставить реакции, печатать, удалять и редактировать. Выглядит как живой человек, а не как бот.
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
## Почему не просто GPTs или промпт
|
|
80
|
+
|
|
81
|
+
Вариантов сделать "девушку в Telegram" несколько — от костыльных до полноценных. Разберём, что есть и где дыры.
|
|
82
|
+
|
|
83
|
+
### ChatGPT GPTs
|
|
84
|
+
|
|
85
|
+
**Как это работает:** Кастомный бот внутри ChatGPT с system prompt. Логика поведения = промпт.
|
|
86
|
+
|
|
87
|
+
**Что упущено:**
|
|
88
|
+
- Нет памяти между сессиями — каждая начинается с нуля
|
|
89
|
+
- Нет Telegram — только веб-интерфейс
|
|
90
|
+
- Нет реакций, печати, редактирования
|
|
91
|
+
- Бот всегда "онлайн" — нет расписания или сна
|
|
92
|
+
- Память ограничена контекстным окном
|
|
93
|
+
|
|
94
|
+
**Итог:** Чат-бот с кастомным промптом, без состояния и реалистичного поведения.
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
### OpenClaw + prompt (markdown-файлы)
|
|
99
|
+
|
|
100
|
+
**Как это работает:** Фреймворк для AI-ассистентов. Личность через markdown-файлы (SOUL.md, IDENTITY.md, USER.md). Telegram bridge через GramJS (MTProto).
|
|
101
|
+
|
|
102
|
+
**Что упущено:**
|
|
103
|
+
- Нет реализм-модулей: presence, sleep, conflict, daily-life, relationship stages
|
|
104
|
+
- Нет agenda — бот не планирует действия
|
|
105
|
+
- Память = история сообщений, нет long-term storage
|
|
106
|
+
- Нет relationship score и conflict system
|
|
107
|
+
|
|
108
|
+
**Итог:** Хороший bridge для Telegram, но не персонаж-движок. Поведение = промпт + история.
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
### HeatherBot
|
|
113
|
+
|
|
114
|
+
**Как это работает:** Локальный Telegram userbot (MTProto via Telethon), persona в YAML, 4-слойная память, 17 kink-specific overlays. ~10K строк Python.
|
|
115
|
+
|
|
116
|
+
**Что упущено:**
|
|
117
|
+
- Слишком специфично под NSFW — 17 kink overlays
|
|
118
|
+
- Сложно настроить — нужно llama-server, Ollama, ComfyUI
|
|
119
|
+
- Требует мощного GPU — 12B модель локально
|
|
120
|
+
- Нет presence/sleep/conflict как отдельных модулей
|
|
121
|
+
|
|
122
|
+
**Итог:** Мощное, но узкое решение под NSFW с тяжёлой инфраструктурой.
|
|
123
|
+
|
|
124
|
+
---
|
|
125
|
+
|
|
126
|
+
### Character.AI
|
|
127
|
+
|
|
128
|
+
**Как это работает:** Закрытый сервис для AI-переписки. Персоны через UI, поведение = prompt engineering + session-level memory.
|
|
129
|
+
|
|
130
|
+
**Что упущено:**
|
|
131
|
+
- Нет Telegram — только веб-интерфейс
|
|
132
|
+
- Нет контроля — всё на их серверах
|
|
133
|
+
- Память сбрасывается между сессиями
|
|
134
|
+
- Memory ограничена — persona обрезается при росте истории
|
|
135
|
+
|
|
136
|
+
**Итог:** Закрытый сервис с ограниченной памятью и без Telegram.
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
### girl-agent
|
|
141
|
+
|
|
142
|
+
**Как это работает:** Движок с несколькими слоями состояния: presence, sleep, daily-life, relationship stages, conflict, memory, anti-AI. Userbot mode через MTProto.
|
|
143
|
+
|
|
144
|
+
**Технические детали:**
|
|
145
|
+
- Presence — паттерны присутствия (частота, офлайн, вероятность ответа)
|
|
146
|
+
- Sleep — время сна, night wake chance
|
|
147
|
+
- Daily-life — расписание, занятость, приоритеты
|
|
148
|
+
- Relationship stages — stranger → convinced → close → intimate → bonded
|
|
149
|
+
- Relationship score — interest, trust, attraction, annoyance, cringe
|
|
150
|
+
- Conflict — если давить/спамить, включается конфликт, может замолчать
|
|
151
|
+
- Memory — важные события в long-term.md, всплывают в диалогах
|
|
152
|
+
- Anti-AI — промпт запрещает markdown, "конечно", "я понимаю", эмодзи-ряды
|
|
153
|
+
- Userbot mode — умеет читать, реагировать, печатать, удалять, редактировать
|
|
154
|
+
- Agenda — бот планирует действия, живёт своей жизнью
|
|
155
|
+
|
|
156
|
+
**Итог:** Движок с несколькими слоями решения. Поведение собирается из состояния, а не из текстовых инструкций.
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## Безопасность
|
|
161
|
+
|
|
162
|
+
⚠️ **Не публикуй:** `data/`, `config.json`, `sessionString` и API-ключи.
|
|
163
|
+
|
|
164
|
+
🔒 **Для userbot mode** используй отдельный тестовый аккаунт — Telegram может забанить основной аккаунт за подозрительную активность.
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
## Лицензия
|
|
169
|
+
|
|
170
|
+
📄 **Source-available** — исходный код открыт для личного тестирования, оценки и вкладов.
|
|
171
|
+
|
|
172
|
+
**Разрешено:**
|
|
173
|
+
- Клонировать и запускать локально
|
|
174
|
+
- Создавать issues и отправлять pull requests
|
|
175
|
+
- Изучать код и экспериментировать
|
|
176
|
+
|
|
177
|
+
**Запрещено без письменного разрешения:**
|
|
178
|
+
- Коммерческое использование
|
|
179
|
+
- Платный хостинг
|
|
180
|
+
- Перепродажа
|
|
181
|
+
- Публичные конкурирующие клоны
|
|
182
|
+
- Использование кода внутри коммерческих продуктов
|
|
183
|
+
|
|
184
|
+
📜 Полный текст лицензии: [LICENSE](./LICENSE)
|