千川素材助手

压缩包里同时带了 插件/ 目录（Chrome 扩展），装完主程序再装插件即可， 不需要另外下载。
还带了一张 安装教程_图文版.png —— 解压后双击就能看， 7 步、每步配截图，看不懂文字直接照着图点。
文件校验 MD5 d554b07a2d2f7dd94579ca8bb1abe5b1

这次更新了什么

• v0.9.100：会员付款改成「付完自动开通」，不用再等人核对。
  ① 软件里选好套餐 → 点「生成付款码」→ 支付宝扫码付款， 付完几秒内自动开通，面板会自己变成「已付款，正在开通」。
  ② 每一笔订单单独生成一张付款码（以前是一张固定码卖所有单）， 订单号、金额都对得上，日后查账、开发票、售后都认这张单。
  ③ 万一支付宝回调慢了，点一下「我付好了，立即刷新」即可； 还不行就联系客服报订单号，10 分钟内给你补开。
  ④ 本版不动采集与报告逻辑 —— 只改付款这一段，装完不用重新采数据， 以前的报告和曲线都不受影响。
  ⑤ 如果你看到的还是原来的固定收款码，说明云端还没切到在线支付， 照旧点「我已支付」就行，两种方式都认。
• v0.9.99：上一版弄坏了两件事（商品变少、曲线全空），这次一起修回来了。
  ① 商品采集变少：商品表里那行「关联商品 / 整体消耗(元)」其实是 表格的表头被当成了商品；而且我上一版把"打开抽屉后的等待"从 1.5 秒砍到 0.4 秒， 表格只画出表头就被读走了。现在等待恢复，并且只认真实数据行 （整行文字等于表头就跳过）。已经采坏的数据，点「重出报告」也会自动清掉假商品。
  ② 曲线一条都没采到：切指标那几秒图表在重建，程序那一瞬间没找到图表 就直接放弃了，而且连失败原因都丢了（所以你只看到 0，不知道为啥）。 现在会等图表重建（最多 8 秒），失败原因一律写进数据。
  ③ 这一版之前的"变慢/画不出图"，是程序自己造成的：读页面接口那段代码 在每次请求里都解析一遍大响应，把页面卡住了，图表自然画不出来。已改成用到才解析。
  ④ 新增一条真能出数的路：程序模拟的鼠标事件页面根本不认 （这就是前几版怎么调都读不到的原因）。现在采不到时会切到浏览器级真实鼠标 （页面顶部会短暂出现"正在调试"的黄条，采集结束自动消失；开着 F12 时自动跳过）。
  ⑤ 关联商品没读到的，先试 3 条，能修好就继续把剩下的一次补完 （以前只补 3 条，9 条素材只能补回 2 个商品）。
• v0.9.98：曲线换方案了 —— 不再靠鼠标划图，直接读页面接口的数据。
  ① 前两版一直在修「划图」那条路（先判假数据、再判静态文字）， 结果只是做到了不写假数字，曲线本身还是取不回来。 这次换了做法：那张曲线图本来就是页面从接口拿到数组再画出来的， 那就直接读那份数据，按素材 ID 取逐秒的点击/流失。
  ② 好处：一次拿全（不用一秒一秒去划）、不受弹层动画影响、 也不会再把横轴末尾的刻度当成"第 34 秒的点击次数"。
  ③ 接口没给到的指标，才退回原来的鼠标扫描；两条都空时， 程序会自动把接口结构交回本机分析 —— 不用你再截图或重跑给我看。
  ④ 装好后请把千川页面关掉重开一次（新逻辑要在页面加载时接入）， 然后再跑一次采集。
• v0.9.97：几乎每条都「未采到」—— 查到真因了：读到的是图上那行静态小字。
  ① 上一版只是如实写了「未采到」，没找到为什么。查数据发现铁证： 有值的那一格，秒数永远等于视频总时长（34 秒的素材就是第 34 秒、 21 秒的就是第 21 秒）—— 那是横轴最后那个刻度「00:34」， 被当成了鼠标指着的读数。所以 90 次采样拿回来的全是同一段文字。
  ② 现在只认鼠标划过之后才出现的浮层：扫之前先把页面上原有的文字记下来， 命中就丢掉。读不到就继续如实写「未采到」，绝不拿静态文字凑一条曲线。
  ③ 顺带修掉报告里那句像内部笔记的话（「不提秒数也不说流失为 0」）—— 那是写给程序的规则，不该出现在你的报告里。旧报告也会自动清掉。
  ④ 采不到时不再空转：一旦证实是静态文字就立刻收手，不会让你干等两分钟。
• v0.9.96：「开头抓人 0.00 弱 / 开头3s流失 0%」找到根因了 —— 曲线只采到一个点。
  ① 每条素材都写着「🎯 开头抓人 0.00 弱」「开头3s流失 0%」，AI 还说 「第None秒流失0.0×周围」。真因不在素材：这次每秒一格的曲线只采到 1 个点 （35 秒里 34 秒是空的），程序把「没采到」当成「0」算了，于是把 采集失败说成你素材开头不行 —— 照着改就是白花钱。
  ② 现在采不到就明说「未采到」（鼠标停上去能看到原因）， 不再印 0.00 / 0%，AI 也不许再编某一秒的数字。
  ③ 采集端一并收紧：页面上的静态文字不再被当成提示框；同一秒反复读到就判为 没采到、如实上报，不再拿一个点凑一整条曲线。
  ④ 旧报告也会自动清掉这些假数：点「重出报告」即可，不用重新采集。
• v0.9.95：有个品一篇都没出稿 —— 真凶找到了，是「越顺利越会炸」。
  ① 报告里两个品写着「这个品这次没出稿：error」、一篇都没有。 真因是：某一篇初稿一次就过了全部校验（没有问题可返修）时，返修那一步 返回的不是 Promise，却被当成 Promise 用 ⇒ 整个品直接归零。 越是顺利越会炸，所以以前看起来像偶发。引擎已修（云端已生效）， 同条件复跑 5 篇全出、全部通过。
  ② 报告第一行原来写「共生成 30 篇」，实际只有 18 篇 —— 那是「应有」篇数。 现在写真实出稿数，几个品没出稿也在标题里点名。
  ③ 「没出稿：error」这种光秃秃的英文不会再出现：现在写清是哪一步出的错， 并明确告诉你不用重跑 —— 点「一键诊断」把结果发我即可。
  ④ 其它内部代码（没配 Key、骨架不足、登录态过期…）也都有中文说法了。
• v0.9.94：上一版把话说满了 —— 旧报告不会再假装"补读过"。
  ① v0.9.93 里写了一句「采集结束前，程序已经自己补读过一遍」。这句话只对那一版 之后采的数据成立；更早的报告是旧版采的，那时根本没有这一步， 报告不该替它编一件没发生过的事。
  ② 现在采集时会给每条真的补读过的素材留个记号（补成、补不成都有）， 报告只有看到记号才说"补读过"，否则老实写「这份是旧版本采的数据，当时还没这一步」。
  ③ 两种情况都不用你重跑 —— 这一条不会退回去。
• v0.9.93：这段文案不会再让你重跑了 —— 读不到它自己去补一遍。
  ① 以前读不出「关联商品」，报告底部只会写「直接重跑一次通常就好」。 可真相是：程序认的是千川那个固定表格样式，页面一改它就永远等不到表， 重跑一百次也是同样的结果 —— 等于把我们的问题换成你的工时。
  ② 现在认表格不看样式、不看表头文字：点开「关联商品」前后哪张表变了， 就认哪张；第一次点没反应，它会自己再点一次（多等九秒，也好过你重跑一轮十几分钟）。
  ③ 一轮采集结束前，凡是没读到的条目，它会按素材 ID 自动找回去补读一遍； 补回来的照常出文案，报告里会写明补了几条 —— 你不用做任何事。
  ④ 报告里那些"让你再点一次、再跑一遍"的话全部改掉了，只留一条真能推进的：点「一键诊断」， 把现场发我。另外清掉了一处让你去点「⚡ 一键全跑」的指路（那个按钮早就删了，按了会找不到）。
• v0.9.92：「一键全跑」删掉之后，它留下的一只"手"还在 —— 现在真的关掉了。
  ① 那个按钮早就删了，可它背后的自动驱动每次页面加载还会问本机"还跑不跑"。 只要本机还留着一次没跑完的旧批次，它就会自己把页面跳走 —— 正在采集的那一轮当场消失，面板只能说"跑一半停了"，日志里连一次采集记录都没有。
  ② 现在这个驱动（以及它带来的"整批完成"汇总卡）彻底停用，单户「跑」完全不受影响。
  ③ 顺带：一个卡在"running"的历史批次，也不会再拦住你点单户的「跑」了。
