fix: 总体体验改进与版本号变更

src/heurams/assets/art/logo-mono-dark.svg

@@ -0,0 +1,25 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="100%" height="100%" viewBox="0 0 554.4 554.4" version="1.1">
+  <defs>
+    <style type="text/css">*{stroke-linejoin: round; stroke-linecap: butt}</style>
+  </defs>
+  <title>HeurAMS Monochrome Logo - Dark</title>
+  <desc>Dark monochrome logo of the HeurAMS Project</desc>
+  <g id="figure_1">
+    <g id="patch_1">
+      <path d="M 0 554.4 L 554.4 554.4 L 554.4 0 L 0 0 L 0 554.4 z" style="fill: none"/>
+    </g>
+    <g id="axes_1">
+      <g id="patch_2">
+        <path d="M 66.528 487.872 L 199.584 487.872 L 199.584 354.816 L 66.528 354.816 z" clip-path="url(#p4da876c7a0)" style="fill: #1A1A1A; stroke: #1A1A1A; stroke-linejoin: miter"/>
+      </g>
+      <g id="patch_3">
+        <path d="M 199.584 354.816 L 487.872 354.816 L 487.872 66.528 L 199.584 66.528 z" clip-path="url(#p4da876c7a0)" style="fill: #1A1A1A; stroke: #1A1A1A; stroke-linejoin: miter"/>
+      </g>
+    </g>
+  </g>
+  <defs>
+    <clipPath id="p4da876c7a0">
+      <rect x="0" y="0" width="554.4" height="554.4"/>
+    </clipPath>
+  </defs>
+</svg>

src/heurams/assets/art/logo-mono-light.svg

@@ -0,0 +1,25 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="100%" height="100%" viewBox="0 0 554.4 554.4" version="1.1">
+  <defs>
+    <style type="text/css">*{stroke-linejoin: round; stroke-linecap: butt}</style>
+  </defs>
+  <title>HeurAMS Monochrome Logo - Light</title>
+  <desc>Light monochrome logo of the HeurAMS Project</desc>
+  <g id="figure_1">
+    <g id="patch_1">
+      <path d="M 0 554.4 L 554.4 554.4 L 554.4 0 L 0 0 L 0 554.4 z" style="fill: none"/>
+    </g>
+    <g id="axes_1">
+      <g id="patch_2">
+        <path d="M 66.528 487.872 L 199.584 487.872 L 199.584 354.816 L 66.528 354.816 z" clip-path="url(#p4da876c7a0)" style="fill: #ffffff; stroke: #ffffff; stroke-linejoin: miter"/>
+      </g>
+      <g id="patch_3">
+        <path d="M 199.584 354.816 L 487.872 354.816 L 487.872 66.528 L 199.584 66.528 z" clip-path="url(#p4da876c7a0)" style="fill: #ffffff; stroke: #ffffff; stroke-linejoin: miter"/>
+      </g>
+    </g>
+  </g>
+  <defs>
+    <clipPath id="p4da876c7a0">
+      <rect x="0" y="0" width="554.4" height="554.4"/>
+    </clipPath>
+  </defs>
+</svg>

src/heurams/assets/art/logo.svg

@@ -0,0 +1,25 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="100%" height="100%" viewBox="0 0 554.4 554.4" version="1.1">
+  <defs>
+    <style type="text/css">*{stroke-linejoin: round; stroke-linecap: butt}</style>
+  </defs>
+  <title>HeurAMS Logo</title>
+  <desc>The logo of the HeurAMS Project</desc>
+  <g id="figure_1">
+    <g id="patch_1">
+      <path d="M 0 554.4 L 554.4 554.4 L 554.4 0 L 0 0 L 0 554.4 z" style="fill: none"/>
+    </g>
+    <g id="axes_1">
+      <g id="patch_2">
+        <path d="M 66.528 487.872 L 199.584 487.872 L 199.584 354.816 L 66.528 354.816 z" clip-path="url(#p4da876c7a0)" style="fill: #1660a5; stroke: #1660a5; stroke-linejoin: miter"/>
+      </g>
+      <g id="patch_3">
+        <path d="M 199.584 354.816 L 487.872 354.816 L 487.872 66.528 L 199.584 66.528 z" clip-path="url(#p4da876c7a0)" style="fill: #545f70; stroke: #545f70; stroke-linejoin: miter"/>
+      </g>
+    </g>
+  </g>
+  <defs>
+    <clipPath id="p4da876c7a0">
+      <rect x="0" y="0" width="554.4" height="554.4"/>
+    </clipPath>
+  </defs>
+</svg>

