MAcode/docs/02-核心系统模块设计.md

第二章 核心系统模块设计

版本：V1.0
基于文档：《AIGC-Hub智视码(AVCC)体系建设方案 V2.0》

---

2.1 赋码引擎（Code Issuance Engine）

2.1.1 职责边界

• 接收创作者的赋码申请，执行四步预检：重复检测、黑名单模型检测、版权材料完整性检测、MA 标识片段合规性检测。
• 对接 MA 行业节点（广电云）码资源池，按审核结果分配对应 AVCC 编码。
• 生成 AVCC 完整六段式编码并返回，同时将编码生成记录上链存证。
• 管理码全生命周期：有效、注销、冻结、迭代版本。

2.1.2 AVCC 编码生成逻辑

// 伪代码：AVCC 六段式编码生成引擎（Go 实现）
func GenerateAVCC(
    platformNode string,        // 平台/机构节点代码，如 "8361"
    objectCategory string,      // 对象类目，如 "10.1300200.AIGC"
    licenseNo string,           // 网标号，如 "(京)网微剧审字(2026)第001号"
    reviewLevel string,         // 类别段：P(重点) / G(普通) / O(其他)
    aiHash string,              // AI 生成内容哈希值
    copyrightCRD string,        // 版权链存证地址
    version int,                // 迭代版本号
) string {
    /*
    AVCC（MA 融合版）= [MA 根] + [国家/行业节点] + [监管段] + [类别段] + [技术段] + [版权段]
    完整示例：
    MA.156.10005.8361/10.1300200.AIGC/(京)网微剧审字(2026)第001号-P-AI-HASH(a1b2c3)-CRD(0x7f3e9a)
    */
    maRoot := "MA"
    country := "156"
    industryNode := "10005"     // 拟申请的 AIGC 视听内容行业节点
    
    avcc := fmt.Sprintf("%s.%s.%s.%s/%s/%s-%s-AI-HASH(%s)-CRD(%s)",
        maRoot, country, industryNode, platformNode,
        objectCategory, licenseNo, reviewLevel, aiHash, copyrightCRD)
    
    if version > 1 {
        avcc = strings.Replace(avcc, fmt.Sprintf("AI-HASH(%s)", aiHash), 
            fmt.Sprintf("v%d-AI-HASH(%s)", version, aiHash), 1)
    }
    
    return avcc
}

// 编码解析
func ParseAVCC(avcc string) (map[string]interface{}, error) {
    // 将 AVCC 字符串解析为结构化字典
    pattern := `^(MA)\.(\d{3})\.(\d+)\.(\d+)/(\S+)/(\S+)-(P|G|O)-(v\d+)?-?AI-HASH\((\w+)\)-CRD\((\w+)\)$`
    re := regexp.MustCompile(pattern)
    match := re.FindStringSubmatch(avcc)
    
    if match == nil {
        return nil, errors.New("Invalid AVCC format")
    }
    
    version := 1
    if match[8] != "" {
        version, _ = strconv.Atoi(strings.ReplaceAll(match[8], "v", ""))
    }
    
    return map[string]interface{}{
        "ma_root":         match[1],
        "country_code":    match[2],
        "industry_node":   match[3],
        "platform_node":   match[4],
        "object_category": match[5],
        "license_no":      match[6],
        "review_level":    match[7],
        "version":         version,
        "ai_hash":         match[9],
        "copyright_crd":   match[10],
    }, nil
}

2.1.3 服务拆分与子服务职责

子服务	职责	关键技术
code-pre-check	接收申请，执行重复性、黑名单、材料完整性预检	视频指纹比对（ perceptual hash）、黑名单缓存查询
code-generator	编码规则引擎，按 MA 标准生成六段式 AVCC	规则引擎、编码模板、版本控制
code-allocator	对接 MA 码资源池，管理码段分配与回收	分布式锁（Redis）、码池库存管理
code-lifecycle	码状态管理（有效 / 注销 / 冻结 / 迭代）	状态机、事件驱动、链上同步

2.1.4 类别段与流通权限映射

