建站与协作

MindPocket:书签、摘要与分类管理

  • 0 次阅读
  • 0 条评论
文章摘要

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

项目介绍

MindPocket 提供个人书签管理,并可结合 AI 做摘要和检索。当前上游使用 Cloudflare Workers、D1、Vectorize 与 R2 等组件,不能把旧文章中的示例仓库地址或 Docker 模板当作当前安装方案。

当前上游以 Cloudflare 组件保存书签、向量和文件,部署与旧教程不同。AI 摘要和检索在实际配置的模型服务上运行。

适合希望检索长期收藏的用户。先验证登录、数据隔离和资源计费,再导入私人链接。

核心功能

功能

作用与使用方式

书签收藏

保存网址与标题

摘要标签

按模型配置辅助整理

向量搜索

检索相关资料

多用户

验证数据范围

云端部署

维护 D1 R2 等资源

功能示意

MindPocket 功能示意图

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

MindPocket 官方界面示例
项目官方界面示例,展示上游演示数据。

项目信息

项目

说明

类型

项目指南

分类

建站与协作

项目仓库

jihe520/mindpocket

整理日期

2026-11-14

安装与运行

在开发电脑或 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 放在本机私有配置中,不复制到公开教程或截图。

更新与备份

更新前保存项目配置、输入资料和输出结果。源码项目记录当前提交与依赖锁文件,比较新版本说明后再更新;安装包项目保留可回退的版本号。服务账号的授权与模型账单在对应平台管理,删除本地目录不会自动撤销授权。

官方资料