Webnovel Writer — плагин

Плагин Claude Code для длинных веб-романов: планирование томов, написание и проверка глав, память о героях и сюжете, панель для просмотра состояния

  • 7 612 ★ репозитория
  • Последний коммит
  • GPL-3.0
Плагин

Широкий доступ

Почему такой уровень

  • Плагин ставит хуки Claude Code, которые срабатывают на каждой сессии и перехватывают запись файлов и команды Bash
  • Агент запускает скрипты Python и пишет много файлов в каталог книги: главы, состояние, индекс, резервные копии
  • Тексты глав и запросы уходят внешним службам эмбеддингов и ранжирования, если вы задали ключи
Все причины и проверки

lingfengqaq/webnovel-writer

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add plugins/webnovel-writer

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Плагин ставит хуки Claude Code, которые срабатывают на каждой сессии и перехватывают запись файлов и команды Bash
  • Агент запускает скрипты Python и пишет много файлов в каталог книги: главы, состояние, индекс, резервные копии
  • Тексты глав и запросы уходят внешним службам эмбеддингов и ранжирования, если вы задали ключи

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Webnovel Writer ведет автора длинного веб-романа от замысла до сотен глав и следит, чтобы в тексте не терялись установки мира, линии героев и заготовленные завязки. Плагин ставится через маркетплейс Claude Code и дает восемь команд: `/webnovel-init` собирает проект книги, `/webnovel-plan` строит план тома и глав, `/webnovel-write` пишет главу, `/webnovel-review` проверяет главы, `/webnovel-query` отвечает по состоянию, `/webnovel-learn` записывает приемы в память проекта, `/webnovel-dashboard` открывает панель, а `/webnovel-doctor` проверяет файлы и зависимости. Глава проходит строгую цепочку из девяти шагов. Сначала проверяется проект, затем агент контекста готовит задание на главу, после чего текст пишется по заданию, ревьюер проверяет его по нескольким критериям, и серьезные замечания блокируют продолжение. Далее идут правка и финальная проверка на следы машинного письма, агент данных вытягивает факты главы, и они записываются как принятый коммит главы. От него обновляются состояние в `state.json`, индекс, краткие содержания, долговременная память и векторная база. В конце делается резервная копия главы. Поиск по прошлым главам идет в режиме `auto`: сначала векторный поиск через внешнюю модель эмбеддингов, а при отсутствии ключа система откатывается к BM25. Для книги есть 37 шаблонов жанров, которые можно смешивать.

Для кого. Для авторов длинных веб-романов на китайском языке, которые пишут вместе с Claude Code и хотят держать сюжет и мир книги в согласованном состоянии на сотнях глав.

Подходит, если

  • Роман выходит по главам, и к двухсотой главе нужно помнить силы героев, время действия и открытые завязки
  • Нужно разложить общий замысел на тома, главы и временную линию и сохранить их в файлах проекта
  • Каждую главу нужно проверять на непротиворечивость, темп и характер героев до публикации
  • Хочется смешать несколько жанров, например систему и школьную драму, на основе готовых шаблонов
  • Нужна панель, где видны герои, связи между ними, главы и состояние завязок, без права правки

Не подходит, если

  • Вы пишете на другом языке: шаблоны жанров, интерфейс и инструкции плагина сделаны для китайских веб-романов
  • Вы работаете в Cursor или Codex: версия 6 рассчитана только на Claude Code, а для других сред автор ведет отдельную ветку v8
  • Нужна короткая форма без памяти и плана: достаточно обычного запроса к модели
  • Лицензия GPL-3.0 не подходит вашему проекту: проект распространяется под ней целиком

Пример запроса к агенту

Запусти /webnovel-write 45: подготовь контекст по сорок пятой главе, напиши ее, проверь ревьюером и покажи отчет с замечаниями

Ограничения

  • Ветка master с этой версией 6 живет в режиме поддержки: автор чинит только критические ошибки. Новую разработку ведет ветка v8 на основе DeepSeek Harness, где установка отличается.
  • Для векторного поиска нужны внешние службы эмбеддингов и ранжирования (по умолчанию ModelScope и Jina) с вашими ключами в файле `.env` книги. Тексты глав и запросы уходят этим службам, а без ключа поиск откатывается к BM25 и работает слабее.
  • Плагин ставит хуки Claude Code: при старте сессии он печатает короткий статус проекта, а перед записью файлов и командами Bash блокирует прямую правку служебных файлов состояния. Отключить проверку записи можно переменной `WEBNOVEL_DISABLE_RUNTIME_GUARD_HOOK`.
  • В тексте главной страницы размещена реклама трех сторонних сервисов-посредников доступа к моделям. Для работы плагина они не нужны, и SkillFoxx их не оценивал.
  • Автор указывает, что проект разрабатывался с Claude Code, Gemini CLI и Codex методом вайб-кодинга. Лицензия GPL-3.0.

