# funresource

**Repository Path**: farfarfun/funresource

## Basic Information

- **Project Name**: funresource
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-31
- **Last Updated**: 2026-10-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# funresource

网盘资源采集与管理工具：从多个来源（Acoooder、RSS 订阅、Telegram 频道）抓取网盘分享链接（阿里云盘、夸克网盘等），自动打标签（电视剧/电影/纪录片/小说等）后存入数据库，供后续检索使用。

## 安装

```bash
pip install funresource
```

## 命令行用法

运行采集前需要能访问 GitHub（Acoooder）、RSSHub 和 Telegram 的公开页面；网络受限、
目标站点不可用或频道内容变化时，采集会失败。`funresource run` 会在当前目录创建默认
SQLite 数据库 `./funresource/resource.db`，并在采集 Acoooder 时创建
`./funresource/tmp` 临时目录；临时目录会在该采集器完成后删除，数据库会保留。

```bash
funresource run
```

会依次运行内置的采集器（`AcoooderGenerate`、`RSSGenerate`、`TelegramChannelGenerate`），把抓到的资源 upsert 进数据库。

## 作为库使用

```python
from funresource.db.base import ResourceManage

manage = ResourceManage()  # 默认使用本地 sqlite，可通过 funsecret 配置 "funresource"/"engine"/"uri" 指向 MySQL 等
results = manage.find("庆余年")  # 按名称正则检索已入库的资源
```

自定义采集来源可以继承 `funresource.generator.base.BaseGenerate`，实现 `generate()` 返回 `Resource` 迭代器，再交给 `ResourceManage.add_resources()` 写库。

## 数据存储

默认使用 SQLite（`./funresource/resource.db`），可通过 [funsecret](https://github.com/farfarfun/funsecret) 配置 `funresource.engine.uri` 切换为 MySQL 等数据库。

## 开发与验证

项目要求 Python 3.10 或更高版本。使用 uv 安装开发依赖并执行检查：

```bash
uv sync --group dev
uv run ruff check .
uv run ruff format --check .
uv run pytest
uv build
```

---

## 关于 farfarfun

[farfarfun](https://github.com/farfarfun) 是一个专注于实用工具库的开源组织，
涵盖云存储、数据处理、AI、多媒体与开发工具链等方向。

- 🏠 组织主页：<https://github.com/farfarfun>
- 📦 PyPI：<https://pypi.org/user/niuliangtao/>
- 📧 联系：farfarfun@qq.com

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