novel-writer-ru

v0.20.0

Published

3 months ago

Инструмент для создания китайских романов на базе ИИ — умный помощник по написанию, основанный на структурированном рабочем процессе

0High
0Medium
0Low

jakerdy

novel writer chinese ai creative-writing translation

Novel Writer - Инструмент для создания китайских романов на базе ИИ

🚀 AI-ассистент для создания романов на основе разработки, управляемой спецификациями (SDD)
Используйте команды с косой чертой прямо в AI-помощниках, таких как Claude, Cursor, Gemini, для систематического создания высококачественных романов.

✨ Основные возможности

📚 Команды с косой чертой - Используйте напрямую в AI-помощниках, таких как Claude, Gemini, Codex, Cursor, Windsurf, Roo Code и других.
🎯 Методология семи шагов - Систематизированный творческий процесс на основе разработки, управляемой спецификациями (SDD).
🤖 Интеллектуальная помощь - ИИ понимает контекст и предлагает целенаправленные творческие рекомендации.
📝 Оптимизация для китайского языка - Специально разработан для создания китайских романов, поддерживает подсчет слов, управление несколькими сюжетными линиями.
🔄 Кроссплатформенность - Поддерживает 13 AI-инструментов, полностью совместим с Windows/Mac/Linux.
🔌 Система плагинов - Расширяемые функции, такие как реальный голос, перевод, имитация стиля и т. д.
✅ Гарантия качества - Отслеживание сюжета, управление временной шкалой, проверка согласованности персонажей.

📖 Подробное описание возможностей：См. CHANGELOG.md для полного списка изменений по версиям.

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

1. Установка

npm install -g novel-writer-ru

2. Инициализация проекта

# Базовое использование
novel init my-novel

# Рекомендуется: предварительная установка плагина реального голоса
novel init my-novel --plugins authentic-voice

# Указание AI-платформы
novel init my-novel --ai claude    # Claude Code
novel init my-novel --ai gemini    # Gemini CLI
novel init my-novel --ai codex     # Codex CLI
novel init my-novel --ai cursor    # Cursor

3. Начните творить

Используйте команды с косой чертой в вашем AI-помощнике:

/novel.constitution    # Формат Claude Code
/novel:constitution    # Формат Gemini CLI
/novel-constitution    # Формат Codex CLI
/constitution          # Формат для других платформ

Процесс методологии семи шагов:

/constitution → 2. /specify → 3. /clarify →
/plan → 5. /tasks → 6. /write → 7. /analyze

📚 Подробные инструкции по установке：docs/installation.md 📖 Полный рабочий процесс：docs/workflow.md 🎯 Соответствие команд AI-платформ：docs/ai-platform-commands.md ⭐ Обязательно к прочтению

📦 Обновление существующего проекта

# Обновление до последней версии
npm install -g novel-writer-ru@latest
cd my-novel
novel upgrade

# Или указание AI-платформы
novel upgrade --ai claude

📚 Полное руководство по обновлению：docs/upgrade-guide.md - включает информацию о совместимости версий, инструкции по миграции, методы отката.

📚 Команды с косой чертой

Описание пространства имен

| AI-платформа | Формат команды | Пример | | -------------------- | -------------------- | -------------- | | Claude Code | /novel.имя_команды | /novel.write | | Gemini CLI | /novel:имя_команды | /novel:write | | Codex CLI | /novel-имя_команды | /novel-write | | Другие платформы | /имя_команды | /write |

💡 В таблице ниже используется общий формат, при фактическом использовании добавьте соответствующий префикс для вашей AI-платформы. 📖 Подробное соответствие команд：docs/ai-platform-commands.md

Методология семи шагов

| Команда | Описание | Когда использовать | | --------------- | -------------------- | ------------------------------------------------------------------- | | /constitution | Создание устава | В начале проекта, определение основных принципов творчества | | /specify | Спецификации истории | Определение требований к истории, как PRD | | /clarify | Уточнение решений | Прояснение неясных моментов с помощью 5 вопросов | | /plan | Создание плана | Разработка структуры глав и технического плана | | /tasks | Декомпозиция задач | Создание списка выполнимых задач | | /write | Написание главы | Написание на основе списка задач | | /analyze | Комплексная проверка | Интеллектуальный двухрежимный: анализ структуры / анализ содержания |

