Legado Book Source Generator — скилл

Q: Как поставить скилл Legado в Claude Code?

Скачайте legado-book-source-generator-*.zip со страницы релизов и положите папку в ~/.claude/skills/legado-book-source-generator/. Для Codex путь $CODEX_HOME/skills/legado-book-source-generator/.

Q: Чем отличаются два формата результата?

По умолчанию получается традиционный book-source.json, совместимый с последней версией оригинала и с сообщественным форком. Если явно выбрать сообщественный вариант, получится одиночный book-source.js, его проверяет MCP форка.

Q: Можно ли проверить уже готовый источник?

Да. В архиве есть локальный валидатор: запускается validator/run.bat, он печатает адрес, где можно импортировать источник, ввести слово и прогнать проверку.

Скилл ведет агента от адреса сайта с книгами до проверенного файла правил для приложения Legado: поиск, оглавление, текст

207 ★ репозитория
Последний коммит 17 авг. 2026

Скилл

narylr350/book-source-creator-skillАвтор:Narylr350

Установка

Работает в: Claude Code
Codex
Koda
Coddy

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/legado-book-source-generator

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

Агент ходит по сторонним сайтам через браузер, а для страниц на JavaScript ставит и запускает Java, `adb` и Android Probe и подключается к телефону
Скилл создает правила для сбора текста с сайтов с книгами, поэтому права на контент и условия сайта остаются на вас

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл `legado-book-source-generator` собирает источник книг (в Legado он называется «书源») для Android-приложения для чтения Legado. Пользователь называет адрес сайта, агент создает рабочую папку командой `node scripts/bsg.mjs init <url>`, через Browser MCP изучает реальные страницы и пишет `book-source.json`. Затем проверка проходит четыре звена: поиск, карточку книги, оглавление и текст главы. Если страница рисуется JavaScript, проверку продолжают в эмуляторе Android или на телефоне через Android Probe. Для сообщества, которое ведет форк приложения, можно сделать одиночный `book-source.js`: его проверка идет через MCP самого приложения по локальной сети или через `adb`. Отчеты о сайте, проверке и итоговый аудит лежат в `runs/<сайт>/`, а готовые файлы в `outputs/<сайт>/`. Если какое-то звено не работает, инструменты называют причину: пустой поиск, неразобранное оглавление, капча, вход, платный доступ.

Для кого. Пользователям Legado, которые хотят получить источник для своего сайта с книгами без ручного подбора правил и сразу увидеть, на каком звене он ломается.

Подходит, если

Нужен источник для сайта с книгами, и вручную подбирать правила поиска, оглавления и текста долго
Готовый источник перестал работать, и надо понять, что сломалось: поиск, оглавление или текст главы
Страница отдает текст только после JavaScript, и обычная проверка по HTTP возвращает пустое место
Для форка приложения с поддержкой JavaScript нужен одиночный файл источника, проверенный через MCP приложения

Не подходит, если

Нужен готовый сборник источников или сами книги: проект не дает ни того, ни другого
Сайт закрыт капчей, входом, платным доступом, DRM или сильной защитой: проект не обходит такие ограничения
Нужно массово собирать книги или раздавать их: проект предназначен для личного обучения и отладки совместимости
Browser MCP подключить нельзя: без него нельзя изучить страницы

Пример запроса к агенту

Сделай источник для Legado по адресу https://example.com и проверь поиск, оглавление и текст главы

Ограничения

Проект не дает готовых источников и содержимого книг. Он не обходит капчу, вход, платный доступ, DRM и Cloudflare, и результат зависит от сайта и модели агента.
Обязателен Browser MCP. Для страниц на JavaScript могут понадобиться Java, `adb`, эмулятор или телефон на Android и Android Probe.
Для варианта с JavaScript нужен форк приложения с MCP-сервисом, а совместимость такого файла с оригинальной версией не гарантирована.
В репозитории нет файла лицензии, README написан по-китайски.

Как отключить. Папку `legado-book-source-generator` удаляют из каталога скиллов агента. Android Probe удаляется с телефона или эмулятора как обычное приложение, а папки `outputs/` и `runs/` стирают вручную.

Частые вопросы

Как поставить скилл Legado в Claude Code?

Скачайте `legado-book-source-generator-*.zip` со страницы релизов и положите папку в `~/.claude/skills/legado-book-source-generator/`. Для Codex путь `$CODEX_HOME/skills/legado-book-source-generator/`.

Нужен ли Android?

Для большинства сайтов нет. Эмулятор или телефон нужны, если текст страницы рисует JavaScript и проверка по HTTP видит пустую страницу. Тогда агент подготовит `adb` и Android Probe сам и спросит вас только про права и отладку по USB.

Чем отличаются два формата результата?

По умолчанию получается традиционный `book-source.json`, совместимый с последней версией оригинала и с сообщественным форком. Если явно выбрать сообщественный вариант, получится одиночный `book-source.js`, его проверяет MCP форка.

Что делает скилл, если сайт закрыт капчей?

Фиксирует блокировку в отчете и останавливается. Скилл не обходит капчи, вход, платный доступ, DRM и Cloudflare.

Можно ли проверить уже готовый источник?

Да. В архиве есть локальный валидатор: запускается `validator/run.bat`, он печатает адрес, где можно импортировать источник, ввести слово и прогнать проверку.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

agent-fleet-manager

Скилл и движок на SQLite следят за тысячами источников по расписанию, находят изменения по хешу и ведут журнал записей.

