# A2APv1Pro

**Repository Path**: coderkent/a2apv1pro

## Basic Information

- **Project Name**: A2APv1Pro
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-17
- **Last Updated**: 2026-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# A2APv1Pro

Template-Version: 0.1.0
Generated-By: myappcreator

A2APv1Pro 是一个面向A2A协议、Agent发布/调用、支付与ERC-8004实验的Python项目。当前已有本地Mock协议闭环、发布端/调用端实现、Demo UI、测试和结构化知识库。

## 当前状态

- 当前阶段：Mock协议闭环已实现；企业可收费 Agent 的开发、发布与运营设计基本完成，调用侧设计待进一步收口。
- 主场景：A2A 协议/产品实验项目。
- 后续技术意图：Python。
- 启用模块：中文与 UTF-8 基线、标准知识库、重要结论落盘、小步可回退修改、协议/产品实验、Python 环境约定、协议安全约束、Codex App 交接。

## 目录

```text
.
├── AGENTS.md
├── README.md
├── knowledge-base/
│   ├── raw/
│   │   └── README.md
│   ├── wiki/
│   │   ├── INDEX.md
│   │   └── project-overview.md
│   └── outputs/
│       └── README.md
├── .myappcreator/
│   ├── init-manifest.md
│   ├── input-improvement-suggestions.md
│   └── codex-app-handoff.md
└── logs/
    └── myappcreator/
        └── generation-log.md
```

## 知识库

本项目知识库使用三层结构：

```text
knowledge-base/
  raw/
  wiki/
  outputs/
```

- `knowledge-base/raw/`：原始素材，AI 默认只读不改。
- `knowledge-base/wiki/`：结构化知识库。
- `knowledge-base/outputs/`：AI 生成报告和派生结果。

入口：

- [知识库索引](knowledge-base/wiki/INDEX.md)
- [知识库HTML看板](knowledge-base/index.html)

## 使用方式

在 Codex App 中将本目录作为独立项目打开，然后先阅读：

- `AGENTS.md`
- `README.md`
- `knowledge-base/wiki/INDEX.md`
- `.myappcreator/init-manifest.md`

## 官方样例

已按 A2A Python 教程把官方样例仓库克隆到本项目下，作为后续分析材料：

- 本地目录：`examples/official-a2a-samples/`
- Python 样例入口：`examples/official-a2a-samples/samples/python/`
- 来源记录：[A2A Python 教程样例来源记录](knowledge-base/wiki/10-research/a2a-python-tutorial-sample-source.md)

当前已有一个基于官方 `a2a-sdk` 类型的最小 A2A 协议合约工程：

- `src/a2apv1pro/models.py`：协议模型入口说明；不再定义本地 AgentCard/Task/Message 等重复结构。
- `src/a2apv1pro/server.py`：基于官方 `a2a.types` 的内存 mock A2A server，暴露 Agent Card 和任务接口。
- `src/a2apv1pro/client.py`：测试内 client，用于跑通合约。
- `src/a2apv1pro/demo_flow.py`：产品定价 demo 的内存流程状态机，包含 Worker Agent、外部 Agent 和 mock 支付模块。
- `src/a2apv1pro/publisher.py`：独立的服务商 Agent 发布端，生成 Mock ERC-8004 Identity Registry、registration file 和 Agent Card/JWS 公开产物。
- `src/a2apv1pro/requester.py`：独立的 Worker Agent 请求端，从序列化公开契约完成发现、报价、Mock ERC-20 付款和 Artifact 接收。
- `src/a2apv1pro/trust_providers.py`：独立 Reputation 与 Sumsub Validation Mock；明确不可用于生产决策。
- `src/a2apv1pro/demo_web.py`：标准库网页 demo server。
- `src/a2apv1pro/web_static/`：单页 UI，联动展示产品工作台、Worker Agent、外部 Agent、Mock 支付模块和事件日志。
- `src/a2apv1pro/official_protocol.py`：使用官方 `a2a.types` protobuf 类型构造更完整的协议对象。
- `tests/`：官方类型模型和端到端合约测试。

启动网页 demo：

```powershell
conda activate a2apv1pro
$env:PYTHONPATH = "src"
python -m a2apv1pro.demo_web
```

然后打开：

```text
http://127.0.0.1:8765
```

运行验证：

```powershell
conda activate a2apv1pro
python -m pytest -q
```

当前已创建项目专用 conda 环境：

```text
name: a2apv1pro
path: d:\dev\miniconda3\envs\a2apv1pro
python: Python 3.13.14
uv: 0.11.28
```

项目已把官方 A2A SDK 作为主依赖，协议对象应直接使用 `a2a.types`，不再维护本地重复模型。项目最低 Python 版本已调整为 `>=3.13`，与官方 Python 样例要求一致。

安装项目依赖：

```powershell
conda activate a2apv1pro
python -m pip install -e .
```

官方 SDK 的直接安装和导入方式是：

```powershell
python -m pip install a2a-sdk
```

```python
import a2a.types
```

本机已在 `a2apv1pro` conda 环境中验证 `a2a-sdk 1.1.0` 可用于构造官方 protobuf 类型。

当前推荐解释器：

```text
d:\dev\miniconda3\envs\a2apv1pro\python.exe
```

## 初始化信息

初始化清单见：

- `.myappcreator/init-manifest.md`

Codex App 交接信息见：

- `.myappcreator/codex-app-handoff.md`

如果后续运行命令、模板结构或规则行为发生变化，应同步更新本 README、相关 spec、知识库页面和命令文档。