DSH 抖音助手
1.4.6 使用说明。插件与独立软件共用人格、兴趣、观看用量和许可名单；独立软件另外提供任务对话。本文的固定安装入口对应 1.4.6，包是否已可下载以 GitHub 和 npm 页面为准。
在本机专用 Microsoft Edge 中浏览抖音电脑版，采样真实画面交给模型，按人格和实际观看行为更新兴趣。这是第三方适配，不是 DeepSeek 官方发行版。
功能
| 功能 | 用法与范围 |
|---|---|
| 自主观看 | 开启“允许自动观看”后，在允许时段和每日额度内挑片、停留、换片或停止；保留手动启动／暂停按钮 |
| 每日额度 | “高级选项”内设置每日观看分钟数和每日模型请求数，均可选不限 |
| 人格与兴趣 | 两版共用人格卡；兴趣依据实际播放进度、观看比例和已确认互动，看到主题不等于喜欢 |
| 好友互动 | 一个总开关管理许可会话的新消息回复及观看中的自主分享，默认开启；须由本人选择许可好友或群聊 |
| 群聊回复 | 仅回复已许可群聊中被 @ 或叫到设定昵称的消息 |
| 自主分享 | 通过官方面板发送当前实际观察作品的卡片，按平台稳定身份绑定收件人，同作品同会话去重 |
| 公开评论 | 独立开关，默认关闭；保留每日及每次观看的尝试上限，同作品不重复评论 |
| 静默观看 | 持续静音，核实窗口归属后尝试最小化；仍使用有窗口 Edge |
| 自检与用量 | 一键诊断、限定修复建议、实际请求与已报告 token 用量、进行中状态 |
| 观看日报 | 从本机观看记录生成 Markdown，不额外调用模型 |
| 可选音频 | 本地 Whisper 转写对白，视频音频还可选择 MiMo 或 MiniMax 云端后端 |
好友互动不设人数、回复请求数或分享次数的业务上限，模型调用仍会消耗额度。默认开启总开关不会自行添加许可会话。旧自动续火花／自动问候入口已移除。
聊天按当前消息的正文、附件和引用分别处理，图文混合不再漏掉附件；引用预览供理解上下文，里面的旧 @ 不触发群回复。原生表情和图片读取实际画面，带动图标记或 GIF 地址的表情尝试两帧采样；语音沿用本地转写，作品卡片或唯一公开作品链接沿用视频采样与原视频预算。普通许可聊天全天运行。
文件、位置、名片、直播、音乐、通话、礼物、链接和直接视频附件先识别类型及可见卡片信息，再自然回应。当前没有文件正文、网页正文、直播或这些附件的音轨读取能力，不会把识别出卡片说成已读完内容；未知附件会说明读不到的部分。撤回和系统通知不自动回复。同批附件较多时保留四张画面预算，其余明确标记未观察，不因此暂停整段聊天。回复沿用共同人格与允许共享的记忆，接梗、回应情绪。
配置了 QQ 共享记忆且有已确认、明确设为公开的本地表情时，大肥鱼可从这些素材中选择一张作为回复；未公开、候选、私人照片和远程地址不会自动跨平台转发。对方要求不发图时只回文字。图片在原许可会话的原生上传预览中核对后发送，确认成功不再补发文字；确定没有开始发送才回退文字，发送不明不重发。网页结构改变或没有可用素材时继续文字聊天。当前网页未开放稳定的原生语音发送入口，不把语音合成成功或上传音频文件当作已发送语音气泡。
两种用法
| 插件版 | 软件版 | |
|---|---|---|
| 入口 | DSH“设置 → 刷抖音”分类设置页 | Windows 独立软件的分类设置和任务对话 |
| 主模型 | DSH 已配置的提供商与支持图片的模型 | 自己填写的 API Key、接口地址和模型 |
| 运行依赖 | 兼容的 DSH 宿主 | 无需安装或启动 DSH、QQ 服务或 Node.js |
| 文档 | 插件说明 | 软件说明、本机 API 说明 |
同一时刻只运行一条自主观看。两版共享每日账本，暂停、重启或改设置不会清空当天用量。
安装 1.4.6
DSH Desktop：打开“应用 → 桌面插件”，填写 dsh-douyin-browser-local@1.4.6 安装或更新。Desktop profile 由 Electron 管理，不要用普通 CLI 另改一份。更新后完全退出并重新打开同一份 DSH。
Web profile 在终端执行：
dsh plugin --profile web add dsh-douyin-browser-local@1.4.6
插件需要 Windows、Microsoft Edge 和兼容 DSH。已检查 0.2.0-rc.2、0.2.1-rc.2 两代 SDK；完整允许版本以 package.json 的 engines.dsh 为准，不笼统保证任意 0.2.x 预发布宿主。设置通信适配常用 WebServer、Connection 与宿主 RPC 入口，第三方宿主仍以实际自检和加载结果为准。npm、GitHub Release 和插件市场分别同步；市场未更新时可核对固定 npm 版本。
独立软件及校验文件见 1.4.6 下载页，文件名为 Dafeiyu-Douyin-API-1.4.6-win-x64.exe。正常退出旧版后打开新版，保留共享记忆、登录目录和本机设置。便携包未签名，要求及更新说明见 desktop/README.md。
从源码安装插件需要 Node.js 22.13+、pnpm 和已核对路径的 DSH：
git clone https://github.com/LockyBee/dsh-douyin-agent.git
cd dsh-douyin-agent
pnpm install --frozen-lockfile
$dshInstallDirectory = 'C:\Apps\DSH Desktop' # 替换为实际安装目录
.\install-native.ps1 -DshRoot $dshInstallDirectory
不带 -Install 只检查。确认无误、完全退出 DSH 后再执行：
.\install-native.ps1 -DshRoot $dshInstallDirectory -Install
第一次使用
- 配置支持图片的主模型。插件从 DSH 目录选择；独立软件在模型设置的密码框填写自己的 Key。
- 点击“打开抖音”，在专用 Edge 中手动登录或完成验证码。
- 在“视频观看”选择时段，按需展开“高级选项”设置每日分钟数和请求数，再开启“允许自动观看”。无需先开始新轮次，应用需保持运行。
- 在“好友互动”读取当前会话，核对稳定身份并勾选许可好友或群聊，按需填写群聊响应昵称。总开关开启且模型、名单就绪后自动准备回复；观看中可自主分享。
普通设置自动保存，文本输入离开输入框后提交，开关和下拉选择修改后提交，以页面回读为准；失败会保留草稿。密钥保留独立保存入口：桌面主模型 Key 走桌面 IPC；音频 Key 在“音频与密钥”密码框填写，离开后通过专用接口保存，不回显，也不会因此开启音频。
状态与验证边界
顶部状态栏区分在线、观看中、准备中和需要处理。后台自动整理有完整证据且确认未发送的待答消息；身份不符或发送结果不明时保留记录并核对。不能只凭总开关开启认定服务已就绪。好友回复与观看分开运行，观看时仍检查许可会话的新消息，实际速度受页面读取和模型耗时影响。
遇到问题先运行“自检与用量 → 一键自检”，按报告处理限定修复项。登录、验证码、无效 Key、损坏记录和宿主适配不能靠删除锁、记忆或登录目录解决。发送结果不确定时保留收据并尝试回读核对；无法确认时不自动重发。
本机已核对许可个人私信的一次真实补答和平台确认、稳定身份与视频播放推进；本次修复另有隔离回归和打包检查。推荐流仍可能换片失败，当前正式包的连续两小时播放及始终低于 2 GB 尚未验收；DSH rc.3 正文显示反馈未定位，真实公开评论发布确认和长视频多批观察仍待验。历史结果保留各自版本，详见本次验证范围。
开发与来源
pnpm test
pnpm run test:native
测试使用临时目录、合成模型或临时浏览器，不应把测试通过写成真实平台联调通过。运行状态、Key、登录资料、私信及联系人记录不进入仓库。
浏览器控制复用 Playwright；来源见 功能复用与来源、软件来源。原创代码采用 MIT，第三方通知见 THIRD_PARTY_NOTICES.md。模型使用说明见 skill/SKILL.md，历史详细资料见 docs/details.md。
视频分镜与图片成本
观看决策、分享视频回复及视频观察工具会把同一作品的多张JPEG采样优先拼成一张带格编号的图片，默认总像素预算480000。每格时间写在模型可读的清单中，仍沿用原作品、播放与许可校验；它不扩大已观看的时间，也不增加音轨理解。普通照片、单帧或无法可靠解码的帧保留原路径。
独立软件对话和DSH普通视频工具可使用 douyin_video_zoom，传前次观察返回的 storyboardSampleId、cell 与同一 videoId，读取指定格的原图。仅限本入口最近一分钟采样；换片、登录或验证遮挡、过期时拒绝。原帧缓存有容量上限，退出或到期清理。自动好友回复目前默认使用分镜，不自动增加第二轮精读请求。
布局、编号和RGB拼图复用 SAOS-3624/dsh-video-storyboard 的MIT源码，JPEG编解码使用带完整许可的纯JS实现，无需新增ffmpeg或外部ASR服务。只合成已经取得的真实采样；上游完整下载、全片扫描、字幕和ASR服务生命周期未接入后台。计费因模型不同，图片数量和像素减少不等于固定token数；用量看板仍只记录提供器实际回报。
共用专用浏览器页面
插件版与软件版共用一个视频页、一个消息页，分别处理观看和全天许可聊天。“打开抖音”显示已有视频页；准备页会在无草稿、登录或验证阻挡时转为视频页。两个入口共用操作锁，许可和每日预算保持原规则。用户自行打开的页面、未发送草稿及验证页面不会为凑标签数量被强行关闭。
群里分享的视频
已许可群中新收到的视频卡片会单独进入观看队列，不要求再 @ 大肥鱼。播放和画面理解遵守原观看时段、每日时长和模型请求预算；时段外或额度用完时等待。普通群文字仍只在被 @ 或叫到响应昵称时回复，单独看视频不会自动往群里发消息。
队列核对原会话、分享消息、成员和实际播放推进，使用分镜输入理解采样画面。会话内笔记供后续提问使用，不写成其他会话可读的共享记忆；不保存原始图片。撤回、撤权或身份变化时停止采用对应记录，重启不批量补看旧历史。分时采样不等于看完整条，也不包含音轨。
多对象分享与观看恢复
大肥鱼可以根据实际视频内容选择多位已许可对象，按顺序逐个分享；同作品、同对象仍永久去重。页面顶部会显示当前分享进度。列表下方或虚拟化列表中的对象按稳定身份有界查找，不用同名或头像猜测收件人。
确认尚未授权点击、也未发送的面板或定位故障，只跳过该对象。每位对象之间释放共同发送锁并短暂让出执行机会，供普通消息回复使用。点击后结果不明时暂停后续分享、保留收据且不重发，观看可以继续；取消、视频预算与未知发送故障仍保留原门禁。
无效或截断的观看决策不执行动作，重新观察后再判断；连续三次无效会停止本次观看，每次模型调用都计入原每日预算。