📓 Mini Diary 技能

一款由 AI 驱动的轻量级日记工具。体积小巧，功能智能。

✨ 特性

• 📝 简洁的日常记录：采用干净的 Markdown 格式，包含日期、天气、笔记和待办事项
• 🏷️ 智能自动打标：AI 分析内容并自动添加相关标签
• 🔍 强大的搜索能力：支持按标签、日期或正文内容搜索，并保留上下文
• 📊 基础统计功能：追踪标签使用频率与待办事项完成率
• ☁️ 支持云同步（可选）：提供 NextCloud 集成方案及详细配置指南
• 🔓 开放格式：纯文本 Markdown 文件 —— 你的数据，完全由你掌控

🚀 快速上手

安装

# 通过 ClawHub 安装
clawhub install mini-diary

基础用法

# 添加一条笔记（自动打标将自动触发）
mini-diary add "与客户会面，讨论 P1S 交付事宜"

# 添加待办事项（使用 [ ] 表示待处理，[x] 表示已完成）
# 待办事项将被添加至当日的 Todos 区域
echo "- [ ] 跟进供应商" >> ~/diary.md
echo "- [x] 提交月度报告" >> ~/diary.md

# 按标签搜索
mini-diary search --tag "📦"

# 按日期搜索
mini-diary search --date "2024-02-22"

# 按正文内容搜索
mini-diary search "客户会议"

# 查看统计信息
mini-diary search --stats

# 列出所有可用标签
mini-diary search --list-tags

📁 日记格式

Mini Diary 使用简洁的 Markdown 格式：

# 📓 我的日记

## 📅 2024-02-22 星期四

### 📝 笔记

- 与客户会面，讨论 P1S 交付事宜 📦🎋
- 修复 X1C 打印机的加热问题 🔧🎋
- 提交月度发票 💰

### ✅ 待办事项

- [ ] 跟进供应商
- [x] 更新库存电子表格

✅ 待办事项管理

添加待办事项

由于待办事项本质上是标准的 Markdown 任务列表，你可以直接追加：

# 添加一条待处理的待办事项
echo "- [ ] 致电客户跟进 P1S 交付事宜" >> ~/diary.md

# 添加一条已完成的待办事项  
echo "- [x] 提交周报" >> ~/diary.md

# 一次性添加多条待办事项
cat >> ~/diary.md << 'EOF'
- [ ] 订购更多耗材
- [x] 备份服务器数据
- [ ] 安排团队会议
EOF

待办事项最佳实践

1. 从日期标题开始：确保你正向正确日期的小节中添加内容
2. 描述清晰明确：例如“致电 John 确认 P1S 交付”，而非仅写“致电 John”
3. 及时更新状态：事项完成后，将 [ ] 修改为 [x]
4. 每日回顾：每天开始或结束时检查待办事项清单

查找待办事项

# 查找待处理的待办事项
grep "[ ]" ~/diary.md

# 查找已完成的待办事项
grep "[x]" ~/diary.md

# 按状态统计数量
grep -c "[ ]" ~/diary.md  # 待处理数量
grep -c "[x]" ~/diary.md  # 已完成数量

🏷️ 自动打标系统

AI 将基于正文内容自动添加标签：

☁️ NextCloud 集成（可选）

配置步骤

1. 设置环境变量：

export NEXTCLOUD_SYNC_DIR="/path/to/nextcloud/diary"

2. Mini Diary 将自动同步到该目录。

⚠️ 重要注意事项

文件权限：NextCloud 对文件归属有特定要求：

# 将文件复制到 NextCloud 目录后：
chown www-data:www-data /path/to/diary.md

# 或在 Docker 环境中执行：
docker exec nextcloud_app chown www-data:www-data /var/www/html/data/...

需手动触发扫描：NextCloud 不会自动检测文件变更：

docker exec nextcloud_app php occ files:scan [username]

⚙️ 配置

环境变量

# 日记文件路径
export DIARY_FILE="$HOME/my-diary.md"

# NextCloud 同步目录
export NEXTCLOUD_SYNC_DIR="/path/to/nextcloud"

# 自定义标签定义文件（JSON 格式）
export TAGS_CONFIG="/path/to/tags.json"

自定义标签

创建一个 JSON 文件来定义自定义标签：

{
  "custom_tags": {
    "project-x": "🚀",
    "urgent": "⚠️",
    "meeting": "👥"
  },
  "rules": {
    "project-x": ["project x", "px", "feature"],
    "urgent": ["urgent", "asap", "important"],
    "meeting": ["meeting", "call", "discussion"]
  }
}

📊 进阶用法

周报生成

# 生成上周汇总报告
mini-diary search --date $(date -d "last week" +%Y-%m-%d) --stats

标签分析

# 查看使用频率最高的标签
mini-diary search --stats | grep -A5 "Tag Statistics"

数据导出

# 导出为 CSV 格式用于进一步分析
grep "^- " diary.md | sed 's/^- //' > notes.csv

🔧 故障排查

常见问题

1. 标签未出现：请检查正文关键词是否匹配标签规则
2. NextCloud 中看不到文件：是否已执行扫描命令？
3. 权限错误：请检查 NextCloud 目录中文件的归属权
4. 搜索无结果：请确认 diary.md 文件存在且包含有效内容

调试模式

# 启用调试输出
export MINI_DIARY_DEBUG=1
mini-diary add "测试笔记"

🤝 参与贡献

发现 Bug？有新功能建议？欢迎提交贡献！

1. Fork 本仓库
2. 新建特性分支
3. 提交 Pull Request

📄 许可协议

MIT License — 具体条款详见 LICENSE 文件。

🙏 致谢

• 基于 OpenClaw 构建
• 灵感源自真实世界对简洁、智能日记工具的需求
• 感谢所有贡献者与用户

Mini Diary —— 因为日记本就该简单、智能，而且完全属于你。