pymud 0.20.0a3__py3-none-any.whl → 0.20.0a4__py3-none-any.whl

pymud/main.py

@@ -89,6 +89,10 @@ def init_pymud_env(args):
     startApp(args)
 
 def startApp(args):
+    startup_path = Path(args.startup_dir).resolve()
+    sys.path.append(f"{startup_path}")
+    os.chdir(startup_path)
+
     if args.debug:
         logging.basicConfig(level = logging.NOTSET,
             format = '%(asctime)s %(name)-12s %(levelname)-8s %(message)s',
@@ -105,9 +109,6 @@ def startApp(args):
             handlers = [logging.NullHandler()],
             )
 
-    startup_path = Path(args.startup_dir).resolve()
-    sys.path.append(f"{startup_path}")
-    os.chdir(startup_path)
     cfg = startup_path.joinpath("pymud.cfg")
     cfg_data = None
     if os.path.exists(cfg):

pymud/objects.py

@@ -147,7 +147,7 @@ class CodeLine:
         return new_code_str, new_code
 
     async def async_execute(self, session, *args, **kwargs):           
-        await session.exec_code_async(self, *args, **kwargs)
+        return await session.exec_code_async(self, *args, **kwargs)
 
 class CodeBlock:
     """
@@ -277,14 +277,16 @@ class CodeBlock:
         """
         以异步方式执行该 CodeBlock。参数与 execute 相同。
         """
+        result = None
         for code in self.codes:
             if isinstance(code, CodeLine):
-                await code.async_execute(session, *args, **kwargs)
+                result = await code.async_execute(session, *args, **kwargs)
 
             if Settings.client["interval"] > 0:
                 await asyncio.sleep(Settings.client["interval"] / 1000.0)
 
         session.clean_finished_tasks()
+        return result
 
 class BaseObject:
     """
@@ -716,6 +718,20 @@ class Command(MatchObject):
         super().__init__(session, patterns, sync = False, *args, **kwargs)
         self._tasks = set()
 
+    def __unload__(self):
+        """
+        当从会话中移除任务时，会自动调用该函数。
+        可以将命令管理的各子类对象在此处清除。
+        该函数需要在子类中覆盖重写。
+        """
+        pass
+
+    def unload(self):
+        """
+        与__unload__方法相同，子类仅需覆盖一种方法就可以
+        """
+        pass
+
     def create_task(self, coro, *args, name = None):
         """
         创建并管理任务。由 Command 创建的任务，同时也被 Session 所管理。

pymud/pkuxkx.py

@@ -17,9 +17,9 @@ class Configuration:
 
     # hpbrief long情况下的含义
     HP_KEYS = (
-        "exp", "pot", "maxneili", "neili", "maxjingli", "jingli", 
-        "maxqi", "effqi", "qi", "maxjing", "effjing", "jing", 
-        "zhenqi", "zhenyuan", "food", "water", "fighting", "busy"
+        "combat_exp", "potential", "max_neili", "neili", "max_jingli", "jingli", 
+        "max_qi", "eff_qi", "qi", "max_jing", "eff_jing", "jing", 
+        "vigour/qi", "vigour/yuan", "food", "water", "fighting", "busy"
         )
 
     # 类的构造函数，传递参数session，是会话本身
@@ -54,7 +54,7 @@ class Configuration:
         
         # 1. fullme的链接对应的触发器，匹配URL
         # 当匹配成功后，调用ontri_webpage
-        self._triggers["tri_webpage"] = self.tri_webpage = Trigger(self.session, id = 'tri_webpage', patterns = r'^http://fullme.pkuxkx.net/robot.php.+$', group = "sys", onSuccess = self.ontri_webpage)
+        self._triggers["tri_webpage"] = self.tri_webpage = Trigger(self.session, id = 'tri_webpage', patterns = r'^http://fullme.pkuxkx.net/robot.php.+$', group = "sys", onSuccess =  lambda id, line, wildcards: webbrowser.open(line))
         # 2. fullme的链接对应的触发器，因为要进行多行匹配（3行），因此匹配模式pattern为3个正则表达式模式构成的元组（所有列表类型均可识别），无需像MushClient一样要指定multiline标识和linesToMatch数量
         # 当匹配成功后，调用ontri_hpbrief
         # 特别说明：此处的hpbrief触发匹配，需要set hpbrief long后才可以支持
@@ -130,9 +130,6 @@ class Configuration:
     def onTimer(self, name, *args, **kwargs):
         self.session.info("每2秒都会打印本信息", "定时器测试")
 
-    def ontri_webpage(self, name, line, wildcards):
-        webbrowser.open(line)
-
     def ontri_hpbrief(self, name, line, wildcards):
         self.session.setVariables(self.HP_KEYS, wildcards)
 

pymud/session.py

@@ -1,4 +1,4 @@
-import asyncio, logging, re, math, os, pickle, datetime, importlib, importlib.util, sysconfig
+import asyncio, logging, re, math, os, pickle, datetime, importlib, importlib.util, sysconfig, time
 from collections.abc import Iterable
 from collections import OrderedDict
 import logging, queue
@@ -141,6 +141,8 @@ class Session:
         self._status_maker = None                           # 创建状态窗口的函数（属性）
         self.display_line  = ""
 
+        self._activetime = time.time()
+
         self.initialize()
 
         self._loggers = dict()
@@ -296,6 +298,15 @@ class Session:
 
         return dura
 
+    @property
+    def idletime(self) -> float:
+        "只读属性，返回当前会话空闲时间（即最后一次向服务器写入数据到现在的时间），以秒为单位。当服务器未连接时，返回-1"
+        idle = -1
+        if self._protocol and self._protocol.connected:
+            idle = time.time() - self._activetime
+
+        return idle
+
     @property
     def status_maker(self):
         """
@@ -772,6 +783,8 @@ class Session:
 
             cmd = line + self.newline
             self.write(cmd.encode(self.encoding, Settings.server["encoding_errors"]))
+
+        self._activetime = time.time()
     
     async def waitfor(self, line: str, awaitable, wait_time = 0.05) -> None:
         """
@@ -831,12 +844,10 @@ class Session:
         name = name or self.name
         if name in self.application.sessions.keys():
             session = self.application.sessions[name]
-            await session.exec_command_async(cmd, *args, **kwargs)
+            return await session.exec_command_async(cmd, *args, **kwargs)
         else:
             self.error(f"不存在名称为{name}的会话")
 
-    
-
     def exec_code(self, cl: CodeLine, *args, **kwargs):
         """
         执行解析为CodeLine形式的MUD命令（必定为单个命令）。一般情况下，脚本中不应调用该方法，而应使用exec/exec_command。
@@ -910,6 +921,7 @@ class Session:
         :param args: 保留兼容与扩展性所需
         :param kwargs: 保留兼容与扩展性所需
         """
+
         if cl.length == 0:
             self.writeline("")
 
@@ -937,9 +949,9 @@ class Session:
                 else:
                     try:
                         cb = CodeBlock(sess_cmd)
-                        await cb.async_execute(session, *args, **kwargs)
+                        return await cb.async_execute(session, *args, **kwargs)
                     except Exception as e:
-                        await session.exec_command_async(sess_cmd)
+                        return await session.exec_command_async(sess_cmd)
             
             else:
                 if cmd in self._commands_alias.keys():
@@ -956,7 +968,7 @@ class Session:
 
         else:
             cmdtext, code = cl.expand(self, *args, **kwargs)
-            await self.exec_text_async(cmdtext)
+            return await self.exec_text_async(cmdtext)
             
     def exec_text(self, cmdtext: str):
         """
@@ -996,14 +1008,14 @@ class Session:
 
         异步调用时，该函数要等待对应的代码执行完毕后才会返回。可以用于确保命令执行完毕。
         """
-
+        result = None
         isNotCmd = True
         for command in self._commands.values():
             if isinstance(command, Command) and command.enabled:
                 state = command.match(cmdtext)
                 if state.result == Command.SUCCESS:
                     # 命令的任务名称采用命令id，以便于后续查错
-                    await self.create_task(command.execute(cmdtext), name = "task-{0}".format(command.id))
+                    result = await self.create_task(command.execute(cmdtext), name = "task-{0}".format(command.id))
                     isNotCmd = False
                     break
 
@@ -1021,6 +1033,8 @@ class Session:
             if notAlias:
                 self.writeline(cmdtext)
 
+        return result
+
     def exec_command(self, line: str, *args, **kwargs) -> None:
         """
         在当前会话中执行MUD命令。多个命令可以用分隔符隔开。
