bolt-boot 0.1.0__tar.gz

bolt_boot-0.1.0/.dockerignore

@@ -0,0 +1,78 @@
+# Git
+.git
+.gitignore
+
+# Python
+__pycache__
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Testing
+.tox/
+.nox/
+.coverage
+.coverage.*
+htmlcov/
+.pytest_cache/
+.hypothesis/
+
+# Type checking
+.mypy_cache/
+.pytype/
+
+# Documentation
+docs/
+*.md
+!README.md
+
+# Local development
+.dev/
+*.log
+logs/
+.env.*
+!.env.example
+
+# Docker
+Dockerfile*
+docker-compose*.yml
+.docker/
+
+# CI/CD
+.github/
+.gitlab-ci.yml
+.travis.yml
+
+# Misc
+.DS_Store
+Thumbs.db

bolt_boot-0.1.0/.env.example

@@ -0,0 +1,54 @@
+# 环境变量示例
+
+# 应用配置
+BOLT_APP_NAME=my-app
+BOLT_DEBUG=true
+BOLT_ENVIRONMENT=development
+
+# 数据库配置
+BOLT_DATABASE_URL=sqlite+aiosqlite:///./dev.db
+#BOLT_DATABASE_POOL_SIZE=5
+BOLT_DATABASE_ECHO_SQL=false
+
+# Redis 配置
+BOLT_REDIS_URL=redis://localhost:6379/0
+BOLT_REDIS_PREFIX=bolt:
+
+# 日志配置
+BOLT_LOG_LEVEL=INFO
+BOLT_LOG_FORMAT=json
+BOLT_LOG_DIR=logs
+
+# LLM 配置（OxyGent 引擎走 OpenAI 兼容端点；provider 可选 openai/deepseek/qwen/custom）
+BOLT_LLM_DEFAULT_PROVIDER=openai
+BOLT_LLM_DEFAULT_MODEL=gpt-4o
+BOLT_LLM_API_KEY=your-api-key-here
+# OpenAI 兼容端点地址（DeepSeek/通义/自建网关必配；openai 官方可不配）
+BOLT_LLM_BASE_URL=https://api.deepseek.com
+BOLT_LLM_MAX_TOKENS=4096
+
+# OxyGent 引擎配置
+# 多 worker 部署必须配置 ES 集群以共享会话历史；留空 = 进程内存存储
+BOLT_OXY_ES_HOSTS=
+BOLT_OXY_PRELOAD=false
+
+# OxyGent A2A 跨进程协作（把本进程 master 暴露给其他 bolt 应用委派）
+BOLT_OXY_A2A_SERVER_ENABLED=false
+BOLT_OXY_A2A_BASE_PATH=/a2a
+# 共享密钥；留空 = 不鉴权（仅限内网/开发环境）
+BOLT_OXY_A2A_TOKEN=
+
+# BoltAgent 会话记忆后端：memory（进程内，默认） / redis（多 worker 共享，复用 BOLT_REDIS_URL）
+BOLT_MEMORY_BACKEND=memory
+BOLT_MEMORY_TTL=3600
+
+# OpenTelemetry 配置
+BOLT_TELEMETRY_ENABLED=true
+BOLT_TELEMETRY_ENDPOINT=http://localhost:4317
+BOLT_TELEMETRY_SERVICE_NAME=bolt-app
+
+
+# ============ 独立指标端口（Prometheus 抓取） ============
+# 启用后应用在 BOLT_METRICS_PORT 起一个无认证 /metrics 服务（限内网抓取）
+#BOLT_METRICS_SERVER_ENABLED=true
+#BOLT_METRICS_PORT=9090

bolt_boot-0.1.0/.gitattributes

@@ -0,0 +1,18 @@
+# 统一换行符为 LF（跨平台一致）
+* text=auto eol=lf
+
+# Windows 脚本保留 CRLF
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.ps1 text eol=crlf
+
+# 二进制文件不做换行转换
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.db binary
+*.sqlite binary
+*.woff binary
+*.woff2 binary

bolt_boot-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,23 @@
+# 三件套：红了拒绝合并
+name: ci
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: 安装
+        run: pip install -e ".[dev]" && pip install -e ".[observability]" || pip install -e ".[dev]"
+      - name: ① ruff
+        run: ruff check bolt
+      - name: ② mypy
+        run: mypy bolt/core bolt/domain --ignore-missing-imports --no-strict-optional
+      - name: ③ pytest
+        run: pytest tests/unit -q -o addopts=""

bolt_boot-0.1.0/.gitignore

