agent-cli-Mrzhou300 0.2.1__tar.gz

agent_cli_mrzhou300-0.2.1/.github/workflows/cd.yml

@@ -0,0 +1,79 @@
+# =============================================================================
+# CD（持续部署）workflow
+#
+# 功能：当你发布新版本（打 git tag）时，自动构建并发布到 PyPI
+# 触发条件：推送 v 开头的标签，如 v0.1.0, v0.2.0, v1.0.0
+# 依赖：需要在 GitHub 仓库设置 PYPI_API_TOKEN 密钥
+# =============================================================================
+
+name: CD
+
+# ── 触发条件 ────────────────────────────────────────────────────────────────
+# 只有推送 "v" 开头的 git tag 时才触发
+# 比如: git tag v0.2.0 && git push origin v0.2.0
+on:
+  push:
+    tags:
+      - "v*"          # v0.1.0, v0.2.0, v1.0.0 等
+
+env:
+  PYTHON_VERSION: "3.12"
+
+jobs:
+  # ──── 发布到 PyPI ──────────────────────────────────────────────────────────
+  publish:
+    name: "📦 发布到 PyPI"
+    runs-on: ubuntu-latest
+    # permissions: 声明这个 job 需要的权限
+    # 这里是创建 Release 需要的
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v6.0.3
+
+      - name: "🐍 安装 Python ${{ env.PYTHON_VERSION }}"
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "${{ env.PYTHON_VERSION }}"
+
+      - name: "📦 安装 uv"
+        uses: astral-sh/setup-uv@v8.2.0
+
+      - name: "🔧 安装依赖"
+        run: uv sync
+
+      # ── 步骤 A: 构建发布包 ──────────────────────────────────────────────
+      # uv build 会生成 .tar.gz（源码包）和 .whl（wheel 包）
+      # 它们会放在 dist/ 目录下
+      - name: "🏗️ 构建发布包"
+        run: uv build
+
+      # ── 步骤 B: 发布到 PyPI ──────────────────────────────────────────────
+      # 使用 PyPI 官方提供的"可信发布"（Trusted Publishing）机制
+      # 不需要用户名密码，只需要在 PyPI 上配置好 GitHub 仓库的信任关系
+      #
+      # 💡 前置操作（只需做一次）：
+      # 1. 登录 https://pypi.org/manage/account/publishing/
+      # 2. 添加一个"可信发布者"（Trusted Publisher）
+      #    - PyPI 项目名: agent-cli-Mrzhou300（和 pyproject.toml 里一致）
+      #    - GitHub 用户名: <你的 GitHub 用户名>
+      #    - GitHub 仓库名: agent-cli
+      #    - 工作流名称: cd.yml（就是这个文件）
+      # 3. 完成！以后每次打 tag 就自动发布了
+      - name: "🚀 发布到 PyPI"
+        # 固定到 v1.14.0 而不是 release/v1，避免缓存问题导致 OIDC 失败
+        uses: pypa/gh-action-pypi-publish@v1.14.0
+
+      # ── 步骤 C: 在 GitHub 上创建 Release ──────────────────────────────────
+      # 这样在 GitHub 仓库的 Releases 页面能看到发布记录
+      - name: "📝 创建 GitHub Release"
+        uses: softprops/action-gh-release@v2
+        with:
+          # 使用 git tag 作为 release 标题
+          name: "v${{ github.ref_name }}"
+          # 自动从 tag 名生成 release 说明
+          generate_release_notes: true
+          # 把构建好的包附加上去
+          files: dist/*

agent_cli_mrzhou300-0.2.1/.github/workflows/ci.yml

@@ -0,0 +1,132 @@
+# =============================================================================
+# CI（持续集成）workflow
+#
+# 功能：每次推送代码或提 PR 时，自动执行 测试 + 代码风格检查
+# 触发条件：push（推送）或 pull_request（PR）
+# 运行环境：GitHub 提供的 Ubuntu 服务器（每次启动都是全新的）
+# =============================================================================
+
+# workflow 的名字，会显示在 GitHub 仓库的 Actions 标签页里
+name: CI
+
+# ── 触发条件 ────────────────────────────────────────────────────────────────
+# 什么时候自动运行这个 workflow
+on:
+  # 推送代码到任意分支时触发
+  push:
+    branches: ["*"]        # 所有分支
+  # 创建 PR 到 main 分支时触发
+  pull_request:
+    branches: ["main"]     # 只监听 PR → main
+
+# ── 环境变量（全局） ─────────────────────────────────────────────────────────
+# 这些变量在整个 workflow 的所有 job 中都可以用
+env:
+  PYTHON_VERSION: "3.12"   # Python 版本（项目要求 >=3.12）
+
+# ── Jobs（工作单元） ─────────────────────────────────────────────────────────
+# 一个 workflow 可以包含多个 job，它们默认并行执行
+jobs:
+
+  # ──── Job 1: 测试 ──────────────────────────────────────────────────────────
+  test:
+    # job 的名称（显示在 GitHub 界面上的名字）
+    name: "Test & Lint"
+    # 运行环境：Ubuntu 最新版
+    runs-on: ubuntu-latest
+
+    # steps：这个 job 要依次执行的步骤
+    # 注意：steps 是顺序执行的，上一步失败就停止
+    steps:
+      # Step 1: 拉取你的代码
+      # actions/checkout 是 GitHub 官方提供的"动作"（Action）
+      # 相当于 git clone 你的仓库到 CI 服务器上
+      - name: "📥 拉取代码"
+        # v6.0.3 — Node 24 兼容，GitHub 自 2026-06-02 起默认运行 Node 24
+        uses: actions/checkout@v6.0.3
+
+      # Step 2: 安装 Python
+      # actions/setup-python 是 GitHub 官方 Action
+      # 在 Ubuntu 上安装指定版本的 Python
+      - name: "🐍 安装 Python ${{ env.PYTHON_VERSION }}"
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "${{ env.PYTHON_VERSION }}"
+
+      # Step 3: 安装 uv（Python 包管理工具）
+      # astral-sh/setup-uv 是 uv 官方提供的 Action
+      # ⚠️ 注意：这个项目用 uv 管理依赖，不是 pip
+      - name: "📦 安装 uv"
+        uses: astral-sh/setup-uv@v8.2.0
+
+      # Step 4: 调试步骤 — 确认当前目录和文件结构
+      # 如果 CI 报错说找不到文件，这个步骤会显示当前目录的内容
+      - name: "📂 查看工作目录"
+        run: |
+          echo "当前目录: $(pwd)"
+          echo "文件列表:"
+          ls -la
+
+      # Step 5: 安装项目依赖
+      # uv sync 等效于 pip install -r requirements.txt
+      # 它读取 pyproject.toml，安装所有依赖（包括 dev 依赖）
+      - name: "🔧 安装依赖"
+        run: uv sync
+
+      # Step 6: 运行 ruff 代码检查
+      # ruff check 检查代码风格问题（替代 flake8 + isort）
+      - name: "🔍 Ruff 代码检查"
+        run: uv run ruff check src/ tests/
+
+      # Step 7: 检查 ruff 格式
+      # ruff format --check 只检查格式是否正确，不修改文件
+      # 如果格式不正确，这里会报错 ❌
+      - name: "🎨 Ruff 格式检查"
+        run: uv run ruff format src/ tests/ --check
+
+      # Step 8: 运行 pytest 单元测试
+      # --cov=agent_cli 测量核心代码的测试覆盖率
+      # --cov-report=term 在终端输出覆盖率报告
+      # --cov-fail-under=80 覆盖率低于 80% 时 CI 失败（低于当前 87% 的保守阈值）
+      - name: "🧪 运行测试"
+        run: uv run pytest tests/ -v --cov=agent_cli --cov-report=term --cov-fail-under=80
+
+      # Step 9: mypy 静态类型检查（非阻塞，仅供参考）
+      # ⚠️ continue-on-error 表示这个步骤失败不会导致整个 workflow 变红
+      # 目前项目对核心模块（agent_cli.core.*）启用了 disallow_untyped_defs
+      - name: "📝 Mypy 类型检查"
+        continue-on-error: true
+        run: uv run mypy src/ || true
+
+  # ──── Job 2: 构建检查（验证包能正常构建） ────────────────────────────────
+  build-check:
+    name: "📦 构建验证"
+    runs-on: ubuntu-latest
+    # needs: 这个 job 依赖于 test job 成功
+    # 只有 test 通过后才会执行（但 parallelism 可以不需要）
+    needs: [test]
+
+    steps:
+      - uses: actions/checkout@v6.0.3
+      - uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "${{ env.PYTHON_VERSION }}"
+      - uses: astral-sh/setup-uv@v8.2.0
+
+      - name: "📂 查看工作目录"
+        run: |
+          echo "当前目录: $(pwd)"
+          echo "文件列表:"
+          ls -la
+
+      - name: "🔧 安装依赖"
+        run: uv sync
+
+      # 构建 wheel 包
+      # 生成的包在 dist/ 目录下
+      - name: "🏗️ 构建包"
+        run: uv build
+
+      # 验证构建的包可以正确安装
+      - name: "✅ 验证包可安装"
+        run: uv pip install dist/*.whl --force-reinstall

agent_cli_mrzhou300-0.2.1/.gitignore

@@ -0,0 +1,34 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.ruff_cache/
+
+# 覆盖率数据
+.coverage
+htmlcov/
+
+# 运行时数据（Claude 等工作目录，不上传）
+.agent/
+.claude/
+
+# 环境变量
+.env
+.env.local
+
+# IDE
+.vscode/*
+!.vscode/extensions.json
+!.vscode/settings.json
+.idea/
+
+# 系统
+.DS_Store
+Thumbs.db
+
+# 虚拟环境
+.venv/
+venv/

agent_cli_mrzhou300-0.2.1/.pre-commit-config.yaml

@@ -0,0 +1,66 @@
+# =============================================================================
+# pre-commit 本地钩子配置
+#
+# 功能：在 `git commit` 之前自动运行代码检查
+#       如果检查不通过，commit 会被阻止
+# 价值：在代码到达 GitHub 之前就发现问题，不用等 CI 报错
+#
+# 安装方法：
+#   1. 安装 pre-commit: pip install pre-commit
+#   2. 安装钩子:      pre-commit install
+#   3. 手动运行:      pre-commit run --all-files
+#
+# 前置条件：
+#   Python 3.12+
+#   pre-commit: pip install pre-commit 或 uv pip install pre-commit
+# =============================================================================
+
+repos:
+  # ── 通用检查 ──────────────────────────────────────────────────────────
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      # 检查是否有合并冲突标记（<<<<<<<, =======, >>>>>>>）
+      - id: check-merge-conflict
+      # 检查 YAML 文件语法是否正确
+      - id: check-yaml
+      # 检查 JSON 文件语法是否正确
+      - id: check-json
+      # 检查文件末尾是否有多余的空行
+      - id: trailing-whitespace
+      # 检查文件末尾是否有且仅有一个换行符
+      - id: end-of-file-fixer
+
+  # ── Ruff（代码风格 + 格式化） ─────────────────────────────────────────
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.16
+    hooks:
+      # ruff check: 代码质量检查（lint）
+      - id: ruff
+        args: [--fix]   # 能自动修的顺手修掉
+      # ruff format: 代码格式化
+      - id: ruff-format
+
+  # ── pytest: 测试 ──────────────────────────────────────────
+  # 确保所有测试通过后才允许提交
+  # 与 CI 使用相同的命令，前置发现问题
+  - repo: local
+    hooks:
+      - id: pytest
+        name: 🧪 pytest
+        description: "运行所有测试，阻止提交失败的测试"
+        entry: uv run pytest tests/ -x --tb=short -q
+        language: system
+        pass_filenames: false
+        always_run: true
+        # 超时 120 秒——本地通常比 CI 快
+        args: []
+
+  # ── mypy: 类型检查 ───────────────────────────────────────────
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.14.1
+    hooks:
+      - id: mypy
+        args: [--no-strict-optional, --ignore-missing-imports, --python-version=3.12, src/agent_cli/]
+        additional_dependencies: ['types-requests']
+        pass_filenames: false  # 使用固定路径而非单个文件

agent_cli_mrzhou300-0.2.1/.vscode/extensions.json

@@ -0,0 +1,5 @@
+{
+  "recommendations": [
+    "github.vscode-github-actions"
+  ]
+}

agent_cli_mrzhou300-0.2.1/.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+  "github-actions.autoShowWorkflowFileContent": true,
+  "github-actions.workflowPath": ".github/workflows",
+  "yaml.schemas": {
+    "https://json.schemastore.org/github-workflow.json": ".github/workflows/*.yml"
+  }
+}

agent_cli_mrzhou300-0.2.1/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+## [0.2.0] — 2026-06-11
+
+### Added
+- **集成测试**：首次引入 VCR 录制/回放集成测试，5 个 DeepSeek 真实模型测试用例（`tests/integration/`）
+- **CLI E2E 测试**：补齐 `run` 命令 7 个 + `swarm` 命令 7 个 CliRunner 测试用例
+- **多模型切换**：`--provider` / `--api-key` / `--base-url` CLI 参数，支持 auto / anthropic / compatible / mock 四种模式
+- **兼容 API 支持**：`CompatibleProvider` 支持 DeepSeek、OpenAI 等兼容 API，含 SSE 流式输出
+- **技能系统**：双模式触发（自动上下文匹配 + `/skill` 命令），技能文件按需注入系统消息
+- **上下文压缩**：L1-L4 四层渐进式压缩，前三层零 API 成本
+- **多 Agent 协作**：Coordinator 模式 — 顺序 / 并行 / 投票 / 辩论四种编排
+- **子 Agent 系统**：独立上下文 + 共享工具集 + 结构化结果
+- **Hook 系统**：PRE_LOOP / POST_LOOP / PRE_TOOL / POST_TOOL 四个生命周期点
+- **监控告警**：P0-P3 四级告警 + 工具调用统计 + Token 追踪
+- **MCP Bridge**：JSON-RPC over stdio 外部工具协议
+
+### Changed
+- 测试覆盖率从 46% → 90%（582 测试通过）
+- README 更新为 v0.2.0 文档
+- 完善架构详解（`docs/architecture.md`）和模块详解（`docs/modules.md`）
+
+### Fixed
+- pre-commit ruff 版本与 CI 同步（v0.5.0 → v0.15.16）
+- 19 个测试文件的 import 排序问题
+- CompactPipeline provider 参数传递
+
+## [0.1.0] — 2026-06-10
+
+### Added
+- 完整项目框架初始提交
+- CI/CD workflow 和 pre-commit 配置
+- 核心 Agent Loop（~60 行）
+- Provider 抽象层（Mock / Anthropic / Compatible）
+- 8+ 内置工具（Bash / Read / Write / Edit / Glob / Grep / WebFetch / Agent）
+- 四级权限管理（Allow / Deny / Ask / Always_Ask）
+- 三级记忆架构（文件级 + 会话级 + 项目级）
+- JSONL 会话持久化（`--resume` 恢复，关键词搜索，自动归档）
+- REPL 交互模式（含 12+ 内置命令）
+- 任务规划与审批闭环（TodoItem 状态机 + 拓扑排序依赖）
+- 测试覆盖 46%（339 测试用例）