@@ -1071,15 +1085,18 @@ class Session:
         """
 
         ## 以下为函数执行本体
+        result = None
         if (not "#" in line) and (not "@" in line) and (not "%" in line):
             cmds = line.split(self.seperator)
             for cmd in cmds:
-                await self.exec_text_async(cmd)
+                result = await self.exec_text_async(cmd)
                 if Settings.client["interval"] > 0:
                     await asyncio.sleep(Settings.client["interval"] / 1000.0)
         else:
             cb = CodeBlock(line)
-            await cb.async_execute(self)
+            result = await cb.async_execute(self)
+
+        return result
 
     def write_eof(self) -> None:
         """
@@ -1242,7 +1259,12 @@ class Session:
         if cls == Alias:
             self._aliases.pop(id, None)
         elif cls == Command:
-            self._commands.pop(id, None)
+            cmd = self._commands.pop(id, None)
+            if isinstance(cmd, Command):
+                cmd.reset()
+                cmd.unload()
+                cmd.__unload__()
+
         elif cls == Trigger:
             self._triggers.pop(id, None)
         elif cls == Timer:
@@ -1252,17 +1274,6 @@ class Session:
         elif cls == GMCPTrigger:
             self._gmcp.pop(id, None)
 
-    # def _delObject(self, obj):
-    #     if isinstance(obj, Alias):
-    #         self._aliases.pop(obj.id, None)
-    #     elif isinstance(obj, Command):
-    #         self._commands.pop(obj.id, None)
-    #     elif isinstance(obj, Trigger):
-    #         self._triggers.pop(obj.id, None)
-    #     elif isinstance(obj, Timer):
-    #         self._timers.pop(obj.id, None)
-    #     elif isinstance(obj, GMCPTrigger):
-    #         self._gmcp.pop(obj.id, None)
 
     def _delObjects(self, ids: Iterable, cls: type):
         "删除多个指定元素"
@@ -1282,14 +1293,14 @@ class Session:
                     def __init__(self, session):
                         self.session = session
 
-                        ali = Alias(session, "s", "south", id = "my_ali1")
+                        ali = SimpleAlias(session, r'^gta$', 'get all', id = 'my_ali1')
                         
                         # 以下几种方式均可将该别名添加到会话
                         session.addObject(ali)
                         session.addAlias(ali)
 
                         # 以下三种方式均可以删除该别名
-                        session.delObjec(ali)
+                        session.delObject(ali)
                         session.delAlias(ali)
                         session.delAlias("my_ali1")
 
@@ -1297,21 +1308,23 @@ class Session:
         if isinstance(obj, Alias):
             self._aliases.pop(obj.id, None)
         elif isinstance(obj, Command):
+            obj.reset()
+            obj.unload()
+            obj.__unload__()
             self._commands.pop(obj.id, None)
         elif isinstance(obj, Trigger):
             self._triggers.pop(obj.id, None)
         elif isinstance(obj, Timer):
-            timer = self._timers.pop(obj.id, None)
-            if isinstance(timer, Timer):
-                timer.enabled = False
+            obj.enabled = False
+            self._timers.pop(obj.id, None)
         elif isinstance(obj, GMCPTrigger):
             self._gmcp.pop(obj.id, None)
 
     def delObjects(self, objs):
         """
-        从会话中移除一组对象，可直接删除  Alias, Trigger, GMCPTrigger, Command, Timer 或它们的子类的元组、列表或者字典(保持兼容性)
+        从会话中移除一组对象，可直接删除多个 Alias, Trigger, GMCPTrigger, Command, Timer
         
-        :param objs: 要删除的对象本身，可以为 Alias, Trigger, GMCPTrigger, Command, Timer 或它们的子类
+        :param objs: 要删除的一组对象的元组、列表或者字典(保持兼容性)，其中对象可以为 Alias, Trigger, GMCPTrigger, Command, Timer 或它们的子类
 
         示例:
 
@@ -1340,7 +1353,7 @@ class Session:
 
         elif isinstance(objs, dict):
             for key, item in objs.items():
-                    self.delObject(item)
+                self.delObject(item)
 
     def addAliases(self, alis):
         """
@@ -2603,7 +2616,7 @@ class Session:
             self._unload_module(mod)
 
     def _unload_module(self, module_name):
-        "卸载指定名称模块。卸载支持需要模块的Configuration实现__del__方法"
+        "卸载指定名称模块。卸载支持需要模块的Configuration实现 __unload__ 或 unload 方法"
         if module_name in self._modules.keys():
             mod = self._modules[module_name]["module"]
             config = self._modules[module_name]["config"]

{pymud-0.20.0a3.dist-info → pymud-0.20.0a4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pymud
-Version: 0.20.0a3
+Version: 0.20.0a4
 Summary: a MUD Client written in Python
 Author-email: "newstart@pkuxkx" <crapex@crapex.cc>
 Maintainer-email: "newstart@pkuxkx" <crapex@crapex.cc>
@@ -730,75 +730,179 @@ Requires-Dist: prompt-toolkit
 + 我自己还在玩，所以本客户端会持续进行更新:)
 
 ## 版本更新信息
-### 0.15.8 (2023-12-05)
-发布到pip，增加模块使用
 
-### 0.16.1 (2023-12-11)
-+ 问题修复：修复__init__.py中的__all__变量为字符串
-+ 功能增加：可以加载自定义Settings。在执行python -m pymud时，会自动从当前目录读取pymud.cfg文件。使用json格式将配置信息写在该文件中即可。支持模块中settings.py里的sessions, client, server, styles, text字段内容。
-+ 功能增加：增加全局变量集，可以使用session.setGlobal和session.getGlobal进行访问，以便于跨session通信。也可以使用#global在命令行访问
-+ 功能增加：增加变量的持久化，持久化文件保存于当前目录，文件名为session名称.mud，该文件在会话初始化时自动读取，会话断开时自动保存，其他时候使用#save保存。
-+ 功能增加：在extras.py中增加DotDict，用于支持字典的.访问方式
-+ 功能增加：使用DotDict增加了session有关对象的点访问方式（.）的快捷访问，包括变量vars，全局变量globals，触发器tris，别名alis，命令cmds，定时器timers，gmcp。例如：session.vars.charname，相当于session.getVariable('charname')
-+ 功能增加：增加#all命令，可以向当前所有活动会话发送同一消息，例如#all xixi，可以使所有连接的会话都发送emote
-+ 功能增加：增加%copy系统变量，当复制后，会将复制内容赋值给%copy变量
-+ 功能增加：增加Trigger测试功能，使用#test {msg}在命令行输入后，会如同接收到服务端数据一样引发触发反应，并且会使用[PYMUD TRIGGER TEST]进行信息显示。
-+ 功能增加：匹配#test命令和%copy变量使用如下：窗体中复制有关行，然后命令行中输入#test %copy可使用复制的行来测试触发器
-+ 功能修改：将原CodeBlock修改为CodeBlock和CodeLine组成，以适应新的#test命令
-+ 功能修改：session对命令的输入异步处理函数handle_input_async进行微小调整，以适应#test命令使用
-+ 功能修改：退出时未断开session时的提示窗口文字改为红色（原黄色对比度问题，看不清楚）
-+ 功能修改：恢复了#help功能，可以在任意会话中使用#help列出所有帮助主题，#help {topic}可以查看主题详情
-+ 功能修改：在#reload重新加载脚本时，保留变量数据
+## 0.20.0 (2024-08-XX)
++ 功能调整: 将模块主入口函数从__main__.py中移动到main.py中，以使可以在当前目录下，可直接使用pymud，也可使用python -m pymud启动
++ 功能调整: 使用argsparser标准模块来配置命令行，可以使用 pymud -h 查看命令行具体参数及说明
++ 功能新增: 命令行参数增加指定启动目录的功能，参数为 -s, --startup_dir。即可以从任意目录通过指定脚本目录方式启动PyMUD了。
+    - 例如， PS C:\> pymud -s d:\prog\pkuxkx 相当于 PS D:\prog\pkuxk> pymud
++ 问题修复: MacOS下 python -m pymud init 创建目录报错的问题。同时，将所有系统上的默认目录均使用 ~/pkuxkx （影响windows）
++ 功能调整: 恢复在__init__.py中增加PyMudApp的导出，可以恢复使用from pymud import PyMudApp了
++ 功能新增: 增加log功能，详见 #log 命令介绍、类参考中的 Logger 类，以及 Session 类的 handle_log 方法
++ 功能新增: 增加 #disconnect, #dis 命令，可以使当前会话从服务器断开。相当于操作菜单 会话->断开连接
++ 功能调整: 在没有session的时候，也可以执行#exit命令
++ 功能新增: #session 命令增加快捷创建会话功能，假如已有快捷菜单 世界->pkuxkx->newstart , 则可以通过 #session pkuxkx.newstart 直接创建该会话，效果等同于点击该菜单
++ 功能调整: 点击菜单创建会话时，若会话已存在，则将该会话切换为当前会话
++ 问题修复: 修复原unload方法不能正确卸载的问题
++ 功能新增: 主模块卸载现在既可以定义在__unload__方法中，也可以定义在unload方法中。可以根据自己喜好选择一个即可。
++ 功能调整: 模块加载和重新加载前，会自动调用模块的__unload__方法或unload方法（若有）
++ 功能新增: Command基类增加__unload__方法和unload方法，二者在从会话中移除该 Command 时均会自动调用。自定义的Command子类应覆盖这两种方法中的一种方法，并在其中增加清除类型自行创建的 Trigger, Alias 等会话对象。这样，模块卸载时只要移除命令本身，在命令中新建的其他关联对象将被一同移除。
++ 问题修复: 修复部分正则表达式书写错误问题
++ 功能新增: Session类新增waitfor函数，用于执行一段代码后立即等待某个触发器的情况，简化原三行代码写法
 
