manager-agent

ИИ-менеджер в Telegram, который ведёт переписку как живой секретарь. С рабочим расписанием, паузами, памятью на клиентов — и без «конечно, я понимаю».

⚠️ Это форк. manager-agent — производный проект на базе TheSashaDev/girl-agent. Все права на оригинальный код принадлежат автору оригинала. Условия исходной source-available лицензии (GSACL 1.1) сохраняются полностью — см. LICENSE.

Этот форк переориентирует движок персоны на сценарий деловой секретарь, оставляя архитектуру и слои реализма оригинала нетронутыми идейно. Спасибо @voided_net за оригинальный движок.

О проекте

Он не отвечает на каждое сообщение мгновенно. Иногда читает и думает. Иногда уточняет у владельца. Иногда отвечает через 40 минут, потому что был на созвоне.

Это не баг. Так задумано.

manager-agent — движок ИИ-секретаря для Telegram. Не промпт. Не GPTs. Не плагин. Это полноценный агент со своим состоянием: рабочее расписание, паттерн присутствия, память на контактов, мандат на самостоятельные ответы, цикл эскалации владельцу, шесть уровней доверия для каждого собеседника. Поведение собирается из этих слоёв, а не из одного system_prompt.

Когда клиент пишет «здравствуйте, хотел предложить идею по проекту», менеджер может:

• ответить сам, если тема покрыта мандатом,
• открыть тикет и уточнить у владельца, если нужно решение,
• вежливо отказать или промолчать в нерабочее время — в зависимости от политики.

