GithubStarsManager - AI 驱动的 GitHub 星标仓库管理工具
GithubStarsManager 是一个 AI 驱动的 GitHub 星标仓库管理应用，支持自动同步 Stars、AI 摘要与分类、语义搜索、Release 跟踪、Fork 管理、Gist 管理等核心功能，并提供可选后端服务器、Docker 部署与 MCP 服务器支持。
社区作者 · zZz
它解决什么问题
GithubStarsManager 是一个 AI 驱动的 GitHub 星标仓库管理应用。它自动同步你 starred 的仓库，使用 AI 生成摘要和分类，并通过语义搜索快速找到内容。支持 Release 跟踪、资源过滤和一键下载，比手动标签更智能，比 GitHub 原生体验更简洁。
主要功能：
- 自动同步 Stars：连接 GitHub Token 自动拉取所有星标仓库
- AI 摘要与分类：使用 AI 生成标签、主题和简短 README 概览
- 语义搜索：按意图而非精确名称查找仓库
- 向量语义搜索：将仓库描述/README 嵌入 Cloudflare Vectorize 索引，用自然语言高精度匹配
- MCP 服务器：可选的 Streamable HTTP / SSE 端点，供 Claude Code、Cursor 等 Agent 搜索 AI 增强的星标数据（需后端或 Electron/桌面端，纯前端界面隐藏该选项）
- Release 跟踪：订阅仓库，统一时间线查看新版本
- 一键下载：展开 Release 资源并即时下载
- 智能资源过滤：按关键词（dmg/mac/arm64/aarch64）匹配资源
- Fork 管理：查看、同步上游、在 fork 仓库上触发 GitHub Actions
- Gist 管理：浏览、创建、编辑、删除 Gist，支持 AI 摘要和语义搜索
- 网络代理：HTTP/SOCKS5 代理，协议级连接测试
- 远程下载（aria2）：通过 JSON-RPC 将 Release 资源发送到 aria2
- 诊断日志：前后端统一日志查看器，带调试捕获模式
- 双语 Wiki 跳转：根据仓库语言跳转 Deepwiki（英文）或 zread（中文）
- 打包客户端：无需环境配置，下载即用
界面预览（配图 3-12）：仓库管理界面、Release 时间线界面、发现/趋势界面、Fork 管理界面、Gist 管理界面、搜索界面、设置面板界面、AI 配置界面、网络配置界面、向量搜索配置界面。
可选后端服务器：部署 Express + SQLite 后端，支持跨设备同步、无 CORS 的 API 代理、加密令牌存储、网络代理转发、RPC 下载代理。
技术栈：前端 React 18 + TypeScript + Tailwind CSS，状态管理 Zustand，图标 Lucide React + Font Awesome，构建工具 Vite。后端 Express + SQLite。
适用对象：拥有数百/数千星标仓库的开发者、系统性跟踪 Release 的用户、不想手动打标签的“懒而高效”用户。
许可证：MIT。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
方式一：桌面客户端（推荐）
从 https://github.com/AmintaCCCP/GithubStarsManager/releases 下载预构建客户端，无需配置环境即可运行。
方式二：从源码运行
步骤 1 · 下载源码或克隆仓库：
git clone https://github.com/AmintaCCCP/GithubStarsManager.git- 进入项目目录，打开终端
- 运行 npm install 安装依赖
- 运行 npm run dev 启动开发服务器
注意：本地使用 npm run dev 时，由于 CORS 限制，调用 AI 服务和 WebDAV 可能会失败。建议使用预构建客户端、自行构建客户端，或运行后端服务器（cd server && npm run dev）来代理 API 请求，完全避免 CORS 问题。
方式三：Docker 部署
预构建的后端和前端镜像已发布到 GHCR，无需本地构建：
docker pull ghcr.io/amintacccp/github-stars-manager-server:latestdocker pull ghcr.io/amintacccp/github-stars-manager-frontend:latestdocker-compose up -d
如果包是私有的，先运行 docker login ghcr.io（使用具有 read:packages 权限的 PAT）。详细说明见 DOCKER.md。
Docker 部署已妥善处理 CORS，可直接在应用中配置任意 AI 或 WebDAV 服务 URL。
可选后端服务器
纯前端模式（localStorage）下应用可完全运行。可选的 Express + SQLite 后端提供：跨设备同步、无 CORS 代理、令牌加密存储、网络代理转发、RPC 下载代理。
Docker 快速开始：docker-compose up -d
前端在 8080 端口，后端在 3000 端口，数据持久化在 Docker volume 中。
自定义配置：创建 .env 文件：
API_SECRET=your-secretENCRYPTION_KEY=your-keyBACKEND_IMAGE_TAG=0.6.2FRONTEND_IMAGE_TAG=0.6.2仅后端（docker run）：
docker run -d --name github-stars-backend -v github-stars-data:/app/data -p 3000:3000 ghcr.io/amintacccp/github-stars-manager-server:latest手动安装后端：
cd servernpm installnpm run dev环境变量说明：
- API_SECRET（可选）：API 认证 Bearer token，不设置则禁用认证
- ENCRYPTION_KEY（可选）：AES-256 密钥，用于加密存储的密钥，不设置则自动生成
- PORT
