Kris
102b98adea
本次提交将woc-bridge项目重构为模块化包结构，按职责拆分多个子域： 1. 新增models层定义所有Pydantic数据模型与统一错误体系 2. 拆分db/ui/messaging/routes等业务域模块 3. 实现基础API路由：状态查询、截图、登录、媒体获取等 4. 重构tools脚本的模块导入路径 5. 补充版本号与能力清单定义 6. 完善全局配置与依赖管理 整体完成项目从单文件脚本到可维护的包结构迁移，为后续功能开发打下基础。
51 lines
2.8 KiB
Python
51 lines
2.8 KiB
Python
"""状态域模型：bridge 状态响应。"""
|
||
|
||
from __future__ import annotations
|
||
|
||
from typing import Optional
|
||
|
||
from pydantic import BaseModel, Field
|
||
|
||
from woc_bridge.models.login import LoginState
|
||
|
||
|
||
# ---------------------------------------------------------------------------
|
||
# 状态接口（GET /api/status）
|
||
# ---------------------------------------------------------------------------
|
||
class StatusResponse(BaseModel):
|
||
"""bridge 状态响应。
|
||
|
||
新增字段（1.1.0）：
|
||
- db_error_code：DB 不可达时的具体原因（encrypted / not_found / unreadable），
|
||
db_accessible=true 时为 None
|
||
- send_queue_pending：发送队列当前积压任务数，客户端据此决定是否退避
|
||
- media_supported：图片/文件发送是否已实现真实传输（与 BRIDGE_CAPABILITIES
|
||
中 image_send/file_send 同步）
|
||
- bridge_capabilities：当前 bridge 支持的能力集合，客户端据此协商
|
||
"""
|
||
|
||
bridge_version: str = Field(description="bridge 版本号")
|
||
wechat_running: bool = Field(description="微信进程是否运行")
|
||
wechat_window_found: bool = Field(description="是否找到微信窗口")
|
||
login_state: LoginState = Field(description="登录态")
|
||
db_accessible: bool = Field(description="微信本地 DB 是否可读")
|
||
db_error_code: Optional[str] = Field(
|
||
default=None,
|
||
description="DB 不可达原因：not_found / unreadable / encrypted_no_key / encrypted_key_ok / key_extract_failed / need_init / init_in_progress / key_invalid；db_accessible=true 时为 None",
|
||
)
|
||
init_in_progress: bool = Field(default=False, description="是否正在进行后台 DB 初始化（密钥提取/预解密）")
|
||
init_progress_pct: Optional[float] = Field(default=None, description="初始化进度百分比 0-100")
|
||
init_message: Optional[str] = Field(default=None, description="初始化阶段描述")
|
||
current_wxid: str = Field(default="", description="当前登录 wxid，未登录时为空")
|
||
current_nickname: str = Field(default="", description="当前登录昵称，未登录时为空")
|
||
uptime_seconds: float = Field(description="bridge 已运行秒数")
|
||
display: str = Field(description="当前 DISPLAY 环境变量值")
|
||
max_batch_size: int = Field(default=50, description="客户端单次拉取建议上限")
|
||
poll_interval_ms: int = Field(default=2000, description="客户端轮询建议间隔（毫秒）")
|
||
send_queue_pending: int = Field(default=0, description="发送队列积压任务数")
|
||
media_supported: bool = Field(default=False, description="图片/文件真实传输是否已实现")
|
||
bridge_capabilities: list[str] = Field(
|
||
default_factory=list,
|
||
description="bridge 支持的能力集合，如 ['text_send','image_send','long_poll']",
|
||
)
|