HeurAMS

Appearance

快速入门 ​

本文将引导您完成 HeurAMS 的首次使用流程.

启动应用 ​

  1. 打开终端（命令提示符、PowerShell、Terminal 等）
  2. 切换到您希望存储学习数据的目录（建议新建空目录）：
    bash
    mkdir heurams_data
cd heurams_data
  3. 启动 HeurAMS：
    bash
    python -m heurams.interface

首次启动时, 应用会自动创建所需的数据目录结构.

数据目录结构 ​

启动后, 当前目录下会生成以下结构：

├── config/
│   └── config.toml          # 用户配置文件
├── data/
│   ├── nucleon/             # 记忆内容 (TOML 格式)
│   ├── electron/            # 算法状态 (JSON 格式)
│   ├── orbital/             # 策略配置 (TOML 格式)
│   ├── cache/               # 音频缓存文件
│   └── template/            # 内容模板
└── heurams.log              # 应用日志

主界面导航 ​

启动后, 您将看到主仪表板, 包含以下功能区域：

  • 复习队列：显示待复习的记忆单元
  • 内容管理：创建、编辑、导入记忆内容
  • 系统设置：调整算法参数、界面主题等
  • 工具菜单：数据备份、缓存清理、统计报告

键盘快捷键 ​

  • Tab / Shift+Tab：在界面元素间导航
  • Enter：激活当前选中的按钮或选项
  • Esc：返回上一级或取消操作
  • Ctrl+S：保存当前内容
  • Ctrl+Q：退出应用（或使用菜单）

创建第一个记忆单元 ​

  1. 在主界面选择 "创建内容" 或类似选项
  2. 选择记忆类型：
    • 文本问答：传统问答形式
    • 古诗词：针对古诗文优化的模板
    • 选择题：自带选项的问题
  3. 填写必要字段：
    • 问题：需要记忆的内容
    • 答案：正确的回答
    • 标签：便于分类管理（如"数学"、"历史"）
  4. 保存内容

开始第一次复习 ​

  1. 返回主界面, 选择 "开始复习"
  2. 系统将显示第一个待复习的记忆单元
  3. 根据提示回答问题：
    • 选择题：使用方向键选择, 按 Enter 确认
    • 填空题：键入答案后按 Enter
    • 识别题：按 Y/N 确认
  4. 评估记忆程度：
    • 困难：完全不记得
    • 一般：需要提示才能想起
    • 容易：立即想起
    • 非常容易：无需思考

系统会根据您的评估计算下一次复习时间.

基本操作示例 ​

导入现有数据 ​

HeurAMS 支持导入 Anki 牌组（计划中）和 CSV 文件. 目前可通过复制文件到 data/nucleon/ 目录手动导入.

调整复习设置 ​

在 设置 → 算法参数 中可调整：

  • 算法选择（SM-2、FSRS 等）
  • 初始间隔倍数
  • 难度系数权重
  • 每日复习上限

查看学习统计 ​

工具 → 学习报告 显示：

  • 今日复习数量
  • 记忆保留率
  • 长期预测
  • 学习曲线

常见问题 ​

Q: 复习时没有内容显示？ ​

A: 确保已创建记忆单元, 且它们已添加到复习队列. 新内容可能需等待到预定复习时间.

Q: 如何更改界面语言？ ​

A: 目前仅支持中文界面. 国际化是未来计划.

Q: 数据存储在哪里？如何备份？ ​

A: 数据存储在当前工作目录的 data/ 子目录中. 定期复制整个目录即可备份.

下一步 ​

掌握基本操作后, 可深入了解：

© 2025 Wang Zhiyu 保留所有权