@@ -0,0 +1,69 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+.build/
+develop-eggs/
+dist/
+downloads/
+.eggs/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+
+# Database
+*.db
+*.sqlite
+*.sqlite3
+
+# Logs
+logs/
+*.log
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Build
+*.pyc
+
+# Test app
+test_app/.env
+test_app/*.db
+
+# CLI/脚手架生成的临时产物
+.bolt/
+.tests/
+*.bak
+
+# 本地 AI 工具配置
+.claude/
+coverage.json
+cache_dir/

bolt_boot-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,51 @@
+# Pre-commit hooks for Bolt framework
+# See https://pre-commit.com for more information
+
+default_language_version:
+  python: python3.12
+
+repos:
+  # General file checks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+        args: [--unsafe]
+      - id: check-toml
+      - id: check-json
+      - id: check-added-large-files
+        args: [--maxkb=500]
+      - id: check-merge-conflict
+      - id: detect-private-key
+      - id: no-commit-to-branch
+        args: [--branch, master, --branch, main]
+
+  # Ruff - linter + formatter (replaces flake8, isort, black)
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.0
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-format
+
+  # Type checking
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.14.0
+    hooks:
+      - id: mypy
+        args: [--ignore-missing-imports]
+        additional_dependencies:
+          - pydantic>=2.10
+          - fastapi>=0.115
+        files: ^bolt/
+
+  # Security checks
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.9.0
+    hooks:
+      - id: bandit
+        args: [-c, pyproject.toml]
+        additional_dependencies: ["bandit[toml]"]
+        files: ^bolt/

bolt_boot-0.1.0/CHANGELOG.md

@@ -0,0 +1,127 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Fixed
+
+- **`bulk_upsert` 支持 MySQL/MariaDB**：新增 `ON DUPLICATE KEY UPDATE` 分支（原仅 PostgreSQL，非 PG 直接抛错）；sqlite 走与 PG 同构的 `ON CONFLICT`；注意 MySQL rowcount 语义（插入=1/更新=2/无变化=0）
+- **连接池参数覆盖 MySQL/MariaDB**：`database.py` 原仅 PostgreSQL 添加 pool_size/max_overflow/pre_ping，MySQL 走裸默认（5 连接、无心跳），高并发与 wait_timeout 场景会出 "MySQL server has gone away"；现在 PG/MySQL/MariaDB 统一注入池参数，SQLite 维持原策略
+- **RedisCacheBackend 弃用调用清理**：`setex`（redis-py 8.x 起弃用）改为 `set(key, value, ex=ttl)`，行为等价
+- **测试环境**：补充 `redis`/`fakeredis` 测试依赖（原 14 例 RedisCacheBackend 用例因 patch 目标 `aioredis` 未绑定而失败）；Redis 相关用例在未安装 redis 的环境中自动跳过
+- **新增 Redis 集成测试** `tests/integration/test_redis_integration.py`（5 例）：连本地 Docker Redis（localhost:6379，redis 服务需发布端口）验证真实读写/TTL 过期/重连持久化；无可用 Redis 自动跳过
+
+### Changed
+
+- **统一响应格式对齐内部规范**：所有接口（含异常/限流/租户/体积限制/关机中间件）统一为
+  `{success, code:int, message, data, timestamp, trace_id?, error?}`
+  - `code` 改为 int：0=成功；失败为 HTTP 语义码（400/401/403/404/409/413/422/429/500/502），业务自定义码从 10000 段起
+  - 新增 `timestamp`（ISO8601 服务端时间）；`error` 为失败时的可读错误码（如 NOT_FOUND）；`trace_id` 保留
+  - `bolt/core/response.py` 为唯一定义点；全量单测（1859 例）已更新并通过
+- 测试环境：补充 `redis`/`fakeredis` 测试依赖（原 14 例 RedisCacheBackend 用例因 patch 目标 `aioredis` 未绑定而失败）；Redis 相关用例在未安装 redis 的环境中自动跳过
+
+- **Agent 引擎全量切换为 OxyGent**（PyPI `oxygent==1.1.3`），移除 langchain/langgraph/langsmith 依赖
+  - `BoltAgent` 对话/工具循环/流式由 OxyGent MAS 驱动（ReAct 工具循环完整可用，`AgentResult.tool_calls` 真实填充）
+  - 新增 `MultiAgentSystem` / `AgentSpec` 多 Agent 编排 API（master 委派 sub_agents）
+  - 新增 A2A 跨进程协作：`add_remote_agent` 客户端委派 + `BOLT_OXY_A2A_SERVER_ENABLED` 服务端暴露（含共享密钥校验）
+  - `ConversationMemory` 重建为纯 Python 实现（内存/Redis/DB 三后端），后端经 `BOLT_MEMORY_BACKEND` 配置化
+- RAG 全面重写为自有实现：Document/Splitters（纯 Python 递归分割）/Loaders（pypdf+stdlib+httpx，SSRF 防护保留）/Embeddings（OpenAI 兼容直连）/VectorStore（numpy 内存 + Chroma 原生）
+- 删除 `AgentGraph`（langgraph 封装）与 `bolt.agent.providers`（RAG 的 LLM 调用改走 `bolt.rag.llm`）
+
+### Added
+
+- `bolt-boot[oxy]` extra：OxyGent 引擎（默认 Agent 引擎，含 `mcp<2`/`python-dotenv` 补钉）
+- `scripts/oxy_integration_smoke.py`：真机集成冒烟（MockLLM 零网络验证委派全链路）
+- 会话记忆配置：`BOLT_MEMORY_BACKEND` / `BOLT_MEMORY_TTL`；A2A 配置：`BOLT_OXY_A2A_*`
+
+### Fixed（生产级框架 bug）
+- observability: `get_tracer`/`get_meter` 持锁调用 init 导致的自死锁（改 RLock）
+- config_center: Apollo `watch` 变更检测死代码（回调永不触发）与失败后零退避 CPU 紧转
+- mq/kafka: `subscribe` 循环 pending future 泄漏
+- security/api_key: `hashlib` 调用错误导致 API Key 生成与旧格式校验必崩
+- security/jwt: `refresh_access_token` 未遵循 blacklist `fail_closed` 配置
+- distributed_lock: 注入 redis client 时 Lua 脚本未注册导致 release 崩溃
+- core/di: 单例工厂异常后 `_PENDING` 标记残留（之后误报循环依赖）；scoped 服务越界获取显式报错
+- mq: `ack/nack` 现返回状态更新后的 Message（冻结数据契约下可观察状态流转）
+- domain/transaction: `transactional` 跨 session 复用事务上下文前校验 session 身份
+
+### Changed
+- Agent 层单引擎化：移除 LangSmith 死代码与 LangGraph 时代残留，文档同步为 OxyGent
+- core 关闭路径改用 `bolt.core.lifecycle` 生命周期注册表，不再感知具体基础设施类型
+- RequestValidationError/HTTPException 接入统一响应 envelope
+- 权限错误消息带上缺失的权限/角色名；健康检查失败消息带上异常文本
+- `BoltAgent._memories` / `OxyRuntime.session_traces` 改为有界 LRU，消除慢性内存泄漏
+- `@tool` 注册沿 MRO 收集，父类工具可被子类继承
+- 时区统一：cache_backends 使用 `time.time()`，registry 使用 aware UTC
+
+### Fixed
+- agent/oxy/engine: 无工具 Agent 的 invoke/chat 曾路由到不存在的
+  `{name}__chat` 孪生导致 KeyError（冷眼新用户实测发现，README 首例
+  即触发）；现无工具 Agent 直接路由主名
+- agent/oxy/runtime: 有工具 Agent 的自定义 system_prompt 改走
+  `additional_prompt` 追加（原用 prompt 覆盖会吞掉默认提示词中的
+  `${tools_description}` 渲染，模型看不到任何工具）
+- agent/oxy/mapping: `invoke()/chat()` 最终输出剥离 `<think>` 推理块，
+  返回干净正文（流式透传不受影响）
+- README: 补 api_prefix 前缀说明、DeepSeek 等国产模型接入方式、
+  流式语义说明、独立指标端口配置
+
+### Fixed
+- oxy/runtime: `_build_mas` 对 oxygent 1.1.3 的 import 路径错误
+  （ChatAgent/FunctionHub/ReActAgent/OpenAILLM 位于 `oxygent.oxy` 子模块）
+- oxy/llm_compat（新增）: 修复上游流式 reasoning/content 分流 bug，
+  DeepSeek 等思考模型每个 delta 均携带 reasoning_content 属性（content
+  阶段值为 None），上游 hasattr 判断导致正文被全部丢弃、ReAct 失效。
+  修复后经 DeepSeek 真实环境端到端验证：ReAct 工具调用、无工具对话、
+  RAG LLM 直连三条路径全部通过
+
+### Fixed
+- 部署外壳（生产就绪评审 P1）：Dockerfile 修复源码 COPY 缺失导致构建必败
+  与无效 CMD（新增 bolt/__main__.py 内置演示应用）；BOLT_ENV →
+  BOLT_ENVIRONMENT（原变量名使容器内生产校验全部失效，已实测恢复）
+- prometheus-client 升级为核心依赖；新增独立指标端口
+  （BOLT_METRICS_SERVER_ENABLED，默认关闭）打通 deploy/prometheus.yml 抓取链路
+- scheduler: Redis 后端下分布式锁接线 _execute_job（多实例部署同一任务
+  仅一个实例执行；Memory 后端行为不变），附接线测试
+- 安全: get_current_user 强制 type==access（refresh token 不再能当
+  access 凭据）；mas_api session_traces 改走 LRU 入口
+
+### Fixed
+- security/brute_force: 容量上限改为 LRU 硬驱逐（原惰性清理可被
+  轮换 username 的攻击者撑大内存），纯 check 不再产生空条目
+- deploy: Grafana 面板挂载路径修正（deploy/grafana）并补充
+  provisioning provider 配置，原配置面板加载为空
+
+### Added
+- `bolt.core.lifecycle` 生命周期注册表（启动/关闭钩子对称）与
+  `ScopedServiceError` 异常类型
+- `docs/KNOWN-TRADEOFFS.md` 技术债台账（能力边界/安全取舍/运维前置条件）
+- repository 缓存能力拆分至 `bolt/domain/repository/cache.py`
+  （CachePort + CacheMixin），base.py 803 → 713 行
+- TokenBlacklist 读路径 fail-open / 写路径 fail-closed 语义、
+  撤销往返与全量撤销的回归测试
+- OxyGent MAS 真实物化测试（test_oxy_materialization.py，需安装 oxygent）：
+  覆盖 Config/LLM 去重/FunctionHub 工具桥接/ReActAgent-ChatAgent 双映射/aclose
+- 测试套件修复并扩展至 1969 个用例（全绿），覆盖率 72% → 80.00%（门禁首次真实达标）
+- 新增测试覆盖：jwt_keys、repository filters/pagination/bulk、core protocols/plugin/telemetry、
+  agent messages、RAG advanced 全系列、Neo4j/内存图谱库、多模态处理器、CLI 命令
+
+## [0.1.0] - 2026-04-26
+
+### Added
+- AI 原生 FastAPI 框架核心（App 工厂、配置、DI 容器、中间件链）
+- DDD 分层架构（Domain / API / Infrastructure / Security）
+- Agent 模块（BoltAgent基类、OxyGent MAS 引擎驱动、多 Agent 编排、对话记忆）
+- RAG 模块（文档加载、分割、嵌入、向量存储、检索器）
+- Advanced RAG（重排序、上下文压缩、引用生成、混合搜索、知识图谱、多模态）
+- 安全模块（JWT RS256/ES256/HS256、API Key、RBAC、多租户隔离、暴力破解防护）
+- 基础设施（Redis 缓存、Kafka/RabbitMQ/RocketMQ 消息队列、分布式锁、调度器）
+- 微服务支持（Consul/Nacos 注册中心、Apollo/Nacos 配置中心、可观测性 OpenTelemetry）
+- CLI 工具（init / generate / migrate / agent / rag / test / docs / db）
+- Docker 多阶段构建 + docker-compose 全栈编排
+- CI/CD 四阶段流水线（lint → test → build → docker）
+- 完整测试套件（单元测试 + 集成测试，覆盖率 > 80%）

bolt_boot-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,51 @@
+# 贡献指南
+
+感谢你为 Bolt 做贡献！本文档说明如何开始以及项目维护的底线规则。
+
+## 开发环境
+
+```bash
+# Python 3.11+
+pip install -e ".[dev]"        # 框架 + 开发工具
+# 或按需安装可选依赖
+pip install -e ".[oxy]"        # OxyGent Agent 引擎
+pip install -e ".[rag]"        # RAG 全家桶
+```
+
+## 底线规则（CI 会拦截）
+
+1. **测试必须全绿**。`pytest tests/unit tests/integration` 零失败、零错误、零挂起；
+   覆盖率门禁为 `--cov-fail-under=80`（pyproject 中已配置），新增代码请附带测试。
+2. **测试与实现同步演进**。修改实现时，同步更新受影响的测试契约；
+   不要为了让旧测试通过而回退实现，也不要删测试来"变绿"。
+3. **静态检查**：`ruff check bolt` 零告警；`mypy` 配置为 `strict = true`
+   （第三方库在 pyproject overrides 中豁免）。
+4. **禁止引入**：`eval`/`exec`/`pickle.loads`、`shell=True`、`verify=False`、
+   未脱敏的敏感信息日志。安全敏感改动（认证、加密、路径处理）请在 PR 中明确标注。
+
+## 提交规范
+
+- 遵循 [Conventional Commits](https://www.conventionalcommits.org/zh-hans/)：
+  `feat:` / `fix:` / `docs:` / `refactor:` / `test:` / `chore:`
+- 一次提交聚焦一件事；提交前确保本地全量测试通过。
+
+## 架构约定（写代码前请读）
+
+完整架构见 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)。核心纪律：
+
+- **分层单向依赖**：`core → domain → api/security/infrastructure`；
+  core 不感知具体基础设施类型（通过 `bolt.core.lifecycle` 注册关闭钩子、
+  `bolt.core.protocols` 定义端口协议）。
+- **防腐层**：第三方 SDK 类型不得泄漏出适配模块（参考 `bolt/agent/oxy/`）。
+- **错误处理**：对外抛 `BoltError` 子类（见 `bolt/core/exceptions.py`），
+  统一响应格式 `{success, code, message, data}`；不要引入第二种错误信封。
+- **有界资源**：任何以用户输入为 key 的内存缓存必须有上限（LRU 语义，
+  参考 `OxyRuntime.session_traces`、`BoltAgent._memories`）。
+- **事务**：业务方法用 `@transactional`；跨 session 场景注意 session 身份校验。
+- **时间**：统一 aware UTC（`datetime.now(UTC)`）或 epoch（`time.time()`），
+  禁止 naive `datetime.now()`。
+
+## 报告 bug
+
+请附上：最小复现代码、预期/实际行为、Python 版本、相关 traceback。
+安全问题请勿公开提交，见 [SECURITY.md](SECURITY.md)。

bolt_boot-0.1.0/Dockerfile

@@ -0,0 +1,55 @@
+# Bolt 框架 Docker 镜像
+# 多阶段构建优化生产镜像
+
+# ============ 构建阶段 ============
+FROM python:3.12-slim AS builder
+
+WORKDIR /app
+
+# 安装构建依赖（利用 Docker layer cache）
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+# 复制包定义与源码（hatchling 构建需要 bolt/ 源码与 README 元数据）
+COPY pyproject.toml README.md ./
+COPY bolt ./bolt
+
+# 创建虚拟环境并安装包及其核心依赖
+RUN python -m venv /opt/venv
+ENV PATH="/opt/venv/bin:$PATH"
+RUN pip install --no-cache-dir --upgrade pip && pip install --no-cache-dir .
+
+# ============ 生产阶段 ============
+FROM python:3.12-slim AS production
+
+WORKDIR /app
+
+# 安装运行时系统依赖
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl \
+    && rm -rf /var/lib/apt/lists/* \
+    && useradd --create-home --shell /bin/bash appuser
+
+# 从构建阶段复制虚拟环境（bolt 包及其依赖已安装其中）
+COPY --from=builder /opt/venv /opt/venv
+ENV PATH="/opt/venv/bin:$PATH"
+
+# 安全：非 root 用户运行
+RUN chown -R appuser:appuser /app
+USER appuser
+
+# 环境变量
+ENV PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    BOLT_ENVIRONMENT=production
+
+# 暴露端口（8000: API, 9090: 指标，需 BOLT_METRICS_SERVER_ENABLED=true）
+EXPOSE 8000 9090
+
+# 健康检查
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:8000/health || exit 1
+
+# 默认命令：内置演示应用（健康检查等基础端点），生产部署请覆盖为业务 app
+CMD ["uvicorn", "bolt.__main__:app", "--host", "0.0.0.0", "--port", "8000"]

bolt_boot-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cheng Qiaoqiao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bolt_boot-0.1.0/Makefile

@@ -0,0 +1,18 @@
+.PHONY: install dev test lint typecheck check
+
+install:        ## 安装框架（可编辑模式）
+	pip install -e .
+
+dev:            ## 启动开发服务器（默认 8000）
+	uvicorn main:app --reload --port 8000
+
+test:           ## 全量测试
+	pytest tests/unit -q -o addopts=""
+
+lint:           ## ruff 规范检查
+	ruff check bolt
+
+typecheck:      ## mypy 类型检查
+	mypy bolt/core bolt/domain --ignore-missing-imports --no-strict-optional
+
+check: lint typecheck test   ## 三件套（CI 同款）