README_zh.md

ForgetURL

🔖 极简书签管理 · 让收藏变得简单

功能特性 • 产品截图 • 技术架构 • 快速开始 • 开源协议

English | 中文

---

🌟 为什么选择 ForgetURL？

厌倦了臃肿的书签管理器？ForgetURL 让你专注于真正重要的事情 —— 收藏链接，分享知识。

在信息爆炸的时代，我们每天都会发现值得收藏的网页。但传统的浏览器书签功能往往杂乱无章，难以管理和分享。ForgetURL 应运而生，它是一款极简主义的书签管理工具，帮助你优雅地整理、分享你的网络收藏。

---

✨ 功能特性

🔐 安全登录 支持 Google 账号登录 支持 GitHub 账号登录 安全的 Token 认证机制 一键登录，无需注册	📖 书签管理 创建多个书签页面 链接分组管理（Collections） 支持标签和子链接 实时编辑，自动保存
🔗 灵活分享 分享类型 权限 🔒 只读链接 仅查看 ✏️ 编辑链接 可修改内容 👑 管理链接 完全控制	📱 极致体验 响应式设计，完美适配移动端 类 X.com / ChatGPT 的极简风格 流畅的动画过渡 深色/浅色主题支持

更多特性

• 📥 导入/导出 - 支持从浏览器导入书签
• 🏷️ 标签系统 - 为链接添加标签，快速筛选
• 📂 链接分组 - 通过 Collections 组织相关链接
• 🔄 版本控制 - 防止编辑冲突，数据更安全
• 🌍 多环境 - 支持本地、测试、生产环境

---

🖼️ 产品截图

极简的登录界面

┌─────────────────────────────────────────────────────────┐
│                                                         │
│                    🔖 ForgetURL                         │
│                                                         │
│              极简书签管理，让收藏更简单                    │
│                                                         │
│         ┌─────────────────────────────┐                 │
│         │   🔵  Continue with Google  │                 │
│         └─────────────────────────────┘                 │
│         ┌─────────────────────────────┐                 │
│         │   ⚫  Continue with GitHub  │                 │
│         └─────────────────────────────┘                 │
│                                                         │
└─────────────────────────────────────────────────────────┘

清爽的书签管理界面

┌─────────────────────────────────────────────────────────┐
│  🔖 ForgetURL                              [用户头像]   │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  我的空间                              [+ 创建页面]     │
│                                                         │
│  ┌─────────────────┐  ┌─────────────────┐               │
│  │ 📚 开发工具      │  │ 📰 每日阅读      │               │
│  │ 收集常用的开发.. │  │ 技术文章和新闻.. │               │
│  │ 12 个链接       │  │ 8 个链接         │               │
│  └─────────────────┘  └─────────────────┘               │
│                                                         │
│  ┌─────────────────┐  ┌─────────────────┐               │
│  │ 🎨 设计灵感      │  │ 🎓 学习资源      │               │
│  │ UI/UX 设计参考.. │  │ 在线课程和教程.. │               │
│  │ 15 个链接       │  │ 20 个链接        │               │
│  └─────────────────┘  └─────────────────┘               │
│                                                         │
└─────────────────────────────────────────────────────────┘

---

🛠️ 技术架构

前端	后端
Vue 3 + Composition API Vite 构建工具 Pinia 状态管理 Tailwind CSS 样式框架 Headless UI 组件库	Go 1.23 Gin Web 框架 GORM ORM 框架 MySQL + Redis Protocol Buffers API 定义

项目结构

forgeturl/
├── forgeturl-server/          # 🔧 后端服务
│   ├── app/
│   │   ├── api/               # API 层 (Protobuf 定义)
│   │   ├── dal/               # 数据访问层
│   │   ├── pkg/               # 工具包
│   │   └── route/             # 路由配置
│   ├── tests/                 # 测试用例
│   └── Dockerfile
│
└── forgeturl-website/         # 🎨 前端网站
    ├── src/
    │   ├── api/               # API 接口封装
    │   ├── components/        # 公共组件
    │   ├── composables/       # 组合式函数
    │   ├── stores/            # 状态管理
    │   └── views/             # 页面视图
    └── package.json

---

🚀 快速开始

👉 直接使用（推荐）

无需安装任何东西，直接访问在线版本：

🔧 本地开发

如果你想在本地运行或参与开发：

📦 前端开发

cd forgeturl-website-claude-opus-4.5
npm install
npm run dev

访问 http://localhost:3000

⚙️ 后端开发

cd forgeturl-server/app
go mod download
cp conf/local.toml.example conf/local.toml
# 编辑 local.toml 配置数据库和 Redis
go run main.go api start

API 服务运行在 http://127.0.0.1:80

🐳 Docker 部署

cd forgeturl-server
docker build -t forgeturl-server .
docker run -d -p 80:80 forgeturl-server

---

📚 文档

文档	描述
后端 README	服务端详细文档
前端 README	前端详细文档
开发指南	开发环境配置

---

🤝 贡献

我们欢迎所有形式的贡献！

• 🐛 提交 Bug 报告
• 💡 提出 功能建议
• 📝 改进文档
• 🔧 提交 Pull Request

---

📄 开源协议

本项目采用 MIT License 开源协议。

---

🌐 ForgetURL.com
_{让书签管理变得简单优雅}