Jmcomic Ai

🛠️ 开发者注意：如果你想为项目贡献代码，请务必查看 贡献指南，其中包含了开发环境搭建、项目结构说明以及 reference 参考源码库的使用方法。

---

📖 项目简介

JMComic AI 是为 JMComic-Crawler-Python 提供的 AI Skills 增强 和 MCP (Model Context Protocol) 支持。

传统的爬虫工具虽然高效，但在处理模糊需求时往往力不从心。你必须记住精确的 ID 或关键字，还要手动配置各种参数。

本项目提供两条独立的 AI 集成路线，二选一即可：

路线	技术类比	AI 怎么「理解」	AI 怎么「动手」	适用场景
🧠 Skills + CLI（推荐）	AI 的操作手册 + 工具箱	阅读 SKILL.md 获取领域知识	执行 scripts/ 下的 CLI 脚本	适合所有用户，理解深度高，可编写自定义逻辑
🔌 MCP	AI 的 USB-C 接口	阅读工具的 description	调用 MCP 标准化工具	适合不支持 Skills 规范、或需要独立部署服务的场景

[!IMPORTANT] 两条路线各自自成体系，不建议混用。Skills 路线下，AI 靠文档理解、靠脚本动手；MCP 路线下，AI 靠工具描述理解、靠工具调用动手。选择其一即可。

现在，你可以像与人交谈一样，通过自然语言来搜索、筛选并下载漫画，而无需编写任何代码。

📸 使用样例 (Usage Samples)

以下示例基于 AI 客户端（Cursor / Antigravity）

1. 下载本子并转 PDF / ZIP	2. 搜索【无修正】本子	3. 查详情 350234	4. 查询月度最多爱心前10个本子
5. 修改option配置

---

核心能力 / 你能用它做什么

不仅仅是下载，JMComic AI 能够理解复杂的上下文指令：

• 智能搜索与下载

  🤔 "帮我搜索作者 [XXX] 的作品，按浏览量排序，下载前 5 个最热门的本子。"

  🤖 Agent: 自动调用 search_album 获取列表，按 views 排序截取前 5，并发调用 download_album。

  🤔 "下载速度太慢了，帮我把图片并发数改为 50。"

  🤖 Agent: 理解意图，调用 update_option 修改 download.threading.image: 50 并实时生效。

• 模糊决策

  🤔 "我想找一些画风类似 [某作品] 的短篇故事，不要超过 3 章的。"

  🤖 Agent: 结合语义检索与元数据过滤，为你推荐并整理符合口味的阅读清单。

✨ 功能特性

• 🧠 Skills 知识注入 - 渐进式加载的技能手册、9 个 CLI 脚本和深度参考文档
• 🔌 MCP 标准集成 - 基于 FastMCP 构建，支持 stdio、SSE、HTTP 多种传输方式
• 🛠️ 全功能工具集 - 9 个核心工具 + 3 个知识资源，覆盖搜索→下载→后处理全流程
• ⚙️ 自然语言配置 - AI 可理解并动态修改 option.yml 配置
• 📊 实时进度追踪 - 下载过程通过 MCP 进度通知实时上报（MCP 路线）
• 🎯 统一 CLI - 提供 jmai / jmcomic-ai 命令行工具

---

📦 安装 (Installation)

0、Agent自主安装

把以下prompt发给agent即可

https://raw.githubusercontent.com/hect0x7/jmcomic-ai/refs/heads/master/README.md
根据这个项目readme，帮我安装jmcomic-ai的skills

1、从pypi安装

# 使用 uv (推荐)
uv add jmcomic-ai
# 或者
uv tool install jmcomic-ai

# 使用 pip
pip install jmcomic-ai

2、从源码安装

推荐使用 uv 进行依赖管理，一步到位。

# 克隆项目
git clone https://github.com/hect0x7/jmcomic-ai.git
cd jmcomic-ai

# 同步依赖环境
uv sync

---

🤔 什么是 Skills / MCP？

	Skills（推荐）	MCP
一句话	AI 的操作手册 — 把领域知识打包成文件让 AI 按需加载	AI 的 USB-C 接口 — 让 AI 调用外部工具的开放协议
AI 怎么理解	读 SKILL.md 文档	读工具的 description
AI 怎么动手	执行 scripts/ 下的 CLI 脚本	通过协议调用工具
官方资料	agentskills.io	modelcontextprotocol.io

🏗️ 架构全景：两条独立路线

graph TB
    subgraph User["👤 用户"]
        NL["自然语言指令"]
    end

    subgraph Host[

... [View full README on GitHub](https://github.com/hect0x7/jmcomic-ai#readme)