项目介绍
MindPocket 提供个人书签管理,并可结合 AI 做摘要和检索。当前上游使用 Cloudflare Workers、D1、Vectorize 与 R2 等组件,不能把旧文章中的示例仓库地址或 Docker 模板当作当前安装方案。
当前上游以 Cloudflare 组件保存书签、向量和文件,部署与旧教程不同。AI 摘要和检索在实际配置的模型服务上运行。
适合希望检索长期收藏的用户。先验证登录、数据隔离和资源计费,再导入私人链接。
核心功能
功能示意

图 1:自制功能示意图,概括本文的使用要点。

项目信息
安装与运行
在开发电脑或 Linux/WSL 中准备 Node.js 与 pnpm。此项目 API 使用 Cloudflare Workers、D1 和 R2,不能当成一个普通 NAS Web 容器。
1. 安装和初始化
git clone https://github.com/jihe520/mindpocket.git
cd mindpocket
pnpm install
if [ ! -s apps/api/.dev.vars ]; then
umask 077
printf 'BETTER_AUTH_SECRET=%s
' "$(openssl rand -hex 32)" > apps/api/.dev.vars
fi
pnpm --filter api db:migrate:local
pnpm --filter api dev
2. 第一次使用
保留 API 终端,按终端显示的本地地址访问。先注册测试账号、新建分类、保存一条公开书签,检查摘要和搜索。若需要完整工作区开发,另一个终端进入仓库根目录运行 pnpm dev。
正式部署到 Cloudflare 时,按仓库 docs/CLOUDFLARE.md 创建 D1、Vectorize 和 R2,填好 apps/api/wrangler.jsonc 的资源 ID。使用 pnpm exec wrangler secret put BETTER_AUTH_SECRET 保存生产密钥,再从根目录运行 pnpm --filter api db:migrate:remote 和 pnpm deploy:cf。本地数据库与线上 D1 是两份数据,不能把本地测试成功当作已迁移。
常见问题
- 命令不存在:确认依赖已安装,关闭并重新打开终端,再检查实际使用的环境。Python 虚拟环境与系统 Python、Windows 与 WSL 的工具路径各自独立。
- 下载依赖失败:先查看具体失败的仓库和包名,检查该终端的网络;浏览器能访问不代表命令行已使用同一代理。
- 配置后仍报错:从当前项目目录启动,检查配置文件名、变量名和日志。真实账号与 API Key 放在本机私有配置中,不复制到公开教程或截图。
更新与备份
更新前保存项目配置、输入资料和输出结果。源码项目记录当前提交与依赖锁文件,比较新版本说明后再更新;安装包项目保留可回退的版本号。服务账号的授权与模型账单在对应平台管理,删除本地目录不会自动撤销授权。