feat(interface): 改进界面

feat(interface): 改进仪表盘
fix: 修复若干问题
2026-01-28 03:35:58 +08:00 · 2026-01-22 06:13:01 +08:00 · 2026-01-17 05:45:45 +08:00 · 2026-01-15 12:49:57 +08:00 · 2026-01-13 23:39:10 +08:00 · 2026-01-09 00:47:34 +08:00
56 changed files with 3976 additions and 649 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -5,22 +5,18 @@
 __pycache__/
 .idea/
 cache/
-#nucleon/test.toml
-electron/test.toml
+data/repo/cngk
+data/repo/eotgk
+data/repo/evtgk
 *.egg-info/
 build/
 dist/
 old/
-# config/
 data/cache/
-data/electron/
-data/nucleon/
 data/global/
-!data/nucleon/TEST*
-data/orbital/
 config/config_dev.toml
 AGENTS.md
-*.log.1
+*.log.*

 # Byte-compiled / optimized / DLL files
 __pycache__/
--- a/.python-version
+++ b/.python-version
@@ -0,0 +1 @@
+3.12
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -3,22 +3,23 @@
 欢迎为此项目做出贡献!  
 本项目是一个开源项目, 我们鼓励社区成员参与改进.

-## 开发流程
+## 开发规范

-1. **分支划分**: 
+1. 分支划分: 
   - `main` 分支: 稳定版本
   - `dev` 分支: 开发版本
   - 功能分支: 从 `dev` 分支创建, 命名格式为 `feature/描述` 或 `fix/描述` 或 `refactor/描述`
-2. **代码风格**: 
-   - 请使用 Black 与 isort 格式化代码
+2. 代码风格: 
+   - 请使用 Black 格式化代码
   - 遵循 PEP 8 规范
   - 添加适当的文档字符串  
-3. **提交消息**: 
+3. 提交消息: 
   - 使用简体中文或英文撰写清晰的提交消息
   - 格式: 遵循 Conventional Commits 规范
-4. **合并方式**:
+4. 合并方式:
   - 不使用 Fast-forward 合并
   - 可以设置 `git config merge.ff false`
