114 lines
11 KiB
Plaintext
114 lines
11 KiB
Plaintext
抖音账号助手 0.1.6 — Windows 10/11 x64
|
||
|
||
【安装】
|
||
只需运行 DouyinAccounts-0.1.6-Windows-x64-Setup.exe。
|
||
无需安装 Python、Qt、Patchright、Node.js 或另行下载浏览器。
|
||
安装程序不会自动启动业务；没有开机自启、自动登录或默认私信。
|
||
默认使用随包的 fingerprint-chromium（adryfish 项目）和 Patchright 驱动，不再回退到系统 Chrome。
|
||
启动参数不再使用 --enable-automation；每个账号有固定的指纹种子，重启或切换归属不会改变种子。
|
||
这些调整不等于“无法被平台检测”，不能保证匿名、防封或绕过平台风控。
|
||
当前测试版尚未购买代码签名证书，Windows 可能提示未知发布者。请核对交付的 SHA256，不要关闭系统安全防护。
|
||
|
||
【首次使用】
|
||
1. 添加大号或小号，只填写自定义名称；小号还可选择归属大号。不需要知道或填写 UID。
|
||
2. 保存后自动打开该账号的独立浏览器，请自己在浏览器中登录。
|
||
登录后程序自动读取并回填 UID、昵称、头像、粉丝数、关注数、获赞数和作品数。
|
||
账号已添加或登录身份与原绑定不一致时会提示，不会覆盖已有绑定。登录成功也不会自动启动业务。
|
||
若关闭了浏览器，可点击“登录 / 刷新信息”继续；已绑定账号点击此按钮可刷新资料和统计。
|
||
只保留一个抖音首页或自己的页面；多个匹配标签会拒绝执行，防止选错。
|
||
3. 选择大号，配置规则。默认关闭；可配置通知类别、关注、私信、正文、不同任务批次间隔和同组 UID 冷却。
|
||
冷却默认 240 分钟（4 小时），设为 0 可关闭；勾选大号后点击启动。规则未开启不会产生或执行业务任务。
|
||
4. 每条匹配通知只给一个关联小号，按组内轮询，不跨组操作。
|
||
一条聚合通知可能包含多个来源用户，每个有效来源用户各执行配置动作。
|
||
5. 小号不可用时等待原小号，不自动改派；大号不可用时整个组暂停。
|
||
6. 停止只暂停业务、等待在途请求保存，浏览器保留。
|
||
关闭浏览器为独立操作，先停止账号组；退出软件也不会自动退出 Chrome。
|
||
7. “待核对”表示执行结果不确定，不会重发。请到平台人工核对，再确认成功或失败。
|
||
同一通知同时开启关注和私信时，两个动作并行开始、结果互不依赖，不等待默认 30 秒批次间隔。
|
||
批次间隔仍用于同一小号的不同通知批次；旧版“必须关注成功后再私信”配置升级后自动关闭。
|
||
8. “正在监听通知（N 条详情待重试，不阻塞新通知）”表示部分通知暂未返回详情。
|
||
这些 ID 会保留，按 30、60、120、240、300 秒间隔重试，之后最多每 5 分钟一次；不拖停整组，不影响正常新通知。
|
||
身份不符或真正的接口错误仍会暂停；不能根据空详情推断通知一定已删除。
|
||
|
||
【切换与删除】
|
||
切换/解除小号归属会取消旧组全部待执行任务，历史与待核对任务保留。
|
||
有执行中任务时禁止切换。登录目录不随归属变化。
|
||
“删除登录数据”需要确认并先停止业务、关闭对应浏览器；删除后需要手动重新登录。
|
||
此操作不删除账号定义、任务和历史，也不影响其他账号。
|
||
更换 Chrome 可执行路径会使用不同登录目录，不复制 Cookie。
|
||
|
||
【同组 UID 冷却与双动作并行（0.1.6 新增）】
|
||
冷却按大号组共享：该组任一小号开始操作某 UID 后，组内其他小号在设定时长内也不会再次操作该 UID；不同大号组互不影响。
|
||
冷却从任务实际领取、即将请求平台时开始并持久化，程序重启不重置。只排队后因停止、切换归属或删除小号而取消的任务不会启动冷却。
|
||
冷却期间，上一次结果无论成功、明确失败还是待核对，都不会因新通知再次创建任务；待核对记录在人工处理前还会继续阻止重复任务，优先保证不重复打扰。
|
||
在任务实际开始前，如果同组同 UID 已存在待执行、执行中或待核对任务，新通知也会直接跳过，避免短时间多条通知重复排队。
|
||
修改冷却时长会用于之后收到的通知；现有冷却按新通知当时的规则计算剩余时间。日志记录冷却开始、剩余秒数、已有任务跳过和所属本地大号名称，不记录完整 UID。
|
||
同一通知同时启用关注和私信时，两项组成一个并行批次，同时调用平台接口；其中一项失败或待核对不会取消另一项。两项各自保存结果。
|
||
默认 30 秒“不同任务批次间隔”只作用于前后两个通知批次，不插入到同一并行批次的关注和私信之间。
|
||
|
||
【详细运行记录（0.1.5 新增）】
|
||
“运行记录”显示最近 2000 条，重新打开程序也会加载最近的日志。可关闭自动滚动，或打开日志文件夹。
|
||
完整记录按电脑本地日期写入 %LOCALAPPDATA%\DouyinAccounts\logs\YYYY-MM-DD.log，UTF-8 编码，不因 UI 上限而截断，也不自动删除旧日期文件。
|
||
记录推送接收与去重、详情请求/重试、规则不匹配、无执行小号、自操作保护、UID 冷却、并行批次、轮询分配、任务入队/执行/结果、旧任务依赖等待、人工核对、账号操作和异常。
|
||
例如“触发者就是执行小号自身”会明确显示跳过原因；“分配完成”不代表已经关注或发送私信。
|
||
监听无新通知时每分钟写一次心跳，重复等待状态不反复刷屏。任务列表也仅展示最近 2000 条，完整历史仍在数据库中。
|
||
日志不保存 Cookie、签名、私信正文、原始请求/响应；通知标识使用稳定摘要，目标 UID 只显示尾号，账号用本地名称标识。
|
||
磁盘或权限异常会在 UI 明确提示；该期间仅有最近 2000 条内存记录，缺失的文件日志不会自动补写，请及时检查。
|
||
旧版 activity.log 及备份仍保留，未记录过的旧过程不会补造。日志会持续占用磁盘，请自行备份管理。
|
||
|
||
【删除小号（0.1.5 新增）】
|
||
先停止小号所属组，等待执行完成；选中小号，点击“删除小号”，二次确认（默认取消）。
|
||
将关闭该小号浏览器，删除其独立登录目录，清除绑定 UID、头像和资料，取消待执行任务，并从账号列表移除。
|
||
按已确认的方案，历史任务和日志保留；后台保留最小账号引用以供历史核对，不会将旧任务改派或重发。
|
||
执行中或所属组运行时禁止删除；目录删除失败时保留账号供重试，不会删除其他账号目录。
|
||
同一抖音账号可重新添加，将获得新的独立目录，不复用旧登录。大号不提供删除操作。
|
||
“删除登录数据”仍是另一项操作：只清空登录数据，不删除账号或解除绑定。
|
||
|
||
【数据位置与升级】
|
||
配置、SQLite、登录目录和脱敏日志存于：%LOCALAPPDATA%\DouyinAccounts
|
||
安装文件在：%LOCALAPPDATA%\Programs\DouyinAccounts
|
||
卸载/覆盖升级默认保留账号数据。从 0.1.0 升级旧数据库时会先备份再迁移，保留原 UID、归属、任务和历史。
|
||
升级 0.1.2 前请先停止业务并关闭旧 Chrome。新内核使用独立登录目录，需要自行重新登录原账号。
|
||
旧目录及旧浏览器配置保留，但新版本不自动沿用旧 Chrome 的路径配置；如需自定义请重新设置指纹浏览器路径。
|
||
0.1.3 及更新版本首次启动旧库时会增加通知重试字段；0.1.5 增加删除标记字段；0.1.6 增加组内 UID 冷却表和规则字段。旧账号、通知 ID、任务和登录目录不变。
|
||
0.1.6 将旧规则的“必须关注成功后再私信”自动关闭；旧版已排队且带前置依赖的任务仍按原快照安全处理，不重写历史。
|
||
0.1.4 修复了新点赞、评论推送后无法取得详情的问题：复用网页自身请求层，自动补齐当前运行时参数，保持原始 ID 精度。
|
||
本次已经实际验证“新增点赞和评论 → 两条推送 → 两条完整详情”，未执行自动关注或私信。
|
||
备份前先停止业务、退出软件并关闭所有账号浏览器，备份整个数据目录。
|
||
登录目录属于敏感凭据，请不要发送给他人，也不要上传到公共云盘。
|
||
更换 Windows 用户或电脑可能需要重新登录，不能依赖 Chrome Cookie 跨用户迁移。
|
||
|
||
【安全与已知边界】
|
||
只操作你拥有或得到授权的账号，遵守平台规则，勿用于骚扰或批量垃圾消息。
|
||
CDP 仅允许本机监听，不要映射到公网。
|
||
本包不会附带任何账号、Cookie 或登录目录。
|
||
网络、页面和平台 SDK 变化可能使监听或操作暂停。界面显示原因；不要强制重复发送。
|
||
通知依赖网页现有 WebSocket；网页刷新/断网期间尚未持久化的推送可能丢失。已保存的通知 ID 会恢复拉取详情。
|
||
离线模拟测试不代表多真实账号的线上业务验收；真实关注/私信及安装体验由使用者自行验收。
|
||
首次绑定以你在该独立浏览器中登录的账号为准；绑定后仍严格核验原 UID。未完成登录的账号不能启动业务。
|
||
|
||
【高级命令行（普通使用不需要）】
|
||
安装目录 cli\DouyinCLI.exe 提供 current-user、notifications、follow、im、mark-read。
|
||
所有操作显式传 --cdp-url http://127.0.0.1:端口 --expected-uid 数字UID。
|
||
通知订阅：DouyinCLI.exe notifications --subscribe --cdp-url ... --expected-uid ...
|
||
私信预览：DouyinCLI.exe im send --uid 目标UID --text 正文 --cdp-url ... --expected-uid ...
|
||
私信只有 --confirm 才提交；mark-read 只有 --apply 才提交。
|
||
follow 默认执行关注，--check-only 只读。请勿随意复制写操作命令。
|
||
不得让 CLI 与桌面队列同时对同一账号写入，CLI 不参与桌面任务事务。
|
||
|
||
【第三方组件】
|
||
Python、PySide6/Qt、Patchright（含其 Node 运行时）、psutil、fingerprint-chromium 随包提供。
|
||
fingerprint-chromium 是第三方 Ungoogled Chromium 分支，非 Google 官方 Chrome；上游说明最新补丁源码会延迟发布。
|
||
本版本固定使用 148.0.7778.215，并校验其发布 ZIP 的 SHA256；这不是对其全部补丁安全性的独立审计。
|
||
版本和浏览器来源见 build-manifest.json；许可文件见 licenses 目录、浏览器 chrome://credits 及各组件内附文件。
|
||
Qt/PySide6 为动态 DLL 分发，可按对应开源许可替换兼容 DLL。源代码与许可入口：
|
||
https://www.qt.io/licensing/open-source-lgpl-obligations
|
||
https://code.qt.io/cgit/pyside/pyside-setup.git/ （6.9.2）
|
||
https://code.qt.io/cgit/qt/qt5.git/ （6.9.2）
|
||
https://www.python.org/downloads/source/
|
||
https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python
|
||
https://github.com/microsoft/playwright
|
||
https://github.com/giampaolo/psutil
|
||
https://github.com/adryfish/fingerprint-chromium
|
||
本项目与抖音、Google、Qt 无隶属关系。
|