类别	编码前缀	流通范围	MA 解析权限	赋码时效
重点 AI 漫剧	AVCC-P	全网全平台，首页推荐	MA 根节点 + 行业节点 + 平台节点三级解析	5-30 个工作日
普通 AI 漫剧	AVCC-G	平台内播放，非首页推荐	MA 行业节点 + 平台节点解析	1-3 个工作日
其他 AI 漫剧	AVCC-O	限本平台 / 限免流播放	平台节点本地解析	秒级实时赋码

---

2.2 审核引擎（AI Review Engine）

2.2.1 职责边界

• 对 AI 漫剧进行画面、台词、声音、AIGC 真实性的多模态合规检测。
• 输出分级建议（重点/普通/其他）及详细预审报告（含违规帧定位、台词标红）。
• 支持重点内容人工终审队列的流转与状态跟踪。
• 模型版本管理与 A/B 测试。

2.2.2 技术架构

┌─────────────────────────────────────────────────────────────────┐
│                    AI 审核引擎 (Review Engine)                   │
│                                                                 │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐         │
│  │  画面审核模块   │  │  台词审核模块   │  │  声音审核模块   │         │
│  │ (Vision Model)│  │ (NLP Model)  │  │ (Audio Model)│         │
│  │              │  │              │  │              │         │
│  │ 输入: 视频帧   │  │ 输入: 台词/SRT │  │ 输入: 音频轨道 │         │
│  │ 输出: 违规帧   │  │ 输出: 敏感词   │  │ 输出: 违规音效 │         │
│  │     标注/置信度│  │     语境评分   │  │     版权匹配   │         │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘         │
│         │              │              │                     │
│  ┌──────┴───────┐  ┌──────┴───────┐  ┌──────┴───────┐         │
│  │ AIGC 真实性核验│  │  版权链比对    │  │  模型版本校验  │         │
│  │(Deepfake检测) │  │(Fingerprint) │  │(白名单匹配)  │         │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘         │
│         │              │              │                     │
│  ┌──────┴──────────────────────────────────────┴──┐           │
│  │              多模态融合决策层                      │           │
│  │  (加权投票 + LLM 预审报告生成)                    │           │
│  │  → 输出: overall_score, suggested_level,         │           │
│  │          violations[], report_json              │           │
│  └─────────────────────────────────────────────────┘           │
└─────────────────────────────────────────────────────────────────┘

2.2.3 模型服务设计详表

模型服务名	输入	输出	推理框架	部署方式	GPU 需求
vision-compliance	视频帧序列 (抽帧 1fps)	违规帧坐标、违规类型标签、置信度 0-1	Triton + PyTorch	K8s GPU Pod	A10 / A100
nlp-dialogue	台词文本 / SRT 字幕	敏感词位置、语境合规评分 0-100	Triton + PyTorch	K8s GPU Pod	A10
audio-compliance	音频轨道 (16kHz mono)	违规音效时间戳、版权音乐指纹匹配度	Triton + PyTorch	K8s GPU Pod	A10
aigc-authenticity	视频 + C2PA 元数据	深度伪造概率、模型白名单命中状态	Triton + PyTorch	K8s GPU Pod	A100
copyright-fingerprint	视频感知哈希 / 指纹向量	Top-N 相似作品、侵权相似度	Milvus 向量检索	CPU Pod	无

2.2.4 审核任务状态机

[queued] → [preprocessing: 音视频切片/抽帧/转码] → [model_inferencing: 并行推理] 
                                                                  |
                                        ┌─────────────────────────┘
                                        ↓
                        [fusion_decision: 融合决策] → [report_generation]
                                                                  |
                                        ┌─────────────────────────┘
                                        ↓
                        ┌──────── P(>阈值) → [human_review_queue: 人工终审]
                        │
                        ├──────── G(中区间) → [platform_review: 平台人工复核]
                        │
                        └──────── O(低分且合规) → [auto_approved: 秒级赋码]

2.2.5 预审报告 JSON 结构

