format

2025-12-17 20:52:11 +08:00
parent 8da8354609
commit 38f720aa7b
30 changed files with 181 additions and 181 deletions
--- a/README.md
+++ b/README.md
@@ -19,17 +19,17 @@
 ## 特性

 ### 间隔迭代算法
-> 许多出版物都广泛讨论了不同重复间隔对学习效果的影响。特别是，间隔效应被认为是一种普遍现象。间隔效应是指，如果重复的间隔是分散/稀疏的，而不是集中重复，那么学习任务的表现会更好。因此，有观点提出，学习中使用的最佳重复间隔是**最长的、但不会导致遗忘的间隔**。
+> 许多出版物都广泛讨论了不同重复间隔对学习效果的影响. 特别是, 间隔效应被认为是一种普遍现象. 间隔效应是指, 如果重复的间隔是分散/稀疏的, 而不是集中重复, 那么学习任务的表现会更好. 因此, 有观点提出, 学习中使用的最佳重复间隔是**最长的、但不会导致遗忘的间隔**. 
 - 采用经实证的 SM-2 间隔迭代算法, 此算法亦用作 Anki 闪卡记忆软件的默认闪卡调度器
 - 动态规划每个记忆单元的记忆间隔时间表
- 动态跟踪记忆反馈数据，优化长期记忆保留率与稳定性
+- 动态跟踪记忆反馈数据, 优化长期记忆保留率与稳定性

 ### 学习进程优化
- 逐字解析：支持逐字详细释义解析
- 语法分析：接入生成式人工智能, 支持古文结构交互式解析
- 自然语音：集成微软神经网络文本转语音 (TTS) 技术
- 多种谜题类型：选择题 (MCQ)、填空题 (Cloze)、识别题 (Recognition)
- 动态内容生成：支持宏驱动的模板系统，根据上下文动态生成题目
+- 逐字解析: 支持逐字详细释义解析
+- 语法分析: 接入生成式人工智能, 支持古文结构交互式解析
+- 自然语音: 集成微软神经网络文本转语音 (TTS) 技术
+- 多种谜题类型: 选择题 (MCQ)、填空题 (Cloze)、识别题 (Recognition)
+- 动态内容生成: 支持宏驱动的模板系统, 根据上下文动态生成题目

 ### 实用用户界面
 - 响应式 Textual 框架构建的跨平台 TUI 界面
@@ -37,27 +37,27 @@
 - 简洁直观的复习流程设计

 ### 架构特性
- 模块化设计：算法、谜题、服务提供者可插拔替换
- 上下文管理：使用 ContextVar 实现隐式依赖注入
- 数据持久化：TOML 配置与内容，JSON 算法状态
- 服务抽象：音频播放、TTS、LLM 通过 provider 架构支持多种后端
- 完整日志系统：带轮转的日志记录，便于调试
+- 模块化设计: 算法、谜题、服务提供者可插拔替换
+- 上下文管理: 使用 ContextVar 实现隐式依赖注入
+- 数据持久化: TOML 配置与内容, JSON 算法状态
+- 服务抽象: 音频播放、TTS、LLM 通过 provider 架构支持多种后端
+- 完整日志系统: 带轮转的日志记录, 便于调试

 ## 安装

 ### 从源码安装
-1. 克隆仓库：
+1. 克隆仓库: 
   ```bash
   git clone https://gitea.imwangzhiyu.xyz/ajax/heurams.git HeurAMS
   cd HeurAMS
   ```

-2. 安装依赖：
+2. 安装依赖: 
   ```bash
   pip install -r requirements.txt
   ```

-3. 以开发模式安装包：
+3. 以开发模式安装包: 
   ```bash
   pip install -e .
   ```
@@ -71,7 +71,7 @@ python -m heurams.interface
 ```

 ### 数据目录结构
-应用会在工作目录下创建以下数据目录：
+应用会在工作目录下创建以下数据目录: 
 - `data/nucleon/`: 记忆内容 (TOML 格式)
 - `data/electron/`: 算法状态 (JSON 格式)
 - `data/orbital/`: 策略配置 (TOML 格式)
@@ -82,13 +82,13 @@ python -m heurams.interface

 ## 配置

-配置文件位于 `config/config.toml`（相对于工作目录）。如果不存在，会使用内置的默认配置。
+配置文件位于 `config/config.toml`（相对于工作目录）. 如果不存在, 会使用内置的默认配置. 

 ## 项目结构

 ### 架构图

-以下 Mermaid 图展示了 HeurAMS 的主要组件及其关系：
+以下 Mermaid 图展示了 HeurAMS 的主要组件及其关系: 

 ```mermaid
 graph TB
@@ -175,8 +175,8 @@ src/heurams/

 ## 贡献

-欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解贡献指南。
+欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解贡献指南. 

 ## 许可证

-本项目基于 AGPL-3.0 许可证开源。详见 [LICENSE](LICENSE) 文件。
+本项目基于 AGPL-3.0 许可证开源. 详见 [LICENSE](LICENSE) 文件.