# ✅ 正确的标签格式
buku -a https://example.com "标题" ,python,tutorial,beginner
buku -a https://example.com "标题" ,web-dev,frontend,react
buku -a https://example.com "标题" ,2024/review,favorite

# ⚠️ 注意事项
# 1. 标签不区分大小写
buku -a https://example.com "标题" ,Python    # 存储为 python
buku -a https://example.com "标题" ,PYTHON    # 存储为 python

# 2. 标签中的空格会被保留
buku -a https://example.com "标题" ,web dev    # 标签为 "web dev"
buku -a https://example.com "标题" ,web-dev    # 标签为 "web-dev"（推荐）

# 3. 标签支持 Unicode 字符
buku -a https://example.com "标题" ,编程,教程,入门

# 列出所有标签及其使用次数
buku --stag

# 输出示例：
# 15 python
# 12 tutorial
#  8 web
#  6 javascript
#  5 reference
#  3 bookmark
#  2 cli

# 仅列出标签名称
buku --stag | awk '{print $2}'

# 统计标签总数
buku --stag | wc -l

# 添加书签时指定标签
buku -a https://example.com "标题" ,tag1,tag2,tag3

# 为现有书签添加标签
buku -u 1 + ,newtag              # 添加单个标签
buku -u 1 + ,tag1,tag2           # 添加多个标签

# 批量添加标签
for id in 1 3 5 7; do
    buku -u "$id" + ,reviewed
done

# 从书签中删除标签
buku -u 1 - ,oldtag              # 删除单个标签
buku -u 1 - ,tag1,tag2           # 删除多个标签

# 清除书签的所有标签
buku -u 1 ,

# 批量删除标签
for id in $(buku -s ,deprecated | grep "^[0-9]" | awk '{print $1}' | tr -d '.'); do
    buku -u "$id" - ,deprecated
done

# 替换书签的所有标签（删除旧标签，设置新标签）
buku -u 1 ,newtag1,newtag2

# 注意：这会清除所有现有标签，仅保留新标签
# 如果只是想修改某个标签，请使用 + 和 - 操作组合

# 全局重命名标签
buku --stag oldname newname

# 示例：将 "js" 重命名为 "javascript"
buku --stag js javascript

# 重命名后，所有包含 "js" 标签的书签都会被更新

# 从所有书签中删除特定标签
buku --stag oldname

# 示例：删除 "deprecated" 标签
buku --stag deprecated

# ⚠️ 注意：这会从所有书签中移除该标签

# 自动标签配置文件位置
~/.config/buku/auto_tag

# 文件格式：每行一个规则
# URL 模式  标签列表
# 使用空格或制表符分隔

# 创建自动标签配置
mkdir -p ~/.config/buku
cat > ~/.config/buku/auto_tag << 'EOF'
github.com ,github,code,git
stackoverflow.com ,stackoverflow,programming,q&a
docs.python.org ,python,doc,reference
developer.mozilla.org ,mdn,web,reference,documentation
arxiv.org ,research,paper,academic
youtube.com ,video,tutorial
medium.com ,article,blog
news.ycombinator.com ,news,tech,hacker-news
reddit.com ,social,community
gitlab.com ,gitlab,code,git
EOF

# 添加包含自动标签匹配域名的书签
buku -a https://github.com/jarun/buku "Buku 项目"
# 自动应用标签：,github,code,git,bookmark

# 手动标签与自动标签合并
buku -a https://github.com/jarun/buku "Buku 项目" ,python,cli
# 最终标签：,github,code,git,bookmark,python,cli

# 查看自动标签配置
cat ~/.config/buku/auto_tag

cat > ~/.config/buku/auto_tag << 'EOF'
# GitHub 相关
github.com ,github,code,git
*.github.io ,github-pages,blog,portfolio
gist.github.com ,github,gist,snippet

# 文档站点
docs.python.org ,python,doc,reference
doc.rust-lang.org ,rust,doc,reference
go.dev/doc ,golang,doc,reference
developer.mozilla.org ,mdn,web,reference
docs.microsoft.com ,microsoft,doc

# 学习资源
coursera.org ,course,online-learning
udemy.com ,course,online-learning
khanacademy.org ,course,online-learning
freecodecamp.org ,tutorial,programming,free

# 技术社区
stackoverflow.com ,stackoverflow,programming,q&a
news.ycombinator.com ,news,tech,hacker-news
reddit.com/r/programming ,reddit,programming
dev.to ,blog,programming,community
medium.com ,article,blog

# 学术资源
arxiv.org ,research,paper,academic
scholar.google.com ,research,academic,search
ieee.org ,research,paper,ieee
acm.org ,research,paper,acm