{
  "task_id": "task_20260602_001",
  "avcc": "MA.156.10005.8361/10.1300200.AIGC/...",
  "status": "completed",
  "overall_score": 78.5,
  "suggested_level": "G",
  "dimension_scores": {
    "vision": 82.0,
    "dialogue": 75.0,
    "audio": 88.0,
    "authenticity": 90.0,
    "copyright": 95.0
  },
  "violations": [
    {
      "type": "dialogue",
      "line": 23,
      "timestamp": "00:05:30",
      "severity": "medium",
      "keyword": "敏感词示例",
      "context": "台词上下文片段",
      "suggestion": "建议替换为 xxx"
    },
    {
      "type": "vision",
      "timestamp": "00:02:15",
      "frame": 3450,
      "severity": "low",
      "category": "血腥画面",
      "confidence": 0.72,
      "bbox": [120, 200, 300, 400],
      "suggestion": "建议打码或删减 0:02:10-0:02:20"
    }
  ],
  "ai_model_version": "review-v2.1.0-20260601",
  "inference_time_ms": 45230,
  "queue_wait_ms": 1200,
  "generated_at": "2026-06-02T14:30:00Z"
}

---

2.3 版权链引擎（Copyright Chain Engine）

2.3.1 职责边界

• 对 AVCC 全生命周期数据进行不可篡改存证（版权登记、审核结果、迭代记录、注销记录）。
• 管理版权主链、用户权益子链、分账智能合约。
• 提供链上数据查询、验证与仲裁接口。
• 对接深圳数据交易所，支撑 MA 数据要素登记证书签发。

2.3.2 联盟链组织与节点

组织	节点角色	权限	职责
广电云	排序节点 + 背书节点 + 锚节点	全权限	链治理、智能合约部署、交易排序
ZIIOT	背书节点	编码存证、根解析记录写入	MA 标识存证
长视频平台A	背书节点	版权登记、播放数据写入	版权与播放数据上链
短视频平台B	背书节点	版权登记、播放数据写入	版权与播放数据上链
深圳数据交易所	观察节点	只读	数据要素登记证书签发依据
监管机构	观察节点	只读	监管审计、链上数据抽查

2.3.3 智能合约设计

合约一：AVCC_Copyright（版权主链合约）

// 示意：ChainMaker / Fabric 智能合约（Go 实现）
// 功能：版权登记、权益方管理、版权迭代记录

// 数据结构
type CopyrightRecord struct {
    AVCC           string            // AVCC 完整编码
    Creator        string            // 创作者地址
    ContentHash    string            // 内容哈希
    LicenseDocHash string            // 授权书哈希
    Timestamp      int64             // 存证时间戳
    RightHolders   []RightHolder     // 权益方列表
    Version        int               // 迭代版本
    PrevAVCC       string            // 上一版本 AVCC（迭代时）
}

type RightHolder struct {
    Type   string   // creator / model / ip / platform
    Address string  // 链上地址
    Share  uint     // 万分比，如 4000 = 40%
}

// 核心方法
func RegisterCopyright(ctx contractapi.TransactionContextInterface, avcc string, ...) error
func UpdateRightHolders(ctx ..., avcc string, holders []RightHolder) error
func RecordIteration(ctx ..., prevAVCC string, newAVCC string, contentHash string) error
func QueryCopyright(ctx ..., avcc string) (*CopyrightRecord, error)

合约二：AVCC_UserRights（用户权益子链合约）

// 功能：用户跨平台购买权益记录与验证

type UserRightsRecord struct {
    AVCC            string   // 作品 AVCC
    UserHash        string   // 用户标识哈希（隐私保护）
    PurchasePlatform string  // 购买平台节点代码
    PurchaseTime    int64    // 购买时间
    ExpiryTime      int64    // 权益过期时间（NULL 表示永久）
    PricePaid       uint64   // 支付金额（分）
    RightsType      string   // play / download / share
}

func RecordPurchase(ctx ..., record UserRightsRecord) error
func VerifyRights(ctx ..., avcc string, userHash string, currentPlatform string) (bool, error)
func TransferRights(ctx ..., avcc string, userHash string, toPlatform string) error

合约三：AVCC_Settlement（分账清算合约）

// 功能：按智能合约比例自动执行分账

type SettlementRecord struct {
    AVCC           string
    PlatformID     string
    PeriodStart    int64
    PeriodEnd      int64
    TotalRevenue   uint64     // 总收益（分）
    PlatformShare  uint64     // 平台分成
    CreatorShare   uint64     // 创作者分成
    ModelShare     uint64     // 模型方分成
    IPShare        uint64     // IP 方分成
    HubFee         uint64     // 广电云服务费（6-8%）
    Status         string     // pending / confirmed / disputed / settled
}