Как отключить. Отключите или удалите плагин командами управления плагинами Claude Code: `claude plugin uninstall webnovel-writer@webnovel-writer-marketplace`. Каталоги книги (`正文`, `大纲`, `设定集`, `.story-system`, `.webnovel`) плагин не трогает при удалении, их можно оставить как рукописи или удалить вручную.

Частые вопросы

Из каких шагов состоит команда `/webnovel-write`?

Из девяти шагов: предпроверка проекта и состояния Story System, обновление рабочего контракта главы, задание от агента контекста, черновик, многокритериальная проверка ревьюером, правка с финальным контролем, извлечение фактов агентом данных, фиксация главы и запись в состояние, индекс, память и векторную базу, затем резервная копия. Пропускать и сливать шаги правила запрещают.

Что происходит, если ревьюер нашел серьезную проблему?

Серьезное замечание блокирует переход к правке и фиксации. Его исправляют точечно или решают вместе с автором. Проверка идет один раунд, а при сбое повторяется только упавший шаг, откатывать всю главу не нужно.

Что такое Story System и зачем `CHAPTER_COMMIT`?

Story System — главная цепочка плагина: в каталоге `.story-system/` лежат контракты перед написанием главы и принятые коммиты после нее. Состояние в `state.json`, индекс `index.db`, краткие содержания и память считаются производными и собираются из принятого `CHAPTER_COMMIT`.

Можно ли обойтись без ключей для векторного поиска?

Да. Без ключа эмбеддинга система откатывается к ключевому поиску BM25, и семантический подбор прошлых глав слабее. Эмбеддинги и ранжирование можно заменить любой службой с интерфейсом, совместимым с OpenAI.

Что показывает панель `/webnovel-dashboard`?

Только чтение: состояние проекта, граф связей героев и предметов, текст глав, завязки и данные об удержании читателя. Интерфейс собран заранее и поставляется вместе с плагином, запускать сборку на своей машине не нужно.

Обсуждение

Вопросов и отзывов пока нет.

Плагины

Скилл для написания романа с девятью агентами: сеттинг, план томов и глав, проза, проверка на машинный стиль и архив с памятью героев

СкиллРасширенный доступ835Звезды репозитория

Плагин для романов и сериальной прозы: агент muse ведет от идеи до черновика, а писатель, критик, редактор и проверка канона работают отдельными агентами

ПлагинРасширенный доступ528Звезды репозитория

Набор из 13 скиллов для написания сетевой прозы в кодинг-агенте: разбор рейтингов и хитов, план и текст, чистка ИИ-стиля, обложка

СкиллРасширенный доступ7,9 тыс.Звезды репозитория

24 скилла для прозы в Markdown, от замысла до печати, и команда story, которая находит противоречия в сюжете раньше читателей

СкиллРасширенный доступ340Звезды репозитория

Скилл для написания цельного романа на китайском по главам: трехуровневый опрос, память предпочтений, клиффхэнгеры и автопроверка

СкиллРасширенный доступ4,1 тыс.Звезды репозитория

Плагин Claude Code для полного цикла блога: стратегия, написание, оптимизация под поиск и AI-цитируемость, аудит и локализация статей

ПлагинРасширенный доступ2,5 тыс.Звезды репозитория

Сравнение с похожими

Записи с тем же главным запросом: чем они отличаются.

ЗаписьОфициальныйЗвезды репозиторияГлавное отличие
Webnovel Writer (эта запись)нет7 612
chinese-novelistнет4 103скилл для романа на китайском по главам с опросом, памятью предпочтений и автопроверкой, без базы фактов и панели состояния
awesome-novelнет835скилл для написания романа с девятью агентами

Коротко о README

Главная страница репозитория на китайском начинается со сведений о ветках: master хранит версию 6 для Claude Code, а v8 несет рабочее место на DeepSeek Harness. Дальше размещены блоки спонсоров, объяснение, зачем нужен плагин, таблица восьми команд, схема потока данных и установка из маркетплейса. Затем описаны запись окружения для векторного поиска, цепочка написания главы, итоговый отчет с тремя блоками, 37 жанров, список подкоманд CLI, ссылки на документы, правила вклада, история версий и лицензия GPL v3. В репозитории есть тесты, шаблоны обращений и документы по архитектуре.

Бейдж для README

Сообщить о проблеме

Foxx AIWebnovel Writer
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.