闲沐连环画（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（纯标准库，无第三方依赖）：
```bash
# 列出全部工具
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（默认生产端点，勿随意覆盖）。
3. 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 兜底、错误语义与排错
