CSlawyer1985/legal-skillhub / skills/ad-compliance-review-wuxue20260207
ad-compliance-review
Verified广告公司 AI 合规审查。基于客户品牌调性与违禁词库,对广告/营销文案做合规风险审查(广告法违禁词、绝对化用语、医疗功效暗示、平台限制、品牌调性冲突)并给出修改建议。当用户需要审查广告文案、排查违禁词、做品牌合规检查,或广告/营销公司要为客户提供"上线前合规闸"服务时使用。也适用于把合规审查封装成可售卖的 AI 功能。
| File | Kind | Size |
|---|---|---|
| CHANGELOG.md | markdown | 7.6 KB |
| EVALUATION.md | markdown | 2.2 KB |
| PUBLISH_NOTES.md | markdown | 3.2 KB |
| SKILL.md | skill md | 18.0 KB |
| _meta.json | config | 106 B |
| _skillhub_meta.json | config | 142 B |
| config.example.json | config | 747 B |
| references/ad_agency_kb.md | markdown | 2.6 KB |
| sample_data/demo_client/banned_words.md | markdown | 615 B |
| sample_data/demo_client/brand.md | markdown | 603 B |
| sample_data/demo_client/cases.md | markdown | 561 B |
| sample_data/demo_docs/sample_ads.txt | markdown | 698 B |
| scripts/generate_report.py | script | 13.2 KB |
| scripts/review.py | script | 13.8 KB |
| scripts/webapp.py | script | 14.5 KB |
scripts/webapp.py
View on GitHub#!/usr/bin/env python3
"""
广告公司 AI 合规审查 —— 在线自助提交页(零依赖,纯标准库)
客户自己打开网页 → 上传历史文案目录(或粘贴) → 自动生成合规体检报告。
完全自助、零获客人力,是天然的获客钩子。
用法:
python scripts/webapp.py [--port 8000]
浏览器打开 http://127.0.0.1:8000
实现:复用 review.py(审查核心)与 generate_report.py(报告渲染),不引入任何第三方依赖。
"""
import os
import sys
import html
import json
import argparse
from http.server import BaseHTTPRequestHandler, HTTPServer
BASE = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
CLIENT = os.path.join(BASE, "sample_data", "demo_client")
ACTIVE_CLIENT = CLIENT # 实际生效的客户词库目录(main 中按 --client 覆盖)
MAX_BODY = 3 * 1024 * 1024 # 单次提交上限 3 MB,超过给出明确提示
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
from review import load_client_terms, validate_client_dir # noqa: E402
from generate_report import analyze, build_html, esc # noqa: E402
esc = html.escape # 兼容别名
def friendly_error_html(title, cause, fix):
"""生成面向普通用户的友好错误页(可直接在 iframe 内渲染)。"""
return f"""<!doctype html>
<html lang="zh-CN"><head><meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>提交遇到问题</title></head>
<body style="margin:0;background:#f4f6f9;font-family:-apple-system,Segoe UI,Roboto,Helvetica,Arial,sans-serif;color:#1f2d3d;">
<div style="max-width:760px;margin:0 auto;padding:32px 20px;">
<div style="height:6px;background:#E24B4A;border-radius:4px;"></div>
<h1 style="font-size:20px;margin:18px 0 4px;">提交遇到问题</h1>
<div style="background:#fff;border:1px solid #f3c9c9;border-radius:12px;padding:20px;margin-top:16px;">
<div style="font-size:15px;font-weight:700;color:#a32d2d;">{esc(title)}</div>
<div style="font-size:13px;color:#5f5e5a;margin-top:10px;line-height:1.8;"><b>可能原因:</b><br>{esc(cause)}</div>
<div style="font-size:13px;color:#36506e;margin-top:12px;line-height:1.8;background:#eef4fd;border-left:4px solid #378ADD;padding:10px 14px;border-radius:6px;"><b>建议操作:</b><br>{esc(fix)}</div>
</div>
<button onclick="history.back()" style="margin-top:16px;border:1px solid #378ADD;background:#378ADD;color:#fff;border-radius:10px;padding:11px 18px;font-size:14px;cursor:pointer;">返回重新提交</button>
</div></body></html>"""
PAGE = """<!doctype html>
<html lang="zh-CN"><head><meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>广告文案合规体检 · 在线提交</title></head>
<body style="margin:0;background:#f4f6f9;font-family:-apple-system,Segoe UI,Roboto,Helvetica,Arial,sans-serif;color:#1f2d3d;">
<div style="max-width:760px;margin:0 auto;padding:32px 20px;">
<div style="height:6px;background:linear-gradient(90deg,#378ADD,#1D9E75);border-radius:4px;"></div>
<h1 style="font-size:22px;margin:18px 0 4px;">广告文案合规体检</h1>
<div style="color:#5f5e5a;font-size:13px;">上传贵司历史文案,一键生成合规风险报告(基于《广告法》通用红线)</div>
<div style="background:#fff;border:1px solid #e6ebf2;border-radius:12px;padding:20px;margin-top:18px;">
<label style="display:block;font-size:13px;font-weight:600;margin-bottom:6px;">客户 / 公司名称</label>
<input id="name" placeholder="如:星澜美妆" style="width:100%;box-sizing:border-box;padding:10px;border:1px solid #cfd8e3;border-radius:8px;font-size:14px;">
<label style="display:block;font-size:13px;font-weight:600;margin:16px 0 6px;">上传文案目录 / 文件</label>
<input id="files" type="file" multiple webkitdirectory
style="width:100%;box-sizing:border-box;padding:8px;border:1px dashed #cfd8e3;border-radius:8px;background:#fafbfc;font-size:13px;color:#5f5e5a;">
<div style="font-size:12px;color:#9aa7b8;margin-top:6px;">支持选择整个文件夹(.txt / .md,每行一条文案);也可手动多选文件。</div>
<div style="font-size:13px;font-weight:600;margin:16px 0 6px;">或粘贴文案(每行一条)</div>
<textarea id="paste" rows="5" placeholder="星澜精华是市面上最好用的修护产品,治疗各类肌肤问题,全网最低价!"
style="width:100%;box-sizing:border-box;padding:10px;border:1px solid #cfd8e3;border-radius:8px;font-size:13px;resize:vertical;"></textarea>
<button id="go" style="margin-top:16px;width:100%;border:0;background:#378ADD;color:#fff;
border-radius:10px;padding:13px;font-size:15px;font-weight:600;cursor:pointer;">生成合规体检报告</button>
<div id="msg" style="font-size:13px;margin-top:10px;min-height:18px;"></div>
</div>
<div id="result" style="margin-top:22px;"></div>
<div style="font-size:11px;color:#9aa7b8;margin-top:24px;text-align:center;">
本报告由 AI 合规体检工具自动生成 · 免费版使用通用广告法基线,接入贵司专属词库请与我们联系。
</div>
</div>
<script>
function collectDocs() {
var docs = [];
var skipped = 0;
var files = document.getElementById('files').files;
var promises = [];
for (var i = 0; i < files.length; i++) {
var f = files[i];
if (!/\\.(txt|md)$/i.test(f.name)) { skipped++; continue; }
(function(file){
promises.push(file.text().then(function(t){
docs.push({src: file.name, text: t});
}).catch(function(){ skipped++; })); // 单个文件读取出错不阻断整体提交
})(f);
}
return Promise.all(promises).then(function(){
var paste = document.getElementById('paste').value.trim();
if (paste) {
paste.split(/\\n|\\r\\n|\\r/).forEach(function(line){
line = line.trim();
if (line) docs.push({src: '粘贴文案', text: line});
});
}
return {docs: docs, skipped: skipped};
});
}
document.getElementById('go').onclick = function(){
var msg = document.getElementById('msg');
var result = document.getElementById('result');
var name = document.getElementById('name').value || '贵司';
msg.style.color = '#378ADD';
msg.textContent = '正在扫描文案,请稍候…(大目录可能需要几秒)';
result.innerHTML = '';
collectDocs().then(function(res){
var docs = res.docs, skipped = res.skipped;
if (!docs.length) {
msg.style.color = '#E24B4A';
msg.textContent = skipped > 0
? '未发现可分析的文案:所选文件中没有 .txt/.md 文本,或文件读取失败。请确认文件类型,或直接在文本框粘贴文案(每行一条)。'
: '未找到可分析的文案:请上传 .txt/.md 文件,或直接在下方文本框粘贴(每行一条)。';
return;
}
fetch('/analyze', {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({name: name, docs: docs})
}).then(function(r){
return r.text().then(function(html){
msg.style.color = r.ok ? '#1D9E75' : '#E24B4A';
msg.textContent = r.ok
? (skipped > 0 ? '报告已生成 ✓(已跳过 ' + skipped + ' 个不支持的文件)' : '报告已生成 ✓')
: '已收到请求,但服务返回了提示,请查看下方说明。';
var box = document.createElement('div');
box.style.cssText = 'border:1px solid #e6ebf2;border-radius:12px;overflow:hidden;background:#fff;';
var bar = document.createElement('div');
bar.style.cssText = 'padding:10px 14px;background:#f7f9fc;border-bottom:1px solid #e6ebf2;display:flex;gap:10px;';
var dl = document.createElement('button');
dl.textContent = '下载报告 (HTML/PDF)';
dl.style.cssText = 'border:1px solid #378ADD;background:#378ADD;color:#fff;border-radius:8px;padding:8px 14px;font-size:13px;cursor:pointer;';
dl.onclick = function(){
var b = new Blob([html], {type:'text/html'});
var a = document.createElement('a');
a.href = URL.createObjectURL(b);
a.download = name + '_合规体检报告.html';
a.click();
};
bar.appendChild(dl);
var ifr = document.createElement('iframe');
ifr.srcdoc = html;
ifr.style.cssText = 'width:100%;height:1000px;border:0;display:block;';
box.appendChild(bar);
box.appendChild(ifr);
result.appendChild(box);
});
});
}).catch(function(){
msg.style.color = '#E24B4A';
msg.textContent = '无法连接到合规体检服务。请确认服务正在运行(已执行 python webapp.py 且无报错),或检查网络后重试。';
});
};
</script>
</body></html>"""
def run_analysis(name, docs):
"""docs: [(src, text), ...] -> 报告 HTML 或 None"""
if not docs:
return None
terms = load_client_terms(ACTIVE_CLIENT)
results, level_count, cat_count, term_count = analyze(docs, terms)
return build_html(name, results, level_count, cat_count, term_count, top=10)
class Handler(BaseHTTPRequestHandler):
def _send(self, code, ctype, body):
if isinstance(body, str):
body = body.encode("utf-8")
self.send_response(code)
self.send_header("Content-Type", ctype)
self.send_header("Content-Length", str(len(body)))
self.end_headers()
self.wfile.write(body)
def do_GET(self):
if self.path in ("/", "/index", "/index.html"):
self._send(200, "text/html; charset=utf-8", PAGE)
else:
self._send(404, "text/plain; charset=utf-8", "not found")
def do_POST(self):
if self.path == "/analyze":
try:
raw = self.headers.get("Content-Length", "")
try:
n = int(raw) if raw.strip() else 0
except ValueError:
self._send(200, "text/html; charset=utf-8",
friendly_error_html("提交数据长度异常",
"请求头中的内容长度无法识别(可能被网络代理截断或浏览器异常)。",
"请刷新页面后重试;若仍失败,多为网络中断,请检查连接后重试。"))
return
if n == 0:
self._send(200, "text/html; charset=utf-8",
friendly_error_html("未收到任何内容",
"浏览器没有把文案数据发送过来。",
"请重新选择文件或粘贴文案后再点击「生成合规体检报告」。"))
return
if n > MAX_BODY:
self._send(200, "text/html; charset=utf-8",
friendly_error_html("提交内容过大",
f"本次上传约 {n // 1024} KB,超过了单次 {MAX_BODY // 1024 // 1024} MB 的上限。",
"请分批次上传,或先清理超大文件(如整本书、长日志、压缩包内的文本)。"))
return
body = self.rfile.read(n)
try:
data = json.loads(body or b"{}")
except json.JSONDecodeError:
self._send(200, "text/html; charset=utf-8",
friendly_error_html("提交数据格式错误",
"浏览器发送的数据不是有效的格式(非标准 JSON)。",
"请刷新页面后重试;若使用旧版浏览器,建议更换为最新版 Chrome / Edge。"))
return
name = (data.get("name") or "贵司").strip()
docs = [
(str(d.get("src", "")), str(d.get("text", "")))
for d in data.get("docs", [])
if str(d.get("text", "")).strip()
]
if not docs:
self._send(200, "text/html; charset=utf-8",
friendly_error_html("没有可分析的文案",
"收到的内容里没有可识别的文案(仅支持 .txt / .md,且内容不能为空)。",
"请确认文件为 .txt 或 .md 文本;或直接在下方文本框粘贴文案(每行一条),再点生成。"))
return
try:
html = run_analysis(name, docs)
except Exception as e:
self._send(200, "text/html; charset=utf-8",
friendly_error_html("分析过程出现异常",
f"系统在扫描文案时出错:{esc(str(e))[:200]}",
"请尝试:① 去掉可疑文件后重试;② 分批上传;③ 直接粘贴文案。如持续出现,请联系我们并附上出错的文案。"))
return
self._send(200, "text/html; charset=utf-8", html)
except Exception as e:
self._send(200, "text/html; charset=utf-8",
friendly_error_html("服务处理失败",
f"服务未预期地中断:{esc(str(e))[:200]}",
"请稍后重试;若反复出现,请重启服务(重新运行 python webapp.py)或联系我们。"))
else:
self._send(404, "text/plain; charset=utf-8", "not found")
def log_message(self, *a):
pass
def main():
ap = argparse.ArgumentParser(description="合规体检在线提交页")
ap.add_argument("--port", type=int, default=8000, help="监听端口")
ap.add_argument("--client", default=None,
help="客户资料目录(含 banned_words.md / brand.md);缺省用内置 demo_client")
args = ap.parse_args()
# 显式校验客户目录:与 review.py / generate_report.py 行为一致
# 致命(不存在/非目录)-> 报错退出;目录存在但缺词表 -> 警告后回退内置基线
client_dir = args.client or CLIENT
ok, msg = validate_client_dir(client_dir)
if not ok:
print("【错误】" + msg, file=sys.stderr)
sys.exit(2)
if msg:
print(msg, file=sys.stderr)
global ACTIVE_CLIENT
ACTIVE_CLIENT = client_dir
print(f"合规体检在线页已启动: http://127.0.0.1:{args.port} (Ctrl+C 停止)")
print(f"当前使用客户词库: {client_dir}")
HTTPServer(("0.0.0.0", args.port), Handler).serve_forever()
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |