177 lines
3.8 KiB
Markdown
177 lines
3.8 KiB
Markdown
# Xian Favor - 收藏关注技能
|
||
|
||
收藏管理系统，用于保存文本笔记、链接、专栏订阅、待办事项。
|
||
|
||
## 触发条件
|
||
|
||
当用户提到以下内容时激活此技能：
|
||
- 收藏、保存、记录（笔记、链接）
|
||
- 待办、任务、提醒
|
||
- 专栏、订阅
|
||
- "帮我记一下"、"保存这个链接"、"添加待办"
|
||
- 查看收藏、我的笔记、待办列表
|
||
|
||
## 核心功能
|
||
|
||
### 1. 添加条目
|
||
|
||
```bash
|
||
# 添加文本笔记
|
||
xian_favor add text "内容" -t "标签1,标签2"
|
||
|
||
# 添加链接
|
||
xian_favor add link "https://url" --title "标题" -t "标签"
|
||
|
||
# 添加专栏订阅
|
||
xian_favor add column "https://feed.url" --title "专栏名" --source "RSS" -t "订阅"
|
||
|
||
# 添加待办事项
|
||
xian_favor add todo "任务内容" -p high -d "2026-12-31" -t "工作"
|
||
# -p 优先级: low/medium/high/urgent
|
||
# -d 截止日期: YYYY-MM-DD
|
||
```
|
||
|
||
### 2. 查看列表
|
||
|
||
```bash
|
||
# 全部条目
|
||
xian_favor list
|
||
|
||
# 筛选类型
|
||
xian_favor list --type todo
|
||
xian_favor list --type link
|
||
xian_favor list --type text
|
||
|
||
# 筛选状态（待办）
|
||
xian_favor list --type todo --status pending
|
||
xian_favor list --type todo --status in_progress
|
||
xian_favor list --type todo --status completed
|
||
|
||
# 筛选标签
|
||
xian_favor list --tag "技术"
|
||
|
||
# JSON输出（用于AI处理）
|
||
xian_favor list --json
|
||
```
|
||
|
||
### 3. 搜索
|
||
|
||
```bash
|
||
xian_favor search "关键词"
|
||
xian_favor search "关键词" --type todo --json
|
||
```
|
||
|
||
### 4. 查看详情
|
||
|
||
```bash
|
||
xian_favor show <ID>
|
||
xian_favor show 1 --json
|
||
```
|
||
|
||
### 5. 编辑
|
||
|
||
```bash
|
||
xian_favor edit <ID> --status completed --note "已完成"
|
||
xian_favor edit <ID> --priority high -d "2026-12-31"
|
||
xian_favor edit <ID> --tags "新标签1,新标签2"
|
||
```
|
||
|
||
### 6. 完成待办
|
||
|
||
```bash
|
||
xian_favor done <ID>
|
||
```
|
||
|
||
### 7. 删除
|
||
|
||
```bash
|
||
xian_favor delete <ID> -f # -f 强制删除不确认
|
||
```
|
||
|
||
### 8. 标签管理
|
||
|
||
```bash
|
||
xian_favor tags # 列出所有标签
|
||
xian_favor tags --delete "旧标签" # 删除标签
|
||
```
|
||
|
||
### 9. 统计
|
||
|
||
```bash
|
||
xian_favor stats
|
||
```
|
||
|
||
## AI 使用指南
|
||
|
||
### 添加笔记时
|
||
|
||
当用户说"帮我记一下..."，自动创建文本笔记：
|
||
```bash
|
||
xian_favor add text "用户的内容" --title "标题（可选）" -t "自动分类标签"
|
||
```
|
||
|
||
### 添加链接时
|
||
|
||
当用户提供链接说"收藏这个"：
|
||
```bash
|
||
xian_favor add link "URL" --title "链接标题（从内容推断）" -t "分类标签"
|
||
```
|
||
|
||
### 添加待办时
|
||
|
||
当用户说"提醒我..."、"我要做..."：
|
||
```bash
|
||
xian_favor add todo "任务内容" -p medium -t "待办"
|
||
```
|
||
- 根据用户语气判断优先级
|
||
- 如果用户提到时间，设置截止日期
|
||
|
||
### 查看待办时
|
||
|
||
```bash
|
||
xian_favor list --type todo --status pending --json
|
||
```
|
||
然后用自然语言总结给用户。
|
||
|
||
### 完成待办时
|
||
|
||
当用户说"完成了..."：
|
||
```bash
|
||
xian_favor done <ID>
|
||
```
|
||
|
||
### 搜索时
|
||
|
||
```bash
|
||
xian_favor search "关键词" --json
|
||
```
|
||
|
||
## Web 界面
|
||
|
||
服务运行在端口 **19014**：
|
||
- http://localhost:19014
|
||
|
||
## 数据存储
|
||
|
||
SQLite 数据库：`~/.xian_favor/xian_favor.db`
|
||
|
||
## 注意事项
|
||
|
||
1. **自动分类**：根据内容自动添加合适标签
|
||
2. **智能标题**：如果没有标题，从内容提取关键信息作为标题
|
||
3. **优先级推断**：用户说"紧急"、"重要"→ high/urgent；用户说"有空做"→ low
|
||
4. **JSON输出**：AI处理时使用 `--json` 参数获取结构化数据
|
||
|
||
## 示例对话
|
||
|
||
用户："帮我记一下，今天学了一个新命令 git stash"
|
||
→ `xian_favor add text "今天学了一个新命令 git stash" -t "学习,git"`
|
||
|
||
用户："收藏这个链接 https://example.com/article"
|
||
→ `xian_favor add link "https://example.com/article" -t "收藏"`
|
||
|
||
用户："提醒我明天检查邮件"
|
||
→ `xian_favor add todo "检查邮件" -d "YYYY-MM-DD" -t "工作"`
|
||
|
||
用户："我有什么待办？"
|
||
→ `xian_favor list --type todo --status pending --json` → 总结给用户 |