bricks-py 0.1.4__tar.gz → 0.2.0__tar.gz

bricks_py-0.2.0/.gitignore

@@ -0,0 +1,14 @@
+venv
+/.svn
+/.idea
+__pycache__
+/logs
+/Files
+/test
+/venv
+/no_views
+.vscode/launch.json
+.gitignore
+.python-version
+.gitignore
+uv.lock

bricks_py-0.2.0/PKG-INFO

@@ -0,0 +1,257 @@
+Metadata-Version: 2.4
+Name: bricks-py
+Version: 0.2.0
+Summary: quickly build your crawler
+Project-URL: Homepage, https://github.com/KKKKKKKEM/bricks
+Project-URL: Repository, https://github.com/KKKKKKKEM/bricks.git
+Project-URL: Documentation, https://kkkkkkkem.vercel.app/bricks
+Project-URL: Bug Tracker, https://github.com/KKKKKKKEM/bricks/issues
+Author-email: Kem <531144129@qq.com>
+License: MIT
+License-File: LICENSE
+Keywords: bricks,crawler,scraper,spider
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: better-exceptions==0.3.3
+Requires-Dist: curl-cffi==0.15.0
+Requires-Dist: jmespath-community==1.1.3
+Requires-Dist: jsonpath==0.82.2
+Requires-Dist: loguru==0.7.3
+Requires-Dist: lxml==5.3.1
+Requires-Dist: redis==5.2.1
+Requires-Dist: w3lib==2.3.1
+Provides-Extra: httpx
+Requires-Dist: httpx>=0.24.0; extra == 'httpx'
+Provides-Extra: playwright
+Requires-Dist: playwright>=1.40.0; extra == 'playwright'
+Provides-Extra: requests
+Requires-Dist: requests>=2.28.0; extra == 'requests'
+Description-Content-Type: text/markdown
+
+[license]: /LICENSE
+[license-badge]: https://img.shields.io/github/license/KKKKKKKEM/bricks?style=flat-square
+[prs]: https://github.com/KKKKKKKEM/bricks
+[prs-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square
+[issues]: https://github.com/KKKKKKKEM/bricks/issues/new
+[issues-badge]: https://img.shields.io/badge/Issues-welcome-brightgreen.svg?style=flat-square
+[release]: https://github.com/KKKKKKKEM/bricks/releases/latest
+[release-badge]: https://img.shields.io/github/v/release/KKKKKKKEM/bricks?style=flat-square
+[pypi]: https://pypi.org/project/bricks-py/
+[pypi-badge]: https://img.shields.io/pypi/v/bricks-py?style=flat-square
+[python-badge]: https://img.shields.io/pypi/pyversions/bricks-py?style=flat-square
+
+<div align="center">
+
+# 🧱 Bricks
+
+**像搭积木一样构建爬虫**
+
+[![license][license-badge]][license]
+[![release][release-badge]][release]
+[![prs][prs-badge]][prs]
+[![issues][issues-badge]][issues]
+![python][python-badge]
+
+</div>
+
+---
+
+## 简介
+
+`Bricks` 是一个模块化、事件驱动的 Python 爬虫框架，旨在将爬虫开发变得像搭建积木一样简单而有趣。框架提供了从 **纯代码式** 到 **零代码配置式** 的多层次开发体验，让新手快速上手，让专家灵活掌控。
+
+无论是简单的单页抓取、多步骤链式请求，还是分布式大规模爬取，`Bricks` 都能以一致的编程模型优雅地处理。
+
+---
+
+## ✨ 核心特性
+
+| 特性 | 说明 |
+|---|---|
+| **事件驱动架构** | 在请求前后、存储前后等生命周期节点注册事件钩子，无需修改核心逻辑即可扩展行为 |
+| **三种爬虫基类** | `air`（纯代码）、`form`（自定义流程配置）、`template`（固定流程配置），按复杂度选择 |
+| **丰富的解析器** | 内置 `json` / `xpath` / `jsonpath` / `regex` 解析，声明规则即可完成数据提取 |
+| **多种下载器** | 默认使用 `curl-cffi`，可选 `requests` / `httpx` / `playwright` / `pycurl` 等，支持自定义 |
+| **弹性调度器** | 可伸缩线程池，同步/异步任务统一调度，自动根据任务量调节 Worker 数量 |
+| **多种任务队列** | 内置 `Local`（单机）和 `Redis`（分布式）队列，接口统一，支持自定义扩展 |
+| **爬虫 API 化** | 内置 `rpc` 模式，一键将爬虫转化为可远程调用的 API |
+| **代理管理** | 内置 `ApiProxy` / `RedisProxy` / `ClashProxy` 等代理管理器，支持自动轮换、阈值回收 |
+
+---
+
+## 🚀 快速开始
+
+### 安装
+
+```bash
+# 安装正式版
+pip install -U bricks-py
+
+# 安装最新开发版
+pip install -U git+https://github.com/KKKKKKKEM/bricks.git
+
+# 安装测试版（beta）
+pip install -i https://test.pypi.org/simple/ -U bricks-py
+```
+
+可选下载器依赖：
+
+```bash
+pip install bricks-py[requests]    # requests 下载器
+pip install bricks-py[httpx]       # httpx 下载器
+pip install bricks-py[playwright]  # playwright 下载器
+```
+
+### 最简示例（air 爬虫）
+
+```python
+from bricks import Request, const
+from bricks.core import events, signals
+from bricks.spider import air
+from bricks.spider.air import Context
+
+
+class MySpider(air.Spider):
+
+    def make_seeds(self, context: Context, **kwargs):
+        # 返回要爬取的种子列表
+        return [{"page": 1}, {"page": 2}, {"page": 3}]
+
+    def make_request(self, context: Context) -> Request:
+        seeds = context.seeds
+        return Request(
+            url="https://api.example.com/list",
+            params={"page": seeds["page"]},
+        )
+
+    def parse(self, context: Context):
+        return context.response.extract(
+            engine="json",
+            rules={"data.list": {"id": "id", "name": "name"}},
+        )
+
+    def item_pipeline(self, context: Context):
+        print(context.items)
+        context.success()  # 标记种子处理完成
+
+    @staticmethod
+    @events.on(const.AFTER_REQUEST)
+    def check_response(context: Context):
+        if context.response.get("code") != 0:
+            raise signals.Retry  # 触发重试
+
+
+if __name__ == "__main__":
+    spider = MySpider()
+    spider.run()
+```
+
+### 配置式示例（form 爬虫）
+
+```python
+from bricks.spider import form
+
+
+class MySpider(form.Spider):
+
+    @property
+    def config(self) -> form.Config:
+        return form.Config(
+            init=[form.Init(func=lambda: {"page": 1})],
+            spider=[
+                form.Download(
+                    url="https://api.example.com/list",
+                    params={"page": "{page}"},
+                ),
+                form.Parse(
+                    func="json",
+                    kwargs={"rules": {"data.list": {"id": "id", "name": "name"}}},
+                ),
+                form.Pipeline(
+                    func=lambda context: print(context.items),
+                    success=True,
+                ),
+            ],
+        )
+
+
+if __name__ == "__main__":
+    MySpider().run()
+```
+
+---
+
+## 📖 文档
+
+| 文档 | 描述 |
+|---|---|
+| [快速入门](docs/quickstart.md) | 5 分钟了解 Bricks 的核心概念和使用方式 |
+| [爬虫基类](docs/spiders.md) | `air` / `form` / `template` 三种爬虫的详细说明 |
+| [事件系统](docs/events.md) | 生命周期钩子、事件注册与触发机制 |
+| [解析器](docs/parsers.md) | JSON / XPath / JSONPath / Regex 解析规则详解 |
+| [下载器](docs/downloaders.md) | 各类下载器的使用与自定义扩展 |
+| [任务队列](docs/queues.md) | Local / Redis 队列与分布式爬虫 |
+| [代理管理](docs/proxies.md) | 代理池配置与自动轮换策略 |
+| [信号机制](docs/signals.md) | Retry / Success / Failure 等控制信号 |
+| [RPC 模式](docs/rpc.md) | 将爬虫暴露为远程 API |
+| [存储插件](docs/storage.md) | 内置 SQLite / MongoDB / Redis / CSV 存储 |
+
+> 完整在线文档：[https://kkkkkkkem.vercel.app/bricks](https://kkkkkkkem.vercel.app/bricks)
+
+---
+
+## 🏗️ 架构概览
+
+```
+bricks/
+├── spider/          # 爬虫基类
+│   ├── air.py       #   纯代码式爬虫
+│   ├── form.py      #   自定义流程配置式爬虫
+│   └── template.py  #   固定流程配置式爬虫
+├── core/            # 核心机制
+│   ├── context.py   #   上下文 / 流程控制
+│   ├── events.py    #   事件管理器
+│   ├── genesis.py   #   基础类 Chaos / Pangu
+│   ├── dispatch.py  #   调度器
+│   └── signals.py   #   控制信号
+├── downloader/      # 下载器
+├── lib/             # 基础库（Request / Response / Queue / Proxy 等）
+├── plugins/         # 内置插件（storage / scripts 等）
+└── rpc/             # RPC 模式
+```
+
+**爬虫生命周期**：
+
+```
+make_seeds → [BEFORE_PUT_SEEDS] → put_seeds → [AFTER_PUT_SEEDS]
+                                                      ↓
+[BEFORE_GET_SEEDS] → get_seeds → [AFTER_GET_SEEDS]
+                                        ↓
+                               [BEFORE_MAKE_REQUEST] → make_request → [AFTER_MAKE_REQUEST]
+                                                                              ↓
+                                                               [BEFORE_REQUEST] → on_request → [AFTER_REQUEST]
+                                                                                                      ↓
+                                                                                              on_response (parse)
+                                                                                                      ↓
+                                                                                   [BEFORE_PIPELINE] → on_pipeline → [AFTER_PIPELINE]
+```
+
+---
+
+## 🤝 贡献
+
+欢迎提交 [Issue][issues] 和 [Pull Request][prs]。
+
+---
+
+## 📄 License
+
+[MIT](LICENSE) © Kem

bricks_py-0.2.0/README.md

@@ -0,0 +1,219 @@
+[license]: /LICENSE
+[license-badge]: https://img.shields.io/github/license/KKKKKKKEM/bricks?style=flat-square
+[prs]: https://github.com/KKKKKKKEM/bricks
+[prs-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square
+[issues]: https://github.com/KKKKKKKEM/bricks/issues/new
+[issues-badge]: https://img.shields.io/badge/Issues-welcome-brightgreen.svg?style=flat-square
+[release]: https://github.com/KKKKKKKEM/bricks/releases/latest
+[release-badge]: https://img.shields.io/github/v/release/KKKKKKKEM/bricks?style=flat-square
+[pypi]: https://pypi.org/project/bricks-py/
+[pypi-badge]: https://img.shields.io/pypi/v/bricks-py?style=flat-square
+[python-badge]: https://img.shields.io/pypi/pyversions/bricks-py?style=flat-square
+
+<div align="center">
+
+# 🧱 Bricks
+
+**像搭积木一样构建爬虫**
+
+[![license][license-badge]][license]
+[![release][release-badge]][release]
+[![prs][prs-badge]][prs]
+[![issues][issues-badge]][issues]
+![python][python-badge]
+
+</div>
+
+---
+
+## 简介
+
+`Bricks` 是一个模块化、事件驱动的 Python 爬虫框架，旨在将爬虫开发变得像搭建积木一样简单而有趣。框架提供了从 **纯代码式** 到 **零代码配置式** 的多层次开发体验，让新手快速上手，让专家灵活掌控。
+
+无论是简单的单页抓取、多步骤链式请求，还是分布式大规模爬取，`Bricks` 都能以一致的编程模型优雅地处理。
+
+---
+
+## ✨ 核心特性
+
+| 特性 | 说明 |
+|---|---|
+| **事件驱动架构** | 在请求前后、存储前后等生命周期节点注册事件钩子，无需修改核心逻辑即可扩展行为 |
+| **三种爬虫基类** | `air`（纯代码）、`form`（自定义流程配置）、`template`（固定流程配置），按复杂度选择 |
+| **丰富的解析器** | 内置 `json` / `xpath` / `jsonpath` / `regex` 解析，声明规则即可完成数据提取 |
+| **多种下载器** | 默认使用 `curl-cffi`，可选 `requests` / `httpx` / `playwright` / `pycurl` 等，支持自定义 |
+| **弹性调度器** | 可伸缩线程池，同步/异步任务统一调度，自动根据任务量调节 Worker 数量 |
+| **多种任务队列** | 内置 `Local`（单机）和 `Redis`（分布式）队列，接口统一，支持自定义扩展 |
+| **爬虫 API 化** | 内置 `rpc` 模式，一键将爬虫转化为可远程调用的 API |
+| **代理管理** | 内置 `ApiProxy` / `RedisProxy` / `ClashProxy` 等代理管理器，支持自动轮换、阈值回收 |
+
+---
+
+## 🚀 快速开始
+
+### 安装
+
+```bash
+# 安装正式版
+pip install -U bricks-py
+
+# 安装最新开发版
+pip install -U git+https://github.com/KKKKKKKEM/bricks.git
+
+# 安装测试版（beta）
+pip install -i https://test.pypi.org/simple/ -U bricks-py
+```
+
+可选下载器依赖：
+
+```bash
+pip install bricks-py[requests]    # requests 下载器
+pip install bricks-py[httpx]       # httpx 下载器
+pip install bricks-py[playwright]  # playwright 下载器
+```
+
+### 最简示例（air 爬虫）
+
+```python
+from bricks import Request, const
+from bricks.core import events, signals
+from bricks.spider import air
+from bricks.spider.air import Context
+
+
+class MySpider(air.Spider):
+
+    def make_seeds(self, context: Context, **kwargs):
+        # 返回要爬取的种子列表
+        return [{"page": 1}, {"page": 2}, {"page": 3}]
+
+    def make_request(self, context: Context) -> Request:
+        seeds = context.seeds
+        return Request(
+            url="https://api.example.com/list",
+            params={"page": seeds["page"]},
+        )
+
+    def parse(self, context: Context):
+        return context.response.extract(
+            engine="json",
+            rules={"data.list": {"id": "id", "name": "name"}},
+        )
+
+    def item_pipeline(self, context: Context):
+        print(context.items)
+        context.success()  # 标记种子处理完成
+
+    @staticmethod
+    @events.on(const.AFTER_REQUEST)
+    def check_response(context: Context):
+        if context.response.get("code") != 0:
+            raise signals.Retry  # 触发重试
+
+
+if __name__ == "__main__":
+    spider = MySpider()
+    spider.run()
+```
+
+### 配置式示例（form 爬虫）
+
+```python
+from bricks.spider import form
+
+
+class MySpider(form.Spider):
+
+    @property
+    def config(self) -> form.Config:
+        return form.Config(
+            init=[form.Init(func=lambda: {"page": 1})],
+            spider=[
+                form.Download(
+                    url="https://api.example.com/list",
+                    params={"page": "{page}"},
+                ),
+                form.Parse(
+                    func="json",
+                    kwargs={"rules": {"data.list": {"id": "id", "name": "name"}}},
+                ),
+                form.Pipeline(
+                    func=lambda context: print(context.items),
+                    success=True,
+                ),
+            ],
+        )
+
+
+if __name__ == "__main__":
+    MySpider().run()
+```
+
+---
+
+## 📖 文档
+
+| 文档 | 描述 |
+|---|---|
+| [快速入门](docs/quickstart.md) | 5 分钟了解 Bricks 的核心概念和使用方式 |
+| [爬虫基类](docs/spiders.md) | `air` / `form` / `template` 三种爬虫的详细说明 |
+| [事件系统](docs/events.md) | 生命周期钩子、事件注册与触发机制 |
+| [解析器](docs/parsers.md) | JSON / XPath / JSONPath / Regex 解析规则详解 |
+| [下载器](docs/downloaders.md) | 各类下载器的使用与自定义扩展 |
+| [任务队列](docs/queues.md) | Local / Redis 队列与分布式爬虫 |
+| [代理管理](docs/proxies.md) | 代理池配置与自动轮换策略 |
+| [信号机制](docs/signals.md) | Retry / Success / Failure 等控制信号 |
+| [RPC 模式](docs/rpc.md) | 将爬虫暴露为远程 API |
+| [存储插件](docs/storage.md) | 内置 SQLite / MongoDB / Redis / CSV 存储 |
+
+> 完整在线文档：[https://kkkkkkkem.vercel.app/bricks](https://kkkkkkkem.vercel.app/bricks)
+
+---
+
+## 🏗️ 架构概览
+
+```
+bricks/
+├── spider/          # 爬虫基类
+│   ├── air.py       #   纯代码式爬虫
+│   ├── form.py      #   自定义流程配置式爬虫
+│   └── template.py  #   固定流程配置式爬虫
+├── core/            # 核心机制
+│   ├── context.py   #   上下文 / 流程控制
+│   ├── events.py    #   事件管理器
+│   ├── genesis.py   #   基础类 Chaos / Pangu
+│   ├── dispatch.py  #   调度器
+│   └── signals.py   #   控制信号
+├── downloader/      # 下载器
+├── lib/             # 基础库（Request / Response / Queue / Proxy 等）
+├── plugins/         # 内置插件（storage / scripts 等）
+└── rpc/             # RPC 模式
+```
+
+**爬虫生命周期**：
+
+```
+make_seeds → [BEFORE_PUT_SEEDS] → put_seeds → [AFTER_PUT_SEEDS]
+                                                      ↓
+[BEFORE_GET_SEEDS] → get_seeds → [AFTER_GET_SEEDS]
+                                        ↓
+                               [BEFORE_MAKE_REQUEST] → make_request → [AFTER_MAKE_REQUEST]
+                                                                              ↓
+                                                               [BEFORE_REQUEST] → on_request → [AFTER_REQUEST]
+                                                                                                      ↓
+                                                                                              on_response (parse)
+                                                                                                      ↓
+                                                                                   [BEFORE_PIPELINE] → on_pipeline → [AFTER_PIPELINE]
+```
+
+---
+
+## 🤝 贡献
+
+欢迎提交 [Issue][issues] 和 [Pull Request][prs]。
+
+---
+
+## 📄 License
+
+[MIT](LICENSE) © Kem

bricks_py-0.2.0/bricks/__main__.py

@@ -0,0 +1,4 @@
+from bricks.client.cli import main
+
+if __name__ == "__main__":
+    main()

bricks_py-0.2.0/bricks/client/cli.py

@@ -0,0 +1,199 @@
+# -*- coding: utf-8 -*-
+# @Desc    : CLI 入口
+import argparse
+import inspect
+import os
+import sys
+
+from loguru import logger
+
+
+def _find_spider_class(module):
+    """从模块中查找 Spider 子类"""
+    from bricks.spider import air
+
+    candidates = []
+    for name in dir(module):
+        obj = getattr(module, name)
+        if (
+            isinstance(obj, type)
+            and issubclass(obj, air.Spider)
+            and obj is not air.Spider
+            and obj.__module__ == module.__name__
+        ):
+            candidates.append(obj)
+
+    if not candidates:
+        return None
+
+    if len(candidates) == 1:
+        return candidates[0]
+
+    # 多个候选时按源代码行号排序取第一个
+    candidates.sort(key=lambda c: inspect.getsourcelines(c)[1])
+    return candidates[0]
+
+
+def _load_spider(filepath, concurrency=None):
+    """加载爬虫文件并返回实例化的 Spider"""
+    from bricks.utils import pandora
+
+    module = pandora.load_objects(filepath)
+    cls = _find_spider_class(module)
+    if cls is None:
+        logger.error(f"未在 {filepath} 中找到 Spider 子类")
+        sys.exit(1)
+
+    kwargs = {}
+    if concurrency is not None:
+        kwargs["concurrency"] = concurrency
+
+    return cls(**kwargs)
+
+
+def cmd_new(args):
+    """生成爬虫文件"""
+    name = args.name
+    form = args.type
+    output = args.output or f"./{name}.py"
+    curl = args.curl
+
+    if curl:
+        from bricks.utils.convert import curl2spider
+        curl2spider(curl=curl, path=output, name=name, form=form)
+    else:
+        tpl_path = os.path.join(
+            os.path.dirname(os.path.dirname(__file__)), "tpls", "spider", form + ".tpl"
+        )
+        if not os.path.exists(tpl_path):
+            logger.error(f"模板文件不存在: {tpl_path}")
+            sys.exit(1)
+
+        with open(tpl_path) as f:
+            tpl = f.read()
+
+        content = tpl.format(
+            **{
+                "SPIDER": name,
+                "URL": "https://example.com",
+                "METHOD": "GET",
+                "PARAMS": None,
+                "BODY": None,
+                "HEADERS": None,
+                "COOKIES": None,
+                "OPTIONS": None,
+                "ALLOW_REDIRECTS": True,
+                "PROXIES": None,
+                "PROXY": None,
+                "MAX_RETRY": 5,
+                "USE_SESSION": False,
+            }
+        )
+
+        target_dir = os.path.dirname(output)
+        if target_dir and not os.path.exists(target_dir):
+            os.makedirs(target_dir, exist_ok=True)
+
+        with open(output, "w") as f:
+            f.write(content)
+
+        logger.debug(f"生成成功, 路径为: {output}")
+
+
+def cmd_run(args):
+    """运行爬虫"""
+    spider = _load_spider(args.file, concurrency=args.concurrency)
+    spider.run(task_name=args.task)
+
+
+def cmd_serve(args):
+    """启动 RPC 服务"""
+    from bricks.client.runner import RpcProxy
+
+    spider = _load_spider(args.file, concurrency=args.concurrency)
+    proxy = RpcProxy(spider.run)
+    proxy.bind(spider)
+    proxy.register_adapter("get_stats", lambda: {
+        "number_of_total_requests": spider.number_of_total_requests.value,
+        "number_of_failure_requests": spider.number_of_failure_requests.value,
+        "number_of_new_seeds": spider.number_of_new_seeds.value,
+        "number_of_seeds_obtained": spider.number_of_seeds_obtained.value,
+        "number_of_seeds_pending": spider.number_of_seeds_pending,
+    })
+    proxy.start(mode=args.mode, ident=args.port)
+
+
+def cmd_status(args):
+    """查询 RPC 服务状态"""
+    from bricks.rpc.http_.service import Client
+
+    endpoint = f"{args.host}:{args.port}"
+    client = Client(endpoint)
+
+    try:
+        resp = client.rpc("PING")
+        print(f"连接成功: {endpoint}")
+        print(f"PING -> {resp.data}")
+    except Exception as e:
+        logger.error(f"无法连接到 {endpoint}: {e}")
+        sys.exit(1)
+
+    try:
+        resp = client.rpc("get_stats")
+        stats = resp.data
+        if isinstance(stats, dict):
+            print("\n--- 运行统计 ---")
+            for key, value in stats.items():
+                print(f"  {key}: {value}")
+        else:
+            print(f"统计数据: {stats}")
+    except Exception as e:
+        logger.warning(f"获取统计数据失败: {e}")
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="bricks",
+        description="Bricks 爬虫框架 CLI",
+    )
+    subparsers = parser.add_subparsers(dest="command")
+
+    # bricks new
+    p_new = subparsers.add_parser("new", help="生成爬虫模板文件")
+    p_new.add_argument("name", help="爬虫类名")
+    p_new.add_argument("-t", "--type", default="air", choices=["air", "form", "template"], help="模板类型 (默认: air)")
+    p_new.add_argument("--curl", help="curl 命令字符串，自动填充请求配置")
+    p_new.add_argument("-o", "--output", help="输出路径 (默认: ./<name>.py)")
+
+    # bricks run
+    p_run = subparsers.add_parser("run", help="运行爬虫")
+    p_run.add_argument("file", help="爬虫 Python 文件路径")
+    p_run.add_argument("-c", "--concurrency", type=int, help="并发数")
+    p_run.add_argument("--task", default="all", help="任务名 (默认: all)")
+
+    # bricks serve
+    p_serve = subparsers.add_parser("serve", help="启动 RPC 服务")
+    p_serve.add_argument("file", help="爬虫文件路径")
+    p_serve.add_argument("-m", "--mode", default="http", choices=["http", "websocket", "socket", "grpc", "redis"], help="RPC 模式 (默认: http)")
+    p_serve.add_argument("-p", "--port", type=int, default=8080, help="端口 (默认: 8080)")
+    p_serve.add_argument("-c", "--concurrency", type=int, help="并发数")
+
+    # bricks status
+    p_status = subparsers.add_parser("status", help="查询 RPC 服务状态")
+    p_status.add_argument("--host", default="localhost", help="主机 (默认: localhost)")
+    p_status.add_argument("-p", "--port", type=int, default=8080, help="端口 (默认: 8080)")
+
+    args = parser.parse_args()
+
+    handlers = {
+        "new": cmd_new,
+        "run": cmd_run,
+        "serve": cmd_serve,
+        "status": cmd_status,
+    }
+
+    handler = handlers.get(args.command)
+    if handler:
+        handler(args)
+    else:
+        parser.print_help()