dsh-douyin-agent 0.0.0-stage → 1.4.0

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,131 @@
-# Temporary Holding Version
+# DSH 抖音助手
 
-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.
+让 DSH 里的 DeepSeek（大肥鱼）自己刷抖音：搜索、换片、看真实画面，把有意思的内容记下来，并在你许可的范围内分享给好友。
+
+在专用 Edge 里浏览电脑网页版抖音：开头先抓 6 帧拼成一张采样图，让模型决定看不看；决定看之后按秒抽帧，拼成最多三张故事板，连同带时间轴的弹幕和转写一起交给模型。所有外发功能默认关闭，每一项都有独立开关、次数上限和时间限制。这是第三方适配，不是 DeepSeek 官方出品。
+
+## 能做什么
+
+| 功能 | 说明 | 默认 |
+| --- | --- | --- |
+| 自主观看 | 按人格和兴趣自己搜索、换片、继续看或停止，并给出理由 | 需手动开始有限轮次 |
+| 兴趣与人格 | 兴趣来自实际观看进度和已确认行为，不是看到主题就算喜欢 | 随观看自动积累 |
+| 时间限制 | 每日允许时段（北京时间）加单轮时长，到点视频真的暂停 | 单轮 10 分钟 |
+| 静默观看 | 静音，核对窗口归属后尝试最小化（仍是有窗口的 Edge，不是 headless） | 关闭 |
+| 观看日报 | 把当天实际看过的标题、作者、链接汇总成 Markdown，不调用模型 | 可手动生成，每轮观看结束后也会尝试生成 |
+| 主动分享 | 通过官方分享界面把当前看过的作品发给许可好友，每天默认 3 次 | 关闭 |
+| 自动问候 | 每位许可好友每天最多一次，合计默认 2 次，带「自动问候」标记 | 关闭 |
+| 私信自动回复 | 只处理你勾选的最多十位好友，只回复启动之后的新消息 | 关闭 |
+| 公开评论 | 只在作品播到结尾时问一次，同一作品永久只评一次，不限条数 | 关闭 |
+| 画面理解 | 开头 6 格采样决定看不看；决定看之后整条按秒抽帧，拼成最多 3 张故事板（末尾不足 6 格不拼） | 随观看自动 |
+| 弹幕与转写 | 抓当前作品的弹幕，按时间标注取高赞几条；对白按 10 秒切段转写，合并成带时间轴的整条文本 | 随观看自动 |
+| 音频理解 | 本地 Whisper 转写对白，可选 MiMo 或 MiniMax 云端 | 关闭 |
+| 磁盘清理 | 每轮开场删掉两天前的故事板和采样图，只清图片，不动观看记录 | 每天自动 |
+
+发送结果不确定时一律暂停，不会自动重发。
+
+## 两种用法
+
+| | 插件版 | 软件版 |
+| --- | --- | --- |
+| 在哪用 | DSH 的「设置 → 刷抖音」，全部用按钮操作 | 独立的 Windows 桌面软件，对话式下任务 |
+| 模型 | 用 DSH 里已配置的提供商 | 用你自己填的 DeepSeek API Key |
+| 版本 | 1.4 | 已打包的是 1.2.0，1.4 尚未打包 |
+
+两者共用同一份人格、兴趣和记忆，但同一时刻只会运行一个自主观看。
+
+## 快速开始（插件版）
+
+### npm 安装（1.4.0 发布后可用）
+
+在 DSH Desktop 自带终端中运行：
+
+```powershell
+dsh plugin --profile desktop add dsh-douyin-browser-local@1.4.0
+```
+
+需要 Windows、已安装 Microsoft Edge 和 DSH 0.2.0-rc.2。安装后按宿主提示重新加载，在设置中打开“刷抖音”；抖音登录和验证由使用者自行完成。市场收录与 npm 包发布分别同步，不能把发布成功当成市场已刷新。
+
+### 从源码安装
+
+
+需要 Windows、Microsoft Edge、Node.js 22.13 以上，以及 DSH 0.2.0-rc.2 系列（已在 DSH Desktop 2.0.17 上核对过设置页）。
+
+```powershell
+git clone https://github.com/LockyBee/dsh-douyin-agent.git
+cd dsh-douyin-agent
+pnpm install --frozen-lockfile
+$dshInstallDirectory = 'C:\Apps\DSH Desktop' # 替换为正在使用的 DSH 安装目录
+.\install-native.ps1 -DshRoot $dshInstallDirectory
+```
+
+第一条命令安装依赖；不带 `-Install` 的脚本只做检查，不改配置也不开窗口。确认无误后完全退出 DSH，再执行：
+
+```powershell
+.\install-native.ps1 -DshRoot $dshInstallDirectory -Install
+```
+
+重新打开 DSH，在「设置」里找到「刷抖音」，按这个顺序用：
+
+1. 基础设置：选提供商和模型（模型必须支持图片），保存。
+2. 视频观看：点「打开抖音」，在专用 Edge 里自己登录或过验证。
+3. 设置允许时段和单轮时长，点「开始有限轮次」，再点「开始自主观看」。
+
+安装细节和本机现有入口的说明见 [插件说明](docs/plugin.md)。
+
+## 当前验证状态
+
+| 状态 | 内容 |
+| --- | --- |
+| 真实环境验证过 | 推荐播放、搜索、上下切换、暂停、画面采样、限时到点暂停；旧版 DSH 原生工具调用；表情图片采样；一次人工授权的好友转发；DSH 2.0.17 中设置页挂载并读回状态；2026-10-30 两条真实的自动问候（拿到消息 ID，平台火花未验证） |
+| 只有合成测试 | 自主分享、行为偏好、自主评论、静默、日报、抽帧故事板与弹幕的真实密度 |
+| 还没验证 | 抖音最小化后的持续播放、真实评论区、收到新私信后的完整自动回复、MiMo 与 MiniMax 云端、标准 bundle 安装 |
+
+合成测试用的是替身模型和临时页面，不能当作真实抖音上能用的证据。最新测试数字和已知失败见 [v10 验证记录](docs/verification/native-v10.md)。
+
+## 目录
+
+| 位置 | 内容 |
+| --- | --- |
+| `dsh-plugin.mjs`、`client.js`、`cordis.bundle.yml` | 原生插件入口、设置页前端、标准 bundle 声明 |
+| `tool-definitions.mjs` | 32 项工具目录，插件和软件共用 |
+| `native-*.mjs` | 设置页后端、模型路由、人格注入、问候与观看决策 |
+| `core.mjs`、`browser-*.mjs` | 专用 Edge 的控制、采样、限时 |
+| `video-limits.mjs`、`task-limits.mjs`、`watch-mode.mjs` | 时段与轮次、任务预算、静默 |
+| `autonomous-*.mjs`、`spark-*.mjs`、`daily-report.mjs` | 自主观看、分享、评论、问候、日报 |
+| `frame-grab.mjs`、`danmaku.mjs`、`capture-session.mjs` | 页面内抽帧与故事板拼接、弹幕抓取与排序、素材清单与音频段归位 |
+| `media-cleanup.mjs` | 开轮时清理两天前的故事板和采样图 |
+| `chat-*.mjs`、`message-tracker.mjs`、`outbound-send.mjs` | 私信自动回复和统一的发送账本 |
+| `memory.mjs`、`persona-memory.mjs`、`qq-sync.mjs` | 共享记忆、人格卡、QQ 侧同步 |
+| `app.mjs`、`api-agent.mjs`、`public/`、`start-api.*` | 旧的本机 HTTP 控制台（`http://127.0.0.1:3218`） |
+| `desktop/` | Electron 桌面软件的源码、打包脚本和上游许可证 |
+| `media/` | 可选音频模块，内置三份社区项目源码 |
+| `tests/`、`verification/` | 单元测试，以及实机验收脚本 |
+| `skill/SKILL.md` | 给模型看的使用说明 |
+
+## 文档
+
+| 文档 | 内容 |
+| --- | --- |
+| [插件说明](docs/plugin.md) | 插件安装、设置页逐项说明、预算、各项外发的规则 |
+| [独立软件说明](docs/standalone-api.md) | 独立 API 控制台和软件版的配置 |
+| [详细说明](docs/details.md) | 原 README 全文，按时间累积，内容多 |
+| [功能复用与来源](docs/reuse.md) | 参考和复用的开源项目，以及边界 |
+| [docs/verification/](docs/verification) | 各版本的测试记录 |
+| [desktop/README.md](desktop/README.md) | 桌面软件的构建和使用 |
+| [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) | 第三方许可证 |
+
+## 开发
+
+```powershell
+pnpm test
+pnpm run test:native
+```
+
+`pnpm test` 会起临时 Edge 页面，不碰真实抖音和你的账号。运行状态、浏览器资料、密钥、数据库、私信正文和联系人信息都只保存在本机，不进入仓库。
+
+## 许可证
+
+本项目原创代码采用 [MIT](LICENSE)。第三方源码和依赖的原许可证、版权及通知见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
+
+公开准备、分发包检查与社区市场申请见 [发布记录](docs/publication.md)。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,42 @@
+# 第三方来源与许可证
+
+## 浏览器、运行时及接口
+
+- 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)。