AstroProject 晚星计划

四包 monorepo — 筑穹 · 摘星 · 织霞 · 天枢

中文

AstroProject 晚星计划 — 四包 monorepo。乐高式架构，每包可独立 pip install，自由组合。

包拓扑

                    astrobasis 天枢 (纯机制层，Python 3.12 stdlib only)
                   ╱    │    ╲
    astroframe 筑穹   astrocrawl 摘星   astroweave 织霞
     (插件平台运行时)   (爬虫引擎)       (工作流编排)

pip 依赖:   astroframe → astrobasis,  astrocrawl → astrobasis,  astroweave → astrobasis
entry_point: astrocrawl → astroframe.plugins,  astroweave → astroframe.plugins

核心三包

组件包

组件包以北斗七星命名，天枢为首。

快速开始

git clone https://github.com/Etoileint/AstroProject.git
cd AstroProject

python -m venv .venv
source .venv/bin/activate

# 安装全部包（compat 模式 — monorepo 双嵌套布局必需）
pip install --config-settings editable_mode=compat -e astrobasis/ -e astroframe/ -e astrocrawl/

# 或按需安装
pip install --config-settings editable_mode=compat -e astrobasis/ -e astrocrawl/

playwright install chromium
astrocrawl https://example.com -d 2

项目结构

AstroProject/
├── astrobasis/astrobasis/       # 天枢 — 纯机制：_logging _atomic _json_compat _types
├── astroframe/astroframe/     # 筑穹 — 插件平台：_registry _lifecycle _scanner _sandbox _host _signature
├── astrocrawl/astrocrawl/     # 摘星 — 爬虫引擎：crawler/ browser/ network/ storage/ rules/ ai/ gui/ cli/ proxy/
├── astroweave/astroweave/       # 织霞 — 工作流引擎（规划中）
├── docs/                      # ADR、开发者指南、领域文档
├── scripts/                   # 代码生成、CI 校验脚本
└── pyproject.toml             # 根配置

English

AstroProject 晚星计划 — a four-package monorepo. LEGO-style architecture: each package independently pip install-able, freely composable.

Package Topology

                    astrobasis (pure mechanism layer, Python 3.12 stdlib only)
                   ╱    │    ╲
          astroframe  astrocrawl  astroweave
         (platform)   (crawler)   (workflow)

pip dependency: astroframe → astrobasis,  astrocrawl → astrobasis,  astroweave → astrobasis
entry_point:    astrocrawl → astroframe.plugins,  astroweave → astroframe.plugins

Core Packages

Component Package

Component packages are named after the Big Dipper, starting with 天枢 (Dubhe).

Quick Start

git clone https://github.com/Etoileint/AstroProject.git
cd AstroProject

python -m venv .venv
source .venv/bin/activate

pip install --config-settings editable_mode=compat -e astrobasis/ -e astroframe/ -e astrocrawl/

playwright install chromium
astrocrawl https://example.com -d 2

Project Structure

AstroProject/
├── astrobasis/astrobasis/       # 天枢 — pure mechanism: _logging _atomic _json_compat _types
├── astroframe/astroframe/     # 筑穹 — plugin platform: _registry _lifecycle _scanner _sandbox _host _signature
├── astrocrawl/astrocrawl/     # 摘星 — crawler engine: crawler/ browser/ network/ storage/ rules/ ai/ gui/ cli/ proxy/
├── astroweave/astroweave/       # 织霞 — workflow engine (planning)
├── docs/                      # ADRs, developer guides, domain docs
├── scripts/                   # Code generation, CI check scripts
└── pyproject.toml             # Root config