Story Development Toolkit

ابزار جامع پایتون برای تولید داستان‌های جذاب و منسجم با پشتیبانی از هوش مصنوعی، حافظه، خروجی، قالب و خط فرمان

Python 3.11+ نسخه 2.2.2 MIT میلاد رضانژاد آماده هوش مصنوعی آماده حافظه آماده خروجی آماده قالب آماده خط فرمان

نصب

bash
pip install story-toolkit

# نصب با قابلیت‌های اختیاری
pip install story-toolkit[openai]      # پشتیبانی از OpenAI
pip install story-toolkit[anthropic]   # پشتیبانی از Anthropic
pip install story-toolkit[local]       # مدل محلی (Ollama)
pip install story-toolkit[export]      # خروجی PDF و EPUB
pip install story-toolkit[all]         # همه قابلیت‌ها

یا نصب از سورس: pip install -e .

ویژگی‌ها

🎭

ایجاد شخصیت

ساخت شخصیت‌های پیچیده با ویژگی‌های شخصیتی، اهداف، مهارت‌ها، ترس‌ها و روابط. شامل سیستم قوس شخصیتی.

📚

تولید پیرنگ

تولید ساختار داستان برای ژانرهای: فانتزی، معمایی، عاشقانه، ماجراجویی و علمی-تخیلی با پیچش‌های داستانی.

💬

نوشتن دیالوگ

ایجاد دیالوگ‌های طبیعی با قالب‌های آماده. یکپارچگی اختیاری با هوش مصنوعی برای دیالوگ‌های پیشرفته (نسخه 2).

🌍

جهان‌سازی

طراحی جهان‌های داستانی با مکان‌ها، فرهنگ‌ها، قوانین، گروه‌ها و ارتباطات بین آن‌ها.

🔍

بررسی انسجام

شناسایی حفره‌های داستانی، ناسازگاری شخصیت‌ها، مشکلات زمانی و ارائه پیشنهادات بهبود.

📊

تحلیل متن

تحلیل خوانایی، ریتم داستان، تعادل دیالوگ‌ها، غنای واژگان و سطح دشواری متن.

💾

حافظه بلندمدت

ذخیره داستان‌ها در پایگاه داده SQLite با تایم‌لاین رویدادها و ماندگاری شخصیت‌ها (نسخه 2.1).

📄

خروجی چندفرمتی

خروجی داستان به فرمت‌های PDF، EPUB، HTML (۴ قالب) و Bionic Reading (نسخه 2.2).

📋

قالب‌های آماده

۵ قالب آماده داستان: سفر قهرمان، ۳ پرده، معمایی، عاشقانه، ترسناک (نسخه 2.2.1).

💻

ابزار خط فرمان

رابط خط فرمان کامل برای ساخت داستان بدون نوشتن کد پایتون (نسخه 2.2.2).

تاریخچه نسخه‌ها

v1.0.0
هسته
v2.0.0
هوش مصنوعی
v2.1.0
حافظه
v2.2.0
خروجی
v2.2.1
قالب
v2.2.2
خط فرمان

شروع سریع

استفاده پایه (سازگار با نسخه 1)

python
from story_toolkit import StoryToolkit

toolkit = StoryToolkit()
story = toolkit.create_story("fantasy", "courage")
hero = toolkit.add_character_to_story(story, "کای", "protagonist")
hero.add_trait("brave")

report = toolkit.check_story_coherence(story)
print(f"انسجام: {report['overall_score']:.0%}")

استفاده از قالب‌های آماده (نسخه 2.2.1)

python
story = toolkit.use_template("hero_journey", genre="fantasy")
templates = toolkit.list_templates()

استفاده از خط فرمان (نسخه 2.2.2)

bash
story-toolkit story new --genre fantasy --theme courage
story-toolkit template list
story-toolkit template use hero_journey
۵
ماژول اصلی
۳
تولیدکننده
۴
پشتیبان هوش مصنوعی
۴
فرمت خروجی
۵
قالب داستان
۳۰+
تست واحد

مستندات

ارتقا آسان! تمام کدهای نوشته شده برای نسخه 1 بدون تغییر در نسخه 2.2.2 کار می‌کنند.