KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

ComfyUI-Ranking

★ 28 Open GitHub ↗

ComfyUI中的应用排行榜工具

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ComfyUI-Ranking

> ComfyUI 精选社区 —— 让创作有价值，让分享有回报

一个深度集成于 ComfyUI 的内容社区插件，支持工具发布、应用分享、资源推荐、任务委托等功能，打造 ComfyUI 生态的价值闭环。

---

## 🎯 项目愿景

1. **让创作变现** —— 工具/工作流可直接定价销售，创作者持续获得收益
2. **让优质可见** —— 多维度榜单排序，好内容更容易被发现和获取
3. **让分享有回报** —— 建立健康的赞赏机制，无偿分享也能获得支持
4. **让生态繁荣** —— 正向循环驱动社区持续进步

---

## ✨ 核心功能

### 📊 六大榜单

| 榜单 | 说明 | 动画效果 |
|------|------|----------|
| **工具榜** | 发布 ComfyUI 节点插件，支持 GitHub 私有库绑定防盗 | 🌊 瀑布式载入 |
| **应用榜** | 分享工作流 JSON，一键下载并导入工作区 | 🌊 瀑布式载入 |
| **推荐榜** | 类小红书的图文内容，封面图 + 详情图展示 | 🌊 瀑布式载入 |
| **讨论区** | 社区交流，支持富文本发帖、评论树与帖子打赏 | 🕳️ 深渊汇聚 |
| **任务榜** | 发布外包需求，支持订金托管、尾款结算与仲裁申诉 | ⚡ 数据流滑入 |
| **创作者榜** | 优质创作者排行，展示贡献、粉丝数据与赞赏总榜 | 🌀 扇形展开 |

### 🌐 国际化支持

- **双语界面** —— 完整支持中文/英文切换
- **交易类型国际化** —— 交易记录支持多语言显示

### 🚀 极简体验

- **一键安装** —— 静默安装插件到 `custom_nodes`，云端内存解压，无需手动 `git clone`
- **一键加载** —— 下载工作流后直接添加到工作区，已购内容永久有效
- **自动更新** —— 定时检测 GitHub 版本，发现新版一键覆盖更新
- **性能优化** —— SWR缓存策略、离线回退机制、N+1查询防护

### 💬 社交互动

- **点赞收藏** —— 标记喜欢的内容，方便后续查找
- **关注粉丝** —— 关注创作者，查看粉丝/关注详情列表
- **评论系统** —— 支持嵌套评论树，防崩溃设计
- **私信聊天** —— 即时通讯，消息实时推送
- **通知中心** —— 点赞、回复、购买等全局消息提醒

### 💰 价值体系

- **定价自由** —— 自由设置积分价格（1积分=1元），或设为免费
- **充值便捷** —— 支付宝扫码秒充值
- **统一余额模型** —— balance为可用余额，earn_balance/tip_balance为累计统计
- **安全提现** —— 阶梯手续费，提现至支付宝
- **交易记录** —— 完整的购买、打赏、充值、提现记录查询

### 🔒 安全保障

- **内容保护** —— 付费内容云端永久记录，一次购买终身有效
- **私有库防盗** —— 支持 GitHub 私有库密钥绑定
- **账号安全** —— 基于邮箱的安全验证与风控
- **图片审核** —— 多云平台智能审核，过滤违规内容
- **管理员权限** —— 完善的管理员权限体系，支持仲裁与审核

---

## 🔌 开放API（第三方插件接入）

本项目提供通用的开放API，允许第三方ComfyUI插件接入RanKing的账号系统与消费系统，实现统一登录、余额共享、计费与退款。

### API端点

| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/open/verify-token` | POST | 验证用户Token，返回账号信息（昵称、头像） |
| `/api/open/balance` | GET | 查询用户钱包余额（balance / earn_balance / tip_balance / task_balance / frozen_balance） |
| `/api/open/deduct` | POST | 通用扣款（从可用余额扣减，写入交易流水） |
| `/api/open/refund` | POST | 退款（部分或全额回退至用户钱包） |

### 接入方式

- 每个第三方插件需向 RanKing 注册获取唯一的 `plugin_key`
- 所有请求必须携带 `X-Plugin-Key` Header
- 余额查询接口同时需要 `Authorization: Bearer <user_token>`
- 扣款 / 退款 / Token验证 接口在请求体中携带 `token` 字段
- 每个 `plugin_key` 独立限流（默认 100 次/分钟，按分钟滑窗内存计数）

### 已接入插件

| 插件 | 标识 | 说明 |
|------|------|------|
| **NodeCraft AI** | `nodecraft_ai` | ComfyUI 节点梦工厂 — AI 编程助手 |

### 安全机制

- **Plugin Key 验证**：未注册或非法 Key 直接返回 403
- **细粒度权限**：每个插件可单独配置允许调用的接口（verify / balance / deduct / refund）
- **独立限流**：按 `plugin_id` 维度隔离，互不影响
- **悲观锁**：扣款/退款使用 `SELECT ... FOR UPDATE` 锁定钱包行，保证并发安全
- **哈希链审计**：所有 `OPEN_DEDUCT` / `OPEN_REFUND` 操作写入 `Transaction` 表，包含 `prev_hash` + `tx_hash`，可全链路追溯
- **跨插件隔离**：退款时校验 `related_account == plugin_id`，禁止跨插件互相退款
- **退款防超额**：累计已退金额 + 本次退款金额 ≤ 原扣款金额

### 错误码约定

| 状态码 | 含义 |
|--------|------|
| 401 | 缺少 `X-Plugin-Key` 或用户 Token |
| 402 | 余额不足 |
| 403 | Plugin Key 无效 / 无对应权限 / 跨插件操作被拒 |
| 404 | 原交易不存在（退款时） |
| 429 | 触发插件级限流 |

> 详细接入指南请参考 [`技术文档/13_开放API与第三方插件接入.md`](./技术文档/13_开放API与第三方插件接入.md)

---

## 📝 更新记录

### 2026-08-11
- 提现审核、申诉仲裁、版本管理、公告与广告等管理功能，全部搬到云端管理面板
- 插件里不再保留管理入口，管理员直接前往云端面板操作
- 修复了点击放大证据图片时可能存在的安全隐患
- 优化“忘记账号？”找回：通过邮箱验证码找回账号，并可直接跳转设置新密码

### 2026-08-06
- 修复了调整侧边栏高度后，底部出现大片空白的问题

### 2026-07-26
- 修复了注册时选的头像不显示的问题
- 头像设置失败时会明确提醒，不影响注册和登录

### 2026-06-17
- 新增其他 ComfyUI 插件接入支持，可与 RanKing 共用登录和余额
- 首个接入插件：NodeCraft AI（节点梦工厂）— ComfyUI AI编程助手

### 2026-06-12
- 修复充值成功后重复收到多条到账提醒的问题
- 修复提现按钮响应慢时连续点击会重复提交的问题
- 修复打赏成功后页面余额没有及时更新的问题
- 修复充值界面打开时显示的余额不是最新的问题
- 修复个人主页背景图太大导致缓存报错的问题

### 2026-06-11
- 修复插件安装时压缩包可能被恶意构造导致文件写入错误位置的问题
- 修复安装地址包含异常字符时可能引发意外行为的问题
- 修复验证码在不同操作间可能被混用的问题
- 修复高频点赞收藏时偶尔出现数量不准确的问题
- 修复长时间运行后内存占用可能持续增长的问题
- 修复管理员权限变更后需要较长时间才能生效的问题
- 修复云端暂时不可达时每次打开都反复请求的问题
- 修复视频播放拖动进度条偶尔报错的问题
- 修复给已注销用户发送私信不会提示的问题
- 更新技术文档，补充基础设施排查经验

### 2026-06-10
- 修复充值回调被恶意利用可能导致资金错乱的问题
- 修复同一笔充值在极端情况下可能被重复到账的问题
- 修复充值和冻结金额未拒绝无效数值的问题
- 修复任务详情页可能泄露其他申请者信息的问题
- 修复发布资源接口未验证登录状态的问题
- 修复后端报错时可能暴露内部细节给用户的问题
- 修复任务退款后状态记录可能不同步的问题
- 修复创作者卡片横幅图片地址可能导致样式异常的问题
- 修复资源校验请求长时间无响应时界面卡住的问题
- 修复充值成功后短暂显示旧余额的问题
- 修复弹窗关闭出错时可能导致界面遮罩层卡死的问题
- 修复通知内容中特殊字符可能导致显示异常的问题
- 修复编辑帖子时封面图标记判断出错的问题
- 补全多处界面文字的中英文翻译
- 更新技术文档，记录本轮排查的经验教训

### 2026-06-09
- 新增广告横幅系统公开API端点（无需认证，所有用户可访问）
- 新增顶部广告横幅组件（异步加载、本地缓存、详情页）
- 修复管理员保存广告配置后前端不生效的问题
- 修复广告禁用状态被缓存导致启用后延迟1小时生效
- 修复广告缓存降级逻辑中异常未被捕获的问题
- 优化 getPublicBannerConfig 支持 noCache 参数透传

### 2026-05-25
- 修复已购买用户重新安装时被余额不足弹窗拦截的问题
- 已购买用户安装时不再弹出付费确认框，直接开始安装
- 详情页正确显示已购买状态，不再误显示「立即获取」
- 切换账号后自动清除旧账号的安装记录，避免状态错乱

### 2026-05-22
- 修复个人设置中地区下拉列表无法切换的问题
- 修复隐私设置中粉丝列表和收藏列表的过滤判断错误
- 数据刷新间隔改为滑条样式，支持拖动调节和精确输入
- 全站统一使用用户设置的刷新间隔，不再各自固定30分钟
- 公测版上线，大量优化：修复安全漏洞、统一弹窗交互、规范配置管理...

### 2026-05-21
- "关于插件"页面全面双语化
- 消息清空按钮采用纯文本绕过翻译干扰
- 统一管理后台返回按钮位置
- 修复任务详情返回按钮渲染失败
- 修复申诉详情返回按钮缺少翻译

### 2026-05-20
- 钱包5个资金接口强制服务端身份认证
- 购买成功后自动为卖家生成销售收入记录
- 前后端双重校验充值上限10000、提现上限5000
- 前端充值按钮防重复点击
- 交易类型枚举值更新为14种
- 充值/提现/销售等文本双语补全

### 2026-05-19
- 私有仓库安装临时文件删除增加5次重试
- 后端ZIP下载新增15秒心跳保活
- 临时文件删除改为异步化避免阻塞
- 前端下载连接新增30秒超时检测
- 最终结果后超时缩短为5秒防卡住
- ZIP首包文件格式校验失败立即报错
- 新增损坏压缩包异常捕获与排查提示

### 2026-05-18
- 禁用私有仓库安装的凭证弹窗交互认证
- 编辑模式私有仓库复选框自动勾选
- 安装路由新增云端不可达时代理容错
- 修复GitHub非200响应导致服务端崩溃
- 修复预缓存登录令牌格式错误
- 修复未登录用户浏览量接口报错
- 新增手动触发ZIP缓存刷新功能

### 2026-05-09
- 新增定时预下载GitHub ZIP到数据集缓存
- 首次发布立即触发预缓存无需等待
- 工具更新自动失效旧缓存并刷新
- 修复价格延迟生效前端显示旧价
- 大文件下载失败自动重试3次
- 临时文件清理日志提示优化

### 2026-05-08
- 修复普通用户访问管理员接口被拒
- 发布界面新增返回确认防止误触清空
- 修复编辑模式私有仓库密钥显示异常
- 视频缓存接口访问控制与大小限制
- 视频边下边播新增内存积压控制
- 后台刷新补全代理图片处理
- 前端超时清理、分页取消等性能优化
- 搜索长度限制、评分容差等健壮性增强
- 提取公共函数、精确异常等代码改进

### 2026-04-26
- 修复讨论区视频播放器不显示
- 修复云端上传视频误走图片代理
- 修复视频代理链接构造错误
- 修复登录令牌过期后浏览接口无退避
- 修复视频流客户端断连导致崩溃
- 修复分页加载网络失败后卡死
- 修复标签页切换后缓存数据污染
- 修复防抖导致网络恢复后浏览量漏记
- 点赞收藏操作防重复提交保护
- 代理错误码细分超时/连接/状态码
- 创作者搜索失败时显示友好提示
- 分页加载器失败时显示手动加载按钮
- 离线模式视频相对路径保持不变

### 2026-04-25
- 多标签页登录状态新增本地缓存同步
- 登出时完善所有用户缓存清理
- 修复创作者排序切换后分页未重置
- 卡片载入动画从10个扩展至12个
- 缓存统计标题文案优化显示
- "关于插件"页面重设计为分区卡片
- 后端搜索支持单字匹配
- 视频代理升级为边下边播
- 视频上传大小限制提升至100MB

### 2026-04-23
- 新增视频本地缓存代理与分段传输
- 新增独立视频播放器支持全屏与快捷键
- 视频上传接口增加认证保护
- 视频缓存下载加锁防并发重复
- 修复全屏播放时内嵌播放器未暂停
- 修复视频帖子封面图不显示
- 修复语言切换后路由失同步叠加
- 修复帖子退出时视频事件未清理
- 新增讨论区视频发布功能

### 2026-04-22
- 修复发布界面图片拖拽排序
- 发布界面原创标记与退款双语补全
- 修复拖拽后封面未同步更新
- 修复拖拽图片误触发工作区加载

### 2026-04-21
- 新增五星评分系统含彩蛋第6星
- 新增评分最高排序选项
- 收藏图标统一替换为书签符号
- 创作者搜索支持单字匹配与离线降级
- 创作者数据新增本地缓存持久化

### 2026-04-14
- 新增个人资料收藏列表
- 新增销售统计模块
- 修复打赏余额不足误报
- 修复退款通知未翻译显示

### 2026-04-13
- 新增任务收益独立统计
- 修复退款逻辑财务安全问题
- 新增提现手续费审计追踪

### 2026-04-10
- 个人资料新增粉丝详情列表
- 优化关注列表展示效果
- 修复提现金额显示异常

### 2026-04-09
- 交易记录支持显示更多上下文
- 新增消息未读数轻量轮询
- 交易类型支持双语显示
- 修复注册接口头像处理异常
- 加强评论递归深度限制
- 修复ZIP解压路径穿越安全漏洞

### 2026-04-08
- 新增插件版本更新提醒
- 新增单资源详情查询接口
- 优化申诉仲裁中心缓存策略

### 2026-04-07
- 修复提现验证码缓存键冲突
- 优化后台静默刷新重渲染机制
- 增强查看他人资料容错处理
- 新增头像数据防篡改三层防护

### 2026-04-06
- 浏览量系统新增每日定时重置
- 优化浏览量缓存失效策略
- 统一前端操作防重复策略

### 2026-04-05
- 新增交易记录打赏统计
- 创作者详情补齐赞赏总榜
- 统一打赏等级规则说明

### 2026-04-04
- 补充数据库连接配置文档

### 2026-04-03
- 完善下载量计数机制文档

### 2026-04-02
- 新增下载量计数技术文档

### 2026-04-01
- 创作者界面全面双语适配
- 修复编辑保存后数据未刷新
- 修复网盘资源编辑回显异常
- 加固应用下载安全处理

### 2026-03-31
- 多Tab排序筛选搜索架构升级
- 各榜单支持专用排序框架
- 新增本地排序优先机制
- 统一前端搜索功能

### 2026-03-30
- 新增数据集批量同步机制
- 新增购买后悔退款功能
- 密码安全升级为加密算法
- 验证码安全机制升级
- 登录令牌安全机制升级

---

## 📦 安装方式

### 方式一：Git Clone（推荐）

```bash
# 进入 ComfyUI 插件目录
cd ComfyUI/custom_nodes