func ExecuteSettlement(ctx ..., record SettlementRecord) error
func DisputeSettlement(ctx ..., avcc string, platformID string, reason string) error
func QuerySettlementHistory(ctx ..., avcc string) ([]SettlementRecord, error)

---

2.4 MA 编码网关（MA Encoding Gateway）

2.4.1 职责边界

• 对外提供统一的 AVCC 解析与流通权限识别服务（RESTful API）。
• 对接 ZIIOT MA 全球根解析系统，支持跨境、跨域、跨平台解析。
• 实现平台接入鉴权（API Key + HMAC-SHA256）、流量管控、解析日志记录。
• 管理 MA 三级节点注册与码资源分配接口（仅限广电云内部调用）。

2.4.2 核心接口列表

接口路径	方法	访问控制	说明
/api/v1/avcc/parse	POST	平台 API Key	解析 AVCC，返回完整元数据与流通权限
/api/v1/avcc/validate	POST	平台 API Key	校验 AVCC 有效性（含 MA 标识段合法性）
/api/v1/avcc/resolve	POST	平台 API Key	对接 MA 根解析，获取全球解析结果
/api/v1/node/register	POST	广电云内部	平台/机构节点注册（MA 三级节点）
/api/v1/node/allocate	POST	广电云内部	码资源分配（仅限广电云行业节点调用）
/api/v1/node/query	GET	平台 API Key	查询本节点码资源使用情况
/api/v1/stats/parse	GET	广电云运营	解析量统计、平台调用排行

2.4.3 解析流程

平台提交 AVCC → 网关本地解析（格式校验 + 签名验证）
                              │
              ┌───────────────┴───────────────┐
              │                               │
        本地缓存命中                      本地缓存未命中
              │                               │
              ↓                               ↓
        返回缓存结果                  调用 ZIIOT MA 根解析 API
                                              │
                                              ↓
                                    返回全球解析结果
                                              │
                                              ↓
                                    本地权限映射（流通范围计算）
                                              │
                                              ↓
                                    写入缓存（TTL=1h）
                                              │
                                              ↓
                                    返回完整解析响应

2.4.4 限流策略

平台类型	日配额	QPS 限制	说明
长视频平台	100万	500	高优先级，首页推荐内容高频校验
短视频平台	500万	2000	海量内容实时校验
AI 工具厂商	50万	200	生成环节嵌入校验
MCN 机构	10万	50	批量赋码辅助查询
跨境平台	20万	100	对接 MA 根解析通道

---

2.5 C2PA 水印 SDK

2.5.1 职责边界

• 在 AI 生成/编辑环节自动嵌入 C2PA 内容凭证（Content Credentials）。
• 凭证内容包含：模型版本、训练数据授权摘要、MA 标识片段（平台/机构代码+对象类目）。
• 支持跨工具、跨平台的 C2PA 水印读取与验证。
• 提供 Python / JavaScript / Go 多语言绑定。

2.5.2 SDK 架构

C2PA SDK (AIGC-Hub-SDK)
├── core/
│   ├── c2pa-rs/               # Rust 核心库，实现 C2PA 标准
│   ├── bindings/
│   │   ├── python/            # PyO3 绑定
│   │   ├── nodejs/            # N-API 绑定
│   │   └── go/                # CGO 绑定
│   └── manifest/
│       ├── manifest_builder.py  # C2PA Manifest 构建器
│       └── manifest_parser.py   # C2PA Manifest 解析器
├── ma-extension/
│   ├── embed_ma_fragment()     # 嵌入 MA 标识片段
│   ├── verify_ma_fragment()    # 验证 MA 标识片段
│   ├── extract_ma_fragment()   # 提取 MA 标识片段
│   └── ma_manifest_schema.json # MA 扩展 JSON Schema
├── ai-tool-adapters/
│   ├── adapter_comfyui.py      # ComfyUI 插件
│   ├── adapter_sd_webui.py     # Stable Diffusion WebUI 插件
│   ├── adapter_kling.py        # 可灵 AI 适配
│   ├── adapter_runway.py       # Runway 适配
│   ├── adapter_pika.py         # Pika 适配
│   └── adapter_midjourney.py   # Midjourney API 钩子
├── platform-plugins/
│   ├── plugin_douyin.js        # 抖音发布校验插件
│   ├── plugin_bilibili.js      # B站发布校验插件
│   ├── plugin_xiaohongshu.js   # 小红书发布校验插件
│   └── plugin_kuaishou.js      # 快手发布校验插件
└── cli/
    ├── aigc-hub-cli            # 命令行工具（创作者本地使用）
    └── embed.py / verify.py    # 脚本工具

