blues-lib

Python library writed by Blues Liu.

blues-lib | 版本：1.19.3

简介

blues-lib 是一个以 Web 自动化 为核心的 Python 库，提供浏览器操作（Selenium/WebDriver）、LLM 调用、数据预处理（DPP）、文件/数据库/消息等能力，并以 MCP 风格工具（ww_*）统一封装，通过 ww CLI 或 AbilityClient 执行自动化任务。

安装

pip install blues-lib

本地开发（推荐 uv）：

uv sync

CLI

安装后提供 ww 与 webwork 两个全局命令：

ww -v                                  # 查看版本
ww help                                # 查看可用命令
ww run -m <meta_path> [-b <bizdata_path>]   # 执行 meta/task/flow
ww dash <bizdata_path>                 # 快速执行（读取/填充模式）
ww tool list                           # 列出所有 ww_* 工具及 schema
ww config / mysql / sqlite / ftp / ssh / webdriver / email / ding / llm ...

详见 readme-cli.md。

示例

from blues_lib.tools.runner import AbilityClient

# 执行一个 ww_* 工具
result = AbilityClient.run({
    "name": "ww_time",
    "options": {"action": "sleep", "value": 0.5, "id": "t1"},
})

# 执行任务 / 流程（meta 内 name 为 ww_task / ww_flow 自动分发）
AbilityClient.run("tests/template/write/base/fillin-article.json5")

目录结构

src/blues_lib/
├── cli/                # ww / webwork CLI（run/dash/config/... 16 个命令）
├── services/
│   ├── dpp/            # 数据预处理职责链（Read/Write/Persist）
│   ├── schema/         # 工具 schema（ToolSchema，基于 pydantic）
│   ├── webdriver/      # WebDriver 工厂与 CFT 自动下载
│   └── llm/            # LLM 客户端
├── tools/
│   ├── runner/         # AbilityClient / MetaLoader / Facade
│   └── ability/        # ww_* 工具定义（atom/sequence/task）
└── types/schemas/      # 工具入参 pydantic 模型（TOOL_ADAPTERS）

测试

uv run pytest                 # 全部测试
uv run pytest tests/tools/    # 指定目录
uv run pytest --cov=src/blues_lib --cov-report=term-missing   # 覆盖率

Metadata

Release files for blues-lib 1.20.14

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for blues-lib 1.20.14
File	Size	Uploaded
blues_lib-1.20.14.tar.gz	1.0 MB	Aug 27, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for blues-lib 1.20.14
File	Interpreter	ABI	Platform	Reset
blues_lib-1.20.14-py3-none-any.whl 1.3 MB Aug 27, 2026	Python 3	none	any	Details

Total release size: 2.4 MB

Release files / blues_lib-1.20.14.tar.gz

Download URL	blues_lib-1.20.14.tar.gz
Size	1.0 MB
Tags	Source
SHA-256 checksum How to use checksums	`3d03e6579f1a35a2b4de58d222b78065ac23c75c8bfcf69daa75d8676c732843`
BLAKE2b-256 checksum How to use checksums	`cf1e87880efaadb54a23b3d0f5b41d2519bf0a18616180442b57b134ea3a8e9d`
Upload date	Aug 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / blues_lib-1.20.14-py3-none-any.whl

Download URL	blues_lib-1.20.14-py3-none-any.whl
Size	1.3 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`66b3d2abb9d2f4112a364d06075e6fd0cacd914b7a97c50f9df48ee2627b41cb`
BLAKE2b-256 checksum How to use checksums	`ba5241325c9a87b95c95e3734f2ac694d52b7fa5ac98f5b8a708460ffda52a57`
Upload date	Aug 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`