# humanizer-ru [Health: Active] **Category:** 💻 Developer Tools **Repository:** https://github.com/Vladimir-Human/humanizer-ru **GitHub Stars:** 123 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/humanizer-ru ## Description Russian-text AI-trace detection and typography normalization over stdio MCP ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `uvx` (confidence: high): ```json "mcpServers": { "humanizer-ru": { "command": "uvx", "args": ["humanizer-ru"] } } ``` ## Documentation & README # humanizer-ru Проверяемая гигиена вставки из чата для русского текста ![Терминал humanizer-markers подсвечивает следы машинного текста и объясняет причину каждого флага](https://raw.githubusercontent.com/Vladimir-Human/humanizer-ru/HEAD/assets/hero.svg) [![License: MIT](https://img.shields.io/github/license/Vladimir-Human/humanizer-ru)](LICENSE) [![PyPI](https://img.shields.io/pypi/v/humanizer-ru?label=PyPI&color=blue)](https://pypi.org/project/humanizer-ru/) [![CI](https://img.shields.io/github/actions/workflow/status/Vladimir-Human/humanizer-ru/regex-check.yml?branch=main&label=CI)](https://github.com/Vladimir-Human/humanizer-ru/actions/workflows/regex-check.yml?query=branch%3Amain) ## Кому это нужно - Редактору и преподавателю: проверить текст перед публикацией: `humanizer-markers --scan файл.md`. - Разработчику и CI: гейт вставки из чат-интерфейсов: [action и контракт](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/contract.v1.json). - Пользователю ИИ-ассистента: та же проверка внутри агентной среды: [MCP одной конфигурацией](#mcp-одной-конфигурацией) или [демо](https://vladimir-human.github.io/humanizer-ru/). ## Попробовать за 30 секунд - [Демо в браузере](https://vladimir-human.github.io/humanizer-ru/): ничего не устанавливать, текст не покидает браузер. - Сообщить о проблеме или опыте использования: [issue в репозитории](https://github.com/Vladimir-Human/humanizer-ru/issues/new); пользовательский текст не передаётся автоматически ни демо, ни сборщиком обратной связи. - В терминале: ```text pip install humanizer-ru python -c "open('primer.txt','w',encoding='utf-8').write('Согласно отчёту :contentReference[oaicite:3]{index=3}, рост заявок.\n')" humanizer-markers --scan primer.txt; echo "rc=$?" primer.txt:1 [contentReference] Согласно отчёту :contentReference[oaicite:3]{index=3}, рост заявок. Найдено маркеров: 1. rc=1 ``` rc=1 означает «найдены маркеры» — это ожидаемый результат проверки на образце со следом вставки, а не ошибка; rc=0 — следов нет, rc=2 — вход не читается (с --json конверт ошибки печатается в stdout). ### MCP одной конфигурацией ```json { "mcpServers": { "humanizer-ru": { "command": "humanizer-mcp" } } } ``` ## Матрица проверенных возможностей и границ Без заявлений о лидерстве: сопоставимого внешнего исследования в нише на дату записи нет (см. LEADERBOARD.md). Строки — что фактически проверено гейтами и тестами цикла; границы — что поверхность не делает. | Поверхность | Проверка известных артефактов | Безопасная очистка | Сверка фактов | Машинный конверт | Граница | |---|---|---|---|---|---| | CLI (`humanizer-markers`, `-polish`, `-facts`, `-report`) | да, с координатами и классами A/B | режимы strip / --preserve-markup / --typographic с инвариантами сохранения | humanizer-facts (категории фактов) | --json, коды возврата по контракту | семантику не проверяет; вердиктов об авторстве нет | | MCP (`humanizer-mcp`, набор инструментов contract.v1.json) | те же команды через stdio | те же режимы через humanizer_polish | humanizer_facts | JSON-RPC конверты, isError по контракту | текст не покидает процесс | | Демо на Pages | да, подсветка исходных диапазонов в браузере | нет (только проверка и отчёт) | нет | копирование отчёта из одного результата | офлайн в браузере, без установки | | GitHub Action | гейт вставки + автофикс текстового пути (класс A) | action_fix вне fenced/кода | нет | rc гейта | фикс не трогает защищённые области | | Текстовый скилл (SKILL.md) | процедуры агента по references | стилевая правка только по явной просьбе | нет | нет (проза скилла) | гарантий естественности и сохранности смысла нет | ## Что это НЕ делает - Переписанный текст: теоретический потолок детекции при парафразе [bib:sadasivan2023]; парафраз обнуляет детекторы [bib:dipper2023]. - Нативно-гладкий машинный текст без артефактов: документная граница там же [bib:sadasivan2023]; популяционная детекция возможна только на больших выборках [bib:chakraborty2023], вердикт по документу не заявляется. - Короткий текст: сигналов меньше, чем слов, водяной знак и статистика требуют длины [bib:anthropic2026wm], [bib:synthid2024]. - Водяные знаки без ключа: distortion-free знак не виден стороннему наблюдателю по построению [bib:kuditipudi2023]; криптографическая неотличимость без ключа [bib:cgz2023]; детектор SynthID-Text требует ключ разработчика [bib:synthid2024]; Anthropic подтверждает: без ключа знак не проверяется, детектор-API в закрытом preview [bib:anthropic2026wm]. - Ключи [bib:…] раскрыты в [research/BIBLIOGRAPHY.md](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/research/BIBLIOGRAPHY.md). - polish не запускать на Markdown и разметке: снимает ##, **, ёлочки, тире; для разметки — режим --preserve-markup. ## Почему можно доверять - [Методология и бенчмарк: числа с доверительными интервалами](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/research/F8-UMBRELLA-2026.md). - [Публичный бенчмарк: таблица с CI, командами воспроизведения и колонкой «где мы хуже»](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/demo/benchmark/index.html). - [Модель угроз и границы детектора](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/docs/THREAT-MODEL.md). - [Парити-гейт Python и JS правил](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/.github/workflows/regex-check.yml). - [Самоаудит: числа, статусы и эррата](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/eval/facts/self-audit.v1.json). - Статус последнего успешного прогона и деплоя: [status.json на Pages](https://vladimir-human.github.io/humanizer-ru/status.json) (генерируется деплой-артефактом из точного SHA; обновляется только зелёным прогоном). ## Установка скилла в браузерные клиенты - Демо работает без установки: https://vladimir-human.github.io/humanizer-ru/ — текст не покидает браузер. - Claude.ai и Claude Code: добавьте скилл из каталога `dsh/skills/humanizer-ru` по инструкции установки в [docs/USAGE.md](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/docs/USAGE.md#установка-за-30-секунд). - Агентные клиенты с поддержкой agentskills.io (opencode, DeepSeek Harness): распакуйте текстовый бандл из архива релиза. - Браузерное расширение отклонено: новый поверхностный контур (permissions, store review) не окупается; очередь идей — [research/BACKLOG.md](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/research/BACKLOG.md). Каталоги: [Glama MCP](https://glama.ai/mcp/servers/Vladimir-Human/humanizer-ru) · [skills.sh](https://www.skills.sh/vladimir-human/humanizer-ru/humanizer-ru). ## Одноимённые проекты На GitHub есть скиллы с тем же именем и другим содержанием. Снимок 2026-09-05 (проверка: `gh repo view <владелец>/humanizer-ru --json stargazerCount`): - [ilyautov/humanizer-ru](https://github.com/ilyautov/humanizer-ru) — 284 звезды: позиционирование «убирает признаки нейросети», публичного реестра чисел нет. - [smixs/humanizer-ru](https://github.com/smixs/humanizer-ru) — 148 звёзд: детерминированный линтер; единственный тёзка, включённый в [LEADERBOARD.md](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/LEADERBOARD.md) как кандидат (парный прогон 2026-09-03). - Этот проект — проверяемая гигиена вставки из чат-интерфейсов: каждое число из детерминированных снимков и [реестра фактов](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/eval/facts/facts.v1.json), границы — в [THREAT-MODEL](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/docs/THREAT-MODEL.md), ложные срабатывания — в [бенчмарке](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/demo/benchmark/index.html). Пришли по имени — выбирайте по способу проверки, а не по звёздам. ## Цифры проекта - 58 паттернов машинного письма и 40 regex-маркеров (классы A и B). - Записи доказательств: 38 из 40 маркеров (реестр research/fixtures/marker-sources.json). - Гейты: 153 гейта полного check_all (142 в --quick); фикстуры в tests/fixtures/, документация сверяется check_docs.py, персона описана в PERSONA.md. Почему так называется: имя унаследовано от первой функции, снимавшей слой копипасты после чат-бота и возвращавшей тексту человеческий вид. Вторая функция продукта: диагностика, подсветить машинные следы и объяснить причину каждого флага, без вердиктов об авторстве. Обе функции работают офлайн, текст не покидает вашу машину. Классовая разбивка FP, exploratory, вне предрега F16: класс A: 0 случаев на 12314 текстов-неносителей; класс B: 8 случаев на 12314, то есть 0.00065, Wilson 95% CI от 0.0003 до 0.0013; контрольный набор 40 текстов: флагов 0; тяжёлый домен S4 legal и official, n=381, дефицит объёма зафиксирован в предреге: 18 случаев на 381, то есть 0.0472, Wilson 95% CI от 0.0301 до 0.0734; знаменатели: 12354 полный корпус F16, 12314 validation-страта. ## Подробнее - [Что ему давать и как переписывать](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/docs/USAGE.md#что-ему-давать) - [Установка вручную и использование](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/docs/USAGE.md#использование) - [Архитектура и паттерны](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/docs/USAGE.md#архитектура) - [Безопасность и отличия версий](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/docs/USAGE.md#безопасность) - [Источники](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/docs/USAGE.md#источники) ## Regex-маркеры: классы A и B Класс A — жёсткие артефакты копипасты: служебные ссылки и метки цитирования чат-интерфейсов. Класс B — контекстные индикаторы: невидимые символы, скрытая раскладка, placeholder-поля; одного совпадения B недостаточно. Класс маркеров — `copypaste_artifacts`; ретайр маркера возможен только по провалу на своём классе, статусы и даты — в `markers.v1.json`. ## История изменений История изменений — в [CHANGELOG.md](https://github.com/Vladimir-Human/humanizer-ru/blob/HEAD/CHANGELOG.md) и на [GitHub Releases](https://github.com/Vladimir-Human/humanizer-ru/releases). ## Лицензия MIT ## Статус проекта [![Версия](https://img.shields.io/github/v/release/Vladimir-Human/humanizer-ru?label=%D0%B2%D0%B5%D1%80%D1%81%D0%B8%D1%8F&color=blue)](https://github.com/Vladimir-Human/humanizer-ru/releases) [![Skills.sh](https://img.shields.io/badge/skills.sh-%D0%BA%D0%B0%D1%82%D0%B0%D0%BB%D0%BE%D0%B3-blueviolet)](https://www.skills.sh/vladimir-human/humanizer-ru/humanizer-ru) [![Догфудинг](https://img.shields.io/badge/%D1%81%D0%B2%D0%BE%D0%B8_%D0%B4%D0%B5%D1%82%D0%B5%D0%BA%D1%82%D0%BE%D1%80%D1%8B-%D0%BE%D1%82%D1%87%D1%91%D1%82-brightgreen)](https://github.com/Vladimir-Human/humanizer-ru/blob/main/eval/facts/self-audit.v1.json) Догфудинг — проект проверяет собственные тексты собственными правилами: порог маркеров стиля в файлах поставки сверяется гейтом `scripts/check_own_style.py` (текущий максимум выводится в его запуске).