您可能对您的抖音账号思考过这些问题：
- 推荐流充斥着低质内容，刷半天找不到一个有价值的视频
- 想给孩子/长辈控制推荐内容，但手动筛选效率太低
- 深陷信息茧房，每天看的都是同类型视频，视野越来越窄
- 想快速调整推荐方向，如时政、艺术、帅哥、美女等，但抖音反应慢
抖音推荐影响器 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签等），根据你的偏好规则自动执行点赞、忽略或“不感兴趣”操作，持续向推荐算法反馈你的真实需求。
在抖音网页版使用该工具后，同一账号在不同设备上的推流都有不同程度的改变，以此影响您的手机端视频推流。产生效果后用完即弃即可，完全可以直接卸载弃用该插件。
原理：
较为简单：推荐算法依赖用户行为反馈（点赞、跳过、不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。
- AI 智能分析：支持 DeepSeek、Kimi、通义千问、智谱 GLM、Gemini 等多个主流大模型，也支持自定义 OpenAI 兼容 API
- 自动化操作：根据预设规则自动执行点赞、忽略或标记“不感兴趣”，通过持续反馈逐步调教推荐算法
- 行为模拟：模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险
- 灵活配置：内置多套预设模板（引导、效率知识、艺术审美等），也可完全自定义规则
- 透明可控：所有配置本地存储，API Key 不上传任何服务器，开源代码可审查
- 低成本：多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断
本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：
内容监管与引导
- 家长控制未成年人设备的推荐内容，过滤不适宜视频
- 子女为长辈设备筛选内容，减少低质量信息和诱导消费
打破信息茧房
- 主动调整推荐算法偏好，接触更多元化的内容类型
- 避免长期沉浸在单一类型视频中
聚焦特定兴趣
- 快速将推荐流调整为某一垂直领域，如科普、健身、艺术创作
- 过滤无关内容，提升信息获取效率
局限性说明
- 不适合从零培养新兴趣：例如在从未看过二次元内容的账号上试图筛选出《明日方舟》相关视频，效率远低于直接搜索
- 需要持续运行：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效
- 依赖算法反馈机制：最终效果受抖音推荐系统的响应速度和策略影响
- 多设备推荐内容可能不完全同步：这是由于抖音本身算法导致，web/平板通常推荐横向长视频，手机推荐竖向短视频
这个项目最初确实是从篡改猴 / 暴力猴编辑框里的单文件脚本一路演化出来的。现在已经完成了一期工程化接管，但对外仍坚持兼容优先：
- 源码已经工程化：实现源码位于
src/，不再继续以“只改线上单文件”的方式维护 - 发布产物路径不变：正式产物仍然是
dist/smart-feed-assistant.user.js - 安装入口不变：GitHub Raw 和 Greasy Fork 继续沿用原链接，不打断旧用户升级
- 版本来源统一：版本号由
package.json单一来源注入到 userscript header - 用户配置兼容保留：旧 GM 存储键和配置语义继续沿用，升级后不要求迁移
小声说：以前那个超大单文件确实把产品先跑起来了，但它已经不适合继续维护。现在这层工程化改造的目标，不是推翻原产品，而是把它收编成一个能长期维护、能测试、能构建、能发布的正常项目。
⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！
本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：
支持浏览器：Chrome、Edge、Firefox、Safari、Opera
安装链接：
- Chrome / Edge：Chrome 网上应用商店
- Firefox：Firefox 附加组件
- Safari：App Store
如果初次使用油猴，可能要求进行一系列操作才能完成，比如启用“允许用户脚本”切换开关或开发者模式。油猴和暴力猴都是很强大的通用脚本承载器，网上也有不少详细教程。
支持浏览器：Chrome、Edge、Firefox
安装链接：
- Chrome / Edge：Chrome 网上应用商店
- Firefox：Firefox 附加组件
推荐选择：两者功能基本相同，如果您是新手，推荐使用 Tampermonkey，用户更多、教程也更丰富。
安装好扩展管理器后，点击以下任一链接安装脚本：
💡 提示：点击上方链接后，扩展管理器会自动弹出安装确认页面
📋 如果链接无法打开，点击展开查看手动安装方法
手动安装步骤：
- 复制以下地址：
https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js
- 打开 Tampermonkey / Violentmonkey 扩展面板
- 点击设置，“添加新脚本”或“+”号
- 在“实用工具”标签页中找到“从 URL 安装”或“通过地址安装”
- 粘贴上方地址并确认安装
详细步骤：
- 点击上方链接，浏览器会自动识别为用户脚本
- 扩展管理器会弹出安装确认页面
- 点击 “安装” 按钮
- 安装成功后，访问 抖音网页版 即可看到右侧悬浮的机器人图标
注意事项：
- 脚本仅在抖音网页版（
www.douyin.com）生效 - 移动端 APP 无法使用
安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！
本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key，可以理解为“通行证”。
API Key 是一串由字母和数字组成的密钥，类似密码，用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。
| 服务商 | 推荐理由 | 获取链接 |
|---|---|---|
| DeepSeek ⭐ | 新手首选，性价比高，注册简单 | 立即获取 |
| Kimi | 月之暗面出品，国内访问稳定 | 立即获取 |
| 通义千问 | 阿里云旗下，企业级稳定性 | 立即获取 |
| 智谱 GLM | 中文理解能力强 | 立即获取 |
| Google Gemini | 可使用 Gemini 系列模型 | 立即获取 |
| 自定义 API | 支持本地代理、第三方转发、CLIProxyAPI 等 OpenAI 兼容 API | 填写任意兼容 OpenAI 格式的 API Base URL |
新手推荐：选择 DeepSeek，配置简单，且多数服务商都提供新用户免费额度。
价格说明：各家服务商的定价策略可能变化，建议以官网最新价格为准。通常新用户都有试用额度，部分模型还有免费档。
- 点击 DeepSeek 官网
- 使用手机号或邮箱注册账号
- 进入控制台后，确保有余额，点击 “创建 API Key”
- 复制生成的密钥，格式类似
sk-xxxxxxxxxxxxxx - 妥善保管：此密钥关联您的账户余额，切勿泄露
- 打开 抖音网页版 的 推荐 界面，右下角 关闭自动连播
- 点击页面右侧的 机器人图标，展开控制面板
- 在 基础设置 标签页中，按下面顺序填写：
- API Base URL 预设：选择您刚才注册的服务商，如 DeepSeek、GLM、Gemini
- API Base URL：预设会自动填好；如果使用本地或第三方转发，可选择 自定义 OpenAI 兼容 API，例如
http://127.0.0.1:8317 - API Key：粘贴刚才复制的密钥，注意不要多复制空格
- 先点击 “① 点击获取模型”
- 脚本会调用 OpenAI 兼容的
/models接口读取可用模型 - 预设 API 会自动选择一个推荐模型
- 自定义 API 会显示
<请选择模型>，请手动选一个模型 - 如果模型后面有备注，如
gemini-3.1-flash-lite-preview（2026.5：推荐，免费/低成本），说明这是人工维护的展示说明；默认选择仍按成本启发式排序
- 脚本会调用 OpenAI 兼容的
- 再点击 “② 点击测试连接”
- 看到成功提示后，说明 Base URL、API Key、模型三件事都通了
- 如果失败，先看 运行日志，再检查 Base URL、Key 和模型是否匹配
- 选择预设模板或填写偏好规则，最后点击 “💾 保存当前配置”
- 点击总是允许即可，脚本开源，无需额外授权担忧
- 如果显示成功，说明配置正确
- 如果显示失败，请先确认已经点击 “① 点击获取模型” 并选择了模型，再检查 API Key 是否正确
在 基础设置 中，您可以选择预设模板或自定义规则：
点击 预设模板 下拉菜单，选择符合您需求的模板：
- 破除信息茧房：使当前视频偏好内容有所改变
- 青少年内容引导：过滤低俗、娱乐化内容，推荐知识、科普类视频
- 效率与知识：聚焦商业、科技、技能学习
- 新闻与时事：关注严肃新闻和时事分析
- 健康生活：健身、饮食、心理健康等内容
- 艺术审美：绘画、音乐、设计等艺术创作
- 还可以筛选帅哥美女
选择后，脚本会自动填充对应的规则描述。
如果预设模板不满足需求，可以手动编辑三个规则框：
- 点赞收藏规则：描述您希望看到的内容，如“深度科普、技术教程”
- 忽略路过规则：描述普通内容的标准，如“日常 Vlog、美食探店”
- 不感兴趣规则：描述要过滤的内容，如“低俗娱乐、过度营销”
填写示例：
【点赞规则】
我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。
【忽略规则】
普通的日常记录、萌宠、美食等娱乐内容。
【不感兴趣规则】
低俗、暴力、虚假信息、过度营销的内容。
- 配置完成后，点击面板右上角的 “开始” 按钮
- 切换到 运行日志 标签页，查看实时处理进度
- 脚本会自动：
- 提取视频标题、作者、标签
- 调用 AI 分析内容
- 执行点赞、忽略或“不感兴趣”操作
- 自动切换到下一个视频
重要提示：
- 必须保持抖音标签页可见，不能切换到其他标签页
- 避免最小化浏览器窗口，否则脚本可能暂停
- 可以在视频播放可见的情况下使用其他应用，如 QQ、微信，但不保证完全稳定
- 建议使用独立浏览器窗口运行，专注处理推荐流
- 查看统计：在 运行日志 标签页可以看到实时统计数据，如已处理、点赞、忽略、不感兴趣
- 停止运行：点击 “停止” 按钮即可终止
- 自动停止：达到设定的运行时长后自动停止
觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！
在 高级选项 标签页中，可以调整以下参数：
| 参数名称 | 默认值 | 说明 |
|---|---|---|
| 操作前观看时长 | 2-4 秒 | 模拟真人观看一段时间后再操作 |
| 内容跳过概率 | 8% | 随机跳过部分视频，避免每个都操作 |
| API 失败重试次数 | 3 次 | AI 调用失败时的最大重试次数 |
建议：如无特殊需求，保持默认值即可。
答：费用取决于您选择的 API 提供商和使用频率。
- 多数服务商为新用户提供免费试用额度，通常足够体验大量判断
- 部分模型甚至有长期免费档
- 正式使用后按调用次数计费，不同平台价格不同，请以官网为准
- 参考量级上，低成本模型通常足够支撑大量推荐流微调
节省技巧：
- 设置较高的“内容跳过概率”，减少 API 调用次数
- 控制每次运行时长，如 10-15 分钟
- 优先选择有新用户优惠的平台
答：可以尝试，但不建议新手优先选择。
脚本会要求模型不要输出推理/思考过程，并优先读取最终回答。推理模型通常更慢、更贵，也更容易出现“只有思考、没有最终答案”的情况。处理抖音推荐流只需要快速判断，普通 chat、flash、lite、mini 这类低成本模型通常更合适。
推荐做法：先点击 “① 点击获取模型”，优先选择带“推荐、免费、低成本、flash、lite”备注的模型。
可能原因：
- API Key 输入错误，注意前后空格
- 选择的提供商与实际 Key 不匹配
- 自定义 API Base URL 填写错误
- 没有先获取模型，或者模型名填错
- 当前 API Key 没有调用该模型的权限
排查步骤：
- 检查 API Base URL 是否正确，预设用户可重新选择一次预设让脚本回填
- 检查 API Key 是否正确，尤其是前后空格
- 点击 “① 点击获取模型”，确认能拿到模型列表
- 选择一个模型后，再点击 “② 点击测试连接”
- 查看“运行日志”中的请求地址、HTTP 状态码和错误信息
答：不能完全后台运行。
具体要求：
- 避免：最小化浏览器窗口
- 不可以：切换到其他标签页
- 不可以：电脑锁屏或休眠
- 可以但不保证稳定：在保持浏览器窗口可见的情况下，使用其他应用
原因：脚本依赖快捷键和 DOM 监听，需要页面保持活跃状态。
建议：使用独立浏览器窗口运行，或使用副屏专门运行脚本。
答：绝对不会。
- 所有配置数据，包括 API Key，仅存储在 您的浏览器本地
- 脚本使用
GM_setValueAPI，不会上传到这个仓库 - 源代码完全开源，可自行审查
- AI 调用直接发送到您选择的服务商，不经过本项目的中间服务器
安全建议：
- 不要在公共电脑上使用
- 定期检查 API Key 的使用记录
- 如怀疑泄露，立即在服务商后台删除并重新生成
答：这通常意味着 抖音更新了页面结构，导致脚本的 DOM 选择器失效。
临时解决方案：
- 刷新页面后重试
- 清除浏览器缓存
- 检查是否有其他油猴脚本冲突
长期解决方案：
- 反馈给作者或提 Issue
- 更新选择器配置
- 欢迎有能力的开发者提交 Pull Request 修复
答：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送类似以下参数：
{
"model": "您填写的模型名称",
"messages": [...],
"temperature": 0.3,
"max_tokens": 500,
"stream": false
}重要限制：
- 不建议使用推理模型
- 支持标准 OpenAI 兼容端点
答：在 运行日志 标签页中：
- 勾选 “显示详细调试信息” 复选框
- 即可看到完整的 API 请求 / 响应内容
- 包括请求地址、请求体、响应状态码等
- 方便排查问题
答：测试账号未出现明显问题，但无法做绝对保证。
重要提示：
- 作者无法保证任何自动化工具的绝对安全性，若不放心建议小号测试
- 抖音对新注册账号可能有风控期，建议先正常使用一段时间
- 使用前请仔细阅读免责声明
- 任何因使用本工具导致的账号问题，作者不承担任何法律责任
最常见原因：抖音更新了页面 HTML 结构。
排查步骤：
-
检查脚本是否已更新
- 打开 Tampermonkey / Violentmonkey 面板
- 查看脚本是否有新版本
- 手动触发更新检查
-
刷新页面后重试
- 有时是临时 DOM 加载问题
-
反馈问题
- 邮件：
1987892914@qq.com - GitHub Issues：点击提交
- 反馈时请附上：
- 发现时间
- 浏览器版本
- 错误日志截图
- 邮件：
答：抖音网页版会折叠较长标题，脚本已尽力提取完整内容，但可能受限于：
- 页面 DOM 结构变化
- 标题动态加载延迟
- 反爬虫机制
解决方案：
- 脚本会自动等待一段时间后重试
- 如果标题过短，会跳过该视频
- 通常不影响整体判断准确性，仍可结合作者、标签等信息判断
当前仓库已经不是“只在编辑框里维护的单文件脚本”了。源码和发布产物已经分层，日常维护请优先基于源码目录进行。
src/
├── ai/ # AI 请求拼装、响应解析、判定逻辑
├── bootstrap/ # 页面入口和初始化
├── config/ # 默认配置、模板、选择器、模型厂商目录
├── controller/ # 主循环、错误恢复、运行状态
├── entry/ # userscript 入口
├── extractor/ # 抖音 DOM 提取逻辑
├── runtime/ # 运行时上下文注入
├── storage/ # GM 存储读写与兼容校验
├── ui/ # 面板、日志、交互
├── global.d.ts # GM / DOM 类型补充
└── types.ts # 核心类型定义
scripts/
├── assemble-userscript.mjs
├── check-dist-drift.mjs
├── migrate-legacy-dist.mjs
└── userscript-content.mjs
tests/ # 单元测试、兼容性测试
dist/ # 正式发布产物
docs/ # 维护指南与发布流程
- Node：
24.15.0 - 包管理器：
npm - 推荐目录：
E:\ProgramProject\jsProject\douyin-smart-feed-assistant - 版本管理：建议继续通过
nvm for Windows使用固定 Node 版本
src/是源码事实来源dist/smart-feed-assistant.user.js是正式发布产物package.json是脚本版本号的单一来源- 不要再回到“只改线上单文件，不回写源码”的流程
npm install
npm run lint
npm run typecheck
npm run test
npm run build
npm run dist:check如需发布前完整校验，可运行：
npm run release:check如果抖音更新页面结构，最容易失效的是 src/config/catalog.ts 中的选择器数组。
建议排查方式：
- 打开 F12 开发者工具
- 点击“选择元素”图标
- 悬停在视频标题、作者、标签区域
- 查看新的 HTML 结构或
data-*属性 - 把新的选择器优先加到数组前面
如果某个提供商变更了端点、模型名或请求参数，请优先更新 src/config/catalog.ts 中的 provider 配置，而不是散落修改请求逻辑。
新增提供商时需要补齐：
baseUrldefaultModelmodels- 如
/models不返回某个实际可调用的推荐模型，在modelSelectionOverrides.extraModelIds中补充候选模型；默认选择仍由成本启发式决定 - 如需展示“推荐、免费、2026.5 仍可用”等人工备注，在
modelLabelNotes中按精确 model id 维护
- 继续沿用现有 GM 存储键
- 新增字段时只做“追加默认值”，不要破坏旧用户读取
- API Key 继续只存在用户脚本本地存储中，不进入仓库
dist/smart-feed-assistant.user.js 必须由构建流程生成。
如果 dist:check 失败，优先排查源码、构建脚本或 header 注入逻辑，而不是直接手改产物。
非常欢迎各种形式的贡献。无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。
- Fork 本仓库
- 创建特性分支：
git checkout -b feature/AmazingFeature - 提交更改：
git commit -m "Add some AmazingFeature" - 推送到分支：
git push origin feature/AmazingFeature - 提交 Pull Request
- 代码风格：遵循现有工程结构和风格
- 提交信息：建议清晰描述变更内容
- 测试：至少确保
npm run typecheck、npm run test、npm run build通过 - 产物一致性：如改动影响发布脚本，请同步更新
dist
- 修复已知 bug
- 添加新的 AI 模型支持
- 改进文档和教程
- 优化界面设计
- 更新 DOM 选择器
- 补充测试覆盖
- 完善发布、校验和工程化链路
即使你不会编程，也可以通过以下方式贡献：
- 提交 bug 报告和功能建议
- 帮助其他用户解答问题
- 分享使用心得和技巧
- 给项目点 ⭐ Star 并推荐给朋友
- 邮箱：1987892914@qq.com
- GitHub Issues：提交问题
- 问题描述，越详细越好
- 浏览器版本
- 脚本版本
- 错误日志截图
- 复现步骤
- 使用 GitHub Issues，比邮件更容易追踪
- 提供完整的错误日志
- 说明已尝试的解决方案
- 如果是 DOM 选择器问题，提供页面 HTML 截图
- 本工具仅供学习和个人研究使用，不得用于任何商业目的
- 使用本工具可能违反抖音平台的服务条款
- 因使用本工具导致的任何后果，包括但不限于账号封禁、限流、数据丢失、经济损失，作者不承担任何法律责任
- 用户应自行评估使用风险并承担全部后果
- 用户必须遵守中华人民共和国相关法律法规
- 用户必须遵守抖音平台的用户协议和社区规范
- 因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关
- 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任
- API Key 仅存储在用户浏览器本地，不会上传到任何服务器
- 用户需自行保管 API Key，防止泄露
- 因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任
- 建议定期更换 API Key 并检查使用记录
- 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，作者对此不承担任何责任
- 本工具可能因抖音平台更新而失效，作者会尽力维护，但不保证时效性和持续可用性
- 作者保留随时停止维护本项目的权利，无需提前通知
- 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证
- 用户自行配置的规则和模板产生的结果由用户自行负责
- 本工具不对 AI 模型的判断结果负责
- 因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关
- 用户应确保配置的规则符合法律法规和社会公德
- 本工具基于网页 DOM 结构开发，可能因平台更新而失效
- 作者不保证代码的绝对安全性、无错性、适用性
- 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，作者对此不承担任何责任
- 用户应具备基本的计算机操作能力和风险识别能力
- 本工具基于 MIT License 开源，允许自由使用、修改和分发
- 使用者需保留原作者版权信息
- 二次开发或分发时需遵守 MIT 协议条款
- 不得用于任何商业用途的虚假宣传或侵权行为
- 在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任
- 包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等
- 即使作者已被告知可能发生此类损害，仍不承担任何责任
- 用户使用本工具的唯一补救措施是停止使用
下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。
- 本声明的解释、效力及纠纷解决均适用中华人民共和国法律
- 若有争议，双方应友好协商解决
- 协商不成的，任何一方可向作者所在地人民法院提起诉讼
MIT License
Copyright (c) 2025 Baianjo
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- 感谢所有提供反馈和建议的用户
- 感谢开源社区的技术支持
- 特别感谢 DeepSeek、Kimi、Qwen、GLM、Gemini、Claude 等 AI 服务提供商