• v0.9.91：跑一半断了？它会自己接着跑；日志也不会再"消失"了。
  ① 以前跑到一半断掉，面板只能说"没有结果"。现在会写清死在「哪一步」 （最近 8 步都留着），并且分得清三种原因：页面被刷新、被跳到别的地址、 还是插件自己被重载了。
  ② 更关键：断了会自己接着跑。页面加载回来的那一刻发现上一轮没跑完， 就自动重来（同一户最多 2 次，成功了就不再重试）—— 你不用守着它。
  ③ 顺手修掉一个一直藏着的问题：程序自动更新重启之后，日志文件会被新旧两个 进程抢住，新进程从此一行都不写。这也是前几次"查不出原因"的老底。 现在抢不到就换个带时间的新文件，绝不静默丢。
• v0.9.90：跑一半就没了？这次把"凶手"摁住了。
  ① 查本机日志发现一条常理上不该同时存在的事：心跳只发了 4 次就停， 可面板的其它请求还在继续 —— 说明页面脚本没死，是那一轮采集中途消失。
  ② 原因：采集靠点击驱动（开抽屉 / 切筛选 / 翻页），只要其中一下点到的是 链接，浏览器就会整页跳走，这一轮连"为什么失败"都来不及写。
  ③ 现在采集期间会临时装一层护栏：拦住跳转，但放行页面自己的动作 （拦狠了抽屉会打不开，这点踩过坑）。同时把每一步都记在本机， 下次真断了，面板会直接写出死在「哪一步」，不再只说"没有结果"。
• v0.9.89：曲线只在抽屉里找，取最大的那块图。
  ① 顺着 v0.9.88 的现场诊断再往前一步：找曲线图以前是全页找， 列表页上只要也有一块图表，拿到的就是它 —— 鼠标在上面划 90 次， 一个数字都读不到，于是「曲线 0 个点」而界面毫无提示。
  ② 现在先只找素材详情抽屉里，并按面积最大挑那块图 （DOM 里排第一的常是小图例）；抽屉容器本身也加了兜底，改类名也认得出。
  ③ 换行/顺序变了也能读（tooltip 只认「秒 + 数字」，不再死抠分隔符）。
• v0.9.88：修「曲线一个点都扫不到、报告还是干瘪」。
  ① 上一版只做到「读不到会说」；这一版查出为什么读不到： 千川改了素材详情抽屉里的类名，切指标、找关联商品、定位曲线全都落空， 而扫到 0 个点还被当成成功 —— 所以报告一直没画面、没流失点。
  ② 现在类名失效就按文字找（指标名、关联商品 tab），曲线图换了组件 （SVG）也能定位；tooltip 不管怎么排版都读得出秒数和数值。
  ③ 真的还读不到时，面板会报出具体原因，同时把抽屉的现场结构 存进本机诊断文件 —— 一次运行就能定位到是哪个元素变了，不用来回来去猜。
• v0.9.87：修好「跑一半自己停了，还不知道为什么」。
  ① 不会再被自动更新打断：采集期间插件每 8 秒告诉本机一句 「我还在跑」，本机就不会挑这个时候自动重启换版本 —— 以前正是这一步把跑到一半的那一轮杀掉，日志里只留下「自动重启（检测到新版本）」。
  ② 断了会说话，而且熬得住刷新：上一轮如果没跑完，面板上会留一条黄条， 写明几点开始的、卡在哪一步、为什么断的（页面被刷新 / 插件被重载 / 本机程序重启过），按 F5 也还在；跑成功一次自动消掉。
  ③ 若中断确实是本机重启造成，错误文案直接说人话，不再只说「本机服务无响应」。
• v0.9.86：修好「报告只剩消耗表，画面 / 流失曲线 / 口播全没了」。
  ① 素材详情定位更稳：以前只认素材 ID和文件名，两个都对不上就整条跳过 （AIGC 汇总行还占着列表第一行）。现在补一条按消耗金额定位 —— 金额是页面真实渲染的值、与素材一一对应，不会再整批错位。
  ② 千川换了图表组件时曲线也能读到（自动退到抽屉内的图表区域）。
  ③ 读不到会说话：采集时逐条播报失败原因，面板上直接显示 「9 条素材的曲线一条都没读到：xxx」；报告顶部也有醒目横幅，写明缺了哪几项、 怎么回事、怎么处理 —— 不再让您对着一份干瘪报告猜是不是软件坏了。
• v0.9.85：出报告不再白跑一次 AI 总结（每份省一次模型费、快 20 秒左右）。
  ① 出报告时会先生成「素材总结」，但这一步没带上报告实际用的条数： 脚本按默认 10 条算，报告卡片却是 11 条（或 20 条）。两边对不上， 系统会判定「缓存作废」再重算一遍 —— 每出一份报告都白烧一次模型费， 还多等一会儿。现在两边严格用同一个条数，算一次就够了。
  ② 顺手修好那句自相矛盾的日志（以前会打印「已有总结样本为 Top10， 与本次 Top10 不一致」，两个数字一样却说不一致，根本没法排查）。
• v0.9.84：报告不再「简陋」——「素材总结」整块消失的 bug 修好了。
  ① 报告开头那 7 个指标卡（全量消耗 / 样本合计 / 集中度 / ROI / 流失点 / 开头流失 / 抓人指数）加上 AI 结论，不会再凭空不见了。 之前只要这一次没抓到秒级曲线（例如换电脑、只抓了列表页），整块就会算崩、被静默跳过， 1.6MB 的报告缩成 65KB，看着像「什么都没采到」。
  ② 缺数据时不再印假的 0.0 / 0.00，统一写 「本批无秒级曲线，未采集」，一眼能分清「这户没数据」和「程序没跑」。
  ③ 万一这块再出问题，日志会打出完整报错堆栈，出报告的最后一行也会写明 「素材总结 有 / ❌缺失」，不再悄悄少一块。
• v0.9.83：点错户不会再被千川踢下线；「一键全跑」按钮删掉了。
  ① 不会再因为点到别的户而「登录状态失效」：一个千川登录账号能挂好几个户， 如果你在 A 户的页面去点 B 户的「跑」，千川会认为登录异常，直接把你踢出去。 现在只有当前页面这个户的「跑」能点，别的户显示灰色 —— 鼠标停上去会写「请先在千川切换到「B 户」再点「跑」」，点了也只提示、不会乱跳。
  ② 「一键全跑」按钮删了：它会把所有户连着跑一遍，一旦有户挂在别的登录账号下 就必然失败，留着只会让人白等一轮。现在按户跑：跑完一个，在千川切到下一个户，再点它的「跑」。
  ③ 底部那句「今天还没跑」的提示也跟着改了，指向每户后面的「跑」。
• v0.9.82：「统计周期没摆正」不再卡住你，能取到哪天就跑哪天。
  ① 不会再出现「数据只更新到 10-24，只能停在 10-23」这种自相矛盾的红字： 千川这户昨天（24 号）的数据还没出，日历里能勾的最后一天其实是 23 号。 旧版把「24 号」当成必须达到的线，于是一直判"没摆正"、一直不动。 现在以千川实际能给你哪一天为准 —— 23 号就是正确答案，直接开跑， 面板上会写一句「这户的数据只到 23 号」，你一眼知道是平台侧的事，不是软件漏了。
  ② 一键全跑不会再因为这个原因失败：以前点「最近7天」被平台钳成半截， 软件就当自己是失败的。现在直接在日历里挑最后一个能勾的日子， 不依赖平台那个快捷按钮。
  ③ 顺手修掉一处误报：日历弹不出来的时候，软件以前会当成"数据只到昨天"， 现在不会了。
• v0.9.81：千川素材页改版了，画面帧照样能采到。
  ① 报告里的「画面帧缺失」不会再出现：千川把素材页从旧版换成了新版， 点开「内容」后的面板结构变了，旧版软件找不到里面的播放器，采不到画面， 于是每条诊断后面都挂一句「画面帧缺失，无法确认第 N 秒靠什么抓人」。 现在新旧两版结构都认 —— 你的户被灰度到哪一版都能正常采。
  ② 浏览器插件里同一个入口一起修好了：客户实际是用插件采帧的， 它的选择器也只认旧版，这次一并兼容。
  ③ 单独重跑「画面帧」那一步不会再报「找不到素材」：以前从第 4 步 接着跑时，第 1 步存的文件名不带户 ID，第 4 步按带户名的去找就找不到。 现在两边的文件名口径一致了。
• v0.9.80：文案过了广告法校验，报告上直接告诉你结果。
  ① 文案里不会再出现「全网最低」「100%」「销量第一」这类词： 以前只在提示词里要求模型别写，模型不一定听。现在生成完还会再判一遍 —— 命中就让模型整篇重写，两轮还改不干净的这一篇直接不出， 宁可少一篇，也不让你拿一条会被罚的文案去投。 商品卡上会写一行「广告法校验：全部通过」或「已剔除 N 篇」。
  ② 素材口播稿被人写过「忽略以上要求」也不会带偏：素材文案是你自己 可以编辑的，以前那段原文会整段喂给模型。现在这类句子会被当成噪音剔除， 模型只从素材里取卖点、不执行里面的任何指令。
  ③ 报告额度按定价页说的算了：试用版「只能生成 1 次报告」以前只管住了 云端那一小段，报告主要在本机跑，所以实际拦不住。现在出报告前会核验额度， 没额度就不开始跑（不会让你等十几分钟才失败）。付费档不受影响， 永久版断网也能继续用（最多离线 7 天）。
