核心用法
linkbox 是一款基于 Shell 脚本构建的本地书签管理工具，通过简单的命令行接口实现书签的全生命周期管理。用户可通过 add 命令将 URL 与标签关联存储，list 按标签筛选浏览，search 全文检索关键词，check 批量验证链接可用性，delete 移除指定条目，export 导出备份数据。所有数据以 JSON Lines 格式存储于 ~/.local/share/linkbox/ 目录，无需配置数据库或云服务。
显著优点
1. 极致轻量：纯 Shell 实现，仅依赖系统自带的 curl 与 Python3，无额外包管理负担，适合资源受限环境。
2. 隐私优先：数据完全本地存储，无云端同步、无账号体系，天然符合 GDPR 与 CCPA 的数据最小化原则。
3. 即开即用：无需复杂配置，安装后即可通过简洁命令完成书签管理，学习成本极低。
4. 链接健康监测：内置 check 命令可主动探测 URL 状态，帮助用户及时清理失效收藏。
潜在缺点与局限性
1. 输入验证薄弱：URL 添加时未校验格式，标签与搜索关键词未做转义处理，特殊字符可能导致命令异常或意外行为。
2. 无版本控制与冲突解决：直接操作文本文件，多进程同时写入存在数据损坏风险，无回滚机制。
3. 功能性边界：不支持浏览器插件一键保存、网页快照、全文索引等高级功能，仅满足基础管理需求。
4. 跨设备同步缺失：纯本地架构意味着用户需自行解决多设备数据同步问题。
适合的目标群体
- 命令行重度用户与极简主义爱好者
- 对隐私敏感、拒绝云服务的专业人士
- 需要轻量书签管理的开发测试环境
- 希望定期清理失效链接的维护者
使用风险
- 命令注入风险：变量未引用可能导致特殊输入被 shell 解析，建议仅输入可信 URL。
- 网络请求阻塞：curl 未设超时，检查大量失效链接时可能长时间挂起。
- 数据完整性依赖 Python：JSON 解析依赖 Python3，精简系统环境可能功能异常。
- 并发写入隐患：高频操作下建议避免并行使用，防止文件损坏。