- 搜索书签、标签
- 根据标签筛选书签
- 支持移动端/桌面端、明亮主题/暗夜主题
后台管理功能：
- 基于 Github OAuth 的身份认证
- 导入浏览器导出的书签
- 标签、书签的增删改查
- 标签间的相互关联
- 标签和书签的相互关联
- 标签排序
- 爬取网站标题、图标、简介
- AI 智能解析网站标题、图标、简介、关联标签
- AI 为标签关联标签
- 多个 API 自动获取网站图标
待实现：
- 定期检测书签可用性
- 书签置顶、仅登录用户可见
- 稍后阅读系统
- 用户系统
需要准备的内容包括 数据库 和 Github OAuth App 密钥对，下面分别介绍。
BMM 使用 Drizzle ORM 持久化存储数据，当前开箱即用的支持 SQLite 和 PostgreSQL 数据库。
默认的环境变量配置使用本地的 SQLite 数据库。但是这种方式只适合本地开发调试，不适合线上部署。
如果你需要线上数据库，下面提供两种方式：
创建好数据库后，在 .env 中配置相关环境变量即可。
BMM 使用 Github 授权登录，认证管理员身份，因此需要配置 Github OAuth。
查看创建步骤
-
登录您的 Github 账户后，访问 https://github.com/settings/applications/new
-
依次填写表单内容
其他内容可随意填写，最重要的是 Authorization callback URL 这一项，请保证它和你的项目最终部署的 线上访问地址 一致！
- 创建一个 Client secret
Github OAuth App 的 Client ID 和 Client Secret 将分别用作环境变量 AUTH_GITHUB_ID 和 AUTH_GITHUB_SECRET，填写的 Authorization callback URL 要和环境变量 AUTH_URL 保持一致。
- git clone 项目
git clone https://github.com/Y80/bmm.git-
pnpm install安装依赖 -
pnpm dev启动项目
对于开发环境，AUTH_URL 可以被自动侦测到，AUTH_GITHUB_ID 和 AUTH_GITHUB_SECRET 也临时提供了一对可用的配置，因此可暂时跳过配置。
通过 pnpm build 构建生产产物时，需要明确配置上面这 3 个变量。
-
fork 当前 Github 仓库
-
登入 Vercel，新建项目，并关联 fork 的 Github 仓库
-
在当前项目下的 Environment Variables 页面中配置环境变量：
DB_DRIVER、DB_CONNECTION_URL、AUTH_URL、AUTH_GITHUB_SECRET和AUTH_GITHUB_ID。
查看截图
Vercel 上每个项目都会被自动分配一个域名，如 bmm.vercel.app，如果你最终使用这个域名访问 BMM 服务，那么可以不用配置 AUTH_URL，否则必须配置该环境变量。
- 在 「Deployments 面板」再重新部署一下即可
# 拉取镜像
docker pull lcclcc/bmm
# 启动容器（使用本地 SQLite， 通过 docker volume bmm 查看数据库文件地址）
docker run --rm \
-e DB_DRIVER=sqlite \
-e DB_CONNECTION_URL=file:/app/volume/sqlite.db \
-v bmm:/app/volume \
-p 3000:3000 \
lcclcc/bmm \
pnpm start
# 启动容器（使用 Turso ）
docker run --rm \
-e DB_DRIVER=sqlite \
-e DB_CONNECTION_URL=libsql://Turso数据库地址 \
-e DB_AUTH_TOKEN=<Turso数据库令牌> \
-p 3000:3000 \
lcclcc/bmm \
pnpm start
# 启动容器（使用 PostgreSQL ）
docker run --rm \
-e DB_DRIVER=postgresql \
-e DB_CONNECTION_URL=postgresql://数据库地址 \
-p 3000:3000 \
lcclcc/bmm \
pnpm start
本项目通过 AI 实现了 分析总结网站、给网站打标签、分析相关联的标签 的功能，可大大减少维护书签数据的工作量。
由于目前 AI 服务商众多，且不同服务商提供的 API 并不相同，因此这里会有轻微的编码工作。
下面是使用 字节跳动-扣子 AI 能力的示例：
export const getServer = coze
function coze() {
if (!env.COZE_API_KEY || !env.COZE_BOT_ID) {
throw new Error('请配置环境变量 COZE_API_KEY、COZE_BOT_ID')
}
return {
responseContentPath: 'messages[0].content',
sendRequest(query: string) {
return commonFetch({
url: 'https://api.coze.cn/open_api/v2/chat',
token: process.env.COZE_API_KEY!,
body: {
bot_id: process.env.COZE_BOT_ID,
user: 'user',
query,
stream: false,
},
})
},
}
}src/lib/ai/servers.ts 文件提供了使用 扣子 和 OpenAI 的代码示例可供参考。
配置环境变量注意敏感数据泄露！不同的环境可以配置不同的环境变量！更多内容可参考 .env
如何设置环境变量 AUTH_URL 和 Github 中的 Authorization callback URL?
首先需要明确， AUTH_URL 和 Github OAuth App 中的 Authorization callback URL 是要一致的，用于指定用户在 Github 确认授权后，浏览器需要重定向的服务器地址。
它们的值如何设定，简单来说，通过什么地址访问 BMM 服务，就把该地址作为它们的值，例如：
- http://localhost:3000 - 本地开发
- https://bmm.vercel.app - 部署到 Vercel 的平台上，使用 Vercel 为你分配的域名
- https://example.com - 用 nginx 代理了本机地址，线上通过域名访问服务
- http://10.1.2.3:3000 - 线上通过 IP:PORT 直接访问服务
Github 登录失败：redirect_uri 错误
如果在 Github 授权之后出现如下错误提示：
这表示授权之后 Github 需要跳转的地址和 Github:OAuth Apps 中的配置不一致。
请保证下方配置的 Authorization callback URL 和你访问的域名地址、 AUTH_URL 一致。
支持其他数据库吗？
由于 drizzle-orm 除了支持 PostgreSQL，还支持 MySQL 和 SQLite，因此对项目做少许编码改造，即可切换数据库。