🎵 Douyin Comment CLI

抖音评论运营 CLI 工具。基于 Bridge Framework（Bridge Server + 油猴脚本），支持视频搜索、评论获取、AI 人格化回复、行为模拟、运营仪表盘。

核心亮点：内置反检测引擎 — 人格化回复 + 随机延迟 + 请求参数随机化 + 浏览行为模拟，让自动化操作更像真人。

✨ 核心功能

🚀 快速开始

npm install

# 1. 复制配置
cp config.example.json config.json
# 编辑 config.json：填入 bridge.token 和 llm.api_key

# 2. 启动 Bridge Server
node server.js

# 3. Chrome 安装油猴脚本 scripts/douyin.user.js
#    打开 douyin.com 并登录

# 4. 验证连接
node cli.js my

# 5. 开始使用
node cli.js my
node cli.js search "关键词"
node cli.js get <aweme_id> --pages 1 --count 5
node cli.js suggest <aweme_id> --auto

🤖 AI 人格化回复

7 种内置人格自动轮换，每条评论风格不同：

使用：

# 生成建议（不发布，看风格）
node cli.js suggest <aweme_id>

# 自动发布（人格轮换 + 随机延迟 + 浏览穿插）
node cli.js suggest <aweme_id> --auto

# 调试模式（跳过所有延迟）
node cli.js suggest <aweme_id> --fast

🎭 行为模拟（browse）

模拟真实用户浏览行为，解决"只发不看"的账户不对称检测：

# 随机搜索热门词 → 看 1-2 个视频 → 偶尔点赞评论
node cli.js browse --max-notes 2 --like-chance 0.2

# 指定关键词浏览
node cli.js browse 穿搭 美食 --max-notes 3

suggest --auto 已内置 browse 穿插：每发约 5 条评论自动穿插一次浏览+点赞。

🎲 请求参数随机化

抖音油猴脚本内置多项反检测参数随机化：

📋 命令清单

核心操作

AI 与运营

反馈闭环（SQLite 记忆层）

⚙️ 配置

config.json（从 config.example.json 复制）：

{
  "bridge": {
    "host": "127.0.0.1",
    "port": 19422,
    "token": "your-bridge-token"
  },
  "llm": {
    "api_key": "sk-...",
    "base_url": "https://api.openai.com/v1",
    "model": "gpt-4o-mini",
    "max_tokens": 4096,
    "timeout_ms": 60000,
    "max_retries": 3
  }
}

环境变量（优先级更高）：

export OPENAI_API_KEY="sk-..."
export OPENAI_BASE_URL="https://..."
export OPENAI_MODEL="gpt-4o-mini"

🏗️ 架构

CLI (cli.js) → HTTP/WS → Bridge Server (:19422) → 油猴脚本 → 页面 fetch → 抖音 API

签名安全：油猴脚本在页面上下文执行，使用页面原生 fetch，自动携带真实 Cookie 和签名。

新增反检测模块：

• lib/jitter.js — 人类行为延迟工具库
• lib/personas.js — 7 种人格模板池
• lib/commands/browse.js — 模拟浏览行为

🛡️ 反检测设计

📁 项目结构

douyin-cli/
├── cli.js                    # CLI 入口
├── server.js                 # Bridge Server
├── config.json               # 配置
├── lib/
│   ├── commands/             # 命令模块
│   │   ├── get.js            # 获取评论
│   │   ├── post.js           # 发表评论
│   │   ├── suggest.js        # AI 回复建议（含人格化+随机延迟）
│   │   ├── browse.js         # 模拟浏览行为
│   │   ├── search.js         # 搜索视频
│   │   ├── download.js       # 下载视频+音频
│   │   └── ...
│   ├── memory/               # SQLite 持久化记忆层
│   ├── personas.js           # 7 种人格模板池
│   ├── jitter.js             # 人类行为延迟工具库
│   ├── llm.js                # LLM 封装（支持人格化）
│   └── ...
├── scripts/
│   └── douyin.user.js        # 油猴脚本（含参数随机化）
├── storage/
│   └── douyin.db             # SQLite 数据库
├── reply-strategy.md         # 回复策略模板
├── SKILL.md                  # Agent 技能文档
└── README.md                 # 本文档

📦 依赖

• Node.js 18+
• ws — WebSocket
• better-sqlite3 — SQLite
• Chrome + Tampermonkey + 油猴脚本
• （可选）OpenAI-compatible API key

📝 License

MIT