将本子加入当前登录账户的收藏夹，需要有效的登录会话或 Cookie。 本子已在收藏中时返回 error，且不会改变收藏状态。

参数: album_id: 本子 ID，也支持 JM 前缀或本子链接。

返回: status: "success" 或 "error"。 album_id: 本子 ID，成功解析后为纯数字字符串。 title: 本子标题，未能读取时为空字符串。 message: 上游结果消息或错误说明。

浏览、过滤、排行本子，支持灵活的分类、时间范围和排序选项。

该工具结合了分类浏览和排行榜功能，支持：

• 浏览特定分类（同人、韩漫等）。

• 按时间范围过滤（今天、本周、本月、全部）。

• 按不同标准排序（点赞、观看、最新、图片数、评分、评论数）。

参数: category: 分类过滤器。可选值： - "all" 或 "0": 全部分类 - "doujin": 同人 - "single": 单本 - "short": 短篇 - "hanman": 韩漫 - "meiman": 美漫 - "doujin_cosplay": Cosplay - "3D": 3D - "another": 其他 - "english_site": 英文站 (默认值: "all")

time_range: 时间范围过滤器。可选值：
    - "all": 全部时间
    - "day" 或 "today": 今天
    - "week": 本周
    - "month": 本月
    (默认值: "all")

order_by: 排序方式。可选值：
    - "latest": 最新更新
    - "likes": 最多点赞
    - "views": 最多观看
    - "pictures": 最多图片
    - "score": 评分最高
    - "comments": 评论最多
    (默认值: "latest")

page: 页码，从1开始（默认值: 1）

返回: 包含以下内容的字典： - albums: 本子简要信息列表 (id, title, tags, cover_url) - total_count: 结果总数 - error: 如果参数无效，则包含错误信息（可选）

注意：该 API 不包含详细统计数据（点赞/观看/作者）。
      请使用 get_album_detail() 获取特定本子的完整信息。

示例: # 1. 获取本月点赞排行 (月榜) browse_albums(time_range="month", order_by="likes")

# 2. 浏览同人志分类 (最新)
browse_albums(category="doujin", order_by="latest")

# 3. 浏览本周热门韩漫 (特定分类排行榜)
browse_albums(category="hanman", time_range="week", order_by="views")

分页浏览已登录账户的收藏，返回轻量本子摘要。

参数: folder_id: 收藏夹 ID，"0" 表示全部收藏（默认值："0"）。 page: 页码，从 1 开始（默认值：1）。 order_by: 排序方式，favorite_time 按收藏时间、update_time 按更新时间 （默认值：favorite_time）。 username: HTML 客户端仅配置 Cookie 时必须提供用户名；通过 login 登录后可省略。 API 客户端忽略此参数，始终查询当前登录账户。

返回: albums: 本子摘要列表，包含 id、title、tags、cover_url。 total_count: 收藏总数。 page: 当前页码。 folder_id: 查询的收藏夹 ID。 error: 页码、收藏夹 ID 或排序参数无效时的错误信息（可选）。

取消当前登录账户对本子的收藏，需要有效的登录会话或 Cookie。 本子未在收藏中时返回 error，且不会改变收藏状态。

参数: album_id: 本子 ID，也支持 JM 前缀或本子链接。

返回: status: "success" 或 "error"。 album_id: 本子 ID，成功解析后为纯数字字符串。 title: 本子标题，未能读取时为空字符串。 message: 上游结果消息或错误说明。

在后台下载整个本子。

这是一个阻塞操作，会等待下载完成后返回。 下载进度会通过日志和 MCP Context（如果可用）实时报告。

参数: album_id: 要下载的本子 ID (例如 "123456") ctx: MCP Context，用于实时报告进度和日志（由 FastMCP 自动注入）

返回: 包含以下内容的字典： - status: "success" 或 "failed" - album_id: 本子 ID - title: 本子标题 - download_path: 下载目录的绝对路径 - duration: 下载调用总耗时（秒） - image_paths: 实际下载或命中缓存的图片绝对路径 - export_files: 下载插件生成的文件路径，按扩展名分组 - task_id: 本次 MCP 下载调用的任务 ID - log_path: 本次调用专属日志文件的绝对路径 - error: 如果失败则包含错误信息

下载特定本子的封面图片。 默认保存到下载目录下的 'covers' 子目录，也可以指定输出目录。

参数: album_id: 本子 ID (例如 "123456") output_dir: 可选的封面输出目录；省略时使用默认的 'covers' 子目录。

返回: 包含保存路径的成功消息。

下载本子中的特定章节。