2.5.3 C2PA Manifest 扩展字段（MA 片段）

{
  "claim_generator": "AIGC-Hub-SDK/1.0.0",
  "assertions": [
    {
      "label": "c2pa.training-mining",
      "data": {
        "entries": [
          {
            "description": "训练数据授权摘要",
            "source": "授权书哈希: 0x7f3e9a...",
            "scope": "commercial-use",
            "dataset_name": "开源数据集A + 授权数据集B",
            "license_type": "CC-BY-SA-4.0 + 商业授权"
          }
        ]
      }
    },
    {
      "label": "ma.avcc.fragment",
      "data": {
        "version": "1.0",
        "ma_root": "MA",
        "country_code": "156",
        "industry_node": "10005",
        "platform_node": "8361",
        "object_category": "10.1300200.AIGC",
        "content_generation_method": "AIGC",
        "model_name": "Stable-Diffusion-XL",
        "model_version": "v1.0",
        "model_provider": "Stability AI",
        "generation_timestamp": "2026-05-20T10:00:00Z",
        "generation_log_hash": "a1b2c3...",
        "manual_edit_ratio": 0.15,
        "sdk_version": "AIGC-Hub-SDK/1.0.0"
      }
    }
  ],
  "signature": {
    "alg": "ES256",
    "issuer": "AIGC-Hub-CA",
    "timestamp": "2026-05-20T10:00:05Z"
  }
}

2.5.4 SDK 集成示例（Python）

from aigc_hub_sdk import C2PAManifestBuilder, MAExtension

# 构建 C2PA Manifest + MA 扩展
builder = C2PAManifestBuilder(
    claim_generator="AIGC-Hub-SDK/1.0.0"
)

# 添加 MA 标识片段
ma_ext = MAExtension(
    platform_node="8361",
    object_category="10.1300200.AIGC",
    model_name="Stable-Diffusion-XL",
    model_version="v1.0",
    generation_log_hash="a1b2c3...",
    manual_edit_ratio=0.15
)
builder.add_assertion(ma_ext.to_c2pa_assertion())

# 添加训练数据授权信息
builder.add_training_assertion(
    dataset_name="开源数据集A",
    license_type="CC-BY-SA-4.0",
    source_hash="0x7f3e9a..."
)

# 嵌入到输出图片/视频
builder.embed("input.png", "output.png", signing_key=key)

# 验证
result = builder.verify("output.png")
assert result.valid
assert result.ma_fragment.platform_node == "8361"

---

2.6 创作者工作台（Creator Workbench）

2.6.1 职责边界

• 面向创作者/MCN 的一站式 SaaS 平台。
• 提供赋码申请、版权登记、分账查询、审核报告查看、多平台数据聚合、智能报税等功能。
• 支持 MCN 机构批量赋码、团队权限管理、子账号体系。

2.6.2 功能模块详表

模块	功能点	技术实现
赋码中心	提交作品、上传版权材料、查看审核进度、下载 AVCC 证书（PDF + 二维码）	大文件分片上传（OSS）、WebSocket 实时进度推送
版权登记	上传授权书、登记版权链、申请 MA 数据要素登记证书	表单引擎、文件哈希计算、链上交易状态轮询
分账查询	查看各平台播放数据、分账流水、收益提现、结算周期管理	数据聚合 API、图表可视化、提现申请工作流
审核报告	查看 AI 预审报告（违规帧定位、台词标红、时间轴导航）	视频播放器联动、时间轴组件、高亮标注
多平台聚合	绑定各平台账号（抖音/B站/快手/小红书），聚合播放量、收益、粉丝数据	OAuth 2.0 接入、定时数据同步、数据看板
智能报税	基于分账流水自动生成税务报表、发票管理、个税计算	规则引擎、PDF 报表生成、电子发票对接
MCN 管理	批量赋码、团队权限、子账号、收益汇总	RBAC 权限模型、批量任务队列

