抖音账号诊断公开作品样本能说明什么douyin-account-diagnosis 是一套抖音账号诊断 SkillAgent 按公开主页采集作品样本本地脚本计算样本指标再按证据整理问题与选题。它适合复盘可见内容需要有来源的样本不能据此断言账号被限流。这是“我的 100 个开源项目”系列的新一篇。看账号时单条作品的点赞数很容易吸引注意但真正值得追问的是这批作品从哪里来统计了哪些字段结论有没有超过样本能说明的范围先把采集、计算和判断拆开项目入口是 douyin-account-diagnosis。截至 2026 年 10 月 4 日manifest 版本为 1.0.1LICENSE 为 MIT。仓库里的 SKILL.md 规定了公开页采集、样本去重、证据保留以及 JSON 和 Markdown 报告的结构scripts/diagnose.mjs 则接收已经整理好的作品数据计算指标。脚本本身没有打开浏览器的逻辑不能只运行它就期待自动抓取主页。这层区别决定了怎么使用需要完整诊断时让能读取 Skill 的 Agent 配合 Easy WebBridge 执行手头已有样本、只想复算指标时可以单独运行脚本。当前源码直接返回的 findings 和 topicSuggestions 是空数组问题优先级、主题判断和选题建议仍需要 Agent 按证据补齐。源码第一次分析输入要写清楚什么按 Skill 合同先提供指定账号的公开页、样本数量和采集时间。sampleLimit 默认 10文档范围为 3–30。需要隔离账号环境时指定已授权浏览器不要把登录态或环境标识写进对外报告。可以给 Agent 这样的任务使用 douyin-account-diagnosis分析我指定的抖音公开主页。 取最近10条仍可见作品记录采集时间、作品链接和互动字段原文。 把页面未显示的字段列为缺失每条问题附证据。 输出 JSON 和 Markdown并区分观察、计算结果与建议。 遇到登录或安全验证时停止该账号。这里的“10 条”是任务范围不是脚本强制校验。源码不会替你检查样本上限也不会自动截取最新作品。采集步骤要先完成去重与范围确认报告才能让别人复核。用两个 mock 样本看清算法下面是本地演示数据不是真实账号效果也没有执行线上采集。先从公开仓库取得脚本gitclone https://github.com/xxjrq/douyin-account-diagnosis.gitcddouyin-account-diagnosisnodescripts/self-test.mjs在项目目录保存 sample.json{accountUrl:https://www.douyin.com/user/mock-account,mode:mock,works:[{likes:100,comments:10,shares:5,views:2000},{likes:80,comments:8,shares:3,views:1500}]}再执行nodescripts/diagnose.mjs sample.jsonaccount-diagnosis.json本次本地复算得到样本数 2总点赞 180总评论 18总分享 8。averageEngagementRate 是逐作品互动率的算术平均先对每条作品计算“点赞评论分享”除以播放量再对有效结果取平均。本例约为 5.91%。它不是“全部互动数除以全部播放量”的加权结果。讨论两批作品时先固定算法与样本范围否则同名的“互动率”也可能无法比较。自测通过只说明 fixture 与基本失败分支符合断言不证明平台页面采集已经跑通。页面没有播放量怎么处理播放量未显示时不补一个估计值。源码只对有效且大于零的 views 计算互动率没有可用分母averageEngagementRate 就可能为 null。这时仍可以复核页面实际显示的点赞、评论与分享但不能把它们解释成有播放分母的互动率。还要留意数据清洗当前脚本用 Number 转换数值null 和空字符串可能变成 0缺少的互动字段在计算率时也可能按 0 处理。因此采集记录要保留“页面没显示”这一事实计算前筛选字段完整的样本不能把缺失值当成真实零值。它也没有计算发布频率和主题分布的实现相关结论需要另有证据与分析步骤。怎样让诊断结果能继续用一份可复盘的报告至少留住账号入口、采集时间、样本数量、作品来源、指标定义和限制。问题按 P0/P1/P2 排序时每条都要说明依据三条选题建议则解释它对应哪个观察并把预期写成待验证的尝试。例如“最近采到的作品主题分散”需要对应样本标题与主题记录“账号权重低”没有后台证据不能从公开互动数推出。样本不足就写不足页面要求验证码就停下来mock 文件也始终保留 mock 标记。如果只想开始一次复盘先把最近一组作品采全、算清楚再挑一个有证据的问题继续调整。这比拿几条点赞数给整个账号下结论更容易核对。项目仓库与操作合同GitHub、SKILL.md。本文核验了公开源码并运行本地 mock 自测没有访问或诊断任何真实抖音账号。
