德饱自媒体助手（@local/debao-media）

下载安装包：Releases（含最新 Beta 包）（debao-media-plugin-v1.0.9.tgz，382 KB，Windows · Beta · 免费）

小红书 + 抖音双平台的内容工作台，一条流水线：

采集 → 拆解 → 仿写 / 原创 → 选题 → 封面 → 视频解析 → 账号学习 → 创意建议

采集：浏览器里打开笔记/视频，点右下角按钮，标题、正文、标签、赞藏评、封面、视频直链自动进来。
后台同步：打开创作者中心（creator.xiaohongshu.com / creator.douyin.com），点「同步后台数据」，页面里那些接口返回的数据（笔记列表、粉丝数、播放）都会被存下来；换号再同步一次就是第二个账号，插件里按平台 + 账号分开看。
视频 / 音乐解析：视频条目点「视频解析 →」，把直链交给 ffmpeg 抽帧 + 豆包视觉模型，出镜头时间轴、结构、可复用模板。
账号学习：把采集来的内容算成统计（互动分位、标签表现、发布节律、爆款 vs 平款差异），再让助手据此出账号画像与创意建议。

不把内容上传到任何服务器：采集数据只存在本机 bridge/data/*.json，表单和草稿存在浏览器 localStorage。调用模型时只把你选中的那一条素材（或抽出来的几帧）发给豆包 / DeepSeek 的官方接口。

安装（从 GitHub 装）

前提：已经装好 DeepSeek Harness 桌面版，并且能用命令行 dsh。

# 1) 拿代码
git clone https://github.com/<你的用户名>/debao-media.git
cd debao-media

# 2) 装进 DSH（profile 一般是 desktop 或 web）
& "$env:LOCALAPPDATA\Programs\deepseek\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add file:.

# 3) 起本机桥（双击也行）
bridge\start-bridge.bat        # 保持这个窗口，或把 bridge\watchdog.vbs 放进启动项

# 4) 装浏览器扩展
#    chrome://extensions → 打开「开发者模式」→「加载已解压的扩展程序」→ 选 bridge\extension

# 5) 填一个豆包 key（视频解析必需；文案默认用 DSH 里登录的 DeepSeek，不用填）
#    打开插件 → 设置 → 填 ARK Key → 保存

装完重启 DSH。详细图文步骤与常见问题见 安装说明.md。

知识库是可选的：仓库里不带课程语料（版权原因），bridge/kb/kb.js 是检索器。想用「依据」功能，把你的 markdown 放进 kb/distilled/、kb/videos/ 即可（格式：普通 .md，二级标题当章节）。不放也能跑，只是没有引用。

板块结构（两大板块 + 两个库）

侧栏按四组分，一眼能看出「我在学东西」还是「我在做东西」：

工作台：总览看板 / 采集库
拆解与学习：拆解 / 仿写 / 搜索 & 热榜 / 找博主 / 账号学习 / 学习库
- 拆解、仿写不用手填：左上角「从采集库选」挑一条，或直接在采集库卡片上点「拆解 →」「仿写 →」，素材自动带进来，点「⚡ 一键生成」出成品；视频素材多一个「解析视频」，本机抽帧 + 豆包看画面。
- 成品按 Markdown 渲染，表格是真表格（分镜表、对比表都能直接看）。
- 学习库：把拆解、仿写、视频解析、博主、账号学习、后台分析统一成一张多维表格（类型 / 标题要点 / 来源 / 数据 / 标签 / 时间 / 操作）。可按类型和平台筛、关键字搜（标题、作者、标签、备注都搜）、星标、行内打标签写备注、点开看全文、＋添加 自己记一条、勾选后批量删除、一键去重（同类型 + 同标题只留最完整的那条，删掉的不会再被同步回来）。
原创：原创（文案 / 脚本两种模式，脚本出分镜表）/ 选题 / 创意 / 灵感库
- 原创页「做哪一种」切换：文案原创 = 图文笔记正文；脚本原创 = 镜号/时长/画面/口播/字卡/声音/作用的分镜表 + 逐字稿 + 拍摄清单。
- 灵感库：一句话先记下（现象、反直觉的细节、想说没说出口的话），攒够了点「做选题」「做创意」直接带进对应页签。
我的：后台数据 / 我的账号 / 原创库 / 草稿 / 设置
- 后台数据：创作者后台同步来的数据按平台（小红书 / 抖音）分开，支持多账号；「上传文件」可以直接丢 CSV / JSON 作品表进来（同样的行重复上传会自动去重）；「AI 分析」把账号现状 + 采集库里同平台的同类标杆 + 上传的数据一起交给 DeepSeek，按编导方法论（爆款四必要条件 / 三条路径 / 行为链复盘）与 Dan Koe 的一人公司逻辑出诊断、选题与 21 天实验。
- 设置：三张 key 卡（豆包 / DeepSeek / TikHub，实时显示「已配置 · 来源」）、用量与费用（视频解析与文案生成分账、按天明细）、单价、以及知识库来源（关闭 / 本机文件夹 / 随插件自带 / IMA 云端，可分组、可搜索、可点开看原文）。
- 作品自动按来源分库：拆解、仿写、视频解析、博主、账号学习、后台分析都进「学习库」；原创、选题、创意进「原创库」。

文案用哪个模型（不用填 key）

插件 host 半（index.js）在 DSH 里注册了两条本机路由：

路由	说明
`GET /debao/gen/status`	探测环境内模型是否可用（返回 `{ok, llm, provider, model}`）
`POST /debao/gen`	SSE 流式生成，内部调 `ctx.llm.stream({ provider: 'deepseek-account', model: 'deepseek-flash' })`

桥（bridge/text.mjs）每次生成前先探一眼：能用就走 DSH 环境里登录的 DeepSeek（不需要任何 key，模型 deepseek-flash）；不可用才回落到豆包 ARK 或你自填的 DeepSeek key。视频画面解析始终走豆包 ARK。

实测：一条 39 字结论 1.2 秒返回，模型报 deepseek-flash。设置页会显示「文案模型：deepseek-flash（环境内直连，不用 key）」。

ctx.llm.stream 的 messages[].content 必须是分片数组（[{ type: 'text', text: '...' }]），传纯字符串会报 content.some is not a function。

桥挂了会自己回来

bridge/watchdog.vbs 每 45 秒探一次 http://127.0.0.1:53210/health，不通就静默拉起 start-bridge.bat。启动项里放一个指向它的快捷方式即可（本机已放 debao-watchdog.lnk）。

.vbs 必须纯 ASCII 且不带 BOM：wscript 按 ANSI 读脚本，UTF-8 中文注释会让它弹「无效字符」错误框后卡住。

给别人装（插件版分发）

有人在群里要现成包的话，直接给 GitHub Releases 里的 .tgz（每次发版都会附上）。

一条命令安装（profile 名看 %USERPROFILE%\.dsh\profiles，一般是 web 或 desktop）：

& <DSH安装目录>\resources\runtime\cli\bin\dsh.cmd plugin --profile desktop add file:<下载的 tgz 路径>

装完重启 DSH。注意 package.json 不能带 BOM，否则 DSH 校验会报 Unexpected token '' 并回滚（已踩过）。

本仓库不含课程语料（版权原因），知识库目录留空即可用；自己往里放 md 就会出现在「设置 → 知识库」里。

详细步骤与 FAQ 见 安装说明.md。

怎么打开

左侧栏「德饱自媒体助手」图标。改过文件后按 F5 刷新 DSH 页面；没出现就重启 DSH。打开后头部有「小红书 / 抖音」切换——同一个方法论，两个平台的标题字数、标签数量、封面比例、算法口径会跟着变。

十七个页签（左侧竖排导航，按「工作台 / 拆解与学习 / 原创 / 我的」分组，鼠标滚轮可滚）

除采集库外，每个生成器页签左上角都有「⚡ 一键生成」：点一下就由本机桥直连豆包（doubao-seed-2-1-lite，默认关掉思考模式，一句话 2 秒、1500 字文案 10-30 秒）把成品写在右栏，流式输出；写完自动落库到「作品库」，可以「采用 / 存草稿 / 重写 / 复制」，关掉对话框也不会丢。原来的「复制指令」还在（复制指令 按钮），想丢给对话模型跑也行。

页签	你要填的	出来的东西
▲ 热榜	抖音挑战榜直接看；小红书切「关键词榜单」填关键词 + 时间窗（当日 / 3 天 / 7 天 / 30 天）+ 排序（点赞 / 收藏 / 时间）	抖音：官方挑战榜 50 条，带排名、热度、视频数、每分钟热度走势 sparkline，可「打开」或一键「找视频」把该话题当关键词跑榜单；小红书：没有公开热榜，用搜索结果按互动排序生成「当日榜」，可「拆解」或「入库」。10 分钟缓存，点刷新强制更新
★ 采集库	基本不用填：浏览器里点一下采集，回来点「刷新」	卡片墙（封面 / 时长 / 平台与类型徽标 / 直链 / 已解析 / 解析结论摘要）：解析视频、看解析、拆解、仿写、原帖、删除；支持卡片 / 列表两种视图（列表带「内容素材概要 / 内容评分 / 爆款指标 / 数据 / 正文标签 / 操作」六列）、平台与类型筛选、「只看有直链」、关键词搜索、勾选 + 批量编辑（分类 / 对标评分 / 备注）/ 批量删除、一键解析全部视频（最多 6 条，带进度）
拆解笔记	标题 + 正文 + 标签 + 三个数据 → 一键生成	五维拆解（选题痛点 / 标题公式 / 内容结构 / 语言风格 / 读者心理）+ 三步填空模板 + 机读评分
仿写	参考笔记 + 要换进去的信息 → 一键生成	结构对照表 + 正文成稿 + 标题 + 标签 + 撞车检查
原创	主题 / 人群 / 痛点 / 卖点 / 关键词 → 一键生成	三个角度 + 正文成稿 + 标题 + 标签 + 首图文案
爆款选题	行业 + 勾选爆款元素 → 一键生成	每个元素 3 条能直接开拍的选题 + 拍摄成本建议
封面提示词	类型 / 主副文案 / 主体 / 气质 → 一键生成	一段能粘进即梦的生图提示词（小红书 3:4 / 抖音 9:16）
视频解析	点一下就出结果（可选：文件路径 / 链接 + 已知信息 + 抽帧密度）	进度条 → 关键帧缩略图 + 一句话结论 + 前 3 秒钩子 + 镜头时间线 + 五段结构 + 可复用模板 + 情绪/缺口/峰值 + 标签；结果自动存本地，可一键复制或「照这个结构仿写 →」
账号学习	阶段 / 目标 / 本地统计 / 补充说明 → 一键生成	账号画像 JSON + 高低互动差异诊断 + 三个可验证实验
创意建议	方向 / 形式 / 条数 → 一键生成	N 条选题，每条带前 3 秒逐字、结构、需要的素材、为什么符合你、判断标准
◉ 我的账号	贴小红书 / 抖音主页链接或 id → 「添加」	多账号「我的账号」卡片：头像、粉丝、获赞、作品数、粉丝走势 sparkline、涨粉/掉粉增量；★ 星标监控（可关）、主页跳转、移除；「同步全部」逐个刷新并留快照（每个账号最多 120 条，`bridge/data/accounts.json`）
☰ 找博主	关键词 + 平台 → 「搜索」	搜到的博主卡片（头像、粉丝、获赞、作品数、简介、认证标）；「抓取作品」拉主页画像 + 最近作品并入库（入库后可拆解 / 仿写），主页链接可直接打开
作品库	—	每次自动生成都存这里：按页签筛选、展开全文、复制、采用、删除，带 token 与耗时
▦ 学习库	不用填；想自己记就点「＋添加」	一张多维表格装下所有学过的东西：类型 chips（全部 / 拆解 / 仿写 / 视频解析 / 博主 / 账号学习 / 后台分析 / 原创 / 选题 / 手动，带条数）+ 平台 chips + 关键字搜索 + ★ 星标筛选；每行 = 类型、标题与要点、来源（平台 + 作者 + 数据）、标签、时间；点标题打开右侧抽屉看全文，可改标签、写备注、复制全文、跳原帖；勾选后批量删除；「去重」按「同类型 + 同标题」只留最完整的一条（删除与合并都记黑名单，重新同步不会复活）
草稿	—	存过的组合，一键载入
◎ 后台数据	在浏览器创作者后台点扩展的「同步后台到库」	把后台接口提炼成人能看的：平台 / 账号两排按钮（小红书、抖音分开，多账号各一张卡）、我的作品（封面 / 时长 / 播放 / 点赞 / 收藏 / 评论 / 发布日；抖音还会带「5s 完播 / 封面点击」，点进去看单条质量）、数据总览（后台「数据中心」那一排：播放 / 曝光 / 点赞 / 评论 / 分享 / 5 秒完播率 / 2 秒跳出率 / 封面点击率 / 平均播放）、粉丝画像（性别 / 年龄 / 设备 / 地域，条形图）、四张汇总卡、本地上传（Excel `.xlsx` / CSV / JSON，按账号分开存、自动去重）、AI 分析（DeepSeek + 知识库 + 编导方法论 + 采集库同类型对标）。账号可以改名字、删除（连它的上传数据一起）、新建空账号；没数据时给四步同步指引
⚙ 设置	—	看 key 有没有配好（豆包 / DeepSeek / TikHub，显示「已配置」与来源：系统环境变量 / 本机文件，留空不改）+ API 费用统计（总计 / 视频解析 / 文案生成 / TikHub 折算人民币，近 14 天按天表格）+ 单价（输入 / 输出 / 汇率，改了按新价重算）+ 数据目录 / 端口 / 桥版本

「拆解 / 仿写 / 原创 / 选题 / 封面」五个页签末尾都会自动附一段平台校准（同一个方法在两个平台要换的说法与指标）。

装采集（一次性，约 2 分钟）

① 采集桥（本机小服务，端口 53210）

已经设为开机自启（启动项 debao-watchdog.lnk，静默无黑窗，每 45 秒探一次 /health，挂了自动拉起）。验证：浏览器打开 http://127.0.0.1:53210/health 应返回 {"ok":true,"version":"2.6.0",...}。

手动启动 / 排错：

plugins\debao-media\bridge\start-bridge.bat

② 浏览器扩展

打开 chrome://extensions（Edge 用 edge://extensions）
右上角打开「开发者模式」
点「加载已解压的扩展程序」，选：plugins\debao-media\bridge\extension
已经在用旧的「德饱采集器」/「灵薯采集器」的话，先移除旧的，再加载这个（扩展名现在叫 采集到我的自媒体库）
2.3.0 起新增了 webRequest 权限和后台脚本（抓视频直链用），升级时必须先「移除」再「加载已解压」，或者点扩展卡片上的「重新加载」并确认新权限，否则扩展会停用
2.4.0 又加了几条直链补路（Vue 组件实例 / React Fiber / 内联 state 脚本）：改完直接点「重新加载」即可，不需要再移除（权限没变）
2.4.1 补上抖音的数据源（_ROUTER_DATA / _SSR_HYDRATED_DATA / __UNIVERSAL_DATA_FOR_REHYDRATION__ / 驼峰字段）：同样点「重新加载」
2.5.0 补上抖音后台的请求重放 + 数据中心 / 粉丝画像（creator-replay）：同样点一次「重新加载」；装完先把「数据中心 / 粉丝数据」点开一次，再点「同步后台到库」

③ 用

采集对标：打开笔记或视频页 → 先按一下播放（视频要等播放器把流拉起来）→ 右下角「采集到自媒体库」（绿灯 = 桥在跑，数字 = 库里的条数）→ 回插件「★ 采集库」→ 解析视频 / 拆解 / 仿写。
抖音：https://www.douyin.com/video/<id> 打开后先播 2 秒 → 点「采集到自媒体库」。抖音的数据在 window._ROUTER_DATA 的 loaderData['video_(id)/page'].videoInfoRes.item_list[0]（新版还有 _SSR_HYDRATED_DATA、__UNIVERSAL_DATA_FOR_REHYDRATION__，以及 URI 编码的 script#RENDER_DATA），字段映射成和小红书同一套：aweme_id → noteId、desc → 标题+正文、statistics.digg_count/collect_count → 赞/藏、video.play_addr → 直链、music.title → 配乐、text_extra[].hashtag_name → 话题。图文作品（images）会标成「图文」，不尝试下载视频。
抖音后台：https://creator.douyin.com 是 creator.*，按钮自动变成「同步后台到库」，把作品列表/数据接口的响应存成本地快照。
- 要拿「数据中心 / 粉丝画像」的数据，得先把那两页点开、等图出来：抖音的图表接口有些是 POST（带日期区间），页面不点开就不会请求，扩展也就无从记录。
- 扩展会重放请求：它记下你在这两页触发过的接口（method / url / body），点同步时原样再请求一遍（只重放读接口，发布 / 删除 / 登录这类一律跳过），所以哪怕你切换了日期区间，也能把当前区间拿回来。
- 作品字段来自 /web/api/creator/item/list 的 items[].metrics（view_count / like_count / favorite_count / comment_count / share_count / completion_rate_5s / bounce_rate_2s / cover_click_rate / avg_view_second），不再是小红书那套 statistics。
- 昵称/头像抖音后台没有可拦截的用户接口，扩展会从页面头部刮一次（[data-e2e="user-name"] 等）；刮不到就按 host 建账号，等下次同步拿到再自动合并，不会多出一个号。
远程视频流会按域名分 Referer（douyinvod/bytecdn 用 douyin.com，其余用 xiaohongshu.com），带错会被 CDN 判 403。
同步后台：打开创作者中心 → 右下角「同步后台到库」→ 插件「账号学习」里点「读本地统计」。
视频直链从哪来（按可靠性排序）：笔记数据本身（__INITIAL_STATE__ 的 noteDetailMap / 深搜笔记对象）→ 页面组件的实例数据（小红书是 Vue：__vnode → component.props/setupState/data；若页面是 React 则走 __reactFiber$ → memoizedProps，inject.js 的 vueVideo() / fiberVideo()）→ 后台 background.js 用 chrome.webRequest 旁观的真实媒体请求（MSE/blob 播 HLS 时的可靠来源）→ inject.js 拦 fetch/XHR 记下的 masterUrl → 页面内联 window.__INITIAL_STATE__ 脚本（不挂 window 的版本）→ 播放器请求过的 m3u8/mp4（Resource Timing）→ <video> 的 src / og:video。
每条采集都会记下「直链是从哪条路拿到的」（videoUrlFrom：state-stream / state-deep / vue / fiber / network / script / dom / webrequest），采集卡直链徽标悬停就能看到；页面 DevTools 控制台还有一行 [德饱] 直链诊断，拿不到时把这一行发我，就能定位是哪一层断了。
采到视频时扩展会顺手把视频存到你本机（bridge\data\media\<id>.mp4，走浏览器自己的登录态取流，所以不怕直链过期）：成功后提示「已入库并存在本机（xx MB）」，采集卡上出现本机徽标。这一步失败也不影响采集，只是解析时还得靠直链。
抓不到直链时按这个顺序排：① 页面先按播放（媒体请求是播放后才发的，扩展只能在请求发生后看到）② 扩展是否 2.4.0 且已「重新加载」（chrome://extensions 上如果显示「已停用 / 需要新权限」，点重新加载并允许）③ 桥是否在线（按钮要是绿灯）④ 浏览器控制台看 [德饱] 直链诊断 那一行，把「后台旁观 / 页面候选」两个数组里看到的东西发我。
采集卡的直链徽标就是这条判据：有直链或本机文件才点得动「解析视频」；都没有就回页面按播放再采一次。用 videoId 拼出来的那种 sns-video-bd.xhscdn.com/<纯数字> 是假直链（没签名，必然 404），扩展已经过滤掉了。

④ 视频解析（一键，不用复制指令）

在「视频解析」页点 开始解析（本机），或者在「★ 采集库」某条视频卡上直接点 解析视频，桥会在后台跑完整条流水线：ffprobe 读参数 → ffmpeg 抽帧（4/8/12 帧可选）→ 豆包 doubao-seed-2-1-lite-260915 看画面出 JSON → 结果落 bridge/data/analyses.json，帧图存 bridge/data/frames/<id>/。解析完会自动跳到「视频解析」页把结果摊开。

左边什么都不填也能跑：默认用采集队列里最新一条有视频直链的。
批量：采集库右上角「一键解析全部视频」把还没解析过的挨个跑（一次最多 6 条，带进度）。
耗时：8 帧约 60–90 秒（豆包视觉模型本身慢），期间有进度条，桥的窗口里能看到阶段日志。
豆包 key 的取法（任一可用，桥自己找）：ARK_API_KEY / DEBAO_ARK_KEY 环境变量 → bridge/ark.key 首行 → 注册表 HKCU\Environment\ARK_API_KEY。本机已配在用户环境变量里，所以直接从启动项拉起的桥也能用；验证：http://127.0.0.1:53210/api/analyze/key 返回 {"ok":true,"from":"user-env",...}。
ffmpeg 找法：DEBAO_FFMPEG_DIR → %USERPROFILE%\.dsh\tools\ffmpeg\bin → C:\ffmpeg\bin → PATH。远程流（尤其 HLS .m3u8）会带 -user_agent + Referer，否则 CDN 直接 403。

原理（出问题时的排查顺序）

小红书 / 抖音页面（__INITIAL_STATE__ / _ROUTER_DATA）
      ↓  inject.js（MAIN world，只读，不发请求）
      ↓  postMessage
   content.js（按钮 + POST）
      ↓  http://127.0.0.1:53210/api/capture
   server.mjs（queue.json / account.json / kb.json / analyses.json）
      ↓  GET /api/queue、/api/stats、/api/kb
   插件各页签

按钮显示「采集桥离线」→ 采集桥没跑，双击 start-bridge.bat。
点采集提示「没读到内容」→ 在详情页再点（列表页没有正文）；或站点改版，inject.js 里 pickNote() / findAweme() 的路径要跟着改。
「同步后台数据」拿不到 → 登录态过期，重新登录创作者中心再点；或该页面还没触发那些接口，先切一下「笔记管理 / 数据概览」。
端口被占用 → 说明已经在跑，直接用。

TikHub 云端拉取与「我的账号」

采集库工具条右侧「☁ 云端拉取」：三个模式（单条链接 / 博主主页 / 关键词搜索）× 两个平台，拉回来的数据直接入库，不用开浏览器。

key 来源顺序：DEBAO_TIKHUB_KEY / TIKHUB_API_KEY 环境变量 → tools/tikhub/.tikhub.key → bridge/data/tikhub.key。
查额度：GET http://127.0.0.1:53210/api/tikhub/status?usage=1（面板顶部状态行也显示账号 / 今日次数 / 已用金额）。
免费额度只覆盖部分抖音接口（例如 fetch_one_video）；小红书与各类搜索路由是付费专用，余额为 0 时会回 402（免费额度以及余额不足，此路由需要付费）。充值入口：https://user.tikhub.io/users/add_credit 。
抖音热榜走 douyin/billboard/fetch_hot_challenge_list（免费接口），小红书热榜没有公开接口，所以「当日榜单」只能由关键词搜索推导。

界面风格

2026-11 起按 Apple 设计语言重做了一版：SF Pro / PingFang 字体栈、胶囊按钮（980px 圆角）、12-14px 卡片圆角、8px 间距基数、Apple Blue #0a84ff 单一强调色、分组式左侧导航（工作台 / 创作 / 我的）、卡片 hover 轻微上浮。设计规范来自 awesome-design-md 的 references/apple.md。

整段交给模型看，短视频也一样（1.0.6 / 1.0.9）

短视频节奏快，抽 8 帧反而会漏掉剪辑点（1.0.9 起默认也整段看）。「拆解」页链接框下面有「怎么解析」两档：

档位	做法	适合
整段看（推荐，默认）	整段视频交给豆包；超过 45MB 先压小样	绝大多数情况
抽帧快跑	只抽帧（按片长给 8 / 16 / 24 / 32 帧）	想省 token、或只想快速看个大概

整段上限 45MB（环境变量 DEBAO_VIDEO_MAX_MB 可调）。超了会先用 ffmpeg 压一份小样（720p/15fps → 480p/12fps → 360p/10fps 逐档试），压到上限内再整段送模型；只有压不动才退回抽帧（1.0.8）。
结果面板会标出这次是「整段视频理解」还是「抽帧 N 帧」。
实测：150 秒 / 9.6MB 的片子，58 秒出结果，五段结构按真实秒数切（钩子 0-3 / 铺垫 3-30 / 展开 30-90 / 转折 90-120 / 收尾 120-150），约 0.014 元；4K 竖屏 11.8 秒 / 65MB 的片子压缩后整段看，55 秒出结果。

切走也不会断（1.0.6）

解析任务在本机桥里跑，不在页面上跑：

进度走 SSE（/api/analyze/stream?id=），切标签页、切到别的对话都不影响；
页面重新打开时用 /api/analyze/active 自动把正在跑的那条接回来；
SSE 万一断了会退回轮询，界面不会卡在「解析中」。

视频自动存本机（扩展 2.6.0）

以前采集时直接下载视频会报 Failed to fetch —— content script 跑在页面世界里，跨域拉 CDN 会被 CORS 拦。现在下载放到后台 service worker（有 host_permissions），取到字节再交给本机桥；页面直下作为兜底。装了新扩展后，点一次「采集到自媒体库」就会看到「已入库并存在本机（x.xxMB）」。

一键生成 · 作品库 · 用量

一键生成（除采集库外每个页签左上角）：POST /api/gen 把左栏那份简报原样交给豆包，右栏 EventSource 接 SSE 流式显示；写完 PATCH 不写、直接落库，右栏底部显示 模型 · 耗时 · token · 预估费用。参数：max_tokens 上限 4000、temperature 默认 0.7。
模型与速度：默认 doubao-seed-2-1-lite-260915 并关掉思考模式（thinking:{type:'disabled'}）——开思考时同一句话要 20-40 秒、烧 1500-2000 推理 token，关掉后 2 秒、几十 token。要开回来：set DEBAO_TEXT_THINK=1；换模型：set DEBAO_TEXT_MODEL=doubao-xxx（本机账号目前只开了这一个模型，别的名字会 404）。
作品库：每次生成都写进 bridge/data/generations.json（保留 300 条），字段 {id,at,kind,platform,title,text,usage,ms,model,adopted}。界面按页签筛选、展开全文、复制、采用（绿框）、删除；GET /api/generations?kind=&platform=、PATCH /api/generation、DELETE /api/generation?id=。
总览看板（左侧第一项）：六张统计卡 + 三块分布（高频标签 / 分类 / 高频作者）+ 豆包用量 + 素材表。走本地桥的三个接口（/api/queue、/api/analyses、/api/usage），不联网。
列表视图（采集库右上「列表」）：六列 —— 内容素材概要（封面 + 标题 + 平台/类型/本机/直链徽标）、内容评分（星级 + 分类）、爆款指标（S/A/B/C + 收藏率 + 评论率）、数据（赞 / 藏 / 评）、正文标签 + 已解析、操作区。收藏率 = 藏/赞×100，评论率 = 评/赞×100。
解析结果落库：每条解析写进 bridge/data/analyses.json，含 probe（时长 / 分辨率 / 帧率 / 有无音轨）、frames（帧图路径）、result（一句话结论 / 时间线 / 结构 / 模板 / 标签）、usage（豆包 token 用量）、meta（标题 / 作者 / 封面 / 原始链接 / 赞藏评，采完再删队列也读得懂）、model、ms。
用量与费用：GET /api/usage 汇总成调用次数 / 帧数 / 输入输出 token / 均值 / 按天 / 预估费用。单价默认输入 0.3、输出 0.6 元每百万 token，可覆盖：

set DEBAO_PRICE_IN=0.3
set DEBAO_PRICE_OUT=0.6

真实数字要跑过解析才有；看板与 http://127.0.0.1:53210/api/usage 一起更新。

方法论来源

生成器的判断不是"网上总结的爆款技巧"，而是一套可复用的内容判断框架，写进两处：

bridge/text.mjs 的 SYSTEM：三条命题（内容是用户任务的解法 / 自媒体是他媒体 / 视频是产品）、爆款四必要条件、三种内容路径（情感共鸣 · 稀缺视角 · 反差节奏）及其脚本骨架、选题公式与任务句模板、任务单与三种结构模板、行为链复盘、证据纪律（原文主张 / 外部验证 / 分析推论，数字必须带口径，不确定写「未核实」）。
各生成器的输出结构：拆解八段（用户任务 → 四必要条件逐条判「成立 / 偏弱 / 不成立」并给证据 → 路径归属 → 标题与预期管理 → 结构与节奏 → 读者心理 → 模板与系列承接 → 边界与风险）；选题带六维评分卡与系列承诺；原创带任务单与证据清单；账号学习走起号 Step0–8 与行为链；仿写多一段「机制复制检查」（复制机制，不复制表面）。

机读评分也跟着扩了：<metadata>{"potential","burden","arousal","hook_type","path":"悲|奇|反","necessities":{"clarity","reach","need","interact"}}</metadata>。

写进 prompt 的是方法论骨架（可复用的判断框架），不是任何课程原文——原文属版权内容，插件不带、仓库也不带。

知识从哪来（回答「你依据什么」）

判断框架（写在代码里）：上一节的 SYSTEM 与各生成器的输出结构，是所有回答的"语法"。
你自己的知识库（每次生成前实时检索）：内容不在安装包里，由你在「设置 → 知识库来源」指定——本机文件夹（推荐，按一级子文件夹分组、按 # 标题切段）/ 随插件自带 / IMA 云端 / 关闭。每次点「⚡ 一键生成」时按本次简报做检索（bridge/text.mjs 的 kbParts() → bridge/kbstore.mjs），取 top 3 段落拼进 system。命中结果会：
- 以「依据〈文件名〉 › 〈小节标题〉」这样的 chip 显示在结果上方（悬停看匹配片段与分数）；
- 随生成记录一起落进 generations.json 的 kb 字段，学习库里可追溯。
- 换来源：设置里改完点「保存并检测」，立刻生效，不用重启。
素材本身（采集库）：你采回来的笔记/视频是"待分析对象"，不是知识源。

仓库与 npm 包里只有检索器（bridge/kbstore.mjs），没有任何语料。你自己放的资料不会被上传、也不会被打包。

TikHub 云端拉取（不开浏览器也能进库）

实测（2026-11-04）：抖音单条视频走 /api/v1/douyin/app/v3/fetch_one_video 可以用免费额度拉通；小红书（xiaohongshu/app_v2、web_v3）与关键词搜索（douyin/search/*）是付费专用路由，余额为 0 时直接 402「不接受免费额度」，需要去 https://user.tikhub.io/users/add_credit 充值。

采集库工具条上的「☁ 云端拉取」：贴笔记链接 / 博主主页 / 关键词就能直接从云端拉数据入库（按次计费，约 ¥0.01/次）。

key 来源顺序：DEBAO_TIKHUB_KEY 环境变量 → tools/tikhub/.tikhub.key → bridge/data/tikhub.key。
查状态：GET /api/tikhub/status?usage=1（含余额与当日调用次数）。
⚠️ key 权限要够：小红书需要 /api/v1/xiaohongshu/app_v2/，抖音搜索需要 /api/v1/douyin/search/。缺权限时接口会返回明确中文提示，告诉你去 https://user.tikhub.io/dashboard/api 勾哪一项。
抖音单条视频走 /api/v1/douyin/app/v3/fetch_one_video；若视频被平台限地区/私密，会返回"filter_list reason:8"，此时只能用浏览器扩展抓（它跑在你自己的会话里）。

接口

GET /health、GET /api/queue?platform=、POST /api/capture（兼容旧 /api/batch-save）、DELETE /api/item?id=、PATCH /api/item、POST /api/clear、 GET /api/stats、GET|POST /api/kb、POST /api/kb/profile、GET /api/analyses、POST /api/analysis、GET|POST /api/account、 GET /api/analyze/key、POST /api/analyze（异步任务，返回 {ok,id}）、GET /api/analyze/status?id=（stage/pct/done/error/result）、GET /api/frames/<analysisId>/<fNN.jpg>、 GET /api/usage（token 与费用汇总）、POST /api/bulk-delete {ids}、POST /api/bulk-patch {ids,category,rating,remark,clear}、 POST /api/media/upload?id=&name=、GET /api/media?id=、 GET /api/gen/key、POST /api/gen {prompt,kind,platform,title}（返回 {ok,id}）、GET /api/gen/stream?id=（SSE：open/delta/done/error）、GET /api/gen/status?id=、 GET /api/generations?kind=&platform=、PATCH /api/generation {id,adopted,title,text}、DELETE /api/generation?id=。

队列上限 500 条，按「平台 + noteId/awemeId」去重覆盖；万 / 千 / w / k 会换算成数字。

配套脚本

node bridge/learn.mjs                 # 本地统计 → data/insights.json（账号学习页「读本地统计」也走这个口径）
node bridge/learn.mjs --platform douyin
node bridge/fetch-media.mjs --latest  # 下最新一条有直链的视频到 data/media/
node bridge/fetch-media.mjs --id p_douyin_xxx
node scripts/sync-locale.mjs          # 用 client.js 里的 STRINGS 重新生成 locale/*.json

没有直链时 fetch-media.mjs 会打印 yt-dlp 的替代命令（本机未装：pip install -U yt-dlp）。

设计原则

只给指令，不抢活：生成的是给模型看的简报，执行还是对话里那一步。
平台先于技巧：同一个钩子在小红书是「标题 + 首图」，在抖音是「前 3 秒口播」；页签输出会分口径。
学习要能落地：账号画像写成结构化 JSON 存本地，创意建议必须引用画像里的某一条，且给判断标准（点击率 / 收藏率 / 3 秒留存）。
反撞车：仿写页有相似度上限（默认 50%），并要求列出必须换掉的句子。

自检

node scripts/self-check.mjs

模拟 DSH 的 __ModuleLoader__：工厂结构、两个 slot、侧栏 id 与 main key 一致、8 个指令生成器（满表单 + 空表单）、两平台口径分流、10 个页签顺序、采集桥七个文件、manifest 是 MV3 且 inject.js 在 MAIN world、双平台域名与端口一致、server 的四类接口、inject 的双平台解析与后台拦截。

卸载

删掉 %USERPROFILE%\.dsh\profiles\desktop\node_modules\@local\debao-media（junction）
从 profile 的 package.json 里删掉 @local/debao-media 那一行和 bundles 里的同名项
删掉启动项 debao-watchdog.lnk，在 chrome://extensions 里移除「德饱采集器」
重启 DSH

说明

方法论来自对「灵薯智作（red-muse）」工作流的拆解，提示词按同一套思路重写，不是原文照搬。没有包含、也不需要它的 VIP / 授权逻辑——这个插件不碰任何付费校验。

德饱自媒体助手（@local/debao-media）

下载安装包：Releases（含最新 Beta 包）（debao-media-plugin-v1.0.9.tgz，382 KB，Windows · Beta · 免费）

小红书 + 抖音双平台的内容工作台，一条流水线：

采集 → 拆解 → 仿写 / 原创 → 选题 → 封面 → 视频解析 → 账号学习 → 创意建议

采集：浏览器里打开笔记/视频，点右下角按钮，标题、正文、标签、赞藏评、封面、视频直链自动进来。
后台同步：打开创作者中心（creator.xiaohongshu.com / creator.douyin.com），点「同步后台数据」，页面里那些接口返回的数据（笔记列表、粉丝数、播放）都会被存下来；换号再同步一次就是第二个账号，插件里按平台 + 账号分开看。
视频 / 音乐解析：视频条目点「视频解析 →」，把直链交给 ffmpeg 抽帧 + 豆包视觉模型，出镜头时间轴、结构、可复用模板。
账号学习：把采集来的内容算成统计（互动分位、标签表现、发布节律、爆款 vs 平款差异），再让助手据此出账号画像与创意建议。

安装（从 GitHub 装）

前提：已经装好 DeepSeek Harness 桌面版，并且能用命令行 dsh。

# 1) 拿代码
git clone https://github.com/<你的用户名>/debao-media.git
cd debao-media

# 2) 装进 DSH（profile 一般是 desktop 或 web）
& "$env:LOCALAPPDATA\Programs\deepseek\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add file:.

# 3) 起本机桥（双击也行）
bridge\start-bridge.bat        # 保持这个窗口，或把 bridge\watchdog.vbs 放进启动项

# 4) 装浏览器扩展
#    chrome://extensions → 打开「开发者模式」→「加载已解压的扩展程序」→ 选 bridge\extension

# 5) 填一个豆包 key（视频解析必需；文案默认用 DSH 里登录的 DeepSeek，不用填）
#    打开插件 → 设置 → 填 ARK Key → 保存

装完重启 DSH。详细图文步骤与常见问题见 安装说明.md。

知识库是可选的：仓库里不带课程语料（版权原因），bridge/kb/kb.js 是检索器。想用「依据」功能，把你的 markdown 放进 kb/distilled/、kb/videos/ 即可（格式：普通 .md，二级标题当章节）。不放也能跑，只是没有引用。

板块结构（两大板块 + 两个库）

侧栏按四组分，一眼能看出「我在学东西」还是「我在做东西」：

工作台：总览看板 / 采集库
拆解与学习：拆解 / 仿写 / 搜索 & 热榜 / 找博主 / 账号学习 / 学习库
- 拆解、仿写不用手填：左上角「从采集库选」挑一条，或直接在采集库卡片上点「拆解 →」「仿写 →」，素材自动带进来，点「⚡ 一键生成」出成品；视频素材多一个「解析视频」，本机抽帧 + 豆包看画面。
- 成品按 Markdown 渲染，表格是真表格（分镜表、对比表都能直接看）。
- 学习库：把拆解、仿写、视频解析、博主、账号学习、后台分析统一成一张多维表格（类型 / 标题要点 / 来源 / 数据 / 标签 / 时间 / 操作）。可按类型和平台筛、关键字搜（标题、作者、标签、备注都搜）、星标、行内打标签写备注、点开看全文、＋添加 自己记一条、勾选后批量删除、一键去重（同类型 + 同标题只留最完整的那条，删掉的不会再被同步回来）。
原创：原创（文案 / 脚本两种模式，脚本出分镜表）/ 选题 / 创意 / 灵感库
- 原创页「做哪一种」切换：文案原创 = 图文笔记正文；脚本原创 = 镜号/时长/画面/口播/字卡/声音/作用的分镜表 + 逐字稿 + 拍摄清单。
- 灵感库：一句话先记下（现象、反直觉的细节、想说没说出口的话），攒够了点「做选题」「做创意」直接带进对应页签。
我的：后台数据 / 我的账号 / 原创库 / 草稿 / 设置
- 后台数据：创作者后台同步来的数据按平台（小红书 / 抖音）分开，支持多账号；「上传文件」可以直接丢 CSV / JSON 作品表进来（同样的行重复上传会自动去重）；「AI 分析」把账号现状 + 采集库里同平台的同类标杆 + 上传的数据一起交给 DeepSeek，按编导方法论（爆款四必要条件 / 三条路径 / 行为链复盘）与 Dan Koe 的一人公司逻辑出诊断、选题与 21 天实验。
- 设置：三张 key 卡（豆包 / DeepSeek / TikHub，实时显示「已配置 · 来源」）、用量与费用（视频解析与文案生成分账、按天明细）、单价、以及知识库来源（关闭 / 本机文件夹 / 随插件自带 / IMA 云端，可分组、可搜索、可点开看原文）。
- 作品自动按来源分库：拆解、仿写、视频解析、博主、账号学习、后台分析都进「学习库」；原创、选题、创意进「原创库」。

文案用哪个模型（不用填 key）

插件 host 半（index.js）在 DSH 里注册了两条本机路由：

路由	说明
`GET /debao/gen/status`	探测环境内模型是否可用（返回 `{ok, llm, provider, model}`）
`POST /debao/gen`	SSE 流式生成，内部调 `ctx.llm.stream({ provider: 'deepseek-account', model: 'deepseek-flash' })`

实测：一条 39 字结论 1.2 秒返回，模型报 deepseek-flash。设置页会显示「文案模型：deepseek-flash（环境内直连，不用 key）」。

ctx.llm.stream 的 messages[].content 必须是分片数组（[{ type: 'text', text: '...' }]），传纯字符串会报 content.some is not a function。

桥挂了会自己回来

.vbs 必须纯 ASCII 且不带 BOM：wscript 按 ANSI 读脚本，UTF-8 中文注释会让它弹「无效字符」错误框后卡住。

给别人装（插件版分发）

有人在群里要现成包的话，直接给 GitHub Releases 里的 .tgz（每次发版都会附上）。

一条命令安装（profile 名看 %USERPROFILE%\.dsh\profiles，一般是 web 或 desktop）：

& <DSH安装目录>\resources\runtime\cli\bin\dsh.cmd plugin --profile desktop add file:<下载的 tgz 路径>

装完重启 DSH。注意 package.json 不能带 BOM，否则 DSH 校验会报 Unexpected token '' 并回滚（已踩过）。

本仓库不含课程语料（版权原因），知识库目录留空即可用；自己往里放 md 就会出现在「设置 → 知识库」里。

详细步骤与 FAQ 见 安装说明.md。

怎么打开

十七个页签（左侧竖排导航，按「工作台 / 拆解与学习 / 原创 / 我的」分组，鼠标滚轮可滚）

除采集库外，每个生成器页签左上角都有「⚡ 一键生成」：点一下就由本机桥直连豆包（doubao-seed-2-1-lite，默认关掉思考模式，一句话 2 秒、1500 字文案 10-30 秒）把成品写在右栏，流式输出；写完自动落库到「作品库」，可以「采用 / 存草稿 / 重写 / 复制」，关掉对话框也不会丢。原来的「复制指令」还在（复制指令 按钮），想丢给对话模型跑也行。

页签	你要填的	出来的东西
▲ 热榜	抖音挑战榜直接看；小红书切「关键词榜单」填关键词 + 时间窗（当日 / 3 天 / 7 天 / 30 天）+ 排序（点赞 / 收藏 / 时间）	抖音：官方挑战榜 50 条，带排名、热度、视频数、每分钟热度走势 sparkline，可「打开」或一键「找视频」把该话题当关键词跑榜单；小红书：没有公开热榜，用搜索结果按互动排序生成「当日榜」，可「拆解」或「入库」。10 分钟缓存，点刷新强制更新
★ 采集库	基本不用填：浏览器里点一下采集，回来点「刷新」	卡片墙（封面 / 时长 / 平台与类型徽标 / 直链 / 已解析 / 解析结论摘要）：解析视频、看解析、拆解、仿写、原帖、删除；支持卡片 / 列表两种视图（列表带「内容素材概要 / 内容评分 / 爆款指标 / 数据 / 正文标签 / 操作」六列）、平台与类型筛选、「只看有直链」、关键词搜索、勾选 + 批量编辑（分类 / 对标评分 / 备注）/ 批量删除、一键解析全部视频（最多 6 条，带进度）
拆解笔记	标题 + 正文 + 标签 + 三个数据 → 一键生成	五维拆解（选题痛点 / 标题公式 / 内容结构 / 语言风格 / 读者心理）+ 三步填空模板 + 机读评分
仿写	参考笔记 + 要换进去的信息 → 一键生成	结构对照表 + 正文成稿 + 标题 + 标签 + 撞车检查
原创	主题 / 人群 / 痛点 / 卖点 / 关键词 → 一键生成	三个角度 + 正文成稿 + 标题 + 标签 + 首图文案
爆款选题	行业 + 勾选爆款元素 → 一键生成	每个元素 3 条能直接开拍的选题 + 拍摄成本建议
封面提示词	类型 / 主副文案 / 主体 / 气质 → 一键生成	一段能粘进即梦的生图提示词（小红书 3:4 / 抖音 9:16）
视频解析	点一下就出结果（可选：文件路径 / 链接 + 已知信息 + 抽帧密度）	进度条 → 关键帧缩略图 + 一句话结论 + 前 3 秒钩子 + 镜头时间线 + 五段结构 + 可复用模板 + 情绪/缺口/峰值 + 标签；结果自动存本地，可一键复制或「照这个结构仿写 →」
账号学习	阶段 / 目标 / 本地统计 / 补充说明 → 一键生成	账号画像 JSON + 高低互动差异诊断 + 三个可验证实验
创意建议	方向 / 形式 / 条数 → 一键生成	N 条选题，每条带前 3 秒逐字、结构、需要的素材、为什么符合你、判断标准
◉ 我的账号	贴小红书 / 抖音主页链接或 id → 「添加」	多账号「我的账号」卡片：头像、粉丝、获赞、作品数、粉丝走势 sparkline、涨粉/掉粉增量；★ 星标监控（可关）、主页跳转、移除；「同步全部」逐个刷新并留快照（每个账号最多 120 条，`bridge/data/accounts.json`）
☰ 找博主	关键词 + 平台 → 「搜索」	搜到的博主卡片（头像、粉丝、获赞、作品数、简介、认证标）；「抓取作品」拉主页画像 + 最近作品并入库（入库后可拆解 / 仿写），主页链接可直接打开
作品库	—	每次自动生成都存这里：按页签筛选、展开全文、复制、采用、删除，带 token 与耗时
▦ 学习库	不用填；想自己记就点「＋添加」	一张多维表格装下所有学过的东西：类型 chips（全部 / 拆解 / 仿写 / 视频解析 / 博主 / 账号学习 / 后台分析 / 原创 / 选题 / 手动，带条数）+ 平台 chips + 关键字搜索 + ★ 星标筛选；每行 = 类型、标题与要点、来源（平台 + 作者 + 数据）、标签、时间；点标题打开右侧抽屉看全文，可改标签、写备注、复制全文、跳原帖；勾选后批量删除；「去重」按「同类型 + 同标题」只留最完整的一条（删除与合并都记黑名单，重新同步不会复活）
草稿	—	存过的组合，一键载入
◎ 后台数据	在浏览器创作者后台点扩展的「同步后台到库」	把后台接口提炼成人能看的：平台 / 账号两排按钮（小红书、抖音分开，多账号各一张卡）、我的作品（封面 / 时长 / 播放 / 点赞 / 收藏 / 评论 / 发布日；抖音还会带「5s 完播 / 封面点击」，点进去看单条质量）、数据总览（后台「数据中心」那一排：播放 / 曝光 / 点赞 / 评论 / 分享 / 5 秒完播率 / 2 秒跳出率 / 封面点击率 / 平均播放）、粉丝画像（性别 / 年龄 / 设备 / 地域，条形图）、四张汇总卡、本地上传（Excel `.xlsx` / CSV / JSON，按账号分开存、自动去重）、AI 分析（DeepSeek + 知识库 + 编导方法论 + 采集库同类型对标）。账号可以改名字、删除（连它的上传数据一起）、新建空账号；没数据时给四步同步指引
⚙ 设置	—	看 key 有没有配好（豆包 / DeepSeek / TikHub，显示「已配置」与来源：系统环境变量 / 本机文件，留空不改）+ API 费用统计（总计 / 视频解析 / 文案生成 / TikHub 折算人民币，近 14 天按天表格）+ 单价（输入 / 输出 / 汇率，改了按新价重算）+ 数据目录 / 端口 / 桥版本

「拆解 / 仿写 / 原创 / 选题 / 封面」五个页签末尾都会自动附一段平台校准（同一个方法在两个平台要换的说法与指标）。

装采集（一次性，约 2 分钟）

① 采集桥（本机小服务，端口 53210）

手动启动 / 排错：

plugins\debao-media\bridge\start-bridge.bat

② 浏览器扩展

打开 chrome://extensions（Edge 用 edge://extensions）
右上角打开「开发者模式」
点「加载已解压的扩展程序」，选：plugins\debao-media\bridge\extension
已经在用旧的「德饱采集器」/「灵薯采集器」的话，先移除旧的，再加载这个（扩展名现在叫 采集到我的自媒体库）
2.3.0 起新增了 webRequest 权限和后台脚本（抓视频直链用），升级时必须先「移除」再「加载已解压」，或者点扩展卡片上的「重新加载」并确认新权限，否则扩展会停用
2.4.0 又加了几条直链补路（Vue 组件实例 / React Fiber / 内联 state 脚本）：改完直接点「重新加载」即可，不需要再移除（权限没变）
2.4.1 补上抖音的数据源（_ROUTER_DATA / _SSR_HYDRATED_DATA / __UNIVERSAL_DATA_FOR_REHYDRATION__ / 驼峰字段）：同样点「重新加载」
2.5.0 补上抖音后台的请求重放 + 数据中心 / 粉丝画像（creator-replay）：同样点一次「重新加载」；装完先把「数据中心 / 粉丝数据」点开一次，再点「同步后台到库」

③ 用

采集对标：打开笔记或视频页 → 先按一下播放（视频要等播放器把流拉起来）→ 右下角「采集到自媒体库」（绿灯 = 桥在跑，数字 = 库里的条数）→ 回插件「★ 采集库」→ 解析视频 / 拆解 / 仿写。
抖音：https://www.douyin.com/video/<id> 打开后先播 2 秒 → 点「采集到自媒体库」。抖音的数据在 window._ROUTER_DATA 的 loaderData['video_(id)/page'].videoInfoRes.item_list[0]（新版还有 _SSR_HYDRATED_DATA、__UNIVERSAL_DATA_FOR_REHYDRATION__，以及 URI 编码的 script#RENDER_DATA），字段映射成和小红书同一套：aweme_id → noteId、desc → 标题+正文、statistics.digg_count/collect_count → 赞/藏、video.play_addr → 直链、music.title → 配乐、text_extra[].hashtag_name → 话题。图文作品（images）会标成「图文」，不尝试下载视频。
抖音后台：https://creator.douyin.com 是 creator.*，按钮自动变成「同步后台到库」，把作品列表/数据接口的响应存成本地快照。
- 要拿「数据中心 / 粉丝画像」的数据，得先把那两页点开、等图出来：抖音的图表接口有些是 POST（带日期区间），页面不点开就不会请求，扩展也就无从记录。
- 扩展会重放请求：它记下你在这两页触发过的接口（method / url / body），点同步时原样再请求一遍（只重放读接口，发布 / 删除 / 登录这类一律跳过），所以哪怕你切换了日期区间，也能把当前区间拿回来。
- 作品字段来自 /web/api/creator/item/list 的 items[].metrics（view_count / like_count / favorite_count / comment_count / share_count / completion_rate_5s / bounce_rate_2s / cover_click_rate / avg_view_second），不再是小红书那套 statistics。
- 昵称/头像抖音后台没有可拦截的用户接口，扩展会从页面头部刮一次（[data-e2e="user-name"] 等）；刮不到就按 host 建账号，等下次同步拿到再自动合并，不会多出一个号。
远程视频流会按域名分 Referer（douyinvod/bytecdn 用 douyin.com，其余用 xiaohongshu.com），带错会被 CDN 判 403。
同步后台：打开创作者中心 → 右下角「同步后台到库」→ 插件「账号学习」里点「读本地统计」。
视频直链从哪来（按可靠性排序）：笔记数据本身（__INITIAL_STATE__ 的 noteDetailMap / 深搜笔记对象）→ 页面组件的实例数据（小红书是 Vue：__vnode → component.props/setupState/data；若页面是 React 则走 __reactFiber$ → memoizedProps，inject.js 的 vueVideo() / fiberVideo()）→ 后台 background.js 用 chrome.webRequest 旁观的真实媒体请求（MSE/blob 播 HLS 时的可靠来源）→ inject.js 拦 fetch/XHR 记下的 masterUrl → 页面内联 window.__INITIAL_STATE__ 脚本（不挂 window 的版本）→ 播放器请求过的 m3u8/mp4（Resource Timing）→ <video> 的 src / og:video。
每条采集都会记下「直链是从哪条路拿到的」（videoUrlFrom：state-stream / state-deep / vue / fiber / network / script / dom / webrequest），采集卡直链徽标悬停就能看到；页面 DevTools 控制台还有一行 [德饱] 直链诊断，拿不到时把这一行发我，就能定位是哪一层断了。
采到视频时扩展会顺手把视频存到你本机（bridge\data\media\<id>.mp4，走浏览器自己的登录态取流，所以不怕直链过期）：成功后提示「已入库并存在本机（xx MB）」，采集卡上出现本机徽标。这一步失败也不影响采集，只是解析时还得靠直链。
抓不到直链时按这个顺序排：① 页面先按播放（媒体请求是播放后才发的，扩展只能在请求发生后看到）② 扩展是否 2.4.0 且已「重新加载」（chrome://extensions 上如果显示「已停用 / 需要新权限」，点重新加载并允许）③ 桥是否在线（按钮要是绿灯）④ 浏览器控制台看 [德饱] 直链诊断 那一行，把「后台旁观 / 页面候选」两个数组里看到的东西发我。
采集卡的直链徽标就是这条判据：有直链或本机文件才点得动「解析视频」；都没有就回页面按播放再采一次。用 videoId 拼出来的那种 sns-video-bd.xhscdn.com/<纯数字> 是假直链（没签名，必然 404），扩展已经过滤掉了。

④ 视频解析（一键，不用复制指令）

左边什么都不填也能跑：默认用采集队列里最新一条有视频直链的。
批量：采集库右上角「一键解析全部视频」把还没解析过的挨个跑（一次最多 6 条，带进度）。
耗时：8 帧约 60–90 秒（豆包视觉模型本身慢），期间有进度条，桥的窗口里能看到阶段日志。
豆包 key 的取法（任一可用，桥自己找）：ARK_API_KEY / DEBAO_ARK_KEY 环境变量 → bridge/ark.key 首行 → 注册表 HKCU\Environment\ARK_API_KEY。本机已配在用户环境变量里，所以直接从启动项拉起的桥也能用；验证：http://127.0.0.1:53210/api/analyze/key 返回 {"ok":true,"from":"user-env",...}。
ffmpeg 找法：DEBAO_FFMPEG_DIR → %USERPROFILE%\.dsh\tools\ffmpeg\bin → C:\ffmpeg\bin → PATH。远程流（尤其 HLS .m3u8）会带 -user_agent + Referer，否则 CDN 直接 403。

原理（出问题时的排查顺序）

小红书 / 抖音页面（__INITIAL_STATE__ / _ROUTER_DATA）
      ↓  inject.js（MAIN world，只读，不发请求）
      ↓  postMessage
   content.js（按钮 + POST）
      ↓  http://127.0.0.1:53210/api/capture
   server.mjs（queue.json / account.json / kb.json / analyses.json）
      ↓  GET /api/queue、/api/stats、/api/kb
   插件各页签

按钮显示「采集桥离线」→ 采集桥没跑，双击 start-bridge.bat。
点采集提示「没读到内容」→ 在详情页再点（列表页没有正文）；或站点改版，inject.js 里 pickNote() / findAweme() 的路径要跟着改。
「同步后台数据」拿不到 → 登录态过期，重新登录创作者中心再点；或该页面还没触发那些接口，先切一下「笔记管理 / 数据概览」。
端口被占用 → 说明已经在跑，直接用。

TikHub 云端拉取与「我的账号」

采集库工具条右侧「☁ 云端拉取」：三个模式（单条链接 / 博主主页 / 关键词搜索）× 两个平台，拉回来的数据直接入库，不用开浏览器。

key 来源顺序：DEBAO_TIKHUB_KEY / TIKHUB_API_KEY 环境变量 → tools/tikhub/.tikhub.key → bridge/data/tikhub.key。
查额度：GET http://127.0.0.1:53210/api/tikhub/status?usage=1（面板顶部状态行也显示账号 / 今日次数 / 已用金额）。
免费额度只覆盖部分抖音接口（例如 fetch_one_video）；小红书与各类搜索路由是付费专用，余额为 0 时会回 402（免费额度以及余额不足，此路由需要付费）。充值入口：https://user.tikhub.io/users/add_credit 。
抖音热榜走 douyin/billboard/fetch_hot_challenge_list（免费接口），小红书热榜没有公开接口，所以「当日榜单」只能由关键词搜索推导。

界面风格

整段交给模型看，短视频也一样（1.0.6 / 1.0.9）

短视频节奏快，抽 8 帧反而会漏掉剪辑点（1.0.9 起默认也整段看）。「拆解」页链接框下面有「怎么解析」两档：

档位	做法	适合
整段看（推荐，默认）	整段视频交给豆包；超过 45MB 先压小样	绝大多数情况
抽帧快跑	只抽帧（按片长给 8 / 16 / 24 / 32 帧）	想省 token、或只想快速看个大概

整段上限 45MB（环境变量 DEBAO_VIDEO_MAX_MB 可调）。超了会先用 ffmpeg 压一份小样（720p/15fps → 480p/12fps → 360p/10fps 逐档试），压到上限内再整段送模型；只有压不动才退回抽帧（1.0.8）。
结果面板会标出这次是「整段视频理解」还是「抽帧 N 帧」。
实测：150 秒 / 9.6MB 的片子，58 秒出结果，五段结构按真实秒数切（钩子 0-3 / 铺垫 3-30 / 展开 30-90 / 转折 90-120 / 收尾 120-150），约 0.014 元；4K 竖屏 11.8 秒 / 65MB 的片子压缩后整段看，55 秒出结果。

切走也不会断（1.0.6）

解析任务在本机桥里跑，不在页面上跑：

进度走 SSE（/api/analyze/stream?id=），切标签页、切到别的对话都不影响；
页面重新打开时用 /api/analyze/active 自动把正在跑的那条接回来；
SSE 万一断了会退回轮询，界面不会卡在「解析中」。

视频自动存本机（扩展 2.6.0）

一键生成 · 作品库 · 用量

一键生成（除采集库外每个页签左上角）：POST /api/gen 把左栏那份简报原样交给豆包，右栏 EventSource 接 SSE 流式显示；写完 PATCH 不写、直接落库，右栏底部显示 模型 · 耗时 · token · 预估费用。参数：max_tokens 上限 4000、temperature 默认 0.7。
模型与速度：默认 doubao-seed-2-1-lite-260915 并关掉思考模式（thinking:{type:'disabled'}）——开思考时同一句话要 20-40 秒、烧 1500-2000 推理 token，关掉后 2 秒、几十 token。要开回来：set DEBAO_TEXT_THINK=1；换模型：set DEBAO_TEXT_MODEL=doubao-xxx（本机账号目前只开了这一个模型，别的名字会 404）。
作品库：每次生成都写进 bridge/data/generations.json（保留 300 条），字段 {id,at,kind,platform,title,text,usage,ms,model,adopted}。界面按页签筛选、展开全文、复制、采用（绿框）、删除；GET /api/generations?kind=&platform=、PATCH /api/generation、DELETE /api/generation?id=。
总览看板（左侧第一项）：六张统计卡 + 三块分布（高频标签 / 分类 / 高频作者）+ 豆包用量 + 素材表。走本地桥的三个接口（/api/queue、/api/analyses、/api/usage），不联网。
列表视图（采集库右上「列表」）：六列 —— 内容素材概要（封面 + 标题 + 平台/类型/本机/直链徽标）、内容评分（星级 + 分类）、爆款指标（S/A/B/C + 收藏率 + 评论率）、数据（赞 / 藏 / 评）、正文标签 + 已解析、操作区。收藏率 = 藏/赞×100，评论率 = 评/赞×100。
解析结果落库：每条解析写进 bridge/data/analyses.json，含 probe（时长 / 分辨率 / 帧率 / 有无音轨）、frames（帧图路径）、result（一句话结论 / 时间线 / 结构 / 模板 / 标签）、usage（豆包 token 用量）、meta（标题 / 作者 / 封面 / 原始链接 / 赞藏评，采完再删队列也读得懂）、model、ms。
用量与费用：GET /api/usage 汇总成调用次数 / 帧数 / 输入输出 token / 均值 / 按天 / 预估费用。单价默认输入 0.3、输出 0.6 元每百万 token，可覆盖：

set DEBAO_PRICE_IN=0.3
set DEBAO_PRICE_OUT=0.6

真实数字要跑过解析才有；看板与 http://127.0.0.1:53210/api/usage 一起更新。

方法论来源

生成器的判断不是"网上总结的爆款技巧"，而是一套可复用的内容判断框架，写进两处：

bridge/text.mjs 的 SYSTEM：三条命题（内容是用户任务的解法 / 自媒体是他媒体 / 视频是产品）、爆款四必要条件、三种内容路径（情感共鸣 · 稀缺视角 · 反差节奏）及其脚本骨架、选题公式与任务句模板、任务单与三种结构模板、行为链复盘、证据纪律（原文主张 / 外部验证 / 分析推论，数字必须带口径，不确定写「未核实」）。
各生成器的输出结构：拆解八段（用户任务 → 四必要条件逐条判「成立 / 偏弱 / 不成立」并给证据 → 路径归属 → 标题与预期管理 → 结构与节奏 → 读者心理 → 模板与系列承接 → 边界与风险）；选题带六维评分卡与系列承诺；原创带任务单与证据清单；账号学习走起号 Step0–8 与行为链；仿写多一段「机制复制检查」（复制机制，不复制表面）。

机读评分也跟着扩了：<metadata>{"potential","burden","arousal","hook_type","path":"悲|奇|反","necessities":{"clarity","reach","need","interact"}}</metadata>。

写进 prompt 的是方法论骨架（可复用的判断框架），不是任何课程原文——原文属版权内容，插件不带、仓库也不带。

知识从哪来（回答「你依据什么」）

判断框架（写在代码里）：上一节的 SYSTEM 与各生成器的输出结构，是所有回答的"语法"。
你自己的知识库（每次生成前实时检索）：内容不在安装包里，由你在「设置 → 知识库来源」指定——本机文件夹（推荐，按一级子文件夹分组、按 # 标题切段）/ 随插件自带 / IMA 云端 / 关闭。每次点「⚡ 一键生成」时按本次简报做检索（bridge/text.mjs 的 kbParts() → bridge/kbstore.mjs），取 top 3 段落拼进 system。命中结果会：
- 以「依据〈文件名〉 › 〈小节标题〉」这样的 chip 显示在结果上方（悬停看匹配片段与分数）；
- 随生成记录一起落进 generations.json 的 kb 字段，学习库里可追溯。
- 换来源：设置里改完点「保存并检测」，立刻生效，不用重启。
素材本身（采集库）：你采回来的笔记/视频是"待分析对象"，不是知识源。

仓库与 npm 包里只有检索器（bridge/kbstore.mjs），没有任何语料。你自己放的资料不会被上传、也不会被打包。

TikHub 云端拉取（不开浏览器也能进库）

实测（2026-11-04）：抖音单条视频走 /api/v1/douyin/app/v3/fetch_one_video 可以用免费额度拉通；小红书（xiaohongshu/app_v2、web_v3）与关键词搜索（douyin/search/*）是付费专用路由，余额为 0 时直接 402「不接受免费额度」，需要去 https://user.tikhub.io/users/add_credit 充值。

采集库工具条上的「☁ 云端拉取」：贴笔记链接 / 博主主页 / 关键词就能直接从云端拉数据入库（按次计费，约 ¥0.01/次）。

key 来源顺序：DEBAO_TIKHUB_KEY 环境变量 → tools/tikhub/.tikhub.key → bridge/data/tikhub.key。
查状态：GET /api/tikhub/status?usage=1（含余额与当日调用次数）。
⚠️ key 权限要够：小红书需要 /api/v1/xiaohongshu/app_v2/，抖音搜索需要 /api/v1/douyin/search/。缺权限时接口会返回明确中文提示，告诉你去 https://user.tikhub.io/dashboard/api 勾哪一项。
抖音单条视频走 /api/v1/douyin/app/v3/fetch_one_video；若视频被平台限地区/私密，会返回"filter_list reason:8"，此时只能用浏览器扩展抓（它跑在你自己的会话里）。

接口

队列上限 500 条，按「平台 + noteId/awemeId」去重覆盖；万 / 千 / w / k 会换算成数字。

配套脚本

node bridge/learn.mjs                 # 本地统计 → data/insights.json（账号学习页「读本地统计」也走这个口径）
node bridge/learn.mjs --platform douyin
node bridge/fetch-media.mjs --latest  # 下最新一条有直链的视频到 data/media/
node bridge/fetch-media.mjs --id p_douyin_xxx
node scripts/sync-locale.mjs          # 用 client.js 里的 STRINGS 重新生成 locale/*.json

没有直链时 fetch-media.mjs 会打印 yt-dlp 的替代命令（本机未装：pip install -U yt-dlp）。

设计原则

只给指令，不抢活：生成的是给模型看的简报，执行还是对话里那一步。
平台先于技巧：同一个钩子在小红书是「标题 + 首图」，在抖音是「前 3 秒口播」；页签输出会分口径。
学习要能落地：账号画像写成结构化 JSON 存本地，创意建议必须引用画像里的某一条，且给判断标准（点击率 / 收藏率 / 3 秒留存）。
反撞车：仿写页有相似度上限（默认 50%），并要求列出必须换掉的句子。

自检

node scripts/self-check.mjs

卸载

删掉 %USERPROFILE%\.dsh\profiles\desktop\node_modules\@local\debao-media（junction）
从 profile 的 package.json 里删掉 @local/debao-media 那一行和 bundles 里的同名项
删掉启动项 debao-watchdog.lnk，在 chrome://extensions 里移除「德饱采集器」
重启 DSH

X1aoDe/debao-media

德饱自媒体助手（@local/debao-media）

安装（从 GitHub 装）

板块结构（两大板块 + 两个库）

文案用哪个模型（不用填 key）

桥挂了会自己回来

给别人装（插件版分发）

怎么打开

十七个页签（左侧竖排导航，按「工作台 / 拆解与学习 / 原创 / 我的」分组，鼠标滚轮可滚）

装采集（一次性，约 2 分钟）

原理（出问题时的排查顺序）

TikHub 云端拉取与「我的账号」

界面风格

整段交给模型看，短视频也一样（1.0.6 / 1.0.9）

切走也不会断（1.0.6）

视频自动存本机（扩展 2.6.0）

一键生成 · 作品库 · 用量

方法论来源

知识从哪来（回答「你依据什么」）

TikHub 云端拉取（不开浏览器也能进库）

接口

配套脚本

设计原则

自检

卸载

说明

Community comments

X1aoDe/debao-media

德饱自媒体助手（@local/debao-media）

安装（从 GitHub 装）

板块结构（两大板块 + 两个库）

文案用哪个模型（不用填 key）

桥挂了会自己回来

给别人装（插件版分发）

怎么打开

十七个页签（左侧竖排导航，按「工作台 / 拆解与学习 / 原创 / 我的」分组，鼠标滚轮可滚）

装采集（一次性，约 2 分钟）

原理（出问题时的排查顺序）

TikHub 云端拉取与「我的账号」

界面风格

整段交给模型看，短视频也一样（1.0.6 / 1.0.9）

切走也不会断（1.0.6）

视频自动存本机（扩展 2.6.0）

一键生成 · 作品库 · 用量

方法论来源

知识从哪来（回答「你依据什么」）

TikHub 云端拉取（不开浏览器也能进库）

接口

配套脚本

设计原则

自检

卸载

说明

Community comments