{"repo": "baianjo/douyin-smart-feed-assistant", "files": {"package.json": {"fec2cc135263cb41a002aafa8029888a4caac75a": {"t": 1785746260.218402, "n": 2024, "h": "f0b6561593679be7", "c": "{\n \"name\": \"douyin-smart-feed-assistant\",\n \"version\": \"2.3.5\",\n \"private\": true,\n \"description\": \"AI-powered userscript that steers the Douyin recommendation feed with configurable preferences.\",\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"24.15.0\"\n },\n \"scripts\": {\n \"build\": \"tsup --config tsup.config.ts && node scripts/assemble-userscript.mjs\",\n \"dist:check\": \"node scripts/check-dist-drift.mjs\",\n \"lint\": \"eslint .\",\n \"typecheck\": \"tsc --noEmit\",\n \"test\": \"vitest run\",\n \"test:watch\": \"vitest\",\n \"release:check\": \"npm run lint && npm run typecheck && npm run test && npm run build && npm run dist:check\"\n },\n \"userscript\": {\n \"fileName\": \"smart-feed-assistant.user.js\",\n \"name\": \"抖音推荐影响器 (Smart Feed Assistant)\",\n \"namespace\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"description\": \"通过AI智能分析内容，优化你的信息流体验\",\n \"author\": \"Baianjo\",\n \"match\": [\n \"*://www.douyin.com/*\"\n ],\n \"connect\": [\n \"api.moonshot.cn\",\n \"api.deepseek.com\",\n \"dashscope.aliyuncs.com\",\n \"dashscope-intl.aliyuncs.com\",\n \"open.bigmodel.cn\",\n \"*\"\n ],\n \"grant\": [\n \"GM_setValue\",\n \"GM_getValue\",\n \"GM_deleteValue\",\n \"GM_xmlhttpRequest\",\n \"GM_addStyle\",\n \"unsafeWindow\"\n ],\n \"runAt\": \"document-end\",\n \"downloadURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"updateURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"homepageURL\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"supportURL\": \"mailto:1987892914@qq.com\",\n \"license\": \"MIT\"\n },\n \"devDependencies\": {\n \"@eslint/js\": \"^9.26.0\",\n \"@types/node\": \"^24.9.1\",\n \"eslint\": \"^9.26.0\",\n \"globals\": \"^16.0.0\",\n \"jsdom\": \"^26.1.0\",\n \"prettier\": \"^3.5.3\",\n \"tsup\": \"^8.5.0\",\n \"typescript\": \"^5.8.3\",\n \"typescript-eslint\": \"^8.32.0\",\n \"vitest\": \"^3.1.3\"\n }\n}\n"}, "cea15fc89ee61f77a8e5ce096ea0be7e479c6550": {"t": 1785761207.621943, "n": 2024, "h": "e9a00f612a7cf2a5", "c": "{\n \"name\": \"douyin-smart-feed-assistant\",\n \"version\": \"2.3.4\",\n \"private\": true,\n \"description\": \"AI-powered userscript that steers the Douyin recommendation feed with configurable preferences.\",\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"24.15.0\"\n },\n \"scripts\": {\n \"build\": \"tsup --config tsup.config.ts && node scripts/assemble-userscript.mjs\",\n \"dist:check\": \"node scripts/check-dist-drift.mjs\",\n \"lint\": \"eslint .\",\n \"typecheck\": \"tsc --noEmit\",\n \"test\": \"vitest run\",\n \"test:watch\": \"vitest\",\n \"release:check\": \"npm run lint && npm run typecheck && npm run test && npm run build && npm run dist:check\"\n },\n \"userscript\": {\n \"fileName\": \"smart-feed-assistant.user.js\",\n \"name\": \"抖音推荐影响器 (Smart Feed Assistant)\",\n \"namespace\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"description\": \"通过AI智能分析内容，优化你的信息流体验\",\n \"author\": \"Baianjo\",\n \"match\": [\n \"*://www.douyin.com/*\"\n ],\n \"connect\": [\n \"api.moonshot.cn\",\n \"api.deepseek.com\",\n \"dashscope.aliyuncs.com\",\n \"dashscope-intl.aliyuncs.com\",\n \"open.bigmodel.cn\",\n \"*\"\n ],\n \"grant\": [\n \"GM_setValue\",\n \"GM_getValue\",\n \"GM_deleteValue\",\n \"GM_xmlhttpRequest\",\n \"GM_addStyle\",\n \"unsafeWindow\"\n ],\n \"runAt\": \"document-end\",\n \"downloadURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"updateURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"homepageURL\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"supportURL\": \"mailto:1987892914@qq.com\",\n \"license\": \"MIT\"\n },\n \"devDependencies\": {\n \"@eslint/js\": \"^9.26.0\",\n \"@types/node\": \"^24.9.1\",\n \"eslint\": \"^9.26.0\",\n \"globals\": \"^16.0.0\",\n \"jsdom\": \"^26.1.0\",\n \"prettier\": \"^3.5.3\",\n \"tsup\": \"^8.5.0\",\n \"typescript\": \"^5.8.3\",\n \"typescript-eslint\": \"^8.32.0\",\n \"vitest\": \"^3.1.3\"\n }\n}\n"}, "e36e2ae43810847aa9e7bda9b1d5145143ff5902": {"t": 1785761208.783581, "n": 2024, "h": "44d498758caa7c7c", "c": "{\n \"name\": \"douyin-smart-feed-assistant\",\n \"version\": \"2.3.3\",\n \"private\": true,\n \"description\": \"AI-powered userscript that steers the Douyin recommendation feed with configurable preferences.\",\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"24.15.0\"\n },\n \"scripts\": {\n \"build\": \"tsup --config tsup.config.ts && node scripts/assemble-userscript.mjs\",\n \"dist:check\": \"node scripts/check-dist-drift.mjs\",\n \"lint\": \"eslint .\",\n \"typecheck\": \"tsc --noEmit\",\n \"test\": \"vitest run\",\n \"test:watch\": \"vitest\",\n \"release:check\": \"npm run lint && npm run typecheck && npm run test && npm run build && npm run dist:check\"\n },\n \"userscript\": {\n \"fileName\": \"smart-feed-assistant.user.js\",\n \"name\": \"抖音推荐影响器 (Smart Feed Assistant)\",\n \"namespace\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"description\": \"通过AI智能分析内容，优化你的信息流体验\",\n \"author\": \"Baianjo\",\n \"match\": [\n \"*://www.douyin.com/*\"\n ],\n \"connect\": [\n \"api.moonshot.cn\",\n \"api.deepseek.com\",\n \"dashscope.aliyuncs.com\",\n \"dashscope-intl.aliyuncs.com\",\n \"open.bigmodel.cn\",\n \"*\"\n ],\n \"grant\": [\n \"GM_setValue\",\n \"GM_getValue\",\n \"GM_deleteValue\",\n \"GM_xmlhttpRequest\",\n \"GM_addStyle\",\n \"unsafeWindow\"\n ],\n \"runAt\": \"document-end\",\n \"downloadURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"updateURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"homepageURL\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"supportURL\": \"mailto:1987892914@qq.com\",\n \"license\": \"MIT\"\n },\n \"devDependencies\": {\n \"@eslint/js\": \"^9.26.0\",\n \"@types/node\": \"^24.9.1\",\n \"eslint\": \"^9.26.0\",\n \"globals\": \"^16.0.0\",\n \"jsdom\": \"^26.1.0\",\n \"prettier\": \"^3.5.3\",\n \"tsup\": \"^8.5.0\",\n \"typescript\": \"^5.8.3\",\n \"typescript-eslint\": \"^8.32.0\",\n \"vitest\": \"^3.1.3\"\n }\n}\n"}, "552b3770aac51f39676cc698d9511aa5b0296641": {"t": 1785761210.2294972, "n": 2024, "h": "7ea0127844b6340d", "c": "{\n \"name\": \"douyin-smart-feed-assistant\",\n \"version\": \"2.3.2\",\n \"private\": true,\n \"description\": \"AI-powered userscript that steers the Douyin recommendation feed with configurable preferences.\",\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"24.15.0\"\n },\n \"scripts\": {\n \"build\": \"tsup --config tsup.config.ts && node scripts/assemble-userscript.mjs\",\n \"dist:check\": \"node scripts/check-dist-drift.mjs\",\n \"lint\": \"eslint .\",\n \"typecheck\": \"tsc --noEmit\",\n \"test\": \"vitest run\",\n \"test:watch\": \"vitest\",\n \"release:check\": \"npm run lint && npm run typecheck && npm run test && npm run build && npm run dist:check\"\n },\n \"userscript\": {\n \"fileName\": \"smart-feed-assistant.user.js\",\n \"name\": \"抖音推荐影响器 (Smart Feed Assistant)\",\n \"namespace\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"description\": \"通过AI智能分析内容，优化你的信息流体验\",\n \"author\": \"Baianjo\",\n \"match\": [\n \"*://www.douyin.com/*\"\n ],\n \"connect\": [\n \"api.moonshot.cn\",\n \"api.deepseek.com\",\n \"dashscope.aliyuncs.com\",\n \"dashscope-intl.aliyuncs.com\",\n \"open.bigmodel.cn\",\n \"*\"\n ],\n \"grant\": [\n \"GM_setValue\",\n \"GM_getValue\",\n \"GM_deleteValue\",\n \"GM_xmlhttpRequest\",\n \"GM_addStyle\",\n \"unsafeWindow\"\n ],\n \"runAt\": \"document-end\",\n \"downloadURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"updateURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"homepageURL\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"supportURL\": \"mailto:1987892914@qq.com\",\n \"license\": \"MIT\"\n },\n \"devDependencies\": {\n \"@eslint/js\": \"^9.26.0\",\n \"@types/node\": \"^24.9.1\",\n \"eslint\": \"^9.26.0\",\n \"globals\": \"^16.0.0\",\n \"jsdom\": \"^26.1.0\",\n \"prettier\": \"^3.5.3\",\n \"tsup\": \"^8.5.0\",\n \"typescript\": \"^5.8.3\",\n \"typescript-eslint\": \"^8.32.0\",\n \"vitest\": \"^3.1.3\"\n }\n}\n"}, "46369cd8d585670d4b57266f133d5dd20875ee64": {"t": 1785761211.894234, "n": 2024, "h": "5fe2e4fa7bf01a34", "c": "{\n \"name\": \"douyin-smart-feed-assistant\",\n \"version\": \"2.3.1\",\n \"private\": true,\n \"description\": \"AI-powered userscript that steers the Douyin recommendation feed with configurable preferences.\",\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"24.15.0\"\n },\n \"scripts\": {\n \"build\": \"tsup --config tsup.config.ts && node scripts/assemble-userscript.mjs\",\n \"dist:check\": \"node scripts/check-dist-drift.mjs\",\n \"lint\": \"eslint .\",\n \"typecheck\": \"tsc --noEmit\",\n \"test\": \"vitest run\",\n \"test:watch\": \"vitest\",\n \"release:check\": \"npm run lint && npm run typecheck && npm run test && npm run build && npm run dist:check\"\n },\n \"userscript\": {\n \"fileName\": \"smart-feed-assistant.user.js\",\n \"name\": \"抖音推荐影响器 (Smart Feed Assistant)\",\n \"namespace\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"description\": \"通过AI智能分析内容，优化你的信息流体验\",\n \"author\": \"Baianjo\",\n \"match\": [\n \"*://www.douyin.com/*\"\n ],\n \"connect\": [\n \"api.moonshot.cn\",\n \"api.deepseek.com\",\n \"dashscope.aliyuncs.com\",\n \"dashscope-intl.aliyuncs.com\",\n \"open.bigmodel.cn\",\n \"*\"\n ],\n \"grant\": [\n \"GM_setValue\",\n \"GM_getValue\",\n \"GM_deleteValue\",\n \"GM_xmlhttpRequest\",\n \"GM_addStyle\",\n \"unsafeWindow\"\n ],\n \"runAt\": \"document-end\",\n \"downloadURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"updateURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"homepageURL\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"supportURL\": \"mailto:1987892914@qq.com\",\n \"license\": \"MIT\"\n },\n \"devDependencies\": {\n \"@eslint/js\": \"^9.26.0\",\n \"@types/node\": \"^24.9.1\",\n \"eslint\": \"^9.26.0\",\n \"globals\": \"^16.0.0\",\n \"jsdom\": \"^26.1.0\",\n \"prettier\": \"^3.5.3\",\n \"tsup\": \"^8.5.0\",\n \"typescript\": \"^5.8.3\",\n \"typescript-eslint\": \"^8.32.0\",\n \"vitest\": \"^3.1.3\"\n }\n}\n"}, "629ac87607c78e0435836c7f57b56572c6dba9bd": {"t": 1785761213.8942738, "n": 2024, "h": "eb72428927c6500c", "c": "{\n \"name\": \"douyin-smart-feed-assistant\",\n \"version\": \"2.3.0\",\n \"private\": true,\n \"description\": \"AI-powered userscript that steers the Douyin recommendation feed with configurable preferences.\",\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"24.15.0\"\n },\n \"scripts\": {\n \"build\": \"tsup --config tsup.config.ts && node scripts/assemble-userscript.mjs\",\n \"dist:check\": \"node scripts/check-dist-drift.mjs\",\n \"lint\": \"eslint .\",\n \"typecheck\": \"tsc --noEmit\",\n \"test\": \"vitest run\",\n \"test:watch\": \"vitest\",\n \"release:check\": \"npm run lint && npm run typecheck && npm run test && npm run build && npm run dist:check\"\n },\n \"userscript\": {\n \"fileName\": \"smart-feed-assistant.user.js\",\n \"name\": \"抖音推荐影响器 (Smart Feed Assistant)\",\n \"namespace\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"description\": \"通过AI智能分析内容，优化你的信息流体验\",\n \"author\": \"Baianjo\",\n \"match\": [\n \"*://www.douyin.com/*\"\n ],\n \"connect\": [\n \"api.moonshot.cn\",\n \"api.deepseek.com\",\n \"dashscope.aliyuncs.com\",\n \"dashscope-intl.aliyuncs.com\",\n \"open.bigmodel.cn\",\n \"*\"\n ],\n \"grant\": [\n \"GM_setValue\",\n \"GM_getValue\",\n \"GM_deleteValue\",\n \"GM_xmlhttpRequest\",\n \"GM_addStyle\",\n \"unsafeWindow\"\n ],\n \"runAt\": \"document-end\",\n \"downloadURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"updateURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"homepageURL\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"supportURL\": \"mailto:1987892914@qq.com\",\n \"license\": \"MIT\"\n },\n \"devDependencies\": {\n \"@eslint/js\": \"^9.26.0\",\n \"@types/node\": \"^24.9.1\",\n \"eslint\": \"^9.26.0\",\n \"globals\": \"^16.0.0\",\n \"jsdom\": \"^26.1.0\",\n \"prettier\": \"^3.5.3\",\n \"tsup\": \"^8.5.0\",\n \"typescript\": \"^5.8.3\",\n \"typescript-eslint\": \"^8.32.0\",\n \"vitest\": \"^3.1.3\"\n }\n}\n"}, "cce67463e3726a8dab0a52ac2427cd7b181860e3": {"t": 1785761215.4060135, "n": 2024, "h": "2c70f5191fb0bf1b", "c": "{\n \"name\": \"douyin-smart-feed-assistant\",\n \"version\": \"2.2.0\",\n \"private\": true,\n \"description\": \"AI-powered userscript that steers the Douyin recommendation feed with configurable preferences.\",\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"24.15.0\"\n },\n \"scripts\": {\n \"build\": \"tsup --config tsup.config.ts && node scripts/assemble-userscript.mjs\",\n \"dist:check\": \"node scripts/check-dist-drift.mjs\",\n \"lint\": \"eslint .\",\n \"typecheck\": \"tsc --noEmit\",\n \"test\": \"vitest run\",\n \"test:watch\": \"vitest\",\n \"release:check\": \"npm run lint && npm run typecheck && npm run test && npm run build && npm run dist:check\"\n },\n \"userscript\": {\n \"fileName\": \"smart-feed-assistant.user.js\",\n \"name\": \"抖音推荐影响器 (Smart Feed Assistant)\",\n \"namespace\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"description\": \"通过AI智能分析内容，优化你的信息流体验\",\n \"author\": \"Baianjo\",\n \"match\": [\n \"*://www.douyin.com/*\"\n ],\n \"connect\": [\n \"api.moonshot.cn\",\n \"api.deepseek.com\",\n \"dashscope.aliyuncs.com\",\n \"dashscope-intl.aliyuncs.com\",\n \"open.bigmodel.cn\",\n \"*\"\n ],\n \"grant\": [\n \"GM_setValue\",\n \"GM_getValue\",\n \"GM_deleteValue\",\n \"GM_xmlhttpRequest\",\n \"GM_addStyle\",\n \"unsafeWindow\"\n ],\n \"runAt\": \"document-end\",\n \"downloadURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"updateURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"homepageURL\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"supportURL\": \"mailto:1987892914@qq.com\",\n \"license\": \"MIT\"\n },\n \"devDependencies\": {\n \"@eslint/js\": \"^9.26.0\",\n \"@types/node\": \"^24.9.1\",\n \"eslint\": \"^9.26.0\",\n \"globals\": \"^16.0.0\",\n \"jsdom\": \"^26.1.0\",\n \"prettier\": \"^3.5.3\",\n \"tsup\": \"^8.5.0\",\n \"typescript\": \"^5.8.3\",\n \"typescript-eslint\": \"^8.32.0\",\n \"vitest\": \"^3.1.3\"\n }\n}\n"}, "eb14d49b96053109604d90da704889a76b38a12a": {"t": 1785761216.7243116, "n": 2024, "h": "6aa9ea582ef1e665", "c": "{\n \"name\": \"douyin-smart-feed-assistant\",\n \"version\": \"2.1.2\",\n \"private\": true,\n \"description\": \"AI-powered userscript that steers the Douyin recommendation feed with configurable preferences.\",\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"24.15.0\"\n },\n \"scripts\": {\n \"build\": \"tsup --config tsup.config.ts && node scripts/assemble-userscript.mjs\",\n \"dist:check\": \"node scripts/check-dist-drift.mjs\",\n \"lint\": \"eslint .\",\n \"typecheck\": \"tsc --noEmit\",\n \"test\": \"vitest run\",\n \"test:watch\": \"vitest\",\n \"release:check\": \"npm run lint && npm run typecheck && npm run test && npm run build && npm run dist:check\"\n },\n \"userscript\": {\n \"fileName\": \"smart-feed-assistant.user.js\",\n \"name\": \"抖音推荐影响器 (Smart Feed Assistant)\",\n \"namespace\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"description\": \"通过AI智能分析内容，优化你的信息流体验\",\n \"author\": \"Baianjo\",\n \"match\": [\n \"*://www.douyin.com/*\"\n ],\n \"connect\": [\n \"api.moonshot.cn\",\n \"api.deepseek.com\",\n \"dashscope.aliyuncs.com\",\n \"dashscope-intl.aliyuncs.com\",\n \"open.bigmodel.cn\",\n \"*\"\n ],\n \"grant\": [\n \"GM_setValue\",\n \"GM_getValue\",\n \"GM_deleteValue\",\n \"GM_xmlhttpRequest\",\n \"GM_addStyle\",\n \"unsafeWindow\"\n ],\n \"runAt\": \"document-end\",\n \"downloadURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"updateURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"homepageURL\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"supportURL\": \"mailto:1987892914@qq.com\",\n \"license\": \"MIT\"\n },\n \"devDependencies\": {\n \"@eslint/js\": \"^9.26.0\",\n \"@types/node\": \"^24.9.1\",\n \"eslint\": \"^9.26.0\",\n \"globals\": \"^16.0.0\",\n \"jsdom\": \"^26.1.0\",\n \"prettier\": \"^3.5.3\",\n \"tsup\": \"^8.5.0\",\n \"typescript\": \"^5.8.3\",\n \"typescript-eslint\": \"^8.32.0\",\n \"vitest\": \"^3.1.3\"\n }\n}\n"}, "c0caad777b7b9f1ef9acc49d6e9308f49f79be8c": {"t": 1785761217.9026854, "n": 2024, "h": "38c1bb541f99d87c", "c": "{\n \"name\": \"douyin-smart-feed-assistant\",\n \"version\": \"2.1.1\",\n \"private\": true,\n \"description\": \"AI-powered userscript that steers the Douyin recommendation feed with configurable preferences.\",\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"24.15.0\"\n },\n \"scripts\": {\n \"build\": \"tsup --config tsup.config.ts && node scripts/assemble-userscript.mjs\",\n \"dist:check\": \"node scripts/check-dist-drift.mjs\",\n \"lint\": \"eslint .\",\n \"typecheck\": \"tsc --noEmit\",\n \"test\": \"vitest run\",\n \"test:watch\": \"vitest\",\n \"release:check\": \"npm run lint && npm run typecheck && npm run test && npm run build && npm run dist:check\"\n },\n \"userscript\": {\n \"fileName\": \"smart-feed-assistant.user.js\",\n \"name\": \"抖音推荐影响器 (Smart Feed Assistant)\",\n \"namespace\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"description\": \"通过AI智能分析内容，优化你的信息流体验\",\n \"author\": \"Baianjo\",\n \"match\": [\n \"*://www.douyin.com/*\"\n ],\n \"connect\": [\n \"api.moonshot.cn\",\n \"api.deepseek.com\",\n \"dashscope.aliyuncs.com\",\n \"dashscope-intl.aliyuncs.com\",\n \"open.bigmodel.cn\",\n \"*\"\n ],\n \"grant\": [\n \"GM_setValue\",\n \"GM_getValue\",\n \"GM_deleteValue\",\n \"GM_xmlhttpRequest\",\n \"GM_addStyle\",\n \"unsafeWindow\"\n ],\n \"runAt\": \"document-end\",\n \"downloadURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"updateURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"homepageURL\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"supportURL\": \"mailto:1987892914@qq.com\",\n \"license\": \"MIT\"\n },\n \"devDependencies\": {\n \"@eslint/js\": \"^9.26.0\",\n \"@types/node\": \"^24.9.1\",\n \"eslint\": \"^9.26.0\",\n \"globals\": \"^16.0.0\",\n \"jsdom\": \"^26.1.0\",\n \"prettier\": \"^3.5.3\",\n \"tsup\": \"^8.5.0\",\n \"typescript\": \"^5.8.3\",\n \"typescript-eslint\": \"^8.32.0\",\n \"vitest\": \"^3.1.3\"\n }\n}\n"}, "ec3584f5fd6e09b9162eafc77d3e6c43a83d016a": {"t": 1785761219.4575422, "n": 2024, "h": "51f5ba9920923352", "c": "{\n \"name\": \"douyin-smart-feed-assistant\",\n \"version\": \"2.1.0\",\n \"private\": true,\n \"description\": \"AI-powered userscript that steers the Douyin recommendation feed with configurable preferences.\",\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"24.15.0\"\n },\n \"scripts\": {\n \"build\": \"tsup --config tsup.config.ts && node scripts/assemble-userscript.mjs\",\n \"dist:check\": \"node scripts/check-dist-drift.mjs\",\n \"lint\": \"eslint .\",\n \"typecheck\": \"tsc --noEmit\",\n \"test\": \"vitest run\",\n \"test:watch\": \"vitest\",\n \"release:check\": \"npm run lint && npm run typecheck && npm run test && npm run build && npm run dist:check\"\n },\n \"userscript\": {\n \"fileName\": \"smart-feed-assistant.user.js\",\n \"name\": \"抖音推荐影响器 (Smart Feed Assistant)\",\n \"namespace\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"description\": \"通过AI智能分析内容，优化你的信息流体验\",\n \"author\": \"Baianjo\",\n \"match\": [\n \"*://www.douyin.com/*\"\n ],\n \"connect\": [\n \"api.moonshot.cn\",\n \"api.deepseek.com\",\n \"dashscope.aliyuncs.com\",\n \"dashscope-intl.aliyuncs.com\",\n \"open.bigmodel.cn\",\n \"*\"\n ],\n \"grant\": [\n \"GM_setValue\",\n \"GM_getValue\",\n \"GM_deleteValue\",\n \"GM_xmlhttpRequest\",\n \"GM_addStyle\",\n \"unsafeWindow\"\n ],\n \"runAt\": \"document-end\",\n \"downloadURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"updateURL\": \"https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\",\n \"homepageURL\": \"https://github.com/baianjo/Douyin-Smart-Feed-Assistant\",\n \"supportURL\": \"mailto:1987892914@qq.com\",\n \"license\": \"MIT\"\n },\n \"devDependencies\": {\n \"@eslint/js\": \"^9.26.0\",\n \"@types/node\": \"^24.9.1\",\n \"eslint\": \"^9.26.0\",\n \"globals\": \"^16.0.0\",\n \"jsdom\": \"^26.1.0\",\n \"prettier\": \"^3.5.3\",\n \"tsup\": \"^8.5.0\",\n \"typescript\": \"^5.8.3\",\n \"typescript-eslint\": \"^8.32.0\",\n \"vitest\": \"^3.1.3\"\n }\n}\n"}}, "README.md": {"fec2cc135263cb41a002aafa8029888a4caac75a": {"t": 1785747352.094283, "n": 16230, "h": "a1f52fd082929789", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [适用场景](#适用场景)\n - [工程化现状](#工程化现状)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [反馈与支持](#反馈与支持)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，如时政、艺术、帅哥、美女等，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签等），根据你的偏好规则自动执行点赞、忽略或“不感兴趣”操作，持续向推荐算法反馈你的真实需求。\n\n在抖音网页版使用该工具后，同一账号在不同设备上的推流都有不同程度的改变，以此影响您的手机端视频推流。产生效果后用完即弃即可，完全可以直接卸载弃用该插件。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞、跳过、不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n### 核心特性\n\n- **AI 智能分析**：支持 DeepSeek、Kimi、通义千问、智谱 GLM、Gemini 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作**：根据预设规则自动执行点赞、忽略或标记“不感兴趣”，通过持续反馈逐步调教推荐算法\n- **行为模拟**：模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置**：内置多套预设模板（引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控**：所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本**：多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域，如科普、健身、艺术创作\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号上试图筛选出《明日方舟》相关视频，效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致，web/平板通常推荐横向长视频，手机推荐竖向短视频\n\n### 工程化现状\n\n这个项目最初确实是从篡改猴 / 暴力猴编辑框里的单文件脚本一路演化出来的。现在已经完成了一期工程化接管，但对外仍坚持兼容优先：\n\n- **源码已经工程化**：实现源码位于 `src/`，不再继续以“只改线上单文件”的方式维护\n- **发布产物路径不变**：正式产物仍然是 `dist/smart-feed-assistant.user.js`\n- **安装入口不变**：GitHub Raw 和 Greasy Fork 继续沿用原链接，不打断旧用户升级\n- **版本来源统一**：版本号由 `package.json` 单一来源注入到 userscript header\n- **用户配置兼容保留**：旧 GM 存储键和配置语义继续沿用，升级后不要求迁移\n\n小声说：以前那个超大单文件确实把产品先跑起来了，但它已经不适合继续维护。现在这层工程化改造的目标，不是推翻原产品，而是把它收编成一个能长期维护、能测试、能构建、能发布的正常项目。\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome / Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n如果初次使用油猴，可能要求进行一系列操作才能完成，比如[启用“允许用户脚本”切换开关或开发者模式](https://www.tampermonkey.net/faq.php#Q209)。油猴和暴力猴都是很强大的通用脚本承载器，网上也有不少详细教程。\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome / Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**，用户更多、教程也更丰富。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n\n### **[👉 点击安装（Greasy Fork）](https://greasyfork.org/zh-CN/scripts/553873-%E6%8A%96%E9%9F%B3%E6%8E%A8%E8%8D%90%E5%BD%B1%E5%93%8D%E5%99%A8-smart-feed-assistant)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```text\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey / Violentmonkey 扩展面板\n3. 点击设置，“添加新脚本”或“+”号\n4. 在“实用工具”标签页中找到“从 URL 安装”或“通过地址安装”\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **“安装”** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key，可以理解为“通行证”。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥，类似密码，用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **Google Gemini** | 可使用 Gemini 系列模型 | [立即获取](https://aistudio.google.com/apikey) |\n| **自定义 API** | 支持本地代理、第三方转发、CLIProxyAPI 等 OpenAI 兼容 API | 填写任意兼容 OpenAI 格式的 API Base URL |\n\n**新手推荐**：选择 **DeepSeek**，配置简单，且多数服务商都提供新用户免费额度。 \n**价格说明**：各家服务商的定价策略可能变化，建议以官网最新价格为准。通常新用户都有试用额度，部分模型还有免费档。\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额，点击 **“创建 API Key”**\n4. 复制生成的密钥，格式类似 `sk-xxxxxxxxxxxxxx`\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com) 的 **推荐** 界面，右下角 **关闭自动连播**\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中，按下面顺序填写：\n - **API Base URL 预设**：选择您刚才注册的服务商，如 DeepSeek、GLM、Gemini\n - **API Base URL**：预设会自动填好；如果使用本地或第三方转发，可选择 **自定义 OpenAI 兼容 API**，例如 `http://127.0.0.1:8317`\n - **API Key**：粘贴刚才复制的密钥，注意不要多复制空格\n4. 先点击 **“① 点击获取模型”**\n - 脚本会调用 OpenAI 兼容的 `/models` 接口读取可用模型\n - 预设 API 会自动选择一个推荐模型\n - 自定义 API 会显示 `<请选择模型>`，请手动选一个模型\n - 如果模型后面有备注，如 `gemini-3.1-flash-lite-preview（2026.5：推荐，免费/低成本）`，说明这是人工维护的展示说明；默认选择仍按成本启发式排序\n5. 再点击 **“② 点击测试连接”**\n - 看到成功提示后，说明 Base URL、API Key、模型三件事都通了\n - 如果失败，先看 **运行日志**，再检查 Base URL、Key 和模型是否匹配\n6. 选择预设模板或填写偏好规则，最后点击 **“💾 保存当前配置”**\n\n![演示图片](./assets/demoapi1.png)\n\n- 点击总是允许即可，脚本开源，无需额外授权担忧\n- 如果显示成功，说明配置正确\n- 如果显示失败，请先确认已经点击 **“① 点击获取模型”** 并选择了模型，再检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **破除信息茧房**：使当前视频偏好内容有所改变\n- **青少年内容引导**：过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识**：聚焦商业、科技、技能学习\n- **新闻与时事**：关注严肃新闻和时事分析\n- **健康生活**：健身、饮食、心理健康等内容\n- **艺术审美**：绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则**：描述您希望看到的内容，如“深度科普、技术教程”\n2. **忽略路过规则**：描述普通内容的标准，如“日常 Vlog、美食探店”\n3. **不感兴趣规则**：描述要过滤的内容，如“低俗娱乐、过度营销”\n\n**填写示例**：\n\n```text\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **“开始”** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞、忽略或“不感兴趣”操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**，不能切换到其他标签页\n- **避免最小化浏览器窗口**，否则脚本可能暂停\n- 可以在视频播放可见的情况下使用其他应用，如 QQ、微信，但不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据，如已处理、点赞、忽略、不感兴趣\n- **停止运行**：点击 **“停止”** 按钮即可终止\n- **自动停止**：达到设定的运行时长后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度，通常足够体验大量判断\n- 部分模型甚至有长期免费档\n- 正式使用后按调用次数计费，不同平台价格不同，请以官网为准\n- 参考量级上，低成本模型通常足够支撑大量推荐流微调\n\n**节省技巧**：\n- 设置较高的“内容跳过概率”，减少 API 调用次数\n- 控制每次运行时长，如 10-15 分钟\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 可以使用“深度思考”模型吗？\n\n**答**：可以尝试，但不建议新手优先选择。\n\n脚本会要求模型不要输出推理/思考过程，并优先读取最终回答。推理模型通常更慢、更贵，也更容易出现“只有思考、没有最终答案”的情况。处理抖音推荐流只需要快速判断，普通 chat、flash、lite、mini 这类低成本模型通常更合适。\n\n**推荐做法**：先点击 **“① 点击获取模型”**，优先选择带“推荐、免费、低成本、flash、lite”备注的模型。\n\n---\n\n### 3. 出现 400 / 401 / 422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误，注意前后空格\n- 选择的提供商与实际 Key 不匹配\n- 自定义 API Base URL 填写错误\n- 没有先获取模型，或者模型名填错\n- 当前 API Key 没有调用该模型的权限\n\n**排查步骤**：\n\n1. 检查 API Base URL 是否正确，预设用户可重新选择一次预设让脚本回填\n2. 检查 API Key 是否正确，尤其是前后空格\n3. 点击 **“① 点击获取模型”**，确认能拿到模型列表\n4. 选择一个模型后，再点击 **“② 点击测试连接”**\n5. 查看“运行日志”中的请求地址、HTTP 状态码和错误信息\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口\n- **不可以**：切换到其他标签页\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用\n\n**原因**：脚本依赖快捷键和 DOM 监听，需要页面保持活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据，包括 API Key，仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，不会上传到这个仓库\n- 源代码完全开源，可自行审查\n- AI 调用直接发送到您选择的服务商，不经过本项目的中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示“无法定位当前视频”？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 反馈给作者或提 Issue\n- 更新选择器配置\n- 欢迎有能力的开发者提交 Pull Request 修复\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送类似以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n如果中转站 / OpenAI 兼容接口明确提示 `max_tokens` 不支持，脚本会自动切换为 `max_completion_tokens`；若仍被明确拒绝，则最后一次重试会不发送 token 上限参数，交给接口默认值处理。\n\n**重要限制**：\n- 不建议使用推理模型\n- 支持标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **“显示详细调试信息”** 复选框\n2. 即可看到完整的 API 请求 / 响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：测试账号未出现明显问题，但无法做绝对保证。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性，若不放心建议小号测试\n- 抖音对新注册账号可能有风控期，建议先正常使用一段时间\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**\n - 打开 Tampermonkey / Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**\n - 有时是临时 DOM 加载问题\n\n3. **反馈问题**\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间\n - 浏览器版本\n - 错误日志截图\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短，会跳过该视频\n- 通常不影响整体判断准确性，仍可结合作者、标签等信息判断\n\n---\n\n## 开发者维护指南\n\n当前仓库已经不是“只在编辑框里维护的单文件脚本”了。源码和发布产物已经分层，日常维护请优先基于源码目录进行。\n\n### 当前代码结构\n\n```text\nsrc/\n├── ai/ # AI 请求拼装、响应解析、判定逻辑\n├── bootstrap/ # 页面入口和初始化\n├── config/ # 默认配置、模板、选择器、模型厂商目录\n├── controller/ # 主循环、错误恢复、运行状态\n├── entry/ # userscript 入口\n├── extractor/ # 抖音 DOM 提取逻辑\n├── runtime/ # 运行时上下文注入\n├── storage/ # GM 存储读写与兼容校验\n├── ui/ # 面板、日志、交互\n├── global.d.ts # GM / DOM 类型补充\n└── types.ts # 核心类型定义\n\nscripts/\n├── assemble-userscript.mjs\n├── check-dist-drift.mjs\n├── migrate-legacy-dist.mjs\n└── userscript-content.mjs\n\ntests/ # 单元测试、兼容性测试\ndist/ # 正式发布产物\ndocs/ # 维护指南与发布流程\n```\n\n### 本地基线\n\n- Node：`24.15.0`\n- 包管理器：`npm`\n- 推荐目录：`E:\\ProgramProject\\jsProject\\douyin-smart-feed-assistant`\n- 版本管理：建议继续通过 `nvm for Windows` 使用固定 Node 版本\n\n### 核心维护原则\n\n1. **`src/` 是源码事实来源**\n2. **`dist/smart-feed-assistant.user.js` 是正式发布产物**\n3. **`package.json` 是脚本版本号的单一来源**\n4. **不要再回到“只改线上单文件，不回写源码”的流程**\n\n### 常用命令\n\n```bash\nnpm install\nnpm run lint\nnpm run typecheck\nnpm run test\nnpm run build\nnpm run dist:check\n```\n\n如需发布前完整校验，可运行：\n\n```bash\nnpm run release:check\n```\n\n### 维护重点 1：更新 DOM 选择器\n\n如果抖音更新页面结构，最容易失效的是 `src/config/catalog.ts` 中的选择器数组。\n\n建议排查方式：\n\n1. 打开 F12 开发者工具\n2. 点击“选择元素”图标\n3. 悬停在视频标题、作者、标签区域\n4. 查看新的 HTML 结构或 `data-*` 属性\n5. 把新的选择器优先加到数组前面\n\n### 维护重点 2：新增或调整 API 提供商\n\n如果某个提供商变更了端点、模型名或请求参数，请优先更新 `src/config/catalog.ts` 中的 provider 配置，而不是散落修改请求逻辑。\n\n新增提供商时需要补齐：\n\n- `baseUrl`\n- `defaultModel`\n- `models`\n- 如 `/models` 不返回某个实际可调用的推荐模型，在 `modelSelectionOverrides.extraModelIds` 中补充候选模型；默认选择仍由成本启发式决定\n- 如需展示“推荐、免费、2026.5 仍可用”等人工备注，在 `modelLabelNotes` 中按精确 model id 维护\n\n### 维护重点 3：保持用户配置兼容\n\n- 继续沿用现有 GM 存储键\n- 新增字段时只做“追加默认值”，不要破坏旧用户读取\n- API Key 继续只存在用户脚本本地存储中，不进入仓库\n\n### 维护重点 4：严禁手改 dist\n\n`dist/smart-feed-assistant.user.js` 必须由构建流程生成。 \n如果 `dist:check` 失败，优先排查源码、构建脚本或 header 注入逻辑，而不是直接手改产物。\n\n### 更多维护文档\n\n- [维护指南](./docs/maintainer-guide.md)\n- [发布流程](./docs/release-process.md)\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献。无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库**\n2. **创建特性分支**：`git checkout -b feature/AmazingFeature`\n3. **提交更改**：`git commit -m \"Add some AmazingFeature\"`\n4. **推送到分支**：`git push origin feature/AmazingFeature`\n5. **提交 Pull Request**\n\n### 提交规范\n\n- **代码风格**：遵循现有工程结构和风格\n- **提交信息**：建议清晰描述变更内容\n- **测试**：至少确保 `npm run typecheck`、`npm run test`、`npm run build` 通过\n- **产物一致性**：如改动影响发布脚本，请同步更新 `dist`\n\n### 贡献方向建议\n\n- 修复已知 bug\n- 添加新的 AI 模型支持\n- 改进文档和教程\n- 优化界面设计\n- 更新 DOM 选择器\n- 补充测试覆盖\n- 完善发布、校验和工程化链路\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述，越详细越好\n2. 浏览器版本\n3. 脚本版本\n4. 错误日志截图\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues，比邮件更容易追踪\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果，包括但不限于账号封禁、限流、数据丢失、经济损失，作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护，但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM、Gemini、Claude 等 AI 服务提供商\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "552b3770aac51f39676cc698d9511aa5b0296641": {"t": 1785761208.0755184, "n": 16113, "h": "41ab0e465f8f9784", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [适用场景](#适用场景)\n - [工程化现状](#工程化现状)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [反馈与支持](#反馈与支持)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，如时政、艺术、帅哥、美女等，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签等），根据你的偏好规则自动执行点赞、忽略或“不感兴趣”操作，持续向推荐算法反馈你的真实需求。\n\n在抖音网页版使用该工具后，同一账号在不同设备上的推流都有不同程度的改变，以此影响您的手机端视频推流。产生效果后用完即弃即可，完全可以直接卸载弃用该插件。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞、跳过、不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n### 核心特性\n\n- **AI 智能分析**：支持 DeepSeek、Kimi、通义千问、智谱 GLM、Gemini 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作**：根据预设规则自动执行点赞、忽略或标记“不感兴趣”，通过持续反馈逐步调教推荐算法\n- **行为模拟**：模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置**：内置多套预设模板（引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控**：所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本**：多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域，如科普、健身、艺术创作\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号上试图筛选出《明日方舟》相关视频，效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致，web/平板通常推荐横向长视频，手机推荐竖向短视频\n\n### 工程化现状\n\n这个项目最初确实是从篡改猴 / 暴力猴编辑框里的单文件脚本一路演化出来的。现在已经完成了一期工程化接管，但对外仍坚持兼容优先：\n\n- **源码已经工程化**：实现源码位于 `src/`，不再继续以“只改线上单文件”的方式维护\n- **发布产物路径不变**：正式产物仍然是 `dist/smart-feed-assistant.user.js`\n- **安装入口不变**：GitHub Raw 和 Greasy Fork 继续沿用原链接，不打断旧用户升级\n- **版本来源统一**：版本号由 `package.json` 单一来源注入到 userscript header\n- **用户配置兼容保留**：旧 GM 存储键和配置语义继续沿用，升级后不要求迁移\n\n小声说：以前那个超大单文件确实把产品先跑起来了，但它已经不适合继续维护。现在这层工程化改造的目标，不是推翻原产品，而是把它收编成一个能长期维护、能测试、能构建、能发布的正常项目。\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome / Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n如果初次使用油猴，可能要求进行一系列操作才能完成，比如[启用“允许用户脚本”切换开关或开发者模式](https://www.tampermonkey.net/faq.php#Q209)。油猴和暴力猴都是很强大的通用脚本承载器，网上也有不少详细教程。\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome / Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**，用户更多、教程也更丰富。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n\n### **[👉 点击安装（Greasy Fork）](https://greasyfork.org/zh-CN/scripts/553873-%E6%8A%96%E9%9F%B3%E6%8E%A8%E8%8D%90%E5%BD%B1%E5%93%8D%E5%99%A8-smart-feed-assistant)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```text\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey / Violentmonkey 扩展面板\n3. 点击设置，“添加新脚本”或“+”号\n4. 在“实用工具”标签页中找到“从 URL 安装”或“通过地址安装”\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **“安装”** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key，可以理解为“通行证”。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥，类似密码，用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **Google Gemini** | 可使用 Gemini 系列模型 | [立即获取](https://aistudio.google.com/apikey) |\n| **自定义 API** | 支持本地代理、第三方转发、CLIProxyAPI 等 OpenAI 兼容 API | 填写任意兼容 OpenAI 格式的 API Base URL |\n\n**新手推荐**：选择 **DeepSeek**，配置简单，且多数服务商都提供新用户免费额度。 \n**价格说明**：各家服务商的定价策略可能变化，建议以官网最新价格为准。通常新用户都有试用额度，部分模型还有免费档。\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额，点击 **“创建 API Key”**\n4. 复制生成的密钥，格式类似 `sk-xxxxxxxxxxxxxx`\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com) 的 **推荐** 界面，右下角 **关闭自动连播**\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中，按下面顺序填写：\n - **API Base URL 预设**：选择您刚才注册的服务商，如 DeepSeek、GLM、Gemini\n - **API Base URL**：预设会自动填好；如果使用本地或第三方转发，可选择 **自定义 OpenAI 兼容 API**，例如 `http://127.0.0.1:8317`\n - **API Key**：粘贴刚才复制的密钥，注意不要多复制空格\n4. 先点击 **“① 点击获取模型”**\n - 脚本会调用 OpenAI 兼容的 `/models` 接口读取可用模型\n - 预设 API 会自动选择一个推荐模型\n - 自定义 API 会显示 `<请选择模型>`，请手动选一个模型\n - 如果模型后面有备注，如 `gemini-3.1-flash-lite-preview（2026.5：推荐，免费/低成本）`，说明这是人工维护的展示说明；默认选择仍按成本启发式排序\n5. 再点击 **“② 点击测试连接”**\n - 看到成功提示后，说明 Base URL、API Key、模型三件事都通了\n - 如果失败，先看 **运行日志**，再检查 Base URL、Key 和模型是否匹配\n6. 选择预设模板或填写偏好规则，最后点击 **“💾 保存当前配置”**\n\n![演示图片](./assets/demoapi1.png)\n\n- 点击总是允许即可，脚本开源，无需额外授权担忧\n- 如果显示成功，说明配置正确\n- 如果显示失败，请先确认已经点击 **“① 点击获取模型”** 并选择了模型，再检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **破除信息茧房**：使当前视频偏好内容有所改变\n- **青少年内容引导**：过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识**：聚焦商业、科技、技能学习\n- **新闻与时事**：关注严肃新闻和时事分析\n- **健康生活**：健身、饮食、心理健康等内容\n- **艺术审美**：绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则**：描述您希望看到的内容，如“深度科普、技术教程”\n2. **忽略路过规则**：描述普通内容的标准，如“日常 Vlog、美食探店”\n3. **不感兴趣规则**：描述要过滤的内容，如“低俗娱乐、过度营销”\n\n**填写示例**：\n\n```text\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **“开始”** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞、忽略或“不感兴趣”操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**，不能切换到其他标签页\n- **避免最小化浏览器窗口**，否则脚本可能暂停\n- 可以在视频播放可见的情况下使用其他应用，如 QQ、微信，但不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据，如已处理、点赞、忽略、不感兴趣\n- **停止运行**：点击 **“停止”** 按钮即可终止\n- **自动停止**：达到设定的运行时长后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度，通常足够体验大量判断\n- 部分模型甚至有长期免费档\n- 正式使用后按调用次数计费，不同平台价格不同，请以官网为准\n- 参考量级上，低成本模型通常足够支撑大量推荐流微调\n\n**节省技巧**：\n- 设置较高的“内容跳过概率”，减少 API 调用次数\n- 控制每次运行时长，如 10-15 分钟\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 可以使用“深度思考”模型吗？\n\n**答**：可以尝试，但不建议新手优先选择。\n\n脚本会要求模型不要输出推理/思考过程，并优先读取最终回答。推理模型通常更慢、更贵，也更容易出现“只有思考、没有最终答案”的情况。处理抖音推荐流只需要快速判断，普通 chat、flash、lite、mini 这类低成本模型通常更合适。\n\n**推荐做法**：先点击 **“① 点击获取模型”**，优先选择带“推荐、免费、低成本、flash、lite”备注的模型。\n\n---\n\n### 3. 出现 400 / 401 / 422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误，注意前后空格\n- 选择的提供商与实际 Key 不匹配\n- 自定义 API Base URL 填写错误\n- 没有先获取模型，或者模型名填错\n- 当前 API Key 没有调用该模型的权限\n\n**排查步骤**：\n\n1. 检查 API Base URL 是否正确，预设用户可重新选择一次预设让脚本回填\n2. 检查 API Key 是否正确，尤其是前后空格\n3. 点击 **“① 点击获取模型”**，确认能拿到模型列表\n4. 选择一个模型后，再点击 **“② 点击测试连接”**\n5. 查看“运行日志”中的请求地址、HTTP 状态码和错误信息\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口\n- **不可以**：切换到其他标签页\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用\n\n**原因**：脚本依赖快捷键和 DOM 监听，需要页面保持活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据，包括 API Key，仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，不会上传到这个仓库\n- 源代码完全开源，可自行审查\n- AI 调用直接发送到您选择的服务商，不经过本项目的中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示“无法定位当前视频”？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 反馈给作者或提 Issue\n- 更新选择器配置\n- 欢迎有能力的开发者提交 Pull Request 修复\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送类似以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型\n- 支持标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **“显示详细调试信息”** 复选框\n2. 即可看到完整的 API 请求 / 响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：测试账号未出现明显问题，但无法做绝对保证。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性，若不放心建议小号测试\n- 抖音对新注册账号可能有风控期，建议先正常使用一段时间\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**\n - 打开 Tampermonkey / Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**\n - 有时是临时 DOM 加载问题\n\n3. **反馈问题**\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间\n - 浏览器版本\n - 错误日志截图\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短，会跳过该视频\n- 通常不影响整体判断准确性，仍可结合作者、标签等信息判断\n\n---\n\n## 开发者维护指南\n\n当前仓库已经不是“只在编辑框里维护的单文件脚本”了。源码和发布产物已经分层，日常维护请优先基于源码目录进行。\n\n### 当前代码结构\n\n```text\nsrc/\n├── ai/ # AI 请求拼装、响应解析、判定逻辑\n├── bootstrap/ # 页面入口和初始化\n├── config/ # 默认配置、模板、选择器、模型厂商目录\n├── controller/ # 主循环、错误恢复、运行状态\n├── entry/ # userscript 入口\n├── extractor/ # 抖音 DOM 提取逻辑\n├── runtime/ # 运行时上下文注入\n├── storage/ # GM 存储读写与兼容校验\n├── ui/ # 面板、日志、交互\n├── global.d.ts # GM / DOM 类型补充\n└── types.ts # 核心类型定义\n\nscripts/\n├── assemble-userscript.mjs\n├── check-dist-drift.mjs\n├── migrate-legacy-dist.mjs\n└── userscript-content.mjs\n\ntests/ # 单元测试、兼容性测试\ndist/ # 正式发布产物\ndocs/ # 维护指南与发布流程\n```\n\n### 本地基线\n\n- Node：`24.15.0`\n- 包管理器：`npm`\n- 推荐目录：`E:\\ProgramProject\\jsProject\\douyin-smart-feed-assistant`\n- 版本管理：建议继续通过 `nvm for Windows` 使用固定 Node 版本\n\n### 核心维护原则\n\n1. **`src/` 是源码事实来源**\n2. **`dist/smart-feed-assistant.user.js` 是正式发布产物**\n3. **`package.json` 是脚本版本号的单一来源**\n4. **不要再回到“只改线上单文件，不回写源码”的流程**\n\n### 常用命令\n\n```bash\nnpm install\nnpm run lint\nnpm run typecheck\nnpm run test\nnpm run build\nnpm run dist:check\n```\n\n如需发布前完整校验，可运行：\n\n```bash\nnpm run release:check\n```\n\n### 维护重点 1：更新 DOM 选择器\n\n如果抖音更新页面结构，最容易失效的是 `src/config/catalog.ts` 中的选择器数组。\n\n建议排查方式：\n\n1. 打开 F12 开发者工具\n2. 点击“选择元素”图标\n3. 悬停在视频标题、作者、标签区域\n4. 查看新的 HTML 结构或 `data-*` 属性\n5. 把新的选择器优先加到数组前面\n\n### 维护重点 2：新增或调整 API 提供商\n\n如果某个提供商变更了端点、模型名或请求参数，请优先更新 `src/config/catalog.ts` 中的 provider 配置，而不是散落修改请求逻辑。\n\n新增提供商时需要补齐：\n\n- `baseUrl`\n- `defaultModel`\n- `models`\n- 如 `/models` 不返回某个实际可调用的推荐模型，在 `modelSelectionOverrides.extraModelIds` 中补充候选模型；默认选择仍由成本启发式决定\n- 如需展示“推荐、免费、2026.5 仍可用”等人工备注，在 `modelLabelNotes` 中按精确 model id 维护\n\n### 维护重点 3：保持用户配置兼容\n\n- 继续沿用现有 GM 存储键\n- 新增字段时只做“追加默认值”，不要破坏旧用户读取\n- API Key 继续只存在用户脚本本地存储中，不进入仓库\n\n### 维护重点 4：严禁手改 dist\n\n`dist/smart-feed-assistant.user.js` 必须由构建流程生成。 \n如果 `dist:check` 失败，优先排查源码、构建脚本或 header 注入逻辑，而不是直接手改产物。\n\n### 更多维护文档\n\n- [维护指南](./docs/maintainer-guide.md)\n- [发布流程](./docs/release-process.md)\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献。无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库**\n2. **创建特性分支**：`git checkout -b feature/AmazingFeature`\n3. **提交更改**：`git commit -m \"Add some AmazingFeature\"`\n4. **推送到分支**：`git push origin feature/AmazingFeature`\n5. **提交 Pull Request**\n\n### 提交规范\n\n- **代码风格**：遵循现有工程结构和风格\n- **提交信息**：建议清晰描述变更内容\n- **测试**：至少确保 `npm run typecheck`、`npm run test`、`npm run build` 通过\n- **产物一致性**：如改动影响发布脚本，请同步更新 `dist`\n\n### 贡献方向建议\n\n- 修复已知 bug\n- 添加新的 AI 模型支持\n- 改进文档和教程\n- 优化界面设计\n- 更新 DOM 选择器\n- 补充测试覆盖\n- 完善发布、校验和工程化链路\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述，越详细越好\n2. 浏览器版本\n3. 脚本版本\n4. 错误日志截图\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues，比邮件更容易追踪\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果，包括但不限于账号封禁、限流、数据丢失、经济损失，作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护，但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM、Gemini、Claude 等 AI 服务提供商\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "46369cd8d585670d4b57266f133d5dd20875ee64": {"t": 1785761209.5262508, "n": 16098, "h": "8eaab5e4a7593b2d", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [适用场景](#适用场景)\n - [工程化现状](#工程化现状)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [反馈与支持](#反馈与支持)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，如时政、艺术、帅哥、美女等，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签等），根据你的偏好规则自动执行点赞、忽略或“不感兴趣”操作，持续向推荐算法反馈你的真实需求。\n\n在抖音网页版使用该工具后，同一账号在不同设备上的推流都有不同程度的改变，以此影响您的手机端视频推流。产生效果后用完即弃即可，完全可以直接卸载弃用该插件。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞、跳过、不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n### 核心特性\n\n- **AI 智能分析**：支持 DeepSeek、Kimi、通义千问、智谱 GLM、Gemini 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作**：根据预设规则自动执行点赞、忽略或标记“不感兴趣”，通过持续反馈逐步调教推荐算法\n- **行为模拟**：模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置**：内置多套预设模板（引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控**：所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本**：多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域，如科普、健身、艺术创作\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号上试图筛选出《明日方舟》相关视频，效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致，web/平板通常推荐横向长视频，手机推荐竖向短视频\n\n### 工程化现状\n\n这个项目最初确实是从篡改猴 / 暴力猴编辑框里的单文件脚本一路演化出来的。现在已经完成了一期工程化接管，但对外仍坚持兼容优先：\n\n- **源码已经工程化**：实现源码位于 `src/`，不再继续以“只改线上单文件”的方式维护\n- **发布产物路径不变**：正式产物仍然是 `dist/smart-feed-assistant.user.js`\n- **安装入口不变**：GitHub Raw 和 Greasy Fork 继续沿用原链接，不打断旧用户升级\n- **版本来源统一**：版本号由 `package.json` 单一来源注入到 userscript header\n- **用户配置兼容保留**：旧 GM 存储键和配置语义继续沿用，升级后不要求迁移\n\n小声说：以前那个超大单文件确实把产品先跑起来了，但它已经不适合继续维护。现在这层工程化改造的目标，不是推翻原产品，而是把它收编成一个能长期维护、能测试、能构建、能发布的正常项目。\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome / Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n如果初次使用油猴，可能要求进行一系列操作才能完成，比如[启用“允许用户脚本”切换开关或开发者模式](https://www.tampermonkey.net/faq.php#Q209)。油猴和暴力猴都是很强大的通用脚本承载器，网上也有不少详细教程。\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome / Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**，用户更多、教程也更丰富。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n\n### **[👉 点击安装（Greasy Fork）](https://greasyfork.org/zh-CN/scripts/553873-%E6%8A%96%E9%9F%B3%E6%8E%A8%E8%8D%90%E5%BD%B1%E5%93%8D%E5%99%A8-smart-feed-assistant)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```text\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey / Violentmonkey 扩展面板\n3. 点击设置，“添加新脚本”或“+”号\n4. 在“实用工具”标签页中找到“从 URL 安装”或“通过地址安装”\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **“安装”** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key，可以理解为“通行证”。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥，类似密码，用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **Google Gemini** | 可使用 Gemini 系列模型 | [立即获取](https://aistudio.google.com/apikey) |\n| **自定义 API** | 支持本地代理、第三方转发、CLIProxyAPI 等 OpenAI 兼容 API | 填写任意兼容 OpenAI 格式的 API Base URL |\n\n**新手推荐**：选择 **DeepSeek**，配置简单，且多数服务商都提供新用户免费额度。 \n**价格说明**：各家服务商的定价策略可能变化，建议以官网最新价格为准。通常新用户都有试用额度，部分模型还有免费档。\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额，点击 **“创建 API Key”**\n4. 复制生成的密钥，格式类似 `sk-xxxxxxxxxxxxxx`\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com) 的 **推荐** 界面，右下角 **关闭自动连播**\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中，按下面顺序填写：\n - **API Base URL 预设**：选择您刚才注册的服务商，如 DeepSeek、GLM、Gemini\n - **API Base URL**：预设会自动填好；如果使用本地或第三方转发，可选择 **自定义 OpenAI 兼容 API**，例如 `http://127.0.0.1:8317`\n - **API Key**：粘贴刚才复制的密钥，注意不要多复制空格\n4. 先点击 **“① 点击获取模型”**\n - 脚本会调用 OpenAI 兼容的 `/models` 接口读取可用模型\n - 预设 API 会自动选择一个推荐模型\n - 自定义 API 会显示 `<请选择模型>`，请手动选一个模型\n - 如果模型后面有备注，如 `gemini-3.1-flash-lite-preview（2026.5：首选推荐，免费/低成本）`，优先按备注选择\n5. 再点击 **“② 点击测试连接”**\n - 看到成功提示后，说明 Base URL、API Key、模型三件事都通了\n - 如果失败，先看 **运行日志**，再检查 Base URL、Key 和模型是否匹配\n6. 选择预设模板或填写偏好规则，最后点击 **“💾 保存当前配置”**\n\n![演示图片](./assets/demoapi1.png)\n\n- 点击总是允许即可，脚本开源，无需额外授权担忧\n- 如果显示成功，说明配置正确\n- 如果显示失败，请先确认已经点击 **“① 点击获取模型”** 并选择了模型，再检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **破除信息茧房**：使当前视频偏好内容有所改变\n- **青少年内容引导**：过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识**：聚焦商业、科技、技能学习\n- **新闻与时事**：关注严肃新闻和时事分析\n- **健康生活**：健身、饮食、心理健康等内容\n- **艺术审美**：绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则**：描述您希望看到的内容，如“深度科普、技术教程”\n2. **忽略路过规则**：描述普通内容的标准，如“日常 Vlog、美食探店”\n3. **不感兴趣规则**：描述要过滤的内容，如“低俗娱乐、过度营销”\n\n**填写示例**：\n\n```text\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **“开始”** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞、忽略或“不感兴趣”操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**，不能切换到其他标签页\n- **避免最小化浏览器窗口**，否则脚本可能暂停\n- 可以在视频播放可见的情况下使用其他应用，如 QQ、微信，但不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据，如已处理、点赞、忽略、不感兴趣\n- **停止运行**：点击 **“停止”** 按钮即可终止\n- **自动停止**：达到设定的运行时长后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度，通常足够体验大量判断\n- 部分模型甚至有长期免费档\n- 正式使用后按调用次数计费，不同平台价格不同，请以官网为准\n- 参考量级上，低成本模型通常足够支撑大量推荐流微调\n\n**节省技巧**：\n- 设置较高的“内容跳过概率”，减少 API 调用次数\n- 控制每次运行时长，如 10-15 分钟\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 可以使用“深度思考”模型吗？\n\n**答**：可以尝试，但不建议新手优先选择。\n\n脚本会要求模型不要输出推理/思考过程，并优先读取最终回答。推理模型通常更慢、更贵，也更容易出现“只有思考、没有最终答案”的情况。处理抖音推荐流只需要快速判断，普通 chat、flash、lite、mini 这类低成本模型通常更合适。\n\n**推荐做法**：先点击 **“① 点击获取模型”**，优先选择带“推荐、免费、低成本、flash、lite”备注的模型。\n\n---\n\n### 3. 出现 400 / 401 / 422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误，注意前后空格\n- 选择的提供商与实际 Key 不匹配\n- 自定义 API Base URL 填写错误\n- 没有先获取模型，或者模型名填错\n- 当前 API Key 没有调用该模型的权限\n\n**排查步骤**：\n\n1. 检查 API Base URL 是否正确，预设用户可重新选择一次预设让脚本回填\n2. 检查 API Key 是否正确，尤其是前后空格\n3. 点击 **“① 点击获取模型”**，确认能拿到模型列表\n4. 选择一个模型后，再点击 **“② 点击测试连接”**\n5. 查看“运行日志”中的请求地址、HTTP 状态码和错误信息\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口\n- **不可以**：切换到其他标签页\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用\n\n**原因**：脚本依赖快捷键和 DOM 监听，需要页面保持活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据，包括 API Key，仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，不会上传到这个仓库\n- 源代码完全开源，可自行审查\n- AI 调用直接发送到您选择的服务商，不经过本项目的中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示“无法定位当前视频”？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 反馈给作者或提 Issue\n- 更新选择器配置\n- 欢迎有能力的开发者提交 Pull Request 修复\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送类似以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型\n- 支持标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **“显示详细调试信息”** 复选框\n2. 即可看到完整的 API 请求 / 响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：测试账号未出现明显问题，但无法做绝对保证。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性，若不放心建议小号测试\n- 抖音对新注册账号可能有风控期，建议先正常使用一段时间\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**\n - 打开 Tampermonkey / Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**\n - 有时是临时 DOM 加载问题\n\n3. **反馈问题**\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间\n - 浏览器版本\n - 错误日志截图\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短，会跳过该视频\n- 通常不影响整体判断准确性，仍可结合作者、标签等信息判断\n\n---\n\n## 开发者维护指南\n\n当前仓库已经不是“只在编辑框里维护的单文件脚本”了。源码和发布产物已经分层，日常维护请优先基于源码目录进行。\n\n### 当前代码结构\n\n```text\nsrc/\n├── ai/ # AI 请求拼装、响应解析、判定逻辑\n├── bootstrap/ # 页面入口和初始化\n├── config/ # 默认配置、模板、选择器、模型厂商目录\n├── controller/ # 主循环、错误恢复、运行状态\n├── entry/ # userscript 入口\n├── extractor/ # 抖音 DOM 提取逻辑\n├── runtime/ # 运行时上下文注入\n├── storage/ # GM 存储读写与兼容校验\n├── ui/ # 面板、日志、交互\n├── global.d.ts # GM / DOM 类型补充\n└── types.ts # 核心类型定义\n\nscripts/\n├── assemble-userscript.mjs\n├── check-dist-drift.mjs\n├── migrate-legacy-dist.mjs\n└── userscript-content.mjs\n\ntests/ # 单元测试、兼容性测试\ndist/ # 正式发布产物\ndocs/ # 维护指南与发布流程\n```\n\n### 本地基线\n\n- Node：`24.15.0`\n- 包管理器：`npm`\n- 推荐目录：`E:\\ProgramProject\\jsProject\\douyin-smart-feed-assistant`\n- 版本管理：建议继续通过 `nvm for Windows` 使用固定 Node 版本\n\n### 核心维护原则\n\n1. **`src/` 是源码事实来源**\n2. **`dist/smart-feed-assistant.user.js` 是正式发布产物**\n3. **`package.json` 是脚本版本号的单一来源**\n4. **不要再回到“只改线上单文件，不回写源码”的流程**\n\n### 常用命令\n\n```bash\nnpm install\nnpm run lint\nnpm run typecheck\nnpm run test\nnpm run build\nnpm run dist:check\n```\n\n如需发布前完整校验，可运行：\n\n```bash\nnpm run release:check\n```\n\n### 维护重点 1：更新 DOM 选择器\n\n如果抖音更新页面结构，最容易失效的是 `src/config/catalog.ts` 中的选择器数组。\n\n建议排查方式：\n\n1. 打开 F12 开发者工具\n2. 点击“选择元素”图标\n3. 悬停在视频标题、作者、标签区域\n4. 查看新的 HTML 结构或 `data-*` 属性\n5. 把新的选择器优先加到数组前面\n\n### 维护重点 2：新增或调整 API 提供商\n\n如果某个提供商变更了端点、模型名或请求参数，请优先更新 `src/config/catalog.ts` 中的 provider 配置，而不是散落修改请求逻辑。\n\n新增提供商时需要补齐：\n\n- `baseUrl`\n- `defaultModel`\n- `models`\n- 如 `/models` 不返回某个实际可调用的推荐模型，在 `modelSelectionOverrides` 中补充 `preferredModel` 和 `extraModelIds`\n- 如需展示“推荐、免费、2026.5 仍可用”等人工备注，在 `modelLabelNotes` 中按精确 model id 维护\n\n### 维护重点 3：保持用户配置兼容\n\n- 继续沿用现有 GM 存储键\n- 新增字段时只做“追加默认值”，不要破坏旧用户读取\n- API Key 继续只存在用户脚本本地存储中，不进入仓库\n\n### 维护重点 4：严禁手改 dist\n\n`dist/smart-feed-assistant.user.js` 必须由构建流程生成。 \n如果 `dist:check` 失败，优先排查源码、构建脚本或 header 注入逻辑，而不是直接手改产物。\n\n### 更多维护文档\n\n- [维护指南](./docs/maintainer-guide.md)\n- [发布流程](./docs/release-process.md)\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献。无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库**\n2. **创建特性分支**：`git checkout -b feature/AmazingFeature`\n3. **提交更改**：`git commit -m \"Add some AmazingFeature\"`\n4. **推送到分支**：`git push origin feature/AmazingFeature`\n5. **提交 Pull Request**\n\n### 提交规范\n\n- **代码风格**：遵循现有工程结构和风格\n- **提交信息**：建议清晰描述变更内容\n- **测试**：至少确保 `npm run typecheck`、`npm run test`、`npm run build` 通过\n- **产物一致性**：如改动影响发布脚本，请同步更新 `dist`\n\n### 贡献方向建议\n\n- 修复已知 bug\n- 添加新的 AI 模型支持\n- 改进文档和教程\n- 优化界面设计\n- 更新 DOM 选择器\n- 补充测试覆盖\n- 完善发布、校验和工程化链路\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述，越详细越好\n2. 浏览器版本\n3. 脚本版本\n4. 错误日志截图\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues，比邮件更容易追踪\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果，包括但不限于账号封禁、限流、数据丢失、经济损失，作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护，但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM、Gemini、Claude 等 AI 服务提供商\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "ec3584f5fd6e09b9162eafc77d3e6c43a83d016a": {"t": 1785761210.9721553, "n": 15323, "h": "57b3ee50453c6e43", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [适用场景](#适用场景)\n - [工程化现状](#工程化现状)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [反馈与支持](#反馈与支持)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，如时政、艺术、帅哥、美女等，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签等），根据你的偏好规则自动执行点赞、忽略或“不感兴趣”操作，持续向推荐算法反馈你的真实需求。\n\n在抖音网页版使用该工具后，同一账号在不同设备上的推流都有不同程度的改变，以此影响您的手机端视频推流。产生效果后用完即弃即可，完全可以直接卸载弃用该插件。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞、跳过、不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n### 核心特性\n\n- **AI 智能分析**：支持 DeepSeek、Kimi、通义千问、智谱 GLM、Gemini 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作**：根据预设规则自动执行点赞、忽略或标记“不感兴趣”，通过持续反馈逐步调教推荐算法\n- **行为模拟**：模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置**：内置多套预设模板（引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控**：所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本**：多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域，如科普、健身、艺术创作\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号上试图筛选出《明日方舟》相关视频，效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致，web/平板通常推荐横向长视频，手机推荐竖向短视频\n\n### 工程化现状\n\n这个项目最初确实是从篡改猴 / 暴力猴编辑框里的单文件脚本一路演化出来的。现在已经完成了一期工程化接管，但对外仍坚持兼容优先：\n\n- **源码已经工程化**：实现源码位于 `src/`，不再继续以“只改线上单文件”的方式维护\n- **发布产物路径不变**：正式产物仍然是 `dist/smart-feed-assistant.user.js`\n- **安装入口不变**：GitHub Raw 和 Greasy Fork 继续沿用原链接，不打断旧用户升级\n- **版本来源统一**：版本号由 `package.json` 单一来源注入到 userscript header\n- **用户配置兼容保留**：旧 GM 存储键和配置语义继续沿用，升级后不要求迁移\n\n小声说：以前那个超大单文件确实把产品先跑起来了，但它已经不适合继续维护。现在这层工程化改造的目标，不是推翻原产品，而是把它收编成一个能长期维护、能测试、能构建、能发布的正常项目。\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome / Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n如果初次使用油猴，可能要求进行一系列操作才能完成，比如[启用“允许用户脚本”切换开关或开发者模式](https://www.tampermonkey.net/faq.php#Q209)。油猴和暴力猴都是很强大的通用脚本承载器，网上也有不少详细教程。\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome / Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**，用户更多、教程也更丰富。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n\n### **[👉 点击安装（Greasy Fork）](https://greasyfork.org/zh-CN/scripts/553873-%E6%8A%96%E9%9F%B3%E6%8E%A8%E8%8D%90%E5%BD%B1%E5%93%8D%E5%99%A8-smart-feed-assistant)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```text\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey / Violentmonkey 扩展面板\n3. 点击设置，“添加新脚本”或“+”号\n4. 在“实用工具”标签页中找到“从 URL 安装”或“通过地址安装”\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **“安装”** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key，可以理解为“通行证”。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥，类似密码，用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**，配置简单，且多数服务商都提供新用户免费额度。 \n**价格说明**：各家服务商的定价策略可能变化，建议以官网最新价格为准。通常新用户都有试用额度，部分模型还有免费档。\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额，点击 **“创建 API Key”**\n4. 复制生成的密钥，格式类似 `sk-xxxxxxxxxxxxxx`\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com) 的 **推荐** 界面，右下角 **关闭自动连播**\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商，如 DeepSeek\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可，如 `deepseek-chat`\n4. 点击 **“测试连接”** 按钮\n\n![演示图片](./assets/demoapi1.png)\n\n- 点击总是允许即可，脚本开源，无需额外授权担忧\n- 如果显示成功，说明配置正确\n- 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **破除信息茧房**：使当前视频偏好内容有所改变\n- **青少年内容引导**：过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识**：聚焦商业、科技、技能学习\n- **新闻与时事**：关注严肃新闻和时事分析\n- **健康生活**：健身、饮食、心理健康等内容\n- **艺术审美**：绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则**：描述您希望看到的内容，如“深度科普、技术教程”\n2. **忽略路过规则**：描述普通内容的标准，如“日常 Vlog、美食探店”\n3. **不感兴趣规则**：描述要过滤的内容，如“低俗娱乐、过度营销”\n\n**填写示例**：\n\n```text\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **“开始”** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞、忽略或“不感兴趣”操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**，不能切换到其他标签页\n- **避免最小化浏览器窗口**，否则脚本可能暂停\n- 可以在视频播放可见的情况下使用其他应用，如 QQ、微信，但不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据，如已处理、点赞、忽略、不感兴趣\n- **停止运行**：点击 **“停止”** 按钮即可终止\n- **自动停止**：达到设定的运行时长后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度，通常足够体验大量判断\n- 部分模型甚至有长期免费档\n- 正式使用后按调用次数计费，不同平台价格不同，请以官网为准\n- 参考量级上，低成本模型通常足够支撑大量推荐流微调\n\n**节省技巧**：\n- 设置较高的“内容跳过概率”，减少 API 调用次数\n- 控制每次运行时长，如 10-15 分钟\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用“深度思考”模型？\n\n**答**：推理模型，如 `deepseek-reasoner`、`R1` 等，会返回思考过程而非简洁回答，容易导致：\n\n1. **响应变慢**：思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高**：推理模型计费通常更贵\n3. **解析失败**：脚本当前更适配标准对话模型的输出格式\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`、`gpt-4o` 或其他常规 chat 模型。\n\n---\n\n### 3. 出现 400 / 422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误，注意前后空格\n- 选择的提供商与实际 Key 不匹配\n- 自定义 API 地址填写错误\n- 使用了推理模型\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确\n2. 确认“API 提供商”选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击“测试连接”查看详细错误信息\n5. 查看“运行日志”中的请求和响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口\n- **不可以**：切换到其他标签页\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用\n\n**原因**：脚本依赖快捷键和 DOM 监听，需要页面保持活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据，包括 API Key，仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，不会上传到这个仓库\n- 源代码完全开源，可自行审查\n- AI 调用直接发送到您选择的服务商，不经过本项目的中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示“无法定位当前视频”？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 反馈给作者或提 Issue\n- 更新选择器配置\n- 欢迎有能力的开发者提交 Pull Request 修复\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送类似以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型\n- 支持标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **“显示详细调试信息”** 复选框\n2. 即可看到完整的 API 请求 / 响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：测试账号未出现明显问题，但无法做绝对保证。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性，若不放心建议小号测试\n- 抖音对新注册账号可能有风控期，建议先正常使用一段时间\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**\n - 打开 Tampermonkey / Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**\n - 有时是临时 DOM 加载问题\n\n3. **反馈问题**\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间\n - 浏览器版本\n - 错误日志截图\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短，会跳过该视频\n- 通常不影响整体判断准确性，仍可结合作者、标签等信息判断\n\n---\n\n## 开发者维护指南\n\n当前仓库已经不是“只在编辑框里维护的单文件脚本”了。源码和发布产物已经分层，日常维护请优先基于源码目录进行。\n\n### 当前代码结构\n\n```text\nsrc/\n├── ai/ # AI 请求拼装、响应解析、判定逻辑\n├── bootstrap/ # 页面入口和初始化\n├── config/ # 默认配置、模板、选择器、模型厂商目录\n├── controller/ # 主循环、错误恢复、运行状态\n├── entry/ # userscript 入口\n├── extractor/ # 抖音 DOM 提取逻辑\n├── runtime/ # 运行时上下文注入\n├── storage/ # GM 存储读写与兼容校验\n├── ui/ # 面板、日志、交互\n├── global.d.ts # GM / DOM 类型补充\n└── types.ts # 核心类型定义\n\nscripts/\n├── assemble-userscript.mjs\n├── check-dist-drift.mjs\n├── migrate-legacy-dist.mjs\n└── userscript-content.mjs\n\ntests/ # 单元测试、兼容性测试\ndist/ # 正式发布产物\ndocs/ # 维护指南与发布流程\n```\n\n### 本地基线\n\n- Node：`24.15.0`\n- 包管理器：`npm`\n- 推荐目录：`E:\\ProgramProject\\jsProject\\douyin-smart-feed-assistant`\n- 版本管理：建议继续通过 `nvm for Windows` 使用固定 Node 版本\n\n### 核心维护原则\n\n1. **`src/` 是源码事实来源**\n2. **`dist/smart-feed-assistant.user.js` 是正式发布产物**\n3. **`package.json` 是脚本版本号的单一来源**\n4. **不要再回到“只改线上单文件，不回写源码”的流程**\n\n### 常用命令\n\n```bash\nnpm install\nnpm run lint\nnpm run typecheck\nnpm run test\nnpm run build\nnpm run dist:check\n```\n\n如需发布前完整校验，可运行：\n\n```bash\nnpm run release:check\n```\n\n### 维护重点 1：更新 DOM 选择器\n\n如果抖音更新页面结构，最容易失效的是 `src/config/catalog.ts` 中的选择器数组。\n\n建议排查方式：\n\n1. 打开 F12 开发者工具\n2. 点击“选择元素”图标\n3. 悬停在视频标题、作者、标签区域\n4. 查看新的 HTML 结构或 `data-*` 属性\n5. 把新的选择器优先加到数组前面\n\n### 维护重点 2：新增或调整 API 提供商\n\n如果某个提供商变更了端点、模型名或请求参数，请优先更新 `src/config/catalog.ts` 中的 provider 配置，而不是散落修改请求逻辑。\n\n新增提供商时需要补齐：\n\n- `endpoint`\n- `defaultModel`\n- `models`\n- `requestParams`\n- 如有厂商专属参数，再单独处理 `vendorSpecific`\n\n### 维护重点 3：保持用户配置兼容\n\n- 继续沿用现有 GM 存储键\n- 新增字段时只做“追加默认值”，不要破坏旧用户读取\n- API Key 继续只存在用户脚本本地存储中，不进入仓库\n\n### 维护重点 4：严禁手改 dist\n\n`dist/smart-feed-assistant.user.js` 必须由构建流程生成。 \n如果 `dist:check` 失败，优先排查源码、构建脚本或 header 注入逻辑，而不是直接手改产物。\n\n### 更多维护文档\n\n- [维护指南](./docs/maintainer-guide.md)\n- [发布流程](./docs/release-process.md)\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献。无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库**\n2. **创建特性分支**：`git checkout -b feature/AmazingFeature`\n3. **提交更改**：`git commit -m \"Add some AmazingFeature\"`\n4. **推送到分支**：`git push origin feature/AmazingFeature`\n5. **提交 Pull Request**\n\n### 提交规范\n\n- **代码风格**：遵循现有工程结构和风格\n- **提交信息**：建议清晰描述变更内容\n- **测试**：至少确保 `npm run typecheck`、`npm run test`、`npm run build` 通过\n- **产物一致性**：如改动影响发布脚本，请同步更新 `dist`\n\n### 贡献方向建议\n\n- 修复已知 bug\n- 添加新的 AI 模型支持\n- 改进文档和教程\n- 优化界面设计\n- 更新 DOM 选择器\n- 补充测试覆盖\n- 完善发布、校验和工程化链路\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述，越详细越好\n2. 浏览器版本\n3. 脚本版本\n4. 错误日志截图\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues，比邮件更容易追踪\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果，包括但不限于账号封禁、限流、数据丢失、经济损失，作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护，但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM、Gemini、Claude 等 AI 服务提供商\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "5b78387df462f8280d01552552b0f44e95bbc23c": {"t": 1785761212.4586792, "n": 14789, "h": "dde705429addd1bc", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，如时政/艺术/帅哥/美女等，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n在抖音网页版使用该工具后，同一账号在不同设备上的推流都有不同程度的改变，以此影响您的手机端视频推流。产生效果后用完即弃即可，完全可以直接卸载弃用该插件。\n\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n如果初次使用油猴，可能要求进行一系列操作才能完成，比如[启用 “允许用户脚本”切换开关 或 开发者模式](https://www.tampermonkey.net/faq.php#Q209)。油猴（或暴力猴）是一个很强大的通用脚本承载器，网上有诸多详细教程，请移步搜索。\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击设置，「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」或「通过地址安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n1. 打开 [抖音网页版](https://www.douyin.com)的**推荐**界面，右下角**关闭自动连播**\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n![演示图片](./assets/demoapi1.png)\n\n - 点击总是允许（脚本开源，无任何风险）\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **破除信息茧房** - 使当前视频偏好内容有所改变\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：测试账号未出现问题。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性，若不放心建议小号测试。（但要注意：抖音对新注册账号有3-7天的风控期，如果未到请先正常使用抖音）\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 修复已知 bug\n- 添加新的 AI 模型支持\n- 改进文档和教程\n- 优化界面设计\n- 更新 DOM 选择器（当抖音改版时）\n- 将单文件拆分为工程（下一步）\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM、Gemini、Claude 等 AI 服务提供商\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "47ea2561bca47468c51551a7bb3d4d5b76bd9a6c": {"t": 1785761214.072635, "n": 14763, "h": "cf555800ad67608a", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，如时政/艺术/帅哥/美女等，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n在抖音网页版使用该工具后，同一账号在不同设备上的推流都有不同程度的改变，以此影响您的手机端视频推流。产生效果后用完即弃即可，完全可以直接卸载弃用该插件。\n\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n如果初次使用油猴，可能要求进行一系列操作才能完成，比如[启用 “允许用户脚本”切换开关 或 开发者模式](https://www.tampermonkey.net/faq.php#Q209)。油猴（或暴力猴）是一个很强大的通用脚本承载器，网上有诸多详细教程，请移步搜索。\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击设置，「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」或「通过地址安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n1. 打开 [抖音网页版](https://www.douyin.com)的**推荐**界面，右下角**关闭自动连播**\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n![演示图片](./assets/demoapi1.png)\n\n - 点击总是允许（脚本开源，无任何风险）\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：测试账号未出现问题。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性，若不放心建议小号测试。（但要注意：抖音对新注册账号有3-7天的风控期，如果未到请先正常使用抖音）\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 修复已知 bug\n- 添加新的 AI 模型支持\n- 改进文档和教程\n- 优化界面设计\n- 更新 DOM 选择器（当抖音改版时）\n- 将单文件拆分为工程（下一步）\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM、Gemini、Claude 等 AI 服务提供商\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "489348bdb494c8d0e5bd16d91cbcbb29cd7fdb12": {"t": 1785761215.832537, "n": 14800, "h": "a3263d6ed5c4ce65", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，如时政/艺术/帅哥/美女等，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n在抖音网页版使用该工具后，同一账号在不同设备上的推流都有不同程度的改变，以此影响您的手机端视频推流。产生效果后用完即弃即可，完全可以直接卸载弃用该插件。\n\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n如果初次使用油猴，可能要求进行一系列操作才能完成，比如[启用 “允许用户脚本”切换开关 或 开发者模式](https://www.tampermonkey.net/faq.php#Q209)。油猴（或暴力猴）是一个很强大的通用脚本承载器，网上有诸多详细教程，请移步搜索。\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击设置，「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」或「通过地址安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n1. 打开 [抖音网页版](https://www.douyin.com)的**推荐**界面，右下角**关闭自动连播**\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n![演示图片](./assets/demoapi1.png)\n\n - 点击总是允许（脚本开源，无任何风险）\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：测试账号未出现问题。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性，若不放心建议小号测试。（但要注意：抖音对新注册账号有3-7天的风控期，如果未到请先正常使用抖音）\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 修复已知 bug\n- 添加新的 AI 模型支持\n- 改进文档和教程\n- 优化界面设计\n- 更新 DOM 选择器（当抖音改版时）\n- 将单文件拆分为工程（下一步）\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM、Gemini、Claude 等 AI 服务提供商\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "0f1cc4be67ce169ff09d9be36213536eec84f110": {"t": 1785761217.2675138, "n": 14772, "h": "3db34b9b0f4a1dbf", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，如时政/艺术/帅哥/美女等，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。在抖音网页版使用该工具后，同一账号在不同设备上的推流都有不同程度的改变，以此影响您的手机端视频推流。\n\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n如果初次使用油猴，可能要求进行一系列操作才能完成，比如[启用 “允许用户脚本”切换开关 或 开发者模式](https://www.tampermonkey.net/faq.php#Q209)。油猴（或暴力猴）是一个很强大的通用脚本承载器，网上有诸多详细教程，请移步搜索。\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击设置，「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」或「通过地址安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n1. 打开 [抖音网页版](https://www.douyin.com)的**推荐**界面，右下角**关闭自动连播**\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n![演示图片](./assets/demoapi1.png)\n\n - 点击总是允许（脚本开源，无任何风险）\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：测试账号未出现问题。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性，若不放心建议小号测试。（但要注意：抖音对新注册账号有3-7天的风控期，如果未到请先正常使用抖音）\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 修复已知 bug\n- 添加新的 AI 模型支持\n- 改进文档和教程\n- 优化界面设计\n- 更新 DOM 选择器（当抖音改版时）\n- 将单文件拆分为工程（下一步）\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM、Gemini、Claude 等 AI 服务提供商\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "e826402bc3ce9ddf7a629bebfc5d37ad557977a2": {"t": 1785761219.5923133, "n": 14722, "h": "3d820dc21a5fb96e", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，如时政/艺术/帅哥/美女等，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n如果初次使用油猴，可能要求进行一系列操作才能完成，比如[启用 “允许用户脚本”切换开关 或 开发者模式](https://www.tampermonkey.net/faq.php#Q209)。油猴（或暴力猴）是一个很强大的通用脚本承载器，网上有诸多详细教程，请移步搜索。\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击设置，「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」或「通过地址安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n1. 打开 [抖音网页版](https://www.douyin.com)的**推荐**界面，右下角**关闭自动连播**\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n![演示图片](./assets/demoapi1.png)\n\n - 点击总是允许（脚本开源，无任何风险）\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：测试账号未出现问题。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性，若不放心建议小号测试。（但要注意：抖音对新注册账号有3-7天的风控期，如果未到请先正常使用抖音）\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 修复已知 bug\n- 添加新的 AI 模型支持\n- 改进文档和教程\n- 优化界面设计\n- 更新 DOM 选择器（当抖音改版时）\n- 将单文件拆分为工程（下一步）\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM、Gemini、Claude 等 AI 服务提供商\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "c40056ca5be018f65679a325ee272a95c913785f": {"t": 1785761221.1721675, "n": 14765, "h": "696a675b6f3b3055", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，如时政/艺术/帅哥/美女等，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n如果初次使用油猴，可能要求进行一系列操作才能完成，比如[启用 “允许用户脚本”切换开关 或 开发者模式](https://www.tampermonkey.net/faq.php#Q209)。油猴（或暴力猴）是一个很强大的通用脚本承载器，网上有诸多详细教程，请移步搜索。\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击设置，「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」或「通过地址安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n1. 打开 [抖音网页版](https://www.douyin.com)的**推荐**界面，右下角**关闭自动连播**\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n![演示图片](./assets/demoapi1.png)\n\n - 点击总是允许（脚本开源，无任何风险）\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：测试账号未出现问题。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性，若不放心建议小号测试。（但要注意：抖音对新注册账号有3-7天的风控期，如果未到请先正常使用抖音）\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 修复已知 bug\n- 添加新的 AI 模型支持\n- 改进文档和教程\n- 优化界面设计\n- 更新 DOM 选择器（当抖音改版时）\n- 将单文件拆分为工程（下一步）\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM、Gemini、Claude 等 AI 服务提供商\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "31b2eec195ee94b40ef2d05ef1aedd1887422e41": {"t": 1785761222.5206406, "n": 14742, "h": "f404d19d7c8c7503", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，如时政/艺术/帅哥/美女等，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n如果初次使用油猴，可能要求进行一系列操作才能完成，比如[启用 “允许用户脚本”切换开关 或 开发者模式](https://www.tampermonkey.net/faq.php#Q209)。油猴（或暴力猴）是一个很强大的通用脚本承载器，网上有诸多详细教程，请移步搜索。\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击设置，「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」或「通过地址安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n![演示图片](./assets/demoapi1.png)\n\n - 点击总是允许（脚本开源，无任何风险）\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：测试账号未出现问题。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性，若不放心建议小号测试。（但要注意：抖音对新注册账号有3-7天的风控期，如果未到请先正常使用抖音）\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 修复已知 bug\n- 添加新的 AI 模型支持\n- 改进文档和教程\n- 优化界面设计\n- 更新 DOM 选择器（当抖音改版时）\n- 将单文件拆分为工程（下一步）\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM、Gemini、Claude 等 AI 服务提供商\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "ddf90ddb98341556e5bc36e6de4732b7f7c18eb7": {"t": 1785761223.9173074, "n": 14770, "h": "306a79b39b335a62", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，如时政/艺术/帅哥/美女等，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n如果初次使用油猴，可能要求进行一系列操作才能完成，比如[启用 “允许用户脚本”切换开关 或 开发者模式](https://www.tampermonkey.net/faq.php#Q209)。油猴（或暴力猴）是一个很强大的通用脚本承载器，网上有诸多详细教程，请移步搜索。\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击设置，「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」或「通过地址安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n![演示图片](./assets/demoapi1.png)\n\n - 点击总是允许（脚本开源，无任何风险）\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。（作者使用自己的大号进行长时间不间断测试）\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性，若不放心建议小号测试。（但要注意：抖音对新注册账号有3-7天的风控期，如果未到请先正常使用抖音）\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 修复已知 bug\n- 添加新的 AI 模型支持\n- 改进文档和教程\n- 优化界面设计\n- 更新 DOM 选择器（当抖音改版时）\n- 将单文件拆分为工程（下一步）\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM、Gemini、Claude 等 AI 服务提供商\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "948b3e6e16a5a63337dd4caa57440cd76bdf0353": {"t": 1785761225.1914606, "n": 14721, "h": "3065cffabc35a77f", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，如时政/艺术/帅哥/美女等，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n如果初次使用油猴，可能要求进行一系列操作才能完成，比如[启用 “允许用户脚本”切换开关 或 开发者模式](https://www.tampermonkey.net/faq.php#Q209)。油猴（或暴力猴）是一个很强大的通用脚本承载器，网上有诸多详细教程，请移步搜索。\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击设置，「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」或「通过地址安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n![演示图片](./assets/demoapi1.png)\n\n - 点击总是允许（脚本开源，无任何风险）\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。（作者使用自己的大号进行长时间不间断测试）\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 修复已知 bug\n- 添加新的 AI 模型支持\n- 改进文档和教程\n- 优化界面设计\n- 更新 DOM 选择器（当抖音改版时）\n- 将单文件拆分为工程（下一步）\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM、Gemini、Claude 等 AI 服务提供商\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "6e1efdb319b94da78c55cd5386cd7a8f24980606": {"t": 1785761226.9457772, "n": 14890, "h": "547fb5f83ee69954", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，如时政/艺术/帅哥/美女等，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n如果初次使用油猴，可能要求进行一系列操作才能完成，比如[启用 “允许用户脚本”切换开关 或 开发者模式](https://www.tampermonkey.net/faq.php#Q209)。油猴（或暴力猴）是一个很强大的通用脚本承载器，网上有诸多详细教程，请移步搜索。\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击设置，「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」或「通过地址安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n![演示图片](./assets/demoapi1.png)\n\n - 点击总是允许（脚本开源，无任何风险）\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。（作者使用自己的大号进行长时间不间断测试）\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "17c313b9b0ed911794d463acf1018c5cc9945961": {"t": 1785761228.4761934, "n": 14892, "h": "8442dd46e433d542", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n如果初次使用油猴，可能要求进行一系列操作才能完成，比如[启用 “允许用户脚本”切换开关 或 开发者模式](https://www.tampermonkey.net/faq.php#Q209)。油猴（或暴力猴）是一个很强大的通用脚本承载器，网上有诸多详细教程，请移步搜索。\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击设置，「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」或「通过地址安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n![演示图片](./assets/demoapi1.png)\n\n - 点击总是允许（脚本开源，无任何风险）\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。（作者使用自己的大号进行长时间不间断测试）\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "e7529b2e44b355b20b6907b61d42fc1844f084ed": {"t": 1785761229.8933668, "n": 14755, "h": "8d52ea2d2b5346df", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击设置，「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」或「通过地址安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n![演示图片](./assets/demoapi1.png)\n\n - 点击总是允许（脚本开源，无任何风险）\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。（作者使用自己的大号进行长时间不间断测试）\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "999b45b126440bb80b2dd56996b24e0bbc56afee": {"t": 1785761232.4690275, "n": 14700, "h": "65a2ca9cfa1c65ba", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击设置，「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」或「通过地址安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。（作者使用自己的大号进行长时间不间断测试）\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "1bb721a26a5ded6b7cc61c69df595ff559657332": {"t": 1785761233.8975086, "n": 14754, "h": "34bb99ef53b5630a", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![版本](https://img.shields.io/badge/版本-2.0.0-blue.svg)\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击设置，「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」或「通过地址安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。（作者使用自己的大号进行长时间不间断测试）\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "f3817661b1f4e89f9567a06182fc7ed0e4762328": {"t": 1785761235.675017, "n": 15067, "h": "2f0628718ac81e26", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![版本](https://img.shields.io/badge/版本-2.0.0-blue.svg)\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击设置，「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」或「通过地址安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。（作者使用自己的大号进行长时间不间断测试）\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## 更新日志\n\n### v2.0.0 (2025.10)\n\n- 🎉 重构代码架构，提升稳定性和可维护性\n- ✨ 新增多个预设模板（青少年引导、效率知识等）\n- 🚀 优化 AI 调用逻辑，降低超时概率\n- 🔧 新增详细调试日志开关，方便排查问题\n- 🛠️ 改进 DOM 选择器，适配最新版抖音网页版\n- 🚨 新增连续错误检测机制，自动识别脚本失效\n- 💾 优化配置保存逻辑，解决 NaN 数据问题\n- 🔒 增强安全性，防止 XSS 攻击\n- 🎨 改进用户界面，提升易用性和美观度\n- 📝 完善文档和使用说明\n\n### v1.x (早期版本)\n\n- 初始版本发布\n- 基础功能实现\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**当前版本**：2.0.0 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "10c0b3b683798a5250f1a593377337bbcc7fed5c": {"t": 1785761237.188278, "n": 15162, "h": "6f0016e16d2fddd3", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![版本](https://img.shields.io/badge/版本-2.0.0-blue.svg)\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\n[https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/main/dist/smart-feed-assistant.user.js)\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。（作者使用自己的大号进行长时间不间断测试）\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## 更新日志\n\n### v2.0.0 (2025.10)\n\n- 🎉 重构代码架构，提升稳定性和可维护性\n- ✨ 新增多个预设模板（青少年引导、效率知识等）\n- 🚀 优化 AI 调用逻辑，降低超时概率\n- 🔧 新增详细调试日志开关，方便排查问题\n- 🛠️ 改进 DOM 选择器，适配最新版抖音网页版\n- 🚨 新增连续错误检测机制，自动识别脚本失效\n- 💾 优化配置保存逻辑，解决 NaN 数据问题\n- 🔒 增强安全性，防止 XSS 攻击\n- 🎨 改进用户界面，提升易用性和美观度\n- 📝 完善文档和使用说明\n\n### v1.x (早期版本)\n\n- 初始版本发布\n- 基础功能实现\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**当前版本**：2.0.0 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "85c65a2562ef813be1bf49676eaf129854d90cc4": {"t": 1785761239.5464807, "n": 15045, "h": "36b82b53b918b699", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![版本](https://img.shields.io/badge/版本-2.0.0-blue.svg)\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。（作者使用自己的大号进行长时间不间断测试）\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## 更新日志\n\n### v2.0.0 (2025.10)\n\n- 🎉 重构代码架构，提升稳定性和可维护性\n- ✨ 新增多个预设模板（青少年引导、效率知识等）\n- 🚀 优化 AI 调用逻辑，降低超时概率\n- 🔧 新增详细调试日志开关，方便排查问题\n- 🛠️ 改进 DOM 选择器，适配最新版抖音网页版\n- 🚨 新增连续错误检测机制，自动识别脚本失效\n- 💾 优化配置保存逻辑，解决 NaN 数据问题\n- 🔒 增强安全性，防止 XSS 攻击\n- 🎨 改进用户界面，提升易用性和美观度\n- 📝 完善文档和使用说明\n\n### v1.x (早期版本)\n\n- 初始版本发布\n- 基础功能实现\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**当前版本**：2.0.0 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "02109a87c4bd54b1c8fb73c9db91741a4e89a9e0": {"t": 1785761241.121991, "n": 15044, "h": "0ea5916c3b539881", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![版本](https://img.shields.io/badge/版本-2.0.0-blue.svg)\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n较为简单：推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、艺术审美等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果。也有很多途径使其免费）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断，约一小时），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，可能需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。指定免费模型：glm4-flash！\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，确保有余额（1元足矣），点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本没适配，无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **避免**：最小化浏览器窗口（可能导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。（作者使用自己的大号进行长时间不间断测试）\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra...（见代码，会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## 更新日志\n\n### v2.0.0 (2025.10)\n\n- 🎉 重构代码架构，提升稳定性和可维护性\n- ✨ 新增多个预设模板（青少年引导、效率知识等）\n- 🚀 优化 AI 调用逻辑，降低超时概率\n- 🔧 新增详细调试日志开关，方便排查问题\n- 🛠️ 改进 DOM 选择器，适配最新版抖音网页版\n- 🚨 新增连续错误检测机制，自动识别脚本失效\n- 💾 优化配置保存逻辑，解决 NaN 数据问题\n- 🔒 增强安全性，防止 XSS 攻击\n- 🎨 改进用户界面，提升易用性和美观度\n- 📝 完善文档和使用说明\n\n### v1.x (早期版本)\n\n- 初始版本发布\n- 基础功能实现\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**当前版本**：2.0.0 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "84ab467d28fa17fec6e858bcdfae0d7104b85a65": {"t": 1785761243.2492344, "n": 15012, "h": "96f383d1c6ea43aa", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![版本](https://img.shields.io/badge/版本-2.0.0-blue.svg)\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、健康生活等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频（大约需要600次判断），效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，通常需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **不可以**：最小化浏览器窗口（会导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 推荐设置 `stream: false`（但部分模型可能不支持该参数，脚本已尽力兼容）\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra_body（会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## 更新日志\n\n### v2.0.0 (2025.10)\n\n- 🎉 重构代码架构，提升稳定性和可维护性\n- ✨ 新增多个预设模板（青少年引导、效率知识等）\n- 🚀 优化 AI 调用逻辑，降低超时概率\n- 🔧 新增详细调试日志开关，方便排查问题\n- 🛠️ 改进 DOM 选择器，适配最新版抖音网页版\n- 🚨 新增连续错误检测机制，自动识别脚本失效\n- 💾 优化配置保存逻辑，解决 NaN 数据问题\n- 🔒 增强安全性，防止 XSS 攻击\n- 🎨 改进用户界面，提升易用性和美观度\n- 📝 完善文档和使用说明\n\n### v1.x (早期版本)\n\n- 初始版本发布\n- 基础功能实现\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**当前版本**：2.0.0 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "9b75e1e47923cad3b3bbe9c7fdef6427dd084666": {"t": 1785761244.5762904, "n": 15000, "h": "de2b8386cd75bbcf", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![版本](https://img.shields.io/badge/版本-2.0.0-blue.svg)\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、健康生活等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频，效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，通常需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下任一链接安装脚本**：\n### **[👉 点击安装（GreasyFork）](https://greasyfork.org/zh-CN/scripts/553873)**\n### **[👉 点击安装（GitHub）](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **不可以**：最小化浏览器窗口（会导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 推荐设置 `stream: false`（但部分模型可能不支持该参数，脚本已尽力兼容）\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra_body（会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## 更新日志\n\n### v2.0.0 (2025.10)\n\n- 🎉 重构代码架构，提升稳定性和可维护性\n- ✨ 新增多个预设模板（青少年引导、效率知识等）\n- 🚀 优化 AI 调用逻辑，降低超时概率\n- 🔧 新增详细调试日志开关，方便排查问题\n- 🛠️ 改进 DOM 选择器，适配最新版抖音网页版\n- 🚨 新增连续错误检测机制，自动识别脚本失效\n- 💾 优化配置保存逻辑，解决 NaN 数据问题\n- 🔒 增强安全性，防止 XSS 攻击\n- 🎨 改进用户界面，提升易用性和美观度\n- 📝 完善文档和使用说明\n\n### v1.x (早期版本)\n\n- 初始版本发布\n- 基础功能实现\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**当前版本**：2.0.0 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "74fdb1e6423f10da6e0fb648ccb58170a27b9e40": {"t": 1785761245.964073, "n": 14921, "h": "188f1e3b5ea419e7", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![版本](https://img.shields.io/badge/版本-2.0.0-blue.svg)\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、健康生活等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频，效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，通常需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n小声说：感谢Claude的大力援助，原本只是想做一个小小的单文件，但Claude编程效率很高所以演化成当前这种大型单文件。然而单文件是不可持续的，后续会拆分成常规工程化项目\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下链接安装脚本**：\n\n### **[👉 点击这里安装脚本](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **不可以**：最小化浏览器窗口（会导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 推荐设置 `stream: false`（但部分模型可能不支持该参数，脚本已尽力兼容）\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra_body（会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## 更新日志\n\n### v2.0.0 (2025.10)\n\n- 🎉 重构代码架构，提升稳定性和可维护性\n- ✨ 新增多个预设模板（青少年引导、效率知识等）\n- 🚀 优化 AI 调用逻辑，降低超时概率\n- 🔧 新增详细调试日志开关，方便排查问题\n- 🛠️ 改进 DOM 选择器，适配最新版抖音网页版\n- 🚨 新增连续错误检测机制，自动识别脚本失效\n- 💾 优化配置保存逻辑，解决 NaN 数据问题\n- 🔒 增强安全性，防止 XSS 攻击\n- 🎨 改进用户界面，提升易用性和美观度\n- 📝 完善文档和使用说明\n\n### v1.x (早期版本)\n\n- 初始版本发布\n- 基础功能实现\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**当前版本**：2.0.0 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "ff2487096fa8906e849ce6e082ac18bf43bcf2cf": {"t": 1785761247.3314571, "n": 14835, "h": "922075bb149afd4a", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![版本](https://img.shields.io/badge/版本-2.0.0-blue.svg)\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n您可能对您的抖音账号思考过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、健康生活等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频，效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，通常需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下链接安装脚本**：\n\n### **[👉 点击这里安装脚本](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **不可以**：最小化浏览器窗口（会导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 推荐设置 `stream: false`（但部分模型可能不支持该参数，脚本已尽力兼容）\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra_body（会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## 更新日志\n\n### v2.0.0 (2025.10)\n\n- 🎉 重构代码架构，提升稳定性和可维护性\n- ✨ 新增多个预设模板（青少年引导、效率知识等）\n- 🚀 优化 AI 调用逻辑，降低超时概率\n- 🔧 新增详细调试日志开关，方便排查问题\n- 🛠️ 改进 DOM 选择器，适配最新版抖音网页版\n- 🚨 新增连续错误检测机制，自动识别脚本失效\n- 💾 优化配置保存逻辑，解决 NaN 数据问题\n- 🔒 增强安全性，防止 XSS 攻击\n- 🎨 改进用户界面，提升易用性和美观度\n- 📝 完善文档和使用说明\n\n### v1.x (早期版本)\n\n- 初始版本发布\n- 基础功能实现\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**当前版本**：2.0.0 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "aa7ae0affeab54b59c60dea6fbe66d23d6d25e47": {"t": 1785761248.7764642, "n": 14833, "h": "fd98f21175351f68", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![版本](https://img.shields.io/badge/版本-2.0.0-blue.svg)\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n您的抖音账号是否遇到过这些问题：\n- **推荐流充斥着低质内容**，刷半天找不到一个有价值的视频\n- **想给孩子/长辈控制推荐内容**，但手动筛选效率太低\n- **深陷信息茧房**，每天看的都是同类型视频，视野越来越窄\n- **想快速调整推荐方向**，但抖音反应慢\n\n**抖音推荐影响器** 是一款基于 AI 的自动化工具，通过调用大语言模型分析视频内容（标题、作者、标签），根据你的偏好规则自动执行点赞、忽略或\"不感兴趣\"操作，持续向推荐算法反馈你的真实需求。\n\n**原理**： \n推荐算法依赖用户行为反馈（点赞/跳过/不感兴趣）来调整内容分发。本工具通过自动化这一过程，加速算法学习你的偏好，让推荐流逐步符合你的期待。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、健康生活等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频，效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，通常需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n- **多设备推荐内容可能不完全同步**：这是由于抖音本身算法导致（web/平板通常推荐横向长视频，手机推荐竖向短视频）\n\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下链接安装脚本**：\n\n### **[👉 点击这里安装脚本](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **不可以**：最小化浏览器窗口（会导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 推荐设置 `stream: false`（但部分模型可能不支持该参数，脚本已尽力兼容）\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra_body（会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## 更新日志\n\n### v2.0.0 (2025.10)\n\n- 🎉 重构代码架构，提升稳定性和可维护性\n- ✨ 新增多个预设模板（青少年引导、效率知识等）\n- 🚀 优化 AI 调用逻辑，降低超时概率\n- 🔧 新增详细调试日志开关，方便排查问题\n- 🛠️ 改进 DOM 选择器，适配最新版抖音网页版\n- 🚨 新增连续错误检测机制，自动识别脚本失效\n- 💾 优化配置保存逻辑，解决 NaN 数据问题\n- 🔒 增强安全性，防止 XSS 攻击\n- 🎨 改进用户界面，提升易用性和美观度\n- 📝 完善文档和使用说明\n\n### v1.x (早期版本)\n\n- 初始版本发布\n- 基础功能实现\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**当前版本**：2.0.0 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "4b24e7b740836edb2347f5ba591764dd4f501e45": {"t": 1785761250.1958277, "n": 14569, "h": "1d116136fcbf1515", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![版本](https://img.shields.io/badge/版本-2.0.0-blue.svg)\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n**抖音推荐影响器** 是一款基于人工智能的用户脚本工具，通过调用大语言模型 API 自动分析抖音推荐流中的视频内容，并根据用户预设的偏好规则执行点赞、忽略或标记\"不感兴趣\"等操作，从而逐步优化推荐算法，提升信息流质量。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、健康生活等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./assets/demo1.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频，效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，通常需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下链接安装脚本**：\n\n### **[👉 点击这里安装脚本](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **不可以**：最小化浏览器窗口（会导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 推荐设置 `stream: false`（但部分模型可能不支持该参数，脚本已尽力兼容）\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra_body（会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## 更新日志\n\n### v2.0.0 (2025.10)\n\n- 🎉 重构代码架构，提升稳定性和可维护性\n- ✨ 新增多个预设模板（青少年引导、效率知识等）\n- 🚀 优化 AI 调用逻辑，降低超时概率\n- 🔧 新增详细调试日志开关，方便排查问题\n- 🛠️ 改进 DOM 选择器，适配最新版抖音网页版\n- 🚨 新增连续错误检测机制，自动识别脚本失效\n- 💾 优化配置保存逻辑，解决 NaN 数据问题\n- 🔒 增强安全性，防止 XSS 攻击\n- 🎨 改进用户界面，提升易用性和美观度\n- 📝 完善文档和使用说明\n\n### v1.x (早期版本)\n\n- 初始版本发布\n- 基础功能实现\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**当前版本**：2.0.0 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "1c5be51e72a475b80c63eef94d4426b6e49c4bc3": {"t": 1785761251.6955836, "n": 14568, "h": "68320bc4c4861b1e", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![版本](https://img.shields.io/badge/版本-2.0.0-blue.svg)\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n**抖音推荐影响器** 是一款基于人工智能的用户脚本工具，通过调用大语言模型 API 自动分析抖音推荐流中的视频内容，并根据用户预设的偏好规则执行点赞、忽略或标记\"不感兴趣\"等操作，从而逐步优化推荐算法，提升信息流质量。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、健康生活等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n![演示图片](./images/demo.png)\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频，效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，通常需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下链接安装脚本**：\n\n### **[👉 点击这里安装脚本](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **不可以**：最小化浏览器窗口（会导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 推荐设置 `stream: false`（但部分模型可能不支持该参数，脚本已尽力兼容）\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra_body（会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## 更新日志\n\n### v2.0.0 (2025.10)\n\n- 🎉 重构代码架构，提升稳定性和可维护性\n- ✨ 新增多个预设模板（青少年引导、效率知识等）\n- 🚀 优化 AI 调用逻辑，降低超时概率\n- 🔧 新增详细调试日志开关，方便排查问题\n- 🛠️ 改进 DOM 选择器，适配最新版抖音网页版\n- 🚨 新增连续错误检测机制，自动识别脚本失效\n- 💾 优化配置保存逻辑，解决 NaN 数据问题\n- 🔒 增强安全性，防止 XSS 攻击\n- 🎨 改进用户界面，提升易用性和美观度\n- 📝 完善文档和使用说明\n\n### v1.x (早期版本)\n\n- 初始版本发布\n- 基础功能实现\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**当前版本**：2.0.0 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}, "3060f8e9d381c3db47c81112e6571b52057d7717": {"t": 1785761253.0801492, "n": 14540, "h": "a542c6986ce40f9c", "c": "# 抖音推荐影响器 (Douyin Smart Feed Assistant)\n\n
\n\n![版本](https://img.shields.io/badge/版本-2.0.0-blue.svg)\n![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)\n![平台](https://img.shields.io/badge/平台-Tampermonkey%20%7C%20Violentmonkey-orange.svg)\n\n**通过 AI 智能分析，让你的抖音推荐流更符合你的品味**\n\n[快速开始](#安装指南) • [使用教程](#使用教程零基础版) • [常见问题](#常见问题faq) • [贡献代码](#贡献指南)\n\n**如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！**\n\n
\n\n---\n\n## 📑 目录\n\n- [项目简介](#项目简介)\n - [核心特性](#核心特性)\n - [效果展示](#效果展示)\n- [安装指南](#安装指南)\n - [第一步：安装浏览器扩展管理器](#第一步安装浏览器扩展管理器)\n - [第二步：安装本脚本](#第二步安装本脚本)\n- [使用教程（零基础版）](#使用教程零基础版)\n - [步骤一：获取 API Key](#步骤一获取-api-key)\n - [步骤二：配置脚本](#步骤二配置脚本)\n - [步骤三：设置偏好规则](#步骤三设置偏好规则)\n - [步骤四：启动脚本](#步骤四启动脚本)\n - [步骤五：查看统计与停止](#步骤五查看统计与停止)\n- [高级选项说明](#高级选项说明)\n- [常见问题（FAQ）](#常见问题faq)\n- [开发者维护指南](#开发者维护指南)\n- [贡献指南](#贡献指南)\n- [免责声明](#免责声明)\n- [许可证](#许可证)\n- [更新日志](#更新日志)\n\n---\n\n## 项目简介\n\n**抖音推荐影响器** 是一款基于人工智能的用户脚本工具，通过调用大语言模型 API 自动分析抖音推荐流中的视频内容，并根据用户预设的偏好规则执行点赞、忽略或标记\"不感兴趣\"等操作，从而逐步优化推荐算法，提升信息流质量。\n\n\n### 核心特性\n\n- **AI 智能分析** - 支持 DeepSeek、Kimi、通义千问、智谱 GLM 等多个主流大模型，也支持自定义 OpenAI 兼容 API\n- **自动化操作** - 根据预设规则自动执行点赞、忽略或标记\"不感兴趣\"，通过持续反馈逐步调教推荐算法\n- **行为模拟** - 模拟真人观看时长、随机跳过部分视频、动态延迟控制，降低被检测风险\n- **灵活配置** - 内置多套预设模板（青少年引导、效率知识、健康生活等），也可完全自定义规则\n- **透明可控** - 所有配置本地存储，API Key 不上传任何服务器，开源代码可审查\n- **低成本** - 多数 API 提供商有免费额度，付费使用成本约 1 元可处理 1000+ 次判断（足以产生效果）\n\n\n### 适用场景\n\n本工具通过持续的自动化反馈来调整抖音推荐算法的输出方向，适用于以下场景：\n\n**内容监管与引导**\n- 家长控制未成年人设备的推荐内容，过滤不适宜视频\n- 子女为长辈设备筛选内容，减少低质量信息和诱导消费\n\n**打破信息茧房**\n- 主动调整推荐算法偏好，接触更多元化的内容类型\n- 避免长期沉浸在单一类型视频中\n\n**聚焦特定兴趣**\n- 快速将推荐流调整为某一垂直领域（如科普、健身、艺术创作）\n- 过滤无关内容，提升信息获取效率\n\n**局限性说明**\n- **不适合从零培养新兴趣**：例如在从未看过二次元内容的账号试图筛选出《明日方舟》相关视频，效率远低于直接搜索\n- **需要持续运行**：推荐算法调整需要一定时间和数据量，通常需要运行多次才能见效\n- **依赖算法反馈机制**：最终效果受抖音推荐系统的响应速度和策略影响\n\n\n**⭐ 如果你也想让抖音推荐更懂你，请点击右上角 Star 收藏本项目！**\n\n---\n\n## 安装指南\n\n### 第一步：安装浏览器扩展管理器\n\n本脚本需要通过用户脚本管理器运行，请根据您的浏览器选择以下任一扩展：\n\n#### 方案一：Tampermonkey（油猴）\n\n**支持浏览器**：Chrome、Edge、Firefox、Safari、Opera\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)\n- Safari：[App Store](https://apps.apple.com/app/tampermonkey/id1482490089)\n\n#### 方案二：Violentmonkey（暴力猴）\n\n**支持浏览器**：Chrome、Edge、Firefox\n\n**安装链接**：\n- Chrome/Edge：[Chrome 网上应用商店](https://chrome.google.com/webstore/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag)\n- Firefox：[Firefox 附加组件](https://addons.mozilla.org/zh-CN/firefox/addon/violentmonkey/)\n\n**推荐选择**：两者功能基本相同，如果您是新手，推荐使用 **Tampermonkey**（用户更多，教程更丰富）。\n\n---\n\n### 第二步：安装本脚本\n\n安装好扩展管理器后，**点击以下链接安装脚本**：\n\n### **[👉 点击这里安装脚本](https://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js)**\n\n> 💡 **提示**：点击上方链接后，扩展管理器会自动弹出安装确认页面\n\n
\n📋 如果链接无法打开，点击展开查看手动安装方法\n\n**手动安装步骤**：\n1. 复制以下地址：\n```\nhttps://raw.githubusercontent.com/baianjo/Douyin-Smart-Feed-Assistant/dist/smart-feed-assistant.user.js\n```\n2. 打开 Tampermonkey/Violentmonkey 扩展面板\n3. 点击「添加新脚本」或「+」号\n4. 在「实用工具」标签页中找到「从 URL 安装」\n5. 粘贴上方地址并确认安装\n\n
\n\n**详细步骤**：\n\n1. 点击上方链接，浏览器会自动识别为用户脚本\n2. 扩展管理器会弹出安装确认页面\n3. 点击 **\"安装\"** 按钮\n4. 安装成功后，访问 [抖音网页版](https://www.douyin.com) 即可看到右侧悬浮的机器人图标\n\n**注意事项**：\n- 脚本仅在抖音网页版（`www.douyin.com`）生效\n- 移动端 APP 无法使用\n\n**安装成功后别忘记给项目点个 ⭐ Star 哦！这是对作者最大的鼓励！**\n\n---\n\n## 使用教程（零基础版）\n\n### 步骤一：获取 API Key\n\n本脚本需要调用大语言模型进行内容分析，您需要先获取 API Key（理解为\"通行证\"即可）。\n\n#### 什么是 API Key？\n\nAPI Key 是一串由字母和数字组成的密钥（类似密码），用于向 AI 服务商证明您的身份。获取后粘贴到脚本配置中即可使用。\n\n#### 如何选择 AI 服务商？\n\n| 服务商 | 推荐理由 | 获取链接 |\n|--------|----------|----------|\n| **DeepSeek** ⭐ | 新手首选，性价比高，注册简单 | [立即获取](https://platform.deepseek.com/api_keys) |\n| **Kimi** | 月之暗面出品，国内访问稳定 | [立即获取](https://platform.moonshot.cn/console/api-keys) |\n| **通义千问** | 阿里云旗下，企业级稳定性 | [立即获取](https://dashscope.console.aliyun.com/apiKey) |\n| **智谱 GLM** | 清华系模型，中文理解能力强 | [立即获取](https://open.bigmodel.cn/usercenter/apikeys) |\n| **自定义 API** | 适合有技术背景的用户 | 填写任意兼容 OpenAI 格式的 API |\n\n**新手推荐**：选择 **DeepSeek**（配置简单，且多数服务商都提供新用户免费额度）。\n\n**价格说明**：各家服务商的定价策略不同，且可能随时调整。建议在官网查看最新价格，多数平台提供免费试用额度供新用户体验。\n\n#### 获取步骤（以 DeepSeek 为例）\n\n1. 点击 [DeepSeek 官网](https://platform.deepseek.com/api_keys)\n2. 使用手机号或邮箱注册账号\n3. 进入控制台后，点击 **\"创建 API Key\"**\n4. 复制生成的密钥（格式类似 `sk-xxxxxxxxxxxxxx`）\n5. **妥善保管**：此密钥关联您的账户余额，切勿泄露\n\n---\n\n### 步骤二：配置脚本\n\n1. 打开 [抖音网页版](https://www.douyin.com)\n2. 点击页面右侧的 **机器人图标**，展开控制面板\n3. 在 **基础设置** 标签页中：\n - **API 提供商**：选择您刚才注册的服务商（如 DeepSeek）\n - **API Key**：粘贴刚才复制的密钥\n - **模型选择**：保持默认即可（如 `deepseek-chat`）\n4. 点击 **\"测试连接\"** 按钮\n - 如果显示成功，说明配置正确\n - 如果显示失败，请检查 API Key 是否正确\n\n---\n\n### 步骤三：设置偏好规则\n\n在 **基础设置** 中，您可以选择预设模板或自定义规则：\n\n#### 使用预设模板（推荐新手）\n\n点击 **预设模板** 下拉菜单，选择符合您需求的模板：\n\n- **青少年内容引导** - 过滤低俗、娱乐化内容，推荐知识、科普类视频\n- **效率与知识** - 聚焦商业、科技、技能学习\n- **新闻与时事** - 关注严肃新闻和时事分析\n- **健康生活** - 健身、饮食、心理健康等内容\n- **艺术审美** - 绘画、音乐、设计等艺术创作\n- 还可以筛选帅哥美女\n\n选择后，脚本会自动填充对应的规则描述。\n\n#### 自定义规则\n\n如果预设模板不满足需求，可以手动编辑三个规则框：\n\n1. **点赞收藏规则** - 描述您希望看到的内容（如\"深度科普、技术教程\"）\n2. **忽略路过规则** - 描述普通内容的标准（如\"日常 Vlog、美食探店\"）\n3. **不感兴趣规则** - 描述要过滤的内容（如\"低俗娱乐、过度营销\"）\n\n**填写示例**：\n\n```\n【点赞规则】\n我希望看到系统性的知识讲解、专业技能展示、逻辑思辨类内容。\n\n【忽略规则】\n普通的日常记录、萌宠、美食等娱乐内容。\n\n【不感兴趣规则】\n低俗、暴力、虚假信息、过度营销的内容。\n```\n\n---\n\n### 步骤四：启动脚本\n\n1. 配置完成后，点击面板右上角的 **\"开始\"** 按钮\n2. 切换到 **运行日志** 标签页，查看实时处理进度\n3. 脚本会自动：\n - 提取视频标题、作者、标签\n - 调用 AI 分析内容\n - 执行点赞/忽略/不感兴趣操作\n - 自动切换到下一个视频\n\n**重要提示**：\n- **必须保持抖音标签页可见**（不能切换到其他标签页）\n- **避免最小化浏览器窗口**（可能会导致脚本暂停）\n- 可以在视频播放可见的情况下使用其他应用（如 QQ、微信），但作者不保证完全稳定\n- 建议使用独立浏览器窗口运行，专注处理推荐流\n\n---\n\n### 步骤五：查看统计与停止\n\n- **查看统计**：在 **运行日志** 标签页可以看到实时统计数据（已处理、点赞、忽略、不感兴趣）\n- **停止运行**：点击 **\"停止\"** 按钮即可终止\n- **自动停止**：达到设定的运行时长（默认 20 分钟）后自动停止\n\n**觉得好用？别忘了给项目点个 ⭐ Star，让更多人发现它！**\n\n---\n\n## 高级选项说明\n\n在 **高级选项** 标签页中，可以调整以下参数：\n\n| 参数名称 | 默认值 | 说明 |\n|---------|--------|------|\n| **操作前观看时长** | 2-4 秒 | 模拟真人观看一段时间后再操作 |\n| **内容跳过概率** | 8% | 随机跳过部分视频，避免每个都操作 |\n| **API 失败重试次数** | 3 次 | AI 调用失败时的最大重试次数 |\n\n**建议**：如无特殊需求，保持默认值即可。\n\n---\n\n## 常见问题（FAQ）\n\n### 1. 使用本脚本大概需要多少费用？\n\n**答**：费用取决于您选择的 API 提供商和使用频率。\n\n- 多数服务商为新用户提供免费试用额度（通常在有限日期内足够体验数十万次判断！），建议网络搜索‘AI API’进行了解和学习。\n- 部分模型甚至永久免费，如GLM-4 flash。\n- 正式使用后按调用次数计费，不同平台价格不同，建议查看官网最新定价。参考价格：DeepSeek 1元 可判断 1000+ 条视频。而使用该脚本通常用不上这么多就已经结束使命了。\n- 也有一些冷门的第三方 API 提供商可能提供长期免费额度\n\n**节省技巧**：\n- 设置较高的\"内容跳过概率\"（如 20%），减少 API 调用次数\n- 控制每次运行时长（如 10-15 分钟），避免长时间挂机\n- 优先选择有新用户优惠的平台\n\n---\n\n### 2. 为什么不能使用 DeepSeek R1（深度思考）模型？\n\n**答**：推理模型（如 `deepseek-reasoner`、`R1` 等）会返回思考过程而非直接回答，导致：\n\n1. **响应变慢** - 思考时间长，抖音会误以为您长时间停留在该视频\n2. **费用更高** - 推理模型计费更贵，不划算\n3. **解析失败** - 脚本无法正确识别推理内容\n\n**解决方案**：请使用标准对话模型，如 `deepseek-chat`（类似曾经的 DeepSeek-V3）、`gpt-4o-mini`、`claude-3.5-sonnet` 等。\n\n**技术说明**：部分模型可能不支持关闭推理模式，即使设置了相关参数也会返回推理内容。建议直接选择标准对话模型以避免兼容性问题。\n\n---\n\n### 3. 出现 400/422 错误怎么办？\n\n**可能原因**：\n\n- API Key 输入错误（注意前后空格）\n- 选择的提供商与实际 Key 不匹配（如用 Kimi 的 Key 选了 DeepSeek）\n- 自定义 API 地址填写错误\n- 使用了推理模型（见问题 2）\n\n**排查步骤**：\n\n1. 检查 API Key 是否正确（复制时可能多了空格）\n2. 确认\"API 提供商\"选择与 Key 匹配\n3. 如果使用自定义 API，检查地址格式是否正确\n4. 点击\"测试连接\"查看详细错误信息\n5. 查看\"运行日志\"中的请求/响应详情\n\n---\n\n### 4. 脚本可以后台运行吗？\n\n**答**：**不能完全后台运行**。\n\n**具体要求**：\n- **不可以**：最小化浏览器窗口（会导致脚本暂停或不稳定）\n- **不可以**：切换到其他标签页（必须保持抖音标签激活）\n- **不可以**：电脑锁屏或休眠\n- **可以但不保证稳定**：在保持浏览器窗口可见的情况下，使用其他应用（如 QQ、微信）\n\n**原因**：脚本依赖键盘快捷键（如 `z` 点赞、`↓` 下滑）和 DOM 监听，需要页面处于活跃状态。\n\n**建议**：使用独立浏览器窗口运行，或使用副屏显示器专门运行脚本。\n\n---\n\n### 5. 脚本会窃取我的 API Key 吗？\n\n**答**：**绝对不会**。\n\n- 所有配置数据（包括 API Key）仅存储在 **您的浏览器本地**\n- 脚本使用 `GM_setValue` API，数据不会上传到任何服务器\n- 源代码完全开源，您可以自行审查\n- AI 调用直接发送到您选择的服务商（DeepSeek/Kimi 等），不经过任何中间服务器\n\n**安全建议**：\n- 不要在公共电脑上使用\n- 定期检查 API Key 的使用记录（在服务商控制台查看）\n- 如怀疑泄露，立即在服务商后台删除并重新生成\n\n---\n\n### 6. 为什么连续多次提示\"无法定位当前视频\"？\n\n**答**：这通常意味着 **抖音更新了页面结构**，导致脚本的 DOM 选择器失效。\n\n**临时解决方案**：\n1. 刷新页面后重试\n2. 清除浏览器缓存\n3. 检查是否有其他油猴脚本冲突\n\n**长期解决方案**：\n- 请将此问题反馈给作者（见下方联系方式）\n- 作者会尽快更新选择器配置\n- 也欢迎有能力的开发者提交 Pull Request 修复\n\n**如果你会前端开发，欢迎 Fork 项目并提交修复，成为贡献者！贡献后可在项目中留名致谢。**\n\n---\n\n### 7. 自定义 API 支持哪些参数？\n\n**答**：如果您使用兼容 OpenAI 格式的第三方 API，脚本会自动发送以下参数：\n\n```json\n{\n \"model\": \"您填写的模型名称\",\n \"messages\": [...],\n \"temperature\": 0.3,\n \"max_tokens\": 500,\n \"stream\": false\n}\n```\n\n**重要限制**：\n- 推荐设置 `stream: false`（但部分模型可能不支持该参数，脚本已尽力兼容）\n- 不建议使用推理模型（会导致解析失败）\n- 支持所有标准 OpenAI 兼容端点\n\n---\n\n### 8. 如何查看详细的运行日志？\n\n**答**：在 **运行日志** 标签页中：\n\n1. 勾选 **\"显示详细调试信息\"** 复选框\n2. 即可看到完整的 API 请求/响应内容\n3. 包括请求地址、请求体、响应状态码等\n4. 方便排查问题\n\n---\n\n### 9. 脚本会被抖音检测吗？会封号吗？\n\n**答**：在正常使用范围内被检测的概率较低。\n\n**重要提示**：\n- 作者无法保证任何自动化工具的绝对安全性\n- 使用前请仔细阅读[免责声明](#免责声明)\n- **任何因使用本工具导致的账号问题，作者不承担任何法律责任**\n\n---\n\n### 10. 脚本突然失效了怎么办？\n\n**最常见原因**：抖音更新了页面 HTML 结构（每次大版本更新都可能发生）。\n\n**排查步骤**：\n\n1. **检查脚本是否已更新**：\n - 打开 Tampermonkey/Violentmonkey 面板\n - 查看脚本是否有新版本\n - 手动触发更新检查\n\n2. **刷新页面后重试**：\n - 有时是临时的 DOM 加载问题\n\n3. **反馈问题**：\n - 邮件：`1987892914@qq.com`\n - GitHub Issues：[点击提交](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n - 反馈时请附上：\n - 发现时间（如 2025-10-15）\n - 浏览器版本\n - 错误日志截图\n\n**开发者？欢迎直接提交 PR 修复！成为项目贡献者，你的名字将出现在致谢名单中。**\n\n---\n\n### 11. 为什么有些视频的标题提取不完整？\n\n**答**：抖音网页版会折叠较长的标题，脚本已尽力提取完整内容，但可能受限于：\n\n- 页面 DOM 结构变化\n- 标题动态加载延迟\n- 反爬虫机制\n\n**解决方案**：\n- 脚本会自动等待一段时间后重试\n- 如果标题过短（少于 3 个字符），会跳过该视频\n- 通常不影响整体判断准确性（还有作者、标签等信息）\n\n---\n\n## 开发者维护指南\n\n### 代码结构\n\n```\nscript.js\n├── CONFIG # 统一配置对象\n│ ├── defaults # 默认参数\n│ ├── selectors # DOM 选择器（最易失效）\n│ ├── apiProviders # API 提供商配置\n│ └── templates # 预设模板\n├── Utils # 工具函数\n├── VideoExtractor # 视频信息提取\n├── AIService # AI 调用封装\n├── UI # 界面管理\n└── Controller # 主控制逻辑\n```\n\n### 新增 API 提供商\n\n在 `CONFIG.apiProviders` 中添加：\n\n```javascript\nnewProvider: {\n name: '显示名称',\n endpoint: 'https://api.example.com/v1/chat/completions',\n defaultModel: 'model-name',\n models: [\n { value: 'model-1', label: '模型1（推荐）' },\n { value: 'model-2', label: '模型2' }\n ],\n requestParams: {\n temperature: 0.3,\n max_tokens: 500,\n stream: false\n // 如需特殊参数，使用 extra_body（会自动展开到请求体根级别）\n }\n}\n```\n\n### 新增模型\n\n在对应提供商的 `models` 数组中添加：\n\n```javascript\n{ value: 'new-model-id', label: '新模型名称' }\n```\n\n### 更新 DOM 选择器（重要）\n\n当抖音更新页面结构时，需要更新 `CONFIG.selectors`：\n\n```javascript\nselectors: {\n title: [\n '新的标题选择器', // 优先级最高\n '旧的备用选择器1',\n '旧的备用选择器2'\n ],\n author: [...],\n tags: [...]\n}\n```\n\n**调试技巧**：\n1. 打开 F12 开发者工具\n2. 点击\"选择元素\"图标\n3. 悬停在视频标题/作者上\n4. 查看 HTML 结构中的 class 或 data 属性\n5. 添加到选择器数组首位\n\n---\n\n## 贡献指南\n\n**非常欢迎各种形式的贡献！无论是修复 bug、添加新功能，还是改进文档，都能让这个项目变得更好。**\n\n### 如何贡献\n\n1. **Fork 本仓库** - 点击右上角的 Fork 按钮\n2. **创建特性分支** - `git checkout -b feature/AmazingFeature`\n3. **提交更改** - `git commit -m 'Add some AmazingFeature'`\n4. **推送到分支** - `git push origin feature/AmazingFeature`\n5. **提交 Pull Request** - 在 GitHub 上创建 PR\n\n### 贡献者将获得\n\n- 在 README 的致谢名单中留名\n- 成为项目 Contributor（显示在 GitHub 项目页面）\n- 如果贡献突出，可获得项目 Collaborator 权限\n\n### 提交规范\n\n- **代码风格**：遵循原有代码格式\n- **提交信息**：使用中文，清晰描述变更内容\n- **测试**：确保在最新版 Chrome/Edge 上测试通过\n\n### 贡献方向建议\n\n- 🐛 修复已知 bug\n- ✨ 添加新的 AI 模型支持\n- 📝 改进文档和教程\n- 🎨 优化界面设计\n- 🔧 更新 DOM 选择器（当抖音改版时）\n- 🌐 添加多语言支持\n\n**即使你不会编程，也可以通过以下方式贡献：**\n- 提交 bug 报告和功能建议\n- 帮助其他用户解答问题\n- 分享使用心得和技巧\n- **给项目点 ⭐ Star 并推荐给朋友**\n\n---\n\n## 反馈与支持\n\n### 联系方式\n\n- **邮箱**：1987892914@qq.com\n- **GitHub Issues**：[提交问题](https://github.com/baianjo/Douyin-Smart-Feed-Assistant/issues)\n\n### 反馈时请提供\n\n1. 问题描述（越详细越好）\n2. 浏览器版本（如 Chrome 120.0.6099.109）\n3. 脚本版本（在\"关于\"标签页查看）\n4. 错误日志截图（在\"运行日志\"标签页中）\n5. 复现步骤\n\n### 获得更快响应\n\n- 使用 GitHub Issues（比邮件更容易追踪）\n- 提供完整的错误日志\n- 说明已尝试的解决方案\n- 如果是 DOM 选择器问题，提供页面 HTML 截图\n\n---\n\n## 免责声明\n\n### 重要提示\n\n#### 一、使用风险\n\n1. 本工具仅供学习和个人研究使用，不得用于任何商业目的\n2. 使用本工具可能违反抖音平台的服务条款\n3. **因使用本工具导致的任何后果（包括但不限于账号封禁、限流、数据丢失、经济损失），作者不承担任何法律责任**\n4. 用户应自行评估使用风险并承担全部后果\n\n#### 二、法律责任\n\n1. 用户必须遵守中华人民共和国相关法律法规\n2. 用户必须遵守抖音平台的用户协议和社区规范\n3. **因违反法律法规或平台规则导致的一切法律后果，由用户自行承担，与作者无关**\n4. 本工具不得用于任何违法违规目的，否则用户自行承担全部法律责任\n\n#### 三、数据安全\n\n1. API Key 仅存储在用户浏览器本地，不会上传到任何服务器\n2. 用户需自行保管 API Key，防止泄露\n3. **因 API Key 泄露、盗用导致的费用损失或其他损失，作者不承担任何责任**\n4. 建议定期更换 API Key 并检查使用记录\n\n#### 四、服务可用性\n\n1. 本工具依赖第三方 API 服务，可能因服务商故障、政策变更等原因导致不可用，**作者对此不承担任何责任**\n2. 本工具可能因抖音平台更新而失效，作者会尽力维护但**不保证时效性和持续可用性**\n3. **作者保留随时停止维护本项目的权利，无需提前通知**\n4. 作者不对工具的持续可用性、稳定性、安全性做任何明示或暗示的保证\n\n#### 五、内容责任\n\n1. 用户自行配置的规则和模板产生的结果由用户自行负责\n2. 本工具不对 AI 模型的判断结果负责\n3. **因 AI 判断错误、误操作、推荐偏差导致的任何后果，由用户自行承担，与作者无关**\n4. 用户应确保配置的规则符合法律法规和社会公德\n\n#### 六、技术限制\n\n1. 本工具基于网页 DOM 结构开发，可能因平台更新而失效\n2. **作者不保证代码的绝对安全性、无错性、适用性**\n3. 使用本工具可能导致浏览器性能下降、系统资源占用增加或其他技术问题，**作者对此不承担任何责任**\n4. 用户应具备基本的计算机操作能力和风险识别能力\n\n#### 七、知识产权\n\n1. 本工具基于 MIT License 开源，允许自由使用、修改和分发\n2. 使用者需保留原作者版权信息\n3. 二次开发或分发时需遵守 MIT 协议条款\n4. 不得用于任何商业用途的虚假宣传或侵权行为\n\n#### 八、责任限制\n\n1. **在任何情况下，作者均不对使用本工具导致的任何直接、间接、偶然、特殊或后果性损害承担责任**\n2. **包括但不限于：利润损失、数据丢失、业务中断、账号损失、声誉损害等**\n3. **即使作者已被告知可能发生此类损害，仍不承担任何责任**\n4. **用户使用本工具的唯一补救措施是停止使用**\n\n### 使用即表示同意\n\n**下载、安装或使用本工具即表示您已完全阅读、理解并无条件同意以上所有条款。如果您不同意任何条款，请立即停止使用并卸载本工具。**\n\n### 法律适用与争议解决\n\n1. 本声明的解释、效力及纠纷解决均适用中华人民共和国法律\n2. 若有争议，双方应友好协商解决\n3. 协商不成的，任何一方可向作者所在地人民法院提起诉讼\n\n---\n\n## 许可证\n\nMIT License\n\nCopyright (c) 2025 Baianjo\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n---\n\n## 致谢\n\n- 感谢所有提供反馈和建议的用户\n- 感谢开源社区的技术支持\n- 特别感谢 DeepSeek、Kimi、Qwen、GLM 等 AI 服务提供商\n\n**特别致谢以下贡献者**（按首次贡献时间排序）：\n\n> 暂无贡献者，期待你成为第一位！\n\n**想要在这里留名？欢迎提交 Pull Request！**\n\n---\n\n## 更新日志\n\n### v2.0.0 (2025.10)\n\n- 🎉 重构代码架构，提升稳定性和可维护性\n- ✨ 新增多个预设模板（青少年引导、效率知识等）\n- 🚀 优化 AI 调用逻辑，降低超时概率\n- 🔧 新增详细调试日志开关，方便排查问题\n- 🛠️ 改进 DOM 选择器，适配最新版抖音网页版\n- 🚨 新增连续错误检测机制，自动识别脚本失效\n- 💾 优化配置保存逻辑，解决 NaN 数据问题\n- 🔒 增强安全性，防止 XSS 攻击\n- 🎨 改进用户界面，提升易用性和美观度\n- 📝 完善文档和使用说明\n\n### v1.x (早期版本)\n\n- 初始版本发布\n- 基础功能实现\n\n---\n\n## Star History\n\n
\n\n### 如果这个项目对你有帮助，请点击右上角 ⭐ Star 支持一下！\n\n**你的 Star 是对作者最大的鼓励，也能帮助更多人发现这个项目！**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=baianjo/Douyin-Smart-Feed-Assistant&type=Date)](https://star-history.com/#baianjo/Douyin-Smart-Feed-Assistant&Date)\n\n### 分享给朋友\n\n觉得好用？分享给有需要的朋友吧！\n\n
\n\n---\n\n
\n\n**最后更新**：2025.9 - 2025.10 \n**当前版本**：2.0.0 \n**维护状态**：积极维护中\n\n**Made with ❤️ by Baianjo**\n\n**⭐ 如果觉得有用，请给项目点个 Star！⭐**\n\n[回到顶部](#抖音推荐影响器-douyin-smart-feed-assistant)\n\n
\n"}}}}