闲沐连环画（xianmu-comics）

把中国经典连环画（小人书）变成对话里可看、可听、可聊、可付费的内容服务。本技能与 https://www.wwzu.com/mcp 的 MCP 服务功能完全一致（同一端点、同一 Key、同一计费），让没有 MCP 配置能力的智能体也能直接使用全部 11 个工具。

服务速览

端点：https://www.wwzu.com/mcp（Streamable HTTP），认证 Authorization: Bearer xm-你的Key
内容规模：568 部连环画 / 56073 页 / 14171 个角色（5690 个可 AI 对话）/ 105 个标签
门户：服务介绍 · 接入文档 · Key 管理 · 计费

开始前：确认 API Key

调用任何工具前都需要一把 xm- 开头的 API Key（环境变量 XIANMU_API_KEY）。检测到没有 Key 时，按以下顺序引导用户（详细步骤与对客话术见 references/workflows.md 第 A 节）：

对话内开通（首选，约 60 秒）：请用户提供邮箱 → POST https://www.wwzu.com/api/auth/send-code （{"email":"…"}）→ 用户把邮箱里的 6 位验证码告诉你 → POST https://www.wwzu.com/api/auth/login （{"email","code"}，邮箱不存在会自动注册并送 30 积分）→ 用返回的 data.token 调 POST https://www.wwzu.com/api/mcp/keys 创建 Key。若该端点返回 404（尚未部署），回落到方式 2。
浏览器兜底：请用户打开 wwzu.com/login.html （邮箱验证码一步注册+登录）→ wwzu.com/mcp-keys.php 点"创建 Key"→ 把显示的明文 Key 粘贴给你。提醒用户：Key 明文仅展示这一次，当次复制保存。
持久化：拿到 Key 后，征得用户同意再写入环境变量（macOS/Linux 写 ~/.bashrc 或 ~/.zshrc 的 export XIANMU_API_KEY=xm-…；Windows 用 setx XIANMU_API_KEY "xm-…" 并提醒重开终端生效）。 任何时候都不要在回复中回显完整 Key，展示时只显示前 4 后 4（如 xm-a1…f3）。

注意：已有账号走对话内登录会轮换其 remember_token（旧网页登录态失效），引导时向用户说明。

调用方式（按优先级三选一）

客户端已配置 xianmu-comics MCP：会话里已有本服务的 MCP 工具（名称形如 mcp__xianmu-comics__*）→ 直接调用，跳过本技能的脚本调用。
本技能脚本（推荐）：调用本文件所在目录下的 scripts/xianmu_mcp.py（纯标准库，无第三方依赖）：
```
# 列出全部工具
python scripts/xianmu_mcp.py tools

# 调用工具：参数是一个 JSON 对象；参数含引号时建议从 stdin 传入
python scripts/xianmu_mcp.py call get_site_overview '{}'
python scripts/xianmu_mcp.py call get_comic '{"comic_id":"17763369151688","page_limit":5}'
echo '{"comic_id":"17763369151688"}' | python scripts/xianmu_mcp.py call get_comic -
```
脚本自动完成 MCP 握手/会话/响应解析（含 SSE），工具结果文本打印到 stdout，诊断信息走 stderr。退出码：0 成功；1 传输/协议/配置错误（stderr 有原因，401/429 已翻译成人话）；2 工具业务错误（isError=true，stderr/stdout 有服务端原因）。环境变量：XIANMU_API_KEY（必填）、 XIANMU_MCP_URL（默认生产端点，勿随意覆盖）。
curl 兜底（无 Python 环境时）：按 references/api.md 手写 JSON-RPC 三步握手。

工具路由表（11 个）

内容层 5 个（每日额度内免费：普通 100 次/Key、VIP 300 次）：

| 用户意图 | 工具 | 关键点 | |---|---|---| | 站点有什么/有哪些类目 | get_site_overview | 无参数；返回统计 + 全部标签目录（105 个） | | 找书/按标签逛/看榜单/相关推荐 | browse_comics | 四模式互斥：query 搜索 / tag 标签 / ranking(favorites|rating|hot) / related_to，一次只传一个 | | 看某本书/翻页/看单页 | get_comic | comic_id 必填；未解锁自动给前 20 页预览+解锁报价+梗概语音；解锁后给全量页图+逐页朗读+文字；page=N 单页三件套 | | 找角色/某书角色表/随机来一个 | search_characters | query/character_ids/comic_id/random 互斥；基础档案免费 | | 和角色聊天 | chat_with_character | character_id+message(≤500 字)；免解锁，1 积分/条 |

计费层 6 个（全部免费调用、不占每日额度）：

