leeexin/book-source-creator-skill

0 Fork 0

Files

T

Narylr 5934e806dd Add Legado repo link and 163zw example source

2026-03-19 23:12:43 +08:00

5.7 KiB

Raw Blame History

book-source-creator-skill

这是一个用于为 Legado 阅读器创建、调试和验证书源的技能仓库。

本仓库地址：https://github.com/Narylr350/book-source-creator-skill
Legado 仓库地址：https://github.com/gedoor/legado

这个 skill 已在 Codex 环境中测试成功。其他 AI 工具目前没有系统测试过。

需要什么

一个支持技能机制的 Codex 环境
可用的浏览器分析能力，核心依赖是 Browser MCP
目标小说网站 URL
如果站点需要登录，需要能由人类协助完成登录
如果要运行辅助脚本，建议有 Node.js；只看技能文档则不强依赖本地脚本
一个用于最终导入验证的 Legado 阅读器

仓库结构

book-source-creator-skill/
  README.md                     # 仓库级使用说明
  examples/                     # 示例书源
  book-source-creator/          # 技能本体
    SKILL.md
    README.md
    scripts/
    references/
    tests/

技能详细说明见 book-source-creator/README.md，技能入口说明见 book-source-creator/SKILL.md。

如何使用

把 book-source-creator/ 整个目录放到你的技能目录中即可。

常见做法示例：

~/.cc-switch/skills/book-source-creator/
~/.codex/skills/book-source-creator/

安装后，在需要为 Legado 阅读器创建、调试或验证书源时调用这个 skill。

标准流程

这个 skill 的推荐流程是：

先判断目标站点是否需要登录。
如果需要登录，优先在登录态下分析；如果登录需要扫码、验证码、短信或人工确认，应立即请求人类协助。
在写任何规则前，先输出一份“网站可生成性评估”。
再使用 Browser MCP 分析搜索、详情、目录、正文四段链路。
根据真实页面结构和请求链路生成书源。
用辅助脚本做结构校验和规则审计。
最后导入 Legado 做实际可用性验证。

网站可生成性评估模板

在正式写规则前，建议先输出：

## 网站可生成性评估
- 目标站点：
- 登录状态：
- 搜索可用性：
- 详情可用性：
- 目录可用性：
- 正文可用性：
- 特殊风险：
- 可生成性评级：
- 是否继续生成：
- 继续生成理由 / 停止理由：

允许使用的评级：

可直接生成
可生成但高风险
需登录后再评估
不建议生成

其中 需登录后再评估 和 不建议生成 不是硬阻断，但如果继续做，必须明确标记为 高风险 并说明理由。

示例

示例 1：输入

请为 https://www.163zw.com/ 创建一个 Legado 书源，并验证搜索、详情、目录和正文。

示例 2：期望执行过程

1. 判断是否需要登录
2. 输出网站可生成性评估
3. 用 Browser MCP 验证搜索入口和结果列表
4. 进入详情页，确认书名、作者、简介、封面、目录入口
5. 进入目录，确认是否分页
6. 进入正文，确认是否多页、是否有广告、是否需要拼接
7. 生成书源 JSON
8. 做结构校验和规则审计
9. 导入 Legado 实测

示例 3：163中文网书源

示例书源文件：examples/163zw-legado.json
测试站点：https://www.163zw.com/

这个仓库对应的 skill 已经实际用于 163中文网 书源生成与验证。当前这一版书源在实际检查中没有发现明显问题，但不代表站点未来不会改版。

163中文网书源创建过程

这份 163中文网 书源是按下面的流程做出来的：

先确认站点是否需要登录。163中文网 当前公开搜索、详情、目录、正文都可直接访问，所以不需要先走登录流程。
输出网站可生成性评估。结论是可生成，但正文存在单章多页、目录存在多页分页，所以应明确记录风险点。
用 Browser MCP 验证搜索链路。搜索 凡人修仙 后，确认结果列表、书名、作者、封面和详情链接都能稳定拿到。
进入详情页，确认书名、作者、简介、封面和章节列表入口。
检查目录页，确认目录首屏只有部分章节，且存在分页，因此规则中需要 nextTocUrl。
进入正文页，确认正文是真实文本而不是图片，但单章被拆成多页，因此规则中需要 nextContentUrl 来拼接同一章。
生成书源 JSON，并把目录分页和正文分页都写进规则。
用辅助脚本做结构校验和规则审计。
最后在 Legado 中实际导入检查，当前未发现明显问题。

这套流程的核心不是“先写规则”，而是“先用 Browser MCP 把站点行为看清楚，再决定规则怎么写”。

脚本说明

技能附带的脚本在 book-source-creator/scripts/：

analyze_with_playwright.mjs：辅助分析真实页面
validate_source.mjs：校验书源 JSON 结构
test_rules.mjs：审计规则风险和占位问题
generate_template.mjs：生成模板

同名 .py 文件是兼容入口，会转调到对应的 .mjs 脚本。

脚本是辅助工具，不是判断中心。如果脚本结果和真实页面表现冲突，应以 Browser MCP 看到的真实页面和请求证据为准。

测试状态

已验证：

Codex 环境下可正常使用这个 skill
Browser MCP 驱动的网站分析流程可跑通
Node 版本辅助脚本可运行
163中文网 的样例书源已经过一轮实际验证，当前未见明显问题

未验证：

其他 AI 工具中的兼容性
所有小说站点的通用成功率
所有登录态站点的行为一致性

5.7 KiB Raw Blame History Unescape Escape