From 60caee0f67c53a9b3280360712d5fad441fd6e6f Mon Sep 17 00:00:00 2001 From: Wang Zhiyu Date: Sat, 16 May 2026 23:59:25 +0800 Subject: [PATCH 1/5] =?UTF-8?q?docs:=20=E4=BF=AE=E6=94=B9=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 4 ++-- src/heurams/interface/__init__.py | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 8426096..49f0fd6 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ ## 概述 "潜进" (HeurAMS: Heuristic Auxiliary Memorizing Scheduler, 启发式记忆辅助调度器) 是一种基于启发式算法与认知科学理论的辅助记忆调度器, 旨在帮助用户更高效地进行记忆工作与学习规划, -也是一种开放, 优雅, 易于扩展的间隔重复调度器实验平台, 旨在帮助研究者更高效地进行前沿记忆算法的研究. +也是一种开放, 优雅, 易于扩展的间隔重复调度器实验平台, 旨在帮助研究者更高效地进行前沿记忆算法的调查实验与研究. [详细介绍](INTRODUCTION.md) [屏幕截图](SCREENSHOTS.md) @@ -18,7 +18,7 @@ ### 从包管理器安装 -潜进 (包名是 `heurams`) 处于早期开发考虑, 尚未上架 PyPI, 但您可以用 pip 支持的 git 协议安装稳定版和开发版本, 这要求您的电脑上安装了 python 环境 (建议版本 3.12.13 及之后). +潜进 (包名是 `heurams`) 处于早期开发考虑, 尚未上架 PyPI, 但您可以用 pip 支持的 git 协议安装稳定版和开发版本, 这要求您的电脑上安装了 python 环境 (建议 3.12.13 及之后版本). #### 面向用户的安装 diff --git a/src/heurams/interface/__init__.py b/src/heurams/interface/__init__.py index 5d55e74..81079cc 100644 --- a/src/heurams/interface/__init__.py +++ b/src/heurams/interface/__init__.py @@ -72,9 +72,8 @@ class HeurAMSApp(App): ) -> None: # 用来给没使用/禁用的快捷键占位, 因为 Binding 删除不了 pass - # 移除烦人的 "rich traceback" - # Textual 官方不会管这破事, 写 Rich 写入脑了导致的 - # 不知道哪来的自信改标准库的 traceback +''' + # 移除烦人的 "rich traceback", 但可能导致未定义行为出现, 所以注释掉 # https://github.com/Textualize/textual/discussions/6255 # NOTE: 进行 textual 版本升级时, 确保查看过上游代码, 尤其是 App 的 _exception # 如果行为变了就把下面的删了 (虽然有 fallback) @@ -89,3 +88,4 @@ class HeurAMSApp(App): self._close_messages_no_wait() raise self._exception super().panic(*args) # ditto +''' \ No newline at end of file From 29186622223f98940e4af011887b599d54559df1 Mon Sep 17 00:00:00 2001 From: Wang Zhiyu Date: Sun, 17 May 2026 00:01:09 +0800 Subject: [PATCH 2/5] =?UTF-8?q?docs:=20=E4=BF=AE=E6=94=B9=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 49f0fd6..4c9614e 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,7 @@ pip install --upgrade 'heurams[basic] @ https://git.pluv27.top/pluv/HeurAMS/arch 从较前沿, 大致稳定的 `dev` 分支安装, 并安装适用于用户体验的可选依赖(如果您追求较前沿的改进): ``` -pip install --upgrade 'heurams[basic] @ https://git.pluv27.top/pluv/HeurAMS/archive/dev.zip' +pip install --force-reinstall 'heurams[basic] @ https://git.pluv27.top/pluv/HeurAMS/archive/dev.zip' ``` 安装适用于一般计算机的通用音频模块(基于 playsound3):\ @@ -52,7 +52,7 @@ pip install --upgrade 'heurams[audio-playsound] @ https://git.pluv27.top/pluv/He 从 `dev` 分支进行基于 git 的可编辑安装, 并安装全部可选依赖(推荐): ``` -pip install --upgrade 'heurams[all] @ https://git.pluv27.top/pluv/HeurAMS/archive/dev.zip' +pip install --force-reinstall 'heurams[all] @ https://git.pluv27.top/pluv/HeurAMS/archive/dev.zip' ``` > 您也可以从 `refactor/...` 等特定分支安装 From dc8fa36a28539bd631ff49b386c84a0d68fcac14 Mon Sep 17 00:00:00 2001 From: Wang Zhiyu Date: Sun, 17 May 2026 00:05:04 +0800 Subject: [PATCH 3/5] =?UTF-8?q?fix:=20=E4=BF=AE=E5=A4=8D=20zmq=20=E4=BE=9D?= =?UTF-8?q?=E8=B5=96=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 4 ++-- src/heurams/interface/__main__.py | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 4c9614e..eddd1c1 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,7 @@ pip install --upgrade 'heurams[basic] @ https://git.pluv27.top/pluv/HeurAMS/arch 从较前沿, 大致稳定的 `dev` 分支安装, 并安装适用于用户体验的可选依赖(如果您追求较前沿的改进): ``` -pip install --force-reinstall 'heurams[basic] @ https://git.pluv27.top/pluv/HeurAMS/archive/dev.zip' +pip install --force-reinstall --no-deps 'heurams[basic] @ https://git.pluv27.top/pluv/HeurAMS/archive/dev.zip' ``` 安装适用于一般计算机的通用音频模块(基于 playsound3):\ @@ -52,7 +52,7 @@ pip install --upgrade 'heurams[audio-playsound] @ https://git.pluv27.top/pluv/He 从 `dev` 分支进行基于 git 的可编辑安装, 并安装全部可选依赖(推荐): ``` -pip install --force-reinstall 'heurams[all] @ https://git.pluv27.top/pluv/HeurAMS/archive/dev.zip' +pip install --force-reinstall --no-deps 'heurams[all] @ https://git.pluv27.top/pluv/HeurAMS/archive/dev.zip' ``` > 您也可以从 `refactor/...` 等特定分支安装 diff --git a/src/heurams/interface/__main__.py b/src/heurams/interface/__main__.py index 519b211..6fac725 100644 --- a/src/heurams/interface/__main__.py +++ b/src/heurams/interface/__main__.py @@ -2,13 +2,13 @@ from heurams.interface import * from heurams.context import config_var from heurams.services.logger import get_logger import threading -import zmq import pickle logger = get_logger(__name__) def start_debug_server(app): + import zmq logger = get_logger("zmq_debug") context = zmq.Context() socket = context.socket(zmq.REP) From b0625ef636d55473576cb0ba5eb9c2e083c6e184 Mon Sep 17 00:00:00 2001 From: Wang Zhiyu Date: Sun, 17 May 2026 00:07:12 +0800 Subject: [PATCH 4/5] =?UTF-8?q?fix:=20=E4=BF=AE=E5=A4=8D=20playsound3=20?= =?UTF-8?q?=E4=BE=9D=E8=B5=96=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/heurams/providers/audio/playsound_audio.py | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/src/heurams/providers/audio/playsound_audio.py b/src/heurams/providers/audio/playsound_audio.py index e6b438d..9cbeecd 100644 --- a/src/heurams/providers/audio/playsound_audio.py +++ b/src/heurams/providers/audio/playsound_audio.py @@ -5,8 +5,6 @@ import pathlib -import playsound3 - from heurams.services.logger import get_logger logger = get_logger(__name__) @@ -15,6 +13,7 @@ logger = get_logger(__name__) def play_by_path(path: pathlib.Path): logger.debug("playsound_audio.play_by_path: 开始播放 %s", path) try: + import playsound3 playsound3.playsound(str(path)) logger.debug("播放完成: %s", path) except Exception as e: From 3d113f2eaaed1de78ac8952980bbc7fd972d679d Mon Sep 17 00:00:00 2001 From: Wang Zhiyu Date: Sun, 17 May 2026 00:22:01 +0800 Subject: [PATCH 5/5] =?UTF-8?q?feat:=20=E6=94=B9=E8=BF=9B=E5=91=BD?= =?UTF-8?q?=E4=BB=A4=E8=A1=8C=E5=85=A5=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/heurams/__main__.py | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/src/heurams/__main__.py b/src/heurams/__main__.py index 75ca5d4..2dcb46c 100644 --- a/src/heurams/__main__.py +++ b/src/heurams/__main__.py @@ -1,19 +1,23 @@ +import platform + import click from heurams.services.version import ver, stage, codename, codename_cn @click.group( invoke_without_command=True, + help=( + f"HeurAMS {ver} - 启发式辅助记忆调度器" + ), context_settings={"help_option_names": ["-h", "--help"]}, ) @click.version_option( ver, "-v", "--version", prog_name="HeurAMS", - message=f"%(prog)s %(version)s ({codename}/{codename_cn}), 阶段: {stage}", + message=f"%(prog)s %(version)s {stage} ({codename}/{codename_cn}), {platform.system()}", ) @click.pass_context def cli(ctx): - """HeurAMS - 启发式辅助记忆调度器""" if ctx.invoked_subcommand is None: click.echo(cli.get_help(ctx)) ctx.exit(0)