-### 0.16.1.post1 (2023-12-12)
-+ 问题修复：修复版本显示，更正问为0.16.1（原0.16.0）
-+ 问题修复：发布日期标志修改为当前时间
-+ 功能修改：CodeLine的执行运行处理修改为不删除中间的多余空白
+``` Python
+    # 原来为确保await triggered的任务在输入前等待，有时候需要这么写：
+    task = self.create_task(self.tri1.triggered())
+    await asyncio.sleep(0.05)
+    self.session.writeline('dazuo')
+    await task
 
-### 0.16.1.post2 (2023-12-12)
-+ 问题修复：修改github项目地址为原pymud地址
+    # 现在可以一句话简写：
+    await self.session.waitfor('dazuo', self.create_task(self.tri1.triggered()))
+```
 
-### 0.16.2a1 (2023-12-18)
-+ 功能修改：归一化#命令和非#命令处理，使session.exec_command、exec_command_async、exec_command_after均可以处理#命令，例如session.exec_command("#save")。同时，也可以在命令行使用#all发送#命令，如"#all #save"此类
-+ 功能修改：调整脚本加载与变量自动加载的顺序。当前为连接自动加载时，首先加载变量，然后再加载脚本。目的是使脚本的变化可以覆盖加载的变量内容，而不是反向覆盖。
-+ 功能修改：会话变量保存和加载可以配置是否打开，默认为打开。见Settings.client["var_autosave] 和 Settings.client["var_autoload"]。同理，该配置可以被本地pymud.cfg所覆盖
-+ 功能修改：将MatchObject的同步onSuccess和异步await的执行顺序进行调整，以确保一定是同步onSuccess先执行。涉及Trigger、Command等。
-+ 功能修改：修改了GMCPTrigger的onSuccess处置和await triggered处置参数，以保持与Trigger同步。当前，onSuccess函数传递3个参数，name，line（GMCP收到的原始str数据）,wildcards（经eval处理的GMCP数据，大概率是dict，偶尔也可能eval失败，返回与line相同值）。await triggered返回与Triggerd的await triggered相同，均为BaseObject.State，包含4个参数的元组，result（永为True)，name（GMCP的id)，line（GMCP原始数据），wildcards（GMCP处理后数据）。其中，后3个参数与onSuccess函数调用时传递参数相同。
++ 功能调整: Session类的addTriggers等方法接受的dict中，会将对象本身id作为会话处理id。当该id与key不一致时，会同时显示警告。
++ 功能新增: Session类新增addObject, addObjects, delObject, delObjects用于操作别名、定时器、触发器、GMCP触发器、命令等对象。
+    - 使用示例:
+
+    ```Python
+        # 所有对象均可以使用 addObject 直接添加到会话中，而不用管是什么具体类型
+        session.addObject(Timer(...))
+        session.addObject(Trigger(...))
+        session.addObject(Alias(...))
+
+        # 所有对象均可以使用 delObject 直接从会话中移除，会自动根据对象类型推断，无需通过函数名区分
+        session.delObject(self.tri1)
+        session.delObject(self.ali1)
+        session.delObject(self.timer1)
+
+        objs = [
+            Trigger(session, xxx, xxx),
+            Alias(session, xxx),
+            SimpleCommand(session, xxx),
+            Timer(session, xxx),
+            GMCPTrigger(session, xxx)
+        ]
+
+        session.addObjects(objs)    # 可以直接将一个数组中所有对象添加到会话中，会自动判断各对象类别
+        session.delObjects(objs)    # 可以直接从会话中移除一个数组中的所有对象，会自动判断对象类别
+    ```
+
++ 功能新增: Session类型新增idletime属性，可以获取本会话发呆秒数（float类型）。当会话处于未连接状态时，返回 -1。可以利用定时器，在其中检测 idletime 值，以在机器人出错后处理恢复
++ 功能新增: Session的所有异步命令调用函数增加返回值，现在调用 session.exec_async, exec_command_async 等方法执行的内容若匹配为命令时，会返回最后最后一个 Command 对象的 execute 函数的返回值
+    - 例如， result = await self.session.cmds.cmd_runto.execute('rt yz') 与 result = await self.session.exec_async('rt yz') 等价，返回值相同
+    - 但     result = await self.session.exec_async('rt yz;dzt')，该返回的result 仅是 dzt 命令的 execute 的返回值。 rt yz 命令返回值被丢弃。
+
+## 0.19.4 (2024-04-20)
++ 功能调整: info 现在 msg 恢复为可接受任何类型参数，不一定是 str
++ 功能调整: #var, #global 指令中，现在可以使用参数扩展了，例如 #var max_qi @qi
++ 功能调整: #var, #global 指令中，现在对字符串会先使用 eval 转换类型，转换失败时使用 str 类型。例如， #var myvar 1 时，myvar类型将为int
++ 功能调整: 变量替代时，会自动实现类型转化，当被替代变量值为非 str 类型时不会再报错
++ 问题修复: 修复之前从后向前选择时，无法复制的问题
 
-### 0.16.2 (2023-12-19)
-+ 功能修改：增加GMCP默认处理。当未使用GMCPTrigger对对应的GMCP消息进行处理时，默认使用[GMCP] name: value的形式输出GMCP收到的消息，以便于个人脚本调试。
-+ 功能修改：修改GMCP数据的处理方式从eval修改为json.load，其余不变。
+## 0.19.3post2 （2024-04-05）
++ 问题修复: 一次发送多个命令时，发送顺序可能不正确的情况
++ 功能增加: 新增一个exec_async函数，是exec函数的异步形式。可以在其他会话中异步执行一段代码
++ 帮助完善: 帮助文档逻辑完善，已完成整个包的内置文档的编写和修改
++ 注: 由于我没弄太明白 readthedocs.io 网站对于读取github源代码的逻辑，目前只能通过新发布正式版本的形式来使 readthedocs.io 网站的文档中的类参考自动更新。
++ 问题修复: 修复退出程序时的小bug
 