Владелец отвечает менеджеру в Telegram (reply, #T-42, @username) — менеджер сам доносит формулировку клиенту, не утечки внутреннего контекста.

Содержание

• Быстрый старт
  • Linux / macOS / WSL — одной командой
  • Windows — через npx
  • Docker (для серверов)
• Что под капотом
• Чем отличается от оригинала
• Сосуществование с girl-agent
• Безопасность
• Лицензия и атрибуция
• Changelog

Быстрый старт

🚧 Статус: в активной разработке. Раздел установки актуализируется по мере выхода первых релизов форка. Пока — запуск из исходников.

Из исходников

git clone https://github.com/shxpe0x/girl-agent-manager.git manager-agent
cd manager-agent
npm install
npm run dev

WebUI поднимется на http://localhost:3100 (по умолчанию для форка, чтобы не конфликтовать с оригинальным girl-agent на 3000).

Linux / macOS / WSL

# раздел добавится в первом релизе форка

Windows — через npx (рекомендуем)

# раздел добавится в первом релизе форка

Docker (для серверов)

# раздел добавится в первом релизе форка

Что под капотом

Поведение собирается из нескольких слоёв, а не из одного промпта.

| | Слой | Что делает | |-|-------------------|------------| | 📱 | Presence | Не всегда «онлайн». Заходит в чат по своему рабочему паттерну: кто-то постоянно в телефоне, кто-то только между встречами. | | 🕘 | Work hours | Вне рабочих часов поведение определяется политикой: молчание / автоответ / только VIP-контакты. | | 📅 | Daily-life | У каждого дня — расписание: встречи, созвоны, обед, рабочие блоки. На созвоне телефон недоступен. | | 👥 | Contact tiers | 6 уровней доверия для каждого контакта: cold-stranger → introduced → regular → trusted-partner → vip плюс blocked. Уровень влияет на тон, скорость, мандат. | | 📜 | Mandate | Текстовая политика владельца: что менеджер решает сам, что эскалирует. Без мандата всё нестандартное идёт владельцу. | | 🎫 | Escalation | Тикет с ID вида #T-42. Холдинг-сообщение клиенту → резюме владельцу → ответ владельца (reply / #T-N / @username) → формулировка клиенту. | | 🧠 | Memory | Карточки на каждого контакта: чем занимается, что обещали, чем закончили. Всплывают в будущих диалогах. | | 🚫 | Anti-AI | Промпт запрещает markdown, «конечно», «я понимаю», эмодзи-ряды, вопросы в конце и всё что палит ChatGPT. Лёгкие опечатки — для реализма. | | 👤 | Userbot mode | Настоящий Telegram-аккаунт через MTProto. Умеет читать, ставить реакции, печатать, удалять и редактировать. Выглядит как живой человек. | | 🗓 | Agenda | Двусторонняя проактивность: follow-up клиентам по обещаниям + дайджесты владельцу о состоянии входящих. |

Чем отличается от оригинала

girl-agent симулирует личные отношения с одним собеседником. manager-agent обслуживает множество внешних контактов от имени одного владельца. Поэтому:

| Оригинал (girl-agent) | Форк (manager-agent) | |---|---| | 9 стадий отношений (met-irl-got-tg → long-term) | 6 контактных уровней (cold-stranger → vip, плюс blocked) | | Один relationship.md на профиль | Карточка на каждого контакта в contacts/<chat_id>.json | | Сон, ночное пробуждение, гормоны цикла | Рабочие часы, политика после-часов, без гормонов | | 5 пресетов общения (cute/clingy/alt/chatty/normal) | 3 деловых тона (formal-вы / friendly-ты / mixed-by-tier) | | Личный approach с одним собеседником | Мандат, эскалация, конфиденциальность ответа | | Owner определяется первым написавшим | Owner задаётся явно при создании профиля | | Privacy: owner-only / allow-strangers | Gate_Level: open / gated / whitelist |

Что сохраняется из оригинала: presence, daily-life, behavior-tick (решение reply/ignore/delay/bubbles), agenda (но двусторонняя), memory-palace, typos, online-heartbeat, telegram-адаптеры (bot + userbot), LLM-клиент, WebUI-каркас, миграции.

Сосуществование с girl-agent

Форк специально настроен так, чтобы запускаться рядом с оригиналом без коллизий:

| | Оригинал | Форк | |---|---|---| | Имя пакета npm | @thesashadev/girl-agent | @shxpe/manager-agent | | CLI-бинарь | girl-agent | manager-agent | | Порт WebUI | 3000 | 3100 | | Префикс env | GIRL_AGENT_* | MANAGER_AGENT_* | | Каталог данных (Linux) | ~/.local/share/girl-agent/data | ~/.local/share/manager-agent/data | | Каталог данных (macOS) | ~/Library/Application Support/girl-agent/data | ~/Library/Application Support/manager-agent/data | | Каталог данных (Windows) | %APPDATA%\girl-agent\data | %APPDATA%\manager-agent\data | | Docker-образ | ghcr.io/thesashadev/girl-agent | ghcr.io/<owner>/manager-agent |

Можно держать обе системы запущенными одновременно — данные изолированы, порты не пересекаются.

Безопасность

⚠️ Не публикуй: data/, config.json, mandate.md, sessionString, API-ключи, токен бота.

🔒 Для userbot-режима используй отдельный тестовый аккаунт — Telegram может забанить основной за подозрительную активность.

🛡 Конфиденциальность тикетов: менеджер по умолчанию не передаёт клиенту фрагменты mandate.md, имена других контактов или тексты резюме, отправленных владельцу. Это поведение enforced на уровне валидации исходящих сообщений.

Лицензия и атрибуция

📄 Source-available — наследуется от оригинала (GSACL 1.1). Исходный код открыт для личного тестирования, оценки и вкладов.

| Разрешено | Запрещено без письменного разрешения | |-----------|--------------------------------------| | ✅ Клонировать и запускать локально | ❌ Коммерческое использование | | ✅ Создавать issues и PR-ы | ❌ Платный хостинг | | ✅ Изучать код и экспериментировать | ❌ Перепродажа | | | ❌ Публичные конкурирующие клоны | | | ❌ Использование кода в коммерческих продуктах |

📜 Полный текст: LICENSE.

Атрибуция

manager-agent — форк TheSashaDev/girl-agent. Все права на оригинальный код принадлежат автору оригинала @voided_net. Этот форк не претендует на авторство архитектуры, движка персоны или каких-либо производных идей оригинала. Изменения форка ограничиваются переориентацией на сценарий делового секретаря и сосуществованием с оригиналом.

Условия исходной лицензии — включая запреты на коммерческое использование, платный хостинг и публичные конкурирующие клоны — действуют для форка в полном объёме.