前言¶
在 DeepSeek Harness（DSH）里让模型「帮找资源」，常见问题是助手一次吐出大量链接：难以核对、难以选渠道，大季集或全系列网盘入口多时更容易失控。暮黎资源查找（dsh_plugin_muliyresources）把流程拆成搜索 → 候选 → 选资源 → 选获取方式 → 选条目 → 交付，每一步由用户确认后再展开；影视、短剧、游戏、软件、小说五类来源共用同一条链路，交付侧可导出单文件 HTML 资源页，或对小说直接落盘整本 TXT。
这是什么¶
- 名称与维护：GitHub 仓库 MuliyStudio/dsh_plugin_muliyresources，作者暮黎 Muliy（MuliyStudio）；npm 包名
dsh-plugin-muliy-resources，当前版本 0.7.0，许可证 MIT。 - 分类：社区目录 SkillHub 归为「联网工具」。
- 宿主要求：DeepSeek Harness ≥ 0.2.2-rc.1（README 标明兼容；宿主侧用到
ctx.tools与 settings 服务）；Node ≥ 22.19.0。 - 工具数量：注册 7 个工具（搜索、详情、资源页、登录、小说下载/设置、配置等）。
搜索阶段只返回候选清单（标题、分类、集数、日期、id），不抓详情、不贴资源站入口页链接；详情先汇总「获取方式 + 条数」，用户选定某一种后再只列该组最多 10 条。
支持的五种来源¶
| 来源 | 能搜到什么 | 详情侧常见能力 | 额外依赖 |
|---|---|---|---|
| 影视（pdy0 / 片库） | 电影、剧集、动漫 | 在线播放线路，百度/夸克/迅雷等网盘，磁力 | 片库账号或 Cookie（可选）；pdy0 验证码默认可 OCR |
| 短剧 | 网盘短剧 | 夸克直链、集数信息 | 无 |
| 游戏（xdgame / switch618） | PC / 主机游戏 | 网盘入口、磁力、截图 | xdgame 账号或 Cookie；switch618 需登录态解析下载页 |
| 软件 | Windows 软件 | 蓝奏云 / 网盘直链、截图 | 无 |
| 小说（SoNovel 规则） | 中文小说、多书源 | 书页、抓取入口、整本 TXT | 默认 不需要 安装 SoNovel；EPUB/PDF 可切服务模式 |
小说默认 novelMode: rules：读本机 rules/main.json，没有则从 GitHub 拉最新规则并可用内置快照；与安装 SoNovel 无关。
核心能力与交付方式¶
分段式交互¶
五类来源通用步骤：
- 搜索：自然语言如「帮我找 XXX」，或点名来源（「找部短剧」「下载小说 XXX」）。
- 选条目：助手列出候选（默认
limit8，可至 20），用户回标题或序号。 - 选获取方式：助手给出在线播放 / 网盘 / 磁力等分类及条数；用户选定后只展开该组（每组最多 10 条）。
- 交付：
- 影视 / 短剧 / 游戏 / 软件：给出单条链接，或将选中的 1–6 条导出为资源页；
- 小说：调用下载工具将整本写到本地（默认目录<当前目录>/muliy-pages/books/）。
影视在线播放需先选线路再选集，助手只返回所选单集地址，不铺整季。
单文件资源页¶
说「导出」可生成 muliy-pages/<标题>-<时间戳>.html：封面头图 + 渠道切换器，一次只显示一个渠道；生成前对分享链做失效检测（404 / 失效文案等）。页内 Pico CSS、Lucide 图标内联，无外部依赖。也可脱离 Harness 用脚本导出，例如：
node scripts/export.mjs --kind movie --id mv:56115 --title "怪奇物语 第一季"
注册工具（摘要）¶
| 工具 | 作用 |
|---|---|
muliy_resource_search |
候选清单：keyword、kind、limit |
muliy_resource_detail |
获取方式概览或展开某一组 |
muliy_resource_page |
导出单文件资源页 |
muliy_resource_login |
switch618 扫码登录并写入 Cookie |
muliy_novel_download |
整本小说下载到本地 |
muliy_novel_setup |
规则检查/更新、可选安装 SoNovel 服务 |
muliy_resource_config |
读改插件配置 |
安装与配置入口¶
安装命令以仓库 README 为准：
npx @deepseek-ai/dsh plugin --profile <你的 profile> add github:MuliyStudio/dsh_plugin_muliyresources
安装后需重启 Harness。若要锁定提交可加 #<commit>。
配置路径：侧栏 插件 → 已安装 → 暮黎资源查找 → 组件 → dsh-plugin-muliy-resources 这一行 → 配置（组合包详情页顶部无单独配置按钮）。
常用配置字段包括：movieSource（pdy / muliy）、影视与游戏的账号/Cookie、gameSource（auto / xdgame / switch618）、novelMode（rules / auto / service）、novelRulesAutoUpdate / novelRulesRefreshHours、maxResults / timeoutMs 等。也可用助手通过 muliy_resource_config 写入，例如：
{ "action": "set", "movieSource": "muliy", "movieUsername": "user", "moviePassword": "pass" }
典型用法示例¶
影视¶
用户搜「怪奇物语」→ 选「第一季」→ 助手汇报各方式条数（如夸克 103）→ 用户选「夸克」→ 从 10 条里选第 1 个 → 得链接或导出资源页。pdy0 验证码默认用 ddddocr-node；失败时可浏览器验证后把 movieCookie 填入配置。
短剧¶
搜甜宠类短剧 → 选标题 → 通常仅夸克网盘全集 → 导出资源页（含提取码）。短剧无在线播放线路。
游戏与 switch618 登录¶
搜游戏名后选版本，再选网盘或磁力。switch618 需登录态才能解析 download.php。可在设置页「switch618 扫码登录」扫码，或对助手说：
登录 switch618，验证码 123456
助手调用 muliy_resource_login 并把 Cookie 写入 game618Cookie。
小说¶
搜书名 → 选书源 → 确认下载 → 数十秒后返回本地路径。规则模式默认 16 并发、支持断点续传（8 分钟可先返回 .part.txt，同一 URL 再继续）。需要 EPUB/PDF 时将 novelMode 设为 service，或对助手说「安装小说服务」走 muliy_novel_setup。
适用场景与注意¶
适合谁：在 DSH 对话里做影视/短剧/游戏/软件/小说检索，且希望由人逐步选候选、渠道与条目，而不是模型一次性刷屏链接的智能体开发者或终端用户。
运行与信任：插件以当前 DSH 进程权限联网访问第三方站点；安装前应阅读仓库源码与 MIT 许可证，自行评估 Cookie、账号信息与外链风险。社区目录 SkillHub 插件页 与 GitHub 无 DeepSeek / 幻方官方应用商店从属关系，DSH 生态理念是「一切皆插件」，本篇介绍基于维护者公开 README 与 package.json。
常见限制（README FAQ）：部分网盘需登录态否则「没有可解析的入口」；资源页封面与截图为远程 URL，离线打开可能缺图；小说 Cloudflare 或需登录的源可能失败，可换候选书源；kind=all 默认会带上小说规则搜索，只找影视/游戏时可指定 kind 跳过。
结尾¶
暮黎资源查找把五类资源的「找 → 选 → 拿」收成统一的分段工具链，并把网盘/磁力/线路整理成可导出的单页 HTML。进一步细节见仓库 README.zh.md 与 CHANGELOG.md。
- 目录页：https://www.skillhub.cn/plugins/MuliyStudio/dsh_plugin_muliyresources
- GitHub：https://github.com/MuliyStudio/dsh_plugin_muliyresources
