feat,fix(core,docs): 完善核心模块代码注释并添加架构改进文档

- 为 core 目录下主要模块 (models, context, creator, base_api, exchange, executor) 添加了详细的类和方法 Docstring。
   - 新增 docs/架构改进.md 文件。
This commit is contained in:
2026-03-18 11:26:55 +08:00
parent d05757f7cc
commit 6393414ab2
9 changed files with 226 additions and 4 deletions

View File

@@ -6,7 +6,17 @@ from core.session import Session
from core import settings
class BaseApi:
"""
所有 API 类的基类。
提供基础的 Session 管理和日志记录功能,供具体的业务 API 类继承。
"""
def __init__(self, session: Session = None):
"""
初始化 BaseApi。
Args:
session: HTTP 会话对象。如果未提供,将使用默认配置创建一个新的 Session。
"""
self.session = session or Session(base_url=settings.base_url)
self.logger = logging.getLogger(self.__class__.__name__)