src/heurams/assets/data/config/_.toml

@@ -0,0 +1,5 @@
+_services_desc = '服务模块设置'
+_providers_desc = '驱动模块设置'
+_repo_desc = '单元集独立设置'
+_interface_desc = '基本用户界面设置'
+_global_desc = '底层设置'

src/heurams/assets/data/config/global.toml

@@ -0,0 +1,21 @@
+zmq_debug = true
+_zmq_debug_desc = "[调试] ZeroMQ 调试服务器, 这会在 zmq_debug_port 上打开一个服务器\n调试工具可远程在 HeurAMS 内执行任意 python 代码, 无必要请关闭"
+zmq_debug_port = 5555
+_zmq_debug_port_desc = "[调试] ZeroMQ 调试服务器端口"
+enable_built_in_interface = true
+_enable_built_in_interface_desc = "启用内置基本用户界面\n(当且仅当 HeurAMS 作为程序库时禁用, 以跳过用户界面逻辑)"
+_paths_desc = "用户数据路径定义"
+
+[paths]
+data = "./data"
+_data_desc = "用户数据根目录"
+cache = "./data/cache"
+_cache_desc = "缓存根目录\n(如音频缓存在 voice 子目录)"
+config = "./data/config"
+_config_desc = "配置文件根目录"
+repo = "./data/repo"
+_repo_desc = "记忆单元集根目录"
+misc = "./data/misc"
+_misc_desc = "扩展程序和 whisper 等模块的数据存储根目录"
+_addons = "./data/addons"
+__addons_desc = "扩展程序根目录"

src/heurams/assets/data/config/interface/_.toml

@@ -0,0 +1,4 @@
+_global_desc = "用户界面通用设置"
+_widgets_desc = "组件设置"
+_screens_desc = "界面设置"
+_puzzles_desc = "谜题生成器设置"

src/heurams/assets/data/config/interface/global.toml

@@ -0,0 +1,25 @@
+show_header = true
+_show_header_desc = "展示界面顶部的标题栏\n如果您想节省这一行空间, 可以禁用它"
+clock_on_header = true
+_clock_on_header_desc = "在界面顶部的标题栏显示时间"
+change_window_title = true
+_change_window_title_desc = "更改终端模拟器窗口的标题\n如果禁用了 header, 则建议启用"
+persist_to_file = true
+_persist_to_file_desc = "[调试] 将记忆更改保存到文件"
+quick_pass = true
+_quick_pass_desc = "[调试] 启用快速应答功能(跳过测验)"
+auto_pass = false
+_auto_pass_desc = "[调试] 自动通过测试模式"
+scheduled_num = 420
+_scheduled_num_desc = "默认记忆单元数量\n可被单元集设置覆盖"
+refresh_on_resume = true
+_refresh_on_resume_desc = "[调试] 每当 Screen 激活后都刷新状态"
+algorithm = "SM-2"
+_algorithm_desc = "默认记忆调度算法\n可被单元集设置覆盖"
+
+[_algorithm_candidate]
+NSP-0 = "筛选用非间隔重复调度器"
+none = "不设置默认调度器"
+SM-2 = "第二代 SuperMemo 简单间隔重复调度器\nWozniak 于 1987 年提出, Anki 的默认算法"
+SM-15M = "类第15代 SuperMemo 复杂间隔重复调度器\n不稳定且逆向工程"
+FSRS = "先进开放间隔重复调度器"

src/heurams/assets/data/config/interface/puzzles/_.toml

