从第一次启动，
到完成第一个任务。

不用先读懂代码。先选一个平台、登录一个账号，再跟着步骤完成一件小事；需要更多能力时，按目录查阅。

先弄清楚三个词

平台账号

你登录 CreatorHub 的抖音、小红书、快手或视频号账号，用来执行任务。

监控目标

你想持续查看的创作者或作品，不等于登录账号。

任务与记录

任务是“准备做什么、正在做什么”；记录是“已经发现或处理的内容”。任务保存成功，不代表已经产生结果。

平台能力速查

小红书的关键词作品监控与关键词批量采集是不同功能：前者持续检查一个搜索词，后者是一次性批处理，目前仅抖音支持。

安装与启动

git clone https://github.com/3441293738/creatorhub.git
cd creatorhub

.\start.cmd

chmod +x start.sh
./start.sh

.\start.cmd check
.\start.cmd install
.\start.cmd --port 8080
.\start.cmd --no-open

登录第一个账号

入口：顶部选择平台 → 平台账号 → 添加账号

1. 先选择要使用的平台。不同平台的账号和监控数据分开显示。
2. 打开“平台账号”，选择当前平台提供的扫码或创作者登录入口。新手先用扫码方式，抖音也支持 Cookie 登录。
3. 在弹出的浏览器窗口按平台提示扫码、确认或完成验证。不要提前关闭登录窗口。
4. 回到账号列表，检查昵称和状态；必要时刷新资料或检测状态。

若暂时看不到账号，先检查顶部平台是否选对。登录失效时从账号列表重新登录，不要为了修复登录删除整个数据目录。

完成第一个任务：下载一条内容

先用自己拥有或获准保存的一条抖音、小红书或快手内容验证完整流程；视频号不支持这条下载路线，请改从我的内容同步自己的作品。

1. 完成对应平台账号登录，复制一条作品的完整分享文案或链接。
2. 打开“链接下载”，粘贴分享内容；如表单提供账号、画质或保存选项，选择刚登录的账号，其余先保留默认值。
3. 提交下载，等待页面返回结果，不要连续点击。
4. 查看下载历史和保存路径，到电脑上的对应目录确认文件。

默认下载内容位于 data/media/ 下；若修改过下载目录，请以界面或配置中的实际路径为准。失败时先看故障排查，不需要重新安装整个项目。

下一步：想自动发现更新，阅读作品监控；想一次性按词收集，阅读关键词采集。

作品监控：持续发现更新

入口：作品监控 → 新建作品监控

适用：抖音、小红书、快手。视频号请使用“我的内容”查看本账号作品。

1. 复制创作者主页的完整分享文案或链接。小红书选择“创作者笔记”或“关键词”监控类型，并填写对应目标；链接尽量保留有效的 xsec_token。
2. 粘贴目标，按需要使用“识别”，检查识别结果，再选择使用账号。
3. 设置检查频率。第一次可先用“每 30 分钟”或“每小时”，而不是同时添加大量高频目标。
4. 选择“自动下载范围”：只想观察结果时选“仅记录，不下载”；确实需要媒体时选择对应类型。
5. 如当前平台提供“首次历史回填”，先选最近 5 条或不下载历史。分组、标签、下载目录和高级筛选可以稍后配置。
6. 保存后在“监控目标”查看状态，在“作品记录”查看发现的内容。

完成标志：目标出现在列表；执行后有检查状态，有符合条件的内容时出现在作品记录中。无需继续监控时，暂停目标，不要只关网页。

关键词采集：一次性收集一批结果

入口：切换到抖音 → 关键词采集 → 新建关键词采集

1. 输入关键词，一次最多 20 个。第一次先填 1 个容易理解的词，例如“摄影教程”。
2. 选择可用账号，将每词作品数设为较小值，例如 5；不需要评论或媒体时关闭对应选项。
3. 如需要评论，设置每作品评论数，并明确是否包含二级评论。数量代表上限，不保证达到该数量。
4. 提交后查看任务进度和错误信息。等待本次采集结束，再检查结果和 Excel 导出。
5. 需要继续采集时，可对已结束任务编辑配置并保留结果去重续跑，避免重复新建相同任务。

完成标志：任务结束，有结果可查看或导出；数量少于上限不一定是故障，结果受平台排序、登录状态和当前可见内容影响。

评论与弹幕监控

评论监控

入口：评论监控 → 新建评论监控

