🔧 libs/common：通用模块

libs/common/ 放的是项目内部可复用的“胶水代码”：小而稳、低耦合、可替换。这里的目标不是堆功能，而是为仓库提供少量可靠的基础能力。

目录结构

libs/common/
├── README.md
├── __init__.py
├── models/                 # 预留：数据模型（当前仅占位）
│   └── __init__.py
└── utils/
    └── backups/            # 基于 .gitignore 的快速备份工具
        ├── README.md
        ├── 快速备份.py
        └── 一键备份.sh

现有内容

utils/backups/：快速备份工具（当前与仓库根目录 backups/ 内容一致，用于避免脚本散落各处）

约束与约定

不放业务逻辑：common/ 只提供基础能力与工具
接口要稳：一旦被引用，就把它当作公开 API 对待
可审计输出：脚本/工具的输出要可复盘（明确输入、输出路径、失败原因）
新增即文档：新增模块/目录必须同步更新本 README 与 libs/README.md

使用方式（当前推荐）

本目录的内容目前主要以“脚本/工具”形式存在，推荐直接运行：

# 备份当前仓库（建议优先使用根目录 backups/ 入口）
python3 backups/快速备份.py

更多参数与说明见：../../backups/README.md。