docs(tasks): add descriptions (#46)

Author: Moskize91

tasks/translator/task.oo.yaml

@@ -4,6 +4,7 @@ executor:
     entry: __init__.py
 inputs_def:
   - handle: source_file
+    description: The original EPUB file to be translated
     json_schema:
       type: string
       ui:widget: file
@@ -14,6 +15,8 @@ inputs_def:
             extensions:
               - .epub
   - handle: translated_file
+    description: The saved path of the translated EPUB file. If not filled in,
+      specify an path.
     json_schema:
       type: string
       ui:widget: save
@@ -26,6 +29,7 @@ inputs_def:
     value:
     nullable: true
   - handle: language
+    description: Translation target language
     json_schema:
       enum:
         - zh-Hans
@@ -54,6 +58,9 @@ inputs_def:
           - Korean
     value: zh-Hans
   - handle: prompt
+    description: Provide LLM with necessary information for translating books. For
+      example, you can fill in the glossary and character name specifications.
+      Just tell LLM with natural language description.
     json_schema:
       type: string
       ui:widget: text
@@ -62,20 +69,29 @@ inputs_def:
   - group: LLM
     collapsed: true
   - handle: max_chunk_tokens
+    description: The entire book will be split into many chunks and submitted to LLM
+      in batches. this number is used to limit the number of tokens in each
+      chunk.
     json_schema:
       type: integer
     value: 2048
   - handle: threads
+    description: The number of threads opened at the same time to initiate requests
+      to LLM, the more threads, the faster the analysis speed.
     json_schema:
       type: integer
       minimum: 1
     value: 4
   - handle: retry_times
+    description: The number of retries after an LLM request fails is limited. If a
+      request exceeds this number, an error will be reported and the request
+      will be exited.
     json_schema:
       type: integer
       minimum: 1
     value: 5
   - handle: retry_interval_seconds
+    description: How long (in seconds) after a failed LLM request starts the next retry
     json_schema:
       type: number
       minimum: 0
@@ -92,6 +108,7 @@ inputs_def:
       max_tokens: 4096
 outputs_def:
   - handle: translated_file
+    description: Translated EPUB file path.
     json_schema:
       type: string
       ui:widget: save
@@ -101,3 +118,6 @@ outputs_def:
             extensions:
               - .epub
 title: Translate a book
+description: Use LLM to translate epub ebooks. The translated book will retain
+  the original text and list the translation side by side with the original
+  text.