# 工具和服务
notion.so ,tool,productivity,notes
trello.com ,tool,project-management
figma.com ,tool,design,ui
EOF

# 添加带层级标签的书签
buku -a https://djangoproject.com "Django" ,tech/python/web/django
buku -a https://flask.palletsprojects.com "Flask" ,tech/python/web/flask
buku -a https://www.tensorflow.org "TensorFlow" ,tech/python/ml/tensorflow

# 搜索大类
buku -s ,tech
# 结果: 匹配所有 tech 开头的标签

# 搜索子类
buku -s ,tech/python
# 结果: 匹配所有 tech/python 开头的标签

# 搜索具体标签
buku -s ,tech/python/web
# 结果: 匹配所有 tech/python/web 的书签

# 搜索特定技术
buku -s ,tech/python/web/django
# 结果: 仅匹配 Django 相关书签

# 1. 保持层级一致性
# ✅ 推荐：统一使用 3-4 级
,tech/python/web/django,
,tech/rust/systems/tokio,

# ❌ 不推荐：层级不一致
,tech/python/django,       # 3 级
,tech/rust/web/backend/actix,  # 5 级

# 2. 使用简洁的标签名
# ✅ 推荐
,tech/python/web/django,
# ❌ 不推荐
,technology/python-programming/web-development/django-framework,

# 3. 避免过深的层级
# ✅ 推荐：最多 4 级
,tech/python/web/django,
# ❌ 不推荐：超过 4 级
,tech/python/web/backend/django/rest-framework/serializers,

# 为搜索结果添加标签
# 方法一：循环处理
buku -s python | grep "^[0-9]" | awk '{print $1}' | tr -d '.' | while read id; do
    buku -u "$id" + ,programming
done

# 方法二：使用 xargs
buku -j -s python | jq -r '.[].id' | xargs -I {} buku -u {} + ,programming

# 为特定范围的书签添加标签
for id in $(seq 1 100); do
    buku -u "$id" + ,legacy 2>/dev/null
done

# 从所有书签中删除特定标签
buku --stag deprecated

# 从搜索结果中删除标签
buku -s ,old-tag | grep "^[0-9]" | awk '{print $1}' | tr -d '.' | while read id; do
    buku -u "$id" - ,old-tag
done

# 使用 Buku 内置功能
buku --stag old-name new-name

# 或使用脚本进行更复杂的重命名
# 例如：将 "python3" 和 "py3" 都统一为 "python"
buku --stag python3 python
buku --stag py3 python

#!/bin/bash
# cleanup_tags.sh - 清理和标准化标签

echo "=== 标签清理工具 ==="
echo ""

# 1. 显示所有标签及使用次数
echo "当前标签列表："
buku --stag
echo ""

# 2. 合并相似标签
echo "合并相似标签..."
buku --stag js javascript 2>/dev/null
buku --stag py python 2>/dev/null
buku --stag rb ruby 2>/dev/null
buku --stag golang go 2>/dev/null

# 3. 删除空标签（如果存在）
# Buku 通常不会创建空标签，但可以检查

# 4. 显示清理后的标签
echo ""
echo "清理后的标签列表："
buku --stag

echo ""
echo "清理完成！"

# 每个书签建议标签数量：3-7 个
# ✅ 推荐
buku -a URL "标题" ,python,web,tutorial,reference

# ❌ 不推荐：标签过多
buku -a URL "标题" ,python,programming,language,code,web,tutorial,beginner,2024,useful

# ❌ 不推荐：标签过少
buku -a URL "标题" ,bookmark

#!/bin/bash
# tag_analysis.sh - 标签使用分析

echo "=== Buku 标签分析报告 ==="
echo ""

# 总书签数
total=$(buku -p | grep -c "^[0-9]")
echo "总书签数: $total"
echo ""

# 标签统计
echo "标签使用排行 (Top 20):"
echo "----------------------"
buku --stag | head -20

echo ""

# 无标签书签数
untagged=$(buku -j | jq '[.[] | select(.tags == "," or .tags == "")] | length')
echo "无标签书签: $untagged"

# 标签种类数
tag_count=$(buku --stag | wc -l)
echo "标签种类数: $tag_count"

# 平均每书签标签数
avg_tags=$(buku -j | jq '[.[] | .tags | split(",") | length - 2] | add / length')
echo "平均标签数: $avg_tags"

#!/bin/bash
# tag_distribution.sh - 标签分布可视化

echo "=== 标签分布图 ==="
echo ""

buku --stag | while read count tag; do
    bar=$(printf '%*s' "$count" '' | tr ' ' '█')
    printf "%-20s %s (%d)\n" "$tag" "$bar" "$count"
done | sort -t'(' -k2 -rn | head -30