更新自述文件

CONTRIBUTING.md

@@ -0,0 +1,7 @@
+# 贡献指南
+## 使用 Nuitka 静态编译
+运行
+
+```bash
+nuitka --clang --jobs=6 --standalone --onefile main.py   
+```

README.md

@@ -3,8 +3,7 @@
 
 ## 概述
 
-"潜进" (HeurAMS, 中文含义: 启发式辅助记忆软件) 是为习题册, 古诗词, 及其他问答/记忆/理解型题目设计的记忆辅助软件, 提供优化记忆方案
-
+"潜进" (HeurAMS, 中文含义: 启发式辅助记忆软件) 是为习题册, 古诗词, 及其他问答/记忆/理解型知识设计的辅助记忆软件, 提供动态规划的优化记忆方案
 
 ## 技术集成与特性
 
@@ -13,10 +12,10 @@
 - 采用经实证的 SM-2 间隔迭代算法, 此算法亦用作 Anki 闪卡记忆软件的默认闪卡调度器
 > 计划: 将添加 FSRS 算法 (Anki 的新可选闪卡调度器) 与一种 SM-15 变体算法作为后续替代  
 > 参考 https://github.com/slaypni/SM-15  
-> 为什么使用 SM-15 的变体?  
-> SM-2 后续算法仅有论文, 无具体方程, 故使用一种基于 SM-15 描述实现的变体算法
-- 动态优化每首诗词的记忆间隔时间表
-- 实时跟踪记忆曲线，优化长期记忆保留率与稳定性
+> 使用 SM-15 的变体:  
+> SM-2 后续算法并非完全开放, 故使用一种基于 SM-15 描述实现的变体算法
+- 动态规划每个记忆单元的记忆间隔时间表
+- 动态跟踪记忆反馈数据，优化长期记忆保留率与稳定性
 
 ### 学习进程优化
 - 逐字解析：支持逐字详细释义解析
@@ -30,12 +29,19 @@
 - 简洁直观的复习流程设计
 
 ## 屏幕截图
-![scrshot2](readme_src/image_2.png)
-![scrshot1](readme_src/image_1.png)
+
+> 单击图片以放大
+
+<img src="./readme_src/img1.png" alt="img1" style="zoom: 33%;" />
+<img src="./readme_src/img2.png" alt="img2" style="zoom:33%;" />
+<img src="./readme_src/img3.png" alt="img3" style="zoom:33%;" />
+<img src="./readme_src/img4.png" alt="img4" style="zoom:33%;" />
 
 ## 技术架构
+
 > 有关技术与实现的细节, 请参阅 CONTRIBUTING.md  
 > 提交拉取请求以参与到此开放源代码项目