• v0.9.79：试用 / 月付用户报错时，不再让你去"换个 Key"。
  ① 平台通道出错改说人话：试用期和月付都是我们出模型费，你手里本来就没有 Key。 以前一律提示「去设置里换一个 Key」—— 你打开设置根本没有可填的地方，只能反复重试 或者来问我们。现在分开说： 「平台登录状态已过期，回助手面板重新打开一次」「会员可能到期了」 「今天的平台额度用完了，明天 0 点恢复」。
  ② 额度类错误不再白等：401 / 403 / 429 是确定性错误，重试一定还是失败， 现在第一次就停下并说清原因，不用等满三次超时。
  ③ 服务端侧稳定性与安全检查若干（不影响你现在的用法）。
• v0.9.78：文案额度用完时，报告会告诉你「明天几点恢复」。
  ① 额度用完不再只写「HTTP 429」：一份报告 10 个商品以前会印 10 条一样的 「HTTP 429」，你只知道失败了、不知道为什么。现在直接写清 「今天的平台文案额度用完了（每天 40 次），明天 0 点恢复；急用可以填自己的 Key」。
  ② Key 填错、没权限、额度用完时立刻停下说清是哪一种： 以前会白等 3 次重试才报错（每次都等满超时），看起来像"软件卡住了"。 现在一次就告诉你「Key 无效，去设置里换一个」或「今天额度用完了」。
  ③ 画面多的素材不会再莫名报「参数有误」：送进模型的图太大时， 现在会明确说是"图太多太大"，而不是一句看不懂的错。
  ④ 后台稳定性修正若干（不影响你现在的用法）。
• v0.9.77：修掉四个「会让你以为成功了、其实没有」的问题。
  ① 跑失败的那一户不会再显示「已完成」：以前因为千川登录态失效跑挂了， 你刷新页面再点「一键全跑」，插件反而告诉本机「已完成」—— 结果是报告没有、 队列却显示跑完，点「查看」打不开。现在失败就报失败，并告诉你是为什么。
  ② 纯音乐素材的「第几秒」不再错位：抽帧中间掉一张时， 后面所有帧的秒数会整体前移；音乐素材没有口播稿，画面是唯一依据，影响更大。
  ③ 提示话术恢复正常：像「这个请求没带模型 API Key：请在本机设置里先配置」 以前被统一成「参数有误」，你只会反复重试。现在原话照给。
  ④ 平台额度加了每日上限（试用 / 月付档）：以前这条链路不计次， 异常情况下可能把额度刷穿；现在和 AI 那条链路共用一份计数。
• v0.9.76：第三方代码审计的问题集中修复（这一版不改界面）。 审计一共报了 6 个 P0 + 三十多个 P1，我们逐条核过，除了刻意设计的，其余都改了。
  ① 报告 ROI 的颜色原来是反的：同一张卡上写着「🚀 建议追投」，旁边却标红「差」。 原因是拿「成本率」的阈值去标「支付GMV÷消耗」—— 阈值改对了（🟢 ≥2 / 🟠 1~2 / 🔴 <1）。
  ② 出报告中途装新版不会再把报告杀掉了：以前解压新版、程序自动重启， 会把跑了十几分钟的报告打断，面板停在一个百分比上什么都没说。现在跑批期间不会自动重启。
  ③ 同一户不会被重复跑：完成信号没送到时，以前会在下次打开时再跑一遍， 重复扣额度（永久版会重复花模型钱）。现在本地记一笔，10 分钟内只补报、不重跑。
  ④ AI 结论不会再因为一个空字段整批作废：结果文件改成「一条一条原子落盘」， 中途断电/被杀也不会丢掉已经花过钱的结论。
  ⑤ 素材列表停在第 2 页以后点生成，会自动先回第 1 页（以前从中间读起，榜单会失真）； 回不去就明确报错，不再拿半截数据出报告。
  ⑥ 平台额度（试用 / 月付）的面板不会再被一次误点废掉：那一档不再显示「保存」， 不会把你的平台令牌当成自己的 Key 存下去。另外给每处网络请求都加了超时 —— 以前云端半开连接会让面板一直停在「登录中…」。
• 安装教程按实际反馈重做了 4 处（这一版只改教程和说明，程序没动）。 装 v0.9.74 的客户基本都是照着长图一步步点的，图上说不清的地方就会卡住：
  ① 第 3 步加了 Windows 风险提示：双击 exe 会弹「Windows 已保护你的电脑」， 有人到这一步就不敢点了。现在图上写明这是「没买数字签名证书」的正常提示， 点「更多信息」→「仍要运行」即可；完全没反应的还教了「属性 → 解除锁定」。
  ② 第 4 步开头写明「只能用谷歌 Chrome」：以前写「Chrome / Edge」， 有人拿 360、QQ 浏览器装，插件装不上还以为东西是坏的。
  ③ 装完插件直接告诉你去开千川：以前这一步完了没有收尾， 客户停在扩展程序页面不知道下一步干什么。
  ④ 加了真实千川截图，指明点右下角那个写着「川」字的蓝色方块： 以前写「点右下角助手头像」，客户在页面上找不到「头像」。
  另外把第 6 步的口径改对了：试用 30 天与月付会员不用填大模型 Key （我们出钱，面板显示「试用/会员已含 · 平台通道」），永久版才需要自己填 —— 旧图上还写着「这部分费用算你自己的，我们不代付」，与 v0.9.74 正好相反。
• 试用 / 月付不用再填大模型 Key 了（这一版主打这条）。 之前不管哪一档，面板上都写着「大模型 · 未配置 Key · 去填」， 点进去是「还没有 Key？看 3 分钟教程」—— 客户刚开通 30 天试用， 就被要求自己掏钱去申请一个 Key，这跟买的东西不符。
  现在试用 30 天和月付 ¥19.9 都由我们出模型费： 面板显示「试用/会员已含 · 平台通道」，不用填任何 Key，报告照常生成。
  永久版 ¥199 仍然要填自己的 Key —— 一次买断垫不起永续的模型账单， 这一点写在套餐卡上（「永久有效 · 自备 Key」），买之前就看得到。
  已经填过 Key 的客户不会丢：升到月付/试用时原 Key 会存着， 哪天换回永久版自动接着用。
  额度：试用 30 天共 1 份报告，月付每天 1 份（第二天 0 点自动恢复）。 一份全链约 ¥0.23 的模型费，一天 5 份我们就倒贴了，所以按份数算。 用完提示「明天 0 点恢复」，急用可以填自己的 Key 接着出，不用等到明天。
• 「报告没生成：TypeError…」修好了（这一版只修这一个）。 另一台电脑上出报告时，面板上是一行红字： 报告没生成：TypeError: unsupported format string passed to NoneType.__format__， 报告一个字节都没出来。这是我们自己的毛病：千川那一格显示 -- （上面没数据），程序读到的是「空」，可出报告时还把它当数字去排版 ⇒ 当场报错，整份报告作废。
  现在这类空格子一律印成 -，报告照常出完；也不会凭空编一个 0.00 上去 —— 你拿报告和千川逐格核对时，空的就是空的，不会再多出一笔假数。
  出过这个错的那台电脑要装这一版（覆盖解压即可），装完重开一次程序。
• 文案能生成了 + 上榜那两条有画面了（这一版就修这两个）。 两个都是「插件明明读到了，程序自己弄丢了」的毛病：
  ① 插件读到的关联商品，在送进本机前被一张字段白名单吞掉了， 于是程序一直以为「没读到商品」，文案板块就永远空着 —— 现在放行了。 报告里也会写明没读到的具体原因（没有这个标签 / 标签点了表格没出来 / 插件旧版）， 不再只写一句「没读到」。
  ② 周榜第 2、3 名那两条是按素材 ID 搜出来补采的，它们本来不在列表页里， 以前抽帧找不到行就跳过 ⇒ 有字没图。现在会先搜出这一条再抓画面。
  ③ 顺手把云端 443 被防火墙拦着这件事做成自动降级：443 不通时临时走 80 端口 （会在报告里写明"本次走明文"）。放行 TCP:443 后自动回到加密通道。
  装完这一版请务必在 chrome://extensions 点「重新加载」，然后重跑一次采集。
• 报告底部文案没生成时，会直接写清原因（这一版就是为这个出的）。 之前那一块是整块消失的：客户只看到「没有文案」，看不到为什么， 也看不到该做什么。现在会写明是「素材没挂商品」「关联商品没读到」还是「云端连不上」， 并给一句能自己动手的话。
  顺带修了一个会说谎的判断：插件是旧版时（Chrome 不会自动重载插件）， 「关联商品」根本没回传，程序却把它算成「这些素材没挂商品」—— 把我们的问题说成了你素材的问题。现在一律算「没读到」。
  另外报告顶部会标出这次采集用的是哪一版插件； 如果还是旧版会直接红字提示「去 chrome://extensions 点重新加载」。
  装完这一版请务必重新加载插件，否则跑的还是旧代码。
