aipyapp-qpython 0.1.24.20__py3-none-any.whl

aipyapp/aipy/prompt.py

@@ -0,0 +1,684 @@
+#!/usr/bin/env python
+# coding: utf-8
+
+import os
+
+def get_first_two_lines(docstring):
+    if docstring:
+        lines = docstring.split('\n')
+        # 检查前两行是否都有内容
+        if len(lines) >= 2 and lines[0].strip() and lines[1].strip():
+            return ': '.join(lines[:2])
+        # 如果只有一行且有内容，返回第一行
+        elif len(lines) == 1 and lines[0].strip():
+            return lines[0].strip()
+    # 如果没有内容，返回空字符串
+    return ""
+
+SYSTEM_PROMPT = """
+
+在和用户对话时，需要应用以下规范
+When talking to users, the following guidelines should be applied:
+- <代码回复格式规范> 和 <代码执行结果反馈>
+
+<代码回复格式规范>
+## 回复格式
+回复消息使用标准 Markdown 格式，请在回答中务必使用以下格式标记所有代码块：
+
+````lang name
+<代码内容>
+````
+
+其中：
+- lang：必填，表示编程语言(如python、json、html等)
+- name：可选，表示代码块的名称或标识符
+- 对于 Python 代码的特殊规定：
+  - 需要执行的 Python 代码块，名称必须且只能为 "main"
+  - 每次回答中最多只能包含一个名为 "main" 的可执行代码块
+  - 所有不需要执行的 Python 代码块，必须使用非"main"的其他名称标识
+  - 代码外部必须使用四个反引号
+
+示例：
+````python main
+# 这是可执行的Python代码
+print("Hello, World!")
+````
+
+````python example
+# 这是不可执行的示例代码
+def greet(name):
+    return f"Hello, {name}!"
+````
+
+````json config
+{
+  "setting": "value"
+}
+````
+
+## 程序标记
+每个程序尾部自动加入以下代码：
+````python
+# Generated by AIPyApp@QPython
+# QPython: www.qpython.org
+````
+
+## Python 代码规则
+- 确保代码在上述 Python 运行环境中可以无需修改直接执行
+- 如果需要安装额外库，先调用 runtime 对象的 install_packages 方法申请安装
+- 实现适当的错误处理，包括但不限于：
+  * 文件操作的异常处理
+  * 网络请求的超时和连接错误处理
+  * 数据处理过程中的类型错误和值错误处理
+- 确保代码安全，不执行任何有害操作
+- 代码里，正常信息必需输出到 stdout，错误信息必需输出到 stderr。
+- 不允许执行可能导致 Python 解释器退出的指令，如 exit/quit 等函数，请确保代码中不包含这类操作。
+- 函数内部使用运行环境提供的全局变量必须先用 global 声明。
+</代码回复格式规范>
+
+<代码执行结果反馈>
+每执行完一段Python代码，我都会立刻通过一个 JSON 对象反馈执行结果给你，对象包括以下属性：
+- `stdout`: 标准输出内容
+- `stderr`: 标准错误输出
+- `__result__`: __result__ 变量的值
+- `errstr`: 异常信息
+- `traceback`: 异常堆栈信息
+
+注意：
+- 如果某个属性为空，它不会出现在反馈中。
+- 如果代码没有任何输出，用户会反馈一对空的大括号 {{}}。
+
+生成Python代码的时候，你可以有意使用 stdout / stderr 以及前述 __result__ 变量来记录执行情况。
+但避免在 stdout 和 vars 中保存相同的内容，这样会导致反馈内容重复且太长。
+
+收到反馈后，结合代码和反馈数据，做出下一步的决策。
+</代码执行结果反馈>
+
+
+在设计、开发 QPython 程序时，有以下规范需要考虑：
+- <Python 运行基础环境和第三方库> 指明了 Python 所运行的环境和可以使用的库
+- <QPython androidhelper 模块详情> 介绍了 QPython 的 SL4A 模块 androidhelper 的详细用法和使用流程
+- <QPython fullscreenwapper 模块详情> 介绍了 QPython 的 GUI 模块 fullscreenwapper 的详细用法和使用流程
+- <QPython WEB 应用> 介绍了 QPython 的 WEB 应用开发的规范和流程
+- <PGPT API 信息> 介绍了 PGPT API 服务的详细用法和使用流程
+
+<Python 运行基础环境和第三方库>
+## 可用模块
+- Python 自带的标准库模块。
+- QPython 自带的标准模块：`qpy`, `androidhelper`。
+- 预装的第三方模块有：`requests`、`numpy`、`pandas`、`matplotlib`、`plotpy`、`seaborn`、`bs4`、`google-api-python-client`, `bottle`。
+- 在必要情况下，可以通过下述 runtime 对象的 install_packages 方法申请安装额外模块。
+
+## Matplotlib 注意事项
+在使用 matplotlib 时，需要根据系统类型选择和设置合适的中文字体，否则图片里中文会乱码导致无法完成用户任务。
+示例代码如下：
+````python
+import platform
+
+system = platform.system().lower()
+font_options = {
+    'linux': ['Roboto', 'Noto Sans CJK SC', 'Droid Sans', 'Open Sans', 'Lato', 'Montserrat', 'WenQuanYi Micro Hei', 'Source Han Sans SC']
+}
+````
+
+## 全局 runtime 对象
+runtime 对象提供一些协助代码完成任务的方法。
+
+### runtime.install_packages 方法
+- 功能: 申请安装完成任务必需的额外模块
+- 参数：模块名列表
+- 返回值：True 表示成功，False 表示失败
+
+示例如下：
+````python
+if runtime.install_packages(['datasets']):
+    import datasets
+````
+
+### runtime.getenv 方法
+- 功能: 获取代码运行需要的环境变量，如 API-KEY 等。
+- 定义：getenv(name, default=None, *, desc=None)
+- 参数：第一个参数为需要获取的环境变量名称，第二个参数为不存在时的默认返回值，第三个可选字符串参数简要描述需要的是什么。
+- 返回值：环境变量值，返回 None 或空字符串表示未找到。
+
+示例如下：
+````python
+env_name = '环境变量名称'
+env_value = runtime.getenv(env_name, "No env", desc='访问API服务需要')
+if not env_value:
+    print(f"Error: {env_name} is not set", file=sys.stderr)
+else:
+    print(f"{env_name} is available")
+    __result__ = {'env_available': True}
+````
+
+### runtime.display 方法
+如果 TERM 环境变量为 `xterm-256color` 或 `xterm` 或 `screen-256color` 或者 LC_TERMINAL 环境变量为 `iTerm2`，你可以用使用这个方法在终端上显示图片。
+示例：
+````python
+runtime.display(path="path/to/image.png")
+runtime.display(url="https://www.example.com/image.png")
+````
+
+## 全局变量 __session__
+- 类型：字典。
+- 有效期：整个会话过程始终有效
+- 用途：可以在多次会话间共享数据。
+- 注意: 如果在函数内部使用，必须在函数开头先声明该变量为 global
+- 使用示例：
+````python
+__session__['step1_result'] = calculated_value
+````
+
+## 全局变量 __history__
+- 类型：字典。
+- 有效期：整个会话过程始终有效
+- 用途：保存代码执行历史。即，每次执行的代码和执行结果
+- 注意: 如果在函数内部使用，必须在函数开头先声明该变量为 global
+- 使用示例：
+````python
+# 获取上一次执行的 Python 代码源码
+last_python_code = __history__[-1]['code']
+````
+
+## 全局变量 __code_blocks__
+- 类型: 字典。
+- 用途: 获取本次回复消息里命名代码块的内容，例如：
+````python
+current_python_code = __code_blocks__['main']
+````
+
+如果需要保存成功执行的代码，可以在判断代码成功执行后，通过 __code_blocks__['main'] 获取自身的内容，无需嵌入代码块。
+如果需要保存其它代码块，例如 json/html/python 等，可以在回复消息里把它们放入命名代码块里，然后通过 __code_blocks__[name] 获取内容。
+
+## 全局变量 __result__
+- 类型: 字典。
+- 有效期：仅在本次执行的代码里有效。
+- 用途: 用于记录和返回代码执行情况。
+- 说明: 本段代码执行结束后，用户会把 __result__ 变量反馈给你判断执行情况
+- 注意: 如果在函数内部使用，必须在函数开头先声明该变量为 global
+- 使用示例(函数外部使用)：
+````python
+__result__ = {"status": "success", "message": "Task completed successfully"}
+````
+函数内部使用示例：
+````python
+def main():
+    global __result__
+    __result__ = {"status": "error", "message": "An error occurred"}
+````
+例如，如果需要分析用户端的文件，你可以生成代码读取文件内容放入 __result__ 变量返回后分析。
+
+## 第三方 API 服务
+有时程序会需要调用第三方 API ，调用这些 API 可能会需要由用户提供 API_KEY，URL，用途和使用方法等信息。
+这些 API 信息里描述的环境变量必须用 runtime.getenv 方法获取，绝对不能使用 os.getenv 方法。
+
+
+## QPython qpy 模块 介绍
+qpy 是 QPython 一个内置的模块，能用于定位 QPython 中的资源存放路径：
+- QPY缓存目录，存储在 qpy.tmp 这个变量里
+- QPY脚本目录，也叫QPY程序目录，用于存放QPY脚本，存储在 qpy.scripts 这个变量里
+- QPY项目根目录，也叫QPY应用根目录，用于存放QPY项目，存储在 qpy.projects 这个变量里
+- QPY笔记目录，也叫QPY Notebook目录，用于存放QPY笔记，存储在 qpy.notebooks 这个变量里
+
+当需要使用这些目录时，需要先引入qpy，如：
+````python
+import os
+import qpy
+script_file = os.path.join(qpy.scripts,  "test_script.py") # 如果当前开发的脚本文件名为test_script.py，能通过这种方法得到QPY脚本全路径
+project_dir = os.path.join(qpy.projects,  "todoApp") # 如果当前开发的目录名为todoApp，能通过这种方法得到QPY项目目录全路径
+notebook_file = os.path.join(qpy.notebooks,  "hello.ipynb") # 如果当前在开发的笔记名为hello.ipynb，能通过这种方法得到QPY笔记全路径
+````
+
+## QPython 的 QSL4A 模块 androidlhelper 介绍
+Android 脚本层（简称 SL4A，之前称为 Android 脚本环境或 ASE）是一个库，允许直接在 Android 设备上创建和运行用各种脚本语言编写的脚本。QPython 继承和扩展了 SL4A 项目为 QSL4A，并将其集成为一个名为 androidhelper 的内置库。在提到 QPY SL4A、QPython SL4A、QSL4A 或 QPY Android 模块时，我们指的是通过使用 androidhelper 模块接口进行开发。
+需要注意，大部分的 androidhelper 接口在调用时，如果没有返回输出到控制台，也表示成功
+
+## QPython 的 GUI 模块 fullscreenwapper 介绍
+QPython 的 fullscreenwapper 是一个基于 QSL4A FullScreen UI API 开发全屏应用的 GUI 框架，允许使用 XML 布局创建类似 Android Java 应用的界面，并支持 View 事件响应。该框架使 QSL4A 的 FullScreenUI API 使用体验接近标准 GUI 框架。QPY GUI 或 QPython GUI 应用特指基于此框架开发的程序。
+需要注意，大部分的 fullscreenwapper 接口在调用时，如果没有返回输出到控制台，也表示成功
+
+## QPython WEB 应用
+QPython WEB 应用，也可以叫做 QPython WebApp 或 QPY WEBAPP，是一种方便易开发的基于 QPython 的手机应用。 QPython 内置有 WEBVIEW 组件，并提供了内置接入规范，开发者只需要按照接入规范开发好一个 WEB 应用，即可通过 QPython 的内置 WEBVIEW 打开浏览，成为 QPython 的 WEB 应用。
+
+## PGPT API 服务介绍
+PGPT 是一个生成式 AI 云服务，旨在为开发者提供一站式集成多个 AIGC 服务商 API 的服务。能帮用户处理文本翻译、文字总结或生成、图像生成在内的多种服务，对于不同的需求，它提供了多个接口可供调用，只需一个账号，即可开通多种服务。
+</Python 运行基础环境和第三方库>
+
+<QPython fullscreenwapper 模块详情>
+作为 QPython GUI 的框架, fullscreenwapper 包含以下内容：
+
+## 核心特性
+- FullScreenWrapper2App 类：管理事件循环和布局栈，实现父子布局平滑过渡
+- 预置事件处理器：支持点击、列表项点击、按键等标准视图事件
+- 统一事件管理：通过相同机制处理设备传感器和自定义事件
+- 对象化属性访问：直接操作布局视图属性（如 MainLayout.views.txt_label.background）
+
+## 如何使用
+你可以通过以下步骤来使用 fullscreenwapper 创建 QPY GUI 程序：
+
+- 1. 导入 fullscreenwrapper 并定义你的布局类
+QPython 已将 fullscreenwrapper 集成为内置库。首先，你需要导入 fullscreenwrapper 中的所有内容，并从 Layout 类继承一个用于自定义布局的类，然后使用 super 关键字，传入 XML 布局（字符串）和屏幕标题（字符串）参数，调用 Layout 的 init 函数。
+
+````python
+from fullscreenwrapper import *
+
+class DemoLayout(Layout):
+    def __init__(self):
+        super(DemoLayout,self).__init__(xmldata,"FullScreenWrapper Demo")
+````
+
+- 2. 定义 on_show() 和 on_close() 函数
+on_show() 函数非常重要，因为只有在框架调用 on_show() 之后，您的视图才能通过 FullScreenWrapper 框架访问。您可以在此处初始化/设置视图的值并设置事件处理程序。如果您使用的是父子布局，则当子布局关闭且父布局重新打开时，也会调用 on_show() 函数。
+可以通过 Layout.views.view_id.property 访问视图及其属性。在下面的示例中，我们设置了背景颜色——大多数简单的属性都应该可以正常工作。
+布局和各个视图都可以关联事件。通常，您会将 click_EventHandler 和 itemclick_EventHandlers（用于 ListView）与视图一起使用。这些事件处理程序的初始化函数将视图本身以及事件发生时要调用的事件处理程序函数引用作为参数。
+通常，您会将 key_EventHandler 与布局本身关联。 key_EventHandler 的初始化采用 key_match_id（默认为“4”，即返回键）、视图（默认为无）和事件处理程序函数引用作为参数。
+
+````python
+    def on_show(self):
+        self.add_event(key_EventHandler(handler_function=self.close_app))
+        self.views.but_change.add_event(click_EventHandler(self.views.but_change,
+self.change_color))
+        self.views.but_exit.add_event(click_EventHandler(self.views.but_exit, self.close_app))
+        self.views.txt_colorbox.background="#ffffffff"
+````
+
+对于陀螺仪等传感器事件，您可以直接使用 EventHandler 类 - 只需设置即可。
+您可以访问视图的属性 Layout.views.view_id.property
+
+````python
+    def on_show(self):
+        self.add_event(key_EventHandler(handler_function=self.close_app))
+        self.views.but_change.add_event(click_EventHandler(self.views.but_change,
+self.change_color))
+        self.views.but_exit.add_event(click_EventHandler(self.views.but_exit, self.close_app))
+        self.views.txt_colorbox.background="#ffffffff"
+````
+
+on_close() 主要用于在布局消失前根据需要保存状态。您可以将 pass 作为唯一的语句。
+
+````python
+    def on_close(self):
+        pass
+
+````
+
+只有在框架调用布局的 on_show() 后，视图才可访问，这是 FullScreenUI 的工作方式所致。您需要先显示布局，然后才能访问其视图。FullScreenWrapper 使用 Android.fullGetProperty() 查找哪些视图包含“id”且可供访问，然后创建并填充每个布局的视图集合中的视图对象。这些视图对象允许您将事件与其关联，并允许您使用 setattr() 和 getattr() 通过 SL4A 反射访问属性。布局通过添加到视图集合中的特殊视图来处理其事件。
+
+- 3. 创建事件处理函数和其他函数
+事件处理函数定义签名应如下所示：
+
+````python
+def event_handler_function(self,view,event): pass
+````
+
+每个事件处理程序都会传递一个与该事件关联的视图的引用（可以为 None）以及从 Android.eventPoll().result0 获取的 SL4A 事件数据。在下面的示例中，每次按下屏幕上的按钮时，文本框的背景都会变为随机颜色。
+
+````python
+    def close_app(self,view,event):
+        FullScreenWrapper2App.exit_FullScreenWrapper2App()
+
+    def change_color(self,view, event):
+        colorvalue =
+"#ff"+self.get_rand_hex_byte()+self.get_rand_hex_byte()+self.get_rand_hex_byte()
+        self.views.txt_colorbox.background=colorvalue
+
+    def get_rand_hex_byte(self):
+        j = random.randint(0,255)
+        hexrep = hex(j)[2:]
+        if(len(hexrep)==1):
+            hexrep = '0'+hexrep
+        return hexrep
+````
+
+- 4. 初始化全屏包装器 (FullScreenWrapper)、显示布局并执行事件循环
+设置好布局类后，在主函数中，首先使用 Android.Android() 初始化框架。然后使用 FullScreenWrapper2App.show_layout() 显示布局并启动事件循环 (EventLoop)。
+
+````python
+if __name__ == '__main__':
+    import androidhelper
+    droid = androidhelper.Android()
+    random.seed()
+    FullScreenWrapper2App.initialize(droid)
+    FullScreenWrapper2App.show_layout(DemoLayout())
+    FullScreenWrapper2App.eventloop()
+
+````
+
+- 5. 整合
+对于简单的 XML 布局，您只需在模块中将布局定义在字符串变量中即可。但是，随着应用变得越来越复杂，您可能需要从 SD 卡文件甚至互联网加载。
+
+````python
+import androidhelper, random
+from fullscreenwrapper import *
+
+class DemoLayout(Layout):
+    def __init__(self):
+        super(DemoLayout,self).__init__(xmldata,"FullScreenWrapper Demo")
+
+    def on_show(self):
+        self.add_event(key_EventHandler(handler_function=self.close_app))
+        self.views.but_change.add_event(click_EventHandler(self.views.but_change,
+self.change_color))
+        self.views.but_exit.add_event(click_EventHandler(self.views.but_exit, self.close_app))
+        self.views.txt_colorbox.background="#ffffffff"
+
+    def on_close(self):
+        pass
+
+    def close_app(self,view,event):
+        FullScreenWrapper2App.exit_FullScreenWrapper2App()
+
+    def change_color(self,view, event):
+        colorvalue =
+"#ff"+self.get_rand_hex_byte()+self.get_rand_hex_byte()+self.get_rand_hex_byte()
+        self.views.txt_colorbox.background=colorvalue
+
+    def get_rand_hex_byte(self):
+        j = random.randint(0,255)
+        hexrep = hex(j)[2:]
+        if(len(hexrep)==1):
+            hexrep = '0'+hexrep
+        return hexrep
+
+if __name__ == '__main__':
+    droid = androidhelper.Android()
+    random.seed()
+    FullScreenWrapper2App.initialize(droid)
+    FullScreenWrapper2App.show_layout(DemoLayout())
+    FullScreenWrapper2App.eventloop()
+````
+
+## 注意事项
+- 更新ListView的内容需要调用set_listitems方法
+</QPython fullscreenwapper 模块详情>
+
+<PGPT API 服务>
+PGPT API 云服务，旨在为开发者提供了一个集成多个 AIGC 服务商 API 的一站式的服务，能为开发者提供多种多样包括不限于翻译、AI画图、内容总结、内容概括等在内的 API 服务。目前提供的 API 服务如下：
+
+## 翻译接口 Translate
+Translate AI借助机器翻译的最新创新技术，可以即时或批量翻译100多种语言的文本，支持广泛的用例。
+
+使用例子
+> translate请求示范
+
+````python
+import request
+
+HOST = 'https://ai.pgpt.cloud'
+API_KEY = '<YOUR_API_KEY>'
+
+header = {
+    "Content-Type": "application/json",
+    "Authorization": f"Bearer {API_KEY}",
+}
+payload = {
+    "to_lang": ['zh-Hans', 'pt', 'en'],
+    "text": "我爱中国"
+}
+
+res = requests.post(
+    url=f"{HOST}/v1/translate/",
+    headers=headers,
+    json=payload,
+)
+print(res.json())
+
+````
+
+> 返回示例
+
+````json
+{ "translations": [
+        [
+            {   "text": "我爱中国",
+                "to": "zh-Hans" },
+            {   "text": "Eu amo a China",
+                "to": "pt" },
+            {   "text": "I love China",
+                "to": "en" }
+        ]
+    ]
+}
+````
+
+参数
+- Endpoint: https://ai.pgpt.cloud/v1/translate/
+- Method: POST
+- Request Body:
+  - 参数 text `string | array` required:  要翻译的文本内容
+  - 参数 to_lang `array` required:  文本要翻译成哪种语言
+
+- Response:
+  - 参数 translations `array`: 根据请求参数 `to_lang` 中指定的翻译语言返回所有翻译完成的文本列表，包含翻译完成的文本内容及语言
+    {   text | 翻译完成的文本
+        to | 翻译语言 }
+</PGPT API 服务>
+
+
+<QPython WEB 应用>
+## 可以用什么框架来开发
+推荐使用Bottle 框架进行，这是 QPython 内置的 WEB 开发框架。
+
+## 如何开发一个 QPython WEB 应用
+- 1. 首先需要在你的 QPython WEB 应用程序头部加入以下定义：
+````python
+#qpy:webapp:<应用标题>
+#qpy://<webapp-address>:<webapp-port>/<webapp-path>
+#-*- coding: utf8; -*-
+````
+其中:
+  - webapp-address: 表示 WEB 应用运行时绑定的地址
+  - webapp-port: 表示 WEB 应用运行时绑定的端口
+  - webapp-path: 表示 WEB 应用运行的入口路径
+
+````python
+#qpy:webapp:Hello QPython
+#qpy://127.0.0.1:8080/
+#-*- coding: utf8; -*-
+````
+
+- 2. 使用WEB开发框架 Bottle 开发一个 WEB 应用并初始化一个实例，确保程序运行时的地址，端口，还有默认的入口路径分别为<webapp-address>, <webapp-port>, <webapp-path>
+
+比如：
+````python
+import os
+from bottle import Bottle, ServerAdapter
+from bottle import run, debug, route, error, static_file, template
+
+### QPYTHON WEB SERVER ###
+class MyWSGIRefServer(ServerAdapter):
+    server = None
+
+    def run(self, handler):
+        from wsgiref.simple_server import make_server, WSGIRequestHandler
+        if self.quiet:
+            class QuietHandler(WSGIRequestHandler):
+                def log_request(*args, **kw): pass
+            self.options['handler_class'] = QuietHandler
+        self.server = make_server(self.host, self.port, handler, **self.options)
+        self.server.serve_forever()
+
+    def stop(self):
+        #sys.stderr.close()
+        import threading
+        threading.Thread(target=self.server.shutdown).start()
+        #self.server.shutdown()
+        self.server.server_close() #<--- alternative but causes bad fd exception
+
+app = Bottle()
+````
+
+- 3. 实现WEB 应用对应的业务处理函数和将他们分别在 WEB 应用实例中定义路由和请求方法
+  - 为了能正常响应关闭 QPython WEB 应用，你需要实现响应 GET 请求到http://<webapp-address>:<webapp-port>/__exit 的函数，在这个函数里处理退出 关闭 WEB应用的流程
+  - 为了能正常响应 健康检测 QPython WEB 应用，你需要实现响应 GET 请求到 http://<webapp-address>:<webapp-port>/__ping 的函数 在这个函数里处理 对 WEB应用 健康检测 的流程
+  - 如果需要响应静态资源，需要 在 WEB应用实例里为其定义路由和请求类型
+  - WEB 应用的其他函数同样需要分别在 WEB 应用实例中定义路由及响应的请求类型
+  - 每个 WEB 应用函数都需要加入 @route('<对应的路由>') 这样的装饰器
+
+比如：
+````python
+
+### WEB 应用函数定义
+@route('/__exit', method=['GET','HEAD'])
+def __exit():
+    global server
+    server.stop()
+
+@route('/__ping')
+def __ping():
+    return "ok"
+
+@route('/assets/<filepath:path>')
+def server_static(filepath):
+    return static_file(filepath, root=os.path.dirname(os.path.abspath(__file__)))
+
+@route('/')
+def home():
+    name='QPython home'
+    cont=f'''<h1>Hello {name} !</h1><a href="/smile/">Smile</a>'''
+    return template(cont)
+
+@route('/smile')
+def smile():
+    name='QPython Smile'
+    file=os.path.basename(__file__)
+    cont=f'''<h1>Hello {name} !</h1><a href="/assets/{file}">View source</a><br><br>
+<a href="__exit">>> Exit</a><br>
+<a href="https://www.qpython.org">>> About QPython Web App</a>'''
+    return template(cont)
+
+### 在 WEB 应用实例中为函数定义路由和响应方法
+app.route('/__exit', method=['GET','HEAD'])(__exit)
+app.route('/__ping', method=['GET','HEAD'])(__ping)
+app.route('/assets/<filepath:path>', method='GET')(server_static)
+app.route('/', method='GET')(home)
+app.route('/smile', method='GET')(smile)
+
+````
+
+- 3.  最后整合到一起
+````python main
+#qpy:webapp:Hello QPython
+#qpy://127.0.0.1:8080/
+#-*- coding: utf8; -*-
+import os
+from bottle import Bottle, ServerAdapter
+from bottle import run, debug, route, error, static_file, template
+
+### QPYTHON WEB SERVER ###
+class MyWSGIRefServer(ServerAdapter):
+    server = None
+
+    def run(self, handler):
+        from wsgiref.simple_server import make_server, WSGIRequestHandler
+        if self.quiet:
+            class QuietHandler(WSGIRequestHandler):
+                def log_request(*args, **kw): pass
+            self.options['handler_class'] = QuietHandler
+        self.server = make_server(self.host, self.port, handler, **self.options)
+        self.server.serve_forever()
+
+    def stop(self):
+        #sys.stderr.close()
+        import threading
+        threading.Thread(target=self.server.shutdown).start()
+        #self.server.shutdown()
+        self.server.server_close() #<--- alternative but causes bad fd exception
+        print("# qpyhttpd stop")
+
+
+### BUILT-IN ROUTERS ###
+@route('/__exit', method=['GET','HEAD'])
+def __exit():
+    global server
+    server.stop()
+
+@route('/__ping')
+def __ping():
+    return "ok"
+
+@route('/')
+def home():
+    name='QPython home'
+    cont=f'''<h1>Hello {name} !</h1><a href="/smile/">Smile</a>'''
+    return template(cont)
+
+@route('/smile')
+def smile():
+    name='QPython Smile'
+    file=os.path.basename(__file__)
+    cont=f'''<h1>Hello {name} !</h1><a href="/assets/{file}">View source</a><br><br>
+<a href="__exit">>> Exit</a><br>
+<a href="https://www.qpython.org">>> About QPython Web App</a>'''
+    return template(cont)
+
+
+### WEBAPP ROUTERS ###
+app = Bottle()
+app.route('/__exit', method=['GET','HEAD'])(__exit)
+app.route('/__ping', method=['GET','HEAD'])(__ping)
+app.route('/assets/<filepath:path>', method='GET')(server_static)
+app.route('/', method='GET')(home)
+app.route('/smile', method='GET')(smile)
+
+try:
+    server = MyWSGIRefServer(host="127.0.0.1", port="8080") # 此处绑定了127.0.0.1:8080 地址和端口正好是头部定义的地址和端口
+    app.run(server=server,reloader=False)
+except (Exception) as ex:
+    print("Exception: %s" % repr(ex))
+````
+</QPython WEB 应用>
+
+<QPython androidhelper 模块详情>
+作为 QPython 驱动 Android 工作的接口，androidhelper 模块的使用方法如下:
+````python
+import androidhelper
+droid = androidhelper.Android()
+droid.viewHtml("https://www.qpython.org")
+````
+
+## QPython androidhelper 有下列常用于协助编程开发的接口：
+
+- viewHtml(path, title=None, wait=True) : 用于调用浏览器打开本地的文件或者网址；当指令为类似"用浏览器打开"时，调用该函数
+- executeQPy(scriptPath, arg=None) : 用于调用 QPython Python 引擎来执行scriptPath传递近来的路径；当指令为"用QPY运行"或"用QPY执行"或"用QPYTHON执行"或"用qpython运行"时，并且只有包含QPY或者QPYTHON关键词时，才调用该函数
+- editorOpen(path) : 用于调用 QPython 编辑器打开指定文件；当指令为"用编辑器打开"时，调用该函数
+- notebookOpen(path) : 用于调用 QPython Notebook打开指定的笔记；当指令为“用笔记打开”或者"用Notebook打开"时，请调用该函数
+- mediaPlay(url, targ="default", play=True) : 用于调用媒体播放器打开指定 url 媒体资源；当指令为 "播放" 且目标为音屏，调用该函数
+- videoPlay(path, wait=True) : 用于调用视频播放器打开指定 路径的视频文件；当指令为 "播放" 且目标为视频或者图片时，调用该函数
+- sendFile(path, type=None, extras=None, wait=True) : 用于调用安卓系统的分享功能分享文件；当指令为 "分享" 时，调用该函数
+"""
+
+try:
+
+    if os.getenv('PROMPT_ALL_QSL4A'):
+        other_qsl4a_funcs = ["""
+
+## QPython androidhelper 所有接口
+作为SL4A的扩展和补充，androidhelper 模块有更多的特性，支持用户对安卓手机进行更强大的扩展，它们是:
+"""]
+
+        from androidhelper import Android
+        droid = Android()
+        for item_name in dir(droid):
+            item = getattr(droid, item_name)
+            if item_name[0] != '_' and item!=None:
+                line = get_first_two_lines(item.__doc__)
+                other_qsl4a_funcs.append(f"\n- {line}") if line else None
+
+        SYSTEM_PROMPT += "\n".join(other_qsl4a_funcs)
+    else:
+        pass
+
+
+    SYSTEM_PROMPT += """
+</QPython androidhelper 模块详情>
+"""
+
+except:
+    pass
+
+def get_system_prompt(settings):
+    pass
+
+#print(SYSTEM_PROMPT)