开发环境

1. 开发前准备

• 阅读 应用开发
• 阅读 技术选型与工程规则
• 安装 uv
• 确认本地可以提供 Python 3.14+
• 确认本地可执行仓库内 scripts/

2. 推荐环境初始化

在仓库根目录执行：

uv python install 3.14
uv sync

最小可用性校验：

uv run python scripts/factory-dispatch --help
uv run python scripts/factory-agent-session --help
uv run pytest -q

3. 开发环境原则

• 使用项目当前约定的工具链和规则
• 优先通过脚本和正式文档进入上下文
• 在开始编码前，先确认需求与设计基线
• 默认通过 uv run python scripts/... 执行仓库脚本，不把系统 python3 当作主入口
• 代码和规则改动后，优先使用 uv run pytest 做最小回归；需要时再补 uv run ruff check . 与 uv run mypy