前言¶
在 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
