Content Validator

三层内容验证系统 (Content Validator)

概述

对内容进行三层验证，确保符合平台要求和质量标准。

调用 Python 模块

from src.utils.validation import ValidationSystem, validate_content

# 方式1: 使用类（完整控制）
validator = ValidationSystem()
passed, results = validator.validate_all(
    content,
    platform="weixin",
    title="文章标题",
    images=["cover.png"]
)

if passed:
    print("✅ 所有验证通过")
else:
    for layer_name, result in results.items():
        if not result.passed:
            print(f"❌ {layer_name}: {result.issues}")

# 方式2: 使用便捷函数
passed, results = validate_content(content, platform="xiaohongshu")

# 获取验证摘要
summary = validator.get_validation_summary(results)
print(f"通过率: {summary['pass_rate']:.1f}%")
print(f"错误: {summary['errors']}")
print(f"警告: {summary['warnings']}")

三层验证架构

Layer 1: 长文本验证

验证文章的基本结构：

# Layer 1 验证结果示例
results["layer1"] = ValidationResult(
    layer="长文本验证",
    passed=True,
    checks=[
        CheckResult(name="字数检查", passed=True, level=INFO, message="字数合格：3800字"),
        CheckResult(name="章节结构", passed=True, level=INFO, message="章节结构良好：7章"),
        CheckResult(name="AI连接词密度", passed=True, level=INFO, message="AI连接词密度合格：1.2%"),
    ]
)

Layer 2: 平台内容验证

根据不同平台的要求进行验证：

平台限制配置

# 平台配置
PLATFORM_LIMITS = {
    "xiaohongshu": {
        "title_max": 20,
        "body_max": 1000,
        "body_min": 100,
    },
    "twitter": {
        "body_max": 280,
        "body_min": 10,
    },
    "weixin": {
        "title_max": 64,
        "body_min": 3500,
        "body_max": 8000,
    },
    "zhihu": {
        "title_max": 50,
        "body_min": 500,
    },
}

Layer 3: 发布前验证

检查图片、链接等资源：

验证级别

class ValidationLevel(Enum):
    ERROR = "error"      # 必须修复，否则无法通过
    WARNING = "warning"  # 建议修复，不影响通过
    INFO = "info"        # 提示信息

处理逻辑

# ERROR: 阻止发布
if check.level == ValidationLevel.ERROR and not check.passed:
    result.passed = False
    result.issues.append(check.message)

# WARNING: 仅提示
elif check.level == ValidationLevel.WARNING and not check.passed:
    result.suggestions.append(check.message)

使用示例

完整验证流程

from src.utils.validation import ValidationSystem

validator = ValidationSystem()

# 验证微信文章
content = open("article.md").read()
passed, results = validator.validate_all(
    content=content,
    platform="weixin",
    title="AI技术深度解析",
    images=["cover.png", "diagram.png"]
)

# 打印结果
print(f"验证结果: {'通过' if passed else '未通过'}")

for layer_name, result in results.items():
    print(f"\n{result.layer}:")
    for check in result.checks:
        status = "✅" if check.passed else "❌"
        print(f"  {status} {check.name}: {check.message}")

平台特定验证

# 小红书验证（重点：字数和emoji）
passed, results = validator.validate_all(content, platform="xiaohongshu")

# Twitter验证（重点：280字符限制）
passed, results = validator.validate_all(content, platform="twitter")

# 知乎验证（重点：深度和专业性）
passed, results = validator.validate_all(content, platform="zhihu")

自定义平台限制

# 添加自定义平台
custom_limits = {
    "my_blog": {
        "title_min": 10,
        "title_max": 100,
        "body_min": 1000,
        "body_max": 20000,
    }
}

validator = ValidationSystem(custom_limits=custom_limits)
passed, results = validator.validate_all(content, platform="my_blog")

验证报告示例

# 获取验证摘要
summary = validator.get_validation_summary(results)

# 输出:
{
    "total_checks": 12,
    "passed_checks": 10,
    "pass_rate": 83.3,
    "all_passed": False,
    "errors": [
        "[长文本验证] 字数不足：当前2800字，最低要求3000字"
    ],
    "warnings": [
        "[平台验证(xiaohongshu)] emoji使用较少：2个，小红书推荐使用emoji",
        "[平台验证(weixin)] 建议添加文章摘要或导语"
    ]
}

与去AI化模块联动

from src.utils.deai import DeAIAgent
from src.utils.validation import ValidationSystem

# 1. 先验证
validator = ValidationSystem()
passed, results = validator.validate_all(content, platform="weixin")

# 2. 如果AI连接词密度过高，进行去AI化
ai_check = next(
    (c for c in results["layer1"].checks if c.name == "AI连接词密度"),
    None
)

if ai_check and ai_check.details.get("density", 0) > 3:
    agent = DeAIAgent()
    content, report = agent.humanize(content, platform="weixin")
    print(f"已进行去AI化处理: {report.original_ai_score}% → {report.final_ai_score}%")

    # 3. 重新验证
    passed, results = validator.validate_all(content, platform="weixin")

注意事项

1. 验证顺序: 建议先 Layer 1 → Layer 2 → Layer 3
2. 平台优先: Layer 2 的平台限制会覆盖 Layer 1 的通用标准
3. 图片检查: Layer 3 需要提供图片列表才能完整验证
4. 错误处理: ERROR 级别的问题必须修复，WARNING 级别可酌情处理
5. 多次验证: 内容修改后应重新验证

Created: 2026-02-14 Version: 1.0 Dependencies: src/utils/validation/, src/utils/deai/