FAQ

常见问题

关于 MoodLog 的常见问题解答。

---

安装相关

Q: 安装时报错 ModuleNotFoundError: No module named 'moodlog'

确保已正确安装且在虚拟环境中：

cd moodlog
source .venv/bin/activate   # Windows 用 .venv\Scripts\activate
pip install -e ".[dev]"

Q: moodlog: command not found

确认安装成功后再试。也可以用 python -m moodlog 直接运行。

Q: Windows 上无法激活虚拟环境

使用 PowerShell 或 CMD：

.venv\Scripts\activate

或使用完整路径：

.\.venv\Scripts\activate.bat

---

记录相关

Q: 可以修改已记录的分数吗？

可以。使用 --force 选项覆盖：

moodlog record 5 --force

Q: 一天可以记录多条吗？

不行。每天只能有一条记录。后记录的会覆盖前一条。

Q: 标签有什么用？

标签可以帮助你：

• 回顾特定主题的日子（如「工作」「旅行」）
• 在搜索时过滤结果
• 统计高频活动

Q: 100 分是什么？

100 分是一个彩蛋！当某天心情特别好时，可以输入 moodlog record 100，会有特别的庆祝效果。

---

数据相关

Q: 数据存在哪里？

数据保存在 data/moodlog.db，是 SQLite 格式。

Q: 如何备份数据？

直接复制数据库文件即可：

cp data/moodlog.db data/moodlog_backup_$(date +%Y%m%d).db

Q: 如何导出数据？

支持多种格式导出：

moodlog export -f json -o backup.json    # JSON
moodlog export -f csv -o backup.csv      # CSV
moodlog export -f markdown -o backup.md # Markdown

Q: 删除记录后数据能恢复吗？

不能。删除操作不可逆。如果需要保留数据，建议先导出再删除。

Q: 数据库损坏了怎么办？

如果有备份，用备份恢复：

cp data/moodlog_backup.db data/moodlog.db

---

显示相关

Q: 图表在终端显示不正常？

确保使用支持 Unicode 的现代终端：

• Windows Terminal
• iTerm2 (macOS)
• GNOME Terminal (Linux)

Q: 月度报告图片保存在哪里？

默认保存在 ~/moodlog_reports/ 目录。

---

多语言

Q: 如何切换到英文界面？

编辑 moodlog/config.toml，将第一行改为：

language = "en_US"

---

其他

Q: 如何查看版本号？

moodlog --version

Q: 提醒功能怎么用？

moodlog remind on              # 开启
moodlog remind on --time 20:00 # 指定时间
moodlog remind off             # 关闭

Q: 有 API 可以程序调用吗？

MoodLog 目前是命令行工具，不提供 API。但可以通过导出 JSON 数据供其他程序使用。

Q: 提了问题或建议怎么联系？

欢迎在 GitHub 仓库提 Issue！