GithubStarsManager

June 2, 2026 · View on GitHub

GithubStarsManager

一个基于AI的GitHub星标仓库管理工具，帮助您更好地组织和管理您的GitHub星标项目。

中文 | English

功能特性

星标太多找不到？GitHub Stars Manager 自动同步您的星标仓库，使用 AI 进行摘要和分类，支持语义搜索。追踪 Release、过滤资产、一键下载——比手动标签更智能，比 GitHub 更简单。

核心功能

功能	描述
自动同步星标	连接 GitHub Token 自动拉取所有星标仓库
AI 摘要与分类	使用 AI 生成标签、主题和简短 README 概览
语义搜索	按意图而非精确名称查找仓库
Release 追踪	订阅仓库并在统一时间线查看新版本
一键下载	展开 Release 资产并即时下载
智能资产过滤	按关键词匹配资产 (dmg / mac / arm64 / aarch64)
发现中心	浏览 GitHub 趋势、热门发布、最受欢迎项目
Fork 管理	查看、同步 Fork 仓库并触发 GitHub Actions 工作流
网络代理	HTTP / SOCKS5 代理支持，协议级连接探测测试
远程下载 (aria2)	通过 aria2 JSON-RPC 将 Release 资产推送到远程下载
诊断日志	前后端统一日志查看器，支持 Debug 捕获模式
双语 Wiki 跳转	根据仓库语言跳转到 Deepwiki (EN) 或 zread (ZH)
客户端打包	无需配置环境，下载即用

可选后端服务

部署 Express + SQLite 后端以实现：

跨设备同步 — 在不同浏览器和设备间共享数据
无 CORS 代理 — AI 和 WebDAV 请求通过服务器转发，避免浏览器 CORS 限制
加密令牌存储 — API 密钥安全存储，不暴露在浏览器中
网络代理转发 — 所有出站请求（GitHub、AI、WebDAV）通过 HTTP/SOCKS5 代理转发
RPC 下载代理 — 通过服务器转发 aria2 下载请求，密钥加密存储

🔍 界面预览

1. 仓库管理 (`Stars` 视图)

功能列表：

自动同步 — 连接 GitHub Token 自动拉取所有星标仓库
AI 批量分析 — 批量选择仓库，使用 AI 自动生成描述、标签和分类；支持暂停/继续分析进度
仓库卡片展示 — 显示 star 数、fork 数、编程语言、主分支状态；支持展开 README 预览
分类侧边栏 — 拖拽排序分类、自定义分类颜色、折叠/展开侧边栏；支持锁定分类防止 AI 覆盖
批量操作工具栏 — 批量归类到指定分类、批量恢复 AI 分析结果
订阅指示器 — 直观显示哪些仓库已订阅 Release 更新
AI 分析状态 — 显示已分析/未分析/分析失败状态；支持按分析状态筛选

截图： Repository Management Interface

2. Release 时间线 (`Releases` 视图)

功能列表：

订阅管理 — 订阅/取消订阅仓库的 Release 通知；支持批量取消订阅
时间线展示 — 按时间倒序列出所有仓库的新版本发布；显示已读/未读状态
智能资产过滤 — 按平台筛选 (macOS / Windows / Linux / ARM)；按文件类型筛选 (dmg / zip / deb / rpm / apk)
自定义过滤规则 — 保存自定义关键词过滤规则
展开下载 — 展开 Release 资产列表，一键复制下载链接；显示文件大小
多视图模式 — 列表视图 / 网格视图切换
分页加载 — 支持分页加载历史发布记录
刷新状态指示 — 显示最后刷新时间

截图： Release Timeline Interface

3. 发现中心 (`Discover` 视图)

功能列表：