@@ -0,0 +1,2 @@
+_cloze_desc = "填空题"
+_mcq_desc = "选择题"

src/heurams/assets/data/config/interface/puzzles/cloze.toml

@@ -0,0 +1,2 @@
+min_denominator = " 1"
+_min_denominator_desc = "设空比例系数的倒数"

src/heurams/assets/data/config/interface/puzzles/mcq.toml

@@ -0,0 +1,2 @@
+max_riddles_num = "2"
+_max_riddles_num_desc = "单次生成的最大谜题数量"

src/heurams/assets/data/config/interface/widgets/_.toml

@@ -0,0 +1 @@
+_recognition_desc = "用于 '辨识' 组件的设置"

src/heurams/assets/data/config/interface/widgets/recognition.toml

@@ -0,0 +1,2 @@
+autovoice = true
+_autovoice_desc = "自动语音播放"

src/heurams/assets/data/config/providers/_.toml

@@ -0,0 +1 @@
+_tts_desc = '文本转语音驱动'

src/heurams/assets/data/config/providers/tts/_.toml

@@ -0,0 +1 @@
+_edgetts_desc = "微软文本转语音驱动"

src/heurams/assets/data/config/providers/tts/edgetts.toml

@@ -0,0 +1,25 @@
+voice = "zh-CN-XiaoxiaoNeural"
+_voice_desc = "音色"
+
+[_voice_candidate]
+zh-CN-XiaoxiaoNeural = "晓晓: 中文温柔女声"
+zh-CN-XiaoyiNeural = "晓伊: 中文甜美女声"
+zh-CN-XiaochenNeural = "晓辰: 中文知性女声"
+zh-CN-XiaohanNeural = "晓涵: 中文优雅女声"
+zh-CN-XiaomengNeural = "晓梦: 中文梦幻女声"
+zh-CN-XiaomoNeural = "晓墨: 中文文艺女声"
+zh-CN-XiaoqiuNeural = "晓秋: 中文成熟女声"
+zh-CN-XiaoruiNeural = "晓睿: 中文智慧女声"
+zh-CN-XiaoshuangNeural = "晓双: 中文活泼女声"
+zh-CN-XiaoxuanNeural = "晓萱: 中文清新女声"
+zh-CN-XiaoyanNeural = "晓颜: 中文柔美女声"
+zh-CN-XiaoyouNeural = "晓悠: 中文悠扬女声"
+zh-CN-XiaozhenNeural = "晓甄: 中文端庄女声"
+zh-CN-YunxiNeural = "云希: 中文清朗男声"
+zh-CN-YunyangNeural = "云扬: 中文阳光男声"
+zh-CN-YunjianNeural = "云健: 中文稳重男声"
+zh-CN-YunfengNeural = "云枫: 中文磁性男声"
+zh-CN-YunhaoNeural = "云皓: 中文豪迈男声"
+zh-CN-YunxiaNeural = "云夏: 中文热情男声"
+zh-CN-YunyeNeural = "云野: 中文野性男声"
+zh-CN-YunzeNeural = "云泽: 中文深沉男声"

src/heurams/assets/data/config/repo/_.toml

@@ -0,0 +1,2 @@
+_cngk-t_desc = "高考必备古诗文-测试"
+_cngk_desc = "高考必备古诗文"

src/heurams/assets/data/config/repo/cngk-t.toml

@@ -0,0 +1,11 @@
+algorithm = "NSP-0"
+_algorithm_desc = "记忆调度算法"
+scheduled_num = 35
+_scheduled_num_desc = "单次记忆单元数量"
+
+[_algorithm_candidate]
+NSP-0 = "筛选用非间隔重复调度器"
+none = "不设置默认调度器"
+SM-2 = "第二代 SuperMemo 简单间隔重复调度器"
+SM-15M = "第15代 SuperMemo 复杂间隔重复调度器 (不稳定且逆向工程)"
+FSRS = "先进开放间隔重复调度器"

src/heurams/assets/data/config/repo/cngk.toml