• 报告能在手机上看，还能扫码直接打开。 以前报告在手机上是读不了的：每张卡片左边固定留了一块画面图（232px，不缩）， 手机屏才 390px 宽，右边的分析文字被挤到只剩 70px —— 一个字一行竖着排下来。 电脑上 232 + 760 看着正好，所以这个问题一直没被发现。现在手机上一律改成上下单列： 画面图独占一行、文字拿回整宽；流失峰／点击峰那张图也不再缩成蚂蚁字，改成可以横着划。
  面板右下角多了一个「手机看」：点开 → 出现二维码 → 手机扫一下 （要连同一个 WiFi）→ 列出你电脑上的报告，点开就能看，字和图都在。 随时能关，最长 120 分钟自动关；只共享报告这一个文件，不共享素材、账号和大模型 Key。 几点先说清楚：
  · 共享期间，同一个 WiFi 下的人拿到这个链接也能打开 —— 报告里有你的真实投放数据， 不想让人看就点「关闭共享」，链接立刻失效；
  · 第一次开启时 Windows 会弹「防火墙」提示，要选允许访问，否则手机连不上；
  · 电脑有多张网卡（装过虚拟机／加速器）时二维码可能指错地址，面板里有「换个地址」；
  · 手机上原来「鼠标悬停看大图」点不动，现在改成点一下放大、再点收起。
  顺带修了两个手机上的小毛病：19 位素材 ID 不再被 iPhone 认成电话号码变成蓝链接； 手机上字号不再自己放大。
  注意：已经生成过的旧报告不会自动变（HTML 是生成那一刻定型的）， 重新跑一次才会得到手机能读的新版式。