五大发现渠道 — 趋势(Trending) / 热门发布(Hot Release) / 最受欢迎(Most Popular) / 话题(Topic) / 搜索(Search)
趋势时间范围 — 今日 / 本周 / 本月三个时间维度
趋势筛选规则 — 更新时间 30 天内，Star 数 50+，按 Star 降序排列
平台过滤 — 按操作系统筛选 (All / macOS / Windows / Linux / Browser)
编程语言过滤 — 按语言筛选 (JavaScript / TypeScript / Python / Go / Rust 等)
AI 仓库分析 — 一键对发现频道中的仓库进行 AI 分析
订阅仓库 — 将感兴趣的仓库加入订阅列表
移动端适配 — 移动设备友好的频道切换体验

趋势数据来源于 GitHub 趋势 RSS 源，每 30 分钟自动更新。适合发现新兴热门项目、追踪技术趋势、寻找学习方向。

截图： Discovery Trending Interface

4. Fork 管理 (`Forks` 视图)

功能列表：

Fork 列表 — 自动获取所有 Fork 仓库，检测上游更新
一键同步 — 将上游变更合并到任意分支，处理冲突
GitHub Actions — 在 Fork 卡片上直接查看和触发工作流
未读/已读追踪 — 上游有新提交的 Fork 显示脉冲指示器
搜索与分页 — 全文搜索、可配置分页大小

Screenshot: Fork

5. 搜索与过滤

功能列表：

多维度搜索 — 关键词搜索、仓库状态筛选、标签筛选、语言筛选、平台筛选
AI 分析状态筛选 — 已分析 / 未分析 / 分析失败 / 已编辑
Release 订阅筛选 — 已订阅 / 未订阅 Release
分类状态筛选 — 分类已锁定 / 未锁定
快捷键支持 — 显示搜索快捷键提示
搜索统计 — 显示搜索结果数量和筛选条件
搜索演示模式 — 展示语义搜索能力

截图：

6. 设置面板

设置分组：

分组	功能
General	语言切换 (中/英)、主题设置
AI Config	配置 OpenAI / Anthropic / Ollama / 兼容 API；支持自定义端点和密钥
WebDAV	坚果云、Nextcloud、ownCloud 等标准 WebDAV 服务备份配置
Backup	备份历史记录、手动备份/恢复、增量备份
Backend Server	连接自建后端服务、API 密钥验证、同步状态指示
Network	HTTP/SOCKS5 代理配置及协议级测试；aria2 RPC 远程下载设置
Category	分类管理、分类排序、默认分类覆盖规则
Data Management	数据导入/导出、清除本地数据、重置所有数据

截图： Settings Panel Interface

7. 自定义 AI 模型

功能列表：

多 AI 提供商支持 — OpenAI (GPT-3.5/GPT-4)、Anthropic (Claude)、Ollama (本地模型)、任何兼容 OpenAI 接口的 API
自定义端点 — 支持私有部署的 AI 服务
连接测试 — 配置后测试 API 连接是否可用
AI 模型选择 — 选择要使用的具体模型

截图： AI Configuration Interface

技术栈

前端: React 18 + TypeScript + Tailwind CSS
状态管理: Zustand
图标: Lucide React + Font Awesome
构建工具: Vite
部署: Netlify

💻 桌面客户端（推荐）

直接下载桌面客户端，无需配置环境：

https://github.com/AmintaCCCP/GithubStarsManager/releases

快速开始

1. 克隆项目

git clone https://github.com/AmintaCCCP/GithubStarsManager.git
cd GithubStarsManager

2. 安装依赖

npm install

3. 启动开发服务器

npm run dev

💡 本地使用 npm run dev 运行项目时，AI 服务和 WebDAV 的调用可能因浏览器 CORS 限制而失败。建议使用预编译客户端，或启动后端服务器（cd server && npm run dev）代理 API 请求以完全避免 CORS 问题。

4. 构建生产版本

npm run build

🤖 AI服务配置

应用支持多种AI服务提供商：

OpenAI: GPT-3.5/GPT-4
Anthropic: Claude
本地部署: Ollama等本地AI服务
其他: 任何兼容OpenAI API的服务

在设置页面中配置您的AI服务：