# 克隆仓库
git clone https://github.com/a63976659/ComfyUI-Ranking.git

# 重启 ComfyUI
```

### 方式二：手动安装（不推荐，无法更新版本）

1. 下载仓库 ZIP 文件
2. 解压到 `ComfyUI/custom_nodes/ComfyUI-Ranking`
3. 重启 ComfyUI

### ⚠️ 安装注意

- 安装失败时 `custom_nodes` 中可能存在空的 `ComfyUI-Ranking` 文件夹
- 删除该空文件夹后重新安装即可

---

## 🎮 使用指南

### 创作者

1. 安装插件并注册社区账号
2. 发布原创工具（可绑定私有库防盗）或工作流应用
3. 自由设置定价或免费开源
4. 将销售收益提现至支付宝

### 分享者

1. 安装插件并注册账号
2. 搬运推荐优质资源，或无偿分享好用的工作流
3. 积累粉丝与口碑
4. 获得粉丝打赏并提现

### 普通用户

1. 浏览多维度榜单（最新/下载量/收藏量）
2. 一键安装优质工具提升生产力
3. 导入适合自己的工作流
4. 通过真实评价和购买量避坑无效资源

---

## 🏗️ 技术架构

```
ComfyUI-Ranking/
├── 前端页面/
│   ├── auth/          # 用户认证组件
│   ├── components/    # 通用UI组件
│   ├── core/          # 核心引擎（状态管理、网络请求）
│   ├── market/        # 市场功能（发布、详情、钱包）
│   ├── profile/       # 个人中心
│   └── social/        # 社交功能（私信、评论、通知）
├── 云端Space代码/       # 后端 FastAPI 服务
├── api_app.py         # 本地 API 入口
├── api_cache.py       # 缓存管理
└── api_tool.py        # 工具函数
```

### 技术栈

- **前端**: 原生 JavaScript + CSS3 动画 + Web Audio API
- **后端**: Python FastAPI + SQLite/PostgreSQL
- **部署**: Hugging Face Spaces (Docker)

---

## 🎨 界面预览

---

## 📄 开源协议

本项目基于 [MIT License](LICENSE) 开源。

---

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

- 报告 Bug：请详细描述复现步骤
- 功能建议：请说明使用场景和期望效果
- 代码贡献：请遵循现有代码风格

---

## 📞 联系我们

如有问题或建议，欢迎通过以下方式联系：

- GitHub Issues: [提交问题](https://github.com/a63976659/ComfyUI-Ranking/issues)
- 社区私信：注册后可直接私信管理员

**让我们一起建设更好的 ComfyUI 生态！** 🚀

ComfyUI-Ranking

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README