DSH 抖音助手（macOS / Chrome 版）

0.1.12 说明。本项目基于上游 dsh-douyin-agent 1.4.6 源码，移植为 macOS 上只运行 Google Chrome 的 DSH 插件形态；不包含 Windows 独立软件。人格、兴趣、观看用量、许可名单和日报沿用原实现。

在本机专用 Google Chrome 中浏览抖音电脑版，采样真实画面交给模型，按人格和实际观看行为更新兴趣。这是第三方适配，不是 DeepSeek 官方发行版。

功能

功能	用法与范围
自主观看	开启“允许自动观看”后，在允许时段和每日额度内挑片、停留、换片或停止；保留手动启动／暂停按钮
每日额度	“高级选项”内设置每日观看分钟数和每日模型请求数，均可选不限
人格与兴趣	插件共用人格卡；兴趣依据实际播放进度、观看比例和已确认互动，看到主题不等于喜欢
好友互动	一个总开关管理许可会话的新消息回复及观看中的自主分享，默认开启；须由本人选择许可好友或群聊
群聊回复	仅回复已许可群聊中被 @ 或叫到设定昵称的消息
自主分享	通过官方面板发送当前实际观察作品的卡片，按平台稳定身份绑定收件人，同作品同会话去重
公开评论	独立开关，默认关闭；保留每日及每次观看的尝试上限，同作品不重复评论
静默观看	持续静音，核实窗口归属后尝试最小化；仍使用有窗口 Chrome
自检与用量	一键诊断、限定修复建议、实际请求与已报告 token 用量、进行中状态
抖音账号	设置页显示专用 Chrome 登录状态，可检查登录、打开登录页扫码；登录态保存在专用资料目录
观看日报	从本机观看记录生成 Markdown，不额外调用模型
可选音频	本地 Whisper 转写对白，视频音频还可选择 MiMo 或 MiniMax 云端后端

好友互动不设人数、回复请求数或分享次数的业务上限，模型调用仍会消耗额度。默认开启总开关不会自行添加许可会话。旧自动续火花／自动问候入口已移除。

聊天按当前消息的正文、附件和引用分别处理，图文混合不再漏掉附件；引用预览供理解上下文，里面的旧 @ 不触发群回复。原生表情和图片读取实际画面，带动图标记或 GIF 地址的表情尝试两帧采样；语音沿用本地转写，作品卡片或唯一公开作品链接沿用视频采样与原视频预算。普通许可聊天全天运行。

文件、位置、名片、直播、音乐、通话、礼物、链接和直接视频附件先识别类型及可见卡片信息，再自然回应。当前没有文件正文、网页正文、直播或这些附件的音轨读取能力，不会把识别出卡片说成已读完内容；未知附件会说明读不到的部分。撤回和系统通知不自动回复。同批附件较多时保留四张画面预算，其余明确标记未观察，不因此暂停整段聊天。回复沿用共同人格与允许共享的记忆，接梗、回应情绪。

配置了 QQ 共享记忆且有已确认、明确设为公开的本地表情时，大肥鱼可从这些素材中选择一张作为回复；未公开、候选、私人照片和远程地址不会自动跨平台转发。对方要求不发图时只回文字。图片在原许可会话的原生上传预览中核对后发送，确认成功不再补发文字；确定没有开始发送才回退文字，发送不明不重发。网页结构改变或没有可用素材时继续文字聊天。当前网页未开放稳定的原生语音发送入口，不把语音合成成功或上传音频文件当作已发送语音气泡。

形态

只提供 DSH 插件：设置入口是“设置 → 刷抖音”，主模型使用 DSH 已配置的提供商和支持图片的模型，状态与记忆保存在 ~/.dsh/douyin-browser/，专用 Chrome 资料目录在 ~/.dsh/douyin-browser/cli-profile。不再包含 Windows 独立软件、Electron 打包或 QQ 合并启动器。

同一时刻只运行一条自主观看；暂停、重启或改设置不会清空当天用量。

安装