• 每天生成的文案不再和昨天一样（这一版重点修的就是这个）。 以前每天都是从同一批爆款底本里、按固定顺序抽结构，所以昨天和今天的稿子 骨架几乎一模一样——不是字面像，是结构像，观众听两句就知道是同一个套路换词。 现在每篇都会记下用过哪个骨架、用过哪些开头：同一个商品第二天再生成时， 会优先挑还没用过的骨架；最近 14 天用过的开头会被直接挡住， 模型改不到位的话会标出来提醒你发之前手改一句。 每个商品头上会写清「全部是新骨架」还是「3 条新 + 2 条沿用」—— 底本池就那么几条（这个品类 8 条），轮完了会如实告诉你，不糊弄。 同一天重跑报告结果保持不变（方便你对数），隔天自动换一批。
• 素材报告底部多了一块：直接给你写成口播稿。 取消耗最高的 10 条素材，找到它们挂的商品，每个商品写 5 篇—— 前 10 里有 3 个品就是 15 篇、4 个品就是 20 篇。标题是「对标市场爆款 60000 篇文案生成」， 下面按消耗从高到低排，每个商品一张主图，鼠标指到图上能看大图， 图下就是这几篇正文（每篇后面标了字数）。
• 卖点是从你自己正在跑量的素材里提的，不是从公共话术库抄的。 底部每篇文章的卖点和痛点，来源是这个商品自己那几条口播稿——素材是正在花钱的稿子， 比通用模板贴得多。商品标题不进这一步，只认素材原文里真说过的。
• 点击率高的素材说了算，点击率低的说法会被避开。 同一个商品挂了好几条素材时，先按这一批的点击率分成高／一般／低三档： 卖点优先从高点击那几条提，只在低点击素材里出现过的说法（比如某个工艺细节） 会自动剔掉，不让它带进新稿。每个商品头上会写明「按几条高点击素材提炼」； 如果这一批确实没有明显突出的，会照实写「按全部素材提炼」，不会假装分过档。
• 生成不出来会说清是哪一步卡住，不会空着不吭声。 「没配模型 Key」「连不上云端」「这个品类还没有底本」「这品没挂素材」—— 这几种原因会分别写出来，报告照常出，不会因为文案没生成就不出报告。 另外「一键诊断」里新增了三条：内置证书、云端文案服务、模型 Key， 底部空着的时候先跑一次诊断，一眼看是哪一条。
• 这一块要用你自己的 DeepSeek Key（费用算你的，我们不代付）。 ⚠ 这是 v0.9.74 之前的旧口径，已作废：现在试用 30 天与月付会员 由我们出模型费，只有永久版才需要自备 Key。 Key 只存在你自己电脑上，生成时加密送到我们的服务器算完就丢——服务器不保存、不写日志。 第一次用之前先跑「一键诊断」，三条都绿了再跑报告，省得白等。
• 报告上的数，现在能拿去和千川一格一格对。 你提的这件事我按「逐格对账」做了一遍，还真揪出几处对不上的地方： 成交金额原来四舍五入到元（千川写 ¥2,218.50，报告写 2,218 元，核账差一毛），现在精确到分； 创建时间只显示到日，现在到秒；另外把点击次数 / 展示次数 / 视频时长一起印出来， 你对着千川的列从头往下看，一格一格都能对上。
• 千川上显示「--」的格子，报告不再写成 0。 这是最伤信任的一种错：页面上那一列是空的（比如净成交还没结算）， 以前会被当成 0，报告里就凭空出现「净ROI 0.00 / 成交 0 元」。 现在这种格子一律显示 -，意思是「千川没给这个数」，不是「这个数是 0」。 （顺带修了一个老毛病：点了「没有展示却有几百次点击」这种不可能的组合，也会自动认出是没读到。）
• 不会再把「净成交金额」当成「成交金额」。 如果你在千川里把列配置成只看扣退款后的净成交，以前报告里的「成交」会比千川少掉退款那部分。 现在两列分开认：有「整体成交金额」就用整体，只有净成交就如实显示 -，绝不拿净的冒充整体。
• 素材 ID 一律印全 19 位，包括名字里没带 ID 的那种。 你自己命名的素材（名字里没有「ID:xxx」），以前报告只印文件名、没法回千川搜； 现在照样印「素材ID xxxxxxxxxxxxxxxxxxx」，点一下整段选中，直接粘到千川搜索框。
• 涨跌 / 周榜 / 上榜补采那几行，指标不再是 0。 这些行原来只带了 7 个字段，所以「净ROI / 成交 / 订单 / 点击率」全是 0， 千川上明明有数。现在整行指标都带着走，和主卡片上的数一致。
• 上一版补采进来的那几条，现在也有「文案」和「AI 二次创作」了。 你截图里那条第 2 名：曲线有了、流失点也标出来了，但「文案」是空的， 「AI 二次创作」写着未生成，展开也没有画面 —— 因为补采进来的素材走的是另一条小路， 写文案、写诊断、收画面这三步只认「消耗前 10 名」那一批，把补采的漏在了外面。 现在这三步都认补采的：文案会自动读出来，二次创作和「改动点」都会写， 拍到的画面也会挂到这张卡上。
• 补采的那条不会再被说成「消耗榜第 11 名」。 它其实排在十几名，只是被榜单点了名才去单独采的。 诊断里现在会照实写「不在前 10 名内（榜单点名后单独补采）」， 但结论不变 —— 能上榜、能跑量，就是中段有转化力，改开头和那一处流失点就够了，不必重拍。
• 上榜但没逐条分析的素材，现在「按素材 ID 单独去搜」补齐，不再靠多采几十条。 周榜是按「消耗 × 新近程度」排的，本来就常挑出消耗排在第 15、20 名的新素材。 这种素材以前只有消耗和 ROI，没有流失点、也没有画面 —— 想补全只能把采集条数往上加，越采越慢。 现在反过来：先定榜单，再把榜单点名、但没逐条分析的那几条回到素材列表里 按素材 ID 单独搜出来，只采这几条，采完自动把搜索框清掉，页面还是你原来的样子。 所以采集条数一点没变，报告里被点过名的素材该有诊断的都有诊断。
• 报告顶上会写明这次补了几条（例如「上榜补采 2 条」），补没补上、漏没漏，你一眼能核对。 万一这几条一条都没搜到（比如素材已经被删除），报告照样出，不会卡在那里不出结果。
• 「周榜第 2 名，却写着未收录」—— 这个毛病修好了。 之前报告会一边说某条素材「值得追投、加权 380」，一边在右边写「未收录」，点也点不开。 原因是逐条诊断只做消耗最高的那几条，而周榜是按「消耗 × 新近程度」排的，本来就会挑出消耗排在第 15、20 名的新素材。 现在凡是被榜单点到名的素材都能点开：有画面的给完整卡片，没采到画面的也会告诉你「它在消耗榜第 15 名，所以只有指标」——不再是三个字的「未收录」。
• 列表翻页没读全，这次读全了。 千川页面明明写着「共 236 条记录」，程序只读到 30 条就以为到头了 —— 因为它翻页之后没等列表刷新就去读，读到还是上一页，就判断「没有更多了」。 而报告里的涨跌、周榜、点击率横向对比全靠这批样本，少读 200 条等于很多素材白看了。 现在按页面自报的总数翻，每翻一页都确认列表真的换了才继续；万一真没读全，报告顶上会用红字写明「页面写着共 N 条，本次只读到 M 条」，不会假装看全了。
• 报告里「点击为什么高」那段，不再对着高点击素材说丧气话了。 之前出现过一次很别扭的情况：一条点击率 2.26%、ROI 2.16 已经进消耗榜的素材， 诊断却写「前 3 秒没抓住人，用户缺少停下的理由，点击起不来」—— 数字是这批最好的， 话却在挑刺。现在改成先按同批中位判一个档（高 / 中间 / 低）， 好在哪就说好在哪，然后补一句「还能更高」的具体动作； 只有真的偏低的那条才说问题。标题也会带上数字， 比如「点击为什么高（2.26%｜同批中位 1.40%）」，你自己在千川后台就能核对。
• 「点击峰在中段」的素材不会再被开头冤枉。 有些素材开头 3 秒确实不抓人，但第 7 秒、第 15 秒那一处画面很能转化， 点击全靠那一下。以前只看开头指数，就说它「开头没拉住点击」； 现在会明确写：这条靠的是第几秒那一处，要说的是那一秒做对了什么。 这一版的每一条诊断都会重算一遍，不会沿用旧的那段话。
• 重装、换电脑、清了后台之后，绑过的千川户不会再「消失」。 这一条是你亲自碰到的：后台清理完重新登录，面板上一堆户全没了， 还提示「去绑定千川户」—— 明明绑过。原因是以前只上报、不读取： 插件把「你绑了哪些户」传给服务器，却从来没问过服务器「我绑过哪些」。 现在登录后、打开面板时都会去要一次，本机的户就自己回来了， 再也不用一个个重绑。已经解绑过的户不会被拉回来。
• 「一键启动」点不动那个问题，这次连根拔了。 以前面板不知道你是「还没装」还是「装了但被删了」，两种情况都只会沉默。 现在它分得清，而且会明说；安装包里也带上了「一键安装.bat」， 解压后双击这一个就同时完成：启动程序、设成开机自启、告诉你插件文件夹在哪。
• 解绑千川户：只有永久版可以。 月付和试用版那个「×」现在是灰的 —— 点了会告诉你为什么，不会再有「点了没反应」。 户是跟账号走的：一个户绑定一次就一直在你名下，月付版如果能随手摘掉， 「每月 N 个户」就等于「每月都能换 N 个户」。永久版买断、户数不限， 收拾自己的列表不影响别人，所以放开。跑批、看报告、绑新户都不受影响。
• 「一键启动」点了没反应 —— 现在它一定会说话。 你遇到的那种情况：程序被删了（或者这台电脑还没装过），点「一键启动」毫无动静。 原因不在插件：点它只是让 Windows 去打开已经装在电脑上的那份程序， 那份程序不在了，Windows 就什么都不做，连个提示都没有 —— 以前面板只会一直显示「启动中…」，然后沉默。 现在十几秒没起来就会明说，而且分两种：「这台电脑还没装」（给你三步： 下载 → 解压 → 双击 QCServer.exe）和「连不上了，多半被删了或移走了」 （会写出上次用的是哪个文件夹，并告诉你数据还在、不用重跑）。 它还会继续在后台试，真起来了就自动改口成「已启动」。
• 安装包里多了一个「一键安装.bat」—— 解压后双击它就完了。 以前解压出来一堆文件，看不出该先点哪个：QCServer.exe 看着像服务端， 「一键设为开机启动.bat」看着像设置项，结果不少人直接去点浏览器面板上的 「一键启动」，而那时程序还没装进电脑。现在双击这一个： 启动程序 + 设成开机自启 + 告诉你下一步装哪个插件文件夹， 装完窗口里会直接列出插件目录的完整路径，照着复制就行。 （在压缩包里直接双击也会被拦住，提示你先解压。）
• 面板里那些「说你电脑上没有的东西」的提示，也顺手改准了。 安装说明原来写「第 2 步会显示『运行中 · 数据与报告存在程序目录』」—— 那个路径上一版就不显示了，照着找会永远找不到；现在写的是「运行中」。 另外说明里补了一句要紧的：大模型 Key 和已绑定的千川户也存在程序文件夹里， 重装或换位置前想留着就先拷走（报告和素材数据不会因为这个丢）。
• 升级前已经跑出来的报告，也不会再漏掉。 上一版把「今天这份报告」改成读硬盘上的账本，可账本有个历史遗留： 以前只有「一键全跑」会记账，你在某一户后面单独点「跑」生成的报告， 账本里是空的（今天 13:53 那份就是这样：文件好好在硬盘上，账上却没有）。 现在程序一启动就拿硬盘上真实存在的报告把账补齐 —— 这一份也能直接在页脚点开，不用重跑一遍。 补的时候只补不删、也不会把「上次跑」的时间往回改，跑失败过的那次不会被写成成功。
• 户与户之间不会串。 报告文件名本来就带户尾号，对账时按尾号一一对上； 对不上任何一户的报告文件一律跳过，绝不会把 A 户的报告挂到 B 户后面。
• 跑出来的报告，离开素材分析页也不会「不见了」。 以前报告一跑完，面板底部会出现一个「查看」—— 但那只是当前这一次的记忆： 你切到别的千川页面、或者顺手按一下刷新，它就退回「还没有报告」， 唯一的入口也跟着消失，报告文件其实一直好好躺在电脑里。 现在记的是已经存到硬盘上的那份账（哪个户、几点、报告存在哪）， 所以换页面、刷新、关掉浏览器再打开，都还能一键打开今天这份。
• 底部那一行变成了「今天这份报告」的状态，一眼就知道能不能点： 今天还没跑 = 蓝色小字「今天还没跑 · 点上面「一键全跑」」（点一下会告诉你怎么跑， 不会偷偷帮你开跑）；今天跑好了 = 绿色按钮「📄 查看今天素材报告」。 户多的时候不再互相挤掉：今天几个户都跑了，按钮上会写「（3 户）」， 点开的是你现在这一户的，鼠标停上去会提示另外几户在哪儿点。 万一本机程序没连上、账读不到，会明说「报告索引读不到 · 点这里重试」， 不会假装「今天还没跑」骗你自己去重跑一遍。
• 第 2 步不再显示数据存在哪个盘。 以前连上之后那行会写「运行中 · 数据在 E:\理理2026」，那个路径你不用管、 也不该去动它。现在只写「运行中」——这一行只回答一个问题：本机程序在不在跑。
• 千川后台数据「晚到」时，不再直接不出报告。 千川的素材数据不是每天零点就齐 —— 常见要到当天下午、甚至第二天才补齐。 以前遇到这种情况，软件认死「必须采到昨天」，于是报一句 「统计周期还停在 X，不是最新一段」然后整户失败； 其实那时页面上是有数据的、也能正常出报告，只是最新那一天还没更新。
• 现在改成听千川自己的：日历里还能点的最后一天，就是能采到的最新一天。 举例（10-22 现场）：日历里 21、22 号是灰的、点不动，能点到 20 号 ⇒ 软件就用「最近7天」里的最新一段（10-15 ~ 10-20）正常采集、正常出报告， 面板上会写一句「千川这个户的数据只更新到 2026-10-20」， 让你知道是平台慢，不是软件偷懒。 等第二天平台把 21 号补上，软件自动就用 15~21，不用重装、不用改任何设置。
• 该停的时候还是会停，而且说得更清楚。 点了「最近7天」却只改了开始日、结束日没跟上（半截），或者页面根本没反应 —— 仍然不出报告，提示里会写清「千川这个户的数据只更新到哪天」， 让你按 F5 重试，绝不拿一份日期是几天前的报告糊弄过去。
• 字幕里不会再冒出 AMOM / WOW 这种字母了。 视频角上的台标、水印，以前会被当成「这一秒说的台词」喂给 AI， 于是诊断里就写「画面字幕出现 AMOM」—— 看着就像识别错了。 现在这类一个汉字都没有、又对不上口播稿的字母串会先剔掉。 真有台词的英文字（比如「戴上 ok 就行」）不会误删，纯音乐素材也一行都不动。
• 拿来做「校正基准」的口播原文，换成真正逐字读出来的那份。 以前用的是从抽屉截图上认出来的字（面板字小、换行断字都会跟错）， 拿一份本身有错的东西去校准字幕，只会越校越错。现在优先用抽屉里逐字读到的原文。
• 字幕和原文都可能有错，现在按「两边都通顺」来校准。 原文是作者自己写的，也会写错 —— 实测就有「视觉上」写成「试卷」、「脸型」写成「洁面」、 「头围」写成「头尾」。所以不再照抄原文，只修错字/漏字/语序，不会凭空加句子。
• 一个账号绑很多千川户，面板也不会被撑爆了。 户列表只在中间那几行里滚动（默认露 5 行），「一键全跑」和完成卡永远在原位； 想看全部点表头的「展开」。以前户一多，主按钮直接被顶到屏幕外，拖都拖不回来。
• 每一行都带尾 4 位，跑完也不会变成图标就认不出是哪个户； 这一户上次的报告，行后面直接有「看」，不用再翻到最下面那张卡。
• 全跑结束给的是汇总：几户完成、几户失败，而不是只剩最后一户的名字。 失败的那户单独重跑一次就好。
• 户数上限那一栏，不限户的套餐现在写「不限」，不再是看不懂的横杠。
• AI 那段画面描述，现在真的看的是「点击峰前 3 秒」整段。 以前这 3 秒只把**最后一帧**交给它，前面两秒多只有字幕文字 —— 所以「举着三顶帽子」「拿帽子遮住脸」这种动作它根本没看见，写出来只能靠猜。 现在整段都给，动作前后变化它看得到。
• 画面重抓一次，AI 那段话一定跟着重写。 以前只比「第几秒」：秒数没变就沿用旧结论，于是出现「图换成这条的了、话还是上一条的」。 现在按画面文件本身认 —— 帧换了就重写，不再有半新半旧。
• 只抓到数字、没抓到明细的那条，卡片上会说清原因（不再是空白一片）， 重跑一次这一天通常就能补上。
• 接着上一版：重跑的时候，AI 那段话也会跟着重写。 AI 的结论是存着复用的，只要「第几秒」没变就不重算。 上一版把画面纠正过来了，但画面一换、秒数不变，AI 那段话还会是照旧画面写的 —— 又变成「图对了、话不对」。现在画面重抓一次，这段旧的 AI 结论就自动作废重写。
• 所以要做的只有一步：重新点一次生成。 画面、字幕、AI 那份建议会一起变对；旧报告被覆盖。
• 「素材ID 和画面对不上」找到了真原因：画面整体错位了一条。 报告里第 2 条素材配的是第 1 条的视频画面，第 3 条配第 2 条的…… 所以「第几秒该改」这些结论，说的其实是另一条视频。 原因是列表第一行那个「AIGC 动态创意视频素材集合」没有素材 ID、也不算一条素材， 但它实实在在占着一行的位置，程序按行数序号去点，就整体差了一位。
• 现在改成按素材 ID 找那一行（找不到 ID 就用文件名），不再按序号数。 同一份数据重跑一次，画面、字幕、结论就全都对上了。
• 已经出过的旧报告不会自己变对 —— 里面的画面和结论是错位那条的。 请重新点一次生成，当天这份会被覆盖成正确的。
• 新电脑装好之后「还要点一下」这件事，压到只做一次。 面板里原来写「双击桌面「0-启动千川素材助手」」—— 那个快捷方式现在的安装包里根本没有， 照做只会找不到东西。现在改成写真的：先双击程序文件夹里的 QCServer.exe。
• 一步到位的做法：双击包里的「一键设为开机启动.bat」→ 输入 1。 现在它除了设开机自启，还会顺手把程序启动起来，你不用再去找 QCServer.exe。 从此这台电脑开机就自己跑，升级也不用管，等于以后一次都不用点。
• 为什么非得点这一次：浏览器有安全限制，网页和插件都不能自己启动你电脑上的程序。 这一下绕不过去，所以就让它只发生一次。
• 端口被占用时，窗口里那句话会立刻出现（上一版要等一会儿，容易让人以为卡住了）。
• 内容同上一版：先问「你是谁」，确认是别人占了 8766 就直接说清楚， 并把对方回的内容一起打出来；那个程序一关掉，这边最多等 2 分钟就自己接上。
• 「为什么链接不上」—— 这次查清了：不是你的电脑坏了，也不是程序坏了。 8766 这个端口被另一个程序先占了（本地另开的一个小服务，端口也写的 8766）， 我们的程序排在后面进不来。更糟的是以前它只会说「已经在运行了，这个窗口可以关掉」， 你照着关掉、再双击，面板还是「本机服务没响应」—— 因为真正抢端口的东西不在你关的范围里。
• 现在它会先问一句「你是谁」：回来的确实是我们自己，才说「已经在运行了」； 回来的是别人，就直接告诉你「8766 被别的程序占用了」，并把对方回的内容打出来， 让你一眼认出是谁（还会教你怎么查：netstat -ano 看进程号）。
• 而且它不再立刻放弃：你在那边把占端口的程序关掉，这边最多等 2 分钟， 一空出来就自己接上，窗口不用再关。
• 顺手把本地另一个服务（罗盘文案底本服务）的默认端口从 8766 挪到了 8770， 两个程序以后不会再撞在一起。
• 「搜出来的视频素材ID居然对不上」—— 修好了。 报告卡片上那串 ID 原来被砍掉了最后几位（显示成 17 位，真的号是 19 位）， 拿它去千川后台或者文件夹里搜当然搜不到。现在素材ID 完整显示、永远不会被截断， 点一下就能整段选中复制。
• 卡片上那一行也理顺了：文件名 · 千川标签（首发/优质）· 素材ID 分开写。 以前「首发」和「ID」是粘在一起的，看着像「首发ID」，容易当成另一个号。
• 顺带说明：文件名那串 32 位字母数字才是你电脑里视频文件的名字， 把它复制到文件夹搜索框，就能找到这条视频本身（素材ID 是千川后台用的号，两者本来就不是一回事）。
• 完成卡再修一处：右边「查看」不再把标题挤到第二行。 上一版把完成提示做成完成卡之后，标题字一长（「理理服配-XA 已完成 2026.10.21 素材报告」）， 「查看」按钮会被挤到下面一行去。现在按钮钉在右上角、标题自动折行，一眼就能看到。
• 面板底部的「上次报告」也缩短了，只写「上次：10-21 报告 · 查看」，不再糊一大串网址。
• 教程页里的网址现在可以直接点：「platform.deepseek.com」「API keys 页面」「充值页面」 都变成了蓝色可点的链接，点一下就在新标签打开，不用再自己往地址栏里抄（抄错一个字母就打不开）。
• 统计周期真的会自动校准了（这次找到真凶）。 以前跑之前会去点「最近7天」，但千川是先改开始日、隔一拍才改结束日， 而我们一看到"日期变了"就以为改好了 —— 于是抓到「10-14 ~ 10-19」这种半截， 报告日期自然还停在前两天。现在必须开始日和结束日都对、并且稳定下来才算改好； 真改不动就当场告诉你「按 F5 刷新再跑」，绝不再拿旧日期的数据出一份看着正常的报告。
• 完成提示改清楚了：现在是一张完成卡 ——「理理服配-XA 已完成 2026.10.20 素材报告」， 右边一个「查看」按钮，第二行小字写「数据窗口 · 30 条 · 画面帧 33 张 · 含 AI 点评」。 原来是一行 11px 的绿字，跑完还得找。
• 「3 分钟教程」改成网页版了：原来藏在面板里的一行小灰字、430px 的弹层， 图根本看不清。现在是一个看得见的按钮，点开在新窗口打开完整教程页 （图可以点开放大）。
• 以后升级不用再关黑窗口了。 以前每次更新，都得先把黑色窗口关掉、再重新双击程序 —— 漏做一次， 跑的还是旧程序，表现出来就变成「软件坏了」「保存不了」。 现在程序会自己发现已经换成了新版本，在你没在跑的时候自己重启一下， 这段时间里黑色窗口会自己关掉、又自己开回来。
• 你只需要：解压覆盖 → 等十几秒 → 插件点「重新加载」→ 千川页面按 F5。
• 正在跑批的时候它会等，不会把你跑到一半的任务打断；万一新版本起不来， 也最多只试两次，绝不会让程序反复重启。
• 顺手修了黑窗口里中文变成一串「?」的问题（换台电脑就可能出现）。
• 「为什么没有图片」—— 修好了。 报告卡片左边那块空白是画面截图。数据其实是齐的，问题是那一轮还在写截图的同时 已经去生成报告了，报告就在"截图还没落好"的一瞬间生成完，而且没有任何提示， 看起来就像软件坏了。现在三步（收数据 → 收截图 → 出报告）排队执行，不会再交错。
• 再加一道保险：报告出完会自己数一遍图，该有图却是 0 张就自动重做一次； 真的没有时，面板会直接告诉你「画面帧没进报告，再跑一次就好」，不再让你对着空白猜。
• 完成提示现在会写明「画面帧 33 张」，图有没有进去一眼就能看出来。
• 「报告没生成：build_summary … gbk codec can't encode character」—— 修好了。 这是主程序往后台窗口打印「¥」这个符号时，中文系统默认编码装不下它， 于是整步直接失败、报告出不来。不是你的 Key 或账号的问题， 现在打印日志时统一走 UTF-8，编不出的字符也只是显示成问号，不会再让流程中断。
• 顺带把失败提示改成人话：以前会把一整段英文报错和电脑里的文件路径贴到面板上， 现在只说发生了什么、下一步该做什么。
• 「显示完成 30 条，可是报告里没有 AI」—— 这一版补上了。 以前跑完只做「数据 + 画面 + 规则报告」，逐条 AI 诊断（为什么点、为什么走） 要另外跑一遍完整流程才有，所以面板说"完成"的时候报告里确实缺了 AI 那一段。 现在报告出来后会接着自动补 AI，补完才算完成：进度条上会写 「AI 1/4 逐条诊断…」，完成时显示「含 AI 点评」。每户大约多花一分钟。
• 不再把几天前的老记录当成"刚刚又失败了"。 面板上那条「全部完成：0 个成功 / 1 个失败」是好几小时前那次的记录， 它一直躺在磁盘里，每次打开面板都重新画一遍，跟你当下这一单没有任何关系。 现在只显示本次打开面板之后跑出来的结果，历史记录不再冒充当前状态。
• AI 没跑成时会直说原因（比如没填大模型 Key、这户还没有素材文件）， 不会再用一句"完成"盖过去。
• 「送达失败：本机服务返回异常（HTTP 500）」—— 原因：本机程序还是几小时前的旧版。 每次更新都会重新生成主程序文件，但如果你没有把那个黑色窗口关掉重开， 它跑的还是旧代码（浏览器插件已经是新版，本机程序没换）。这一版让程序自己认： 发现"程序文件比正在运行的进程新"，面板会直接拦住并提示你重启， 不会再跑到一半丢一句 HTTP 500 让你猜。
• 顺带修了同一个坑的另一面：素材位置那一行会写明「程序是旧版，关掉黑窗口重开」。
• 数据概览有消耗、素材分析却 0 条 —— 原因找到了：范围里带上了「今天」。 千川的素材分析是隔天出数（日历里"今天"是灰的、点不动），所以只要统计周期里包含今天， 接口回来的就是空的：报「这段周期没有素材」，但你的账号其实天天在花钱。 现在跑之前会检查：只有一天、或者范围里含今天，就自动改成「最近7天」（到昨天为止）， 面板会写明「统计周期原来是 2026-10-18 ~ 2026-10-20，已改成 2026-10-13 ~ 2026-10-19」。 正常选的上月、自定义区间一律不动。
• 不会再在"别的页面"上瞎跑：以前停在数据概览，那里也有「推商品/推直播」的图表切页， 软件以为到了素材分析，点了以后下面没有列表，就报"没素材"。现在必须看到「视频素材」这排页签才算数。
• 这次终于找到了真正的原因：页面上那个「统计周期」被选成了今天。 千川是隔天才出数据，周期只有今天的时候，素材列表本来就是空的 —— 以前软件照样去点「推商品」，然后报「这段周期没有素材」，看起来像账号没素材。 现在点「一键全跑」之前会先看一眼周期：只有一天就自动改成「最近7天」， 并在面板上写明「统计周期原来是单日（2026-10-20 ~ 2026-10-20），已改成 2026-10-13 ~ 2026-10-19」。 已经选了好几天的，一个字都不动，尊重你自己选的。
• 「推直播 没找到这个筛选项」不会再误报了：切换筛选的那一瞬间，页面上那一行按钮 会被重新画一遍，旧版本正好卡在这个空档去读，就写成"没找到"。现在会等它画完再确认。
• 万一周期改不动，会把话说清楚：会直接告诉你「自动切最近7天没成（原因）」， 并提示你手动点开页面上方的日期框选「最近7天」—— 不会再把责任推给你的账号。
• 窗口拉小、屏幕缩放不一样，都不影响跑：这一版专门拿九种窗口尺寸 （从 1920×1080 一直到 700 宽、300 高）在同一台机器、同一个账号上逐个试过， 结果完全一致 —— 都能自动切到「推商品」并读到素材。 原因是认按钮靠的是按钮上的字，不是"它在屏幕上的位置"，所以窗口多大都认得出。
• 面板拖到屏幕外面会自动拉回来：显示器比窗口小、或者缩放改过的时候， 以前可能把面板拖到看不见的地方，下次打开就"找不到了"。现在拖到哪儿都限制在看得见的范围内。
• 「诊断」会带上你那台机器的窗口大小和缩放：万一换台电脑还是不行， 点「诊断 → 复制诊断结果」，里面会写窗口多大、缩放多少 —— 不用再解释，一眼就能对上号。
• 「推商品 0 条 / 推直播（没找到这个筛选项）」这条红字不该再出现了： 上一版能自动切「推商品」了，但页面上叫「推商品」的地方不止一处 —— 筛选面板展开时的选项、弹层里的按钮，字一模一样。点错了地方，页面会跳走或者把面板关掉， 接着就连「推直播」都找不到了，看起来像"这个户没素材"。 现在只用真正的筛选按钮，弹出层里的一律不点；万一页面还是被点跳走了， 会直接说「页面跳走了」，不会再谎报成没有素材。
• 报错里会写清是哪个「统计周期」：素材分析页顶上有统计周期， 如果它只有一天（比如就是今天），而今天还没发素材，列表当然是空的。 以前只有一句「这段周期没有素材」，看的人只能去怀疑自己的账号。 现在会写成「统计周期 2026-10-20 ~ 2026-10-20 里没有素材：推商品 0 条 / 推直播 0 条 （页面显示「暂无数据」）」，只有一天时还会直接提示：把周期改成近 7 天再跑一次。
• 「诊断」现在会把当前页面一起带回去：统计周期、当前选中的筛选、 列表读到几行、页面上写没写「暂无数据」。以后再出问题，点一下「诊断」→ 「复制诊断结果」，把那段文字发过来就行，不用再截图，也不用猜。
• 顺手修了一个很难发现的：以前每次更新只换了主程序， 跟着主程序一起用的几个脚本文件（「诊断」用的那份就在里面）一直没换 —— 于是程序是新的、诊断却还是旧的。现在一起换了。
• 「一键全跑」现在真的会自己切到「推商品」，而且会等页面加载完再动手：上一版虽然加了 自动切换，但它动手的时间太早 —— 页面刚打开、筛选按钮还没渲染出来就去点， 等于点空气，于是又报「列表是空的」。现在会先等「视频素材 / 推商品」这套按钮 真的出现、点完还会回头确认「是不是真的切过去了」，确认切到了才读列表。
• 千川改列名不会再让报告读空：千川把「消耗」改成了「整体消耗(元)」， 还多了「综合成本(元) / 综合营销ROI / 净成交金额(元)」这一套全域口径。 以前只认「消耗」两个字，列名一改整张表都认不出来。 现在两套名字都认，并且严格区分「成交金额」和「净成交金额」（后者是扣掉退款的）。
• 推商品真的没数据时，会自动改用「推直播」，并告诉你两个筛选各有多少条， 不再一句话把整个户判成失败。
• 「一键全跑」现在会自己把筛选切到「推商品」：素材分析页默认停在 推直播，多数账户那一栏是空的（页面显示「暂无数据」）， 以前脚本就着这个空列表往下跑，结果报「没找到素材列表」，还白白导航好几轮。 现在开始跑之前会先点「视频素材 → 推商品」，切好再读列表； 如果这个账户这段周期确实没有推商品素材，会直接说「列表是空的」， 不会再让你去怀疑页面没打开。
• 修好了「API Key 点保存保存不了」：那一下其实不怪 Key —— 本机程序没启动，Key 要写进本机的一个配置文件，程序不在就写不进去。 以前界面只会丢一句「保存失败」，谁也不知道该干什么。现在： ① 面板顶部会有一条黄色提示，直接写「本机程序没启动 · 点这里重连」， 下面告诉你双击哪个文件；② 点保存不会再停在「保存中…」， 而是当场告诉你先去启动程序。
• 按钮不会再一直转圈：万一后台脚本没回话，按钮也会在几秒内自己恢复， 不会再出现「点了没反应、一直显示绑定中」这种没法判断的状态。
• 现在能看出「插件是不是最新的」了：以前插件更新了、但浏览器里没点刷新， 面板显示的版本号还是旧的，谁也发现不了 —— 这次的 bug 就是这么被藏住的。 现在只要发现磁盘上已经是新版、页面还在跑旧版，顶部会出一条红条， 明确写着先去 chrome://extensions 点刷新、再回千川按 F5。
• 新增「一键设为开机启动」：装好以后双击包里的 一键设为开机启动.bat，输入 1 回车就行 —— 以后开机自动启动本机程序，不用再每天去点那一下（窗口最小化，不挡屏幕）。 想改回手动：再双击它，输入 2。
• 重复打开不再报红字：以前程序已经在跑，你再双击一次，黑窗口会刷一屏 [Errno 10048] 之类的英文错误，看着像装坏了。现在只会写一句 「已经在运行了，这个窗口可以直接关掉」。
• （上一版）修好了「一键全跑，0 个成功 / 1 个失败」：点是停在千川首页点的全跑 —— 脚本在首页里找不到素材列表。现在会先自动打开素材分析页再跑。
• （上一版）每个千川户后面多了一个「跑」：只跑这一户，其它户不动， 下面会出现这一户自己的进度条；「一键全跑」的进度条也会边走边写正在做什么。
• 修好了「一键全跑，0 个成功 / 1 个失败」：原因很具体 —— 你点一键全跑的时候，页面停在千川首页，脚本就在首页里找素材列表，当然找不到， 于是这一户直接被记成失败。现在点一键全跑会先自动把素材分析页打开再开始跑， 不用你先手动切到那一页。
• 每个千川户后面多了一个「跑」：只想看眼前这一个户的时候，点它后面那个 「跑」就行 —— 其它户不会动，也不用等整批排完。它和「一键全跑」算的是同一套数、 出的是同一种报告，区别只是只跑这一个。
• 两条进度条：点户后面的「跑」，下面会出现这一户自己的进度条 （读列表 → 扫曲线 → 抽画面 → 出报告，一格一格往前走）；「一键全跑」那条进度条 也不再只在户与户之间跳，正在做什么、做到哪一步都会写出来。跑完是绿条，失败是红条。
• 「按你说的点了没反应」这次是真修了 —— 而且面板会自己承认没装上： 上一版改完之后你看到的现象没变，是因为插件更新后要重载、页面还要按一次 F5； 页面里跑的还是旧脚本，界面就继续"说假话"，而版本号显示的是新版本，谁也看不出来。 现在面板右上角显示的是这个页面正在跑的版本，一旦和实际版本对不上， 面板顶部会直接出现一条红条，写着"按 F5 刷新"。
• 「绑定了，但下面还写『还没绑定任何户』」修好了：以前"读不到本机账本" 和"一台户都没绑"长得一模一样，都是那句「还没绑定任何户」，你明明绑好了也以为没绑。 现在分开了 —— 真的没有户才这样写；读不到就显示「读不到本机账本 · 点这里重试」， 点一下会真的重新连一次本机程序，不是重画一下界面。
• 「Key 保存完又变回未配置」修好了：保存成功后，面板一律以"保存成功"为准 认定已配置，不会再退回「先填大模型 Key」让你以为白填了。
• 主按钮的提示更具体：素材位置没设好时，主按钮写的是 「先设素材位置（第 2 步点『填写』）」，不再是一句含糊的"先完成上面的设置"。
• 修好了「点『绑定当前户』没反应」：这是上一版最坑的一处 —— 点下去其实已经绑上了 （户确实写进了本机账本），但面板读不回户列表，所以第 3 步永远停在「绑定当前户」、 下面还是「还没绑定任何户」，看起来就像按钮坏了。现在点一下当场变绿勾、户列表马上出现这个户， 绑定成功会明确写着「已绑定」。
• 同一处毛病还牵连了两个地方，一并修好：① 素材位置明明填了、程序明明开着， 却一直显示「没连上程序」；② 大模型 Key 存进去以后，面板上还一直写「未配置 Key」。 这三件事其实是同一个原因 —— 插件去本机程序拿数据时读错了位置， 拿到"空"却不报错。现在三处都按真实结果显示。
• 大模型 Key 只填一行：以前点开「大模型 Key」要填三个框（接口地址、模型名、API Key）， 非技术用户基本看不懂。现在只剩一个 API Key，接口固定走 DeepSeek， 地址和模型名都不用管；Key 存进去后软件会自动验一次，通了就把余额告诉你。
• 第 3 步「绑定当前户」：以前素材位置还没设好的时候，第 3 步只显示一行户名、 没有按钮，看着像"没地方点"。现在这一步固定有一个「绑定当前户」， 跟素材位置无关。
• 程序没开也能先填素材位置：以前点「填写」如果本机程序还没启动， 只会弹一句红字把你挡回去，什么都填不了。现在先让你填 —— 程序开着就立刻生效； 程序没开就把路径记下来（面板显示黄字「待生效」），你双击启动程序后自动生效， 不用再填第二次。顺手把「重试」按钮改成了「填写」，它本来就是让你填路径的。
• 填 Key 少按一次：永久版「填 Key」那一屏原来三个按钮（获取 Key / 测试连接 / 保存）， 现在是两个 —— 保存 在前、获取 API Key 在后，「测试连接」去掉了。 Key 存进去后软件会自己验一次：通了直接把 DeepSeek 余额告诉你；没通给个黄色提醒 （保存已经成功了，不用重填）。
• DeepSeek Key 教程放大：以前那个「拿 Key」的教程弹层只有 380px 宽、 正文 10.5px，图里那几行小字基本看不清。这一版弹层放宽到 680px、字号整体上调， 图片按弹层宽度铺满（竖版截图单独按高度收，不会被压成窄条）， 点任意一张图可以全屏看；标题栏改成吸顶 + 右上角一个关闭按钮， 看到第 5 步想退出不用再滚回最下面。
• 插件改成「进了千川就出现」：以前只在一个域名（qianchuan.jinritemai.com） 下注入挂件，页面一跳巨量统一后台（business.oceanengine.com）、 或者千川把内容装进同域 iframe 里，右下角那个「川」圆点就不出现， 看起来就像插件没装好。这一版把注入范围扩到千川/巨量的全部相关域名， 并且所有 frame 都注入（浮层只挂最外层，不会叠出好几个圆点）。 另外启动顺序改成先把圆点挂出来、再去连本机服务：本机程序没启动也能看到圆点， 点开就有提示，不会一片空白。
• 插件改成「解压好的文件夹」直接装：以前包里只有一个 插件\…_插件_v<版本>.zip，有人在「加载已解压的扩展程序」时选中了安装包外层目录， Chrome 当场报 Cannot load extension with file or directory name _internal —— _internal 是主程序的运行库，Chrome 规定扩展目录里不能有 _ 开头的名字。这一版包里已经把插件解压好（插件\千川素材助手_插件_v0.9.94）， 选它就行、不用自己解压；包根和 插件\ 里各放了一份安装说明， 写清了「选哪个、别选哪个、报错长什么样」。
• 周榜改为「按当天体量」定门槛：以前周榜跟消耗榜用同一把尺（¥100）， 刚起量的新素材根本进不来；现在门槛 = 当天消耗榜末位的 50% （不封顶 —— 新素材整体量级大时门槛会高于消耗榜，报告里会照实说明）。 报告里写明「本次 ¥XX = 末位 ¥XX 的一半」，素材多的账号门槛自然抬高， 素材少的账号也不会被一条大鱼把门槛带飞。
• 消耗榜单从 11 条改为 10 条，并加了进榜门槛：消耗要 ≥ ¥100 或占到全量的 1%， 不够格的素材不再占榜（会在榜底注明「另有 N 条低于门槛未进榜」）。
• 差异对比换了画法：前 3 与其他素材按「成交与成本 / 开头与节奏 / 内容表现」三项双向比， 超出噪声的才标色，持平写「≈ 持平」，下面直接给一句结论。
• 卖点/人群标签对比改成占比条形榜：以前两栏并排显示标签出现"次数"，但前 3 只有 3 条、 其他有十几条，次数根本不可比；现在统一折算成占比，两栏同尺，长度可直接横着比。
• 修了安装包的一个硬伤：旧包漏打两个运行依赖，部分电脑上跑到「生成报告」会报 No module named html、AI 那几步直接失败。这一版已补齐， 并且打包流程里加了一步「逐个试 import」的自检，以后漏依赖会当场拦下、不会发出去。
• 流失峰位归因改口径：同一秒在多条素材上都掉人，不再当成"平台特性"放过， 按内容问题给改法（重点前置 / 换掉那一秒的画面或说法）。