Отслеживание и проверка

| Команда | Описание | Когда использовать | | -------------- | ----------------------------- | ---------------------------------------------------------------------------------- | | /track-init | Инициализация отслеживания | При первом использовании (только один раз) | | /checklist | Контрольный список качества ⭐ | Проверка спецификаций (перед написанием) + сканирование контента (после написания) | | /track | Комплексное отслеживание | После завершения каждой главы | | /plot-check | Проверка сюжета | Регулярная проверка каждые 5-10 глав | | /timeline | Управление временной шкалой | После важных событий | | /relations | Отслеживание отношений | При изменении отношений между персонажами | | /world-check | Проверка мира | После появления новых настроек |

📖 Подробное описание команд：docs/commands.md - включает подробное использование, параметры и лучшие практики для каждой команды.

my-novel/
├── .specify/          # Конфигурация Spec Kit
│   ├── memory/        # Память для творчества (constitution.md и т.д.)
│   └── scripts/       # Вспомогательные скрипты
├── .claude/           # Команды Claude (или .cursor/.gemini и т.д.)
│   └── commands/      # Файлы команд с косой чертой
├── spec/              # Данные спецификаций романа
│   ├── tracking/      # Данные отслеживания (plot-tracker.json и т.д.)
│   └── knowledge/     # База знаний (world-setting.md и т.д.)
├── stories/           # Содержание романа
│   └── 001-название_истории/
│       ├── specification.md    # Спецификации истории
│       ├── creative-plan.md    # Творческий план
│       ├── tasks.md            # Список задач
│       └── content/            # Содержание глав
└── scripts/           # Вспомогательные скрипты
    ├── bash/          # Unix/Linux/Mac
    └── powershell/    # Windows

🤖 Поддерживаемые AI-помощники

| AI-инструмент | Описание | Статус | | ---------------------- | ------------------------------------------------------------ | ------------------ | | Claude Code | AI-помощник от Anthropic | ✅ Рекомендуется | | Cursor | AI-редактор кода | ✅ Полная поддержка | | Gemini CLI | AI-помощник от Google | ✅ Формат TOML | | Windsurf | AI-редактор от Codeium | ✅ Полная поддержка | | Roo Code | AI-помощник для программирования | ✅ Полная поддержка | | GitHub Copilot | AI-помощник для программирования от GitHub | ✅ Полная поддержка | | Qwen Code | AI-помощник для кода от Alibaba Tongyi Qianwen | ✅ Формат TOML | | OpenCode | Инструмент для AI-программирования с открытым исходным кодом | ✅ Полная поддержка | | Codex CLI | AI-помощник для программирования | ✅ Полная поддержка | | Kilo Code | Инструмент для AI-программирования | ✅ Полная поддержка | | Auggie CLI | AI-помощник для разработки | ✅ Полная поддержка | | CodeBuddy | AI-партнер по программированию | ✅ Полная поддержка | | Amazon Q Developer | AI-помощник для разработки от AWS | ✅ Полная поддержка |

💡 Использование novel init --all позволяет сгенерировать конфигурацию для всех AI-инструментов одновременно.

🛠️ CLI команды

`novel init [name]`

novel init my-novel [опции]

Часто используемые опции:

--here - Инициализировать в текущем каталоге
--ai <type> - Выбрать AI-платформу (claude/gemini/cursor и т.д.)
--with-experts - Включить экспертный режим
--plugins <names> - Предварительно установить плагины (через запятую)
--all - Сгенерировать конфигурацию для всех AI-платформ

`novel plugins`

novel plugins list                # Показать список установленных плагинов
novel plugins add <name>          # Установить плагин
novel plugins remove <name>       # Удалить плагин

`novel upgrade`

