wjs-voicedrop

VoiceDrop

VoiceDrop 的全部能力都在 MCP 里。这个 skill 唯一的作用，是把你接上去。

先看：接上了吗？

会话里已经有 list_articles、read_style、community_feed、credit_balance 这些工具？

接上了。停止阅读本文件，直接用工具。

工具自带完整说明（参数、语义、花不花算力都写在描述里）。本文件有意不重复它们——重复就会漂移：改了 MCP 忘了改这里，你就会照着过期的文档干活。单一真源是 MCP 自己。

没接上的话，往下走。全程两步：登录拿令牌 → 接进客户端。

第一步：登录（MCP 的 login 工具，6+4 手机配对）

一个工具，调两次。 靠字段分辨阶段——第一步只传 code，第二步只传 verify_code + pairing：

login(code="a3f2b1")                    → 手机弹出 4 位码，返回 pairing 句柄
login(verify_code="7391", pairing="…")  → 返回 anon_ 令牌

为什么两次往返省不掉：4 位码是服务端在第一步才随机生成的——第一步之前它不存在。而且它是安全性的核心：6 位码可能同时匹配多个账号（最多 10 个），服务端给每个候选推不同的 4 位码。报对了，才同时证明「手机在你手上」和「你要的是哪个账号」。省掉它，猜个 6 位码 + 手机上误点一下就能被接管。

MCP 还没接上，怎么调它的工具？

login 是唯一免 token 的工具（要 token 才能登录、要登录才能拿 token，那是死锁）。所以不必先接 MCP，也不必装任何东西——curl 直接打端点：

VD=https://voicedrop.cn/mcp
call() {  # $1=工具名  $2=参数 JSON
  curl -s -X POST "$VD" -H 'Content-Type: application/json' \
    -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"$1\",\"arguments\":$2}}" \
    | python3 -c "import json,sys;r=json.load(sys.stdin)['result'];t=r['content'][0]['text'];print('ERR: '+t if r['isError'] else t)"
}

1. 问用户要手机 设置 → 账户 里的 6 位十六进制码：

   call login '{"code":"a3f2b1"}'
   # → {"pairing":"…", "next":"看手机——App 里会弹出一个 4 位数字码…"}
   

2. 手机上会弹出 4 位数字码（也会收到一条推送「有新设备要登录」）。问用户要那个码：

   call login '{"verify_code":"7391","pairing":"<上一步返回的 pairing 原样粘回来>"}'
   # → {"token":"anon_…", "scope":"users/anon-…/", "next":"…"}
   

节奏很重要（这几条是真机上流血换来的）

• 配对只活 2 分钟。 拿到 6 位码立刻发起，拿到 4 位码立刻完成。中间不要聊天、不要解释、不要顺手干别的——超时就得整个重来。
• 用户报完 4 位码后，多半会切回电脑。 App 一进后台，服务端的「放行」消息就送不到手机。这时手机会收到第二条推送「确认登录」——提醒用户立刻点它；或者手动把 App 切回前台，登录会自动完成（服务端存着待办，回前台自动补送）。
• 手机没弹码？ 让用户把 App 切到前台就行——码会自动补送出来，不必重新发起。

报错对照