2.6.3 前端页面结构

/workbench
├── /dashboard              # 数据总览（待办赋码数、审核中、收益、最新通知）
├── /code
│   ├── /apply              # 赋码申请
│   ├── /status             # 赋码进度查询
│   └── /certificate        # AVCC 证书下载
├── /copyright
│   ├── /register           # 版权登记
│   └── /certificate        # 数据要素登记证书
├── /review
│   └── /reports            # 审核报告列表与详情
├── /finance
│   ├── /revenue            # 收益明细
│   ├── /settlement         # 结算记录
│   └── /withdraw           # 提现申请
├── /platforms
│   └── /connect            # 平台账号绑定
├── /tax
│   └── /reports            # 税务报表
└── /settings
    ├── /profile            # 个人/企业信息
    ├── /team               # MCN 团队管理（企业用户）
    └── /api-keys           # API 密钥管理

---

2.7 跨平台清算引擎（Cross-platform Settlement Engine）

2.7.1 职责边界

• 按智能合约执行跨平台分账结算（版权主链合约触发）。
• 管理用户权益通兑（购买记录跨平台解锁验证）。
• 生成版权估值报告，支撑 ABS 发行等金融衍生服务。
• 对接银行/支付机构，完成法币结算。

2.7.2 分账结算模型

用户支付 10 元
    │
    ├── 平台抽成 30% ────────→ 3.00 元 (首发/播放平台)
    │
    ├── 广电云清算服务费 6% ──→ 0.60 元 (AIGC-Hub 技术服务费)
    │
    └── 内容分成池 64% ───────→ 6.40 元
            │
            ├── 创作者分成 40% ─→ 4.00 元
            ├── 模型方分成 15% ─→ 1.50 元
            ├── IP 方分成 10% ──→ 1.00 元
            └── 平台运营 9% ───→ 0.90 元 (内容运营/推广成本)

2.7.3 清算周期

结算类型	周期	触发条件	链上确认方式
日结	T+1	播放数据日汇总	联盟链日结批处理
周结	T+7	周累计 GMV > 阈值	联盟链周结批处理
月结	T+30	月度对账	联盟链月结 + 法币转账
实时结算	即时	用户购买行为	链上实时记录 + 定期归集

2.7.4 版权估值模型

估值维度	权重	数据来源
播放量	30%	ClickHouse 播放数据
完播率	20%	平台回传数据
分账流水	25%	链上结算记录
用户评分	10%	平台评分聚合
合规评分	10%	审核引擎综合评分
模型认证加分	5%	白名单模型额外加成

// 伪代码：版权估值计算（清算引擎 - Go 实现）
func EvaluateCopyrightValue(avcc string) (map[string]interface{}, error) {
    metrics := map[string]float64{
        "total_plays":        clickhouse.QueryMetric(avcc, "plays"),
        "completion_rate":    clickhouse.QueryMetric(avcc, "completion_rate"),
        "settlement_history": chain.QuerySettlementScore(avcc),
        "user_rating":        platformAPI.AggregateRating(avcc),
        "compliance_score":   reviewDB.GetScore(avcc),
        "model_certified":    0.0,
    }
    
    if modelRegistry.IsCertified(avcc) {
        metrics["model_certified"] = 1.0
    }
    
    valueScore := 
        metrics["total_plays"] * 0.30 +
        metrics["completion_rate"] * 0.20 +
        metrics["settlement_history"] * 0.25 +
        metrics["user_rating"] * 0.10 +
        metrics["compliance_score"] * 0.10 +
        metrics["model_certified"] * 0.05
    
    confidence := "medium"
    if metrics["total_plays"] > 100000 {
        confidence = "high"
    }
    
    return map[string]interface{}{
        "avcc":                avcc,
        "valuation_score":     valueScore,
        "estimated_value_cny": valueScore * 1000,  // 估值映射
        "confidence":          confidence,
        "report_url":          fmt.Sprintf("https://aigc-hub.cn/valuation/%s", avcc),
    }, nil
}

---

上一章：01-总体技术架构.md
下一章：03-数据库与数据模型.md