参数: photo_id: 要下载的章节 ID (例如 "123456") ctx: MCP Context，用于实时报告进度和日志（由 FastMCP 自动注入）

返回: 包含以下内容的字典： - status: "success" 或 "failed" - photo_id: 章节 ID - image_count: 下载的图片数量 - download_path: 下载目录的绝对路径 - duration: 下载调用总耗时（秒） - image_paths: 实际下载或命中缓存的图片绝对路径 - export_files: 下载插件生成的文件路径，按扩展名分组 - task_id: 本次 MCP 下载调用的任务 ID - log_path: 本次调用专属日志文件的绝对路径 - error: 如果失败则包含错误信息

获取本子的一页评论，包括递归回评和剧透标识。

参数: album_id: 本子 ID (例如 "302820")。 page: 评论页码，从 1 开始（默认值：1）。

返回: 包含以下内容的字典： - album_id: 本子 ID - page: 当前页码 - page_size: 每页主评论数量 - total: 全部分页的主评论总数；不可用时为 null - page_count: 总页数；不可用时为 null - comment_count: 当前页主评论与所有层级回评总数 - comments: 评论列表，每条评论包含 replies 和 is_spoiler

获取特定本子的详细信息。

参数: album_id: 本子 ID (例如 "123456")

返回: 包含详细信息的字典：id, title, author, likes, views, tags, actors, description, chapter_count, update_time, cover_url。

获取已登录账户的收藏夹目录。

参数: username: HTML 客户端仅配置 Cookie 时必须提供用户名；通过 login 登录后可省略。 API 客户端忽略此参数，始终查询当前登录账户。

返回: folders: 收藏夹列表，每项包含字符串 id 和 name；无收藏夹时为空列表。 查询全部收藏时使用 folder_id="0"，该值不一定出现在目录中。

获取全站最新发布的一页评论，包括评论所属本子、递归回评和剧透标识。

参数: page: 评论页码，从 1 开始（默认值：1）。

返回: 包含当前页码、分页总数、评论数量和评论列表的字典。 HTML 客户端不提供 total 和 page_count，此时对应字段为 null。

登录 JMComic 账户以访问更多功能（如收藏夹、高级内容等）。 登录后的会话 Cookie 会自动保存，供后续请求使用。

参数: username: 用户名 password: 密码

返回: 登录成功或失败的消息。

对已下载的本子进行后处理（生成 Zip、PDF 或长图）。

参数: album_id: 要处理的本子 ID。 process_type: 后处理类型，可选值为 "zip", "img2pdf", "long_img"。 params: 后处理参数字典。支持： - dir_rule: 输出路径规则。格式: {"rule": "Bd/{Atitle}.zip", "base_dir": "D:/Comics"}。 - delete_original_file: 布尔值，处理完成后是否删除原始文件。

返回: 包含以下内容的字典： - status: "success" 或 "error" - process_type: 后处理类型 - album_id: 本子 ID - output_path: 输出文件/目录的绝对路径 - output_paths: 插件实际生成的全部文件绝对路径 - is_directory: 输出是否为目录 - message: 成功或错误消息

搜索本子，支持高级过滤选项。

参数: keyword: 搜索关键词（支持本子ID、标题、作者、标签等）。 page: 页码，从1开始（默认值：1）。 main_tag: 搜索范围 - 0 (站内), 1 (作品), 2 (作者), 3 (标签), 4 (角色)（默认值：0）。 order_by: 排序方式，与 browse_albums 词汇一致。可选值： - "latest": 最新更新 - "likes": 最多点赞 - "views": 最多观看 - "pictures": 最多图片 - "score": 评分最高 - "comments": 评论最多 （默认值："latest"）。 time_range: 时间过滤，与 browse_albums 词汇一致。可选值： - "all": 全部时间 - "day" 或 "today": 今天 - "week": 本周 - "month": 本月 （默认值："all"）。 category: 分类过滤 - "all" 或具体的 CID（默认值："all"）。

返回: 包含以下内容的字典： - albums: 本子信息列表。 - total_count: 结果总数。 - error: 如果 order_by / time_range 参数无效，则包含错误信息（可选）。

更新 JMComic 配置并保存到文件。

重要提示：此工具仅执行有限的验证。 在调用此工具之前，建议先查看以下资源了解 JmOption 语法：

• jmcomic://option/schema: 参数类型和结构约束。

• jmcomic://option/reference: 字段详细说明和示例。

参数: option_updates: 要合并的配置更新字典。 支持对 client、download、dir_rule 等进行嵌套更新。

返回: 包含文件路径的成功消息，或错误消息。

示例: option_updates = { "client": {"impl": "api"}, "download": {"threading": {"image": 50}} }