1. 选择单条作品或账号近期作品的监控方式，填写相应链接或目标。
2. 选择已登录账号，按需设置检查周期与采集选项；第一次减少目标数量，其他参数先保留默认。
3. 保存后查看“监控目标”的状态，执行后到“评论记录”查看结果。
4. 看不到数据时检查目标是否有可见评论、登录是否有效，以及筛选条件是否排除了结果。

评论监控是读取和保存评论，不会因为你创建了监控就自动发出回复。回复规则见自动评论与审核。

弹幕监控（仅抖音短视频）

入口：切换到抖音 → 弹幕监控 → 新建弹幕监控

1. 填写视频目标并选择账号；自己的视频使用创作中心来源，公开视频使用播放器来源。
2. 设置视频内时间范围，按需添加关键词、文本长度、点赞数和容量上限。
3. 保存并等待执行，到“弹幕记录”查看按视频时间点排列的结果。

弹幕时间是视频播放时间轴上的位置，不是评论发布时间，也不是直播弹幕。评论区有内容不代表视频中一定有弹幕。

链接下载：保存已知内容

入口：链接下载

1. 从对应平台复制完整分享文案，不必手动删掉文案中的文字。
2. 粘贴到输入框；按需选择账号、画质和下载选项，再提交。
3. 查看下载历史或错误提示，成功后检查实际保存路径。

抖音支持画质选择，小红书支持图集与视频，快手支持内容下载；视频号暂不支持。下载有断点续传和失败重试机制，但链接失效或登录失效仍需要先修复原因。

高画质取决于平台实际提供的资源；“仅音频”、格式处理或音画合并出现问题时，先更新依赖，必要时检查 ffmpeg。命令行用户可参考 README 命令行说明。

发布与转发

入口：发布 → 撰写内容；结果在“发布记录”查看

1. 切换到目标平台并选择发布账号。先确认创作者登录有效，特别是小红书。
2. 添加自己拥有发布权的素材，填写标题、正文与话题；按表单要求检查素材类型。
3. 在预览区域核对素材、账号和文案。小红书可按界面支持配置图集、视频或定时发布。
4. 确认无误后提交一次，在“发布记录”和“任务队列”观察进度。
5. 到平台侧核对作品。任务提交成功不代表已经通过平台审核或公开可见。

转发已下载内容

项目支持已下载抖音作品转发到小红书或视频号、小红书作品转发到抖音。先完成下载，再在对应作品操作中进入转发，核对目标平台、账号和素材，修改文案后提交。不是所有平台都支持互相转发。

定时及排队任务请保持本地服务运行，执行情况以记录和平台结果为准，不要把定时按钮当成云端托管承诺。

我的内容与私信

入口：我的内容 → 选择账号 → 选择当前平台提供的标签

1. 选择自己的账号，再同步对应的作品、关注或粉丝数据。
2. 等待同步结果，按页面筛选查看。抖音和小红书有私信能力，快手与视频号不要按相同能力预期使用。
3. 需要处理私信时，先同步并查看会话，确认对象与上下文，再撰写或审核回复。

小红书私信自动回复

在私信区域按需配置关键词、排除词、回复模板、冷却时间和消息最大年龄。默认生成待审核草稿，先检查命中对象和文案，再决定是否发送。首次启用只建立消息游标，不会处理全部历史积压。

后台会低频检查新消息。发送使用账号自己的可见 Chrome 会话与页面输入框；浏览器默认可能最小化，需要查看时点击“打开浏览器收发”。提交结果不确定时，先核对会话再操作。

作品健康监控

如当前账号页面提供健康监控，可按需开启零播放、违规或下架等提醒，并配置通知渠道。视频号在此管理自己的作品、数据与评论，不用于监控他人账号。

自动评论与审核

入口：自动评论 → 新建评论规则；审核在“任务与审核”

1. 选择执行账号与规则目标，按表单填写触发条件和评论模板。
2. 新建规则默认关闭。先小范围试跑，检查模板、命中目标及生成的任务。
3. 使用审核流程时，到“任务与审核”逐条检查内容；不合适的内容不要发送。
4. 确认行为符合预期后再手动启用规则，并保持低频。
5. 不需要时关闭规则，查看队列里是否还有待处理任务。

小红书默认页面发布并先人工审核；manual 模式只保存草稿。自动评论、私信和账号动作还受活跃时段、共享写入间隔、小时/每日上限及风险冷却约束。

通知：不用一直盯着面板

入口：通知 → 添加通知渠道

