dsh-douyin-mac 0.0.0-stage → 0.1.9

package/CHANGELOG.md

@@ -0,0 +1,142 @@
+# 更新记录
+
+## 0.1.9（2026-11-04）
+
+- 新增远程短信验证：身份验证时自动打开“接收短信验证码”并请求短信，经微信推送验证界面；用户把 6 位码发回微信后由 `douyin_submit_sms` 填入提交。
+- 新增工具 `douyin_request_sms` / `douyin_submit_sms`；设置页“抖音账号”增加发送短信验证码、输入并提交验证码。
+- 身份验证界面截取改用真实鼠标点击与验证码输入框定位，修正手机号掩码识别。
+
+## 0.1.8（2026-11-04）
+
+- 识别抖音“身份验证”中间状态（短信/登录密码/发送短信验证）：账号状态提示改为“抖音要求身份验证，扫码无法绕过”，不再误报为未登录等扫码。
+- 获取二维码时遇到身份验证界面，截取验证面板并注明 `kind: verification`；微信推送文案同步说明需要短信或密码验证。
+
+## 0.1.7（2026-11-04）
+
+- “刷新插件状态”现在会同时刷新抖音账号登录状态，并显示“已刷新插件状态”反馈。
+- 设置页打开期间自动轮询账号状态：已登录 30 秒一次，未登录 8 秒一次，扫码后无需手动刷新即可看到已登录。
+
+## 0.1.6（2026-11-04）
+
+- “退出登录”默认同时关闭专用 Chrome（CDP Browser.close），返回浏览器是否关闭；不删除资料目录，下次打开会重新启动。
+- 工具栏新增“关闭浏览器”，只关窗口/进程，不清登录 Cookie；确认改为页内二次点击（不再依赖浏览器原生 confirm），并补上客户端路由白名单。
+
+## 0.1.5（2026-11-04）
+
+- 插件设置页可直接显示登录二维码：点“获取登录二维码”在“抖音账号”区块内显示 512×512 二维码图片，扫码后点“检查登录状态”即可，无需切到 Chrome 窗口。
+- 二维码过期后重新获取即可；新增“退出登录”与设置页提示联动。
+
+## 0.1.4（2026-11-04）
+
+- “抖音账号”新增“退出登录”：逐个删除 douyin 域 Cookie（含 .douyin.com 父域）并清理本地存储后刷新，返回清理数量；不删除专用资料目录，退出后可立即发送二维码或打开登录页换号。
+
+## 0.1.3（2026-11-04）
+
+- 新增“发送二维码到微信”：从专用 Chrome 登录框提取真实二维码图片（512×512 PNG），经 DSH 内微信通道推给本人，适合不在电脑前时重新登录。
+- 自主观看因登录或验证停止时自动推送二维码（一分钟去重）；已登录时按钮直接提示无需发送。
+- 配套修改本地 dsh-weixin-ilink：提供 `weixinPush.toOwner()` 服务，复用已绑定账号与上下文向白名单第一个会话发送文字和图片。
+
+## 0.1.2（2026-11-04）
+
+- 登录状态改用本机抖音 `sessionid` Cookie 判断，不再把“页面没有登录弹窗”当成已登录；页面仍显示登录入口时给出刷新提示。
+- “打开登录页”会先取消最小化并把专用窗口置前；已登录时刷新页面并提示如何退出换号，未登录时打开首页登录框。
+- 操作结果直接显示在“抖音账号”区块，避免点了按钮看不到反馈。
+
+## 0.1.1（2026-11-04）
+
+- 设置页“基础设置”新增“抖音账号”：显示专用 Chrome 的登录状态，提供“检查登录状态”和“打开登录页”；换账号在 Chrome 内退出后重新扫码。
+- 准备页（launcher）也用于登录状态读取与登录页打开，未开始观看时不再误报“没有可用页面”。
+- 好友互动未选择许可会话时，状态从笼统的“准备中”改为“好友互动未配置”，并提示可关闭好友互动只做观看。
+
+## 0.1.0（macOS Chrome 移植，2026-11-04）
+
+- 基于上游 1.4.6 源码建立 macOS 插件分支，包名 `dsh-douyin-mac`，只提供 DSH 插件形态。
+- 浏览器层从 Microsoft Edge 改为 Google Chrome：macOS 安装探测、`channel: 'chrome'`、专用资料目录、错误码与诊断文案同步。
+- 状态目录默认改到 `~/.dsh/douyin-browser/state`，不再落在包目录内。
+- 修复静默设置与观看启动并发时互相判忙：控制锁等待 15 秒、回收已退出进程的锁、同实例窗口应用串行；核心工具路径不再因窗口忙中止。
+- 测试夹具适配 macOS：Chrome 路径、`--no-sandbox`/`--disable-gpu`、`/var` 符号链接的真实路径。
+- 实测：专用 Chrome 扫码登录、`douyin_status` 工具调用、自主观看观察→模型决策→换片→按额度停止、静默最小化下播放与取帧继续。
+
+## 1.4.6（2026-10-30）
+
+- 修复个人私信已读不回：等待平台确认后才推进发出水位；待发消息的零号标识不再被当成已送达。稳定身份优先于昵称，避免误判联系人。
+- 修复群聊补载旧历史造成回复不断被新消息替代的问题。普通许可聊天全天运行，群文字仍只在被 @ 或叫到响应昵称时回复。
+- 后台自动整理证据完整、可确认未发送的待答消息；发送结果不明时保留收据并核对，不盲目重发。减少需要用户手工处理的状态提示。
+- 加强图文、引用、原生表情、动图与可见卡片识别；回复采用共同人格及允许共享的记忆。可选择已确认公开的 QQ 本地表情，语音仍以已配置的本地转写为主。
+- 已许可群的新分享视频进入独立观看队列，沿用原观看时段及每日预算。按批次观察真实画面，由模型决定继续或停止，取消固定三秒总观察上限；群文字触发规则不变。
+- 接入 MIT 项目 dsh-video-storyboard 的布局与拼图代码，将同作品采样合为分镜图片；支持指定格精读。保留上游来源与许可证，不把封面或少量采样视作看完整条。
+- 多对象分享按稳定身份串行处理，显示进度并在对象间让出发送锁。确定未点击的定位失败跳过该对象；点击后结果不明时暂停分享，观看可以继续。
+- 共用视频页与消息页，改进后台连接释放、暂停操作、准备失败回收和缓存上限，减少标签及浏览器上下文累积。
+- 改进日报结构、作者资料长度边界、桌面运行包完整性核验及设置状态。插件和独立软件同步为 1.4.6。
+
+已知限制：推荐流仍可能换片失败；当前正式包尚无连续两小时实际播放和始终低于 2 GB 的验收结果。DSH rc.3 正文不显示反馈尚未复现定位，真实公开评论的发布确认仍待验，评论默认关闭。文件、位置、直播等部分卡片只读可见资料，暂不发送原生语音气泡。Windows 以外未完成适配。详见[本次验证范围](docs/verification/local-1.4.6-20261030.md)。
+
+## 1.4.5（2026-10-25）
+
+- 插件和软件改为自动保存；观看使用允许开关与每日时长、请求额度，高级选项可折叠，保留手动开始和暂停入口。
+- 好友与群聊共用所选许可名单和互动开关，取消人数与回复、分享次数上限，移除自动续火花入口。
+- 私信按共用人格接话，去掉固定“自动回复”前缀；支持已核实的表情、图片和单条本地语音转写。群聊只在被 @ 或叫到设定昵称时回复。
+- 状态栏按真实工作阶段显示，模型用量每次响应后追加。修复自动保存与轮询回包覆盖草稿、播放计时微小误差及重复分享导致观看停止。
+
+- 分享收件人和发送按钮绑定平台稳定身份，不再用昵称或头像作为授权匹配条件。
+- 适配当前网页的作品分享入口与好友面板，去除转发器残留的 50 人上限。
+- 分享收据记录明确的失败阶段和原因，两版设置页可查看；旧收据与去重记录保留。
+- 正常分享显示“在线 · 分享中”，真正未确认的发送仍需核对。
+- 换片等待期间持续核对原作品与验证状态，只发一次可信输入；旧决策不作用于新作品。
+- 视频模块补齐无文字验证码遮罩检测。
+- 宿主版本声明补充已验证的 0.2.1-rc.2 预发布分支，避免包管理器把它静默排除。
+
+这批改动由 1.4.5-beta.1、beta.2 本地验证后合并。此前本机使用过的 1.4.6 至 1.4.12 标签仅为内部构建，未作为正式版本发布。真实群聊、长期无人值守和其他机器环境的验证边界见[验证记录](docs/verification/local-1.4.5-beta.2-20261025.md)。
+
+## 1.4.4（2026-10-23）
+
+- 插件与软件在不限时长时保留分钟框输入；填写数字切回限时草稿，保存后生效。
+- 视频观看设置直接显示上次自主观看停止原因。
+- 自主分享说明许可名单的维护入口和保存步骤，不必启用私信自动回复。
+
+## 1.4.3（2026-10-23）
+
+- 自检增加专用浏览器连接、登录提示、真实窗口最小化、媒体静音、调度和互动状态。
+- 报告包含错误码、处理步骤、报告编号、有效期和允许的修复动作，不包含私人内容。
+- 新增 DSH 诊断及修复工具，设置页和软件提供相同修复按钮及可复制报告。
+- 仅修复已开启静默但未生效的问题；执行前后重新检查，不改许可、记忆、Key、预算，不启动服务或发送。
+
+使用说明见 docs/features-1.4.3.md。此公开版本也包含下面1.3.2至1.4.2的本机候选更新；这些中间版本未单独公开发布。
+
+## 1.4.2（本地更新，2026-10-23，尚未发布 npm）
+
+- 修复静默设置无法应用到已打开专用浏览器、仅有私信页或准备页时不能最小化的问题。
+- 手动视频操作也应用静默最小化，界面显示实际应用结果及阻止原因。
+- 打开准备入口复用唯一初始空白页，避免遗留不受管空标签。
+- 软件左栏将“对话与视频”移到“业务设置”上方。
+
+使用方式与验证边界见 docs/features-1.4.2.md。
+
+## 1.4.1（本地更新，2026-10-23，尚未发布 npm）
+
+- 软件与插件新增每个允许时段自动开始一轮，共享调度许可和一次性时段回执。
+- 好友互动显示各服务是否运行，以及私信联系人暂停情况。
+- 软件新增GitHub正式版本检查、下载校验与更新重启入口。
+- 修复软件包和左上角图标，移除左栏与设置分类重复的导航。
+
+使用条件、更新包要求和复用记录见 docs/features-1.4.1.md。
+
+## 1.4.0（本地更新，2026-10-23，尚未发布 npm）
+
+- 插件和软件新增一键自检、共用用量看板及主题观看设置。
+- 单轮时长可选择不限，有限值上限扩大到1,000,000分钟；自主请求和手动任务预算上限同步扩大。
+- 新增DeepSeek谷时段、全天和晚间快捷选择，支持周末全天。
+- 保留旧设置及共享记忆，保存较长规则不会延长旧轮次。
+
+使用方式、计数范围和停止行为见 docs/features-1.4.0.md。
+
+## 1.3.2（候选版，2026-10-23，尚未发布 npm）
+
+- 修复部分 DSH 桌面版进入设置后提示“没有可用的同源设置服务”、全部操作不可用的问题。
+- 支持常用桌面协议、本机 HTTPS 和宿主 RPC，后台同时适配 Connection 的设置路由，保留旧 WebServer 入口。
+- 连接失败后仍可刷新，恢复成功后清除旧错误。
+- 继续校验同源、宿主认证及写入令牌；写操作失败不自动重放。
+
+软件版同步到 1.3.2：打包共享领域模块，补齐静默观看、公开评论许可及观看日报界面；断连后可手动刷新，连接恢复会清除旧连接错误。软件仍独立使用用户 API Key，沿用与插件共用的人格、记忆和许可设置。软件包的检查范围见 desktop/VERIFICATION.md。
+
+升级后请完全退出并重开 DSH。不要删除人格、记忆、登录目录或重填 API Key。各第三方宿主的兼容程度以实测为准；记录见 docs/verification/settings-compatibility-20261023.md。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LockyBee and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,102 @@
-# Temporary Holding Version
+# DSH 抖音助手（macOS / Chrome 版）
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+0.1.9 说明。本项目基于上游 [dsh-douyin-agent](https://github.com/LockyBee/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：
+
+```sh
+dsh plugin --profile web add dsh-douyin-mac@0.1.9
+```
+
+本地开发也可以从源码目录安装（`npm install` 后 `dsh plugin --profile web add .`），两种方式不要同时用。
+
+插件通过 Playwright 启动**独立资料目录**的 Chrome 并连接本机 CDP；Chrome 136 起默认资料目录不允许开远程调试，专用目录已规避该限制。DSH 配置变化后重启同一份 DSH 即生效。
+
+## 第一次使用
+
+1. 在“刷抖音 → 基础设置 → DSH 模型”选择支持图片的提供商与模型。
+2. 点击“打开抖音”，在专用 Chrome 中手动登录或完成验证码；登录态保存在专用资料目录，重启后仍在。
+3. 在“视频观看”选择时段，按需展开“高级选项”设置每日分钟数和请求数，再开启“允许自动观看”。
+4. 在“好友互动”读取当前会话，核对稳定身份并勾选许可好友或群聊，按需填写群聊响应昵称。
+
+普通设置自动保存，文本输入离开输入框后提交；失败会保留草稿。音频 Key 在“音频与密钥”密码框填写，保存后不回显。
+
+## 状态与验证边界
+
+顶部状态栏区分在线、观看中、准备中和需要处理。后台自动整理有完整证据且确认未发送的待答消息；身份不符或发送结果不明时保留记录并核对。不能只凭总开关开启认定服务已就绪。好友回复与观看分开运行，观看时仍检查许可会话的新消息，实际速度受页面读取和模型耗时影响。
+
+遇到问题先运行“自检与用量 → 一键自检”，按报告处理限定修复项。登录、验证码、无效 Key、损坏记录和宿主适配不能靠删除锁、记忆或登录目录解决。发送结果不确定时保留收据并尝试回读核对；无法确认时不自动重发。
+
+macOS 移植的实机结果、测试统计和已知失败分类见[macOS 验证记录](docs/verification/mac-0.1.0-20261104.md)。推荐流仍可能换片失败；真实公开评论发布确认、连续两小时播放、真实群聊与多收件人分享仍待验。本机未安装 ffmpeg / 本地 Whisper，可选音频用例未通过，音频功能保持默认关闭。历史 Windows 的结果保留在原版本记录中，不自动适用于本移植。
+
+## 开发与来源
+
+```sh
+npm test
+npm run test:native
+```
+
+测试使用临时目录、合成模型或临时浏览器，不应把测试通过写成真实平台联调通过。运行状态、Key、登录资料、私信及联系人记录不进入仓库。
+
+浏览器控制复用 Playwright；来源见 [功能复用与来源](docs/reuse.md)、[软件来源](desktop/UPSTREAM.md)。原创代码采用 [MIT](LICENSE)，第三方通知见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。模型使用说明见 [skill/SKILL.md](skill/SKILL.md)，历史详细资料见 [docs/details.md](docs/details.md)。
+
+## 视频分镜与图片成本
+
+观看决策、分享视频回复及视频观察工具会把同一作品的多张JPEG采样优先拼成一张带格编号的图片，默认总像素预算480000。每格时间写在模型可读的清单中，仍沿用原作品、播放与许可校验；它不扩大已观看的时间，也不增加音轨理解。普通照片、单帧或无法可靠解码的帧保留原路径。
+
+DSH 普通视频工具可使用 `douyin_video_zoom`，传前次观察返回的 `storyboardSampleId`、`cell` 与同一 `videoId`，读取指定格的原图。仅限本入口最近一分钟采样；换片、登录或验证遮挡、过期时拒绝。原帧缓存有容量上限，退出或到期清理。自动好友回复目前默认使用分镜，不自动增加第二轮精读请求。
+
+布局、编号和RGB拼图复用 [SAOS-3624/dsh-video-storyboard](https://github.com/SAOS-3624/dsh-video-storyboard) 的MIT源码，JPEG编解码使用带完整许可的纯JS实现，无需新增ffmpeg或外部ASR服务。只合成已经取得的真实采样；上游完整下载、全片扫描、字幕和ASR服务生命周期未接入后台。计费因模型不同，图片数量和像素减少不等于固定token数；用量看板仍只记录提供器实际回报。
+
+### 共用专用浏览器页面
+
+插件共用同一个视频页、一个消息页，分别处理观看和全天许可聊天。“打开抖音”显示已有视频页；准备页会在无草稿、登录或验证阻挡时转为视频页。两个入口共用操作锁，许可和每日预算保持原规则。用户自行打开的页面、未发送草稿及验证页面不会为凑标签数量被强行关闭。
+
+### 群里分享的视频
+
+已许可群中新收到的视频卡片会单独进入观看队列，不要求再 @ 大肥鱼。播放和画面理解遵守原观看时段、每日时长和模型请求预算；时段外或额度用完时等待。普通群文字仍只在被 @ 或叫到响应昵称时回复，单独看视频不会自动往群里发消息。
+
+队列核对原会话、分享消息、成员和实际播放推进，使用分镜输入理解采样画面。会话内笔记供后续提问使用，不写成其他会话可读的共享记忆；不保存原始图片。撤回、撤权或身份变化时停止采用对应记录，重启不批量补看旧历史。分时采样不等于看完整条，也不包含音轨。
+
+### 多对象分享与观看恢复
+
+大肥鱼可以根据实际视频内容选择多位已许可对象，按顺序逐个分享；同作品、同对象仍永久去重。页面顶部会显示当前分享进度。列表下方或虚拟化列表中的对象按稳定身份有界查找，不用同名或头像猜测收件人。
+
+确认尚未授权点击、也未发送的面板或定位故障，只跳过该对象。每位对象之间释放共同发送锁并短暂让出执行机会，供普通消息回复使用。点击后结果不明时暂停后续分享、保留收据且不重发，观看可以继续；取消、视频预算与未知发送故障仍保留原门禁。
+
+无效或截断的观看决策不执行动作，重新观察后再判断；连续三次无效会停止本次观看，每次模型调用都计入原每日预算。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,48 @@
+# 第三方来源与许可证
+
+## 浏览器、运行时及接口
+
+- Microsoft Playwright CLI 0.1.22、Playwright MCP 0.0.83 及锁定的 playwright-core：Apache-2.0，来源为 [Microsoft Playwright](https://github.com/microsoft/playwright)。依赖由包管理器安装，原 LICENSE 和版权声明保留在包内；分发时须保留 Apache-2.0 要求的声明和通知。
+- DSH 原生插件使用本机已安装产品的 runtime、schema、Cordis Loader 与附件接口，相关包的 MIT LICENSE 留在依赖内。独立软件的 UI 源码复用范围另见下文；账号配置和个人历史不随源码或软件提供。
+- DeepSeek API：按官方 Chat Completions 协议调用，使用用户已有账户配置；接口服务使用与费用另受供应商条款约束。
+- 相关抖音方案研究：`chu557/douyin-plugin-dsh-plugin`（MIT）、`AnacondaKC/dsh-douyin`（BSD-3-Clause）、`q35888/dsh-plugin-browser`（MIT）。本项目没有复制这三个抖音插件的业务实现。
+
+## 1.3 安装、设置与日报流程参考
+
+参考 MIT 项目 [c1overzz/dsh-bili-scroll](https://github.com/c1overzz/dsh-bili-scroll/tree/a047fde1df2be1ec1d9d7551aa0b5eae6626b319) 的标准 bundle 安装声明、原生设置入口与 Markdown 日报流程，核对提交为 `a047fde1df2be1ec1d9d7551aa0b5eae6626b319`。本项目自行实现抖音设置、模型路由、报告汇总与手改保护，没有复制或打包其 Python、B 站 MCP、字幕获取、登录凭据和定时 headless 任务。
+
+续火花另核对 MIT 项目 [HRuiCcc/dy-xuhuohua](https://github.com/HRuiCcc/dy-xuhuohua) 及 MIT 与 NOTICE 项目 [dr-190/ScriptCat-Douyin-Fire-Helper](https://github.com/dr-190/ScriptCat-Douyin-Fire-Helper)；未复制其发送实现或新增其运行依赖。固定提交、未采用原因与本地复用范围见 [功能复用与来源](docs/reuse.md)。来源核查不代表新版插件已实机加载，也不证明评论发布、平台火花或最小化持续播放已通过。
+
+## 实际保存的媒体源码
+
+下列三个社区项目的原始源码和 MIT LICENSE 已复制到 `media/vendor/`，不是仅安装依赖或参考名称。固定 commit、原始路径、SHA256 和 `modified:false` 记录见 [media/PROVENANCE.json](media/PROVENANCE.json)；本机核对全部记录的文件哈希与清单一致。
+
+| 来源 | 固定 commit | 本机文件与用途 | 保留的许可证 |
+| --- | --- | --- | --- |
+| [ch1bug/dsh-mimo-agent-tools](https://github.com/ch1bug/dsh-mimo-agent-tools/tree/38a7985d25090a4b87b987c2d99613a5c6b318d7) | `38a7985d25090a4b87b987c2d99613a5c6b318d7` | `media/vendor/mimo/driver/mimo_driver.py`；桥接调用其 `build_body` 构造 MiMo 音频、视频请求正文 | [media/vendor/mimo/LICENSE](media/vendor/mimo/LICENSE)，MIT，Copyright © 2026 lihao (ch1bug) |
+| [GooDAnDReaDY/dsh-voice](https://github.com/GooDAnDReaDY/dsh-voice/tree/e3e96e0bd3a34d73fec0edac45a1fba1cb7b6f6f) | `e3e96e0bd3a34d73fec0edac45a1fba1cb7b6f6f` | `media/vendor/voice/lib/providers.js`、`provider-http.js`；配置本机 Whisper HTTP 服务时调用其 local-whisper provider | [media/vendor/voice/LICENSE](media/vendor/voice/LICENSE)，MIT，Copyright © 2026 GooDAnDReaDY |
+| [moluyao/dsh-minimax-asr](https://github.com/moluyao/dsh-minimax-asr/tree/bbf79d17e32a1dab94bffba20fa6b1fbd8cf700e) | `bbf79d17e32a1dab94bffba20fa6b1fbd8cf700e` | `media/vendor/minimax/lib/index.js`；保留为 MiniMax ASR 请求参数来源，网络请求由本项目 Node.js fetch 适配 | [media/vendor/minimax/LICENSE](media/vendor/minimax/LICENSE)，MIT，Copyright © 2026 moluyao |
+
+三个 MIT LICENSE 均允许使用、修改、分发及商用，同时要求在副本或重要部分中保留版权和许可声明；原许可证全文随源码保留。它们是社区项目，不是 DeepSeek 官方插件；许可证许可不等于云服务可免费调用或保证适配成功。
+
+本地语音路径另依赖 Python、Whisper/faster-whisper、FFmpeg 等已安装运行环境，安装清单见 `media/requirements.txt`；模型权重与运行依赖按各自许可证和使用条件管理。媒体开关默认关闭，本项目没有打包个人凭据或模型缓存。云端后端尚未做真实请求验收，本地合成对白转写已单独验证。实际抖音采到的 3 秒猫咪片段音轨没有有效对白，不作为 ASR 准确性或声音理解验收。
+
+媒体与插件的适配验收分开记录：本地 Whisper 已真实处理合成 WAV、WebM；精确表情截图进入 DeepSeek 的真实请求不使用上述云音频后端，也没有向真人发送。2026-10-15 又独立完成真实 DSH 的 22 项工具目录核对、状态/许可会话读取、表情图片附件和人工转发提示分支；云端音频仍未联调。具体结果及元数据读取限制见主 README 和 PLUGIN-README；上游许可证不改变这些验收边界。
+
+本项目原创代码采用根目录 [LICENSE](LICENSE) 中的 MIT 许可证；第三方源码、字体及依赖继续按各自许可证分发，保留原版权、许可和必要通知。第三方许可和上游测试不替本项目作交付保证。
+
+## 独立 API 桌面软件
+
+界面复用 `deepseek-ai/deepseek-harness` 固定提交 `fb2c4b9e698e30edb738bca4cf0618587db7d203` 中的 `ui-primitives` React 基础组件、`ui-theme` 样式及 `ui-layout` 的 `AppFrame.module.css`。官方 MIT 全文保存在 [desktop/licenses/DeepSeek-Harness-MIT.txt](desktop/licenses/DeepSeek-Harness-MIT.txt)，固定下载与来源校验见 [desktop/UPSTREAM.json](desktop/UPSTREAM.json) 和 [desktop/UPSTREAM.md](desktop/UPSTREAM.md)。同目录留存的完整上游第三方通知用于来源核查，不表示本软件使用了上游全部依赖。
+
+独立软件的模型请求、业务表单、桌面生命周期及 IPC 由本项目实现，运行资源不包含 DSH Host、Cordis、DSH SDK 或社区桌面壳。它不代表 DeepSeek 官方发行，也不复制用户 DSH 的外观图片、桌宠、音效、凭据、会话或历史。
+
+桌面构建使用 Electron `44.0.0`、electron-builder `26.15.3`、esbuild `0.28.1`；后台使用 Node.js `24.17.0`、`playwright-core` `1.64.0-alpha-1790635538000` 和 `yaml` `2.9.0`。Node 完整许可、Playwright 的 Apache-2.0/NOTICE/ThirdPartyNotices 和 YAML 的 ISC 许可随后台实际运行包保留。React、KaTeX 字体、Markdown、Shiki 及其他前端组件以 `desktop/ui-api` 的锁文件和实际构建产物为准，各自版权与许可证随界面产物保存；Electron/Chromium 的通知由桌面分发层保留。
+
+上述依赖的许可不代替模型接口服务的条款，也不构成软件联调保证。可选音频仍使用前述三个社区项目的来源与 MIT；Python、FFmpeg、音频模型及个人密钥不随基础软件提供。构建与验收范围见 [desktop/README.md](desktop/README.md)。
+
+## 省图片成本的视频分镜
+
+复用 SAOS-3624/dsh-video-storyboard 0.4.4 固定提交 2ba682d471a0e63defdb5e8e023465ab59806b05 的纯 RGB 布局、编号和拼图代码，按 MIT 分发。适配只作用于本项目已核实的视频采样，不启用上游下载器、全局 ASR 或进程托管。版权及完整许可见 storyboard/vendor/LICENSE，原 NOTICE 与逐文件来源见 storyboard/PROVENANCE.json。上游文档中的作者视频图片未复制。
+
+JPEG 编解码复用 jpeg-js 0.4.4，保留 BSD-3-Clause 许可证；其 decoder.js 原有 Copyright 2011 notmasteryet 的 Apache-2.0 声明及完整 Apache 文本均保留，encoder.js 的 Adobe BSD 声明也保留。文件见 storyboard/vendor/jpeg-js/。不新增原生图片库或自动下载运行依赖。拼成一张图不等于所有模型固定计费384 token，实际以所选模型返回的用量为准。