DeepSeek Harness plugin for in-conversation multi-source anime search. Aggregates results from Mikan
- Language
- TypeScript
- License
- MIT
- Branch
- main
Install
$ dsh plugin --profile web add @cocofhu/anime-findRun the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial
Install via your agent
Install the DeepSeek Harness plugin cocofhu/anime-find for me: review the repository at https://github.com/cocofhu/anime-find first, then run the install command and verify the plugin loads successfully.
Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.
One-Sentence Description
anime-find is an in-conversation anime search plugin for DeepSeek Harness Web, enabling Agents to directly display anime cards from Mikan/AniBT/AnimeGarden in replies, view magnet links, torrents, and Bangumi introductions on the same page, and even select episodes for playback directly in the conversation based on statically parsed rules.
Core Capabilities
- Multi-source aggregated search: Simultaneously calls Mikan, AniBT, and AnimeGarden, merging and displaying cards by source; single source failure doesn't block other sources
- Bangumi index completion: Auto-completes ratings, original titles, and tags for each card (direct pull if bgmId exists, otherwise search by title)
- Resource detail panel: Browse episodes by subgroup, with one-click magnet copy and .torrent download links
- Bangumi introduction and short reviews: Detail card loads introduction, rating, genre tags, and up to 5 short reviews; hides corresponding Tab when Bangumi is unavailable
- Streaming online playback: Attempts trial playback based on search results at statically parsed rule sites; rewrites HLS segment links after proxying through Host
- Smart follow-up: Recognizes commands like "any more", "show another batch", "recommend more", and automatically flips to the next batch of results
- Season awareness: When user says "this season" or "recent good ones", identifies current quarter using Asia/Shanghai timezone; supports explicit quarters like "Summer 2026" or "2026-07"
- In-plugin update check: Manually compare with GitHub official Releases in config page; provides ready-to-copy update command when new version is found
Technical Implementation
- Language: TypeScript (Host side
src/*.ts, built tolib/host.js) + JavaScript + React (Client sidesrc/client.js, built tolib/client.js, includes HLS player) - Key dependencies: cheerio (HTML parsing), hls.js (HLS playback), @deepseek-ai/dsh-tools (tool registration), @deepseek-ai/cordis (plugin injection)
- Architecture pattern: Registers
anime-findplugin ID and default config with host viacordis.patch.yml; Host sideapply(ctx, config)simultaneously injectstools(registersanime_find_searchtool),webServer(registers/anime-findproxy and cover endpoints),systemPrompt(appends segment to constrain Agent calling behavior); Client side renders cards and player in ToolView via@deepseek-ai/dsh-client-runtimeand@deepseek-ai/dsh-client-ui-slots - Entry files: Host entry
lib/client.js(package.json#exports['.']); Client entrylib/client.js(package.json#exports['./client']); build triggered bypreparescript (tsc+ resource copy)
Use Cases
Searching for anime directly in DeepSeek Harness Web conversations without switching browser tabs. Want unified answers for "what's good this season", "where are the magnet links for an anime", and "can I watch online" rather than checking each site individually. Suitable for anime enthusiasts who need regular switching between new season tracking and catching up on older series; limited value for experienced users who only want specific source sites, since this plugin doesn't host any media and users need to verify watchability of rule sites themselves.
Prerequisites and Compatibility
| Dependency | Minimum Version | Description |
|---|---|---|
| DSH Web | >= 0.1.0-rc.6 | peerDependency declares @deepseek-ai/dsh-tools (uses ^0.1.0-rc.6 during development); client needs @deepseek-ai/dsh-client-runtime and @deepseek-ai/dsh-client-ui-slots |
| Node.js | >= 22 | package.json#engines.node |
| Runtime | — | Host side runs on Node.js, no native modules needed; client browser native ESM + hls.js |
| Platform | Cross-platform | macOS/Windows/Linux all work, runtime only depends on browser and Node |
| Native modules | None | dependencies only cheerio and hls.js; no node-gyp build steps |
Installation
dsh plugin --profile web add github:cocofhu/anime-find
After installation, restart dsh web and force-refresh the page in browser.
Configuration Options
| Config | Type | Description | Default |
|---|---|---|---|
| Search sources | Multi-select | Enabled sources: Mikan/AniBT/AnimeGarden, default Mikan only | Mikan only |
| Search result limit | Number | Cards per batch; auto minimum 36 when viewing this season | 12 |
| Mikan site URL | URL | Mikan root domain, mirrors supported | https://mikanani.me |
| AniBT site URL | URL | AniBT root domain, mirrors supported | https://anibt.net |
| AnimeGarden API URL | URL | AnimeGarden API endpoint | https://api.animes.garden |
| Upstream request timeout (ms) | Number | Between 3s and 120s | 20000 |
| Request UA | String | User-Agent sent to upstream | Mozilla/5.0 (compatible; anime-find/0.1) |
| Streaming master switch | Toggle | When off, detail card hides "Streaming" Tab | Enabled |
| Streaming rules | JSON array | Statically parseable playback sources, each with at least 8 fields (name, baseURL, searchURL, searchList, searchName, searchResult, chapterRoads, chapterResult); {{keyword}} or {{query}} replaced with search keyword | Built-in xfdm (pilot source) |
Config takes effect immediately upon save, written to $DSH_HOME/anime-find.json.
FAQ
Q: What should I say in conversation to trigger anime search?
A: Any anime-related question will cause the Agent to call anime_find_search tool and output clickable cards in the reply. Saying "what good anime are there recently", "this season", "any more" will automatically expand based on current quarter (Asia/Shanghai timezone). Saying "search for Mushoku Tensei" searches by title.
Q: What can I see after clicking a card?
A: Resource list grouped by subgroup, including episode numbers, magnet links and .torrent file addresses; if the card has a Bangumi ID, details will also pull introduction, rating, genre tags, and up to 5 short reviews, all proxied on Host side and not written to the tool's message body sent to the Agent.
Q: Can I use the Streaming Tab by default? Do I need to prepare rules myself?
A: Enabled by default with one built-in pilot rule xfdm (static parsing only, no content hosting). If that site is unavailable, you can turn it off in settings or paste custom rule JSON; rules must be statically parseable with at least 8 fields: name/baseURL/searchURL/searchList/searchName/searchResult/chapterRoads/chapterResult.
Q: Must I restart dsh web after installation?
A: Yes. After installing/updating a plugin, you need to restart dsh web and force-refresh the browser; this is because the HLS player (hls.min.js) is explicitly registered by Host and can only be loaded by ToolView after refresh.
Q: Do I need to restart after changing config? Where is the file saved?
A: No restart needed, takes effect on save. Config written to anime-find.json in Harness user directory (~/.dsh/anime-find.json when $DSH_HOME unset, DSH_HOME takes priority). Version and install source are read-only fields and won't be written to this file.
Q: What to do if "Player cannot load this episode" appears?
A: This episode has no playable address parsed or the source site has restrictions. You can switch to other sources in the same tab, or directly open the source site page to watch; when rule parsing is limited, the Streaming Tab will auto-hide but won't affect introduction and resource browsing.
Q: Will data be sent to the model or uploaded to the cloud?
A: No. Search requests are sent from the plugin to respective source sites (Mikan/AniBT/AnimeGarden); Bangumi introductions/short reviews are proxied by Host and only rendered to UI, not written to the tool message body sent to the Agent; config file only exists locally.
Q: How to update to the latest version?
A: Manually click "Check for Updates" in the plugin settings page under "Version & Updates" section. When a new version is found, follow the prompts to execute dsh plugin --profile web update anime-find in terminal, then restart dsh web and force-refresh browser; no auto-check, no pre-release/draft Releases used. This command won't show for local link: or file: installs.
Learning Curve
Beginner — Use with natural language in conversation, config options have reasonable defaults, can immediately search for anime and view magnet links without writing rules; custom streaming rules require understanding CSS/XPath selectors and JSON field conventions, corresponding to "intermediate" effort.
Known Issues and Limitations
- Streaming rules in initial release don't support scripts, functions, text matching, or other dynamic XPath predicates; no page JavaScript or WebView interception executed; initial release won't auto-sync community rule repository
- When a single episode cannot play or 0 playable addresses are parsed, it won't fall back to other links for the same episode; detail card will show "Player cannot load this episode" or hide the entire Streaming Tab
- Bangumi short reviews come from
next.bgm.tv/p1non-public API, may change or go offline; failure only hides the short reviews Tab, doesn't affect introduction and resource browsing - Single source failure won't interrupt other sources, but plugin won't auto-retry; when AniBT/AnimeGarden are enabled but domains are unreachable, search results will significantly decrease (default Mikan only)
- Pagination results depend on source site returning enough resources; when this season results are few, manually increase result limit or enable other sources in settings
dsh plugin updatecommand only works for GitHub sources; update check still works for locallink:orfile:installs, but won't provide copyable update command

DeepSeek Harness 搜番插件。在对话中搜索番剧,以可点击卡片展示结果,并在详情面板中查看字幕组、磁力链接和种子文件。
功能
- 聚合 Mikan、AniBT 和 AnimeGarden
- 在对话流中展示番剧封面、标题、评分、格式和资源数量
- 根据 Asia/Shanghai 时区识别当前新番季度
- 支持「还有吗」「换一批」等追问并分页展示更多结果
- 点击卡片后按字幕组和集数浏览资源,并可查看 Bangumi 介绍、评分和短评
- 支持复制磁力链接和打开
.torrent文件 - 可选流媒体 Tab:按搜索结果显示用户规则解析出的可播源,并在同页选集播放
- 可在 Harness 插件设置中启用来源、调整结果数量和站点地址
- 在插件设置中查看当前版本,并手动检查 GitHub 正式 Release
环境要求
- Node.js 22 或更高版本
- DeepSeek Harness Web
安装
从 npm 安装:
dsh plugin --profile web add @cocofhu/anime-find
本地开发:
dsh plugin --profile web add /absolute/path/to/anime-find
安装后重启 dsh web,并强制刷新浏览器页面。不要用 github:cocofhu/anime-find 或无前缀的 anime-find 安装:git 源会跑 prepare;旧包名已迁到 @cocofhu/anime-find。
使用
可以直接对 Agent 说:
搜一下无职转生,看看有没有磁力
最近有哪些好看的动漫
还有吗
插件向 Agent 提供 anime_find_search 工具。搜索完成后,对话中会显示可点击卡片;点击卡片即可查看字幕组与下载资源。
资源详情
按字幕组浏览集数、复制磁力链接或打开种子文件:

流媒体播放
在详情中切换到流媒体,选择剧集后可在对话中直接播放:

配置
打开 设置 → 插件 → 插件配置 → 搜番:
- 搜索源:默认仅启用 Mikan,可选 AniBT 和 AnimeGarden
- 搜索结果上限:每批返回的卡片数量
- 站点地址:各来源的服务地址,可按需替换镜像
保存后立即生效。用户配置落在 Harness 用户目录 $DSH_HOME/settings.yaml 的 anime-find: 段(由 dsh 设置服务原子写入)。版本与安装来源为只读信息,不会写入该段。
从旧版升级时,若仍存在 $DSH_HOME/anime-find.json 且 yaml 中尚无该用户段,插件会把 json 导入 anime-find: 后将原文件改名为 anime-find.json.bak;若 yaml 里已有用户配置则跳过导入,仍只改名备份,之后不再读取 json。
流媒体播放
流媒体默认开启,并内置一条可静态解析的试点规则(xfdm)。打开 设置 → 插件 → 插件配置 → 搜番
可关闭总开关、启停或替换规则 JSON。规则须为可静态解析的 CSS 或受限 XPath 子集,至少包含
name、baseURL、searchURL、searchList、searchName、searchResult、chapterRoads
和 chapterResult。{{keyword}} 或 {{query}} 会替换为搜索关键词。
播放地址支持两种取法:playURL 既可以是指向 src/href 的选择器,也可以写成
script:player_aaaa.url,从播放页内联脚本对象里读取(MacCMS 站点常用,按同级
encrypt 字段自动处理 URL 编码或 base64)。
当媒体位于站点之外的 CDN 时,用 mediaHosts 显式声明这些域名,只有声明过的域才会
被解析和代理放行;私网、回环和链路本地地址始终拒绝。
mediaHeaders 只作用于媒体请求,值留空表示不发送该头。同一站点的不同 CDN 要求可能
相反(有的必须带 Referer,有的带了就报错),所以键名含点时视为域名,其下的头只对该
域及其子域生效:
{
"mediaHosts": ["cdn-a.example", "cdn-b.example"],
"mediaHeaders": { "cdn-b.example": { "referer": "" } }
}
流媒体 Tab 只显示已解析出剧集的源;单集不能播放时可换源或打开源站。媒体请求仅会代理到
已启用规则的域名及其声明的 mediaHosts(HLS playlist 会重写分片链接),不提供开放代理。首期不支持依赖
Kazumi WebView 拦截的动态规则,也不会自动同步社区规则仓库。受限 XPath 支持常见的
//tag、层级、序号、属性与属性包含谓词;脚本、函数和文本匹配谓词仍不支持。插件不托管任何内容,请仅
访问你有权观看的内容并遵守来源站点条款。
也可通过 cordis.patch.yml 设置默认来源:
- id: anime-find
config:
sources: [mikan]
数据与网络
启用某个来源后,插件会向对应站点发送搜索和详情请求。封面通过插件服务转发,配置仅保存在本机,不会写入仓库。
详情卡在有 Bangumi subject ID 时,会通过 Host 使用插件配置的 User-Agent 和超时设置请求 Bangumi 条目信息;介绍、评分和基础信息来自公开 v0 API。短评由 Host 代理 Bangumi 的非公开 p1 接口,最多展示 5 条。该接口可能变更或不可用,届时短评 Tab 会自动隐藏,不影响介绍和资源浏览;本期不使用 HTML 抓取后备。
Bangumi 的介绍和短评只在用户点击详情卡后加载和渲染,不会写入提供给模型的工具正文。
请遵守来源站点的使用条款,并仅将下载能力用于你有权访问的内容。
版本与更新
在 设置 → 插件 → 插件配置 → 搜番 的「版本与更新」区块中,可手动检查 GitHub 上的最新正式 Release。打开设置页不会自动检查,也不会使用预发布版或草稿 Release。
发现新版本时,保留显示以下官方命令供参考。点击「更新」并确认后,插件会自动使用
当前 profile 执行该命令、拉起新的 dsh web(可能使用不同端口),然后自动跳转到新
地址:
dsh plugin --profile web update @cocofhu/anime-find
当前以 link: 或 file: 本地方式安装时,页面仍会显示版本对比,但禁止自动更新,
以免覆盖开发环境。若仓库尚未发布正式 Release,检查结果会显示「暂无可用 Release,无法判断是否有更新」。
开发
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build
源码位于 src/,构建结果输出到 lib/。lib/ 不提交到版本库,安装或发布时由 prepare 脚本生成。
Harness + MiniMax 中国站验收
使用隔离的 DSH_HOME 部署本地插件时,需要先为 Harness 注册模型提供方;否则 Web 首次引导无法创建会话,也无法触发 anime_find_search 和 ToolView。密钥只通过环境变量传入,不要写入仓库或 settings.yaml:
export MINIMAX_KEY_CN='...'
export DSH_HOME="$(mktemp -d)"
mkdir -p "$DSH_HOME"
cat >"$DSH_HOME/settings.yaml" <<'EOF'
llm-pi-ai:
providers:
minimax-cn:
apiKeyEnv: MINIMAX_KEY_CN
api: openai-completions
baseURL: https://api.minimaxi.com/v1
models:
- id: MiniMax-M3
EOF
npx @deepseek-ai/dsh web
随后在 设置 → 模型 选择 minimax-cn / MiniMax-M3,并从另一个终端安装本地插件:
DSH_HOME="$DSH_HOME" npx @deepseek-ai/dsh plugin --profile web add /absolute/path/to/anime-find
在新会话中请求搜番,确认工具视图的「流媒体」Tab、可播源卡片、选集和播放器路径。该配置仅用于验收;流媒体规则和任何第三方站点授权仍须由测试者自行提供。
故障排查
- 页面停在 Loading plugins:确认
pnpm build成功,重启dsh web后强制刷新 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED:改用 npm 安装dsh plugin --profile web add @cocofhu/anime-find,不要走 git 源或旧包名anime-find- loader 报
requires options.id或requires options.key:settings.plugin.item在部分 Harness 版本是 list slot(要id),在 rc7 起是 keyed slot(要key)。客户端必须同时注册id和key;Host 通过installSettingsSection登记anime-find命名空间后才会分发配置卡 - 搜番卡片未出现:开启新对话,并确认
anime_find_search已加载 - 本季结果较少:提高结果上限,或在设置中启用 AniBT / AnimeGarden
- 来源请求失败:检查网络与对应站点地址;单个来源失败不会阻止其他来源返回结果
参与贡献
提交 Issue 或 Pull Request 前请阅读 CONTRIBUTING.md。安全问题请按 SECURITY.md 私下报告。
许可证
Read the usage guide →
Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.
Listing badge
[](https://deepseek-plugin.org/plugins/cocofhu/anime-find)Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.