web-novel-research

Readme

# dsh-web-novel-research

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

> ⭐ 如果你觉得这个项目有用，给个 Star 支持一下，就是对我最大的鼓励。

中文网文剧情检索 Skill —— 查询网络小说的剧情梗概、后续发展、具体章节内容、角色/设定细节。**通过免费转载站实现，不依赖起点等付费平台。**

适用于 DeepSeek Harness（DSH）等支持 Skill 概念的 Agent 框架。

## 它能做什么

- 用户问「这本小说的剧情/后续/某章内容」→ 快速定位并总结
- 用户报出剧情线索（招式名/场景/角色名）→ 定位到对应章节
- 判断小说是否完结/断更，核实最新章号

## 核心方法

1. **免费转载站优先**：起点正文要订阅抓不到；部分书在番茄/书旗是免费正版，先建议用户直接看
2. **目录即索引**：先抓目录页拿全部章节标题——标题就是剧情节点（「出海」「回归」「远行」直接定位），不用逐章读
3. **按线索直搜**：用户给招式名/角色名，直接搜「书名+关键词」命中章节，不逐章扫
4. **多源交叉验证**：串台/乱码/缺章换站；完结状态至少查两站
5. **标注来源可信度**：总结按「已证实 ✅ / 从标题推断 ~」区分，不把猜测当事实

## 免费转载站清单（2026-08 实测）

| 站 | 备注 |
|---|---|
| 友友小说 youyouxs.com | 目录分页全；⚠️ 个别章节页内容串台 |
| 速读谷 sudugu.org | 章节 ID 不连续，从目录页取 |
| 69书吧 69shuba.com | 目录页可能 404，章节 URL 已知可直接用 |
| 12bz / 第一版主 | **GBK 编码**，需按 gb18030 解码；正文在子域名 |
| 飘天文学 piaotia.com | GBK；章节 URL 从目录页正则提取 |
| timotxt | 繁体，更新到最新章节，适合断更判断 |

## 已知坑（重要）

- **同名章节跨卷重复**：多卷结构的书，不同卷会出现同一章号+同名，必须「卷名+章节标题」双重确认，否则抓到别的卷
- **转载站不等于完结**：站内最新章号可能只是断更点（实测某书 12bz 收 55 章、姐妹花文学收 85 章）
- **章节页串台**：偶尔返回完全无关的书，抓完先对人物名
- **成人向内容**：只讲设定和主线，不复述露骨细节；用户求续写只给剧情版

## 安装（一句话版，推荐）

在 DSH 对话里直接说：

> 安装 https://github.com/canghai666x/dsh-web-novel-research 这个 skill

Agent 安装时会读取仓库内的 `AGENT_INSTALL.md`（给 AI 看的精确安装说明书），按步骤执行并验证。

Agent 会自动完成：clone 仓库 → 放入 skills 目录 → 加载 SKILL.md → 确认可用。全程不用手动敲命令。

**手动安装（备选）：** 将 `SKILL.md` 放入 Agent 的 skills 目录，或按框架的 Skill 加载方式引用。触发词：网文剧情/小说后续/章节内容/断更查询。

## 许可证

MIT