СкиллРасширенный доступ101

Grazer

Скилл и CLI ищут посты, видео и статьи на агентских соцсетях и научных источниках и отправляют ответы после проверки.

СкиллРасширенный доступ197

Printing Press Library

Каталог из 600 с лишним готовых CLI для агентов: поисковый скилл подбирает инструмент, установщик ставит бинарник и скилл.

CLIШирокий доступ2,1 тыс.

Lemma skills

Официальный

Скиллы для кодовых агентов, которые собирают и проверяют рабочие пространства платформы Lemma с агентами и приложениями

СкиллШирокий доступ647

ok-script MCP

Официальный

MCP-сервер помогает агенту создавать и проверять Python-задачи для управления приложениями Windows и устройствами Android.

MCP-серверШирокий доступ841

recruiting-copilot

Скиллы для HR: требования к вакансии, поиск на BOSS Zhipin и Liepin, оценка резюме, интервью и реестр кандидатов

СкиллШирокий доступ117

Коротко о README

README объясняет назначение проекта и сразу оговаривает, чего он не делает. Дальше идут быстрый старт из архива, выбор формата результата, описание артефактов, список причин сбоя, отдельный валидатор, потребность в Android и Browser MCP и ответы на частые вопросы. Завершает его карта основных папок.

Бейдж для README

Исходный SKILL.md

---
name: legado-book-source-generator
description: Use when 用户要求为任意网站生成书源、生成阅读书源、分析小说站点、生成 Legado/阅读规则。强制触发词：书源、生成书源、帮我生成、book source、legado、阅读书源、小说站点分析。如果用户给出了一个 URL 并要求生成或分析，必须加载此 skill。
---

# Legado 书源生成

这是工具箱模式。先初始化，再按当前问题选择工具；不要把流程当成必须机械执行的长状态机。

```powershell
node "<skill-dir>/scripts/bsg.mjs" init <url> [--cwd <输出目录>] [--target legacy-json|community-js]
node "<skill-dir>/scripts/bsg.mjs" toolbox
node "<skill-dir>/scripts/bsg.mjs" status --run <run-dir>
```

## 先读哪些 reference

- 常规流程：读 `references/workflow.md`。
- 站点观察 / site-facts：读 `references/site-inspection.md` 和 `references/assessment-template.md`。
- 生成规则：读 `references/legado-json-structure.md`、`references/official-rule-pack.json`、`references/legado-source-behavior.md`。
- 验证失败回修：读 `references/failure-diagnosis.md`、`references/validation-policy.md`、`references/validator-integration.md`。
- Android、模拟器、登录态、WebView/WebJs、入口反爬复核：必须先读 `references/android-probe-guide.md` 和 `references/policies.md`；需要判断 Probe 与阅读 App 差异时再读 `references/webview-behavior-matrix.md`。
- 社区维护版 JavaScript 单文件书源：读 `references/community-app-mcp.md`，并从目标 App MCP 读取当前版本的 `legado://help/jsHelp`。

## 常用工具

- `status --run <run-dir>`：看当前阶段、`pendingUserAction`、`repairContext` 和下一步建议。
- `check --run <run-dir>`：检查评估、登录、Android 决策是否缺证据。
- `observe --run <run-dir> --phase <phase> --status <status> [--blocker <type>] [--render <type>] --note <evidence>`：Browser MCP 每确认一条链路就立即写入事实；入口验证码或正文签名/字体加密会关闭探查并返回 `record-assessment`。
- `source inspect --run <run-dir>`：审计传统 JSON 目标的 `book-source.json` 风险字段。
- `android --run <run-dir>`：Android 单入口；检查真机/模拟器和 Probe，必要时启动 Probe，运行 `mode=android` 验证并收敛报告。
- `android --run <run-dir> --dump-cookie <file>`：显式导出 Probe 原始 Cookie 到本地文件，供人工核对或 validator 调试；默认输出不显示 Cookie 值。
- `android-status`：只读诊断；检查 adb、真机/模拟器和 Android Probe。
- `validate --run <run-dir> [--mode http|browser|android] [--keyword <中文关键词>] [--book-url <url>]`：运行 validator，写入 `validator-report.json`。`--book-url` 跳过搜索直接从详情页开始验证（对齐阅读 debug 模式的 URL 直接入口），用于搜索被反爬阻塞但需验证后续链路的场景。
- `record-validation --run <run-dir> --status <status>`：把真实验证报告收敛成状态、能力矩阵和修复上下文。
- `debug-bundle [--run <run-dir>]`：打包状态、报告、书源和会话导出，方便复盘。
- `run --run <run-dir>`：可选的阶段助手；它会启动下一阶段，或自动记录当前目标的验证报告。
- `app-mcp status [--url <mcp-url>] [--serial <adb-serial>]`：连接社区维护版阅读 App 的原生 MCP，检查协议、版本、工具和帮助资源；唯一在线 adb 设备会自动建立临时端口转发。
- `app-mcp help-js [--url <mcp-url>] [--serial <adb-serial>]`：读取目标 App 当前版本的 `legado://help/jsHelp`；动态读取，不保存副本到 run。
- `app-mcp validate-js --source <book-source.js> --keyword <关键词> [--report <file>] [--keep-source]`：通过目标 App 原生 MCP 保存、读回、调试并校验 JavaScript 单文件书源；默认验证后删除 App 内临时书源。

Сообщить о проблеме