humanizer-ru 3.27.0 → 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.27.0-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.27.0-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.27.0",
+  "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.27.0
+# 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» для несвязанных понятий | Перечисли конкретно или убери |
 | «Погрузимся в...», «Давайте посмотрим поближе», «И вот здесь начинается самое интересное» | Удали анонс, сразу пиши суть |
 | «Раскрыть потенциал», «Вывести на новый уровень», «Открывает новые горизонты/перспективы/возможности» | Конкретный результат, если он назван в тексте; иначе удали |

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)