novel upgrade [--ai <type>]       # Обновить проект до последней версии

`novel check`

novel check                       # Проверить конфигурацию и состояние проекта

📖 Индекс документации

Основная документация

Подробное описание команд - Подробное использование, параметры и лучшие практики для всех команд с косой чертой.
Рабочий процесс - Полное описание творческого процесса.
Методы письма - Подробное описание 6 классических методов письма.
Лучшие практики - Практический опыт и продвинутые приемы.

Продвинутая документация

Практическое руководство - Применение SDD на реальных примерах.
Руководство по обновлению - Инструкции по обновлению версий и миграции.
Руководство по установке - Подробные шаги по установке.
Подсчет слов - Лучшие практики подсчета слов в китайском языке.

Плагины и расширения

Плагин реального голоса - novel plugins add authentic-voice
- Отредактируйте .specify/memory/personal-voice.md для настройки личных голосовых данных.
- Используйте /authentic-voice для создания, /authenticity-audit для самопроверки.
Плагин перевода - novel plugins add translate
Плагин имитации стиля - Стиль писателей, таких как Лу Яо, Ван Юй и др.

💡 Используйте novel plugins list для просмотра всех доступных плагинов.

📈 История версий

Полный журнал изменений: CHANGELOG.md

Основные моменты последнего релиза:

v0.15.0 - Оптимизация формата команд для нескольких платформ
v0.14.2 - Исправление подсчета слов в китайском языке
v0.12.2 - Улучшенный слой для Claude Code
v0.12.0 - Система управления несколькими сюжетными линиями
v0.10.0 - Система методологии семи шагов

🤝 Вклад

Приглашаем к отправке Issues и Pull Requests!

Адрес проекта: https://github.com/wordflowlab/novel-writer

📄 Лицензия

MIT License

🌐 Матрица проектов

WordFlowLab исследует AI-ассистированное написание романов в различных аспектах, используя комбинацию открытых проектов с разными методологиями и технологическими стеками:

Серия исследований методологий

| Проект | Методология | Технические особенности | Применение | | --------------------------------------------------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | | Novel-Writer ⭐ | Spec-Kit | Использует команды с косой чертой, методология семи шагов | Подходит для пользователей разных платформ, работает с 13 AI-инструментами | | Article-Writer 🆕 | Spec-Kit | Процесс написания из девяти шагов, управление рабочей областью | Создание статей для WeChat/самостоятельных медиа, уменьшение "AI-вкуса" | | Novel-Writer-OpenSpec | OpenSpec | Использует команды с косой чертой, раздельное управление спецификациями (specs/ + changes/) | Подходит для стандартизированного управления спецификациями OpenSpec | | Novel-Writer-Skills | Spec-Kit + Agent Skills | Использует команды с косой чертой, поддерживает Claude Code Agent Skills | Специально оптимизирован для Claude Code |

Серия реализаций инструментов

| Проект | Тип | Техническая основа | Описание | | ----------------------------------------------------------- | ----------------- | ----------------------------------------------- | ------------------------------------------------------- | | WriteFlow | CLI-инструмент | Имитация архитектуры Claude Code | Автономный CLI, разработанный для технических писателей | | NovelWeave | Расширение VSCode | Форк: Cline → Roo Code → Kilo Code → NovelWeave | Визуальный редактор романов, плетение звездной пыли |

Путь технологической эволюции

Ветвь методологии Spec-Kit:
  Novel-Writer (основная линия) ──┬─→ Novel-Writer-Skills (специальная версия для Claude Code)
                                 └─→ WriteFlow (автономная версия CLI)

Ветвь методологии OpenSpec:
  Novel-Writer-OpenSpec (исследовательская версия)

Ветвь расширения VSCode:
  Cline → Roo Code → Kilo Code → NovelWeave (специальная версия для романов)

🙏 Благодарности

Проект разработан на основе архитектуры Spec Kit, за что выражаем особую благодарность! Оригинальная китайская версия Novel Writer

Novel Writer - Пусть ИИ станет вашим творческим партнером! ✨📚