-### 0.17.0a1 (2023-12-20)
-+ 功能修改：调整修改GMCP数据的wildcards处理方式，恢复为eval，其余不变。（回滚0.16.2版更改）
-+ 功能修改：将本地pymud.cfg文件的读取默认编码调整为utf8，以避免加载出现问题
-+ 问题修复：sessions.py中，修复系统command与会话command重名的问题（这次才发现）
-+ 功能修改：将自动脚本加载调整到session创建初始，而不论是否连接服务器
-+ 功能修改：脚本load和reload时，不再清空任何对象，保留内容包括：中止并清空所有task，关闭所有定时器，将所有异步对象复位
-+ 功能修改：去掉了左右边框
+## 0.19.2post2 （2024-03-24）
++ 错误修复：订正部分错别字、错误帮助、错别格式
++ 系统完善：完善帮助体系，按reST格式重写所有有关的docstring
++ 功能调整：session.exec_command / exec_command_async / exec 系列命令调整，现在可以在exec时带变量参数了。例如 session.exec("dazuo @dzpt")，直接调用 dzpt的变量值
++ 功能调整: settings.py中，client字典增加配置reconnect_wait，为自动重连的等待时间，默认15s，可本地覆盖
++ 功能调整: 变通解决了菜单栏右边单击 帮助 菜单会响应问题
++ 错误修复: 修复了会话关闭时插件卸载的代码错误
++ 功能调整: 在会话关闭、程序退出时增加等待，确保收到服务器断开命令之后才关闭和退出
++ 问题修复: 在退出程序时增加了插件卸载调用
++ 实现调整: 在清除task的列表推导过程中去掉了类型判断以减少任务时间占用
++ 其他调整: 从包中删除了拷贝过来作为参考的文件
++ 帮助完善: 帮助文档逻辑完善
++ 实现调整: 改用官方示例的task清除方式，每个任务结束后清除
 
-### 0.17.0b1 (2023-12-23)
-+ 问题修复：修复了当使用session.addCommand/addTrigger/addAlias等添加对象，而对象是Command/Trigger/Alias等的子类时，由于类型检查失败导致无法成功的问题
-+ 功能修改：增加自动重连配置，Settings.client["auto_reconnect"]配置，当为True时，若连接过程中出现异常断开，则10秒后自动重连。该配置默认为False。
-+ 功能修改：当连接过程中出现异常时，异常提示中增加异常时刻。
-+ 功能修改：#reload指令增加可以重新加载插件功能。例如，#reload chathook会重新加载名为chathook的插件。
-+ 功能增加：增加#py指令，可以直接在命令行中写代码并执行。执行的上下文环境为当前环境，即self代表当前session。例如，#py self.writeline("xixi")相当于直接在脚本会话中调用发送xixi指令
-+ 功能新增：新增插件（Plugins）功能。将自动读取pymud模块目录的plugins子目录以及当前脚本目录的plugins子目录下的.py文件，若发现遵照插件规范脚本，将自动加载该模块到pymud。可以使用#plugins查看所有被加载的插件，可以直接带参数插件名（如#plugins myplugin）查看插件的详细信息（自动打印插件的__doc__属性，即写在文件最前面的字符串常量）插件文件中必须有以下定义：
+## 0.19.1 （2024-03-06）
++ 功能新增: 新增鼠标启用禁用功能，以适用于ssh远程情况下的复制功能。F2快捷键可以切换状态。当鼠标禁用时，底部状态栏右侧会显示“鼠标已禁用状态”
++ 功能新增: 新增快捷键F1会直接通过浏览器打开帮助网址 https://pymud.readthedocs.io/
++ 功能新增: 新增默认快捷键F3=#ig, F4=#cls, F11=#close, F12=#exit。此几个快捷键通过配置文件进行配置，可以自行定义或修改。F1、F2为写死的系统功能。
++ 功能调整: 将除#session之外的所有其他#命令实现统一到Session类中实现，这些命令均支持通过Session.exec_command运行
++ 功能调整: python -m pymud init时，创建的pymud.cfg文件增加了keys字典
 
-|名称|类型|状态|含义|
-|-|-|-|-|
-|PLUGIN_NAME|str|必须有|插件唯一名称|
-|PLUGIN_DESC|dict|必须有|插件描述信息的详情，必要关键字包含VERSION（版本）、AUTHOR（作者）、RELEASE_DATE（发布日期）、DESCRIPTION（简要描述）|
-|PLUGIN_PYMUD_START|func(app)|函数定义必须有，函数体可以为空|PYMUD自动读取并加载插件时自动调用的函数， app为PyMudApp（pymud管理类）。该函数仅会在程序运行时，自动加载一次|
-|PLUGIN_SESSION_CREATE|func(session)|函数定义必须有，函数体可以为空|在会话中加载插件时自动调用的函数， session为加载插件的会话。该函数在每一个会话创建时均被自动加载一次|
-|PLUGIN_SESSION_DESTROY|func(session)|函数定义必须有，函数体可以为空|在会话中卸载插件时自动调用的函数， session为卸载插件的会话。卸载在每一个会话关闭时均被自动运行一次。|
+## 0.19.0 (2024-03-01)
++ 实现调整: session.info/warning/error处理多行时，会给每一行加上同样颜色
++ 功能新增: 初次运行时，可以使用python -m pymud init来初始化环境，自动创建目录并在该目录中建立配置文件和样例脚本文件
++ 实现调整: 将缓冲清除行数的实现调整到SessionBuffer中，减少代码耦合并进一步降低内存占用
++ 功能新增: 新增命令行命令#T+, #T-, 可以使能/禁用指定组，相当于session.enableGroup操作
++ 功能新增: 新增命令行命令#task，可以列出所有系统管理的Task清单，主要用于开发测试
++ 实现调整: 调整系统管理Task的清空和退出机制，减少处理时间占用和内存占用
++ 实现调整: 调整COPY-RAW模式复制，即使仅选中行中的部分内容，也自动识别整行（多行模式也是整个多行）
++ 功能新增: Settings中新增keys字典，用于定义快捷键。可定义快捷键参见prompt_toolkit中Keys的定义。其值为可在session.exec_command运行支持的所有内容。该字典内容可以被pymud.cfg所覆盖。
 
-### 0.17.0 (2023-12-24)
-+ 功能修改：对session自动加载mud文件中变量失败时的异常进行管理，此时将不加载变量，自动继续进行
-+ 功能修改：所有匹配类对象的匹配模式patterns支持动态修改，涉及Alias，Trigger，Command。修改方式为直接对其patterns属性赋值。如tri.patterns = aNewPattern
-+ 功能修改：连接/断开连接时刻都会在提示中增加时刻信息，而不论是否异常。
+## 0.18.4post4 (2024-02-23)
++ 功能新增：新增Settings.client["buffer_lines"]，表示保留的缓冲行数（默认5000）。当Session内容缓冲行数达到该值2倍时（10000行），将截取一半（5000行），后一半内容进行保留，前一半丢弃。此功能是为了减少长时挂机的内存消耗和响应时间。
++ 功能修复：解决在显示美化（Settings.client["beautify"]）打开之后，复制部分文字不能正确判断起始终止的问题。
++ 功能调整：修改缓冲行数判断逻辑，加快客户端判断响应速度。
++ 问题调整：修改缓冲截取处理中的小BUG。
++ 功能调整：将帮助窗口中的链接改到帮助网址： https://pymud.readthedocs.org
++ 问题修复：修复了随包提供的pkuxkx.py样例脚本中的几处错误
+
+## 0.18.3 (2024-02-07)
++ 功能调整：原#unload时通过调用__del__来实现卸载的时间不可控，现将模块卸载改为调用unload函数。若需卸载时人工清除有关定时器、触发器等，请在Configuration类下新增unload函数（参数仅self），并在其中进行实现
++ 功能新增：新增会话Variable和全局Global的删除接口。可以通过session.delVariable(name)删除一个变量，可以通过session.delGlobal(name)来删除一个全局Global变量
+
+## 0.18.2 (2024-02-06)
++ 问题修复：修改了定时器实现，以避免出现递归调用超限异常
++ 问题修复：修改了参数替代时的默认值，从None改为字符串"None"，以避免替代时报None异常
+
+## 0.18.1 (2024-02-05)
++ 问题修复：统一处置了task.cancel的参数和create_task的name属性，以适应更低版本的python环境（低至3.7）
++ 实现调整：为解决同步/异步执行问题，在CodeLine和CodeBlock的实现中，会通过调用命令来判断是否使用同步模式（默认为异步）。#gag、#replace为强制同步，#wa为强制异步。当同时存在时，同步失效，异步执行。
++ 实现调整：将%line、%raw的访问传递到触发器内部的执行中，避免同步异步问题。
++ 新增文档：将帮助文档添加到本项目，帮助文档自动同步到 pymud.readthedocs.org （文档内容暂未更新）
 
