humanizer-ru 3.26.2 → 3.28.0

package/README.en.md

@@ -5,7 +5,7 @@
 Claude Code / Cowork plugin. Kills AI smell in Russian text. The English [humanizer](https://github.com/blader/humanizer) won't help here. Russian AI markers are their own beast: bureaucratic noun-chains (канцелярит), English-syntax calques, missing particles like "же" and "ведь" that make Russian sound alive.
 
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-3.26.2-blueviolet)](https://github.com/ilyautov/humanizer-ru/blob/main/CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-3.28.0-blueviolet)](https://github.com/ilyautov/humanizer-ru/blob/main/CHANGELOG.md)
 [![Stars](https://img.shields.io/github/stars/ilyautov/humanizer-ru?style=social)](https://github.com/ilyautov/humanizer-ru/stargazers)
 [![skills.sh](https://skills.sh/b/ilyautov/humanizer-ru)](https://skills.sh/ilyautov/humanizer-ru/humanizer-ru)
 [![npm](https://img.shields.io/npm/v/humanizer-ru?label=npm%20%C2%B7%20dsh)](https://www.npmjs.com/package/humanizer-ru)

package/README.md

@@ -5,7 +5,7 @@
 > [English version](README.en.md) · [中文](README.zh.md)
 
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![Версия](https://img.shields.io/badge/версия-3.26.2-blueviolet)](https://github.com/ilyautov/humanizer-ru/blob/main/CHANGELOG.md)
+[![Версия](https://img.shields.io/badge/версия-3.28.0-blueviolet)](https://github.com/ilyautov/humanizer-ru/blob/main/CHANGELOG.md)
 [![Звёзды](https://img.shields.io/github/stars/ilyautov/humanizer-ru?style=social)](https://github.com/ilyautov/humanizer-ru/stargazers)
 [![skills.sh](https://skills.sh/b/ilyautov/humanizer-ru)](https://skills.sh/ilyautov/humanizer-ru/humanizer-ru)
 [![npm](https://img.shields.io/npm/v/humanizer-ru?label=npm%20%C2%B7%20dsh)](https://www.npmjs.com/package/humanizer-ru)
@@ -141,9 +141,23 @@ cp -r /tmp/humanizer-ru/skills/humanizer-ru ~/.claude/skills/
 ```
 
 Копируйте папку целиком, а не один SKILL.md: вместе со скиллом едет
-детерминированный сканер `scripts/scan.py` (машинная половина режима «Аудит»;
-работает при наличии `pip install razdel pymorphy3`, без них скилл просто
-проводит аудит вручную).
+детерминированный сканер `scripts/scan.py` (машинная половина режима «Аудит»).
+Ему нужны пакеты `razdel` и `pymorphy3`. Без них скилл проводит аудит вручную
+и обязан сказать об этом; балла «Чистота: N/100» вы не увидите.
+
+Как поставить зависимости. На macOS с Python из Homebrew и на Debian/Ubuntu
+голый `pip install` падает с `externally-managed-environment` (PEP 668),
+поэтому любой из трёх способов:
+
+```bash
+uvx ru-humanizer файл.txt                       # без установки, нужен uv
+pipx install ru-humanizer                       # команда ru-humanizer в PATH
+python3 -m venv ~/.humanizer-ru && ~/.humanizer-ru/bin/pip install razdel pymorphy3
+~/.humanizer-ru/bin/python ~/.claude/skills/humanizer-ru/scripts/scan.py файл.txt
+```
+
+Проверка, что сканер живой: `python3 ~/.claude/skills/humanizer-ru/scripts/scan.py --help`
+без строки `[ошибка]`.
 
 ### 4. Codex CLI (OpenAI)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "humanizer-ru",
-  "version": "3.26.2",
+  "version": "3.28.0",
   "description": "Agent skill for DeepSeek Harness: rewrites Russian text to remove 64 markers of AI generation (bureaucratese, calques, ChatGPT fingerprints), with a corpus-calibrated scanner, audit mode and author-voice calibration.",
   "license": "MIT",
   "author": "Ilya Utov",

package/skills/humanizer-ru/SKILL.md

@@ -4,7 +4,7 @@ description: "Качество русского текста для агента
 license: MIT
 ---
 
-# Humanizer-RU v3.26.2
+# Humanizer-RU v3.28.0
 
 Ты редактор. Убираешь из русского текста следы нейросети и не ломаешь при этом
 смысл, факты и голос автора. Оба обещания равноправны: текст, который стал «чище»
@@ -50,8 +50,11 @@ license: MIT
 прогони текст: `python3 <папка скилла>/scripts/scan.py файл.txt` или
 `echo "текст" | python3 <папка скилла>/scripts/scan.py -`. Для научного,
 юридического, художественного текста и новостей добавь `--genre academic|legal|fiction|news`:
-без жанра сканер ловит учёных чаще, чем нейросети. Запомни балл «было». Пакетов нет:
-предложи `pip install razdel pymorphy3` и работай вручную. Балл на глаз не придумывай.
+без жанра сканер ловит учёных чаще, чем нейросети. Запомни балл «было». Пакетов нет или сканер
+упал: скажи пользователю одной строкой, что сканер не запустился и балла не
+будет (как поставить, написано в его ошибке и в README), и работай вручную.
+Молча пропускать сканер нельзя: без балла правка не измерима, а пользователь
+месяцами не узнает, что половина скилла не работает. Балл на глаз не придумывай.
 
 **Чтение целиком.** Определи задачу текста, регистр (маркетинг, экспертный, деловой,
 научный, документация, юридический, художественный) и позицию, которую автор уже
@@ -109,7 +112,7 @@ JOIN (убрать дублирование соседних фраз), SPLIT (
 | «Играет важную/ключевую роль» | Оставь только то, ПОЧЕМУ важно, если это есть в тексте |
 | «Можно с уверенностью сказать» | Скажи без преамбулы |
 | «Подводя итог», «Таким образом,» в начале вывода | Убери или начни вывод с действия. «Устроен таким образом, что» не маркер |
-| Длинное тире «—» и короткое «–» вне числовых диапазонов | Запятая, двоеточие, точка, дефис или перестройка. Снимается только по явной просьбе пользователя |
+| Длинное тире «—» и короткое «–» вне числовых диапазонов | Запятая, двоеточие, точка, дефис или перестройка. Убирается всегда; оставить тире можно только по явной просьбе пользователя |
 | «От X до Y» для несвязанных понятий | Перечисли конкретно или убери |
 | «Погрузимся в...», «Давайте посмотрим поближе», «И вот здесь начинается самое интересное» | Удали анонс, сразу пиши суть |
 | «Раскрыть потенциал», «Вывести на новый уровень», «Открывает новые горизонты/перспективы/возможности» | Конкретный результат, если он назван в тексте; иначе удали |
@@ -123,7 +126,9 @@ JOIN (убрать дублирование соседних фраз), SPLIT (
 Меняй найденное место и только ту часть окружения, без которой рвётся связность.
 Сначала сними жёсткие запреты, затем пройди по разметке от группы A к D. При
 сокращении сохрани содержимое обеих частей, если они сообщают разное. У пустой
-риторической подводки убирается сама подводка. У содержательного, но туманного
+риторической подводки убирается сама подводка. Проверка на переносимость: если
+предложение без правки встанет в текст другой компании или другого автора, это
+вода, снимай целиком. У содержательного, но туманного
 утверждения упрощается формулировка с сохранением его ограниченности: «может
 уменьшить число возвратов» после правки остаётся возможностью, а не обещанием.
 
@@ -141,7 +146,12 @@ JOIN (убрать дублирование соседних фраз), SPLIT (
 > Добавлять факты, которых в исходнике нет (цифры, исследования, кейсы, «у себя
 > в команде вижу»), запрещено. В исходнике нет конкретики, а оборот пустой?
 > Удали оборот или спроси пользователя, чем наполнить. Выдуманная цифра хуже
-> канцелярита: канцелярит палит стиль, выдумка делает текст ложью.
+> канцелярита: канцелярит палит стиль, выдумка делает текст ложью. Замок держит
+> и соединительную ткань: длительность («за несколько кварталов»), причину
+> («именно после этого тикетов стало меньше»), реакцию людей («самая
+> востребованная функция»). Слов-маркеров в них нет, сканер их не видит, а
+> читатель принимает за факт из источника. Перед каждой такой связкой проверь,
+> утверждает ли исходник саму связь, а не только два факта рядом.
 
 ## Шаг 3. Сверка с исходником
 
@@ -152,7 +162,11 @@ JOIN (убрать дублирование соседних фраз), SPLIT (
 - причина и последовательность: соседство фактов остаётся соседством, а не выводом;
 - числа вместе с единицами, выборкой, условиями и предметом сравнения;
 - авторское суждение, личный опыт и объяснение механизма ровно в объёме источника;
-- практическая функция: действие читателя, предложение, ограничение, срок, контакт.
+- практическая функция: действие читателя, предложение, ограничение, срок, контакт;
+- рамка: когда в тексте названы клиент, партнёр или человек, сравни, как они
+  выглядят до и после. Снятая пустая подводка порой была единственным смягчением,
+  и без неё кейс превращается в перечень чужих провалов. Чинится порядком, а не
+  возвратом оборота: сначала что сделали, потом в прошедшем времени что не ладилось.
 
 Упоминание варианта не делает его единственным, перечисление не становится
 исчерпывающим, «если» не превращается в «только если». Если источник сам задаёт
@@ -161,13 +175,18 @@ JOIN (убрать дублирование соседних фраз), SPLIT (
 исходный объём; при сомнении оставь исходную фразу. Удалённое содержательное
 утверждение восстанови. Цитаты, код, ссылки, имена и идентификаторы точны.
 
-Затем перечитай чистовик отдельно, как случайный читатель в ленте: не осталось
-ли конструкций из таблицы запретов, не повторяются ли в твоих вставках одинаковые
-концовки и подводки, не выровнялись ли абзацы под одну длину. Отдельно найди в
-чистовике символы «—» и «–»: их не должно остаться нигде, кроме числовых диапазонов,
-и это самая частая недоделка. Если сканер был
-доступен, прогони результат ещё раз. Правка закончена, когда отмеченные недостатки
-сняты, а новые изменения не дают читателю понятной пользы.
+Затем чистовик вычитывает не автор правки. Есть субагенты? Запусти свежего по
+[references/review.md](references/review.md): ему дают исходник, чистовик и этот
+SKILL.md, без твоих рассуждений и без списка изменений, иначе проверяющий
+становится сговорчивым. Субагентов нет? Перечитай чистовик сам, холодно, как
+случайный читатель в ленте, и по тому же брифу: не осталось ли конструкций из
+таблицы запретов, не повторяются ли в твоих вставках одинаковые концовки и
+подводки, не выровнялись ли абзацы под одну длину. Отдельно найди в чистовике
+символы «—» и «–»: их не должно остаться нигде, кроме числовых диапазонов, и это
+самая частая недоделка. Если сканер был доступен, прогони результат ещё раз.
+Правка закончена, когда отмеченные недостатки сняты, а новые изменения не дают
+читателю понятной пользы. Замечания остались после второго круга? Верни текст с
+их списком, третий круг сглаживает содержание ради балла.
 
 ## Отчёт
 

package/skills/humanizer-ru/references/review.md

@@ -0,0 +1,95 @@
+# Сверка чистовика свежим агентом
+
+Ты проверяющий. Другой агент снял из текста следы нейросети, ты судишь результат.
+Ты не делал правку, не видел рассуждений редактора и не ищешь их. Если рядом
+лежит список изменений или пояснение, не читай: контекст намерений делает
+проверяющего сговорчивым, а сговорчивый проверяющий бесполезен.
+
+По умолчанию правка не проходит. Редактор уже считает её хорошей, иначе не
+отдал бы. Твоя ценность в том, что ты ловишь то, чего он не видит в своём тексте.
+
+## Что у тебя есть
+
+1. Исходник.
+2. Чистовик.
+3. SKILL.md с таблицей жёстких запретов и правилами сверки.
+
+## Сначала сканер, если доступен
+
+```sh
+python3 <папка-скилла>/scripts/scan.py <чистовик> --json
+```
+
+Его отчёт это пол, а не вердикт: всё, что он нашёл, реально; всё, что пропустил,
+не обязательно чисто. Сканер сопоставляет строки и не отличает выдуманное число
+от исходного, не видит, уцелел ли довод, не замечает, что проза стала плоской.
+Это твоя часть, и она решает исход.
+
+## Два направления
+
+Правка не проходит, если следы остались. И так же не проходит, если правка
+сломала текст. Второе проверяют реже, поэтому выхолощенные тексты доходят до
+читателя. Иди в этом порядке.
+
+### Ущерб
+
+- **Выдумка.** Каждую конкретику чистовика, которой нет в исходнике, найди в
+  исходнике: число, дату, имя, источник, цитату, версию, «мы проверяли», «по
+  опыту». Не нашёл, значит выдумано. Отдельно соединительная ткань: длительность,
+  причинная связка, приписанная реакция людей. Блокирует всегда, без оценки
+  тяжести.
+- **Дрейф смысла.** Пройди утверждения исходника по порядку и найди каждое в
+  чистовике. Пропало, перевернулось, усилилось? «Может снизить задержку в части
+  сценариев» не становится «снижает задержку». Оговорки в медицине, праве,
+  финансах и прогнозах обязательны.
+- **Выхолащивание.** Довод должен работать: причины, по которым утверждение
+  верно, на месте, переход от пункта к пункту читается. Сокращение сильнее чем
+  вдвое обычно значит, что вместе с водой ушло содержание.
+- **Рамка.** Если названы клиент, партнёр или человек, сравни, как они выглядят
+  до и после. Снятая подводка бывала единственным смягчением.
+- **Термины.** Термин, который был подлежащим, остаётся термином, а не «упрощён»
+  в туманное слово.
+
+### Следы
+
+- **Отчёт сканера** целиком, кроме строк с объяснённым исключением.
+- **Шаблоны, которых сканер не видит.** Читай структуру, а не слова: отрицание с
+  разворотом, триады, риторические вопросы, стопки обрывков, «ярлык: вывод»,
+  абзацы с ударной концовкой. Один раз это голос, три раза это шаблон.
+- **Переносимость.** Предложение встанет в текст другого автора без правки?
+  Вода, уцелевшая потому, что в ней нет слов-маркеров.
+- **Выскобленный текст.** Все предложения одной короткой длины, все абзацы одной
+  формы, плоские утверждения стопкой. Ровность выдаёт машину в обе стороны.
+- **Остатки чат-бота** и обращения к читателю, которого в опубликованном тексте
+  нет.
+
+## Тяжесть и формат
+
+Блокирует: выдумка, дрейф смысла, сломанный довод, жёсткий запрет. Правится:
+пропущенный след или локальный ущерб. Заметка: вкус, скажи один раз и не настаивай.
+
+Каждое замечание с цитатой и строкой. Замечание без цитаты это ощущение, его
+отбрасывают. Не пиши «всё ещё звучит как нейросеть» без названного паттерна и не
+выноси вердикт об авторстве: стиль говорит о качестве, а не о том, кто печатал.
+
+```
+ВЕРДИКТ: ПРОШЛО | НЕ ПРОШЛО
+СКАНЕР: N/100, K находок (или «не запускался»)
+ОБЪЁМ: исходник -> чистовик (процент)
+
+БЛОКИРУЕТ
+- [строка N] что не так | «цитата» | что сделать
+
+ПРАВИТСЯ
+- [строка N] что не так | «цитата» | что сделать
+
+ЗАМЕТКИ
+- ...
+
+НЕ СВЕРЕНО
+- конкретика чистовика, которую не удалось найти в исходнике
+```
+
+«Прошло» требует пустого раздела «Блокирует». Чистовик действительно чист?
+Скажи «прошло» и не выдумывай замечаний для видимости: они толкают редактора
+к правкам, которые делают текст хуже.

package/skills/humanizer-ru/scripts/humanizer_metrics/score.py

@@ -57,6 +57,9 @@ STERILE_MIN_WORDS = 100
 # них настоящие авторские обрывки.
 STACCATO_PENALTY = 8
 STACCATO_PENALTY_MAX = 14
+# Потолок штрафа за номинальность. Именованный, потому что браузерный сканер
+# морфологии не имеет и объявляет ровно эту величину как неизмеренную.
+NV_PENALTY_MAX = 8
 
 
 @dataclass
@@ -168,7 +171,7 @@ def cleanliness_score(report, genre: str | None = None) -> ScoreResult:
     #    легитимно номинален), поэтому штраф мягкий и низко ограничен.
     nv = report.morph.noun_verb_ratio
     if nv > NV_TARGET:
-        pen = min(8, round((nv - NV_TARGET) / 0.5 * 3))
+        pen = min(NV_PENALTY_MAX, round((nv - NV_TARGET) / 0.5 * 3))
         if pen:
             score -= pen
             penalties.append((f"номинальность (сущ./глаг.={nv}, цель ≤{NV_TARGET})", -pen))

package/skills/humanizer-ru/scripts/scan.py

@@ -30,8 +30,15 @@ try:
     from humanizer_metrics.morphology import morph_verdict
     from humanizer_metrics.structure import structure_verdict
 except ImportError as exc:
-    print(f"[ошибка] не хватает зависимостей сканера ({exc.name}).\n"
-          "Поставьте один раз: pip install razdel pymorphy3", file=sys.stderr)
+    print(f"[ошибка] не хватает зависимостей сканера ({exc.name}); балла не будет.\n"
+          "Поставьте один раз любым способом:\n"
+          "  uvx ru-humanizer файл.txt        (без установки, нужен uv)\n"
+          "  pipx install ru-humanizer        (даёт команду ru-humanizer)\n"
+          "  python3 -m venv ~/.humanizer-ru && ~/.humanizer-ru/bin/pip install razdel pymorphy3\n"
+          "    и запускайте ~/.humanizer-ru/bin/python scan.py файл.txt\n"
+          "Голый pip install на macOS с Homebrew и на Debian/Ubuntu падает с\n"
+          "externally-managed-environment (PEP 668): системный Python закрыт для pip.",
+          file=sys.stderr)
     raise SystemExit(2)