添加AI配置
输入API端点和密钥
选择模型
测试连接

🌐 网络代理配置

应用支持通过代理路由所有出站请求：

HTTP 代理 — 标准 HTTP CONNECT 隧道，支持可选认证
SOCKS5 代理 — 完整 SOCKS5 支持，包括用户名/密码认证 (RFC 1929)
协议级测试 — 连接测试执行真实的协议握手，而非简单 TCP 连接
加密存储 — 代理密码使用 AES-256-GCM 加密存储

在设置 → 网络标签页中配置（Electron 客户端或后端服务器可用时显示）。

⬇️ 远程下载 (aria2 RPC)

将 Release 下载链接直接发送到 aria2 守护进程：

启用 aria2 RPC：aria2c --enable-rpc --rpc-listen-port=6800
打开设置 → 网络 → 远程下载
输入主机、端口和可选密钥
测试连接后保存
Release 资产按钮将自动把下载任务推送到 aria2

支持有后端和纯前端两种模式（浏览器直连 aria2）。

💾 WebDAV备份配置

支持多种WebDAV服务：

坚果云: 国内用户推荐
Nextcloud: 自建云存储
ownCloud: 企业级解决方案
其他: 任何标准WebDAV服务

配置步骤：

在设置页面添加WebDAV配置
输入服务器URL、用户名、密码和路径
测试连接
启用自动备份

🚀 部署

Netlify部署

Fork本项目到您的GitHub账户
在Netlify中连接您的GitHub仓库
配置构建设置：
- Build command: npm run build
- Publish directory: dist
部署

其他平台

项目构建后生成静态文件，可以部署到任何静态网站托管服务：

Vercel
GitHub Pages
Cloudflare Pages
自建服务器

Docker 部署

GHCR 上有预构建的后端镜像，无需本地构建：

docker pull ghcr.io/amintacccp/github-stars-manager-server:latest
docker-compose up -d

如果镜像为私有，需先执行 docker login ghcr.io（使用具有 read:packages 权限的 PAT）。

请参阅 DOCKER.md 获取详细的构建和部署说明。Docker 设置正确处理了 CORS，并允许您直接在应用程序中配置任何 AI 或 WebDAV 服务 URL。

🖥️ 后端服务器（可选）

应用在没有后端的情况下也能完整运行（纯前端，使用 localStorage）。可选的 Express + SQLite 后端提供以下额外功能：

跨设备同步: 在不同浏览器和设备间共享数据
无 CORS 代理: AI 和 WebDAV 请求通过服务器转发，避免浏览器 CORS 限制
令牌安全: API 密钥加密存储在服务器，不会暴露在浏览器网络请求中

快速启动（推荐使用 Docker）

docker-compose up -d

前端运行在 8080 端口，后端运行在 3000 端口。数据持久化存储在 Docker 卷中。

自定义配置，创建 .env 文件：

API_SECRET=your-secret
ENCRYPTION_KEY=your-key
BACKEND_IMAGE_TAG=v0.6.2   # 固定版本（默认：latest）

仅后端（docker run）

# 基础运行 — 无认证，端口 3000
docker run -d --name github-stars-backend \
  -v github-stars-data:/app/data \
  -p 3000:3000 \
  ghcr.io/amintacccp/github-stars-manager-server:latest

# 自定义密钥和端口
docker run -d --name github-stars-backend \
  -v github-stars-data:/app/data \
  -p 3000:3000 \
  -e API_SECRET="your-secret" \
  -e ENCRYPTION_KEY="your-key" \
  ghcr.io/amintacccp/github-stars-manager-server:latest

手动启动

cd server
npm install
npm run dev

环境变量

变量	必填	说明
`API_SECRET`	否	API 认证令牌。未设置时禁用认证。
`ENCRYPTION_KEY`	否	用于加密存储密钥的 AES-256 密钥。未设置时自动生成。
`PORT`	否	服务器端口（默认：3000）