JMComic Downloader — Development skill for Claude Code

JMComic 下载器 · JMComic_downloader

把 [JMComic-Crawler-Python](https://github.com/hect0x7/JMComic-Crawler-Python)（`jmcomic`）包装成**三种好用的形态**：一个能直接双击运行的 Windows 窗口程序、一个给 AI Agent 用的 skill、一个返回 JSON 的命令行工具。三者共用同一套下载引擎和配置。

本项目只是 `jmcomic` 的外壳（wrapper），下载能力全部来自上游库。请遵守所在地区法律，并尊重目标站点的访问频率限制。

---

它能做什么

能力	说明
按车号下载	输入 438696 / JM438696 / 完整 18comic 链接都能识别；支持一次填多个
整本 / 单章	「整本」下载全部章节，「单章」只下指定章节
元数据查询	标题、作者、标签、作品、角色、页数、发布时间、观看/点赞/评论数、章节列表
搜索	站内搜索、按标签 / 作品 / 角色搜索，支持分类、副分类、时间范围、排序
排行榜	日榜 / 周榜 / 月榜，以及任意分类组合
评论	本子评论（含回复）和全站最新评论
导出	下载后自动生成 PDF、ZIP、长图 PNG
断点续传	已下载的图片自动跳过，重新点一次就能续
代理	支持 HTTP 代理，可在界面里直接填

**不包含**：收藏夹、每日签到、收藏夹导出等需要登录的功能。需要时请自行配置 `option.yml` 里的 `login` 插件（见[配置](#配置)）。

---

三种用法

方式一：双击 exe（推荐给普通用户）

从 [Releases](https://github.com/NanNank0/JMComic_downloader/releases/latest) 下载 `jmcomic-downloader.exe`。它是一个独立文件，**不需要装 Python，也不需要装 jmcomic**——运行所需的一切都已经打包进去了。

1. 双击 jmcomic-downloader.exe
2. 在「车号 / 链接」里输入号码，例如 438696
3. 按 回车 或点「开始下载」
4. 下载完成后在「日志」区看到保存路径

首次启动约 3–5 秒（需要把内置的运行环境解压到临时目录），之后正常。

Windows 首次运行可能弹出 SmartScreen 提示（因为没有代码签名）。点「更多信息」→「仍要运行」。

方式二：给 AI Agent 用（DSH / Codex / Claude Code）

本项目就是一个标准 skill 目录，能被任何读取 `SKILL.md` 的 agent 加载：

# 默认装到 ~/.agents/skills（DSH 和 Codex 都会扫描这个目录）
python scripts/install.py

# 或者装到你需要的所有位置
python scripts/install.py --target agents dsh codex claude

装完**新开一个会话**，agent 的技能列表里就会出现 `jmcomic`。之后你可以直接对 agent 说：

帮我查一下 JM438696 的信息 搜一下 MANA 的无修正本子，下载第一本并导出 PDF

Agent 会自己调用 `scripts/jmctl.py`。想卸载：

python scripts/install.py --uninstall --target all

方式三：命令行 / 自动化

python scripts/jmctl.py info 438696                 # 查元数据
python scripts/jmctl.py search "MANA"               # 搜索
python scripts/jmctl.py rank --period week          # 周榜
python scripts/jmctl.py download 438696 --export pdf  # 下载 + 导出 PDF

每个命令都**只往 stdout 输出一个 JSON 对象**，日志走 stderr，方便被脚本或程序消费。

---

安装

用 e