+
 ``` mermaid
 graph TD
     subgraph 后端
@@ -62,10 +68,4 @@ graph TD
 ## 系统要求
 
 - 平台支持：Windows / macOS / Linux / Android (需要 Termux 或 Linux) (终端或浏览器)
-- 网络连接：可预缓存语音文件, 需联网使用大模型服务功能
-
-## 使用 Nuitka 静态编译
-运行
-```bash
-nuitka --clang --jobs=6 --standalone --onefile main.py   
-```
+- 网络连接：可预缓存语音文件, 需联网使用大模型服务功能

compositions.py

@@ -124,9 +124,8 @@ class Recognition(Composition):
     def handler(self, event, type_):
         if type_ == "button":
             if event.button.id == self.getid("ok"):
+                self.reactor.report(self.atom, 5)
                 return 0
-        if type_ == 1:
-            pass
         return -1
 
 
@@ -201,9 +200,11 @@ class FillBlank(Composition):
                 return 1
             else:
                 if self.inputlist == self.puzzle.answer:
+                    self.reactor.report(self.atom, 4)
                     return 0
                 else:
                     self.inputlist = []
+                    self.reactor.report(self.atom, 2)
                     return 1
 
 
@@ -240,9 +241,11 @@ class DrawCard(Composition):
                 return 1
             else:
                 if self.inputlist == self.puzzle.answer:
+                    self.reactor.report(self.atom, 4)
                     return 0
                 else:
                     self.inputlist = []
+                    self.reactor.report(self.atom, 2)
                     return 1
 
 

config.toml

@@ -1,8 +1,14 @@
 # [调试] 将更改保存到文件
 save = 1
+
 # [调试] 覆写时间
-time_override = 10
+time_override = -1
+
+# [调试] 一键通过
+quick_pass = 0
+
 # 对于每个项目的新记忆核子数量
 tasked_number = 8
-# 竖屏适配
+
+# 竖屏适配 (未完成)
 mobile_mode = 1

main.py

@@ -22,18 +22,18 @@ import auxiliary as aux
 import compositions as compo
 import builtins
 
-_original_open = builtins.open
+# Hook python 的 open() 函数, 使用 utf-8 (兼容 Windows 万年 GBK)
 
+_original_open = builtins.open
 
 def _open(*args, **kwargs):
     if "encoding" not in kwargs:
         kwargs["encoding"] = "utf-8"
     return _original_open(*args, **kwargs)
 
-
 builtins.open = _open
 
-ver = "0.3.0b"
+ver = "0.3.0"
 
 config = aux.ConfigFile("config.toml")
 
@@ -43,19 +43,9 @@ class MemScreen(Screen):
         ("d", "toggle_dark", "改变色调"),
         ("q", "pop_screen", "返回主菜单"),
         ("v", "play_voice", "朗读"),
-        ("0", "press('q0')", None),
-        ("1", "press('q1')", None),
-        ("2", "press('q2')", None),
-        ("3", "press('q3')", None),
-        ("4", "press('q4')", None),
-        ("5", "press('q5')", None),
-        ("[", "press('q5')", None),
-        ("]", "press('q4')", None),
-        (";", "press('q3')", None),
-        ("'", "press('q2')", None),
-        (".", "press('q1')", None),
-        ("/", "press('q0')", None),
     ]
+    if config.get("quick_pass"):
+        BINDINGS.append(("k", "quick_pass", "快速通过[调试]"))
     btn = dict()
 
     def __init__(
@@ -127,10 +117,6 @@ class MemScreen(Screen):
     def refresh_ui(self):
         self.call_later(self.recompose)
 
-    def report(self, quality):
-        assessment = self.reactor.report(self.reactor.current_atom, quality)
-        return assessment
-
     def action_play_voice(self):
         def play():
             cache_dir = pathlib.Path(f"./cache/voice/")
@@ -148,6 +134,9 @@ class MemScreen(Screen):
 
         threading.Thread(target=play).start()
 
+    def action_quick_pass(self):
+        self.reactor.report(self.reactor.current_atom, 5)
+        self._forward_judge(0)
     def action_toggle_dark(self):
         self.app.action_toggle_dark()
 
@@ -183,7 +172,7 @@ class PreparationScreen(Screen):
                 classes="start-button",
             )
             yield Static(f"\n全文如下:\n")
-            yield Static(self._get_full_content(), classes="full")
+            yield Static(self._get_full_content().replace("/", ""), classes="full")
         yield Footer()
 
     def _get_full_content(self):

nucleon/陈情表.toml

@@ -8,7 +8,7 @@ translation = "语句翻译"
 ["testdata"]
 # 记忆时显示的额外信息
 additional_inf = ["translation","keyword_note", "note"]
-# 填空测试, content指代键名
+# 填空测试, content 指代键名
 fill_blank_test = {"from"=["content"], "hint"=["translation"]}
 # 选择题测试
 draw_card_test = {"from"=["keyword_note"]}

particles.py

@@ -48,6 +48,7 @@ class Electron:
         Args:
             quality (int): 记忆保留率量化参数
         """
+        print(f"REVISOR: {quality}, {is_new_activation}")
         if quality == -1:
             return -1
 

puzzles.py

@@ -108,14 +108,14 @@ class SelectionPuzzle(Puzzle):
     def __str__(self):
         return f"{self.wording}\n正确答案: {', '.join(self.answer)}"
 
-
-puz = SelectionPuzzle(
-    {"1+1": "2", "1+2": "3", "1+3": "4"},
-    ["2", "5", "0"],
-    3,
-    '求值: '
-)
-puz.refresh()
-print(puz.wording)
-print(puz.answer)
-print(puz.options)
+if __name__ == "__main__":
+    puz = SelectionPuzzle(
+        {"1+1": "2", "1+2": "3", "1+3": "4"},
+        ["2", "5", "0"],
+        3,
+        '求值: '
+    )
+    puz.refresh()
+    print(puz.wording)
+    print(puz.answer)
+    print(puz.options)

reactor.py

@@ -32,7 +32,6 @@ class Reactor():
     """反应堆对象, 处理和分配一次文件记忆流程的资源与策略"""
     def __init__(self, nucleon_file: pt.NucleonUnion, electron_file: pt.ElectronUnion, screen, tasked_num):
         # 导入原子对象
-        self.reported = set()
         self.nucleon_file = nucleon_file
         self.electron_file = electron_file
         self.tasked_num = tasked_num
@@ -41,6 +40,7 @@ class Reactor():
         counter = self.tasked_num
         self.screen = screen
         self.electron_dict = electron_file.electrons_dict
+        self.quality_dict = {}
         def electron_dict_get_fallback(key) -> pt.Electron:
             value = self.electron_dict.get(key)
             # 如果值不存在，则设置默认值
@@ -71,7 +71,6 @@ class Reactor():
         self.procession: list
         self.failed: list
         self.round_title: str
-        self.reported: set
         self.current_atom: typing.Tuple[pt.Electron, pt.Nucleon, dict]
         self.round_set = 0
         self.current_atom = pt.Atom.placeholder()
@@ -127,23 +126,25 @@ class Reactor():
         return 0
 
     def save(self):
+        self._deploy_report()
         print("Progress saved")
         # self.nucleon_file.save()
         self.electron_file.save()
     
+    def _deploy_report(self):
+        "部署所有 _report"
+        for e, q in self.quality_dict.items():
+            if q == -1:
+                e.revisor(5, True)
+                continue
+            e.revisor(q)
     def report(self, atom, quality):
-        """
-        0: 初次激活/通过
-        1: 不通过
-        """
+        "向反应器和最低质量记录汇报"
         if atom in self.atoms_new:
-            atom[0].revisor(quality, True)
-            return 0
-        if atom[0] not in self.reported:
-            atom[0].revisor(quality)
-            self.reported.add(atom[0])
+            self.quality_dict[atom[0]] = -1
+            print(self.quality_dict)
+            return
+        self.quality_dict[atom[0]] = min(quality, self.quality_dict.get(atom[0], 5))
         if quality <= 3:
             self.failed.append(atom)
-            return 1
-        else:
-            return 0
+        print(self.quality_dict)