PublishGuard — 发布验证与平台凭证管理器

版本： 1.0.0
作者： Aoineco & Co.
许可证： MIT
标签： publish, verify, 404-prevention, credentials, multi-platform, community

简介

防止 AI 智能体在内容实际未发布到目标平台时，错误报告“已成功发布！”；内置持久化凭证存储，可在会话重置后保留。

智能体最常撒的谎： “我已发布！链接在此：[404]”

问题

AI 智能体普遍存在以下问题：

1. 报告发布成功，但用户访问链接时返回 404
2. HTTP 状态码为 200，但平台 静默拒绝了内容
3. 会话重置后 遗忘登录方式（如认证方法、所需请求头等）
4. 忽略 平台特有要求（例如 BotMadang 要求标题必须含韩文）
5. 触发 速率限制 却不知需等待

特性

预配置平台

使用方法

from publish_guard import PublishGuard

pg = PublishGuard()

# 1. 读取平台指南（每次会话重置后都必须执行！）
print(pg.get_platform_guide("botmadang"))

# 2. 发布前校验内容
valid, issues = pg.validate_content("botmadang", {
    "title": "안녕하세요 새로운 스킬 소개",  # 韩文为必需！
    "content": "TokenGuard는 429 에러를 방지합니다."
})

# 3. 检查速率限制
can_post, wait = pg.check_rate_limit("botmadang")
if not can_post:
    time.sleep(wait)

# 4. [通过 API / 浏览器执行发布操作]

# 5. 验证 —— 最关键的一步
result = pg.verify_post(
    url="https://botmadang.net/post/12345",
    platform="botmadang",
    expected_content="TokenGuard"
)

if result.verified:
    print("✅ 实际已发布！")
    pg.record_post("botmadang", url, verified=True)
else:
    print(f"🔴 失败：{result.diagnosis}")
    print(f"💡 建议修复：{result.retry_suggestion}")

核心规则

╔══════════════════════════════════════════════════════════╗
║  绝不可在未调用 verify_post() 前，向用户报告“已成功发布” ║
║                                                         ║
║  若 verify_post() 返回 verified=False，                  ║
║  必须告知用户失败，并展示诊断信息。                    ║
╚══════════════════════════════════════════════════════════╝

🔐 加密凭证保险库

API 密钥与令牌 永不以明文形式存储。PublishGuard 内置 VaultCrypto 加密引擎：

• PBKDF2-HMAC-SHA256 密钥派生（200,000 次迭代）
• HMAC-SHA256 CTR 流式加密（Encrypt-then-MAC）
• 机器绑定加密 —— 保险库文件仅能在创建它的机器上解密
• 文件权限锁定 为 0600（仅所有者可读写）
• 安全删除 —— 明文原始数据在删除前被随机字节覆写

即使他人将 .vault 文件复制到其他机器，也无法解密，因其依赖原始机器的指纹（主机名 + 用户名 + workspace 路径）。

from vault_crypto import EncryptedVault

vault = EncryptedVault()
vault.set("botmadang", "token", "your-api-key")  # 立即以加密形式落盘
key = vault.get("botmadang", "token")             # 仅在内存中解密

迁移现有明文凭证：

python3 vault_crypto.py migrate /path/to/plaintext_creds.json
# → 创建加密版 .vault，同时安全删除明文文件

文件结构

publish-guard/
├── SKILL.md                # 当前文件
└── scripts/
    ├── publish_guard.py    # 主引擎（零外部依赖）
    └── vault_crypto.py     # 加密凭证存储模块

审计日志

发布与验证记录将写入：

memory/publish_audit/posts_YYYY-MM-DD.jsonl
memory/publish_audit/verify_YYYY-MM-DD.jsonl

零依赖

纯 Python 3.10+ 实现，无需 pip install。 仅使用标准库 urllib 执行 HTTP 验证。 专为 $7 Bootstrap Protocol 设计 —— 每一个字节都至关重要。