跳转至

装机上手

装

# 方式 1：pip
pip install acong-tech-xiangqin

# 方式 2：uv tool（推荐，隔离环境）
uv tool install acong-tech-xiangqin

# 方式 3：skill（Claude Code 场景）
skills install acong-tech/xiangqin

装完验证：

xq --version
xq health           # 打生产 epsilon，期望 {"status":"ok","version":"..."}

第一次跑通

1. 注册

xq register 13800001111
# → 验证码已发 138****1111，60s 内有效
#   request_id: 01JF...

mock 期验证码固定 123456，生产期从阿里云短信服务收真码。

2. 验证 → 拿 session

xq verify 123456 --request-id 01JF...
# → 登录成功（新用户），user_id=01JG...
#   session 已写 ~/.xiangqin/session.json

3. 填资料

xq profile set gender m
xq profile set age 28
xq profile set city hangzhou
xq profile set tags '程序,登山,做饭'
xq profile set bio '想找能一起爬山的人'
xq profile show

可选字段：gender / age / city 必填，tags / bio 可空（xq profile clear tags 清）。

4. 查匹配

xq query 'gender=f AND city=hangzhou AND age>=25 AND age<=30'
# → 8 条命中（其中 2 条付费置顶 🔥）
#   ------------------------------------------------------------
#   🔥 01JG...  f  27  hangzhou
#      tags: 瑜伽, 咖啡
#      bio:  想找稳定关系

5. 买曝光

# 真付走支付宝扫码
xq expose buy --count 100
# 终端打 ASCII 二维码，手机支付宝扫 → webhook 回来自动充值

# mock 期（服务端 provider=mock 时）
xq expose buy --count 100 --mock

xq expose balance    # 剩余曝光
xq expose history    # 订单历史

6. 登出

xq logout

常见错误

退出码 错误 解决
1 未登录 过了 session 有效期 xq register <手机> && xq verify ...
1 register failed: 429 1 分钟内重复发码 等 60s 或用上次返回的 request_id
1 verify failed: 400 验证码错 / 过期 重新 xq register
1 query failed: 400 WHERE 语法不合规 看 设计 — DSL
1 buy failed: 400 --count 超出 1-10000 拆多单

下一步