1. 准备自己的 Bark、钉钉机器人或 Telegram 通知渠道信息。
2. 选择渠道类型，填写名称和页面要求的地址、密钥或接收目标。
3. 保存后发送测试通知，在接收端确认收到。
4. 在提供通知选项的任务中按需启用提醒，检查实际任务产生事件后的通知结果。

完成标志：测试通知抵达正确的设备或群。通知配置全局共用，切换平台不需要重复创建。测试失败时先检查接收目标、网络和密钥，不要把含密钥的 URL 贴到公开 Issue。

任务队列与风控：理解“为什么还没执行”

入口：任务队列 / 风控中心 → 账号状态、风控规则

1. 在任务队列中按类型筛选，找到对应任务，查看状态、错误和等待原因。
2. 如果任务需要审核，先回到功能页审核；如果账号失效，先恢复登录。
3. 如果处于冷却、活跃时段外或达到上限，等待条件满足，不要重复创建任务。
4. 出现平台安全验证时，在当前可见浏览器窗口按提示处理，再检查账号和任务状态。

重启服务不会自动消除所有冷却状态。保留默认保护设置，优先减少任务规模和频率，而不是把限制全部调为零。

设置与账号环境

入口：设置；账号环境在“平台账号 → 浏览器内核 / 代理池”

外观与体验

切换浅色、深色等显示选项；平台配色与主题分别控制。

下载设置

调整保存目录与默认下载选项。改动后用一条内容确认实际落盘位置。

AI 文案

按页面字段配置自己的服务地址、模型和密钥，在实际生成文案时核对效果。服务可能产生第三方费用，发送前检查生成内容；不用 AI 时可跳过。

采集与运行

调整浏览器、调度等运行参数。新手先保留默认，修改前记录原值，一次只调整一项。

账号隔离与代理

每个账号有独立浏览器 Profile，和日常个人 Chrome 配置分开。不要让其他 Chrome 进程同时打开项目账号的 Profile，也不要随意删除它。

代理是可选项，不是安装前置条件。确有需要时，在“代理池”填写自己的代理并测试，再为账号关联；保持稳定出口。已配置的代理连接失败时会报错，不会静默改用直连。

浏览器内核

小红书优先系统 Chrome/CDP；自动模式在未安装 Chrome 时可回退到可见 Patchright Chromium，实际后端可在账号列表确认。Fingerprint Chromium 是其他平台的进阶可选项，小红书不使用该组合。普通上手无需安装额外指纹浏览器。

完整配置字段见 config.example.yaml。需要手动改配置时先停止服务并备份 config.yaml，注意 YAML 缩进，用空格而不是 Tab，保存后重启验证。

更新、备份与恢复

先备份，再更新

1. 暂停重要任务并停止本地服务，避免复制正在写入的数据库。
2. 将 config.yaml 和整个 data/ 复制到项目之外的私人备份目录。若自定义了数据库、媒体或 Profile 路径，也要备份这些实际目录。
3. 记录当前版本或提交号。Git 安装用户在工作区无待处理修改时执行 git pull --ff-only；有冲突先处理，不要强行覆盖。
4. ZIP 安装用户将新版本解压到新目录，再把备份的配置与数据复制进去；不复用旧的 .venv。
5. 运行安装命令更新依赖，然后正常启动，检查账号、配置和历史记录。

# Windows
.\start.cmd install
.\start.cmd

# macOS / Linux
./start.sh install
./start.sh

数据库字段通常在启动时自动迁移，不需要为升级清空数据库。若需要回滚，停止服务，使用更新前的代码和配套的更新前数据备份，不要直接让旧代码读取已经迁移的数据。

常见问题：先按现象排查

浏览器查找快捷键：Windows / Linux 按 Ctrl + F，macOS 按 ⌘ + F，搜索错误关键词。

# Windows
.\.venv\Scripts\python.exe -m patchright install chromium
# macOS / Linux
./.venv/bin/python -m patchright install chromium

仍有问题？让反馈更容易复现

到 GitHub Issues 提交问题，或者查看README 中的群二维码和作者微信。提交前搜索是否已有相同问题。

操作系统及版本：
Python 版本：
CreatorHub 版本 / 提交号 / ZIP 下载日期：
平台及功能：
复现步骤：1. … 2. … 3. …
预期结果：
实际结果：
脱敏后的完整错误日志或截图：

请隐藏 Cookie、Token、手机号、代理密码、私信内容、通知密钥及带签名参数的链接；不要上传 config.yaml、数据库或 Profile。