+
 ## 设置开发环境

 ```bash
--- a/data/config/config.toml
+++ b/data/config/config.toml
@@ -6,7 +6,10 @@ daystamp_override = -1
 timestamp_override = -1

 # [调试] 一键通过
-quick_pass = 1
+quick_pass = true
+
+# [调试] 自动化测试模式(仅用于测试完整性)
+auto_pass = false

 # 对于每个项目的默认新记忆原子数量
 scheduled_num = 8
@@ -17,7 +20,7 @@ timezone_offset = +28800 # 中国标准时间 (UTC+8)
 [interface]

 [interface.memorizor]
-autovoice = true # 自动语音播放, 仅限于 recognition 组件
+autovoice = false # 自动语音播放, 仅限于 recognition 组件

 [algorithm]
 default = "SM-2" # 主要算法; 可选项: SM-2, SM-15M, FSRS
--- a/examples/data/config/config.toml
+++ b/examples/data/config/config.toml
@@ -1,56 +0,0 @@
-# [调试] 将更改保存到文件
-persist_to_file = 1
-
-# [调试] 覆写时间, 设为 -1 以禁用
-daystamp_override = -1
-timestamp_override = -1
-
-# [调试] 一键通过
-quick_pass = 1
-
-# 对于每个项目的默认新记忆原子数量
-scheduled_num = 8
-
-# UTC 时间戳修正 仅用于 UNIX 日时间戳的生成修正, 单位为秒
-timezone_offset = +28800 # 中国标准时间 (UTC+8)
-
-[interface]
-
-[interface.memorizor]
-autovoice = true # 自动语音播放, 仅限于 recognition 组件
-
-[algorithm]
-default = "SM-2" # 主要算法; 可选项: SM-2, SM-15M, FSRS
-
-[puzzles] # 谜题默认配置
-
-[puzzles.mcq]
-max_riddles_num = 2
-
-[puzzles.cloze]
-min_denominator = 3
-
-[paths] # 相对于配置文件的 ".." (即工作目录) 而言 或绝对路径
-data = "./data"
-
-[services] # 定义服务到提供者的映射
-audio = "playsound" # 可选项: playsound(通用), termux(仅用于支持 Android Termux), mpg123(TODO)
-tts = "edgetts" # 可选项: edgetts
-llm = "openai" # 可选项: openai
-sync = "webdav" # 可选项: 留空, webdav
-
-[providers.tts.edgetts] # EdgeTTS 设置
-voice = "zh-CN-XiaoxiaoNeural" # 可选项: zh-CN-YunjianNeural (男声), zh-CN-XiaoxiaoNeural (女声)
-
-[providers.llm.openai] # 与 OpenAI 相容的语言模型接口服务设置
-url = ""
-key = ""
-
-[providers.sync.webdav] # WebDAV 同步设置
-url = ""
-username = ""
-password = ""
-remote_path = "/heurams/"
-verify_ssl = true
-
-[sync]
--- a/examples/repo.ipynb
+++ b/examples/repo.ipynb
@@ -6,7 +6,8 @@
   "metadata": {},
   "source": [
    "# 演练场\n",
-    "此笔记本将带你了解 repomgr 与 particles 对象相关操作"
+    "此笔记本将带你了解 repomgr 与 particles 对象相关操作  \n",
+    "此笔记本内含的系统命令默认仅存在于 Linux 操作系统, 如果你使用 Windows, 请在安装 busybox 或 cygwin 或 WSL 的环境下执行此笔记本"
   ]
  },
  {
@@ -21,7 +22,7 @@
  },
  {
   "cell_type": "code",
-   "execution_count": 1,
+   "execution_count": 29,
   "id": "a5ed9864",
   "metadata": {},
   "outputs": [
@@ -30,7 +31,12 @@
     "output_type": "stream",
     "text": [
      "\u001b[01;34m.\u001b[0m\n",
+      "├── \u001b[01;34mdata\u001b[0m\n",
+      "│   └── \u001b[01;34mconfig\u001b[0m\n",
+      "│       └── \u001b[00mconfig.toml\u001b[0m\n",
+      "├── \u001b[00mjiebatest.py\u001b[0m\n",
      "├── \u001b[00mrepo.ipynb\u001b[0m\n",
+      "├── \u001b[00msimplemem.py\u001b[0m\n",
      "└── \u001b[01;34mtest_repo\u001b[0m\n",
      "    ├── \u001b[00malgodata.json\u001b[0m\n",
      "    ├── \u001b[00mmanifest.toml\u001b[0m\n",
@@ -38,7 +44,7 @@
      "    ├── \u001b[00mschedule.toml\u001b[0m\n",
      "    └── \u001b[00mtypedef.toml\u001b[0m\n",
      "\n",
-      "2 directories, 6 files\n"
+      "4 directories, 9 files\n"
     ]
    }
   ],
@@ -56,7 +62,7 @@
  },
  {
   "cell_type": "code",
-   "execution_count": 2,
+   "execution_count": 30,
   "id": "9777730e",
   "metadata": {},
   "outputs": [
@@ -85,21 +91,10 @@
  },
  {
   "cell_type": "code",
-   "execution_count": 3,
+   "execution_count": 31,
   "id": "bf1b00c8",
   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "欢迎使用 HeurAMS 及其组件!\n",
-      "rootdir: /mnt/data/Devel/HeurAMS/HeurAMS/src/heurams\n",
-      "workdir: /mnt/data/Devel/HeurAMS/HeurAMS/examples\n",
-      "未能加载自定义用户配置\n"
-     ]
-    }
-   ],
+   "outputs": [],
   "source": [
    "import heurams.kernel.repolib as repolib  # 这是 RepoLib 子模块, 用于管理和结构化 repo(中文含义: 仓库) 数据结构与本地文件间的联系\n",
    "import heurams.kernel.particles as pt  # 这是 Particles(中文含义: 粒子) 子模块, 用于运行时的记忆管理操作\n",
@@ -120,7 +115,7 @@
  },
  {
   "cell_type": "code",
-   "execution_count": 4,
+   "execution_count": 32,
   "id": "897b62d7",
   "metadata": {},
   "outputs": [
@@ -148,7 +143,7 @@
  },
  {
   "cell_type": "code",
-   "execution_count": 5,
+   "execution_count": 33,
   "id": "708ae7e4",
   "metadata": {},
   "outputs": [],
@@ -169,7 +164,7 @@
  },
  {
   "cell_type": "code",
-   "execution_count": 6,
+   "execution_count": 34,
   "id": "a11115fb",
   "metadata": {},
   "outputs": [
@@ -177,20 +172,20 @@
     "name": "stdout",
     "output_type": "stream",
     "text": [
-      "{'algodata': [('君臣固守以窥周室,', {}), ('秦孝公据崤函之固, 拥雍州之地,', {})],\n",
+      "{'algodata': [('秦孝公据崤函之固, 拥雍州之地,', {}), ('君臣固守以窥周室,', {})],\n",
      " 'manifest': {'author': '__heurams__',\n",
      "              'desc': '高考古诗文: 过秦论',\n",
      "              'title': '测试单元: 过秦论'},\n",
-      " 'payload': [('君臣固守以窥周室,',\n",
-      "              {'content': '君臣/固守/以窥/周室,/',\n",
-      "               'keyword_note': {'窥': '窥视'},\n",
-      "               'note': [],\n",
-      "               'translation': '君臣牢固地守卫着，借以窥视周王室的权力，'}),\n",
-      "             ('秦孝公据崤函之固, 拥雍州之地,',\n",
+      " 'payload': [('秦孝公据崤函之固, 拥雍州之地,',\n",
      "              {'content': '秦孝公/据/崤函/之固/, 拥/雍州/之地,/',\n",
      "               'keyword_note': {'崤函': '崤山和函谷关', '据': '占据', '雍州': '古代九州之一'},\n",
      "               'note': [],\n",
-      "               'translation': '秦孝公占据着崤山和函谷关的险固地势，拥有雍州的土地，'})],\n",
+      "               'translation': '秦孝公占据着崤山和函谷关的险固地势，拥有雍州的土地，'}),\n",
+      "             ('君臣固守以窥周室,',\n",
+      "              {'content': '君臣/固守/以窥/周室,/',\n",
+      "               'keyword_note': {'窥': '窥视'},\n",
+      "               'note': [],\n",
+      "               'translation': '君臣牢固地守卫着，借以窥视周王室的权力，'})],\n",
      " 'schedule': {'phases': {'final_review': [['FillBlank', '0.7'],\n",
      "                                          ['SelectMeaning', '0.7'],\n",
      "                                          ['Recognition', '1.0']],\n",
@@ -207,10 +202,9 @@
      "                            'translation': '语句翻译',\n",
      "                            'tts_text': '文本转语音文本'},\n",
      "             'common': {'delimiter': '/',\n",
-      "                        'tts_text': \"eval:payload['content'].replace('/', '')\"},\n",
      "                        'puzzles': {'FillBlank': {'__hint__': '',\n",
      "                                                  '__origin__': 'cloze',\n",
-      "                                       'delimiter': \"eval:metadata['formation']['delimiter']\",\n",
+      "                                                  'delimiter': \"eval:nucleon['delimiter']\",\n",
      "                                                  'min_denominator': \"eval:default['cloze']['min_denominator']\",\n",
      "                                                  'text': \"eval:payload['content']\"},\n",
      "                                    'Recognition': {'__hint__': '',\n",
@@ -226,7 +220,8 @@
      "                                                      'max_riddles_num': \"eval:default['mcq']['max_riddles_num']\",\n",
      "                                                      'prefix': '选择正确项: ',\n",
      "                                                      'primary': \"eval:payload['content']\"}},\n",
-      "             '古文句': {}}}\n"
+      "                        'tts_text': \"eval:payload['content'].replace('/', \"\n",
+      "                                    \"'')\"}}}\n"
     ]
    }
   ],
@@ -255,13 +250,13 @@
    "- save_list: 默认为 [\"algodata\"], 是要持久化的数据.\n",
    "- source: 默认为原目录, 你也可以手动指定为其他文件夹(通过 Path)\n",
    "\n",
-    "现在做一些演练, 我们将创建一个位于 test_new_repo 的\"克隆\", 此时我们!\n",
+    "现在做一些演练, 我们将创建一个位于 test_new_repo 的\"克隆\".  \n",
    "除非文件夹已经存在, Repo 对象将会为你自动创建新文件夹."
   ]
  },
  {
   "cell_type": "code",
-   "execution_count": 7,
+   "execution_count": 35,
   "id": "05eeaacc",
   "metadata": {},
   "outputs": [
@@ -270,8 +265,12 @@
     "output_type": "stream",
     "text": [
      "\u001b[01;34m.\u001b[0m\n",
-      "├── \u001b[00mheurams.log\u001b[0m\n",
+      "├── \u001b[01;34mdata\u001b[0m\n",
+      "│   └── \u001b[01;34mconfig\u001b[0m\n",
+      "│       └── \u001b[00mconfig.toml\u001b[0m\n",
+      "├── \u001b[00mjiebatest.py\u001b[0m\n",
      "├── \u001b[00mrepo.ipynb\u001b[0m\n",
+      "├── \u001b[00msimplemem.py\u001b[0m\n",
      "├── \u001b[01;34mtest_new_repo\u001b[0m\n",
      "│   ├── \u001b[00malgodata.json\u001b[0m\n",
      "│   ├── \u001b[00mmanifest.toml\u001b[0m\n",
@@ -285,7 +284,7 @@
      "    ├── \u001b[00mschedule.toml\u001b[0m\n",
      "    └── \u001b[00mtypedef.toml\u001b[0m\n",
      "\n",
-      "3 directories, 12 files\n"
+      "5 directories, 14 files\n"
     ]
    }
   ],
@@ -327,7 +326,7 @@
  },
  {
   "cell_type": "code",
-   "execution_count": 8,
+   "execution_count": 36,
   "id": "7e88bd7c",
   "metadata": {},
   "outputs": [
@@ -335,13 +334,13 @@
     "name": "stdout",
     "output_type": "stream",
     "text": [
-      "[('age', 12), ('enemy', 'jerry'), ('name', 'tom')]\n",
-      "[('age', 12), ('enemy', 'jerry'), ('name', 'tom')]\n"
+      "[('name', 'tom'), ('age', 12), ('enemy', 'jerry')]\n",
+      "[('name', 'tom'), ('age', 12), ('enemy', 'jerry')]\n"
     ]
    }
   ],
   "source": [
-    "from heurams.utils.lict import Lict\n",
+    "from heurams.kernel.auxiliary.lict import Lict\n",
    "\n",
    "lct = Lict()  # 空的\n",
    "lct = Lict(initlist=[(\"name\", \"tom\"), (\"age\", 12), (\"enemy\", \"jerry\")])  # 基于列表\n",
@@ -356,13 +355,13 @@
   "metadata": {},
   "source": [
    "### 输出形式\n",
-    "lct 的\"官方\"输出形式是列表形式\n",
+    "Lict 的\"官方\"输出形式是列表形式\n",
    "你也可以选择输出字典形式"
   ]
  },
  {
   "cell_type": "code",
-   "execution_count": 9,
+   "execution_count": 37,
   "id": "248f6cba",
   "metadata": {},
   "outputs": [
@@ -392,7 +391,7 @@
  },
  {
   "cell_type": "code",
-   "execution_count": 10,
+   "execution_count": 38,
   "id": "a0eb07a7",
   "metadata": {},
   "outputs": [
@@ -400,9 +399,9 @@
     "name": "stdout",
     "output_type": "stream",
     "text": [
-      "[('age', 12), ('enemy', 'jerry'), ('name', 'tom')]\n",
-      "[('age', 12), ('enemy', 'jerry'), ('name', 'tom'), ('type', 'cat')]\n",
-      "[('age', 12), ('enemy', 'jerry'), ('is_human', False), ('name', 'tom'), ('type', 'cat')]\n"
+      "[('name', 'tom'), ('age', 12), ('enemy', 'jerry')]\n",
+      "[('name', 'tom'), ('age', 12), ('enemy', 'jerry'), ('type', 'cat')]\n",
+      "[('name', 'tom'), ('age', 12), ('enemy', 'jerry'), ('type', 'cat'), ('is_human', False)]\n"
     ]
    }
   ],
@@ -437,7 +436,7 @@
  },
  {
   "cell_type": "code",
-   "execution_count": 11,
+   "execution_count": null,
   "id": "0ab442d4",
   "metadata": {},
   "outputs": [
@@ -445,12 +444,12 @@
     "name": "stdout",
     "output_type": "stream",
     "text": [
-      "{'age': 12, 'enemy': 'jerry', 'is_human': False, 'name': 'tom', 'type': 'cat', 'enemy_2': 'spike'}\n"
+      "{'name': 'tom', 'age': 12, 'enemy': 'jerry', 'type': 'cat', 'is_human': False, 'enemy_2': 'spike'}\n"
     ]
    }
   ],
   "source": [
-    "# 由于 jupyter 的环境处理, 请不要重复运行此单元格, 如果想再看一遍, 请重启 jupyter 后再全部运行\n",
+    "# 由于 Jupyter 的环境处理(环境状态会累积), 请不要重复运行此单元格, 如果想再看一遍, 请重启 jupyter 后再全部运行\n",
    "\n",
    "# 唯一推荐方式\n",
    "lct.append((\"enemy_2\", \"spike\"))\n",
@@ -470,7 +469,7 @@
  },
  {
   "cell_type": "code",
-   "execution_count": 12,
+   "execution_count": 40,
   "id": "f3ca752f",
   "metadata": {},
   "outputs": [
@@ -478,23 +477,23 @@
     "name": "stdout",
     "output_type": "stream",
     "text": [
-      "[('age', 12), ('enemy', 'jerry'), ('enemy_2', 'spike'), ('is_human', False), ('name', 'tom'), ('type', 'cat')]\n",
+      "[('age', 12), ('enemy', 'jerry'), ('is_human', False), ('name', 'tom'), ('type', 'cat'), ('enemy_2', 'spike')]\n",
      "{'age': 12, 'enemy': 'jerry', 'is_human': False, 'name': 'tom', 'type': 'cat', 'enemy_2': 'spike'}\n",
      "------\n",
      "('age', 12)\n",
      "('enemy', 'jerry')\n",
-      "('enemy_2', 'spike')\n",
      "('is_human', False)\n",
      "('name', 'tom')\n",
      "('type', 'cat')\n",
+      "('enemy_2', 'spike')\n",
      "6\n",
-      "('type', 'cat')\n",
-      "[('age', 12), ('enemy', 'jerry'), ('enemy_2', 'spike'), ('is_human', False), ('name', 'tom')]\n",
-      "('name', 'tom')\n",
-      "[('age', 12), ('enemy', 'jerry'), ('enemy_2', 'spike'), ('is_human', False)]\n",
-      "('is_human', False)\n",
-      "[('age', 12), ('enemy', 'jerry'), ('enemy_2', 'spike')]\n",
      "('enemy_2', 'spike')\n",
+      "[('age', 12), ('enemy', 'jerry'), ('is_human', False), ('name', 'tom'), ('type', 'cat')]\n",
+      "('type', 'cat')\n",
+      "[('age', 12), ('enemy', 'jerry'), ('is_human', False), ('name', 'tom')]\n",
+      "('name', 'tom')\n",
+      "[('age', 12), ('enemy', 'jerry'), ('is_human', False)]\n",
+      "('is_human', False)\n",
      "[('age', 12), ('enemy', 'jerry')]\n",
      "('enemy', 'jerry')\n",
      "[('age', 12)]\n",
@@ -508,7 +507,7 @@
       "Ellipsis"
      ]
     },
-     "execution_count": 12,
+     "execution_count": 40,
     "metadata": {},
     "output_type": "execute_result"
    }
@@ -556,10 +555,18 @@
  },
  {
   "cell_type": "code",
-   "execution_count": 13,
+   "execution_count": 41,
   "id": "773bf99c",
   "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "zsh:1: no matches found: heurams.log*\n"
+     ]
+    }
+   ],
   "source": [
    "!rm -rf test_new_repo\n",
    "!rm -rf heurams.log*"
@@ -567,7 +574,7 @@
  },
  {
   "cell_type": "code",
-   "execution_count": 14,
+   "execution_count": 42,
   "id": "8645c5a2",
   "metadata": {},
   "outputs": [
@@ -575,67 +582,106 @@
     "name": "stdout",
     "output_type": "stream",
     "text": [
-      "{   'content': '君臣/固守/以窥/周室,/',\n",
-      "    'delimiter': '/',\n",
-      "    'keyword_note': {'窥': '窥视'},\n",
-      "    'note': [],\n",
-      "    'translation': '君臣牢固地守卫着，借以窥视周王室的权力，',\n",
-      "    'tts_text': '君臣固守以窥周室,'}\n",
-      "{   'SM-2': {   'efactor': 2.5,\n",
-      "                'interval': 1,\n",
-      "                'is_activated': 1,\n",
-      "                'last_date': 20454,\n",
-      "                'last_modify': 1767274438.752494,\n",
-      "                'next_date': 20455,\n",
-      "                'real_rept': 1,\n",
-      "                'rept': 0}}\n",
      "{   'content': '秦孝公/据/崤函/之固/, 拥/雍州/之地,/',\n",
      "    'delimiter': '/',\n",
      "    'keyword_note': {'崤函': '崤山和函谷关', '据': '占据', '雍州': '古代九州之一'},\n",
      "    'note': [],\n",
+      "    'puzzles': {   'FillBlank': {   '__hint__': '',\n",
+      "                                    '__origin__': 'cloze',\n",
+      "                                    'delimiter': '/',\n",
+      "                                    'min_denominator': 3,\n",
+      "                                    'text': '秦孝公/据/崤函/之固/, 拥/雍州/之地,/'},\n",
+      "                   'Recognition': {   '__hint__': '',\n",
+      "                                      '__origin__': 'recognition',\n",
+      "                                      'primary': '秦孝公/据/崤函/之固/, 拥/雍州/之地,/',\n",
+      "                                      'secondary': [   {   '崤函': '崤山和函谷关',\n",
+      "                                                           '据': '占据',\n",
+      "                                                           '雍州': '古代九州之一'},\n",
+      "                                                       []],\n",
+      "                                      'top_dim': [   '秦孝公占据着崤山和函谷关的险固地势，拥有雍州的土地，']},\n",
+      "                   'SelectMeaning': {   '__hint__': '秦孝公/据/崤函/之固/, 拥/雍州/之地,/',\n",
+      "                                        '__origin__': 'mcq',\n",
+      "                                        'jammer': ['占据', '崤山和函谷关', '古代九州之一'],\n",
+      "                                        'mapping': {   '崤函': '崤山和函谷关',\n",
+      "                                                       '据': '占据',\n",
+      "                                                       '雍州': '古代九州之一'},\n",
+      "                                        'max_riddles_num': 2,\n",
+      "                                        'prefix': '选择正确项: ',\n",
+      "                                        'primary': '秦孝公/据/崤函/之固/, 拥/雍州/之地,/'}},\n",
      "    'translation': '秦孝公占据着崤山和函谷关的险固地势，拥有雍州的土地，',\n",
      "    'tts_text': '秦孝公据崤函之固, 拥雍州之地,'}\n",
      "{   'SM-2': {   'efactor': 2.5,\n",
      "                'interval': 1,\n",
      "                'is_activated': 1,\n",
-      "                'last_date': 20454,\n",
-      "                'last_modify': 1767274438.7534873,\n",
-      "                'next_date': 20455,\n",
+      "                'last_date': 20459,\n",
+      "                'last_modify': 1767700296.4950516,\n",
+      "                'next_date': 20460,\n",
      "                'real_rept': 1,\n",
      "                'rept': 0}}\n",
-      "{   'algodata': [   (   '君臣固守以窥周室,',\n",
+      "{   'content': '君臣/固守/以窥/周室,/',\n",
+      "    'delimiter': '/',\n",
+      "    'keyword_note': {'窥': '窥视'},\n",
+      "    'note': [],\n",
+      "    'puzzles': {   'FillBlank': {   '__hint__': '',\n",
+      "                                    '__origin__': 'cloze',\n",
+      "                                    'delimiter': '/',\n",
+      "                                    'min_denominator': 3,\n",
+      "                                    'text': '君臣/固守/以窥/周室,/'},\n",
+      "                   'Recognition': {   '__hint__': '',\n",
+      "                                      '__origin__': 'recognition',\n",
+      "                                      'primary': '君臣/固守/以窥/周室,/',\n",
+      "                                      'secondary': [{'窥': '窥视'}, []],\n",
+      "                                      'top_dim': ['君臣牢固地守卫着，借以窥视周王室的权力，']},\n",
+      "                   'SelectMeaning': {   '__hint__': '君臣/固守/以窥/周室,/',\n",
+      "                                        '__origin__': 'mcq',\n",
+      "                                        'jammer': ['窥视'],\n",
+      "                                        'mapping': {'窥': '窥视'},\n",
+      "                                        'max_riddles_num': 2,\n",
+      "                                        'prefix': '选择正确项: ',\n",
+      "                                        'primary': '君臣/固守/以窥/周室,/'}},\n",
+      "    'translation': '君臣牢固地守卫着，借以窥视周王室的权力，',\n",
+      "    'tts_text': '君臣固守以窥周室,'}\n",
      "{   'SM-2': {   'efactor': 2.5,\n",
      "                'interval': 1,\n",
      "                'is_activated': 1,\n",
-      "                                        'last_date': 20454,\n",
-      "                                        'last_modify': 1767274438.752494,\n",
-      "                                        'next_date': 20455,\n",
+      "                'last_date': 20459,\n",
+      "                'last_modify': 1767700296.4968777,\n",
+      "                'next_date': 20460,\n",
+      "                'real_rept': 1,\n",
+      "                'rept': 0}}\n",
+      "{   'algodata': [   (   '秦孝公据崤函之固, 拥雍州之地,',\n",
+      "                        {   'SM-2': {   'efactor': 2.5,\n",
+      "                                        'interval': 1,\n",
+      "                                        'is_activated': 1,\n",
+      "                                        'last_date': 20459,\n",
+      "                                        'last_modify': 1767700296.4950516,\n",
+      "                                        'next_date': 20460,\n",
      "                                        'real_rept': 1,\n",
      "                                        'rept': 0}}),\n",
-      "                    (   '秦孝公据崤函之固, 拥雍州之地,',\n",
+      "                    (   '君臣固守以窥周室,',\n",
      "                        {   'SM-2': {   'efactor': 2.5,\n",
      "                                        'interval': 1,\n",
      "                                        'is_activated': 1,\n",
-      "                                        'last_date': 20454,\n",
-      "                                        'last_modify': 1767274438.7534873,\n",
-      "                                        'next_date': 20455,\n",
+      "                                        'last_date': 20459,\n",
+      "                                        'last_modify': 1767700296.4968777,\n",
+      "                                        'next_date': 20460,\n",
      "                                        'real_rept': 1,\n",
      "                                        'rept': 0}})],\n",
      "    'manifest': {   'author': '__heurams__',\n",
      "                    'desc': '高考古诗文: 过秦论',\n",
      "                    'title': '测试单元: 过秦论'},\n",
-      "    'payload': [   (   '君臣固守以窥周室,',\n",
-      "                       {   'content': '君臣/固守/以窥/周室,/',\n",
-      "                           'keyword_note': {'窥': '窥视'},\n",
-      "                           'note': [],\n",
-      "                           'translation': '君臣牢固地守卫着，借以窥视周王室的权力，'}),\n",
-      "                   (   '秦孝公据崤函之固, 拥雍州之地,',\n",
+      "    'payload': [   (   '秦孝公据崤函之固, 拥雍州之地,',\n",
      "                       {   'content': '秦孝公/据/崤函/之固/, 拥/雍州/之地,/',\n",
      "                           'keyword_note': {   '崤函': '崤山和函谷关',\n",
      "                                               '据': '占据',\n",
      "                                               '雍州': '古代九州之一'},\n",
      "                           'note': [],\n",
-      "                           'translation': '秦孝公占据着崤山和函谷关的险固地势，拥有雍州的土地，'})],\n",
+      "                           'translation': '秦孝公占据着崤山和函谷关的险固地势，拥有雍州的土地，'}),\n",
+      "                   (   '君臣固守以窥周室,',\n",
+      "                       {   'content': '君臣/固守/以窥/周室,/',\n",
+      "                           'keyword_note': {'窥': '窥视'},\n",
+      "                           'note': [],\n",
+      "                           'translation': '君臣牢固地守卫着，借以窥视周王室的权力，'})],\n",
      "    'schedule': {   'phases': {   'final_review': [   ['FillBlank', '0.7'],\n",
      "                                                      ['SelectMeaning', '0.7'],\n",
      "                                                      ['Recognition', '1.0']],\n",
@@ -654,11 +700,9 @@
      "                                     'translation': '语句翻译',\n",
      "                                     'tts_text': '文本转语音文本'},\n",
      "                   'common': {   'delimiter': '/',\n",
-      "                                 'tts_text': \"eval:payload['content'].replace('/', \"\n",
-      "                                             \"'')\"},\n",
      "                                 'puzzles': {   'FillBlank': {   '__hint__': '',\n",
      "                                                                 '__origin__': 'cloze',\n",
-      "                                                   'delimiter': \"eval:metadata['formation']['delimiter']\",\n",
+      "                                                                 'delimiter': \"eval:nucleon['delimiter']\",\n",
      "                                                                 'min_denominator': \"eval:default['cloze']['min_denominator']\",\n",
      "                                                                 'text': \"eval:payload['content']\"},\n",
      "                                                'Recognition': {   '__hint__': '',\n",
@@ -674,7 +718,8 @@
      "                                                                     'max_riddles_num': \"eval:default['mcq']['max_riddles_num']\",\n",
      "                                                                     'prefix': '选择正确项: ',\n",
      "                                                                     'primary': \"eval:payload['content']\"}},\n",
-      "                   '古文句': {}}}\n"
+      "                                 'tts_text': \"eval:payload['content'].replace('/', \"\n",
+      "                                             \"'')\"}}}\n"
     ]
    }
   ],
--- a/examples/simplemem.py
+++ b/examples/simplemem.py
@@ -1,8 +1,9 @@
-import heurams.kernel.repolib as repolib
-import heurams.kernel.particles as pt
-from heurams.services.textproc import truncate
-from pathlib import Path
 import time
+from pathlib import Path
+
+import heurams.kernel.particles as pt
+import heurams.kernel.repolib as repolib
+from heurams.services.textproc import truncate

 repo = repolib.Repo.create_from_repodir(Path("./test_repo"))
 alist = list()
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,23 +1,34 @@
-[build-system]
-requires = ["setuptools>=45", "wheel"]
-build-backend = "setuptools.build_meta"
-
 [project]
 name = "heurams"
 version = "0.5.0"
-description = "Heuristic Assisted Memory Scheduler"
-license = {file = "LICENSE"}
-classifiers = [
-    "License :: OSI Approved :: GNU Affero General Public License v3",
-    "Programming Language :: Python :: 3",
-    "Operating System :: OS Independent",
-    "Topic :: Education",
-    "Intended Audience :: Education",
-]
-keywords = ["spaced-repetition", "memory", "learning", "tui", "textual", "flashcards", "education"]
-
+description = "Heuristic Auxiliary Memory Scheduler"
 readme = "README.md"
+authors = [
+    { name = "pluvium27", email = "pluvium27@outlook.com" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "edge-tts==7.0.2",
+    "jieba==0.42.1",
+    "openai==1.0.0",
+    "playsound==1.2.2",
+    "psutil>=7.2.1",
+    "pygobject>=3.54.5",
+    "tabulate>=0.9.0",
+    "textual==7.0.0",
+    "toml==0.10.2",
+    "transitions==0.9.3",
+]

-[tool.setuptools.packages.find]
-where = ["src"]
+[project.scripts]
+heurams = "heurams.__main__:main"
+tui = "heurams.interface.__main__:main"

+[build-system]
+requires = ["uv_build>=0.9.22,<0.10.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "flet>=0.80.1",
+]
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,8 +1,8 @@
 edge-tts==7.0.2
-fsspec==2025.12.0
 jieba==0.42.1
+openai==1.0.0
 playsound==1.2.2
-tabulate==0.9.0
-textual==5.3.0
+tabulate>=0.9.0
+textual==7.0.0
 toml==0.10.2
 transitions==0.9.3
--- a/src/heurams/main.py
+++ b/src/heurams/main.py
@@ -1,7 +1,21 @@
-prompt = """HeurAMS 已经被成功地安装在系统中.
-但 HeurAMS 被设计为一个带有辅助记忆调度器功能的软件包, 无法直接被执行, 但可被其他 Python 程序调用.
-若您想启动内置的基本用户界面,
+import heurams.services.version as ver
+
+# __main__.py
+def main():
+    prompt = f"""HeurAMS {ver.ver} 已经被成功地安装在系统中.
+HeurAMS 被设计为一个带有辅助记忆调度器功能的软件包, 无法直接被执行, 但可被其他 Python 程序调用.
+若您想启动内置的基本用户界面:
 请运行 python -m heurams.interface,
 或者 python -m heurams.interface.__main__
+python 代指您使用的解释器, 在某些发行版中可能是 python3, 而 python 命令被指向了 python2.
+尽管项目保留了 requirements.txt, 我们仍不推荐使用系统 python 和原始 venv 进行开发.
+项目的推荐开发环境工具是 uv.
+如果你的环境已经安装了 uv:
+ 先运行 uv sync 同步环境, 此命令只需要执行一遍, uv 会自动处理依赖.
+ 然后通过运行 uv run tui 启动内置基本用户界面.
+ 此时您的解释器在项目目录里的 .venv/bin 中, 使用 IDE 开发前, 务必切换解释器!
 注意: 一个常见的误区是, 执行 interface 下的 __main__.py 运行基本用户界面, 这会导致 Python 上下文环境异常, 请不要这样做."""
    print(prompt)
+
+if __name__ == "__main__":
+    main()
--- a/src/heurams/context.py
+++ b/src/heurams/context.py
@@ -5,7 +5,6 @@

 import pathlib
 from contextvars import ContextVar
-import shutil

 from heurams.services.config import ConfigFile
 from heurams.services.logger import get_logger
@@ -15,40 +14,19 @@ from heurams.services.logger import get_logger
 # 数据文件路径规定: 以运行目录为准

 rootdir = pathlib.Path(__file__).parent
-print(f"项目根目录: {rootdir}")
+workdir = pathlib.Path.cwd()
+#print(f"项目根目录: {rootdir}")
+#print(f"工作目录: {workdir}")
 logger = get_logger(__name__)
 logger.debug(f"项目根目录: {rootdir}")
-workdir = pathlib.Path.cwd()
-print(f"工作目录: {workdir}")
 logger.debug(f"工作目录: {workdir}")

-if pathlib.Path(workdir / "data" / "config" / "config_dev.toml").exists():
-    print("使用开发设置")
-    logger.debug("使用开发设置")
-    config_var: ContextVar[ConfigFile] = ContextVar(
-        "config_var",
-        default=ConfigFile(workdir / "data" / "config" / "config_dev.toml"),
-    )
-else:
-    try:
-        config_var: ContextVar[ConfigFile] = ContextVar(
-            "config_var",
-            default=ConfigFile(workdir / "data" / "config" / "config.toml"),
-        )  # 配置文件
-    except Exception as e:
-        input("按下回车以创建新的配置文件, 或按下 Ctrl + C 以终止程序 ")
 (workdir / "data" / "config").mkdir(parents=True, exist_ok=True)
-        (workdir / "data" / "config" / "config").unlink(missing_ok=True)
-        shutil.copy(
-            (rootdir / "default" / "config" / "config.toml"),
-            workdir / "data" / "config" / "config.toml",
-        )
-    finally:
+
 config_var: ContextVar[ConfigFile] = ContextVar(
    "config_var",
    default=ConfigFile(workdir / "data" / "config" / "config.toml"),
-        )  # 配置文件
-
+)

 class ConfigContext:
    """
--- a/src/heurams/default/config/config.toml
+++ b/src/heurams/default/config/config.toml
@@ -1,56 +0,0 @@
-# [调试] 将更改保存到文件
-persist_to_file = 1
-
-# [调试] 覆写时间, 设为 -1 以禁用
-daystamp_override = -1
-timestamp_override = -1
-
-# [调试] 一键通过
-quick_pass = 1
-
-# 对于每个项目的默认新记忆原子数量
-scheduled_num = 8
-
-# UTC 时间戳修正 仅用于 UNIX 日时间戳的生成修正, 单位为秒
-timezone_offset = +28800 # 中国标准时间 (UTC+8)
-
-[interface]
-
-[interface.memorizor]
-autovoice = true # 自动语音播放, 仅限于 recognition 组件
-
-[algorithm]
-default = "SM-2" # 主要算法; 可选项: SM-2, SM-15M, FSRS
-
-[puzzles] # 谜题默认配置
-
-[puzzles.mcq]
-max_riddles_num = 2
-
-[puzzles.cloze]
-min_denominator = 3
-
-[paths] # 相对于配置文件的 ".." (即工作目录) 而言 或绝对路径
-data = "./data"
-
-[services] # 定义服务到提供者的映射
-audio = "playsound" # 可选项: playsound(通用), termux(仅用于支持 Android Termux), mpg123(TODO)
-tts = "edgetts" # 可选项: edgetts
-llm = "openai" # 可选项: openai
-sync = "webdav" # 可选项: 留空, webdav
-
-[providers.tts.edgetts] # EdgeTTS 设置
-voice = "zh-CN-XiaoxiaoNeural" # 可选项: zh-CN-YunjianNeural (男声), zh-CN-XiaoxiaoNeural (女声)
-
-[providers.llm.openai] # 与 OpenAI 相容的语言模型接口服务设置
-url = ""
-key = ""
-
-[providers.sync.webdav] # WebDAV 同步设置
-url = ""
-username = ""
-password = ""
-remote_path = "/heurams/"
-verify_ssl = true
-
-[sync]
--- a/src/heurams/interface/init.py
+++ b/src/heurams/interface/init.py
@@ -1,47 +1,46 @@
+from time import sleep, perf_counter
+print("欢迎使用基本用户界面!")
+print("加载配置与上下文... ", end="", flush=True)
+_start1 = perf_counter()
+_start = perf_counter()
+from heurams.context import *
+_end = perf_counter()
+print(f"已完成! (耗时: {round(1000 * (_end - _start))}ms)")
+
+print("加载用户界面框架... ", end="", flush=True)
+_start = perf_counter()
 from textual.app import App
 from textual.widgets import Button
+_end = perf_counter()
+print(f"已完成! (耗时: {round(1000 * (_end - _start))}ms)")

-from heurams.context import config_var
-from heurams.services.logger import get_logger
-
+print("加载用户界面布局... ", end="", flush=True)
+_start = perf_counter()
 from .screens.about import AboutScreen
 from .screens.dashboard import DashboardScreen
+from .screens.llmchat import LLMChatScreen
+from .screens.navigator import NavigatorScreen
 from .screens.precache import PrecachingScreen
+from .screens.radio import RadioScreen
 from .screens.repocreator import RepoCreatorScreen
+from .screens.repoeditor import RepoEditorScreen
 from .screens.synctool import SyncScreen
+_end = perf_counter()
+print(f"已完成! (耗时: {round(1000 * (_end - _start))}ms)")

-logger = get_logger(__name__)
-
-
-def environment_check():
-    from pathlib import Path
-
-    logger.debug("检查环境路径")
-    subdir = ["cache/voice", "repo", "global", "config"]
-    for i in subdir:
-        i = Path(config_var.get()["paths"]["data"]) / i
-        if not i.exists():
-            logger.info("创建目录: %s", i)
-            print(f"创建 {i}")
-            i.mkdir(exist_ok=True, parents=True)
-        else:
-            logger.debug("目录已存在: %s", i)
-            print(f"找到 {i}")
-    logger.debug("环境检查完成")
-
-
+print(f"组件目录: {rootdir}")
+print(f"工作目录: {workdir}")
+_end1 = perf_counter()
+print(f"前置工作共计耗时: {round(1000 * (_end1 - _start1))}ms")
 class HeurAMSApp(App):
    TITLE = "潜进"
    CSS_PATH = "css/main.tcss"
    SUB_TITLE = "启发式辅助记忆调度器"
    BINDINGS = [
-        ("q", "quit", "退出"),
-        ("d", "toggle_dark", "切换色调"),
-        ("1", "app.push_screen('dashboard')", "仪表盘"),
-        ("2", "app.push_screen('precache_all')", "缓存管理器"),
-        ("3", "app.push_screen('repo_creator')", "创建新仓库"),
-        # ("4", "app.push_screen('synctool')", "同步工具"),
-        ("0", "app.push_screen('about')", "版本信息"),
+        ("q", "go_back", "退出"),
+        ("d", "toggle_dark", "主题"),
+        ("n", "app.push_screen('navigator')", "导航"),
+        ("z", "app.push_screen('about')", "关于"),
    ]
    SCREENS = {
        "dashboard": DashboardScreen,
@@ -49,15 +48,22 @@ class HeurAMSApp(App):
        "precache_all": PrecachingScreen,
        "synctool": SyncScreen,
        "about": AboutScreen,
+        "navigator": NavigatorScreen,
+        "radio": RadioScreen,
+        "repo_editor": RepoEditorScreen,
+        "llmchat": LLMChatScreen,
+#        "config": ConfigScreen,
    }

    def on_mount(self) -> None:
-        environment_check()
        self.push_screen("dashboard")

    def on_button_pressed(self, event: Button.Pressed) -> None:
-        self.exit(event.button.id)
+        pass
+        # self.exit(event.button.id)
+
+    def action_go_back(self) -> None:
+        quit()

    def action_do_nothing(self):
-        print("DO NOTHING")
        self.refresh()
--- a/src/heurams/interface/main.py
+++ b/src/heurams/interface/main.py
@@ -1,18 +1,29 @@
-from textual.app import App
-from textual.widgets import Button
-
+from heurams.interface import *
 from heurams.context import config_var
-from heurams.interface import HeurAMSApp
 from heurams.services.logger import get_logger

-from .screens.about import AboutScreen
-from .screens.dashboard import DashboardScreen
-from .screens.precache import PrecachingScreen
-from .screens.repocreator import RepoCreatorScreen
-
 logger = get_logger(__name__)

+def environment_check():
+    from pathlib import Path
+
+    logger.debug("检查环境路径")
+    subdir = ["cache/voice", "repo", "global", "config"]
+    for i in subdir:
+        i = Path(config_var.get()["paths"]["data"]) / i
+        if not i.exists():
+            logger.info("创建目录: %s", i)
+            print(f"创建 {i}")
+            i.mkdir(exist_ok=True, parents=True)
+        else:
+            logger.debug("目录已存在: %s", i)
+            print(f"找到 {i}")
+    logger.debug("环境检查完成")
+
+def main():
+    environment_check()
    app = HeurAMSApp()
+    app.run(inline=False)

 if __name__ == "__main__":
-    app.run()
+    main()
--- a/src/heurams/interface/css/main.tcss
+++ b/src/heurams/interface/css/main.tcss
@@ -0,0 +1,87 @@
+
+
+NavigatorScreen {
+    align: center middle;
+}
+
+.infview {
+    width: 5fr
+}
+.dataview {
+    width: 3fr
+}
+
+.repo_listitem {
+    layout: grid;
+    grid-size: 2;
+}
+
+.repo_listitem_btn {
+    dock: right;
+    offset: -5% 0
+}
+
+#dialog {
+    grid-size: 2;
+    grid-gutter: 1 1;
+    grid-rows: 1fr 3;
+    padding: 0 1;
+    width: 46;
+    height: 12;
+    border: thick $background 80%;
+    background: $surface;
+}
+
+/* LLM 聊天界面样式 */
+LLMChatScreen {
+    background: $surface;
+}
+
+#chat-container {
+    height: 100%;
+    padding: 1;
+}
+
+#toolbar {
+    height: 3;
+    margin-bottom: 1;
+    align: center middle;
+}
+
+#toolbar Button {
+    margin: 0 1;
+}
+
+#chat-log {
+    height: 1fr;
+    border: solid $primary;
+    padding: 1;
+    background: $surface;
+}
+
+#dashboardtop {
+    height: 4
+}
+
+#input-container {
+    height: 3;
+    margin-top: 1;
+    align: center middle;
+}
+
+#message-input {
+    width: 1fr;
+    margin-right: 1;
+}
+
+#status-bar {
+    height: 1;
+    margin-top: 1;
+    text-style: italic;
+    color: $text-muted;
+}
+
+.session-label {
+    color: $primary;
+    text-style: bold;
+}
--- a/src/heurams/interface/screens/about.py
+++ b/src/heurams/interface/screens/about.py
@@ -7,14 +7,31 @@ from textual.widgets import Button, Footer, Header, Label, Markdown, Static

 import heurams.services.version as version
 from heurams.context import *
+import platform
+import shutil
+import psutil
+import os
+import sys


 class AboutScreen(Screen):
+    BINDINGS = [
+        ("q", "go_back", "返回"),
+    ]

    def compose(self) -> ComposeResult:
        yield Header(show_clock=True)
        with ScrollableContainer(id="about_container"):
            yield Label("[b]关于与版本信息[/b]")
+            
+            # 获取系统信息
+            textual_version = self._get_textual_version()
+            terminal_info = self._get_terminal_info()
+            python_version = self._get_python_version()
+            os_version = self._get_os_version()
+            disk_usage = self._get_disk_usage()
+            memory_info = self._get_memory_info()
+            
            about_text = f"""
 # 关于 "潜进"  

@@ -22,54 +39,43 @@ class AboutScreen(Screen):
  
 开发代号: {version.codename.capitalize()} {version.codename_cn} 

-一个基于启发式算法的开放源代码记忆调度器, 旨在帮助用户更高效地进行记忆工作与学习规划.  
+一个基于启发式算法的辅助记忆调度器, 旨在帮助用户更高效地进行记忆工作与学习规划.  

-以 AGPL-3.0 开放源代码  
+以 AGPL-3.0 开放源代码, 这直接意味着任何个体直接基于此代码对外或内部提供的应用和服务, 无论本地或网络, 必须向所有用户公开完整修改后的源代码, 且继续沿用 AGPL-3.0 协议.  

-开发人员:  
+您可在项目主页 https://ams.imwangzhiyu.xyz 获取用户指南, 开发文档与软件更新.  

- Wang Zhiyu([@pluvium27](https://github.com/pluvium27)): 项目作者  
+如果您觉得这个软件有用, 可以给它添加一个星标 :)  

-特别感谢:
+> 此软件, 以及它作为一个"程序库"是自由且免费的, 但是开发工作必须投入大量精力
+> 即使您不是软件开发人员, 我们也欢迎您加入 HeurAMS 的队伍!  
+> 您可以加入各种语言的翻译团队来翻译软件的界面, 您还可以制作图像、主题、音效, 或者改进软件配套的文档……  
+> 不管您来自何方, 我们都欢迎您加入社区并做出贡献.  
+> 我们的共同目标是为人人带来高品质的辅助记忆 & 学习软件.  
+> 您的慷慨支持, 我们必当涌泉相报.
+
+开发人员列表:  
+
+- Wang Zhiyu([@pluvium27](https://github.com/pluvium27)): 发起项目与主要维护者  
+
+特别感谢以下人士, 他们的算法与理论构成了此软件算法的基石:  

 - [Piotr A. Woźniak](https://supermemo.guru/wiki/Piotr_Wozniak): SM-2 算法与 SM-15 算法理论
 - [Kazuaki Tanida](https://github.com/slaypni): SM-15 算法的 CoffeeScript 实现
 - [Thoughts Memo](https://www.zhihu.com/people/L.M.Sherlock): 文献参考

-# 参与贡献

-我们是一个年轻且包容的社区, 由技术人员, 设计师, 文书工作者, 以及创意人员共同构成,  
+# 运行环境信息

-通过我们协力开发的软件为所有人谋取福祉.  
+Python 解释器版本: {python_version}  
+Textual 框架版本: {textual_version}  
+终端模拟器: {terminal_info}  
+操作系统版本: {os_version}  
+存储余量: {disk_usage}  
+内存大小: {memory_info}  
  
-上述工作不可避免地让我们确立了下列价值观 (取自 KDE 宣言):  
-
- - 开放治理 确保更多人能参与我们的领导和决策进程;  
-
- - 自由软件 确保我们的工作成果随时能为所有人所用;  
-
- - 多样包容 确保所有人都能加入社区并参加工作;  
-
- - 创新精神 确保新思路能不断涌现并服务于所有人;  
-
- - 共同产权 确保我们能团结一致;  
-
- - 迎合用户 确保我们的成果对所有人有用.  
-
-综上所述, 在为我们共同目标奋斗的过程中, 我们认为上述价值观反映了我们社区的本质, 是我们始终如一地保持初心的关键所在.  
-
-这是一项立足于协作精神的事业, 它的运作和产出不受任何单一个人或者机构的操纵.  
-
-我们的共同目标是为人人带来高品质的辅助记忆 & 学习软件.
-
-不管您来自何方, 我们都欢迎您加入社区并做出贡献.
+报告问题时, 请复制这些信息到问题描述, 并上传软件日志 `heurams.log` 作为附件, 以协助开发者定位错误  
 """
-
-            # """
-            # 学术数据
-
-            # "潜进" 的用户数据可用于科学方面的研究, 我们将在未来版本添加学术数据的收集和展示平台
-            # """
            yield Markdown(about_text, classes="about-markdown")

            yield Button(
@@ -87,3 +93,68 @@ class AboutScreen(Screen):
        event.stop()
        if event.button.id == "back_button":
            self.action_go_back()
+    
+    def _get_textual_version(self) -> str:
+        """获取 Textual 框架版本"""
+        try:
+            import textual
+            return textual.__version__
+        except (ImportError, AttributeError):
+            return "未知"
+    
+    def _get_terminal_info(self) -> str:
+        """获取终端模拟器信息"""
+        terminal = shutil.which("terminal")
+        if terminal:
+            return terminal
+        # 尝试从环境变量获取
+        terminal_env = os.environ.get('TERM_PROGRAM') or os.environ.get('TERM')
+        return terminal_env or "未知"
+    
+    def _get_python_version(self) -> str:
+        """获取 Python 解释器版本"""
+        return platform.python_version()
+    
+    def _get_os_version(self) -> str:
+        """获取操作系统版本"""
+        try:
+            if platform.system() == "Darwin":
+                # macOS
+                import subprocess
+                result = subprocess.run(['sw_vers', '-productVersion'], 
+                                      capture_output=True, text=True)
+                return f"macOS {result.stdout.strip()}"
+            elif platform.system() == "Windows":
+                # Windows
+                return f"Windows {platform.release()}"
+            elif platform.system() == "Linux":
+                # Linux - 尝试获取发行版信息
+                try:
+                    import distro
+                    return f"{distro.name()} {distro.version()}"
+                except (ImportError, AttributeError):
+                    return platform.platform()
+            else:
+                return platform.platform()
+        except Exception:
+            return platform.platform()
+    
+    def _get_disk_usage(self) -> str:
+        """获取磁盘使用情况"""
+        try:
+            usage = psutil.disk_usage('/')
+            free_gb = usage.free / (1024 ** 3)
+            total_gb = usage.total / (1024 ** 3)
+            percent_free = (free_gb / total_gb) * 100
+            return f"{free_gb:.1f} GB ({percent_free:.1f}%)"
+        except Exception:
+            return "未知"
+    
+    def _get_memory_info(self) -> str:
+        """获取内存信息"""
+        try:
+            memory = psutil.virtual_memory()
+            total_gb = memory.total / (1024 ** 3)
+            return f"{total_gb:.1f} GB"
+        except Exception:
+            return "未知"
--- a/src/heurams/interface/screens/configure.py
+++ b/src/heurams/interface/screens/configure.py
--- a/src/heurams/interface/screens/dashboard.py
+++ b/src/heurams/interface/screens/dashboard.py
@@ -1,12 +1,17 @@
 """仪表盘界面"""

+from functools import reduce
 import pathlib
+from pathlib import Path
+import os

 from textual.app import ComposeResult
-from textual.containers import ScrollableContainer
+from textual.containers import ScrollableContainer, Container, Horizontal, Vertical
 from textual.screen import Screen
 from textual.widgets import Button, Footer, Header, Label, ListItem, ListView, Static
+from textual.layouts import horizontal

+import heurams.kernel.particles as pt
 import heurams.services.timer as timer
 import heurams.services.version as version
 from heurams.context import *
@@ -14,10 +19,10 @@ from heurams.kernel.particles import *
 from heurams.kernel.repolib import *
 from heurams.services.logger import get_logger

-import heurams.kernel.particles as pt
-from pathlib import Path
 from .about import AboutScreen
+from .navigator import NavigatorScreen
 from .preparation import PreparationScreen
+from .radio import RadioScreen

 logger = get_logger(__name__)

@@ -26,6 +31,9 @@ class DashboardScreen(Screen):
    """主仪表盘屏幕"""

    SUB_TITLE = "仪表盘"
+    BINDINGS = [
+        ("q", "go_back", "返回"),
+    ]

    def __init__(
        self,
@@ -37,25 +45,39 @@ class DashboardScreen(Screen):
        self.repostat = {}
        self.title2dirname = {}
        self.title2repo = {}
+        self.dirname2repo = {}
        self._load_data()

    def compose(self) -> ComposeResult:
        """组合界面组件"""
        yield Header(show_clock=True)
-        yield ScrollableContainer(
-            Label('欢迎使用 "潜进" 启发式辅助记忆调度器', classes="title-label"),
+        with ScrollableContainer():
+            yield Horizontal(
+                Vertical(
+                    Label(f'欢迎使用 "潜进" 版本 {version.ver}'),
                    Label(
-                f"当前 UNIX 日时间戳: {timer.get_daystamp()} (UTC+{config_var.get()["timezone_offset"] / 3600})"
+                        f"当前 UNIX 日时间戳: {timer.get_daystamp()}"
                    ),
+                    Label(f"应用时区修正: UTC+{config_var.get()['timezone_offset'] / 3600}"),
                    Label(f"全局算法设置: {config_var.get()['algorithm']['default']}"),
-            Label("选择待学习或待修改的项目:", classes="title-label"),
-            ListView(id="repo-list", classes="repo-list-view"),
-            Label(f'"潜进" 启发式辅助记忆调度器 | 版本 {version.ver} '),
+                    classes="column infview",
+                ),
+                Vertical(
+                    Label(f"已加载 {len(self.repostat)} 个单元集", classes='dataview'),
+                    Label(f"共计 {reduce(lambda x, y: x + y, map(lambda x: x.get('unit_sum'), self.repostat.values()))} 个单元", classes='dataview'),
+                    Label(f"已激活 {reduce(lambda x, y: x + y, map(lambda x: x.get('activated_sum'), self.repostat.values()))} 个单元", classes='dataview'),
+                    Label(f"终端尺寸: {os.get_terminal_size()[0]}x{os.get_terminal_size()[1]}"),
+                    classes="column dataview",
+                ),
+                id="dashboardtop"
            )
+
+            yield ListView(id="repo-list", classes="repo-list-view")
+            yield Label(f'"潜进" 启发式辅助记忆调度器 版本 {version.ver} {version.stage.capitalize()}')
        yield Footer()

    def _load_data(self):
-        self.repo_dirs = Repo.probe_vaild_repos_in_dir(
+        self.repo_dirs = Repo.probe_valid_repos_in_dir(
            Path(config_var.get()["paths"]["data"]) / "repo"
        )
        for repo_dir in self.repo_dirs:
@@ -69,7 +91,6 @@ class DashboardScreen(Screen):
        unit_sum = len(repo)
        activated_sum = 0
        nextdate = 0x3F3F3F3F
-        is_unfinished = unit_sum > activated_sum
        for i in repo.ident_index:
            nucleon = pt.Nucleon.create_on_nucleonic_data(
                nucleonic_data=repo.nucleonic_data_lict.get_itemic_unit(i)
@@ -82,10 +103,11 @@ class DashboardScreen(Screen):
                if electron.is_due():
                    is_due = 1
                nextdate = min(nextdate, electron.nextdate())
+        is_unfinished = unit_sum > activated_sum
        if is_unfinished:
            nextdate = min(nextdate, timer.get_daystamp())
        need_to_study = is_due or is_unfinished
-        prompt = f"{title}\0\n  进度: {activated_sum}/{unit_sum}\n  {"需要学习" if need_to_study else "无需操作"}"
+        prompt = f"{title}\0\n  进度: {activated_sum}/{unit_sum} ({round(activated_sum/unit_sum*100)}%)\n  {'需要学习' if need_to_study else '无需操作'}"
        stat = {
            "is_due": is_due,
            "unit_sum": unit_sum,
@@ -100,6 +122,7 @@ class DashboardScreen(Screen):
        self.repostat[dirname] = stat
        self.title2dirname[title] = dirname
        self.title2repo[title] = repo
+        self.dirname2repo[dirname] = repo

    def on_mount(self) -> None:
        """挂载组件时初始化"""
@@ -127,7 +150,7 @@ class DashboardScreen(Screen):

        for repotitle in repotitles:
            prompt = self.repostat[self.title2dirname[repotitle]]["prompt"]
-            list_item = ListItem(Label(prompt))
+            list_item = ListItem(Label(prompt), Button(f"开始学习", flat=True, variant="primary", classes="repo_listitem_btn", id=f"launch_{self.repostat[self.title2dirname[repotitle]]['dirname']}"), classes="repo_listitem")
            repo_list_widget.append(list_item)

            # if not self.stay_enabled[repodir]:
@@ -139,7 +162,7 @@ class DashboardScreen(Screen):
            return

        selected_label = event.item.query_one(Label)
-        label_text = str(selected_label.renderable)
+        label_text = str(selected_label.render())

        if "未找到任何仓库" in label_text:
            return
@@ -158,3 +181,15 @@ class DashboardScreen(Screen):
    def action_quit_app(self) -> None:
        """退出应用程序"""
        self.app.exit()
+
+    def action_open_navigator(self) -> None:
+        """打开导航器"""
+        self.app.push_screen(NavigatorScreen())
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        logger.debug(f"event.button.id: {event.button.id}")
+        """处理按钮点击事件"""
+        if str(event.button.id).startswith("launch_"): # type: ignore
+            from .preparation import launch
+            launch(repo=self.dirname2repo[event.button.id[7:]], app=self.app, scheduled_num=-1) # type: ignore
+            # TODO: 这样启动的记忆实例的状态机无法绑定到 PreparationScreen 中
--- a/src/heurams/interface/screens/favmgr.py
+++ b/src/heurams/interface/screens/favmgr.py
@@ -0,0 +1,204 @@
+"""收藏夹管理器界面"""
+
+import base64
+from pathlib import Path
+from typing import List, Optional
+
+from textual.app import ComposeResult
+from textual.containers import ScrollableContainer
+from textual.screen import Screen
+from textual.widgets import (
+    Button,
+    Footer,
+    Header,
+    Label,
+    ListItem,
+    ListView,
+    Markdown,
+    Static,
+)
+
+from heurams.context import config_var
+from heurams.kernel.repolib import Repo
+from heurams.services.favorite_service import FavoriteItem, favorite_manager
+from heurams.services.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+class FavoriteManagerScreen(Screen):
+    """收藏夹管理器屏幕"""
+
+    SUB_TITLE = "收藏夹"
+
+    BINDINGS = [
+        ("q", "go_back", "返回"),
+        ("d", "toggle_dark", ""),
+    ]
+
+    def __init__(
+        self,
+        name: str | None = None,
+        id: str | None = None,
+        classes: str | None = None,
+    ) -> None:
+        super().__init__(name, id, classes)
+        self.favorites: List[FavoriteItem] = []
+        self._load_favorites()
+
+    def _load_favorites(self) -> None:
+        """加载收藏列表"""
+        self.favorites = favorite_manager.get_all()
+        logger.debug("加载 %d 个收藏项", len(self.favorites))
+
+    def compose(self) -> ComposeResult:
+        """组合界面组件"""
+        yield Header(show_clock=True)
+        with ScrollableContainer(id="favorites-container"):
+            if not self.favorites:
+                yield Label("暂无收藏", classes="empty-label")
+                yield Static("使用 * 键在记忆界面中添加收藏.")
+            else:
+                yield Label(f"共 {len(self.favorites)} 个收藏项", classes="count-label")
+                yield ListView(id="favorites-list")
+        yield Footer()
+
+    def on_mount(self) -> None:
+        """挂载后填充列表"""
+        if self.favorites:
+            list_view = self.query_one("#favorites-list")
+            for fav in self.favorites:
+                list_view.append(self._create_favorite_item(fav)) # type: ignore
+
+    def _encode_favorite_key(self, repo_path: str, ident: str) -> str:
+        """编码仓库路径和标识符为安全的按钮 ID 部分"""
+        # 使用 \x00 分隔两部分，然后进行 base64 编码
+        combined = f"{repo_path}\x00{ident}"
+        encoded = base64.urlsafe_b64encode(combined.encode()).decode()
+        # 去掉填充的等号
+        return encoded.rstrip("=")
+
+    def _decode_favorite_key(self, key: str) -> tuple[str, str]:
+        """解码按钮 ID 部分为仓库路径和标识符"""
+        # 补全等号以使长度是4的倍数
+        padded = key + "=" * ((4 - len(key) % 4) % 4)
+        decoded = base64.urlsafe_b64decode(padded.encode()).decode()
+        repo_path, ident = decoded.split("\x00", 1)
+        return repo_path, ident
+
+    def _create_favorite_item(self, fav: FavoriteItem) -> ListItem:
+        """创建收藏项列表项"""
+        # 尝试获取仓库信息
+        repo_info = self._get_repo_info(fav.repo_path, fav)
+        title = repo_info.get("title", fav.repo_path) if repo_info else fav.repo_path
+        content_preview = repo_info.get("content_preview", "") if repo_info else ""
+        added_time = self._format_time(fav.added)
+
+        # 构建显示文本
+        display_text = f"[b]{title}[/b] ({fav.ident})\n"
+        if content_preview:
+            display_text += f"{content_preview}\n"
+        display_text += f"添加于: {added_time}"
+        if fav.tags:
+            display_text += f"  标签: {', '.join(fav.tags)}"
+
+        # 创建安全的按钮 ID
+        button_key = self._encode_favorite_key(fav.repo_path, fav.ident)
+        # 创建列表项，包含移除按钮
+        container = ScrollableContainer(
+            Markdown(display_text, classes="favorite-content"),
+            Button("移除", id=f"remove-{button_key}", variant="error"),
+            classes="favorite-item",
+        )
+        return ListItem(container)
+
+    def _get_repo_info(self, repo_path: str, fav: FavoriteItem) -> Optional[dict]:
+        """获取仓库信息（标题、原子内容预览）"""
+        try:
+            data_repo = Path(config_var.get()["paths"]["data"]) / "repo"
+            repo_dir = data_repo / repo_path
+            if not repo_dir.exists():
+                logger.warning("仓库目录不存在: %s", repo_dir)
+                return None
+            repo = Repo.create_from_repodir(repo_dir)
+            # 获取原子内容预览
+            content_preview = ""
+            payload = repo.payload
+            # 查找对应 ident 的 payload 条目
+            for ident_key, content in payload:
+                if ident_key == fav.ident:
+                    # 截断过长的内容
+                    if isinstance(content, dict) and "content" in content:
+                        text = content["content"]
+                    else:
+                        text = str(content)
+                    if len(text) > 100:
+                        content_preview = text[:100] + "..."
+                    else:
+                        content_preview = text
+                    break
+            return {
+                "title": repo.manifest["title"],
+                "content_preview": content_preview,
+            }
+        except Exception as e:
+            logger.error("获取仓库信息失败: %s", e)
+            return None
+
+    def _format_time(self, timestamp: int) -> str:
+        """格式化时间戳"""
+        from datetime import datetime
+
+        dt = datetime.fromtimestamp(timestamp)
+        return dt.strftime("%Y-%m-%d %H:%M")
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        """处理按钮点击事件"""
+        button_id = event.button.id
+        if button_id and button_id.startswith("remove-"):
+            # 提取编码后的键
+            key = button_id[7:]  # 去掉 "remove-" 前缀
+            try:
+                repo_path, ident = self._decode_favorite_key(key)
+                self._remove_favorite(repo_path, ident)
+            except Exception as e:
+                logger.error("解析按钮 ID 失败: %s", e)
+                self.app.notify("操作失败: 无效的按钮标识", severity="error")
+
+    def _remove_favorite(self, repo_path: str, ident: str) -> None:
+        """移除收藏项"""
+        if favorite_manager.remove(repo_path, ident):
+            self.app.notify(f"已移除收藏: {ident}", severity="information")
+            # 重新加载列表
+            self._load_favorites()
+            # 刷新界面
+            self._refresh_list()
+        else:
+            self.app.notify(f"移除失败: {ident}", severity="error")
+
+    def _refresh_list(self) -> None:
+        """刷新列表显示"""
+        container = self.query_one("#favorites-container")
+        # 清空容器
+        for child in container.children:
+            child.remove()
+        # 重新组合
+        if not self.favorites:
+            container.mount(Label("暂无收藏", classes="empty-label"))
+            container.mount(Static("使用 * 键在记忆界面中添加收藏。"))
+        else:
+            container.mount(
+                Label(f"共 {len(self.favorites)} 个收藏项", classes="count-label")
+            )
+            list_view = ListView(id="favorites-list")
+            container.mount(list_view)
+            for fav in self.favorites:
+                list_view.append(self._create_favorite_item(fav))
+
+    def action_go_back(self) -> None:
+        """返回上一屏幕"""
+        self.app.pop_screen()
+
+    def action_toggle_dark(self) -> None:
+        """切换暗黑模式"""
+        self.app.dark = not self.app.dark # type: ignore
--- a/src/heurams/interface/screens/intelinote.py
+++ b/src/heurams/interface/screens/intelinote.py
@@ -1 +0,0 @@
-"""笔记界面"""
--- a/src/heurams/interface/screens/llmchat.py
+++ b/src/heurams/interface/screens/llmchat.py
@@ -0,0 +1,330 @@
+from pathlib import Path
+from typing import Optional
+
+from textual.app import ComposeResult
+from textual.containers import Container, Horizontal
+from textual.screen import Screen
+from textual.widgets import Button, Footer, Header, Input, Label, RichLog, Static
+
+from heurams.context import *
+from heurams.services.llm_service import ChatSession, get_chat_manager
+from heurams.services.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+class LLMChatScreen(Screen):
+    """LLM 聊天屏幕"""
+
+    SUB_TITLE = "语言模型集成"
+    BINDINGS = [
+        ("q", "go_back", "返回"),
+        ("ctrl+s", "save_session", "保存会话"),
+        ("ctrl+l", "load_session", "加载会话"),
+        ("ctrl+n", "new_session", "新建会话"),
+        ("ctrl+c", "clear_history", "清空历史"),
+        ("escape", "focus_input", "聚焦输入"),
+    ]
+
+    def __init__(
+        self,
+        session_id: Optional[str] = None,
+        name: str | None = None,
+        id: str | None = None,
+        classes: str | None = None,
+    ) -> None:
+        super().__init__(name, id, classes)
+        self.session_id = session_id
+        self.chat_manager = get_chat_manager()
+        self.current_session: Optional[ChatSession] = None
+        self.is_streaming = False
+
+    def compose(self) -> ComposeResult:
+        """组合界面组件"""
+        yield Header(show_clock=True)
+
+        with Container(id="chat-container"):
+            # 顶部工具栏
+            with Horizontal(id="toolbar"):
+                yield Button("新建会话", id="new-session", variant="primary")
+                yield Button("保存会话", id="save-session", variant="default")
+                yield Button("加载会话", id="load-session", variant="default")
+                yield Button("清空历史", id="clear-history", variant="default")
+                yield Button("设置系统提示", id="set-system-prompt", variant="default")
+                yield Static(" | ", classes="separator")
+                yield Label("当前会话:", classes="label")
+                yield Static(id="current-session-label", classes="session-label")
+
+            # 聊天记录显示区域
+            yield RichLog(
+                id="chat-log",
+                wrap=True,
+                highlight=True,
+                markup=True,
+                classes="chat-log",
+            )
+
+            # 输入区域
+            with Horizontal(id="input-container"):
+                yield Input(
+                    id="message-input",
+                    placeholder="输入消息... (按 Ctrl+Enter 发送, Esc 聚焦)",
+                    classes="message-input",
+                )
+                yield Button(
+                    "发送", id="send-button", variant="primary", classes="send-button"
+                )
+
+            # 状态栏
+            yield Static(id="status-bar", classes="status-bar")
+
+        yield Footer()
+
+    def on_mount(self) -> None:
+        """挂载组件时初始化"""
+        # 获取或创建会话
+        self.current_session = self.chat_manager.get_session(self.session_id)
+        if self.current_session is None:
+            self.notify("无法创建 LLM 会话，请检查配置", severity="error")
+            return
+
+        # 更新会话标签
+        self.query_one("#current-session-label", Static).update(
+            f"{self.current_session.session_id}"
+        )
+
+        # 加载历史消息到聊天记录
+        self._display_history()
+
+        # 聚焦输入框
+        self.query_one("#message-input", Input).focus()
+
+        # 检查配置
+        self._check_config()
+
+    def _check_config(self):
+        """检查 LLM 配置"""
+        config = config_var.get()
+        provider_name = config["services"]["llm"]
+        provider_config = config["providers"]["llm"][provider_name]
+
+        if provider_name == "openai":
+            if not provider_config.get("key") and not provider_config.get("url"):
+                self.notify(
+                    "未配置 OpenAI API key 或 URL，请在 config.toml 中配置 [providers.llm.openai]",
+                    severity="warning",
+                )
+
+    def _display_history(self):
+        """显示当前会话的历史消息"""
+        if not self.current_session:
+            return
+
+        chat_log = self.query_one("#chat-log", RichLog)
+        chat_log.clear()
+
+        for msg in self.current_session.get_history():
+            role = msg["role"]
+            content = msg["content"]
+
+            if role == "user":
+                chat_log.write(f"[bold cyan]你:[/bold cyan] {content}")
+            elif role == "assistant":
+                chat_log.write(f"[bold green]AI:[/bold green] {content}")
+            elif role == "system":
+                # 系统消息不显示在聊天记录中
+                pass
+
+    def _add_message_to_log(self, role: str, content: str):
+        """添加消息到聊天记录显示"""
+        chat_log = self.query_one("#chat-log", RichLog)
+        if role == "user":
+            chat_log.write(f"[bold cyan]你:[/bold cyan] {content}")
+        elif role == "assistant":
+            chat_log.write(f"[bold green]AI:[/bold green] {content}")
+        chat_log.scroll_end()
+
+    async def on_input_submitted(self, event: Input.Submitted):
+        """处理输入提交"""
+        if event.input.id == "message-input":
+            await self._send_message()
+
+    async def on_button_pressed(self, event: Button.Pressed):
+        """处理按钮点击"""
+        button_id = event.button.id
+
+        if button_id == "send-button":
+            await self._send_message()
+        elif button_id == "new-session":
+            self.action_new_session()
+        elif button_id == "save-session":
+            self.action_save_session()
+        elif button_id == "load-session":
+            self.action_load_session()
+        elif button_id == "clear-history":
+            self.action_clear_history()
+        elif button_id == "set-system-prompt":
+            self.action_set_system_prompt()
+
+    async def _send_message(self):
+        """发送当前输入的消息"""
+        if not self.current_session or self.is_streaming:
+            return
+
+        input_widget = self.query_one("#message-input", Input)
+        message = input_widget.value.strip()
+
+        if not message:
+            return
+
+        # 清空输入框
+        input_widget.value = ""
+
+        # 显示用户消息
+        self._add_message_to_log("user", message)
+
+        # 禁用输入和按钮
+        self._set_input_state(disabled=True)
+        self.is_streaming = True
+
+        # 更新状态
+        self.query_one("#status-bar", Static).update("AI 正在思考...")
+
+        try:
+            # 发送消息并获取响应
+            response = await self.current_session.send_message(message)
+
+            # 显示AI响应
+            self._add_message_to_log("assistant", response)
+
+        except Exception as e:
+            error_msg = f"请求失败: {str(e)}"
+            logger.error(error_msg)
+            self._add_message_to_log("assistant", f"[red]{error_msg}[/red]")
+            self.notify(error_msg, severity="error")
+
+        finally:
+            # 恢复输入和按钮
+            self._set_input_state(disabled=False)
+            self.is_streaming = False
+            self.query_one("#status-bar", Static).update("就绪")
+            input_widget.focus()
+
+    def _set_input_state(self, disabled: bool):
+        """设置输入控件状态"""
+        self.query_one("#message-input", Input).disabled = disabled
+        self.query_one("#send-button", Button).disabled = disabled
+
+    async def action_save_session(self):
+        """保存当前会话到文件"""
+        if not self.current_session:
+            self.notify("无当前会话", severity="error")
+            return
+
+        # 默认保存到 data/chat_sessions/ 目录
+        save_dir = Path(config_var.get()["paths"]["data"]) / "chat_sessions"
+        save_dir.mkdir(exist_ok=True, parents=True)
+
+        file_path = save_dir / f"{self.current_session.session_id}.json"
+        self.current_session.save_to_file(file_path)
+
+        self.notify(f"会话已保存到 {file_path}", severity="information")
+
+    async def action_load_session(self):
+        """从文件加载会话"""
+        # 简化实现：加载默认目录下的第一个会话文件
+        save_dir = Path(config_var.get()["paths"]["data"]) / "chat_sessions"
+        if not save_dir.exists():
+            self.notify(f"目录不存在: {save_dir}", severity="error")
+            return
+
+        session_files = list(save_dir.glob("*.json"))
+        if not session_files:
+            self.notify("未找到会话文件", severity="error")
+            return
+
+        # 使用第一个文件（在实际应用中可以让用户选择）
+        file_path = session_files[0]
+
+        try:
+            # 获取 LLM 提供者
+            provider_name = config_var.get()["services"]["llm"]
+            provider_config = config_var.get()["providers"]["llm"][provider_name]
+            from heurams.providers.llm import providers as prov
+
+            llm_provider = prov[provider_name](provider_config)
+
+            # 加载会话
+            self.current_session = ChatSession.load_from_file(file_path, llm_provider)
+
+            # 更新聊天管理器
+            self.chat_manager.sessions[self.current_session.session_id] = (
+                self.current_session
+            )
+
+            # 更新UI
+            self.query_one("#current-session-label", Static).update(
+                f"{self.current_session.session_id}"
+            )
+            self._display_history()
+
+            self.notify(f"已加载会话: {file_path.name}", severity="information")
+
+        except Exception as e:
+            logger.error("加载会话失败: %s", e)
+            self.notify(f"加载失败: {str(e)}", severity="error")
+
+    async def action_new_session(self):
+        """创建新会话"""
+        # 简单实现：使用时间戳作为会话ID
+        import time
+
+        new_session_id = f"session_{int(time.time())}"
+
+        self.current_session = self.chat_manager.get_session(new_session_id)
+
+        # 更新UI
+        self.query_one("#current-session-label", Static).update(
+            f"{self.current_session.session_id}"
+        )
+        self._display_history()
+
+        self.notify(f"已创建新会话: {new_session_id}", severity="information")
+        self.query_one("#message-input", Input).focus()
+
+    async def action_clear_history(self):
+        """清空当前会话历史"""
+        if not self.current_session:
+            return
+
+        self.current_session.clear_history()
+        self._display_history()
+        self.notify("历史已清空", severity="information")
+
+    async def action_set_system_prompt(self):
+        """设置系统提示词"""
+        if not self.current_session:
+            return
+
+        # 使用输入框获取新提示词
+        input_widget = self.query_one("#message-input", Input)
+        current_value = input_widget.value
+
+        # 临时修改输入框提示
+        input_widget.placeholder = "输入系统提示词... (按 Enter 确认, Esc 取消)"
+        input_widget.value = self.current_session.system_prompt
+
+        # 等待用户输入
+        self.notify("请输入系统提示词，按 Enter 确认", severity="information")
+
+        # 实际应用中需要更复杂的交互，这里简化处理
+        # 用户手动输入后按 Enter 会触发 on_input_submitted
+        # 这里我们只修改占位符，实际系统提示词设置需要额外界面
+
+    def action_focus_input(self):
+        """聚焦到输入框"""
+        self.query_one("#message-input", Input).focus()
+
+    def action_go_back(self):
+        """返回上级屏幕"""
+        self.app.pop_screen()
--- a/src/heurams/interface/screens/memoqueue.py
+++ b/src/heurams/interface/screens/memoqueue.py
@@ -1,6 +1,8 @@
 """队列式记忆工作界面"""

 from enum import Enum, auto
+from pathlib import Path
+from typing import Callable

 from textual.app import ComposeResult
 from textual.containers import Center, ScrollableContainer
@@ -8,10 +10,11 @@ from textual.reactive import reactive
 from textual.screen import Screen
 from textual.widgets import Button, Footer, Header, Label, Static

-import heurams.kernel.puzzles as pz
 import heurams.kernel.particles as pt
+import heurams.kernel.puzzles as pz
 from heurams.context import config_var
 from heurams.kernel.reactor import *
+from heurams.services.favorite_service import favorite_manager
 from heurams.services.logger import get_logger

 from .. import shim
@@ -31,6 +34,7 @@ class MemScreen(Screen):
        ("p", "prev", "查看上一个"),
        ("d", "toggle_dark", ""),
        ("v", "play_voice", "朗读"),
+        ("*", "toggle_favorite", "收藏"),
        ("0,1,2,3", "app.push_screen('about')", ""),
    ]

@@ -42,12 +46,16 @@ class MemScreen(Screen):
    def __init__(
        self,
        phaser: Phaser,
+        save_func: Callable,
+        repo=None,
        name=None,
        id=None,
        classes=None,
    ) -> None:
        super().__init__(name, id, classes)
        self.phaser = phaser
+        self.save_func = save_func
+        self.repo = repo
        self.update_state()
        self.fission: Fission

@@ -63,6 +71,7 @@ class MemScreen(Screen):
        self.procession: Procession = self.phaser.current_procession()  # type: ignore
        self.atom: pt.Atom = self.procession.current_atom  # type: ignore
        
+
    def on_mount(self):
        self.fission = self.procession.get_fission()
        self.mount_puzzle()
@@ -80,27 +89,32 @@ class MemScreen(Screen):

    def _get_progress_text(self):
        s = f"阶段: {self.procession.phase.name}\n"
+        # 收藏状态
+        if self.repo is not None:
+            fav_status = "已收藏" if self._is_current_atom_favorited() else "未收藏"
+            s += f"收藏: {fav_status}\n"
+        if config_var.get().get("debug_topline", 0):
            try:
-            alia = self.fission.get_current_puzzle_inf()['alia'] # type: ignore
+                alia = self.fission.get_current_puzzle_inf()["alia"]  # type: ignore
                s += f"谜题: {alia}\n"
            except:
                pass
            try:
-            stat = self.phaser.__repr__('simple', '')
+                stat = self.phaser.__repr__("simple", "")
                s += f"{stat}\n"
            except:
                pass
            try:
-            stat = self.procession.__repr__('simple', '')
+                stat = self.procession.__repr__("simple", "")
                s += f"{stat}\n"
            except:
                pass
            try:
-            stat = self.fission.__repr__('simple', '')
+                stat = self.fission.__repr__("simple", "")
                s += f"{stat}\n"
            except Exception as e:
                s = str(e)
-        #s += f"当前进度: {self.procession.process() + 1}/{self.procession.total_length()}"
+        s += f"进度: {self.procession.process() + 1}/{self.procession.total_length()}"
        return s

    def update_display(self):
@@ -110,6 +124,9 @@ class MemScreen(Screen):

    def mount_puzzle(self):
        """挂载当前谜题组件"""
+        if self.procession.phase == PhaserState.FINISHED:
+            self.mount_finished_widget()
+            return
        container = self.query_one("#puzzle-container")
        for i in container.children:
            i.remove()
@@ -122,7 +139,9 @@ class MemScreen(Screen):
            i.remove()
        from heurams.interface.widgets.finished import Finished

-        container.mount(Finished())
+        if config_var.get().get("persist_to_file", 0):
+            self.save_func()
+        container.mount(Finished(is_saved=config_var.get().get("persist_to_file", 0)))

    def on_button_pressed(self, event):
        event.stop()
@@ -150,32 +169,46 @@ class MemScreen(Screen):
    def watch_rating(self, old_rating, new_rating) -> None:
        if new_rating == -1:  # 安全值
            return
+        self.update_state()
+        if self.procession.phase == PhaserState.FINISHED:
+            rating = -1
+            return
        self.fission.report(new_rating)
        self.forward(new_rating)
        self.rating = -1

+
    def forward(self, rating):
        self.update_state()
        allow_forward = 1 if rating >= 4 else 0
        if allow_forward:
            self.fission.forward()
-        if self.fission.state == 'retronly':
+        if self.fission.state == "retronly":
            self.forward_atom(self.fission.get_quality())
        self.update_state()
        self.mount_puzzle()
        self.update_display()

+    def atom_reporter(self, quality):
+        if not self.atom.registry["runtime"]["locked"]:
+            if not self.atom.registry["electron"].is_activated():
+                self.atom.registry["electron"].activate()
+                logger.debug(f"激活原子 {self.atom}")
+                self.atom.lock(1)
+                self.atom.minimize(5)
+            else:
+                self.atom.minimize(quality)
+        else:
+            pass
+
    def forward_atom(self, quality):
        logger.debug(f"Quality: {quality}")
+        self.atom_reporter(quality)
        if quality <= 3:
            self.procession.append()
            self.update_state()  # 刷新状态
        self.procession.forward(1)
        self.update_state()  # 刷新状态
-        if self.procession.phase == PhaserState.FINISHED:  # 若所有队列都结束了
-            logger.debug(f"记忆进程结束")
-            self.mount_finished_widget()
-            return
        self.fission = self.procession.get_fission()

    def action_go_back(self):
@@ -186,3 +219,40 @@ class MemScreen(Screen):

    def action_quick_fail(self):
        self.rating = 3
+
+    def _get_repo_rel_path(self) -> str:
+        """获取仓库相对路径（相对于 data/repo）"""
+        if self.repo is None:
+            return ""
+        # self.repo.source 是 Path 对象，指向仓库目录
+        repo_full_path = self.repo.source
+        data_repo_path = Path(config_var.get()["paths"]["data"]) / "repo"
+        try:
+            rel_path = repo_full_path.relative_to(data_repo_path)
+            return str(rel_path)
+        except ValueError:
+            # 如果不在 data/repo 下，则返回完整路径（字符串形式）
+            return str(repo_full_path)
+
+    def _is_current_atom_favorited(self) -> bool:
+        """检查当前原子是否已收藏"""
+        if self.repo is None:
+            return False
+        repo_path = self._get_repo_rel_path()
+        return favorite_manager.has(repo_path, self.atom.ident)
+
+    def action_toggle_favorite(self):
+        """切换收藏状态"""
+        if self.repo is None:
+            self.app.notify("无法收藏：未关联仓库", severity="error")
+            return
+        repo_path = self._get_repo_rel_path()
+        ident = self.atom.ident
+        if favorite_manager.has(repo_path, ident):
+            favorite_manager.remove(repo_path, ident)
+            self.app.notify(f"已取消收藏：{ident}", severity="information")
+        else:
+            favorite_manager.add(repo_path, ident)
+            self.app.notify(f"已收藏：{ident}", severity="information")
+        # 更新显示（如果需要）
+        self.update_display()
--- a/src/heurams/interface/screens/navigator.py
+++ b/src/heurams/interface/screens/navigator.py
@@ -0,0 +1,94 @@
+import webbrowser
+
+from textual.app import ComposeResult
+from textual.containers import Grid, ScrollableContainer
+from textual.screen import ModalScreen
+from textual.widgets import Button, Footer, Header, Label, ListItem, ListView, Static
+
+from heurams.context import *
+from heurams.services.logger import get_logger
+
+from .favmgr import FavoriteManagerScreen
+
+logger = get_logger(__name__)
+
+
+class NavigatorScreen(ModalScreen):
+    """导航器模态窗口"""
+
+    BINDINGS = [
+        ("q", "go_back", "返回"),
+        ("escape", "go_back", "返回"),
+        ("n", "go_back", "切换"),
+    ]
+
+    SCREENS = [
+        ("仪表盘", "dashboard"),
+        ("电台", "radio"),
+        ("语言模型集成", "llmchat"),
+        #        ("创建仓库", "repo_creator"),
+        ("缓存管理器", "precache_all"),
+        ("收藏夹管理器", FavoriteManagerScreen),
+        ("配置设置", "config"),
+        ("关于此软件", "about"),
+        ("调试日志", "logviewer"),
+        #        ("同步工具", "synctool"),
+        #        ("仓库编辑器", "repo_editor"),
+    ]
+
+    OTHERS = [
+        ("退出程序", "self.app.exit()"),
+        ("项目主页", "webbrowser.open('https://ams.imwangzhiyu.xyz')"),
+    ]
+
+    def compose(self) -> ComposeResult:
+        """组合界面组件"""
+        with Grid(id="dialog"):
+            yield Label(
+                "[b]请选择要跳转的功能\n或记忆会话实例[/b]\n\n将在此处显示提示",
+                classes="title-label",
+            )
+            yield ListView(
+                *[ListItem(Label(title)) for title, _ in (self.SCREENS + self.OTHERS)],
+                id="nav-list",
+                classes="nav-list-view",
+            )
+            yield Static("按下回车以完成切换\n所有会话将被保存")
+            yield Button(
+                "关闭 (n)", id="close_button", variant="primary", classes="close-button", flat=True
+            )
+
+    def on_mount(self) -> None:
+        # 设置焦点到列表
+        nav_list = self.query_one("#nav-list", ListView)
+        nav_list.focus()
+
+    def on_list_view_selected(self, event) -> None:
+        if not isinstance(event.item, ListItem):
+            return
+        selected_label = event.item.query_one(Label)
+        label_text = str(selected_label.render())
+        # 查找对应的屏幕标识
+        for title, screen_id in self.SCREENS:
+            if title == label_text:
+                self.app.pop_screen()
+                # 跳转到目标屏幕
+                if isinstance(screen_id, str):
+                    # 已注册的字符串标识符
+                    self.app.push_screen(screen_id)
+                else:
+                    self.app.push_screen(screen_id())
+                return
+        for title, cmd in self.OTHERS:
+            if title == label_text:
+                exec(cmd)
+                return
+        return
+
+    def on_button_pressed(self, event) -> None:
+        event.stop()
+        if event.button.id == "close_button":
+            self.action_go_back()
+
+    def action_go_back(self) -> None:
+        self.app.pop_screen()
--- a/src/heurams/interface/screens/precache.py
+++ b/src/heurams/interface/screens/precache.py
@@ -3,7 +3,7 @@
 import pathlib

 from textual.app import ComposeResult
-from textual.containers import Horizontal, ScrollableContainer
+from textual.containers import Horizontal, ScrollableContainer, Container
 from textual.screen import Screen
 from textual.widgets import Button, Footer, Header, Label, ProgressBar, Static
 from textual.worker import get_current_worker
@@ -12,7 +12,18 @@ import heurams.kernel.particles as pt
 import heurams.services.hasher as hasher
 from heurams.context import *

-cache_dir = pathlib.Path(config_var.get()["paths"]["data"]) / "cache" / "voice"
+# 兼容性缓存路径：优先使用 paths.cache，否则使用 data/cache
+paths = config_var.get()["paths"]
+cache_dir = pathlib.Path(paths.get("cache", paths["data"] + "/cache")) / "voice"
+
+
+def format_size(bytes_num: int) -> str:
+    """将字节数格式化为人类可读的字符串"""
+    for unit in ['B', 'KB', 'MB', 'GB', 'TB']:
+        if bytes_num < 1024.0:
+            return f"{bytes_num:.2f} {unit}"
+        bytes_num /= 1024.0 # type: ignore
+    return f"{bytes_num:.2f} PB"


 class PrecachingScreen(Screen):
@@ -26,7 +37,9 @@ class PrecachingScreen(Screen):
    """

    SUB_TITLE = "缓存管理器"
-    BINDINGS = [("q", "go_back", "返回")]
+    BINDINGS = [
+        ("q", "go_back", "返回"),
+    ]

    def __init__(self, nucleons: list = [], desc: str = ""):
        super().__init__(name=None, id=None, classes=None)
@@ -40,12 +53,56 @@ class PrecachingScreen(Screen):
        self.precache_worker = None
        self.cancel_flag = 0
        self.desc = desc
+        # 不再需要缓存配置，保留配置读取以兼容
+        self.cache_stats = {"total_size": 0, "file_count": 0, "human_size": "0 B", "cached_units": 0, "total_units": 0, "cache_rate": 0}
+        self._update_cache_stats()
+
+    def _get_total_units(self) -> int:
+        """获取所有仓库的总单元数"""
+        from heurams.context import config_var
+        from heurams.kernel.repolib import Repo
+        repo_path = pathlib.Path(config_var.get()["paths"]["data"]) / "repo"
+        repo_dirs = Repo.probe_valid_repos_in_dir(repo_path)
+        repos = map(Repo.create_from_repodir, repo_dirs)
+        total = 0
+        for repo in repos:
+            try:
+                total += len(repo.ident_index)
+            except:
+                continue
+        return total
+
+    def _update_cache_stats(self) -> None:
+        """更新缓存统计信息"""
+        total_size = 0
+        file_count = 0
+        cached_units = 0
+        if cache_dir.exists():
+            for file in cache_dir.rglob("*"):
+                if file.is_file():
+                    total_size += file.stat().st_size
+                    file_count += 1
+                    if file.suffix.lower() == ".wav":
+                        cached_units += 1
+        total_units = self._get_total_units()
+        cache_rate = (cached_units / total_units * 100) if total_units > 0 else 0
+        
+        self.cache_stats["total_size"] = total_size
+        self.cache_stats["file_count"] = file_count
+        self.cache_stats["human_size"] = format_size(total_size)
+        self.cache_stats["cached_units"] = cached_units
+        self.cache_stats["total_units"] = total_units
+        self.cache_stats["cache_rate"] = cache_rate

    def compose(self) -> ComposeResult:
        yield Header(show_clock=True)
        with ScrollableContainer(id="precache_container"):
            yield Label("[b]音频预缓存[/b]", classes="title-label")
-
+            with Container():
+                yield Static(
+                    f"缓存率: {self.cache_stats.get('cache_rate', 0):.1f}% (已缓存 {self.cache_stats.get('cached_units', 0)} / {self.cache_stats.get('total_units', 0)} 个单元)",
+                    classes="cache-usage-text"
+                )
                if self.nucleons:
                    yield Static(f"目标单元归属: [b]{self.desc}[/b]", classes="target-info")
                    yield Static(f"单元数量: {len(self.nucleons)}", classes="target-info")
@@ -55,7 +112,6 @@ class PrecachingScreen(Screen):
                yield Static(id="status", classes="status-info")
                yield Static(id="current_item", classes="current-item")
                yield ProgressBar(total=100, show_eta=False, id="progress_bar")
-
                with Horizontal(classes="button-group"):
                    if not self.is_precaching:
                        yield Button("开始预缓存", id="start_precache", variant="primary")
@@ -63,7 +119,11 @@ class PrecachingScreen(Screen):
                        yield Button("取消预缓存", id="cancel_precache", variant="error")
                    yield Button("清空缓存", id="clear_cache", variant="warning")
                    yield Button("返回", id="go_back", variant="default")
-
+            with Container(classes="cache-info"):
+                yield Static(f"缓存路径: {cache_dir}", classes="cache-path")
+                yield Static(f"文件数: {self.cache_stats['file_count']}", classes="cache-count")
+                yield Static(f"总大小: {self.cache_stats['human_size']}", classes="cache-size")
+                yield Button("刷新", id="refresh_cache_stats", variant="default", flat=True)
                yield Static("若您离开此界面, 未完成的缓存进程会自动停止.")
                yield Static('缓存程序支持 "断点续传".')

@@ -72,6 +132,7 @@ class PrecachingScreen(Screen):
    def on_mount(self):
        """挂载时初始化状态"""
        self.update_status("就绪", "等待开始...")
+        self._update_cache_display()

    def update_status(self, status, current_item="", progress=None):
        """更新状态显示"""
@@ -86,6 +147,25 @@ class PrecachingScreen(Screen):
            progress_bar.progress = progress
            progress_bar.advance(0)  # 刷新显示

+    def _update_cache_display(self) -> None:
+        """更新缓存信息显示"""
+        # 更新统计信息
+        self._update_cache_stats()
+        # 更新缓存率进度条
+        # 更新缓存大小和文件数显示
+        cache_count_widget = self.query_one(".cache-count", Static)
+        cache_size_widget = self.query_one(".cache-size", Static)
+        cache_usage_text = self.query_one(".cache-usage-text", Static)
+        if cache_count_widget:
+            cache_count_widget.update(f"文件数: {self.cache_stats['file_count']}")
+        if cache_size_widget:
+            cache_size_widget.update(f"总大小: {self.cache_stats['human_size']}")
+        if cache_usage_text:
+            cache_usage_text.update(
+                f"缓存率: {self.cache_stats.get('cache_rate', 0):.1f}% "
+                f"(已缓存 {self.cache_stats.get('cached_units', 0)} / {self.cache_stats.get('total_units', 0)} 个单元)"
+            )
+
    def precache_by_text(self, text: str):
        """预缓存单段文本的音频"""
        from heurams.context import config_var, rootdir, workdir
@@ -151,7 +231,7 @@ class PrecachingScreen(Screen):
        from heurams.kernel.repolib import Repo

        repo_path = pathlib.Path(config_var.get()["paths"]["data"]) / "repo"
-        repo_dirs = Repo.probe_vaild_repos_in_dir(repo_path)
+        repo_dirs = Repo.probe_valid_repos_in_dir(repo_path)
        repos = map(Repo.create_from_repodir, repo_dirs)

        # 计算总项目数
@@ -207,12 +287,17 @@ class PrecachingScreen(Screen):

                shutil.rmtree(cache_dir, ignore_errors=True)
                self.update_status("已清空", "音频缓存已清空", 0)
+                self._update_cache_display()  # 更新缓存统计显示
            except Exception as e:
                self.update_status("错误", f"清空缓存失败: {e}")
            self.cancel_flag = 1
            self.processed = 0
            self.progress = 0

+        elif event.button.id == "refresh_cache_stats":
+            # 刷新缓存统计信息
+            self._update_cache_display()
+            self.app.notify("缓存信息已刷新", severity="information")
        elif event.button.id == "go_back":
            self.action_go_back()

@@ -220,8 +305,3 @@ class PrecachingScreen(Screen):
        if self.is_precaching and self.precache_worker:
            self.precache_worker.cancel()
        self.app.pop_screen()
-
-    def action_quit_app(self):
-        if self.is_precaching and self.precache_worker:
-            self.precache_worker.cancel()
-        self.app.exit()
--- a/src/heurams/interface/screens/preparation.py
+++ b/src/heurams/interface/screens/preparation.py
@@ -5,14 +5,14 @@ from textual.containers import ScrollableContainer
 from textual.reactive import reactive
 from textual.screen import Screen
 from textual.widget import Widget
-from textual.widgets import Button, Footer, Header, Label, Markdown, Static
+from textual.widgets import Button, Footer, Header, Label, Markdown, Static, Rule, Sparkline

 import heurams.kernel.particles as pt
 import heurams.services.hasher as hasher
 from heurams.context import *
 from heurams.context import config_var
-from heurams.services.logger import get_logger
 from heurams.kernel.repolib import *
+from heurams.services.logger import get_logger

 logger = get_logger(__name__)

@@ -34,6 +34,7 @@ class PreparationScreen(Screen):
        super().__init__(name=None, id=None, classes=None)
        self.repo = repo
        self.repostat = repostat
+        self.load_data()

    def compose(self) -> ComposeResult:
        yield Header(show_clock=True)
@@ -43,7 +44,7 @@ class PreparationScreen(Screen):
                f"仓库路径: {config_var.get()['paths']['data']}/repo/[b]{self.repostat['dirname']}[/b]"
            )
            yield Label(f"\n单元数量: {len(self.repo)}\n")
-            yield Label(f"单次记忆数量: {self.scheduled_num}", id="schnum_label")
+            yield Label(f"最小记忆分组: {self.scheduled_num}\n", id="schnum_label")

            yield Button(
                "开始记忆",
@@ -58,8 +59,13 @@ class PreparationScreen(Screen):
                classes="precache-button",
            )

-            yield Static(f"\n单元预览:\n")
-            yield Markdown(self._get_full_content().replace("/", ""), classes="full")
+            yield Static()
+            yield Sparkline(self.spark_line_arr, summary_function=max)
+            yield Rule()
+            #yield Static(str(self.spark_line_arr))
+            yield Static(f"单元状态预览:\n")
+            for i in self.content.splitlines():
+                yield Static(i, classes="full")
        yield Footer()
    
    # def watch_scheduled_num(self, old_scheduled_num, new_scheduled_num):
@@ -70,14 +76,27 @@ class PreparationScreen(Screen):
    #    except:
    #        pass

-    def _get_full_content(self):
+    def load_data(self):
        content = ""
+        spark_line_arr = []
        for i in self.repo.ident_index:
            n = pt.Nucleon.create_on_nucleonic_data(
                nucleonic_data=self.repo.nucleonic_data_lict.get_itemic_unit(i)
            )
-            content += f"- {n['content']}  \n"
-        return content
+            e = pt.Electron.create_on_electonic_data(electronic_data=self.repo.electronic_data_lict.get_itemic_unit(i))
+            statstr = ""
+
+            if e.is_activated():
+                statstr = '[#00ff00]A[/]'
+                if e.is_due():
+                    statstr = '[#ffff00]R[/]'
+                #statstr += ('[dim]' + str(e.rept(real_rept=True)).zfill(2)+'[/]')
+            else:
+                statstr = '[#ff0000]U[/]'
+            spark_line_arr.append(e.rept(real_rept=True))
+            content += f" {statstr} {n['content'].replace('/', '')}  \n"
+        self.content = content
+        self.spark_line_arr = spark_line_arr

    def action_go_back(self):
        self.app.pop_screen()
@@ -104,19 +123,27 @@ class PreparationScreen(Screen):
        event.stop()
        logger.debug("按下按钮")
        if event.button.id == "start_memorizing_button":
+            launch(repo=self.repo, app=self.app, scheduled_num=self.scheduled_num)
+
+        elif event.button.id == "precache_button":
+            self.action_precache()
+
+def launch(repo, app, scheduled_num):
+    if scheduled_num == -1:
+        scheduled_num = config_var.get()["scheduled_num"]
    atoms = list()
-            for i in self.repo.ident_index:
+    for i in repo.ident_index:
        n = pt.Nucleon.create_on_nucleonic_data(
-                    nucleonic_data=self.repo.nucleonic_data_lict.get_itemic_unit(i)
+            nucleonic_data=repo.nucleonic_data_lict.get_itemic_unit(i)
        )
        e = pt.Electron.create_on_electonic_data(
-                    electronic_data=self.repo.electronic_data_lict.get_itemic_unit(i)
+            electronic_data=repo.electronic_data_lict.get_itemic_unit(i)
        )
-                a = pt.Atom(n, e, self.repo.orbitic_data)
+        a = pt.Atom(n, e, repo.orbitic_data)
        atoms.append(a)

    atoms_to_provide = list()
-            left_new = self.scheduled_num
+    left_new = scheduled_num
    for i in atoms:
        i: pt.Atom
        if i.registry["electron"].is_activated():
@@ -126,12 +153,11 @@ class PreparationScreen(Screen):
            left_new -= 1
            if left_new >= 0:
                atoms_to_provide.append(i)
-            from .memoqueue import MemScreen
    import heurams.kernel.reactor as rt

-            pheser = rt.Phaser(atoms_to_provide)
-            memscreen = MemScreen(pheser)
-            self.app.push_screen(memscreen)
+    from .memoqueue import MemScreen

-        elif event.button.id == "precache_button":
-            self.action_precache()
+    pheser = rt.Phaser(atoms_to_provide)
+    save_func = repo.persist_to_repodir
+    memscreen = MemScreen(pheser, save_func, repo=repo)
+    app.push_screen(memscreen)
--- a/src/heurams/interface/screens/radio.py
+++ b/src/heurams/interface/screens/radio.py
@@ -1 +1,217 @@
+"""用于筛选当日记忆的条目 以音频形式重放"""
+
 """ "前进电台" 界面"""
+import os
+from pathlib import Path
+from typing import List, Optional
+
+from textual.app import ComposeResult
+from textual.containers import Container, ScrollableContainer
+from textual.reactive import reactive
+from textual.screen import Screen
+from textual.widgets import Button, Footer, Header, Label, Static
+
+import heurams.kernel.particles as pt
+from heurams.kernel.repolib import Repo
+from heurams.context import config_var
+from heurams.services.audio_service import play_by_path
+from heurams.services.hasher import get_md5
+from heurams.services.logger import get_logger
+from heurams.services.tts_service import convertor
+
+logger = get_logger(__name__)
+
+
+class RadioScreen(Screen):
+    SUB_TITLE = "电台"
+
+    BINDINGS = [
+        ("q", "go_back", "返回"),
+        ("space", "toggle_play", "播放/暂停"),
+    ]
+
+    # 当前播放的原子索引
+    current_index = reactive(0)
+    # 播放状态: 'stopped', 'playing', 'paused'
+    play_state = reactive("stopped")
+
+    def __init__(
+        self,
+        name: str | None = None,
+        id: str | None = None,
+        classes: str | None = None,
+    ) -> None:
+        super().__init__(name, id, classes)
+        self._organizer()
+
+    def _organizer(self):
+        repodirs = Repo.probe_valid_repos_in_dir(Path(config_var.get()['paths']['data']) / 'repo')
+        repos = list(map(lambda repodir: Repo.create_from_repodir(repodir), repodirs))
+        for repo in repos:
+            last_modify = 0.0
+            for i in repo.ident_index:
+                e = pt.Electron.create_on_electonic_data(
+                    electronic_data=repo.electronic_data_lict.get_itemic_unit(i)
+                )
+                last_modify = max(last_modify, e.las())
+            
+
+    def compose(self) -> ComposeResult:
+        yield Header(show_clock=True)
+        with Container(id="main"):
+            yield Label("[b]前进电台[/b]", classes="title")
+            yield Static(f"共 {len(self.atoms)} 条当日记忆", id="status")
+            with Container(id="controls"):
+                yield Button("播放", id="play", variant="success")
+                yield Button("暂停", id="pause", variant="primary")
+                yield Button("上一首", id="prev", variant="default")
+                yield Button("下一首", id="next", variant="default")
+                yield Button("停止", id="stop", variant="error")
+            yield ScrollableContainer(id="playlist")
+        yield Footer()
+
+    def on_mount(self) -> None:
+        """挂载后更新播放列表显示"""
+        self._update_playlist()
+
+    def _filter_due_atoms(self) -> List[pt.Atom]:
+        """筛选当日需要复习的原子（已激活且到期）"""
+        atoms = []
+        for ident in self.repo.ident_index:
+            n = pt.Nucleon.create_on_nucleonic_data(
+                nucleonic_data=self.repo.nucleonic_data_lict.get_itemic_unit(ident)
+            )
+            e = pt.Electron.create_on_electonic_data(
+                electronic_data=self.repo.electronic_data_lict.get_itemic_unit(ident)
+            )
+            a = pt.Atom(n, e, self.repo.orbitic_data)
+            # 仅选择已激活且到期的原子
+            if (
+                a.registry["electron"].is_activated()
+                and a.registry["electron"].is_due()
+            ):
+                atoms.append(a)
+        return atoms
+
+    def _update_playlist(self) -> None:
+        """更新播放列表显示"""
+        container = self.query_one("#playlist")
+        container.remove_children()
+        for idx, atom in enumerate(self.atoms):
+            content = atom.registry["nucleon"].get("content", "无内容")
+            prefix = "▶ " if idx == self.current_index else "  "
+            widget = Static(f"{prefix}{idx+1}. {content[:50]}...")
+            widget.set_class(idx == self.current_index, "current")
+            container.mount(widget)
+
+    def _get_audio_path(self, atom: pt.Atom) -> Path:
+        """返回音频文件路径，若不存在则生成"""
+        tts_text = atom.registry["nucleon"].get("tts_text", "")
+        if not tts_text:
+            tts_text = atom.registry["nucleon"].get("content", "")
+        voice_dir = Path(config_var.get()["paths"]["data"]) / "cache" / "voice"
+        voice_dir.mkdir(parents=True, exist_ok=True)
+        path = voice_dir / f"{get_md5(tts_text)}.wav"
+        if not path.exists():
+            convertor(tts_text, path)
+        return path
+
+    async def _play_atom(self, idx: int) -> None:
+        """播放指定索引的原子（异步）"""
+        if idx < 0 or idx >= len(self.atoms):
+            return
+        atom = self.atoms[idx]
+        try:
+            path = self._get_audio_path(atom)
+            self._current_path = path
+            # 在后台线程中播放，避免阻塞UI
+            await self.run_worker(
+                lambda: play_by_path(path), exclusive=True, thread=True
+            )
+        except Exception as e:
+            logger.error("播放失败: %s", e)
+
+    def _stop_playback(self) -> None:
+        """停止当前播放"""
+        if self._play_task and not self._play_task.done():
+            self._play_task.cancel()
+        self._play_task = None
+        self._current_path = None
+        self.play_state = "stopped"
+
+    async def _play_current(self) -> None:
+        """播放当前索引的原子"""
+        self._stop_playback()
+        self.play_state = "playing"
+        self._play_task = asyncio.create_task(self._play_atom(self.current_index))
+        try:
+            await self._play_task
+        except asyncio.CancelledError:
+            pass
+        finally:
+            if self.play_state == "playing":
+                self.play_state = "stopped"
+
+    # 按钮事件处理
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        button_id = event.button.id
+        if button_id == "play":
+            self.action_toggle_play()
+        elif button_id == "pause":
+            self.action_pause()
+        elif button_id == "prev":
+            self.action_prev()
+        elif button_id == "next":
+            self.action_next()
+        elif button_id == "stop":
+            self.action_stop()
+
+    # 键盘动作
+    def action_toggle_play(self) -> None:
+        if self.play_state == "playing":
+            self.action_pause()
+        else:
+            self.action_play()
+
+    def action_play(self) -> None:
+        if self.play_state != "playing":
+            if self.play_state == "paused":
+                # 恢复播放（目前暂停功能简单实现为停止）
+                self.play_state = "playing"
+            else:
+                asyncio.create_task(self._play_current())
+
+    def action_pause(self) -> None:
+        if self.play_state == "playing":
+            self._stop_playback()
+            self.play_state = "paused"
+
+    def action_stop(self) -> None:
+        self._stop_playback()
+        self.play_state = "stopped"
+
+    def action_next(self) -> None:
+        if self.current_index < len(self.atoms) - 1:
+            self.current_index += 1
+            self._update_playlist()
+            if self.play_state == "playing":
+                asyncio.create_task(self._play_current())
+
+    def action_prev(self) -> None:
+        if self.current_index > 0:
+            self.current_index -= 1
+            self._update_playlist()
+            if self.play_state == "playing":
+                asyncio.create_task(self._play_current())
+
+    def action_go_back(self) -> None:
+        self._stop_playback()
+        self.app.pop_screen()
+
+    # 响应式更新
+    def watch_current_index(self, old: int, new: int) -> None:
+        self._update_playlist()
+
+    def watch_play_state(self, old: str, new: str) -> None:
+        # 更新按钮状态（可在此添加样式变化）
+        pass
--- a/src/heurams/interface/screens/repocreator.py
+++ b/src/heurams/interface/screens/repocreator.py
@@ -24,7 +24,7 @@ class RepoCreatorScreen(Screen):

        from heurams.context import config_var

-        template_dir = Path(config_var.get()["paths"]["template_dir"])
+        template_dir = Path(config_var.get()["paths"]["data"]) / "templates"
        templates = list()
        for i in template_dir.iterdir():
            if i.name.endswith(".toml"):
--- a/src/heurams/interface/screens/repoeditor.py
+++ b/src/heurams/interface/screens/repoeditor.py
@@ -0,0 +1,267 @@
+"""仓库编辑器, 使用TextArea控件等实现仓库配置编辑"""
+
+import json
+from pathlib import Path
+from typing import Optional
+
+import toml
+from textual.app import ComposeResult
+from textual.containers import Container, Horizontal, ScrollableContainer, Vertical
+from textual.reactive import reactive
+from textual.screen import Screen
+from textual.widgets import (
+    Button,
+    Footer,
+    Header,
+    Label,
+    ListItem,
+    ListView,
+    Static,
+    TextArea,
+)
+
+from heurams.context import config_var
+from heurams.kernel.repolib import Repo
+from heurams.services.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+class RepoEditorScreen(Screen):
+    """仓库编辑器屏幕"""
+
+    SUB_TITLE = "仓库编辑器"
+
+    BINDINGS = [
+        ("q", "go_back", "返回"),
+        ("s", "save_file", "保存"),
+        ("r", "reload_file", "重载"),
+        ("d", "toggle_dark", ""),
+    ]
+
+    # 当前选择的仓库路径
+    selected_repo_path: reactive[Optional[Path]] = reactive(None)
+    # 当前选择的文件名
+    selected_filename: reactive[Optional[str]] = reactive(None)
+    # 文件内容
+    file_content: reactive[str] = reactive("")
+
+    def __init__(
+        self,
+        repo: Optional[Repo] = None,
+        name: str | None = None,
+        id: str | None = None,
+        classes: str | None = None,
+    ) -> None:
+        super().__init__(name, id, classes)
+        self.repo = repo
+        self.repo_dir: Optional[Path] = None
+        self.file_list = []
+        if repo is not None and repo.source is not None:
+            self.repo_dir = repo.source
+            self._load_file_list()
+        # selected_repo_path 将在 on_mount 中设置，避免触发watch时组件未就绪
+
+    def _load_file_list(self) -> None:
+        """加载仓库目录下的文件列表"""
+        if self.repo_dir is None:
+            return
+        self.file_list = []
+        for fname in Repo.file_mapping.values():
+            fpath = self.repo_dir / fname
+            if fpath.exists():
+                self.file_list.append(fname)
+        # 也可能存在其他文件，但暂时只支持标准文件
+        self.file_list.sort()
+
+    def compose(self) -> ComposeResult:
+        """组合界面组件"""
+        yield Header(show_clock=True)
+        with Container(id="main_container"):
+            with Horizontal(id="top_panel"):
+                # 左侧: 仓库选择
+                with Vertical(id="repo_selector", classes="panel"):
+                    yield Label("仓库列表", classes="panel-title")
+                    yield ListView(
+                        *[
+                            ListItem(Label(repo_dir.name))
+                            for repo_dir in self._get_repo_dirs()
+                        ],
+                        id="repo_list",
+                        classes="list-view",
+                    )
+                # 中间: 文件列表
+                with Vertical(id="file_selector", classes="panel"):
+                    yield Label("文件列表", classes="panel-title")
+                    yield ListView(
+                        *[ListItem(Label(fname)) for fname in self.file_list],
+                        id="file_list",
+                        classes="list-view",
+                    )
+                # 右侧: 编辑区域
+                with Vertical(id="editor_panel", classes="panel"):
+                    yield Label("编辑文件", classes="panel-title")
+                    yield TextArea(
+                        id="text_editor",
+                        language="plaintext",
+                        classes="text-editor",
+                    )
+                    with Horizontal(id="button_bar"):
+                        yield Button("保存", id="save_button", variant="primary")
+                        yield Button("重载", id="reload_button", variant="default")
+                        yield Button("返回", id="back_button", variant="error")
+        yield Footer()
+
+    def _get_repo_dirs(self) -> list[Path]:
+        """获取data/repo/下所有有效仓库目录"""
+        repo_root = Path(config_var.get()["paths"]["data"]) / "repo"
+        repo_dirs = []
+        if repo_root.exists():
+            for entry in repo_root.iterdir():
+                if entry.is_dir():
+                    # 检查是否存在 manifest.toml
+                    if (entry / "manifest.toml").exists():
+                        repo_dirs.append(entry)
+        return repo_dirs
+
+    def on_mount(self) -> None:
+        """挂载组件时初始化"""
+        # 如果已有仓库，设置 selected_repo_path 以触发watch（此时组件已就绪）
+        if self.repo_dir is not None:
+            self.selected_repo_path = self.repo_dir
+        # 焦点放在仓库列表
+        self.query_one("#repo_list", ListView).focus()
+
+    def watch_selected_repo_path(
+        self, old_path: Optional[Path], new_path: Optional[Path]
+    ) -> None:
+        """当选择的仓库路径变化时，加载文件列表"""
+        if new_path is None:
+            self.file_list = []
+            self.selected_filename = None
+            self.file_content = ""
+            return
+        self.repo_dir = new_path
+        self._load_file_list()
+        # 如果组件已挂载，更新UI
+        if self.is_mounted:
+            file_list_view = self.query_one("#file_list", ListView)
+            file_list_view.clear()
+            for fname in self.file_list:
+                file_list_view.append(ListItem(Label(fname)))
+            # 清空编辑器
+            self.query_one("#text_editor", TextArea).text = ""
+        self.selected_filename = None
+
+    def watch_selected_filename(
+        self, old_name: Optional[str], new_name: Optional[str]
+    ) -> None:
+        """当选择的文件名变化时，加载文件内容"""
+        if new_name is None or self.repo_dir is None:
+            self.file_content = ""
+            return
+        file_path = self.repo_dir / new_name
+        if not file_path.exists():
+            self.notify(f"文件不存在: {new_name}", severity="error")
+            return
+        try:
+            content = file_path.read_text(encoding="utf-8")
+            self.file_content = content
+            # 如果组件已挂载，更新编辑器
+            if self.is_mounted:
+                editor = self.query_one("#text_editor", TextArea)
+                editor.text = content
+                # 根据文件后缀设置语言
+                if new_name.endswith(".toml"):
+                    editor.language = "toml"
+                elif new_name.endswith(".json"):
+                    editor.language = "json"
+                else:
+                    editor.language = "plaintext"
+        except Exception as e:
+            logger.error(f"读取文件失败: {e}")
+            self.notify(f"读取文件失败: {e}", severity="error")
+
+    def watch_file_content(self, old_content: str, new_content: str) -> None:
+        """当文件内容变化时更新编辑器（仅当外部改变时）"""
+        # 目前不需要做任何事情，因为编辑器内容已绑定
+        pass
+
+    def on_list_view_selected(self, event) -> None:
+        """处理列表项选择事件"""
+        if not isinstance(event.item, ListItem):
+            return
+        list_id = event.list_view.id
+        selected_label = event.item.query_one(Label)
+        selected_text = str(selected_label.render())
+
+        if list_id == "repo_list":
+            # 用户选择了仓库
+            repo_root = Path(config_var.get()["paths"]["data"]) / "repo"
+            selected_dir = repo_root / selected_text
+            if selected_dir.exists():
+                self.selected_repo_path = selected_dir
+        elif list_id == "file_list":
+            # 用户选择了文件
+            if self.repo_dir is None:
+                self.notify("请先选择仓库", severity="warning")
+                return
+            self.selected_filename = selected_text
+
+    def on_button_pressed(self, event) -> None:
+        """处理按钮点击事件"""
+        event.stop()
+        if event.button.id == "save_button":
+            self.action_save_file()
+        elif event.button.id == "reload_button":
+            self.action_reload_file()
+        elif event.button.id == "back_button":
+            self.action_go_back()
+
+    def action_save_file(self) -> None:
+        """保存当前编辑的文件"""
+        if self.repo_dir is None or self.selected_filename is None:
+            self.notify("未选择仓库或文件", severity="warning")
+            return
+        file_path = self.repo_dir / self.selected_filename
+        editor = self.query_one("#text_editor", TextArea)
+        new_content = editor.text
+        # 验证格式
+        try:
+            if self.selected_filename.endswith(".toml"):
+                toml.loads(new_content)  # 验证TOML
+            elif self.selected_filename.endswith(".json"):
+                json.loads(new_content)  # 验证JSON
+        except Exception as e:
+            self.notify(f"格式错误: {e}", severity="error")
+            return
+        # 写入文件
+        try:
+            file_path.write_text(new_content, encoding="utf-8")
+            self.notify("保存成功", severity="information")
+        except Exception as e:
+            logger.error(f"保存文件失败: {e}")
+            self.notify(f"保存文件失败: {e}", severity="error")
+
+    def action_reload_file(self) -> None:
+        """重新加载当前文件（放弃修改）"""
+        if self.repo_dir is None or self.selected_filename is None:
+            self.notify("未选择仓库或文件", severity="warning")
+            return
+        file_path = self.repo_dir / self.selected_filename
+        try:
+            content = file_path.read_text(encoding="utf-8")
+            editor = self.query_one("#text_editor", TextArea)
+            editor.text = content
+            self.notify("已重载", severity="information")
+        except Exception as e:
+            logger.error(f"重载文件失败: {e}")
+            self.notify(f"重载文件失败: {e}", severity="error")
+
+    def action_go_back(self) -> None:
+        """返回上一屏幕"""
+        self.app.pop_screen()
+
+    def action_toggle_dark(self) -> None:
+        """切换暗色模式"""
+        self.app.dark = not self.app.dark
--- a/src/heurams/interface/widgets/cloze_puzzle.py
+++ b/src/heurams/interface/widgets/cloze_puzzle.py
@@ -5,10 +5,11 @@ from typing import TypedDict
 from textual.containers import Container
 from textual.message import Message
 from textual.widget import Widget
-from textual.widgets import Button, Label
+from textual.widgets import Button, Label, Markdown

-import heurams.kernel.puzzles as pz
 import heurams.kernel.particles as pt
+import heurams.kernel.puzzles as pz
+from heurams.services.hasher import hash
 from heurams.services.logger import get_logger

 from .base_puzzle_widget import BasePuzzleWidget
@@ -65,7 +66,7 @@ class ClozePuzzle(BasePuzzleWidget):

    def compose(self):
        yield Label(self.puzzle.wording, id="sentence")
-        yield Label(f"当前输入: {self.inputlist}", id="inputpreview")
+        yield Markdown(f"> {self.listprint(self.inputlist)}", id="inputpreview")
        # 渲染当前问题的选项
        with Container(id="btn-container"):
            for i in self.ans:
@@ -76,9 +77,18 @@ class ClozePuzzle(BasePuzzleWidget):

        yield Button("退格", id="delete")

+    def listprint(self, lst):
+        s = ""
+        if lst:
+            lastone = lst[-1]
+            for i in lst[:-1]:
+                s += (i + ' ')
+            s += f" `{lastone}`"
+        return s
+
    def update_display(self):
        preview = self.query_one("#inputpreview")
-        preview.update(f"当前输入: {self.inputlist}")  # type: ignore
+        preview.update(f"> {self.listprint(self.inputlist)}")  # type: ignore

    def on_button_pressed(self, event: Button.Pressed) -> None:
        button_id = event.button.id
--- a/src/heurams/interface/widgets/finished.py
+++ b/src/heurams/interface/widgets/finished.py
@@ -7,24 +7,27 @@ class Finished(Widget):
        self,
        *children: Widget,
        alia="",
+        is_saved=0,
        name: str | None = None,
        id: str | None = None,
        classes: str | None = None,
        disabled: bool = False,
-        markup: bool = True
+        markup: bool = True,
    ) -> None:
        self.alia = alia
+        self.is_saved = is_saved
        super().__init__(
            *children,
            name=name,
            id=id,
            classes=classes,
            disabled=disabled,
-            markup=markup
+            markup=markup,
        )

    def compose(self):
        yield Label("本次记忆进程结束", id="finished_msg")
+        yield Label(f"算法数据{'已保存' if self.is_saved else "未能保存"}")
        yield Button("返回上一级", id="back-to-menu")

    def on_button_pressed(self, event):
--- a/src/heurams/interface/widgets/mcq_puzzle.py
+++ b/src/heurams/interface/widgets/mcq_puzzle.py
@@ -5,8 +5,8 @@ from textual.containers import Container, ScrollableContainer
 from textual.widget import Widget
 from textual.widgets import Button, Label

-import heurams.kernel.puzzles as pz
 import heurams.kernel.particles as pt
+import heurams.kernel.puzzles as pz
 from heurams.services.hasher import hash
 from heurams.services.logger import get_logger

@@ -55,6 +55,8 @@ class MCQPuzzle(BasePuzzleWidget):

    def _load(self):
        cfg = self.atom.registry["nucleon"]["puzzles"][self.alia]
+        if cfg['mapping'] == {}:
+            self.screen.rating = 5 # type: ignore
        self.puzzle = pz.MCQPuzzle(
            cfg["mapping"], cfg["jammer"], int(cfg["max_riddles_num"]), cfg["prefix"]
        )
@@ -150,7 +152,7 @@ class MCQPuzzle(BasePuzzleWidget):
            for option in current_options:
                button_id = f"sel{str(self.cursor).zfill(3)}-{hash(option)}"
                if button_id not in self.hashmap:
-                    self.hashmap[button_id] = option
+                    self.hashmap[button_id[7:]] = option
                new_button = Button(option, id=button_id)
                container.mount(new_button)

--- a/src/heurams/interface/widgets/recognition.py
+++ b/src/heurams/interface/widgets/recognition.py
@@ -68,8 +68,6 @@ class Recognition(BasePuzzleWidget):
            f":{delim}": ":",
        }
        
-        nucleon = self.atom.registry["nucleon"]
-        metadata = self.atom.registry["nucleon"]
        primary = cfg["primary"]

        with Center():
@@ -90,12 +88,12 @@ class Recognition(BasePuzzleWidget):
        for item in cfg["secondary"]:
            if isinstance(item, list):
                for j in item:
-                    yield Markdown(f"### {metadata['annotation'][item]}: {j}")
+                    yield Markdown(f"### 笔记: {j}") #TODO ANNOTATION
                    continue
            if isinstance(item, Dict):
                total = ""
                for j, k in item.items():  # type: ignore
-                    total += f"> **{j}**: {k}  \n"
+                    total += f"> {j}: {k}  \n"
                yield Markdown(total)
            if isinstance(item, str):
                yield Markdown(item)
@@ -107,13 +105,3 @@ class Recognition(BasePuzzleWidget):
        if event.button.id == "ok":
            self.screen.rating = 5  # type: ignore
            self.handler(5)
-
-    def handler(self, rating):
-        if not self.atom.registry["runtime"]["locked"]:
-            if not self.atom.registry["electron"].is_activated():
-                self.atom.registry["electron"].activate()
-                logger.debug(f"激活原子 {self.atom}")
-                self.atom.lock(1)
-                self.atom.minimize(5)
-        else:
-            pass
--- a/src/heurams/kernel/auxiliary/init.py
+++ b/src/heurams/kernel/auxiliary/init.py
--- a/src/heurams/kernel/auxiliary/evalizor.py
+++ b/src/heurams/kernel/auxiliary/evalizor.py
--- a/src/heurams/kernel/auxiliary/lict.py
+++ b/src/heurams/kernel/auxiliary/lict.py
--- a/src/heurams/kernel/auxiliary/refvar.py
+++ b/src/heurams/kernel/auxiliary/refvar.py
--- a/src/heurams/kernel/particles/init.py
+++ b/src/heurams/kernel/particles/init.py
@@ -3,8 +3,8 @@ from .electron import Electron
 from .nucleon import Nucleon
 from .placeholders import (
    AtomPlaceholder,
-    NucleonPlaceholder,
    ElectronPlaceholder,
+    NucleonPlaceholder,
    orbital_placeholder,
 )

--- a/src/heurams/kernel/particles/atom.py
+++ b/src/heurams/kernel/particles/atom.py
@@ -1,6 +1,5 @@
 from typing import TypedDict

-
 from heurams.services.logger import get_logger

 from .electron import Electron
--- a/src/heurams/kernel/particles/electron.py
+++ b/src/heurams/kernel/particles/electron.py
@@ -53,10 +53,19 @@ class Electron:
        result = self.algo.is_due(self.algodata)
        return result and self.is_activated()

+    def rept(self, real_rept = False):
+        if real_rept:
+            return self.algodata[self.algo.algo_name]['real_rept']
+        return self.algodata[self.algo.algo_name]['rept']
+
    def is_activated(self):
        result = self.algodata[self.algo.algo_name]["is_activated"]
        return result

+    def last_modify(self):
+        result = self.algodata[self.algo.algo_name]["last_modify"]
+        return result
+
    def get_rating(self):
        try:
            result = self.algo.get_rating(self.algodata)
@@ -68,6 +77,10 @@ class Electron:
        result = self.algo.nextdate(self.algodata)
        return result

+    def lastdate(self) -> int:
+        result = self.algodata[self.algo.algo_name]["lastdate"]
+        return result
+
    def revisor(self, quality: int = 5, is_new_activation: bool = False):
        """算法迭代决策机制实现

--- a/src/heurams/kernel/particles/nucleon.py
+++ b/src/heurams/kernel/particles/nucleon.py
@@ -1,9 +1,9 @@
 from copy import deepcopy
 from logging import config

-from heurams.services.logger import get_logger
-from heurams.utils.evalizor import Evalizer
 from heurams.context import config_var
+from heurams.services.logger import get_logger
+from heurams.kernel.auxiliary.evalizor import Evalizer

 logger = get_logger(__name__)

@@ -13,13 +13,28 @@ class Nucleon:

    def __init__(self, ident, payload, common):
        self.ident = ident
+        try:
+            data_safe = deepcopy((payload | common))
+            data_puz = deepcopy(data_safe['puzzles'])
+            data_safe['puzzles'] = {}
            env = {
-            "payload": payload,
+                "payload": data_safe,
                "default": config_var.get()["puzzles"],
-            "nucleon": (payload | common),
+                "nucleon": data_safe,
            }
            self.evalizer = Evalizer(environment=env)
-        self.data: dict = self.evalizer(deepcopy((payload | common)))  # type: ignore
+            data_safe = self.evalizer(deepcopy(data_safe))
+            env = {
+                "payload": data_safe,
+                "default": config_var.get()["puzzles"],
+                "nucleon": data_safe,
+            }
+            self.evalizer = Evalizer(environment=env)
+            data_puz = self.evalizer(deepcopy(data_puz))
+            data_safe['puzzles'] = data_puz # type: ignore
+            self.data: dict = data_safe # type: ignore
+        except Exception:
+            self.data = (payload | common)

    def __getitem__(self, key):
        if isinstance(key, str):
--- a/src/heurams/kernel/particles/placeholders.py
+++ b/src/heurams/kernel/particles/placeholders.py
@@ -1,7 +1,8 @@
 from heurams.kernel.particles import orbital
+
+from .atom import Atom
 from .electron import Electron
 from .nucleon import Nucleon
-from .atom import Atom

 orbital_placeholder = {
    "schedule": ["quick_review", "recognition", "final_review"],
--- a/src/heurams/kernel/reactor/fission.py
+++ b/src/heurams/kernel/reactor/fission.py
@@ -1,16 +1,18 @@
-from functools import reduce
 import random
-
-import heurams.kernel.puzzles as puz
-import heurams.kernel.particles as pt
-from heurams.services.logger import get_logger
+from functools import reduce

 from tabulate import tabulate as tabu
 from transitions import Machine
+
+import heurams.kernel.particles as pt
+import heurams.kernel.puzzles as puz
+from heurams.services.logger import get_logger
+
 from .states import FissionState, PhaserState

 logger = get_logger(__name__)

+
 class Fission(Machine):
    """单原子调度展开器"""

@@ -21,32 +23,6 @@ class Fission(Machine):
        self.current_puzzle_inf: dict
        # phase 为 PhaserState 枚举实例, 需要获取其value
        phase_value = phase.value
-        orbital_schedule = atom.registry["orbital"]["phases"][phase_value]  # type: ignore
-        orbital_puzzles = atom.registry["nucleon"]["puzzles"]
-        self.puzzles_inf = list()
-        self.min_ratings = []
-        for item, possibility in orbital_schedule:  # type: ignore
-            logger.debug(f"开始处理: {item}")
-            if not isinstance(possibility, float):
-                possibility = float(possibility)
-
-            while possibility > 1:
-                self.puzzles_inf.append(
-                    {
-                        "puzzle": puz.puzzles[orbital_puzzles[item]["__origin__"]],
-                        "alia": item,
-                    }
-                )
-                possibility -= 1
-
-            if random.random() <= possibility:
-                self.puzzles_inf.append(
-                    {
-                        "puzzle": puz.puzzles[orbital_puzzles[item]["__origin__"]],
-                        "alia": item,
-                    }
-                )
-        self.current_puzzle_inf = self.puzzles_inf[0]
        states = [
            {"name": FissionState.EXAMMODE.value},
            {"name": FissionState.RETRONLY.value},
@@ -59,9 +35,46 @@ class Fission(Machine):
                "dest": FissionState.RETRONLY.value,
            },
        ]
+        if phase == PhaserState.FINISHED:
+            Machine.__init__(
+                self,
+                states=states,
+                transitions=transitions,
+                initial=FissionState.EXAMMODE.value,
+            )
+            return
+        orbital_schedule = atom.registry["orbital"]["phases"][phase_value]  # type: ignore
+        orbital_puzzles = atom.registry["nucleon"]["puzzles"]
+        self.puzzles_inf = list()
+        self.min_ratings = []
+        for item, possibility in orbital_schedule:  # type: ignore
+            logger.debug(f"开始处理: {item}")
+
+            puzzle = puz.puzzles[orbital_puzzles[item]["__origin__"]]
+
+            if not isinstance(possibility, float):
+                possibility = float(possibility)
+
+            while possibility > 1:
+                self.puzzles_inf.append(
+                    {
+                        "puzzle": puzzle,
+                        "alia": item,
+                    }
+                )
+                possibility -= 1
+
+            if random.random() <= possibility:
+                self.puzzles_inf.append(
+                    {
+                        "puzzle": puzzle,
+                        "alia": item,
+                    }
+                )
+        self.current_puzzle_inf = self.puzzles_inf[0]

        for i in range(len(self.puzzles_inf)):
-            self.min_ratings.append(0x3f3f3f3f)
+            self.min_ratings.append(0x3F3F3F3F)

        Machine.__init__(
            self,
@@ -71,30 +84,28 @@ class Fission(Machine):
        )

    def get_puzzles_inf(self):
-        if self.state == 'retronly':
-            return [{"puzzle": puz.puzzles['recognition'], "alia": "Recognition"}]
+        if self.state == "retronly":
+            return [{"puzzle": puz.puzzles["recognition"], "alia": "Recognition"}]
        return self.puzzles_inf

    def get_current_puzzle_inf(self):
-        if self.state == 'retronly':
-            return {"puzzle": puz.puzzles['recognition'], "alia": "Recognition"}
+        if self.state == "retronly":
+            return {"puzzle": puz.puzzles["recognition"], "alia": "Recognition"}
        return self.current_puzzle_inf

    def report(self, rating):
        self.min_ratings[self.cursor] = min(rating, self.min_ratings[self.cursor])

    def get_quality(self):
-        logger.debug(f"CState: {self.state}")
        if self.is_state("retronly", self):
            return reduce(lambda x, y: min(x, y), self.min_ratings)
        raise IndexError

    def forward(self, step=1):
        """将谜题指针向前移动并依情况更新或完成"""
-        logger.debug("Procession.forward: step=%d, 当前 cursor=%d", step, self.cursor)
        self.cursor += step
        if self.cursor >= len(self.puzzles_inf):
-            if self.state != 'retronly':
+            if self.state != "retronly":
                self.finish()
        else:
            self.current_puzzle_inf = self.puzzles_inf[self.cursor]
@@ -108,7 +119,7 @@ class Fission(Machine):
                "Atom": truncate(self.atom.ident),
                "State": self.state,
                "Progress": f"{self.cursor + 1} / {len(self.puzzles_inf)}",
-                "Queue": list(map(lambda f: truncate(f['alia']), self.puzzles_inf)),
+                "Queue": list(map(lambda f: truncate(f["alia"]), self.puzzles_inf)),
                "Current Puzzle": f"{self.current_puzzle_inf['alia']}@{self.current_puzzle_inf['puzzle'].__name__}",  # type: ignore
            }
        ]
--- a/src/heurams/kernel/reactor/phaser.py
+++ b/src/heurams/kernel/reactor/phaser.py
@@ -1,8 +1,8 @@
-from click import style
+from transitions import Machine
+
 import heurams.kernel.particles as pt
 from heurams.kernel.particles.placeholders import AtomPlaceholder
 from heurams.services.logger import get_logger
-from transitions import Machine

 from .procession import Procession
 from .states import PhaserState, ProcessionState
@@ -16,6 +16,7 @@ class Phaser(Machine):
    def __init__(self, atoms: list[pt.Atom]) -> None:
        logger.debug("Phaser.__init__: 原子数量=%d", len(atoms))

+        self.atoms = atoms
        new_atoms = list()
        old_atoms = list()

@@ -105,6 +106,9 @@ class Phaser(Machine):

    def on_finished(self):
        """进入FINISHED状态时的回调"""
+        for i in self.atoms:
+            i.lock(1)
+            i.revise()
        logger.debug("Phaser 进入 FINISHED 状态")

    def current_procession(self):
@@ -129,9 +133,10 @@ class Phaser(Machine):
        return Procession([AtomPlaceholder()], PhaserState.FINISHED)

    def __repr__(self, style="pipe", ends="\n"):
-        from heurams.services.textproc import truncate
        from tabulate import tabulate as tabu

+        from heurams.services.textproc import truncate
+
        lst = [
            {
                "Type": "Phaser",
--- a/src/heurams/kernel/reactor/procession.py
+++ b/src/heurams/kernel/reactor/procession.py
@@ -1,13 +1,15 @@
+from tabulate import tabulate as tabu
+from transitions import Machine
+
 import heurams.kernel.particles as pt
 from heurams.services.logger import get_logger
-from transitions import Machine
-from tabulate import tabulate as tabu

 from .fission import Fission
 from .states import PhaserState, ProcessionState

 logger = get_logger(__name__)

+
 class Procession(Machine):
    """队列: 标识单次记忆流程"""

--- a/src/heurams/kernel/reactor/states.py
+++ b/src/heurams/kernel/reactor/states.py
@@ -12,12 +12,15 @@ class PhaserState(Enum):
    FINAL_REVIEW = "final_review"
    FINISHED = "finished"

+
 class ProcessionState(Enum):
    ACTIVE = "active"
    FINISHED = "finished"

+
 class FissionState(Enum):
    EXAMMODE = "exammode"
    RETRONLY = "retronly"

+
 logger.debug("状态枚举定义已加载")
--- a/src/heurams/kernel/repolib/repo.py
+++ b/src/heurams/kernel/repolib/repo.py
@@ -7,7 +7,7 @@ import toml

 import heurams.kernel.particles as pt

-from ...utils.lict import Lict
+from heurams.kernel.auxiliary.lict import Lict


 class RepoManifest(TypedDict):
@@ -101,7 +101,7 @@ class Repo:
            source = self.source
        if source == None:
            raise FileNotFoundError("不存在仓库到文件的映射")
-        source.mkdir(parents=True, exist_ok=False)
+        source.mkdir(parents=True, exist_ok=True)
        for keyname in save_list:
            filename = self.file_mapping[keyname]
            with open(source / filename, "w") as f:
@@ -112,7 +112,7 @@ class Repo:
                if filename.endswith("toml"):
                    toml.dump(dict_data, f)
                elif filename.endswith("json"):
-                    json.dump(dict_data, f)
+                    json.dump(dict_data, f, ensure_ascii=False, indent=4)
                else:
                    raise ValueError(f"不支持的文件类型: {filename}")

@@ -167,7 +167,7 @@ class Repo:
            return 0

    @classmethod
-    def probe_vaild_repos_in_dir(cls, folder: Path):
+    def probe_valid_repos_in_dir(cls, folder: Path):
        lst = list()
        for i in folder.iterdir():
            if i.is_dir():
--- a/src/heurams/providers/audio/protocol.py
+++ b/src/heurams/providers/audio/protocol.py
@@ -1,13 +0,0 @@
-import pathlib
-from typing import Protocol
-
-from heurams.services.logger import get_logger
-
-logger = get_logger(__name__)
-
-
-class PlayFunctionProtocol(Protocol):
-    def __call__(self, path: pathlib.Path) -> None: ...
-
-
-logger.debug("音频协议模块已加载")
--- a/src/heurams/providers/llm/init.py
+++ b/src/heurams/providers/llm/init.py
@@ -1,6 +1,19 @@
 # 大语言模型
 from heurams.services.logger import get_logger

+from .base import BaseLLM
+from .openai import OpenAILLM
+
 logger = get_logger(__name__)

-logger.debug("LLM providers 模块已加载")
+__all__ = [
+    "BaseLLM",
+    "OpenAILLM",
+]
+
+providers = {
+    "base": BaseLLM,
+    "openai": OpenAILLM,
+}
+
+logger.debug("LLM providers 已注册: %s", list(providers.keys()))
--- a/src/heurams/providers/llm/base.py
+++ b/src/heurams/providers/llm/base.py
@@ -1,5 +1,55 @@
+"""LLM 提供者基类"""
+
+import asyncio
+from typing import Any, Dict, List, Optional
+
 from heurams.services.logger import get_logger

 logger = get_logger(__name__)

-logger.debug("LLM 基类模块已加载")
+
+class BaseLLM:
+    """LLM 提供者基类"""
+
+    name = "BaseLLM"
+
+    def __init__(self, config: Dict[str, Any]):
+        """初始化 LLM 提供者
+
+        Args:
+            config: 提供者配置字典
+        """
+        self.config = config
+        logger.debug("BaseLLM 初始化完成")
+
+    async def chat(self, messages: List[Dict[str, str]], **kwargs) -> str:
+        """发送聊天消息并获取响应
+
+        Args:
+            messages: 消息列表，每个消息为 {"role": "user"|"assistant"|"system", "content": "消息内容"}
+            **kwargs: 其他参数，如 temperature, max_tokens 等
+
+        Returns:
+            模型返回的文本响应
+        """
+        logger.debug("BaseLLM.chat: messages=%d, kwargs=%s", len(messages), kwargs)
+        logger.warning("BaseLLM.chat 是基类方法，未实现具体功能")
+        await asyncio.sleep(0)  # 避免未使用异步的警告
+        return "BaseLLM 未实现具体功能"
+
+    async def chat_stream(self, messages: List[Dict[str, str]], **kwargs):
+        """流式聊天（可选实现）
+
+        Args:
+            messages: 消息列表
+            **kwargs: 其他参数
+
+        Yields:
+            流式响应的文本块
+        """
+        logger.debug(
+            "BaseLLM.chat_stream: messages=%d, kwargs=%s", len(messages), kwargs
+        )
+        logger.warning("BaseLLM.chat_stream 是基类方法，未实现具体功能")
+        await asyncio.sleep(0)
+        yield "BaseLLM 未实现流式功能"
--- a/src/heurams/providers/llm/openai.py
+++ b/src/heurams/providers/llm/openai.py
@@ -1,5 +1,96 @@
+"""OpenAI 兼容 LLM 提供者"""
+
+import asyncio
+from typing import Any, AsyncGenerator, Dict, List, Optional
+
 from heurams.services.logger import get_logger

+from .base import BaseLLM
+
 logger = get_logger(__name__)

-logger.debug("OpenAI provider 模块已加载(未实现)")
+
+class OpenAILLM(BaseLLM):
+    """OpenAI 兼容 LLM 提供者"""
+
+    name = "OpenAI"
+
+    def __init__(self, config: Dict[str, Any]):
+        super().__init__(config)
+        self.api_key = config.get("key", "")
+        self.base_url = config.get("url", "https://api.openai.com/v1")
+        self._client = None
+        logger.debug("OpenAILLM 初始化完成: base_url=%s", self.base_url)
+
+    def _get_client(self):
+        """获取 OpenAI 客户端（延迟导入）"""
+        if self._client is None:
+            try:
+                from openai import AsyncOpenAI
+            except ImportError:
+                logger.error("未安装 openai 库，请运行: pip install openai")
+                raise ImportError("未安装 openai 库，请运行: pip install openai")
+
+            self._client = AsyncOpenAI(
+                api_key=self.api_key if self.api_key else None,
+                base_url=self.base_url if self.base_url else None,
+            )
+        return self._client
+
+    async def chat(self, messages: List[Dict[str, str]], **kwargs) -> str:
+        """发送聊天消息并获取响应"""
+        logger.debug("OpenAILLM.chat: messages=%d", len(messages))
+
+        client = self._get_client()
+
+        # 默认参数
+        default_kwargs = {
+            "model": kwargs.get("model", "gpt-3.5-turbo"),
+            "temperature": kwargs.get("temperature", 0.7),
+            "max_tokens": kwargs.get("max_tokens", 1000),
+        }
+
+        # 合并参数，优先使用传入的 kwargs
+        request_kwargs = {**default_kwargs, **kwargs}
+        request_kwargs["messages"] = messages
+
+        try:
+            response = await client.chat.completions.create(**request_kwargs)
+            content = response.choices[0].message.content
+            logger.debug(
+                "OpenAILLM.chat 成功: response length=%d",
+                len(content) if content else 0,
+            )
+            return content or ""
+        except Exception as e:
+            logger.error("OpenAILLM.chat 失败: %s", e)
+            raise
+
+    async def chat_stream(
+        self, messages: List[Dict[str, str]], **kwargs
+    ) -> AsyncGenerator[str, None]:
+        """流式聊天"""
+        logger.debug("OpenAILLM.chat_stream: messages=%d", len(messages))
+
+        client = self._get_client()
+
+        # 默认参数
+        default_kwargs = {
+            "model": kwargs.get("model", "gpt-3.5-turbo"),
+            "temperature": kwargs.get("temperature", 0.7),
+            "max_tokens": kwargs.get("max_tokens", 1000),
+            "stream": True,
+        }
+
+        # 合并参数
+        request_kwargs = {**default_kwargs, **kwargs}
+        request_kwargs["messages"] = messages
+
+        try:
+            stream = await client.chat.completions.create(**request_kwargs)
+            async for chunk in stream:
+                if chunk.choices[0].delta.content:
+                    yield chunk.choices[0].delta.content
+        except Exception as e:
+            logger.error("OpenAILLM.chat_stream 失败: %s", e)
+            raise
--- a/src/heurams/services/config.py
+++ b/src/heurams/services/config.py
@@ -6,15 +6,81 @@ import toml

 from heurams.services.logger import get_logger

+default_config = {
+    "persist_to_file": 1, # 将更改保存到文件
+    "daystamp_override": -1, # 覆写时间, 设为 -1 以禁用
+    "timestamp_override": -1, # 覆写时间, 设为 -1 以禁用
+    "quick_pass": 1, # 启用用于测试的快速通过
+    "scheduled_num": 8, # 对于每个项目的默认新记忆原子数量
+    "timezone_offset": 28800, # UTC 时间戳修正 仅用于 UNIX 日时间戳的生成修正, 单位为秒
+    # 28800 是中国标准时间 (UTC+8)
+    
+    "interface": {
+        "memorizor": {
+            "autovoice": True  # 自动语音播放, 仅限于 recognition 组件
+        }
+    },
+    
+    "algorithm": {
+        "default": "SM-2"  # 主要算法
+        # 可选项: SM-2, SM-15M, FSRS
+    },
+    
+    "puzzles": {  # 谜题默认配置
+        "mcq": {
+            "max_riddles_num": 2
+        },
+        "cloze": {
+            "min_denominator": 3
+        }
+    },
+    
+    "paths": {  # 相对于配置文件的 ".." (即工作目录) 而言 或绝对路径
+        "data": "./data"
+    },
+    
+    "services": {  # 定义服务到提供者的映射
+        "audio": "playsound",  # 可选项: playsound(通用), termux(仅用于 Android Termux), mpg123(TODO)
+        "tts": "edgetts",  # 可选项: edgetts
+        "llm": "openai",  # 可选项: openai
+        "sync": "webdav"  # 可选项: 留空, webdav
+    },
+    
+    "providers": {
+        "tts": {
+            "edgetts": {  # EdgeTTS 设置
+                "voice": "zh-CN-XiaoxiaoNeural"  # 可选项: zh-CN-YunjianNeural (男声), zh-CN-XiaoxiaoNeural (女声)
+            }
+        },
+        "llm": {
+            "openai": {  # 与 OpenAI 相容的语言模型接口服务设置
+                "url": "",
+                "key": ""
+            }
+        },
+        "sync": {
+            "webdav": {  # WebDAV 同步设置
+                "url": "",
+                "username": "",
+                "password": "",
+                "remote_path": "/heurams/",
+                "verify_ssl": True
+            }
+        }
+    },
+}

 class ConfigFile:
    def __init__(self, path: pathlib.Path):
        self.logger = get_logger(__name__)
        self.path = path
+        self.data = dict()
        if not self.path.exists():
            self.path.touch()
            self.logger.debug("创建配置文件: %s", self.path)
-        self.data = dict()
+            self.data = default_config
+        self.valid_configfile = 1
+        # 考虑到可能临时编辑格式错误, 所以不覆写格式错误的配置文件, 而是提示损坏并使用默认配置
        self._load()

    def _load(self):
@@ -26,7 +92,8 @@ class ConfigFile:
            except toml.TomlDecodeError as e:
                print(f"{e}")
                self.logger.error("TOML解析错误: %s", e)
-                self.data = {}
+                self.data = default_config
+                self.valid_configfile = 0

    def modify(self, key: str, value: typing.Any):
        """修改配置值并保存"""
@@ -36,10 +103,13 @@ class ConfigFile:

    def save(self, path: typing.Union[str, pathlib.Path] = ""):
        """保存配置到文件"""
+        if self.valid_configfile:
            save_path = pathlib.Path(path) if path else self.path
            with open(save_path, "w") as f:
                toml.dump(self.data, f)
            self.logger.debug("配置文件已保存: %s", save_path)
+        else:
+            pass

    def get(self, key: str, default: typing.Any = None) -> typing.Any:
        """获取配置值, 如果不存在返回默认值"""
--- a/src/heurams/services/favorite_service.py
+++ b/src/heurams/services/favorite_service.py
@@ -0,0 +1,163 @@
+# 收藏服务
+import json
+import shutil
+import time
+from dataclasses import asdict, dataclass
+from pathlib import Path
+from typing import Dict, List, Optional, Tuple
+
+from heurams.context import config_var
+from heurams.services.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+@dataclass
+class FavoriteItem:
+    """收藏项"""
+
+    repo_path: str  # 仓库相对路径 (相对于 data/repo)
+    ident: str  # 原子标识符
+    added: int  # 添加时间戳 (UNIX 秒)
+    # 可选标签
+    tags: List[str] | None = None
+
+    def __post_init__(self):
+        if self.tags is None:
+            self.tags = []
+
+    def to_dict(self) -> dict:
+        return {
+            "repo_path": self.repo_path,
+            "ident": self.ident,
+            "added": self.added,
+            "tags": self.tags,
+        }
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "FavoriteItem":
+        return cls(
+            repo_path=data["repo_path"],
+            ident=data["ident"],
+            added=data["added"],
+            tags=data.get("tags", []),
+        )
+
+
+class FavoriteManager:
+    """收藏管理器"""
+
+    _instance = None
+
+    def __new__(cls):
+        if cls._instance is None:
+            cls._instance = super().__new__(cls)
+        return cls._instance
+
+    def __init__(self):
+        if not hasattr(self, "_loaded"):
+            self._loaded = True
+            self._favorites: List[FavoriteItem] = []
+            self._file_path = self._get_file_path()
+            self.load()
+
+    def _get_file_path(self) -> Path:
+        """获取收藏文件路径"""
+        config_path = Path(config_var.get()["paths"]["data"])
+        fav_path = config_path / "global" / "favorites.json"
+        fav_path.parent.mkdir(parents=True, exist_ok=True)
+        return fav_path
+
+    def load(self) -> None:
+        """从文件加载收藏列表"""
+        if self._file_path.exists():
+            try:
+                with open(self._file_path, "r", encoding="utf-8") as f:
+                    data = json.load(f)
+                self._favorites = [FavoriteItem.from_dict(item) for item in data]
+                logger.debug("收藏列表加载成功，共 %d 项", len(self._favorites))
+            except Exception as e:
+                logger.error("加载收藏列表失败: %s", e)
+                self._favorites = []
+        else:
+            self._favorites = []
+
+    def save(self) -> None:
+        """保存收藏列表到文件"""
+        try:
+            data = [item.to_dict() for item in self._favorites]
+            with open(self._file_path, "w", encoding="utf-8") as f:
+                json.dump(data, f, ensure_ascii=False, indent=2)
+            logger.debug("收藏列表保存成功，共 %d 项", len(self._favorites))
+        except Exception as e:
+            logger.error("保存收藏列表失败: %s", e)
+
+    def add(self, repo_path: str, ident: str, tags: List[str] | None = None) -> bool:
+        """添加收藏
+
+        Args:
+            repo_path: 仓库相对路径
+            ident: 原子标识符
+            tags: 标签列表
+        Returns:
+            是否成功添加 (若已存在则返回 False)
+        """
+        # 检查是否已存在
+        for item in self._favorites:
+            if item.repo_path == repo_path and item.ident == ident:
+                logger.debug("收藏已存在: %s/%s", repo_path, ident)
+                return False
+        item = FavoriteItem(
+            repo_path=repo_path,
+            ident=ident,
+            added=int(time.time()),
+            tags=tags if tags else [],
+        )
+        self._favorites.append(item)
+        self.save()
+        logger.info("添加收藏: %s/%s", repo_path, ident)
+        return True
+
+    def remove(self, repo_path: str, ident: str) -> bool:
+        """移除收藏
+
+        Returns:
+            是否成功移除 (若不存在则返回 False)
+        """
+        for idx, item in enumerate(self._favorites):
+            if item.repo_path == repo_path and item.ident == ident:
+                del self._favorites[idx]
+                self.save()
+                logger.info("移除收藏: %s/%s", repo_path, ident)
+                return True
+        logger.debug("收藏不存在: %s/%s", repo_path, ident)
+        return False
+
+    def has(self, repo_path: str, ident: str) -> bool:
+        """检查是否已收藏"""
+        for item in self._favorites:
+            if item.repo_path == repo_path and item.ident == ident:
+                return True
+        return False
+
+    def get_all(self) -> List[FavoriteItem]:
+        """获取所有收藏项（按添加时间倒序）"""
+        return sorted(self._favorites, key=lambda x: x.added, reverse=True)
+
+    def get_by_repo(self, repo_path: str) -> List[FavoriteItem]:
+        """获取指定仓库的所有收藏项"""
+        return [item for item in self._favorites if item.repo_path == repo_path]
+
+    def clear(self) -> None:
+        """清空收藏列表"""
+        self._favorites = []
+        self.save()
+        logger.info("清空收藏列表")
+
+    def count(self) -> int:
+        """收藏总数"""
+        return len(self._favorites)
+
+
+# 全局单例实例
+favorite_manager = FavoriteManager()
--- a/src/heurams/services/llm_service.py
+++ b/src/heurams/services/llm_service.py
@@ -0,0 +1,228 @@
+"""LLM 聊天服务"""
+
+import asyncio
+import json
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+from heurams.context import config_var
+from heurams.providers.llm import providers as prov
+from heurams.services.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+class ChatSession:
+    """聊天会话，管理单个对话的历史和参数"""
+
+    def __init__(
+        self, session_id: str, llm_provider, system_prompt: str = "", **default_params
+    ):
+        """初始化聊天会话
+
+        Args:
+            session_id: 会话唯一标识符
+            llm_provider: LLM 提供者实例
+            system_prompt: 系统提示词
+            **default_params: 默认参数（temperature, max_tokens, model 等）
+        """
+        self.session_id = session_id
+        self.llm_provider = llm_provider
+        self.system_prompt = system_prompt
+        self.default_params = default_params
+
+        # 消息历史
+        self.messages: List[Dict[str, str]] = []
+        if system_prompt:
+            self.messages.append({"role": "system", "content": system_prompt})
+
+        logger.debug("创建聊天会话: id=%s", session_id)
+
+    def add_message(self, role: str, content: str):
+        """添加消息到历史"""
+        self.messages.append({"role": role, "content": content})
+        logger.debug(
+            "会话 %s 添加消息: role=%s, length=%d", self.session_id, role, len(content)
+        )
+
+    def clear_history(self):
+        """清空消息历史（保留系统提示）"""
+        self.messages = []
+        if self.system_prompt:
+            self.messages.append({"role": "system", "content": self.system_prompt})
+        logger.debug("会话 %s 清空历史", self.session_id)
+
+    def set_system_prompt(self, prompt: str):
+        """设置系统提示词"""
+        self.system_prompt = prompt
+        # 更新消息历史中的系统消息
+        if self.messages and self.messages[0]["role"] == "system":
+            self.messages[0]["content"] = prompt
+        elif prompt:
+            self.messages.insert(0, {"role": "system", "content": prompt})
+        logger.debug("会话 %s 设置系统提示: length=%d", self.session_id, len(prompt))
+
+    async def send_message(self, message: str, **override_params) -> str:
+        """发送消息并获取响应
+
+        Args:
+            message: 用户消息内容
+            **override_params: 覆盖默认参数
+
+        Returns:
+            模型响应内容
+        """
+        # 添加用户消息
+        self.add_message("user", message)
+
+        # 合并参数
+        params = {**self.default_params, **override_params}
+
+        # 发送请求
+        logger.debug("会话 %s 发送消息: length=%d", self.session_id, len(message))
+        response = await self.llm_provider.chat(self.messages, **params)
+
+        # 添加助手响应
+        self.add_message("assistant", response)
+
+        return response
+
+    async def send_message_stream(self, message: str, **override_params):
+        """流式发送消息
+
+        Args:
+            message: 用户消息内容
+            **override_params: 覆盖默认参数
+
+        Yields:
+            流式响应的文本块
+        """
+        # 添加用户消息
+        self.add_message("user", message)
+
+        # 合并参数
+        params = {**self.default_params, **override_params}
+
+        # 发送流式请求
+        logger.debug("会话 %s 发送流式消息: length=%d", self.session_id, len(message))
+
+        full_response = ""
+        async for chunk in self.llm_provider.chat_stream(self.messages, **params):
+            yield chunk
+            full_response += chunk
+
+        # 添加完整的助手响应到历史
+        self.add_message("assistant", full_response)
+
+    def get_history(self) -> List[Dict[str, str]]:
+        """获取消息历史（不包括系统消息）"""
+        # 返回用户和助手的消息，可选排除系统消息
+        return [msg for msg in self.messages if msg["role"] != "system"]
+
+    def save_to_file(self, file_path: Path):
+        """保存会话到文件"""
+        data = {
+            "session_id": self.session_id,
+            "system_prompt": self.system_prompt,
+            "default_params": self.default_params,
+            "messages": self.messages,
+        }
+        with open(file_path, "w", encoding="utf-8") as f:
+            json.dump(data, f, ensure_ascii=False, indent=2)
+        logger.debug("会话 %s 保存到: %s", self.session_id, file_path)
+
+    @classmethod
+    def load_from_file(cls, file_path: Path, llm_provider):
+        """从文件加载会话"""
+        with open(file_path, "r", encoding="utf-8") as f:
+            data = json.load(f)
+
+        session = cls(
+            session_id=data["session_id"],
+            llm_provider=llm_provider,
+            system_prompt=data.get("system_prompt", ""),
+            **data.get("default_params", {})
+        )
+        session.messages = data["messages"]
+        logger.debug("从文件加载会话: %s", file_path)
+        return session
+
+
+class ChatManager:
+    """聊天管理器，管理多个会话"""
+
+    def __init__(self):
+        self.sessions: Dict[str, ChatSession] = {}
+        self.default_session_id = "default"
+        logger.debug("聊天管理器初始化完成")
+
+    def get_session(
+        self,
+        session_id: Optional[str] = None,
+        create_if_missing: bool = True,
+        **session_params
+    ) -> Optional[ChatSession]:
+        """获取或创建聊天会话
+
+        Args:
+            session_id: 会话标识符，None 则使用默认会话
+            create_if_missing: 如果会话不存在则创建
+            **session_params: 传递给 ChatSession 的参数
+
+        Returns:
+            聊天会话实例，如果不存在且不创建则返回 None
+        """
+        if session_id is None:
+            session_id = self.default_session_id
+
+        if session_id in self.sessions:
+            return self.sessions[session_id]
+
+        if create_if_missing:
+            # 获取 LLM 提供者
+            provider_name = config_var.get()["services"]["llm"]
+            provider_config = config_var.get()["providers"]["llm"][provider_name]
+            llm_provider = prov[provider_name](provider_config)
+
+            session = ChatSession(
+                session_id=session_id, llm_provider=llm_provider, **session_params
+            )
+            self.sessions[session_id] = session
+            logger.debug("创建新会话: id=%s", session_id)
+            return session
+
+        return None
+
+    def delete_session(self, session_id: str):
+        """删除会话"""
+        if session_id in self.sessions:
+            del self.sessions[session_id]
+            logger.debug("删除会话: id=%s", session_id)
+
+    def list_sessions(self) -> List[str]:
+        """列出所有会话ID"""
+        return list(self.sessions.keys())
+
+
+# 全局聊天管理器实例
+_chat_manager: Optional[ChatManager] = None
+
+
+def get_chat_manager() -> ChatManager:
+    """获取全局聊天管理器实例"""
+    global _chat_manager
+    if _chat_manager is None:
+        _chat_manager = ChatManager()
+        logger.debug("创建全局聊天管理器")
+    return _chat_manager
+
+
+def create_chat_session(
+    session_id: Optional[str] = None, **session_params
+) -> ChatSession:
+    """创建或获取聊天会话（便捷函数）"""
+    manager = get_chat_manager()
+    return manager.get_session(session_id, True, **session_params)
+
+
+logger.debug("LLM 服务初始化完成")
--- a/src/heurams/services/vfs.py
+++ b/src/heurams/services/vfs.py
@@ -1,20 +0,0 @@
-"""vfs.py
-得益于 FSSpec, 无需实现大部分虚拟文件系统的 Providers
-"""
-
-from pathlib import Path
-
-import fsspec as fs
-
-
-class VFSObject:
-    def __init__(self, protocol, base_url):
-        self.base_url = base_url
-        self.protocol = protocol
-        self.fs = fs.filesystem(protocol=protocol, base_url=base_url)
-
-    def open(self, path: Path):
-        return self.fs.open(path)
-
-    def open_by_list(self, path_list: list[Path]):
-        return self.fs.open_files(path_list)
--- a/src/heurams/tools/csv2payload.py
+++ b/src/heurams/tools/csv2payload.py
@@ -0,0 +1,177 @@
+#!/usr/bin/env python3
+"""
+将符合条件的CSV转为符合Payload需要的TOML格式
+
+使用命令: python3 csv2payload.py <CSV路径> <生成TOML路径, 默认为文件名相同, 后缀为toml的TOML文件> [-r: 可选参数, 表示按照索引打乱顺序的随机整数种子]
+
+转换规则:
+1. `ident` 列用作 TOML 的 section 标题(`[ident]`)
+2. 若某行的 `ident` 为空，则自动按顺序生成标识符，例如 `idx_1`、`idx_2` 等
+3. 所有其他列(除 `ident` 外)都作为该 section 下的键值对
+4. 所有列都是可选的，但 `ident` 为空时会自动生成
+
+示例 CSV:
+```csv
+ident, content, meaning, ...
+"Fox", "Fox", "狐狸(一种动物)", ...
+"Dog", "Dog", "狗(一种比猫聪明的动物)", ...
+"Cat", "Cat", "猫(一种不如狗聪明的动物)", ...
+"Dolphin", "Dolphin", "一种很聪明的海洋哺乳动物", ...
+, "Duck", "一种扁嘴水禽"
+, "Meow", "猫发出的声音"
+"Doge", "Doge", "神烦狗(一张搞笑狗狗表情包的代称)", ...
+, "Woof", "狗发出的声音"
+```
+
+转换后的 TOML: 
+```toml
+[Fox]
+content = "Fox"
+meaning = "狐狸(一种动物)"
+
+[Dog]
+content = "Dog"
+meaning = "狗(一种比猫聪明的动物)"
+
+[Cat]
+content = "Cat"
+meaning = "猫(一种不如狗聪明的动物)"
+
+[Dolphin]
+content = "Dolphin"
+meaning = "一种很聪明的海洋哺乳动物"
+
+[idx_1]
+content = "Duck"
+meaning = "一种扁嘴水禽"
+
+[idx_2]
+content = "Meow"
+meaning = "猫发出的声音"
+
+[Doge]
+content = "Doge"
+meaning = "神烦狗(一张搞笑狗狗表情包的代称)"
+
+[idx_3]
+content = "Woof"
+meaning = "狗发出的声音"
+```
+
+补充说明：
+- 自动生成的标识符使用 `idx_` 前缀加数字序列
+- 生成序列基于原始 CSV 中 `ident` 为空的行出现的顺序
+- 所有值都保留为字符串类型，符合 TOML 字符串格式要求
+- 如果 CSV 包含更多列，它们也会以相同方式转换为键值对
+- 支持 `-r` 参数指定随机种子来打乱 section 顺序
+"""
+import csv
+import sys
+import os
+import random
+import argparse
+from pathlib import Path
+
+def csv_to_toml(csv_path, toml_path=None, random_seed=None):
+    """
+    将CSV文件转换为TOML格式
+    
+    Args:
+        csv_path (str): 输入CSV文件路径
+        toml_path (str): 输出TOML文件路径，默认为相同目录下同名文件
+        random_seed (int): 随机种子，用于打乱section顺序，None表示不打乱
+    """
+    # 检查CSV文件是否存在
+    csv_file = Path(csv_path)
+    if not csv_file.exists():
+        print(f"错误: CSV文件不存在 - {csv_path}")
+        sys.exit(1)
+    
+    # 确定输出TOML文件路径
+    if toml_path is None:
+        toml_path = csv_file.with_suffix('.toml')
+    else:
+        toml_path = Path(toml_path)
+    
+    # 读取CSV文件
+    try:
+        with open(csv_file, 'r', encoding='utf-8') as f:
+            reader = csv.DictReader(f)
+            rows = list(reader)
+    except Exception as e:
+        print(f"错误: 无法读取CSV文件 - {e}")
+        sys.exit(1)
+    
+    # 检查CSV文件是否有数据
+    if not rows:
+        print("错误: CSV文件为空或格式不正确")
+        sys.exit(1)
+    
+    # 如果指定了随机种子，设置随机种子并打乱行顺序
+    if random_seed is not None:
+        random.seed(random_seed)
+        random.shuffle(rows)
+        print(f"提示: 使用随机种子 {random_seed} 打乱了 section 顺序")
+    
+    # 生成TOML内容
+    toml_content = []
+    idx_counter = 1
+    
+    for row in rows:
+        # 处理ident列，为空时生成自动标识符
+        ident = row.get('ident', '').strip()
+        if not ident:
+            ident = f"idx_{idx_counter}"
+            idx_counter += 1
+        
+        # 添加section标题
+        toml_content.append(f"[{ident}]")
+        
+        # 添加所有其他列作为键值对（排除ident列）
+        for key, value in row.items():
+            if key == 'ident':
+                continue
+            
+            # 确保值存在且不为空
+            if value is not None and str(value).strip() != '':
+                # 转义特殊字符并添加引号
+                escaped_value = str(value).replace('"', '\\"')
+                toml_content.append(f'"{key}" = "{escaped_value}"')
+        
+        # section之间添加空行
+        toml_content.append("")
+    
+    # 写入TOML文件
+    try:
+        with open(toml_path, 'w', encoding='utf-8') as f:
+            f.write('\n'.join(toml_content).strip())
+        print(f"成功: 已生成TOML文件 - {toml_path}")
+    except Exception as e:
+        print(f"错误: 无法写入TOML文件 - {e}")
+        sys.exit(1)
+
+def main():
+    """主函数"""
+    parser = argparse.ArgumentParser(
+        description='将CSV文件转换为TOML格式，支持随机打乱section顺序',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog='''
+示例:
+  %(prog)s input.csv output.toml
+  %(prog)s input.csv                    # 自动生成input.toml
+  %(prog)s input.csv -r 42              # 使用种子42打乱顺序
+  %(prog)s input.csv -r 123 output.toml # 指定种子和输出路径
+        '''
+    )
+    
+    parser.add_argument('csv_path', help='输入的CSV文件路径')
+    parser.add_argument('toml_path', nargs='?', help='输出的TOML文件路径，默认为CSV同名文件')
+    parser.add_argument('-r', '--random-seed', type=int, 
+                       help='随机种子，用于打乱TOML section的顺序')
+    
+    args = parser.parse_args()
+    
+    csv_to_toml(args.csv_path, args.toml_path, args.random_seed)
+
+if __name__ == "__main__":
+    main()
--- a/uv.lock
+++ b/uv.lock
Author	SHA1	Message	Date
Wang Zhiyu	c60e7fb151	feat(interface): 改进界面	2026-01-28 03:35:58 +08:00
Wang Zhiyu	f6753cd0a3	feat(interface): 改进仪表盘	2026-01-22 06:13:01 +08:00
Wang Zhiyu	4ec062b116	fix: 修复若干问题	2026-01-17 05:45:45 +08:00
Wang Zhiyu	69b7edeed0	fix(interface): 修复按钮标识和一个哈希问题	2026-01-15 12:49:57 +08:00
Wang Zhiyu	473a3bba8f	feat(interface): 改进状态显示	2026-01-13 23:39:10 +08:00
Wang Zhiyu	016ae16100	build: 使用 uv 包管理器	2026-01-09 00:47:34 +08:00
Wang Zhiyu	5b1a627ddb	fix: 改进	2026-01-08 01:00:08 +08:00
Wang Zhiyu	2e4a663adf	fix: 小范围修补	2026-01-08 00:56:04 +08:00
Wang Zhiyu	ed85655e8b	feat: 一系列新功能	2026-01-08 00:05:00 +08:00
Wang Zhiyu	47c14e520b	feat(interface): 完成队列式记忆模块更新	2026-01-06 20:32:27 +08:00
Wang Zhiyu	ca7ef92b05	fix: 修复完成屏幕问题	2026-01-06 19:58:46 +08:00