📓 Mini Diary Skill
Your AI-powered mini diary. Small footprint, smart features.
✨ Features
- - 📝 Simple Daily Logging: Clean Markdown format with date, weather, notes, and todos
- 🏷️ Smart Auto-Tagging: AI analyzes content and adds relevant tags automatically
- 🔍 Powerful Search: Search by tags, date, or content with context
- 📊 Basic Statistics: Tag frequency and completion rate tracking
- ☁️ Cloud Sync Ready: Optional NextCloud integration with detailed guide
- 🔓 Open Format: Plain Markdown files - you own your data
🚀 Quick Start
Installation
CODEBLOCK0
Basic Usage
CODEBLOCK1
📁 Diary Format
Mini Diary uses a simple Markdown format:
CODEBLOCK2
✅ Managing Todos
Adding Todos
Since todos are simple Markdown task lists, you can add them directly:
CODEBLOCK3
Todo Best Practices
- 1. Start with date: Ensure you're adding to the correct day's section
- Use clear descriptions: "Call John re: P1S delivery" not just "Call John"
- Update status: Change
[ ] to [x] when completed - Review daily: Check todos at start/end of each day
Finding Todos
CODEBLOCK4
🏷️ Auto-Tagging System
The AI automatically adds tags based on content:
| Tag | Meaning | Example Triggers |
|---|
| 🏠 | Family | home, family, household |
| 💰 |
Finance | invoice, payment, accounting |
| 📦 | Order | order, purchase, stock |
| 🚚 | Shipping | shipping, delivery, logistics |
| 💻 | Tech | software, system, computer |
| 🔧 | Support | repair, fix, issue, problem |
| 🎋 | Bambu | bambu, 3d print, printer |
| 📋 | Form | form, report, data, spreadsheet |
| 📅 | Daily | (default for routine notes) |
☁️ NextCloud Integration (Optional)
Setup
- 1. Set environment variable:
CODEBLOCK5
- 2. Mini Diary will automatically sync to this directory.
⚠️ Important Notes
File Permissions: NextCloud requires specific file ownership:
CODEBLOCK6
Scan Command Required: NextCloud won't detect changes automatically:
CODEBLOCK7
⚙️ Configuration
Environment Variables
CODEBLOCK8
Custom Tags
Create a JSON file to define custom tags:
CODEBLOCK9
📊 Advanced Usage
Weekly Report
CODEBLOCK10
Tag Analysis
CODEBLOCK11
Export Data
CODEBLOCK12
🔧 Troubleshooting
Common Issues
- 1. Tags not appearing: Check content keywords match tag rules
- NextCloud files not showing: Did you run the scan command?
- Permission errors: Check file ownership in NextCloud directory
- Search not working: Ensure diary file exists and has content
Debug Mode
CODEBLOCK13
🤝 Contributing
Found a bug? Have a feature request? Contributions welcome!
- 1. Fork the repository
- Create a feature branch
- Submit a pull request
📄 License
MIT License - see LICENSE file for details.
🙏 Acknowledgments
- - Built with OpenClaw
- Inspired by real-world need for simple, smart journaling
- Thanks to all contributors and users
Mini Diary - Because journaling should be simple, smart, and yours.
📓 迷你日记技能
你的AI驱动迷你日记。小巧精悍,智能功能。
✨ 功能特性
- - 📝 简洁日常记录:采用整洁的Markdown格式,包含日期、天气、笔记和待办事项
- 🏷️ 智能自动标签:AI分析内容并自动添加相关标签
- 🔍 强大搜索功能:按标签、日期或内容进行上下文搜索
- 📊 基础统计功能:追踪标签使用频率和完成率
- ☁️ 云同步就绪:可选NextCloud集成,附详细指南
- 🔓 开放格式:纯Markdown文件——数据完全归你所有
🚀 快速开始
安装
bash
通过ClawHub安装
clawhub install mini-diary
基本用法
bash
添加笔记(自动标签功能自动生效)
mini-diary add 与客户会面讨论P1S交付事宜
添加待办事项(使用[ ]表示待办,[x]表示已完成)
待办事项将添加到当前日期的待办区域
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
📁 日记格式
迷你日记采用简洁的Markdown格式:
markdown
📓 我的日记
📅 2024-02-22 星期四
📝 笔记
- - 与客户会面讨论P1S交付事宜 📦🎋
- 修复X1C打印机的加热问题 🔧🎋
- 提交月度发票 💰
✅ 待办事项
✅ 管理待办事项
添加待办事项
由于待办事项是简单的Markdown任务列表,你可以直接添加:
bash
添加待办事项
echo - [ ] 致电客户进行跟进 >> ~/diary.md
添加已完成事项
echo - [x] 提交周报 >> ~/diary.md
添加多个待办事项
cat >> ~/diary.md << EOF
- - [ ] 订购更多耗材
- [x] 备份服务器数据
- [ ] 安排团队会议
EOF
待办事项最佳实践
- 1. 从日期开始:确保添加到正确日期的区域
- 使用清晰描述:写致电John讨论P1S交付,而非仅致电John
- 更新状态:完成时将[ ]改为[x]
- 每日回顾:每天开始/结束时检查待办事项
查找待办事项
bash
搜索待办事项
grep \[ \] ~/diary.md
搜索已完成事项
grep \[x\] ~/diary.md
按状态统计待办事项
grep -c \[ \] ~/diary.md # 待办数量
grep -c \[x\] ~/diary.md # 已完成数量
🏷️ 自动标签系统
AI根据内容自动添加标签:
财务 | 发票、付款、会计 |
| 📦 | 订单 | 订单、采购、库存 |
| 🚚 | 物流 | 运输、配送、物流 |
| 💻 | 技术 | 软件、系统、电脑 |
| 🔧 | 支持 | 维修、修复、问题、故障 |
| 🎋 | 拓竹 | 拓竹、3D打印、打印机 |
| 📋 | 表单 | 表格、报告、数据、电子表格 |
| 📅 | 日常 | (常规笔记的默认标签) |
☁️ NextCloud集成(可选)
设置
- 1. 设置环境变量:
bash
export NEXTCLOUD
SYNCDIR=/path/to/nextcloud/diary
- 2. 迷你日记将自动同步到此目录。
⚠️ 重要提示
文件权限:NextCloud需要特定的文件所有权:
bash
将文件复制到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不会自动检测更改:
bash
docker exec nextcloud_app php occ files:scan [username]
⚙️ 配置
环境变量
bash
日记文件位置
export DIARY_FILE=$HOME/my-diary.md
NextCloud同步目录
export NEXTCLOUD
SYNCDIR=/path/to/nextcloud
自定义标签定义(JSON文件)
export TAGS_CONFIG=/path/to/tags.json
自定义标签
创建JSON文件定义自定义标签:
json
{
custom_tags: {
project-x: 🚀,
urgent: ⚠️,
meeting: 👥
},
rules: {
project-x: [项目x, px, 功能],
urgent: [紧急, 尽快, 重要],
meeting: [会议, 通话, 讨论]
}
}
📊 高级用法
周报
bash
生成周度摘要
mini-diary search --date $(date -d last week +%Y-%m-%d) --stats
标签分析
bash
查看最常用标签
mini-diary search --stats | grep -A5 标签统计
导出数据
bash
导出为CSV进行分析
grep ^- diary.md | sed s/^- // > notes.csv
🔧 故障排除
常见问题
- 1. 标签未显示:检查内容关键词是否匹配标签规则
- NextCloud文件未显示:是否执行了扫描命令?
- 权限错误:检查NextCloud目录中的文件所有权
- 搜索不工作:确保日记文件存在且包含内容
调试模式
bash
启用调试输出
export MINI
DIARYDEBUG=1
mini-diary add 测试笔记
🤝 贡献
发现Bug?有功能需求?欢迎贡献!
- 1. Fork仓库
- 创建功能分支
- 提交拉取请求
📄 许可证
MIT许可证 - 详见LICENSE文件。
🙏 致谢
- - 基于OpenClaw构建
- 灵感来源于对简单智能日记的实际需求
- 感谢所有贡献者和用户
迷你日记 - 因为日记应该简单、智能,且属于你。