@@ -0,0 +1,11 @@
+algorithm = "NSP-0"
+_algorithm_desc = "记忆调度算法"
+scheduled_num = 35
+_scheduled_num_desc = "单次记忆单元数量"
+
+[_algorithm_candidate]
+NSP-0 = "筛选用非间隔重复调度器"
+none = "不设置默认调度器"
+SM-2 = "第二代 SuperMemo 简单间隔重复调度器"
+SM-15M = "第15代 SuperMemo 复杂间隔重复调度器 (不稳定且逆向工程)"
+FSRS = "先进开放间隔重复调度器"

src/heurams/assets/data/config/services/_.toml

@@ -0,0 +1,5 @@
+_audio_desc = '音频服务'
+_llm_desc = '语言模型服务'
+_sync_desc = '数据同步服务'
+_timer_desc = '时间服务'
+_tts_desc = '文本转语音服务'

src/heurams/assets/data/config/services/audio.toml

@@ -0,0 +1,9 @@
+provider = "playsound"
+_provider_desc = "音频驱动类型"
+
+[_provider_candidate]
+playsound = "Python 桌面跨平台音频系统, 使用了 playsound3 替代了老旧的 playsound"
+termux = "Android Termux 音频系统"
+mpg123 = "通用音频系统, 依赖系统 mpg123"
+pulseaudio = "高级音频路由系统"
+none = "不使用音频"

src/heurams/assets/data/config/services/llm.toml

@@ -0,0 +1,6 @@
+provider = "openai"
+_provider_desc = "模型接口类型"
+
+[_provider_candidate]
+openai = "OpenAI 风格 API, 同时支持与其相容的模型服务 (如 deepseek)"
+none = "不使用语言大模型"

src/heurams/assets/data/config/services/sync.toml

@@ -0,0 +1,7 @@
+provider = "webdav"
+_provider_desc = "同步服务驱动类型"
+
+[_provider_candidate]
+webdav = "WebDAV 兼容网络文件系统 (包括 webdavs)"
+official = "官方同步服务器"
+none = "不使用同步服务器"

src/heurams/assets/data/config/services/timer.toml

@@ -0,0 +1,6 @@
+daystamp_override = -1
+_daystamp_override_desc = "[调试] 覆写 UNIX 日时间戳, 单位为日\n(设为 -1 禁用)"
+timestamp_override = -1
+_timestamp_override_desc = "[调试] 覆写 UNIX 时间戳, 单位为秒\n(设为 -1 禁用)"
+timezone_offset = 28800
+_timezone_offset_desc = "时区偏移设置, 用于取消跨天时区误差, 单位为秒\n(如 28800 为 UTC+8.0, 中国标准时间)"

src/heurams/assets/data/config/services/tts.toml

@@ -0,0 +1,7 @@
+provider = "edgetts"
+_provider_desc = "文本转语音驱动类型"
+
+[_provider_candidate]
+edgetts = "微软神经网络语音合成, 依赖微软网络服务"
+espeak = "低保真度本地语音合成"
+none = "不使用文本转语音"

src/heurams/context.py

@@ -22,7 +22,14 @@ logger = get_logger(__name__)
 logger.debug(f"包目录: {rootdir}")
 logger.debug(f"工作目录: {workdir}")
 
-(workdir / "data" / "config").mkdir(parents=True, exist_ok=True)
+default_data = rootdir / "assets" / "data"
+user_data = workdir / "data"
+if not user_data.exists():
+    logger.info("初始化数据目录: %s", user_data)
+    import shutil
+    shutil.copytree(default_data, user_data)
+else:
+    (workdir / "data" / "config").mkdir(parents=True, exist_ok=True)
 
 config_var: ContextVar[ConfigDict] = ContextVar(
     "config_var",

src/heurams/services/version.py

@@ -4,7 +4,7 @@ from heurams.services.logger import get_logger
 logger = get_logger(__name__)
 
 ver = "0.5.0"
-stage = "rc.1"
+stage = "stable"
 codename = "fulcrum"
 codename_cn = "支点"