@dsh-external/dsh-bangumi

使用方法

1. 打开面板

启动 DSH Web 后，左侧边栏顶部（新会话/记忆系统入口附近）点击「追番」图标进入独立页。面板含四个标签页：

• 订阅：当前订阅列表，每行显示番名、总集数与本地集数进度条、缺集号；可一键退订
• 日历：按日期查看最近一周哪些番更新第几集
• 搜索：输入番名关键词 → 候选列表（含匹配度与本地已有集数）→ 点「订阅」；也可直接查某部番的种子候选（标注本地缺哪些集），逐条加下载
• 设置：qBittorrent 连接参数、媒体库目录、轮询间隔等；保存后立即生效，无需重启

2. 订阅一部番

1. 搜索页输入番名（中日文皆可，如「葬送的芙莉莲 / フリーレン」）
2. 从候选里选中最匹配的条目（已完结的番会优先拉整包资源）
3. 点「订阅」——插件自动从 RSS 源判新：连载番只补最新缺集，完结番一次拿全集
4. 之后每 30 分钟自动轮询新集（可在设置里改间隔），下载自动进 qBittorrent 并按「分类根/作品/季」归类

3. 直接加种子

有具体磁链或想指定资源时：搜索页找到条目后展开种子列表，选匹配的磁链下载（自动套用番剧分类目录）。

4. LLM 对话中使用

在 DSH 对话里可直接调用内置工具，例如：

• bangumi_lookup 某番名：返回该番完整资料卡（封面/简介/已放送/本地下载进度/缺集）
• 「订阅 xxx」→ bangumi_subscribe
• 「xxx 下到哪了」→ bangumi_progress / bangumi_list
• 「这周有什么更新」→ bangumi_calendar
• qBittorrent 连接/下载管理 → qb_status / qb_configure / qb_add_torrent

4. LLM 对话中使用

在 DSH 对话里可直接调用内置工具，例如：

• bangumi_lookup 某番名：返回该番完整资料卡（封面/简介/已放送/本地下载进度/缺集）
• 「订阅 xxx」→ bangumi_subscribe
• 「xxx 下到哪了」→ bangumi_progress / bangumi_list
• 「这周有什么更新」→ bangumi_calendar
• qBittorrent 连接/下载管理 → qb_status / qb_configure / qb_add_torrent

配置

优先级：环境变量 DSH_BANGUMI_* → ~/.dsh/dsh-bangumi.json → 默认值。设置页写入后 reloadRuntime 立即生效，无需重启。

键	默认	说明
qbUrl	http://127.0.0.1:8080	qBittorrent WebUI
qbCategory / qbTags	bangumi	下载分类 / 标签
qbCategoryRoot	番	番剧分类根（按需改成自己的分类体系）
qbBaseDir	源码默认路径	番剧保存根目录（作品目录建在其下）
pollIntervalMinutes	30	判新轮询间隔
minMatchScore	60	种子最低匹配分
rssIgnoreDays	3	判新回看窗（天），0=不限（慎用）