安装三步

1. 解压到固定目录，建议：F:\千川素材助手。 ⚠ 别每次换目录 —— 数据、报告、已绑的户、Key 都在程序文件夹里， 换一处就等于换了一份软件，旧的那份还在，看起来就像「Key 和户丢了」。
2. 双击 一键安装.bat（它同时做三件事：启动程序 + 设成开机自启 + 告诉你下一步）。 看不到任何窗口是正常的 —— 它没有黑窗口，缩在右下角任务栏。 首次运行 Windows 可能弹「Windows 已保护你的电脑」：点「更多信息」→「仍要运行」。 出问题双击 一键诊断.bat，它逐项告诉你哪里不对。
3. 装插件：不用解压，打开 chrome://extensions → 右上角打开「开发者模式」→ 点「加载已解压的扩展程序」→ 选这个文件夹： 插件\千川素材助手_插件_v0.9.100
   ⚠ 别选外层那个「千川素材助手」文件夹 —— 里面有 _internal，Chrome 会报 Filenames starting with "_" are reserved，跟插件坏没坏没关系。 包根有一份 安装说明.txt，插件\ 里那份叫 装插件看这里.txt（两块内容不一样，各看各的）。

首次使用

1. 只能用谷歌 Chrome（红黄绿蓝圆标那个）打开千川并保持登录。 Edge、360、QQ、搜狗、火狐都不行 —— 插件装不上，或装上了也看不到面板。
2. 进千川「素材分析」页，点页面右下角写着「川」字的蓝色小方块， 面板就展开了。第一次会让你登录 / 注册（手机号），登录后点 「+ 绑定当前千川户」把要分析的户绑上（v0.9.72 起它叫这个名，不叫「添加千川户」）。
3. 点「⚡ 一键全跑」，等它跑完（单户约 10~15 分钟，取决于素材条数），报告在 reports\素材报告_日期.html。

数据去哪儿了，如实写：素材列表、视频帧、截图、字幕、生成的报告 全部只存在你自己电脑上，不上传；服务器只保存账号、授权与配额。 唯一的例外是「对标文案」那一步 —— 它要把素材的文字稿（不是视频、不是图片） 加密送到云端做生成，算完就丢、不落盘、不写日志。 （以前这里写的是「全部不上传服务器」，与实现不符，已改。）