需要 macOS、Google Chrome、Node.js 22.13+ 和兼容的 DSH（engines.dsh 以 package.json 为准）。从 npm 安装到 web profile：

dsh plugin --profile web add dsh-douyin-mac@0.1.12

本地开发也可以从源码目录安装（npm install 后 dsh plugin --profile web add .），两种方式不要同时用。

插件通过 Playwright 启动独立资料目录的 Chrome 并连接本机 CDP；Chrome 136 起默认资料目录不允许开远程调试，专用目录已规避该限制。DSH 配置变化后重启同一份 DSH 即生效。

第一次使用

1. 在“刷抖音 → 基础设置 → DSH 模型”选择支持图片的提供商与模型。
2. 点击“打开抖音”，在专用 Chrome 中手动登录或完成验证码；登录态保存在专用资料目录，重启后仍在。
3. 在“视频观看”选择时段，按需展开“高级选项”设置每日分钟数和请求数，再开启“允许自动观看”。
4. 在“好友互动”读取当前会话，核对稳定身份并勾选许可好友或群聊，按需填写群聊响应昵称。

普通设置自动保存，文本输入离开输入框后提交；失败会保留草稿。音频 Key 在“音频与密钥”密码框填写，保存后不回显。

状态与验证边界

顶部状态栏区分在线、观看中、准备中和需要处理。后台自动整理有完整证据且确认未发送的待答消息；身份不符或发送结果不明时保留记录并核对。不能只凭总开关开启认定服务已就绪。好友回复与观看分开运行，观看时仍检查许可会话的新消息，实际速度受页面读取和模型耗时影响。

遇到问题先运行“自检与用量 → 一键自检”，按报告处理限定修复项。登录、验证码、无效 Key、损坏记录和宿主适配不能靠删除锁、记忆或登录目录解决。发送结果不确定时保留收据并尝试回读核对；无法确认时不自动重发。

macOS 移植的实机结果、测试统计和已知失败分类见macOS 验证记录。推荐流仍可能换片失败；真实公开评论发布确认、连续两小时播放、真实群聊与多收件人分享仍待验。本机未安装 ffmpeg / 本地 Whisper，可选音频用例未通过，音频功能保持默认关闭。历史 Windows 的结果保留在原版本记录中，不自动适用于本移植。

开发与来源

npm test
npm 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数；用量看板仍只记录提供器实际回报。

共用专用浏览器页面

插件共用同一个视频页、一个消息页，分别处理观看和全天许可聊天。“打开抖音”显示已有视频页；准备页会在无草稿、登录或验证阻挡时转为视频页。两个入口共用操作锁，许可和每日预算保持原规则。用户自行打开的页面、未发送草稿及验证页面不会为凑标签数量被强行关闭。

群里分享的视频

已许可群中新收到的视频卡片会单独进入观看队列，不要求再 @ 大肥鱼。播放和画面理解遵守原观看时段、每日时长和模型请求预算；时段外或额度用完时等待。普通群文字仍只在被 @ 或叫到响应昵称时回复，单独看视频不会自动往群里发消息。

队列核对原会话、分享消息、成员和实际播放推进，使用分镜输入理解采样画面。会话内笔记供后续提问使用，不写成其他会话可读的共享记忆；不保存原始图片。撤回、撤权或身份变化时停止采用对应记录，重启不批量补看旧历史。分时采样不等于看完整条，也不包含音轨。

多对象分享与观看恢复

大肥鱼可以根据实际视频内容选择多位已许可对象，按顺序逐个分享；同作品、同对象仍永久去重。页面顶部会显示当前分享进度。列表下方或虚拟化列表中的对象按稳定身份有界查找，不用同名或头像猜测收件人。

确认尚未授权点击、也未发送的面板或定位故障，只跳过该对象。每位对象之间释放共同发送锁并短暂让出执行机会，供普通消息回复使用。点击后结果不明时暂停后续分享、保留收据且不重发，观看可以继续；取消、视频预算与未知发送故障仍保留原门禁。

无效或截断的观看决策不执行动作，重新观察后再判断；连续三次无效会停止本次观看，每次模型调用都计入原每日预算。