Skip to content

huangjien/vscode-chapter-eval

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AI Editor

GitHub

English | Chinese (Simplified - zh-cn): 中文(简体) | Chinese (Traditional - zh-tw): 中文(繁體) | Cantonese (Traditional - zh-hk): 中文(繁體.粤语)Japanese (ja): 日本語 | French (fr): Français | German (de): Deutsch | Italian (it): Italiano | Spanish (es): Español | Portuguese (Brazilian - pt-br): Português (Brasil) | Russian (ru): Русский | Korean (ko): 한국어

AI Editor is a Visual Studio Code extension that leverages the capabilities of AI to assist authors in evaluating their novel chapters. This tool is designed to help both aspiring and seasoned writers gain insights into their writing and refine their craft.

Purpose of This Extension

This extension aims to fulfill the dream many of us have of writing a novel. As a programmer who has recently embarked on this journey, I developed this tool to simplify the evaluation process of my chapters, helping me enhance my storytelling without the daunting hassle of navigating through separate tools.

Key Features

  • Supports Markdown and Plain Text Files: Evaluate chapters written in both Markdown and plain text formats seamlessly.
  • AI Integration: Utilize the power of AI to analyze the narrative tension and quality of your writing.
  • Local Model Support: From version 0.7.x onwards, the extension has begun supporting local models (ollama) for evaluation, although results may vary.
  • User-Friendly Interface: Easily accessible commands allow for straightforward evaluations, formatting, and text management.
  • Text-To-Speech Support: The extension also allows you to read your selected text aloud.

Why You Should Use It

Every writer deserves to feel confident about their work. With AI Editor, you can receive constructive feedback that focuses on crucial areas of your story, such as pacing, tension, and character development. This extension is about more than just getting scores; it's about understanding your writing better.

Obtaining Your OpenAI API Key

To use this extension, you will need an API key from OpenAI. Follow these steps to obtain one:

  1. Visit OpenAI's website and create an account if you don’t have one.
  2. Click on the Create new secret key button.
  3. Copy the key and paste it into the API Key field in the extension settings.

Configuring the Extension

Update the settings for this extension in your VS Code environment to tailor its functionality to your needs.

Settings

The default prompt for evaluating your chapters is:

You are ASSISTANT, work as a literary critic. Please evaluate the tension of the following chapter and give it a score out of 100. Also, describe the curve of the tension changes in the chapter. Point out the three most outstanding advantages and the three biggest disadvantages of the chapter. If you find any typographical errors, please point them out.
USER: $PROMPT$
ASSISTANT:

Note: The $PROMPT$ should remain intact as it represents the content of the current chapter.

How to Use the Extension

In your editor containing the novel chapter:

  1. Right-click on the text.
  2. From the context menu, select "Evaluate Chapter".

Evaluate a chapter

Wait a moment for AI to return the evaluation, which will provide valuable insights into your writing:

Evaluation result

A Note on Local Models

Starting from version 0.7.x, local models are supported, though the effectiveness may vary with different configurations and model types.

L10N

This tools support below languages:

Chinese (Simplified - zh-cn), Chinese (Traditional - zh-tw), Japanese (ja), French (fr), German (de), Italian (it), Spanish (es), Portuguese (Brazilian - pt-br), Russian (ru), and Korean (ko) .

Limitations & Feedback

As a proof of concept, this extension may have limitations or bugs. Your feedback and contributions are invaluable for improving its performance. If you enjoy using it, please consider buying me a coffee ☕️ to support future developments.