[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-92660":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":14,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":16,"rankGlobal":9,"rankLanguage":9,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":9,"pushedAt":9,"updatedAt":22,"readmeContent":23,"aiSummary":24,"trendingCount":14,"starSnapshotCount":14,"syncStatus":25,"lastSyncTime":26,"discoverSource":27},92660,"traffic-compass","code-wahaha\u002Ftraffic-compass","code-wahaha","抖音作品发布前的 AI 合规自查 + 流量潜力评分工具（DeepSeek 审核大脑 + 规则引擎）",null,"Python",63,14,51,0,6,44.13,"MIT License",false,"main",true,[],"2026-07-22 04:02:06","# 流量罗盘 · Traffic Compass\n\n**中文** | [English](.\u002FREADME.en.md)\n\n> 抖音作品发布前的 **AI 合规自查 + 流量潜力评分** 工具。\n> 粘贴你的口播文案 → 一键查出违规风险、给出最小改动建议、并按赛道权重打出\"流量潜力分\"。\n\n发抖音最怕两件事：**违规限流**、**辛苦做了没流量**。流量罗盘在你点\"发布\"之前先帮你过一遍：\n\n- 🛡 **违规自查**：广告法极限词、绝对化用语、引流导流、封建迷信、AI 能力夸大\u002F焦虑营销、医疗\u002F金融\u002F法律\u002F教育资质红线……读语境判断，**不见词就杀**（\"我妈是最好的人\"不会被误报）。\n- ✍️ **最小改动建议**：只换违规的那几个词，**保留你的口语腔和节奏**，不把你的话改成 AI 腔。\n- 📈 **流量潜力评分**：满分 100，按 AI 口播赛道权重打分（**收藏价值 28% + 开头钩子 20%** 为核心），指出最该补的短板。\n- 💬 **追问改写**：出报告后还能继续问\"为什么会限流\"\"帮我把开头改强一点\"。\n\n> ⚠️ 合规判定是**参考**不是法律意见；流量潜力是**文案维度**的估算（不含画面\u002F封面\u002F口播节奏\u002F发布时间\u002F账号权重），**不承诺播放量**。\n\n---\n\n## 两种用法\n\n### A. Web 应用（`webapp\u002F`）\n一个 FastAPI 后端 + 单文件聊天前端，本地或服务器都能跑。**只需一个 DeepSeek Key 即可使用核心功能。**\n\n### B. Claude Code 技能（`skill\u002F`）\n把审核规则做成可装的 Agent 技能，在 Claude Code 里说\"帮我自查这条抖音\"即可触发，规则数据在 `skill\u002Freferences\u002F`。\n\n---\n\n## 快速开始（Web 应用）\n\n```bash\ncd webapp\npip install -r requirements.txt\n\n# 配置 DeepSeek Key（二选一）：\n#  1) 复制 _data\u002Fapikeys.example.json 为 _data\u002Fapikeys.json 并填入\n#  2) 或设环境变量 DEEPSEEK_KEY=你的密钥\ncp _data\u002Fapikeys.example.json _data\u002Fapikeys.json   # 然后编辑填 key\n\npython app.py\n# 打开 http:\u002F\u002F127.0.0.1:8900\n```\n\n默认是**文字粘贴模式**（无需任何 cookie）。把口播文案贴进去就能用。\n\n---\n\n## 配置说明\n\n| 变量 | 必填 | 用途 |\n|---|---|---|\n| `DEEPSEEK_KEY` | ✅ | 审核大脑（纠错 + 语境违规 + 流量评分） |\n| `DEEPSEEK_MODEL` | 否 | 默认 `deepseek-v4-flash`（快省）；`deepseek-v4-pro` 更准更慢 |\n| `BAILIAN_KEY` | 否 | 仅\"链接提取\"用（阿里云百炼 ASR 语音转文字） |\n| `DISABLE_EXTRACT` | 否 | 设 `1` 关闭链接提取，只用文字模式（无 cookie 时建议） |\n| `DOUYIN_COOKIE_BASE` | 否 | 链接提取用的抖音登录态 cookie 基目录 |\n\n> **链接提取（抖音链接 → 文字）是可选高级功能**，需要三样：① DeepSeek Key ② 百炼 Key ③ **你自己的抖音登录**——界面右下角有「抖音登录」小按钮，点了弹出抖音页面、手机扫码即可，登录 cookie 只存在你本机 `_data\u002Fchrome_data\u002F`，不会上传给任何人。另需安装 `playwright`（`playwright install chromium`）。不配这些也完全不影响核心的文案自查。\n\n---\n\n## 项目结构\n\n```\n流量罗盘-开源\u002F\n├── webapp\u002F                  # Web 应用（FastAPI + 单文件前端）\n│   ├── app.py               # 后端路由：\u002Fapi\u002Faudit \u002Fapi\u002Fchat \u002Fapi\u002Fextract \u002Fapi\u002Fplatforms\n│   ├── llm.py               # DeepSeek 调用（审核大脑 + 追问改写）\n│   ├── audit_skill.md       # ⭐核心：喂给 DeepSeek 的审核系统提示词（改规则改这里）\n│   ├── engine.py            # 确定性规则引擎（违禁词召回网 + 防误杀 + 评分）\n│   ├── extract.py           # 可选：抖音链接 → 文字（playwright + 百炼 ASR）\n│   ├── config.py            # key\u002F模型配置（env 优先）\n│   ├── rules\u002Fdouyin.json    # 抖音规则包（加平台 = 仿此再放一个 json）\n│   ├── static\u002Findex.html    # 深色聊天 UI（单文件）\n│   └── _data\u002Fapikeys.example.json\n├── skill\u002F                   # Claude Code 技能版（同一套规则）\n│   ├── SKILL.md\n│   ├── references\u002F          # 违禁词库 \u002F 白名单 \u002F AI标注与资质 \u002F 预测模型\n│   └── scripts\u002Flog_record.py\n├── docs\u002F                    # 规则手册来源、设计文档、测试样例\n├── .env.example\n└── LICENSE                  # MIT\n```\n\n---\n\n## 工作原理\n\n```\n口播文案\n  → engine.py 代码预扫（确定性\"必查名单\"召回网，防漏看）\n  → DeepSeek（带 audit_skill.md 审核大脑）：纠错 + 语境违规复核 + 流量潜力评分\n  → 结构化报告（纠错原文 \u002F 违规清单 \u002F 亮点 \u002F 改进 \u002F 七维评分）\n  → 可继续 \u002Fapi\u002Fchat 追问、改写\n```\n\n**两层把关**：代码引擎负责\"宁可多列\"的召回（不漏），DeepSeek 负责\"读语境\"的精判（不误杀）。\n\n---\n\n## 扩展到其他平台（如小红书）\n\n1. 仿 `webapp\u002Frules\u002Fdouyin.json` 写一份 `rules\u002Fxiaohongshu.json`（设 `\"enabled\": true`）。\n2. 在 `audit_skill.md` 补充该平台的特有规则。\n3. 前端下拉自动出现，无需改代码。\n\n---\n\n## 免责声明\n\n本项目仅为**创作者自查辅助工具**。合规判定基于公开平台规则整理，**不构成法律意见**；平台规则随时变化，请以官方最新规则为准。流量潜力为基于经验与文案维度的**估算**，实际表现受画面、封面、发布时机、账号权重等大量变量影响，**不对任何播放\u002F收益结果做承诺**。\n\n## 开源协议\n\n[MIT](.\u002FLICENSE) © code-wahaha\n","流量罗盘（Traffic Compass）是一款面向抖音创作者的开源文案合规与流量潜力评估工具。它结合确定性规则引擎与 DeepSeek 大模型，提供发布前的违规风险识别（支持语境判断，避免误报）、最小化修改建议、以及基于赛道权重的流量潜力评分（如收藏价值、开头钩子等维度）。项目采用 FastAPI 构建 Web 应用，支持本地部署，仅需 DeepSeek API Key 即可运行；同时提供 Claude Code 技能插件版本。适用于短视频口播文案的预审优化场景，尤其适合中腰部创作者快速自查文案合规性与传播适配度。",2,"2026-07-10 02:30:06","CREATED_QUERY"]