Links

本地链接管理工具 — 全平台桌面应用，用于管理个人书签和资源链接。

数据完全存储在本地（SQLite），无需账号、无需联网，你的链接只属于你。

设计理念

• 本地优先：所有数据存储在本地 SQLite 数据库，不依赖任何云服务
• 轻量高效：Tauri + Rust 后端，安装包约 5MB，内存占用极低
• 快速捕获：全局快捷键 Cmd+Shift+L（macOS）/ Ctrl+Shift+L（Windows）随时唤起快速添加窗口
• 自动抓取：粘贴 URL 后自动抓取页面标题、描述、favicon 和封面图
• 全文搜索：基于 SQLite FTS5，支持中文和标签搜索，搜索结果高亮
• 安全可靠：链接去重检测、失效检测，数据损坏自动重建

核心功能

技术栈

项目架构

links/
├── .github/workflows/     # CI/CD：自动构建 Windows 安装包
│   └── release.yml
│
├── src-tauri/              # Rust 后端
│   ├── src/
│   │   ├── main.rs         # 入口，调用 app_lib::run()
│   │   ├── lib.rs          # Tauri builder：插件、命令注册、数据库初始化、全局快捷键、系统托盘
│   │   ├── db.rs           # SQLite 建表/迁移、数据模型、Db(Mutex<Connection>) 封装、CRUD、搜索、导出
│   │   ├── fetcher.rs      # URL 元数据异步抓取、Windows 系统代理
│   │   ├── commands.rs     # 所有 Tauri 命令、快捷键管理、剪贴板、去重/失效检测
│   │   ├── config.rs       # config.json 读写、Config(Mutex<HashMap>) 封装
│   │   └── normalize.rs    # URL 标准化（去重比较用）
│   ├── Cargo.toml          # Rust 依赖：tauri, rusqlite, reqwest, scraper, tokio...
│   ├── tauri.conf.json     # 窗口、构建、打包配置（主窗口 + quick-add 窗口）
│   └── capabilities/       # Tauri 权限配置
│
├── src/                    # Svelte 前端
│   ├── main.js             # 主窗口挂载入口
│   ├── quick-add.js        # 快速添加窗口入口
│   ├── App.svelte          # 主布局（侧边栏 + 内容区 + FAB）
│   ├── app.css             # CSS 变量设计系统 + 明暗主题
│   ├── lib/
│   │   ├── api.js          # Tauri invoke 封装（全部后端命令的 JS 绑定）
│   │   ├── stores/index.js # Svelte stores（links / categories / tags）
│   │   └── components/     # UI 组件
│   │       ├── LinkCard.svelte      # 链接卡片
│   │       ├── LinkForm.svelte      # 链接编辑/新增表单
│   │       ├── LinkList.svelte      # 链接列表
│   │       ├── SearchBar.svelte     # 搜索栏
│   │       ├── Sidebar.svelte       # 侧边栏（分组 + 标签）
│   │       ├── TagInput.svelte      # 标签输入
│   │       ├── ExportDialog.svelte  # 导出对话框
│   │       └── SettingsDialog.svelte # 设置对话框
│   └── pages/
│       └── QuickAdd.svelte # 快速添加页面
│
├── index.html              # 主窗口 HTML（含启动动画）
├── quick-add.html          # 快速添加窗口 HTML
├── package.json            # 前端依赖与脚本
├── vite.config.js          # Vite 配置（双入口：main + quick-add）
├── svelte.config.js        # Svelte 预处理配置
├── tsconfig.json           # TypeScript 严格模式配置
├── generate-icons.py       # 图标生成脚本
└── TODO.md                 # 开发进度跟踪

数据流

组件 → store 方法 → api.js → invoke() → Rust command → Db / HTTP

前端通过 api.js 统一封装所有 invoke() 调用，store 层管理状态和缓存，组件只与 store 交互。

数据库

links 表的 is_broken 字段标记链接失效状态，由后台异步检测更新。

后端命令

快速开始

环境要求

macOS 需要安装 xcode-select --install，Windows 需要 Visual Studio C++ Build Tools。

安装与启动

git clone https://github.com/Surihogg/links.git && cd links
npm install
npm run tauri dev

常用命令

npm run tauri dev          # 开发模式（Rust + 前端热重载）
npm run dev                # 仅前端（浏览器预览，后端不可用）
npm run build              # 仅构建前端
cd src-tauri && cargo check  # 快速检查 Rust 语法
cd src-tauri && cargo test   # 运行 Rust 单元测试

打包

npm run tauri build

rusqlite 使用 bundled 自带 SQLite，reqwest 使用 rustls-tls 无需系统 OpenSSL。只能在当前平台构建当前平台的包。

CI/CD

项目配置了 GitHub Actions 自动构建（.github/workflows/release.yml）：

• 触发条件：推送到 main 分支或手动触发
• 构建平台：Windows（当前仅 Windows）
• 产出：自动创建 GitHub Release Draft，附带安装包附件
• 发布流程：Draft 需手动确认后发布

如需支持 macOS / Linux 自动构建，需添加对应的 CI Runner。

数据存储

所有数据（数据库、配置、日志）存放在同一目录：

调试

DevTools

macOS: Cmd+Option+I，Windows/Linux: Ctrl+Shift+I

Console 直接调用后端

const { invoke } = window.__TAURI__.core;
await invoke("links_list", { params: {} });
await invoke("links_search", { params: { query: "关键词" } });
await invoke("categories_list");
await invoke("get_setting", { key: "close-behavior" });

Rust 日志

日志文件位于数据存储目录（见上方），文件名为 links.log。

常见问题

端口 1420 被占用：lsof -i :1420 找到进程后 kill -9 <PID>

Rust 编译失败：cd src-tauri && cargo check 2>&1，依赖下载失败重试，版本冲突删除 Cargo.lock

快捷键无效：检查 capabilities/default.json 是否包含 global-shortcut:allow-register

白屏：确认 Vite 在 localhost:1420 运行，DevTools 查看报错

数据库损坏：删除 links.db（含 -wal -shm）后重启自动重建

元数据抓取失败：检查 fail_links.log，Windows 用户确认系统代理设置

License

MIT