dsh-plugin-streamnest 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2026 StreamNest 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.
+
+Scope: This license covers original StreamNest contributions only. Third-party
+and adapted portions retain their own copyright notices and license terms.
+Bundled dependency notices and license terms are included in
+lib/THIRD_PARTY_LICENSES.txt.
+The Commons Clause condition on the Channels integration is not overridden.

package/README.en.md

@@ -0,0 +1,106 @@
+# StreamNest · 拾流
+
+[![DeepSeek Harness](https://img.shields.io/badge/DeepSeek-Harness-4D6BFE)](https://github.com/deepseek-ai/deepseek-harness)
+[![Stars](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fgit.aimz.cc.cd%2Fapi%2Fv1%2Frepos%2Flynn1286%2Fdsh-plugin-streamnest&query=%24.stars_count&label=Stars&logo=gitea&color=orange)](https://git.aimz.cc.cd/lynn1286/dsh-plugin-streamnest/stars)
+[![Version](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fgit.aimz.cc.cd%2Fapi%2Fv1%2Frepos%2Flynn1286%2Fdsh-plugin-streamnest%2Fraw%2Fpackage.json%3Fref%3Dmain&query=%24.version&prefix=v&label=version&color=blue)](package.json)
+[![License: MIT (original code)](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+[中文](README.md) | English
+
+A local audio and video downloader plugin for DeepSeek Harness. Parse media links, select video quality, audio tracks or subtitles, and save files to your computer. The UI and Agent share the same services and download queue.
+
+![StreamNest installed and enabled in the DeepSeek Harness desktop app, showing the Link Download page](assets/screenshots/deepseek-harness-installed.png)
+
+## Features
+
+- **Link parsing**: Parse media with yt-dlp, with dedicated APIs and browser fallbacks for Douyin and Kuaishou; supports single-video WeChat Channels share links.
+- **Download options**: Select video quality and audio tracks, extract MP3 audio, and download subtitles in their original format or convert them to SRT.
+- **Task management**: Queue downloads, control concurrency, view progress and speed, pause, resume, retry, and inspect local files.
+- **Completed downloads**: Search, view local thumbnails, play media, open folders, and sync the download directory; permanently delete individual or multiple downloads after a second confirmation.
+- **Download acceleration**: Download direct links in chunks with resume support and optional aria2; concurrent HLS / DASH segment downloads.
+- **Settings**: Configure the download directory, filename template, default quality, proxy, explicitly selected browser profile or Cookie file, and Chinese or English UI.
+- **Dependencies and diagnostics**: Detect or install yt-dlp, FFmpeg and ffprobe; inspect redacted logs and generate feedback drafts.
+
+## Installation
+
+In DeepSeek Harness, open **Plugins → Add Plugin**, enter `dsh-plugin-streamnest`, select the official npm registry, then install and enable it. The published package includes build artifacts and requires no compilation during installation.
+
+You can also use the official CLI:
+
+```bash
+dsh plugin --profile desktop add dsh-plugin-streamnest --registry=https://registry.npmjs.org/
+```
+
+For the Web version of DeepSeek Harness, replace `desktop` with the appropriate profile, such as `web`. See `peerDependencies` in `package.json` for the supported host SDK versions.
+
+## Usage
+
+1. Open StreamNest in the host, go to **Settings**, select a local download directory, and check the runtime dependencies.
+2. Paste a media link into **Link Download**, parse it, select video quality, audio tracks or subtitles, and add a download to the queue.
+3. Monitor and control tasks in **Download Queue**; play media or open its folder in **Completed Downloads**.
+
+You can also ask the Agent in a host conversation to parse links, create downloads, inspect the queue, or pause tasks. Results stay in sync with the UI.
+
+### Limitations
+
+- Parses one video at a time without expanding playlists; live streams are not supported.
+- Site availability depends on platform APIs, access permissions, login state, and runtime tool versions.
+- Standard WeChat Channels share links require a Tencent Yuanbao login session. Links containing valid playback parameters can be parsed directly. Only single videos are supported.
+- Browser Cookies are read only after a source is explicitly configured. Without a configured source, requests use an unauthenticated session.
+- Downloads do not resume automatically after the host restarts; resume them manually.
+- Deleting items in **Completed Downloads** permanently deletes their registered files after a second confirmation and cannot be undone. Directory sync only updates records and does not delete files.
+- aria2 is optional and must be installed separately or provided through a configured path.
+
+## Development and packaging
+
+Requires Node.js ≥ 22.13 and pnpm 11.5.0, as pinned in `package.json`.
+
+```bash
+pnpm install --frozen-lockfile
+pnpm dev
+```
+
+The development preview runs at `http://127.0.0.1:5179`, with the API at `http://127.0.0.1:4322/streamnest/api`. The preview uses the official host theme and UI primitives; in the DeepSeek Harness desktop app, the plugin inherits the host theme.
+
+```bash
+pnpm run check
+pnpm run release
+```
+
+The release archive is written to `release/streamnest-<version>.tgz` and can be installed locally. It includes the project documentation, reference project sources, original license texts, and bundled client dependency licenses.
+
+### Publishing to npm
+
+Sign in with `npm login`, or provide an access token with publishing permissions through standard npm configuration, then run:
+
+```bash
+pnpm run publish:npm --dry-run
+pnpm run publish:npm
+```
+
+The publish command runs checks, creates a release archive, and publishes that same archive to the official npm registry. Authentication uses standard npm login or access token configuration, and npm verifies publishing permissions. `--dry-run` performs a rehearsal only. Update the version in `package.json` before each subsequent release; a published version cannot be overwritten.
+
+| Directory                        | Responsibility                                            |
+| -------------------------------- | --------------------------------------------------------- |
+| `apps/api`                       | NestJS business services, DTO validation, media downloads |
+| `apps/web`                       | React UI and Chinese / English translations               |
+| `apps/shared`                    | Shared contracts for tasks, settings and output files     |
+| `packages/harness`               | Host integration, official UI adapters and Agent tools    |
+| `assets/reference-projects.json` | Reference project source list                             |
+| `licenses`                       | Original license texts for reference projects             |
+
+The UI, API and Agent reuse the same business services. Host adapters live in `packages/harness`.
+
+## Acknowledgments
+
+Reference implementations: [DownVid](https://github.com/yxxbc/downvid) · [wx_channels_download](https://github.com/ltaoo/wx_channels_download)
+
+## License
+
+Original contributions are licensed under the [MIT License](LICENSE); the MIT badge above applies only to those contributions. Referenced and adapted portions retain their original authors' copyrights and license terms. The wx_channels_download license includes the Commons Clause; its full license text governs those portions. The build collects reference project sources, original licenses and bundled client dependency licenses in `lib/THIRD_PARTY_LICENSES.txt`.
+
+## Disclaimer
+
+- This is an independently developed third-party plugin with no official affiliation with or endorsement by DeepSeek or the relevant media platforms.
+- Download only content you own, are authorized to download, or may lawfully download under applicable law. Follow the source platform's terms of service and respect copyright and privacy requirements. Do not use this software to bypass paywalls, DRM or other access controls, distribute content without authorization, or engage in other unlawful activities.
+- The software is provided “as is,” without guarantees of continued third-party site availability or the completeness, accuracy or fitness of downloads for a particular purpose. Keep account credentials secure and back up important files. To the extent permitted by applicable law, authors and contributors are not liable for losses arising from use of this software, subject to [LICENSE](LICENSE) and the relevant third-party licenses.

package/README.md

@@ -1,3 +1,106 @@
-# Temporary Holding Version
+# 拾流 · StreamNest
 
-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.
+[![DeepSeek Harness](https://img.shields.io/badge/DeepSeek-Harness-4D6BFE)](https://github.com/deepseek-ai/deepseek-harness)
+[![Stars](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fgit.aimz.cc.cd%2Fapi%2Fv1%2Frepos%2Flynn1286%2Fdsh-plugin-streamnest&query=%24.stars_count&label=Stars&logo=gitea&color=orange)](https://git.aimz.cc.cd/lynn1286/dsh-plugin-streamnest/stars)
+[![Version](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fgit.aimz.cc.cd%2Fapi%2Fv1%2Frepos%2Flynn1286%2Fdsh-plugin-streamnest%2Fraw%2Fpackage.json%3Fref%3Dmain&query=%24.version&prefix=v&label=version&color=blue)](package.json)
+[![License: MIT (original code)](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+中文 | [English](README.en.md)
+
+适用于 DeepSeek Harness 的本地音视频下载插件。解析媒体链接、选择画质、音轨或字幕并保存到本机，页面与 Agent 共用同一套服务和下载队列。
+
+![拾流已安装并启用：DeepSeek Harness 桌面版中的链接下载界面](assets/screenshots/deepseek-harness-installed.png)
+
+## 功能
+
+- **链接解析**：通过 yt-dlp 解析媒体，抖音、快手提供专用 API 和浏览器回退；支持微信视频号单视频分享链接。
+- **下载选择**：选择视频画质和音轨，提取 MP3，下载字幕并选择保留源格式或转换为 SRT。
+- **任务管理**：下载排队、并发控制、进度与速度显示、暂停、继续、重试，以及本地文件查看。
+- **已完成下载**：搜索、本地缩略图、播放、打开目录和目录同步；支持二次确认后的单个与批量永久删除。
+- **下载加速**：直链分块下载和断点续传，可选 aria2；支持 HLS / DASH 分片并发。
+- **运行设置**：下载目录、文件名模板、默认画质、代理、明确指定的浏览器账号或 Cookie 文件，以及中英文界面。
+- **依赖与诊断**：探测或安装 yt-dlp、FFmpeg、ffprobe；查看脱敏日志和生成反馈草稿。
+
+## 安装
+
+在 DeepSeek Harness 的「插件 → 添加插件」中输入 `dsh-plugin-streamnest`，选择 npm 官方源安装并启用。发布包已包含构建产物，安装时无需编译。
+
+也可以使用官方 CLI：
+
+```bash
+dsh plugin --profile desktop add dsh-plugin-streamnest --registry=https://registry.npmjs.org/
+```
+
+使用 DeepSeek Harness Web 版时，将 `desktop` 换为对应的 profile（例如 `web`）。宿主 SDK 兼容范围见 `package.json` 的 `peerDependencies`。
+
+## 使用
+
+1. 在宿主中打开「拾流」，进入「运行设置」，选择本机下载目录并检查运行依赖。
+2. 在「链接下载」粘贴媒体链接，解析后选择画质、音轨或字幕，加入下载队列。
+3. 在「下载队列」查看进度和控制任务，在「已完成下载」播放或打开文件目录。
+
+也可以在宿主会话中让 Agent 解析链接、创建下载任务、查询队列或暂停任务，操作结果与页面同步。
+
+### 功能限制
+
+- 每次解析一个视频，不展开播放列表；不支持正在直播的媒体。
+- 网站可用性取决于站点接口、访问权限、登录状态和运行工具版本。
+- 视频号普通分享链接需要腾讯元宝登录状态；已携带有效播放参数的链接可直接解析。仅处理单视频内容。
+- 浏览器 Cookie 仅在明确配置来源后读取；未配置时以未登录状态访问。
+- 宿主重启后不会自动继续下载，需手动继续。
+- 「已完成下载」中的删除会永久删除所选记录登记的文件，二次确认后执行，无法撤销；目录同步只整理记录，不删除文件。
+- aria2 为可选工具，需自行安装或指定路径。
+
+## 开发与打包
+
+需要 Node.js ≥ 22.13，使用 `package.json` 固定的 pnpm 11.5.0。
+
+```bash
+pnpm install --frozen-lockfile
+pnpm dev
+```
+
+开发预览地址为 `http://127.0.0.1:5179`，API 地址为 `http://127.0.0.1:4322/streamnest/api`。开发预览使用官方宿主主题与控件；在 DeepSeek Harness 桌面版中继承宿主主题。
+
+```bash
+pnpm run check
+pnpm run release
+```
+
+发布包输出至 `release/streamnest-<版本>.tgz`，可用于本地安装。构建产物包含项目介绍、参考项目来源、原始许可及客户端捆绑依赖许可。
+
+### 发布到 npm
+
+先通过 `npm login` 登录，或通过标准 npm 配置提供具备发布权限的 access token，再执行：
+
+```bash
+pnpm run publish:npm --dry-run
+pnpm run publish:npm
+```
+
+发布命令会先执行检查、生成 release 包，再发布同一个安装包到 npm 官方 registry。认证沿用标准 npm 登录或 access token 配置，发布权限由 npm 校验。`--dry-run` 只演练。后续发布前须更新 `package.json` 的版本号，已发布的同名版本不能覆盖。
+
+| 目录                             | 职责                                      |
+| -------------------------------- | ----------------------------------------- |
+| `apps/api`                       | NestJS 业务服务、DTO 校验、解析与下载实现 |
+| `apps/web`                       | React 页面与中英文词库                    |
+| `apps/shared`                    | 任务、设置、输出文件等共享契约            |
+| `packages/harness`               | 宿主接入、官方 UI 适配与 Agent 工具       |
+| `assets/reference-projects.json` | 参考项目来源清单                          |
+| `licenses`                       | 参考项目原始许可文本                      |
+
+页面、API 与 Agent 复用相同业务服务，宿主适配集中在 `packages/harness`。
+
+## 感谢开源
+
+参考实现：[DownVid](https://github.com/yxxbc/downvid) · [wx_channels_download](https://github.com/ltaoo/wx_channels_download)
+
+## 许可
+
+原创部分采用 [MIT 许可](LICENSE)，顶部 MIT 徽章仅指原创部分。参考及改编部分保留各自原作者版权和许可，wx_channels_download 的许可包含 Commons Clause 附加条款，以许可原文为准。构建时将参考项目来源、原始许可和客户端依赖许可汇总至 `lib/THIRD_PARTY_LICENSES.txt`。
+
+## 免责声明
+
+- 本项目为独立开发的第三方插件，与 DeepSeek 及相关媒体平台不存在官方隶属或背书关系。
+- 仅下载自己拥有权利、已获得授权或适用法律允许下载的内容，并遵守来源平台的服务条款及版权、隐私等要求。不得用于绕过付费、DRM 或其他访问控制，不得用于未经授权的传播或其他违法用途。
+- 软件按「现状」提供，不保证第三方站点持续可用，也不保证下载结果完整、准确或适合特定用途。请自行保管账号凭据并备份重要文件；在适用法律允许的范围内，作者及贡献者不对使用本软件造成的损失承担责任，具体以 [LICENSE](LICENSE) 及相关第三方许可为准。

package/assets/logo.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" viewBox="0 0 32 32" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M8 5.5h11a4 4 0 0 1 0 8h-6a3.5 3.5 0 0 0 0 7h8"/>
+  <path d="m17.5 17 3.5 3.5-3.5 3.5"/>
+  <path d="M5 22v2a4 4 0 0 0 4 4h14a4 4 0 0 0 4-4v-2"/>
+</svg>

package/assets/reference-projects.json

@@ -0,0 +1,16 @@
+{
+  "downvid": {
+    "name": "DownVid",
+    "author": "yxxbc",
+    "url": "https://github.com/yxxbc/downvid",
+    "license": "MIT",
+    "licenseFile": "licenses/downvid.LICENSE"
+  },
+  "wxChannels": {
+    "name": "wx_channels_download",
+    "author": "ltaoo",
+    "url": "https://github.com/ltaoo/wx_channels_download",
+    "license": "MIT + Commons Clause",
+    "licenseFile": "licenses/wx_channels_download.LICENSE"
+  }
+}