Yiliu - AI Note-Taking Knowledge Base
Capture anytime, auto-organize, surface on demand.
✨ What's New (v1.2.0)
- LibSQL Storage: Replaced sql.js with LibSQL for better performance
- Semantic Search: Vector similarity search with hybrid ranking
- AI Enhancement: Auto-generated summaries and tags
- Local Embeddings: Support for HuggingFace Transformers (no API key needed)
- Version Management: Auto-save + manual marking for important versions
Features
| Feature | Description | Command |
|---|---|---|
| Record | Quick capture with AI enhancement | /记 or type directly |
| Semantic Search | Find content by intent | /搜 <keyword> |
| List | View recent notes | /列表 |
| Edit | Modify existing notes | /编辑 <id> <content> |
| History | View version history | /历史 <id> |
| Export | Export to Markdown | /导出 |
| Stats | View statistics | /统计 |
Quick Start
Install
git clone https://github.com/DamingDong/yiliu.git
cd yiliu
npm install
npm run build
Configure AI (Optional)
export OPENAI_API_KEY="your-api-key"
# Optional: Custom API endpoint
export OPENAI_BASE_URL="https://api.openai.com/v1"
Without API Key: Falls back to local embeddings via @huggingface/transformers. Core features still work.
Usage
# Record a note (AI auto-summarizes + tags)
/记 Today I learned about CRDT sync with Last-Write-Wins strategy
# Semantic search (understands intent)
搜 distributed sync methods
# List notes
/列表
# View stats
/统计
# Export backup
/导出
AI Features
| Feature | Model | Description |
|---|---|---|
| Embeddings | text-embedding-3-small / all-MiniLM-L6-v2 | Semantic search |
| Summaries | gpt-4o-mini | Auto summaries |
| Tags | gpt-4o-mini | Auto tags |
No API Key: Falls back to keyword search, core features remain functional.
Data Storage
- LibSQL: Notes, version history
- Vector Index: Semantic search
- Path:
data/yiliu.db,data/vectors.json
Architecture
yiliu/
├── src/
│ ├── index.ts # Entry
│ ├── commands/ # Command handlers
│ ├── storage/ # Storage (LibSQL + Vector)
│ ├── ai/ # AI capabilities
│ └── types/ # Type definitions
├── data/ # Data directory
└── SKILL.md
Version History
- v1.2.0 (2026-03-20) - LibSQL, semantic search, AI enhancement, local embeddings
- v1.0.0 (2026-03-19) - MVP release
License
MIT License