| 用户意图 | 工具 | 关键点 | |---|---|---| | 查积分/VIP/书架/套餐 | get_account | 返回 packages（积分套餐）、vip_plans（VIP 套餐）、unlocked_comics | | 解锁这本书 | unlock_comic | method='alipay' 返回订单码（免费会员唯一通道）；method='points' VIP 专享扣分 | | 付了吗/到账没 | check_payment | 传 order_no 轮询；不传查最近一笔待确认单；自动履约 | | 充积分 | recharge_points | package_key 如 p100/p500/p1000；返回订单码 | | 开通/续费 VIP | purchase_vip | plan_key='monthly'(¥9.9) / 'quarterly'(¥29.7)；返回订单码 | | 额度用完了想立刻继续 | reset_daily_quota | 扣 100 积分立即清零今日计数 |

工具入参/返回字段的完整说明见 references/tools.md；各业务流程的逐步操作与对客话术见 references/workflows.md。

价格与额度口径（转述给用户时必须准确）

免费层：所有内容工具解锁态自适应——未解锁也能看基础信息、前 20 页预览、听梗概语音； 4 个查询工具每日 100 次/Key（VIP 300 次），次日自动恢复
按部买断：¥1.9 / ¥2.9 / ¥4.9（按页数分档），解锁后永久可读，无订阅
AI 角色对话：1 积分/条，免解锁，与官网同价同账本
积分：100 分 = ¥1 平价直充（p100/p500/p1000/p3000/p5000），VIP 充值额外加赠 10%；积分解锁/下载高清资源包为 VIP 专享
VIP：月卡 ¥9.9（赠 1200 积分）/ 季卡 ¥29.7（赠 3600 积分），支付到账即赠分并顺延有效期， 无自动续费；权益：每日额度 300 次、每月赠 1200 积分、充值加赠 10%、积分解锁/下载专享、签到双倍积分
收款通道：支付宝订单码是唯一线上收款方式；支付结果一律用 check_payment 轮询确认

示例提示词（题材多样，均可在真实内容上命中）

把用户的自然表达路由到对应工具组合：

| 示例 | 主工具 | |---|---| | "帮我找几本聊斋志异题材的连环画，挑一本讲讲梗概，再放一段梗概语音" | browse_comics → get_comic | | "《画皮》讲的是什么？先给我看前几页" | get_comic（画皮 comic_id=17763369151688） | | "我想和聂小倩聊聊她的故事" | search_characters("聂小倩") → chat_with_character（character_id=9574） | | "找评分最高的岳飞题材连环画，让岳飞给我讲讲精忠报国" | browse_comics → search_characters（岳飞 character_id=68） → chat_with_character | | "白蛇传这本书值不值得解锁？给我看看前面的预览和报价" | browse_comics(query=白蛇传) → get_comic | | "你们一共有多少部连环画？收藏榜前十是哪些？" | get_site_overview / browse_comics(ranking=favorites) | | "《画皮》不错，帮我解锁完整版，我用支付宝扫码付" | unlock_comic(method='alipay') → check_payment | | "VIP 有什么权益？直接帮我用月卡开通" | get_account（看 vip_plans） → purchase_vip('monthly') → check_payment |

智能体行为准则

付费引导照转述：响应里的 unlock_quote / unlock_hint / nudge / preview_note / how_to_unlock / next_step / resource_pack 字段是给用户看的话术与数字（已读进度、单价锚、推荐方式），请转述或按其推荐动作推进，不要丢弃、不要编造替代。
二维码必须内嵌显示：qr_code_image 是服务端生成的正方形 PNG data URI，直接放进 <img src="…"> 即可 1:1 显示；严禁把它存成本地文件再用路径引用，qr_code 链接只作兜底。
支付闭环：下单后主动（或提示用户要求时）用 check_payment(order_no=…) 轮询，通常数秒到账； paid=true 后按返回的 next_step 继续（解锁交付/积分入账/VIP 生效）。
解锁后进入"漫剧模式"：已解锁的 get_comic 返回逐页 audio_url 与 reading_guide—— 按指引逐页展示图片并自动播放朗读，翻页播讲，这是本服务最核心的体验。
错误处理：脚本退出码 1 时先读 stderr（401=Key 失效→引导重建；429=额度尽→推荐 reset_daily_quota 或次日再用；404=URL/会话问题）；退出码 2 为工具业务错误（如积分不足，服务端已给出差额与套餐引导，照转述即可）。
内容合规红线：书页图片与音频仅供即时展示/播放，禁止批量下载、转存或二次分发；给用户展示时使用响应中的站点直链，不要转存代理。
comic_id 口径：对外一律用官网 htmlname（如 17763369151688），结果都带 web_url 可引导用户去官网详情页；入参也兼容内部数字 ID。

参考文件

references/tools.md — 11 个工具的完整入参/返回字段/互斥规则与示例
references/workflows.md — Key 开通、找书阅读、解锁支付、充值、VIP、角色对话全流程与对客话术
references/api.md — MCP 直连协议细节、curl 兜底、错误语义与排错