提高prompt水平

app.py

@@ -105,27 +105,26 @@ def generate_cleword(content):
     user_message = f"""
               你是一名优秀的课程文稿录入员。我将给你markdown格式的课程文稿，请你帮助我把这种文稿转化为一种叫做cleword的领域特定语言。下面是一些转化的基本规则：
               cleword是一种基于yaml的，缩进敏感的领域特定语言。它被专门用来创作课程。
-              以下是某门课内容的cleword语法示例，这门课的内容演示了一个名叫思远的老师，教给名叫大乾的学生关于Python的变量的知识的场景。请注意其中的语法规则和缩进：
+              以下是某节课部分内容的cleword语法示例，这门课的内容演示了一个名叫思远的老师，教给名叫大乾的学生关于Python的变量的知识的场景。请注意其中出现的对于不同元素的语法规则和缩进：
 
               ```cleword
-
                 - 发言:
                     谁: 思远
                     说:
-                      - ok，那现在请你在自己的电脑中打开python，我们开始接下来的学习✊✊
+                      - ok，那现在请你在自己的电脑中打开python，我们开始接下来的学习✊✊ #cleword语法注释：在一个”发言“下面，每一个短杠 “ - ” 就代表一条对话消息
                       - 前面，我们学习了Python的print()函数和3种基本数据类型。这能够让Python把一些东西“说”给我们听。
 
-                - 图片:
+                - 图片: #cleword语法注释：请注意图片的语法。
                     地址: https://siyuan-harry.oss-cn-beijing.aliyuncs.com/oss://siyuan-harry/20231026105853.png
 
                 - 发言:
                     谁: 思远
                     说:
                       - 但是目前，我们所有的程序都只是运行一步，把一个值打印出来。
-                      - |
-                        这对于更复杂的程序而言，肯定是不够用的。
+                      - |  #cleword语法注释：在“ - | ”的下面，可以在同一个对话消息内写符合markdown语法的内容
+                        这对于更复杂的程序而言，肯定是不够用的。 
                         - 数据如何在程序中被传递？
-                        - 如何实现多个步骤的程序？
+                        - 如何实现多个步骤的程序？ 
                       - 这些都是问题。
                 - 发言:
                     谁: 大乾
@@ -145,7 +144,7 @@ def generate_cleword(content):
                     说:
                       - 这里，我们需要 变量 来帮助这个程序做得更好。
 
-                - 大纲:
+                - 大纲: #cleword语法注释：markdown文稿中的一二三级标题，都应当转换为cleword里的对应等级大纲
                     标题: 1 什么是变量
                     等级: 1
 
@@ -156,19 +155,19 @@ def generate_cleword(content):
                         虽然变量是个非常重要的东西，但其实它一点都不难，很容易理解。
                         > 只要你用心去做！
                       - 多说无益，先来尝试运行一下下面这个代码：
-                      - |
+                      - | #cleword语法注释：在“ - | ”的下面，可以在同一个消息内写符合markdown语法的内容。比如这条消息中的“Python代码块”
                         ```python
                         weather = '今天的天气是多云转晴'
                         print(weather)
                         ```
 
-                - 旁白: 请自己在本地的编辑器里手打出来，不要复制粘贴哦
+                - 旁白: 请自己在本地的编辑器里手打出来，不要复制粘贴哦 #cleword语法注释：“旁白”的语法就是这样的
               ```
 
               接下来，我将给你一个markdown版本的原始课程文稿。请你把它转化为cleword格式输出。
               原始文稿：「{content}」
 
-              请你注意这里的markdown语法格式，并将原始文稿逐句地转化为符合cleword语法的格式。
+              请你注意原始文稿里的markdown语法格式（如人物标记、图片、旁白标记、代码块等），并将原始文稿逐句地转化为符合cleword语法的格式。
 
             """
     messages =  [