-### 0.17.1 (2023-12-27)
+## 0.18.0 (2024-01-24) 
++ 问题修复：修复了delTrigger/delAlias等等无法删除对象的问题
++ 功能调整：delTrigger等函数，修改为既可以接受Trigger对象本身，也可以接受其id。其他类似
++ 功能增加：增加了delTriggers（注意，带s）等函数，可以删除多个指定对象。可接受列表、元组等可迭代对象，并且其内容既可以为对象本身，也可以为id。
++ 功能增加：增加了session.reset()功能，可清除会话所有有关脚本信息。也可以在命令行使用#reset调用，另外，#unload不带参数调用时，有同样效果
++ 功能增加：增加了#ignore/#ig参数，类似于zmud的#ignore功能，可以切换全局触发器禁用状态。当全局被禁用时，底部状态栏右侧会显示此状态。（未全局禁用时不显示）
++ 功能调整：移除了会话切换时，状态栏显示的内容
++ 功能调整：会话命令的执行整体进行了实现调整，将参数替代延迟到特定命令执行时刻。（此实现影响面较大，请大家使用中发现BUG时都报告下，我及时修改）
++ 功能调整：代码块现在可以使用{}括起来了。这种情况下，命令和命令可以嵌套了。例如，#3 {#3 get g1b from bo yu;combine gem;pack gem;#wa 3000}，该代码可以执行三次合并g1b宝石
++ 功能新增：增加了#ali,#tri,#ti的三参数使用，可以在命令行直接代码创建SimpleAlias, SimpleTrigger和SimpleTimer。
++ 使用示例：#ali {gp\s(\S+)} {get %1 from corpse}, #tri {^[> ]*【\S+】.+} {#mess %line}, #ti 10 {xixi;haha}
++ 功能新增：新增#session_name cmd命令，可以直接使名为session_name的会话执行cmd命令
++ 功能新增：session类型新增exec方法，使用方法为：session.exec(cmd, session_name)。可以使名为session_name的会话执行cmd命令。当不指定session_name时，在当前会话执行。
++ 功能调整：定时器创建时若不指定id，其自动生成的id前缀由tmr调整为ti
++ 实现调整：将#all、#session_name cmd等命令的实现从pymud.py中移动到了session.py中，这样可以在脚本中使用session.exec_command("#all xixi")。
++ 问题修复：修复了点击菜单"重新加载脚本配置"报错的问题
++ 功能调整：从菜单里点击创建会话时，会自动以登录名为本会话创建id变量
++ 当前已知问题：由于同步/异步执行问题，在SimpleTrigger中，#gag和#replace的执行结果会很奇怪，可能会隐藏和替换掉非触发行。可行的办法为在onSuccess里，调用session.replace进行处理。
+
+## 0.17.4 (2024-01-08)
++ 问题修复：修复了DotDict在dump时出现错误的问题
++ 问题修复：修改了reconnect的实现方式，修复了断开重连时报错的问题
++ 功能增加：为Session增加两个事件属性，分别为event_connected和event_disconnected，接受一个带有session参数的函数，在连接和连接断开时触发。
++ 功能调整：调整了时间显示格式，只显示到秒，不显示毫秒数。
+
+## 0.17.3 (2024-01-02)
++ 问题修复：修复了原有的#repeat功能。命令行#repeat/#rep可以重复输入上一次命令（这个基本没用，主要是我在远程连接时，手机上没有方向键...）
++ 问题修复：修改定时器的实现方式，真正修复了定时器每reload后会新增一个的bug。
++ 功能增加：命令行使用#tri, #ali, #cmd, #ti时，除了接受on/off参数外，增加了del参数，可以删除对应的触发器、别名、命令、定时器。例如：#ti tm_test del 可以删除id为“tm_test”的定时器。
++ 功能调整：调整了#help {cmd}的显示格式，最后一行也增加了换行符，确保后续数据在下一行出现。
++ 功能调整：调整了Timer和SimpleTimer在#timer时的显示格式。
++ 实现调整：调整了Session.clean实现中各对象清理的顺序，将任务清除移到了最后。
+
+## 0.17.2post4 (2023-12-29)
++ 功能修改：会话菜单 "显示/隐藏命令" 和 "打开/关闭自动重连" 操作后，增加在当前会话中提示状态信息。
++ 功能修改：Timer实现进行修改，以确保一个定时器仅创建一个任务。
++ 功能调整：Timer对象在复位Session对象时，也同时复位。目的是确保reload时不重新创建定时器任务。
++ 功能调整：在会话连接时，不再复位Session有关对象信息。该复位活动仅在连接断开时和脚本重新加载时进行。
++ 功能调整：启动PYMUD时，会将控制台标题设置为PYMUD+版本号。
++ 问题修复：修复会话特定脚本模块会被其他会话加载的bug。
++ 问题修复：修复定时器Timer中的bug。
+
+## 0.17.1post1 (2023-12-27)
 本版对模块功能进行了整体调整，支持加载/卸载/重载/预加载多个模块，具体内容如下：
 + 当模块中存在名为Configuration类时，以主模块形式加载，即：自动创建该Configuration类的实例（与原脚本相同）
 + 当模块中不存在名为Configuration类时，以子模块形式加载，即：仅加载该模块，但不会创建Configuration的实例
@@ -834,164 +938,66 @@ Requires-Dist: prompt-toolkit
  }
 ```
 
-### 0.17.1post1 (2023-12-27)
 + 问题修复：修复enableGroup中定时器处的bug
 + 功能修改：会话连接和重新连接时，取消原定时器停止的设定，目前保留为只清除所有task、复位Command
 + 功能修改：auto_reconnect设定目前对正常/异常断开均有效。若设置为True，当连接断开后15s后自动重连
 + 功能修改：会话菜单下增加“打开/关闭自动重连”子菜单，可以动态切换自动重连是否打开。
 
-### 0.17.2 (2023-12-28)
-+ 功能修改：会话菜单 "显示/隐藏命令" 和 "打开/关闭自动重连" 操作后，增加在当前会话中提示状态信息。
-+ 功能修改：Timer实现进行修改，以确保一个定时器仅创建一个任务。
-+ 功能调整：Timer对象在复位Session对象时，也同时复位。目的是确保reload时不重新创建定时器任务。
-+ 功能调整：在会话连接时，不再复位Session有关对象信息。该复位活动仅在连接断开时和脚本重新加载时进行。
-+ 功能调整：启动PYMUD时，会将控制台标题设置为PYMUD+版本号。
-
-### 0.17.2post1 (2023-12-28)
-+ 问题修复：修复定时器Timer中的bug。
-
-### 0.17.2post2 (2023-12-28)
-+ 问题修复：修复会话特定脚本模块会被其他会话加载的bug。
-
-### 0.17.2post4 (2023-12-29)
-+ 问题修复：修复定时器Timer中的bug。
-
-### 0.17.3 (2024-01-02)
-+ 问题修复：修复了原有的#repeat功能。命令行#repeat/#rep可以重复输入上一次命令（这个基本没用，主要是我在远程连接时，手机上没有方向键...）
-+ 问题修复：修改定时器的实现方式，真正修复了定时器每reload后会新增一个的bug。
-+ 功能增加：命令行使用#tri, #ali, #cmd, #ti时，除了接受on/off参数外，增加了del参数，可以删除对应的触发器、别名、命令、定时器。例如：#ti tm_test del 可以删除id为“tm_test”的定时器。
-+ 功能调整：调整了#help {cmd}的显示格式，最后一行也增加了换行符，确保后续数据在下一行出现。
-+ 功能调整：调整了Timer和SimpleTimer在#timer时的显示格式。
-+ 实现调整：调整了Session.clean实现中各对象清理的顺序，将任务清除移到了最后。
-
-### 0.17.4 (2024-01-08)
-+ 问题修复：修复了DotDict在dump时出现错误的问题
-+ 问题修复：修改了reconnect的实现方式，修复了断开重连时报错的问题
-+ 功能增加：为Session增加两个事件属性，分别为event_connected和event_disconnected，接受一个带有session参数的函数，在连接和连接断开时触发。
-+ 功能调整：调整了时间显示格式，只显示到秒，不显示毫秒数。
-
-### 0.18.0b1 (2024-01-21) 
-+ 问题修复：修复了delTrigger/delAlias等等无法删除对象的问题
-+ 功能调整：delTrigger等函数，修改为既可以接受Trigger对象本身，也可以接受其id。其他类似
-+ 功能增加：增加了delTriggers（注意，带s）等函数，可以删除多个指定对象。可接受列表、元组等可迭代对象，并且其内容既可以为对象本身，也可以为id。
-+ 功能增加：增加了session.reset()功能，可清除会话所有有关脚本信息。也可以在命令行使用#reset调用，另外，#unload不带参数调用时，有同样效果
-+ 功能增加：增加了#ignore/#ig参数，类似于zmud的#ignore功能，可以切换全局触发器禁用状态。当全局被禁用时，底部状态栏右侧会显示此状态。（未全局禁用时不显示）
-+ 功能调整：移除了会话切换时，状态栏显示的内容
-+ 功能调整：会话命令的执行整体进行了实现调整，将参数替代延迟到特定命令执行时刻。（此实现影响面较大，请大家使用中发现BUG时都报告下，我及时修改）
-+ 功能调整：代码块现在可以使用{}括起来了。这种情况下，命令和命令可以嵌套了。例如，#3 {#3 get g1b from bo yu;combine gem;pack gem;#wa 3000}，该代码可以执行三次合并g1b宝石
-+ 功能新增：增加了#ali,#tri,#ti的三参数使用，可以在命令行直接代码创建SimpleAlias, SimpleTrigger和SimpleTimer。
-+ 使用示例：#ali {gp\s(\S+)} {get %1 from corpse}, #tri {^[> ]*【\S+】.+} {#mess %line}, #ti 10 {xixi;haha}
-+ 功能新增：新增#session_name cmd命令，可以直接使名为session_name的会话执行cmd命令
-+ 功能新增：session类型新增exec方法，使用方法为：session.exec(cmd, session_name)。可以使名为session_name的会话执行cmd命令。当不指定session_name时，在当前会话执行。
-+ 功能调整：定时器创建时若不指定id，其自动生成的id前缀由tmr调整为ti
-+ 实现调整：将#all、#session_name cmd等命令的实现从pymud.py中移动到了session.py中，这样可以在脚本中使用session.exec_command("#all xixi")。
-+ 当前已知问题：由于同步/异步执行问题，在SimpleTrigger中，#gag和#replace的执行结果会很奇怪，可能会隐藏和替换掉非触发行。可行的办法为在onSuccess里，调用session.replace进行处理。
-
-### 0.18.0 (2024-01-24)
-+ 问题修复：修复了点击菜单"重新加载脚本配置"报错的问题
-+ 功能调整：从菜单里点击创建会话时，会自动以登录名为本会话创建id变量
-
-### 0.18.1 (2024-02-05)
-+ 问题修复：统一处置了task.cancel的参数和create_task的name属性，以适应更低版本的python环境（低至3.7）
-+ 实现调整：为解决同步/异步执行问题，在CodeLine和CodeBlock的实现中，会通过调用命令来判断是否使用同步模式（默认为异步）。#gag、#replace为强制同步，#wa为强制异步。当同时存在时，同步失效，异步执行。
-+ 实现调整：将%line、%raw的访问传递到触发器内部的执行中，避免同步异步问题。
-+ 新增文档：将帮助文档添加到本项目，帮助文档自动同步到 pymud.readthedocs.org （文档内容暂未更新）
-
-### 0.18.2 (2024-02-06)
-+ 问题修复：修改了定时器实现，以避免出现递归调用超限异常
-+ 问题修复：修改了参数替代时的默认值，从None改为字符串"None"，以避免替代时报None异常
-
-### 0.18.3 (2024-02-07)
-+ 功能调整：原#unload时通过调用__del__来实现卸载的时间不可控，现将模块卸载改为调用unload函数。若需卸载时人工清除有关定时器、触发器等，请在Configuration类下新增unload函数（参数仅self），并在其中进行实现
-+ 功能新增：新增会话Variable和全局Global的删除接口。可以通过session.delVariable(name)删除一个变量，可以通过session.delGlobal(name)来删除一个全局Global变量
-
-### 0.18.4 (2024-02-19)
-+ 功能新增：新增Settings.client["buffer_lines"]，表示保留的缓冲行数（默认5000）。当Session内容缓冲行数达到该值2倍时（10000行），将截取一半（5000行），后一半内容进行保留，前一半丢弃。此功能是为了减少长时挂机的内存消耗和响应时间。
-+ 功能修复：解决在显示美化（Settings.client["beautify"]）打开之后，复制部分文字不能正确判断起始终止的问题。
-
-### 0.18.4post1 (2024-02-19)
-+ 功能调整：修改缓冲行数判断逻辑，加快客户端判断响应速度。
-
-### 0.18.4post2 (2024-02-20)
-+ 问题调整：修改缓冲截取处理中的小BUG。
-
-### 0.18.4post4 (2024-02-23)
-+ 功能调整：将帮助窗口中的链接改到帮助网址： https://pymud.readthedocs.org
-+ 问题修复：修复了随包提供的pkuxkx.py样例脚本中的几处错误
-
-### 0.19.0 (2024-03-01)
-+ 实现调整: session.info/warning/error处理多行时，会给每一行加上同样颜色
-+ 功能新增: 初次运行时，可以使用python -m pymud init来初始化环境，自动创建目录并在该目录中建立配置文件和样例脚本文件
-+ 实现调整: 将缓冲清除行数的实现调整到SessionBuffer中，减少代码耦合并进一步降低内存占用
-+ 功能新增: 新增命令行命令#T+, #T-, 可以使能/禁用指定组，相当于session.enableGroup操作
-+ 功能新增: 新增命令行命令#task，可以列出所有系统管理的Task清单，主要用于开发测试
-+ 实现调整: 调整系统管理Task的清空和退出机制，减少处理时间占用和内存占用
-+ 实现调整: 调整COPY-RAW模式复制，即使仅选中行中的部分内容，也自动识别整行（多行模式也是整个多行）
-+ 功能新增: Settings中新增keys字典，用于定义快捷键。可定义快捷键参见prompt_toolkit中Keys的定义。其值为可在session.exec_command运行支持的所有内容。该字典内容可以被pymud.cfg所覆盖。
-
-### 0.19.1 （2024-03-06）
-+ 功能新增: 新增鼠标启用禁用功能，以适用于ssh远程情况下的复制功能。F2快捷键可以切换状态。当鼠标禁用时，底部状态栏右侧会显示“鼠标已禁用状态”
-+ 功能新增: 新增快捷键F1会直接通过浏览器打开帮助网址 https://pymud.readthedocs.io/
-+ 功能新增: 新增默认快捷键F3=#ig, F4=#cls, F11=#close, F12=#exit。此几个快捷键通过配置文件进行配置，可以自行定义或修改。F1、F2为写死的系统功能。
-+ 功能调整: 将除#session之外的所有其他#命令实现统一到Session类中实现，这些命令均支持通过Session.exec_command运行
-+ 功能调整: python -m pymud init时，创建的pymud.cfg文件增加了keys字典
-
-### 0.19.2 （2024-03-22）
-+ 错误修复：订正部分错别字、错误帮助、错别格式
-+ 系统完善：完善帮助体系，按reST格式重写所有有关的docstring
-+ 功能调整：session.exec_command / exec_command_async / exec 系列命令调整，现在可以在exec时带变量参数了。例如 session.exec("dazuo @dzpt")，直接调用 dzpt的变量值
-+ 功能调整: settings.py中，client字典增加配置reconnect_wait，为自动重连的等待时间，默认15s，可本地覆盖
-+ 功能调整: 变通解决了菜单栏右边单击 帮助 菜单会响应问题
-+ 错误修复: 修复了会话关闭时插件卸载的代码错误
-+ 功能调整: 在会话关闭、程序退出时增加等待，确保收到服务器断开命令之后才关闭和退出
-
-### 0.19.2post1 （2024-03-23）
-+ 问题修复: 在退出程序时增加了插件卸载调用
-+ 实现调整: 在清除task的列表推导过程中去掉了类型判断以减少任务时间占用
-+ 其他调整: 从包中删除了拷贝过来作为参考的文件
-+ 帮助完善: 帮助文档逻辑完善
-
-### 0.19.2post2 （2024-03-24）
-+ 实现调整: 改用官方示例的task清除方式，每个任务结束后清除
-
-### 0.19.3 (2024-03-27)
-+ 问题修复: 一次发送多个命令时，发送顺序可能不正确的情况
-
-### 0.19.3post1 (2024-04-03)
-+ 功能增加: 新增一个exec_async函数，是exec函数的异步形式。可以在其他会话中异步执行一段代码
-+ 帮助完善: 帮助文档逻辑完善，已完成整个包的内置文档的编写和修改
-+ 注: 由于我没弄太明白 readthedocs.io 网站对于读取github源代码的逻辑，目前只能通过新发布正式版本的形式来使 readthedocs.io 网站的文档中的类参考自动更新。
+## 0.17.0 (2023-12-24)
++ 功能修改：调整修改GMCP数据的wildcards处理方式，恢复为eval，其余不变。（回滚0.16.2版更改）
++ 功能修改：将本地pymud.cfg文件的读取默认编码调整为utf8，以避免加载出现问题
++ 问题修复：sessions.py中，修复系统command与会话command重名的问题（这次才发现）
++ 功能修改：将自动脚本加载调整到session创建初始，而不论是否连接服务器
++ 功能修改：脚本load和reload时，不再清空任何对象，保留内容包括：中止并清空所有task，关闭所有定时器，将所有异步对象复位
++ 功能修改：去掉了左右边框
++ 问题修复：修复了当使用session.addCommand/addTrigger/addAlias等添加对象，而对象是Command/Trigger/Alias等的子类时，由于类型检查失败导致无法成功的问题
++ 功能修改：增加自动重连配置，Settings.client["auto_reconnect"]配置，当为True时，若连接过程中出现异常断开，则10秒后自动重连。该配置默认为False。
++ 功能修改：当连接过程中出现异常时，异常提示中增加异常时刻。
++ 功能修改：#reload指令增加可以重新加载插件功能。例如，#reload chathook会重新加载名为chathook的插件。
++ 功能增加：增加#py指令，可以直接在命令行中写代码并执行。执行的上下文环境为当前环境，即self代表当前session。例如，#py self.writeline("xixi")相当于直接在脚本会话中调用发送xixi指令
++ 功能新增：新增插件（Plugins）功能。将自动读取pymud模块目录的plugins子目录以及当前脚本目录的plugins子目录下的.py文件，若发现遵照插件规范脚本，将自动加载该模块到pymud。可以使用#plugins查看所有被加载的插件，可以直接带参数插件名（如#plugins myplugin）查看插件的详细信息（自动打印插件的__doc__属性，即写在文件最前面的字符串常量）插件文件中必须有以下定义：
 
-### 0.19.3post2 （2024-04-05）
-+ 问题修复: 修复退出程序时的小bug
+|名称|类型|状态|含义|
+|-|-|-|-|
+|PLUGIN_NAME|str|必须有|插件唯一名称|
+|PLUGIN_DESC|dict|必须有|插件描述信息的详情，必要关键字包含VERSION（版本）、AUTHOR（作者）、RELEASE_DATE（发布日期）、DESCRIPTION（简要描述）|
+|PLUGIN_PYMUD_START|func(app)|函数定义必须有，函数体可以为空|PYMUD自动读取并加载插件时自动调用的函数， app为PyMudApp（pymud管理类）。该函数仅会在程序运行时，自动加载一次|
+|PLUGIN_SESSION_CREATE|func(session)|函数定义必须有，函数体可以为空|在会话中加载插件时自动调用的函数， session为加载插件的会话。该函数在每一个会话创建时均被自动加载一次|
+|PLUGIN_SESSION_DESTROY|func(session)|函数定义必须有，函数体可以为空|在会话中卸载插件时自动调用的函数， session为卸载插件的会话。卸载在每一个会话关闭时均被自动运行一次。|
 
-### 0.19.4 (2024-04-20)
-+ 功能调整: info 现在 msg 恢复为可接受任何类型参数，不一定是 str
-+ 功能调整: #var, #global 指令中，现在可以使用参数扩展了，例如 #var max_qi @qi
-+ 功能调整: #var, #global 指令中，现在对字符串会先使用 eval 转换类型，转换失败时使用 str 类型。例如， #var myvar 1 时，myvar类型将为int
-+ 功能调整: 变量替代时，会自动实现类型转化，当被替代变量值为非 str 类型时不会再报错
-+ 问题修复: 修复之前从后向前选择时，无法复制的问题
++ 功能修改：对session自动加载mud文件中变量失败时的异常进行管理，此时将不加载变量，自动继续进行
++ 功能修改：所有匹配类对象的匹配模式patterns支持动态修改，涉及Alias，Trigger，Command。修改方式为直接对其patterns属性赋值。如tri.patterns = aNewPattern
++ 功能修改：连接/断开连接时刻都会在提示中增加时刻信息，而不论是否异常。
 
-### 0.20.0a1 (2024-08-14)
-+ 功能调整: 使用argsparser标准模块来配置命令行，可以使用 python -m pymud -h 查看命令行具体参数及说明
-+ 功能调整: 恢复在__init__.py中增加PyMudApp的导出，可以恢复使用from pymud import PyMudApp了
-+ 功能调整: 在没有session的时候，也可以执行#exit命令
-+ 功能调整: 模块加载和重新加载前，会自动调用模块的unload方法（若有）
-+ 功能新增: 增加log功能，详见 #log 命令介绍、类参考中的 Logger 类，以及 Session 类的 handle_log 方法
+## 0.16.2 (2023-12-19)
++ 功能修改：归一化#命令和非#命令处理，使session.exec_command、exec_command_async、exec_command_after均可以处理#命令，例如session.exec_command("#save")。同时，也可以在命令行使用#all发送#命令，如"#all #save"此类
++ 功能修改：调整脚本加载与变量自动加载的顺序。当前为连接自动加载时，首先加载变量，然后再加载脚本。目的是使脚本的变化可以覆盖加载的变量内容，而不是反向覆盖。
++ 功能修改：会话变量保存和加载可以配置是否打开，默认为打开。见Settings.client["var_autosave] 和 Settings.client["var_autoload"]。同理，该配置可以被本地pymud.cfg所覆盖
++ 功能修改：将MatchObject的同步onSuccess和异步await的执行顺序进行调整，以确保一定是同步onSuccess先执行。涉及Trigger、Command等。
++ 功能修改：修改了GMCPTrigger的onSuccess处置和await triggered处置参数，以保持与Trigger同步。当前，onSuccess函数传递3个参数，name，line（GMCP收到的原始str数据）,wildcards（经eval处理的GMCP数据，大概率是dict，偶尔也可能eval失败，返回与line相同值）。await triggered返回与Triggerd的await triggered相同，均为BaseObject.State，包含4个参数的元组，result（永为True)，name（GMCP的id)，line（GMCP原始数据），wildcards（GMCP处理后数据）。其中，后3个参数与onSuccess函数调用时传递参数相同。
++ 功能修改：增加GMCP默认处理。当未使用GMCPTrigger对对应的GMCP消息进行处理时，默认使用[GMCP] name: value的形式输出GMCP收到的消息，以便于个人脚本调试。
++ 功能修改：修改GMCP数据的处理方式从eval修改为json.load，其余不变。
 
-### 0.20.0a2 (2024-08-19)
-+ 问题修复: 关闭会话时未关闭相关记录器，导致后续会话无法启动
-+ 问题修复: MacOS下 python -m pymud init 创建目录报错的问题。同时，将所有系统上的默认目录均使用 ~/pkuxkx （影响windows）
-+ 功能新增: Session类新增waitfor函数，用于执行一段代码后立即等待某个触发器的情况，简化原三行代码写法
+## 0.16.1.post2 (2023-12-12)
++ 问题修复：修复__init__.py中的__all__变量为字符串
++ 功能增加：可以加载自定义Settings。在执行python -m pymud时，会自动从当前目录读取pymud.cfg文件。使用json格式将配置信息写在该文件中即可。支持模块中settings.py里的sessions, client, server, styles, text字段内容。
++ 功能增加：增加全局变量集，可以使用session.setGlobal和session.getGlobal进行访问，以便于跨session通信。也可以使用#global在命令行访问
++ 功能增加：增加变量的持久化，持久化文件保存于当前目录，文件名为session名称.mud，该文件在会话初始化时自动读取，会话断开时自动保存，其他时候使用#save保存。
++ 功能增加：在extras.py中增加DotDict，用于支持字典的.访问方式
++ 功能增加：使用DotDict增加了session有关对象的点访问方式（.）的快捷访问，包括变量vars，全局变量globals，触发器tris，别名alis，命令cmds，定时器timers，gmcp。例如：session.vars.charname，相当于session.getVariable('charname')
++ 功能增加：增加#all命令，可以向当前所有活动会话发送同一消息，例如#all xixi，可以使所有连接的会话都发送emote
++ 功能增加：增加%copy系统变量，当复制后，会将复制内容赋值给%copy变量
++ 功能增加：增加Trigger测试功能，使用#test {msg}在命令行输入后，会如同接收到服务端数据一样引发触发反应，并且会使用[PYMUD TRIGGER TEST]进行信息显示。
++ 功能增加：匹配#test命令和%copy变量使用如下：窗体中复制有关行，然后命令行中输入#test %copy可使用复制的行来测试触发器
++ 功能修改：将原CodeBlock修改为CodeBlock和CodeLine组成，以适应新的#test命令
++ 功能修改：session对命令的输入异步处理函数handle_input_async进行微小调整，以适应#test命令使用
++ 功能修改：退出时未断开session时的提示窗口文字改为红色（原黄色对比度问题，看不清楚）
++ 功能修改：恢复了#help功能，可以在任意会话中使用#help列出所有帮助主题，#help {topic}可以查看主题详情
++ 功能修改：在#reload重新加载脚本时，保留变量数据
++ 问题修复：修复版本显示，更正为0.16.1（原0.16.0）
++ 问题修复：发布日期标志修改为当前时间
++ 功能修改：CodeLine的执行运行处理修改为不删除中间的多余空白
++ 问题修复：修改github项目地址为原pymud地址
 
-### 0.20.0 (2024-08-XX)
-+ 功能调整: 将模块主入口函数从__main__.py中移动到main.py中，以使可以在当前目录下，可直接使用pymud，也可使用python -m pymud启动
-+ 问题修复: 修复部分正则表达式书写错误问题
-+ 功能调整: Session类的addTriggers等方法接受的dict中，会将对象本身id作为会话处理id。当该id与key不一致时，会同时显示警告。
-+ 功能新增: Session类新增addObject, addObjects, delObject, delObjects用于操作别名、定时器、触发器、GMCP触发器、命令等对象。
-+ 功能新增: 主模块卸载现在既可以定义在__unload__方法中，也可以定义在unload方法中
-+ 问题修复: 修复原unload方法不能正确卸载的问题
-+ 功能新增: 命令行参数增加指定启动目录的功能，参数为 -s, --startup_dir。即可以从任意目录通过指定脚本目录方式启动PyMUD了。例如， PS C:\> pymud -s d:\prog\pkuxkx 相当于 PS D:\prog\pkuxk> pymud
-+ 功能新增: 增加 #disconnect, #dis 命令，可以使当前会话从服务器断开。相当于操作菜单 会话->断开连接
-+ 功能新增: #session 命令增加快捷创建会话功能，假如已有快捷菜单 世界->pkuxkx->newstart , 则可以通过 #session pkuxkx.newstart 直接创建该会话，效果等同于点击该菜单
-+ 功能调整: 点击菜单创建会话时，若会话已存在，则将该会话切换为当前会话
+## 0.15.8 (2023-12-05)
+首次发布到pip，增加模块使用

pymud-0.20.0a4.dist-info/RECORD

@@ -0,0 +1,18 @@
+pymud/__init__.py,sha256=hvX7Ga2xPG9J3ZpxBLrC6BvrzUo-Dj26HsRKf41Brhw,533
+pymud/__main__.py,sha256=hFzZjadLlcOuoLM7D8wFiFVO8mqF7vMuo9y-9xfIhRc,64
+pymud/dialogs.py,sha256=D0ZtCeoBchF5eYzXumkOi3p-maCQZu4v9-wJgxQ790o,6500
+pymud/extras.py,sha256=QwWwLavVtuXfg0Qb0f_040va1_kej27P-ZB_19HB6Qk,42422
+pymud/logger.py,sha256=elYfbpvmKYJfB-rnPYZWY5r8ROu9yja9t-dBi1faRGc,5358
+pymud/main.py,sha256=b_Ui_cN4W8IfhYNyc1duwr3Bp7pYYZQusKTSafCWZIA,6534
+pymud/objects.py,sha256=aV3RzhZZ7y3qK_kwaYbtnpmaqfBxVwQ8fMwvEs9Dh-A,38534
+pymud/pkuxkx.py,sha256=jRQRUs2xtw7GzYHtLYZXOASnqMumKh0iCoOeKZs8NnU,11467
+pymud/protocol.py,sha256=QfDXjlg2OcJXmVoXf_3mAemnYotRXDUlEZNQjhkfXdA,49106
+pymud/pymud.py,sha256=N9WxaHDqqsTWIBG8UJ38gdMC_pQ30wphcN2LtT66eA4,49584
+pymud/session.py,sha256=BCmQljeEjWS6n35WTwmxMZBZenNTAoixaqcAjhTROGs,130095
+pymud/settings.py,sha256=CRNpHl4RjOuQYzAIWyUEvOo7q-f4lo01X1v_CriHWO4,7145
+pymud-0.20.0a4.dist-info/LICENSE.txt,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
+pymud-0.20.0a4.dist-info/METADATA,sha256=tDJ-Og3BTghz3zG6YwEKRnI6EwT083VHG5aeBeW_XCA,72291
+pymud-0.20.0a4.dist-info/WHEEL,sha256=Mdi9PDNwEZptOjTlUcAth7XJDFtKrHYaQMPulZeBCiQ,91
+pymud-0.20.0a4.dist-info/entry_points.txt,sha256=diPUOtTkhgC1hVny7Cdg4aRhaHSynMQoraE7ZhJxUcw,37
+pymud-0.20.0a4.dist-info/top_level.txt,sha256=8Gp1eXjxixXjqhhti6tLCspV_8s9sNV3z5Em2_KRhD4,6
+pymud-0.20.0a4.dist-info/RECORD,,

{pymud-0.20.0a3.dist-info → pymud-0.20.0a4.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (73.0.0)
+Generator: setuptools (73.0.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pymud-0.20.0a3.dist-info/RECORD

@@ -1,18 +0,0 @@
-pymud/__init__.py,sha256=hvX7Ga2xPG9J3ZpxBLrC6BvrzUo-Dj26HsRKf41Brhw,533
-pymud/__main__.py,sha256=hFzZjadLlcOuoLM7D8wFiFVO8mqF7vMuo9y-9xfIhRc,64
-pymud/dialogs.py,sha256=D0ZtCeoBchF5eYzXumkOi3p-maCQZu4v9-wJgxQ790o,6500
-pymud/extras.py,sha256=QwWwLavVtuXfg0Qb0f_040va1_kej27P-ZB_19HB6Qk,42422
-pymud/logger.py,sha256=elYfbpvmKYJfB-rnPYZWY5r8ROu9yja9t-dBi1faRGc,5358
-pymud/main.py,sha256=wpL1t88qcnYDq1vyguj2NOMpD9yVgZeuAJSMWEbDeiI,6532
-pymud/objects.py,sha256=0aUc-PZfVSdYPEAamY0eO6k3P9wJcw6PNxfSE8eZZeE,38072
-pymud/pkuxkx.py,sha256=vWXHU6GF0HQ0eWb3LmxFVRP0cKnigffCX7Z-LJvwVtw,11496
-pymud/protocol.py,sha256=QfDXjlg2OcJXmVoXf_3mAemnYotRXDUlEZNQjhkfXdA,49106
-pymud/pymud.py,sha256=N9WxaHDqqsTWIBG8UJ38gdMC_pQ30wphcN2LtT66eA4,49584
-pymud/session.py,sha256=Ea5pqFFMQ1NWct51g3LCWpyVzM83puFzLhdE7I4WEy4,129768
-pymud/settings.py,sha256=CRNpHl4RjOuQYzAIWyUEvOo7q-f4lo01X1v_CriHWO4,7145
-pymud-0.20.0a3.dist-info/LICENSE.txt,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
-pymud-0.20.0a3.dist-info/METADATA,sha256=rXogwgamQhQ1geFAq3eH-Vyi2m521g2vevHm9XEf3Rg,70341
-pymud-0.20.0a3.dist-info/WHEEL,sha256=nCVcAvsfA9TDtwGwhYaRrlPhTLV9m-Ga6mdyDtuwK18,91
-pymud-0.20.0a3.dist-info/entry_points.txt,sha256=diPUOtTkhgC1hVny7Cdg4aRhaHSynMQoraE7ZhJxUcw,37
-pymud-0.20.0a3.dist-info/top_level.txt,sha256=8Gp1eXjxixXjqhhti6tLCspV_8s9sNV3z5Em2_KRhD4,6
-pymud-0.20.0a3.dist-info/RECORD,,