mcpField
E
eliteforge-qingtui-cli

eliteforge-qingtui-cli

github.com/cloudsen生产力41 次安装
代码仓库

关于 eliteforge-qingtui-cli

eliteforge-qingtui-cli 是用于通过 QingTui CLI 执行用户查询和文本消息发送的技能，适合需要命令行操作的 QingTui 用户。它规定了依赖与环境变量检查、安装升级、先查帮助再运行的流程。

主要功能

  1. 01检查 Python、pipx、jq 依赖
  2. 02验证必需环境变量
  3. 03安装或升级 QingTui CLI
  4. 04查询用户列表并解析用户
  5. 05向指定用户发送文本消息

适用场景

  1. 01按手机号解析用户 OpenID
  2. 02向指定 QingTui 用户发送文本
  3. 03在执行操作前核对命令参数

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cloudsen/eliteforge-skills --skill eliteforge-qingtui-cli

安装后在 Claude Code 中输入/eliteforge-qingtui-cli确认已加载。

附带文件agents/openai.yaml

详细介绍

来自项目 README

EliteForge QingTui CLI

依赖准备

以下工具不存在，先尝试自动安装：

  • python3
  • pipx
  • jq 上下文或环境变量中的内部变量缺失，终止运行，提示用户补全相关变量。

工作流

  1. 先确认依赖和变量可用。
  2. 每次使用前都检查 eliteforge-qingtui-cli 是否已安装。
    • 未安装时执行：pipx install eliteforge-qingtui-cli
  3. 每次使用前都执行：pipx upgrade eliteforge-qingtui-cli
  4. 先看帮助再执行具体命令，避免硬编码能力说明。
    • 总帮助：qingtui -h
    • 用户列表：qingtui list-users -h
    • 用户解析：qingtui resolve-users -h
    • 文本发送：qingtui send-text -h
  5. 按用户目标执行命令，可编写脚本自行编排接口。
  6. 涉及发送时，优先确认收件人来源，避免混淆 --user-name、--user-login、--open-id。

使用案例

向特定用户发送文本消息：

# 先通过用户手机号获取openid
openid=$(qingtui resolve-users --user-login '13800138000' | jq -r '.open_ids[0]')
# 发送文本消息
qingtui send-text --open-id $openid --content "Hello Alice!"

Environment Variables

  • ELITEFORGE_SKILL_QINGTUI_APPID [required] QingTui light app ID.
  • ELITEFORGE_SKILL_QINGTUI_SECRET [required] QingTui light app secret.
  • ELITEFORGE_SKILL_QINGTUI_API_BASE [optional] API base URL; defaults to https://open.qingtui.com.
  • ELITEFORGE_SKILL_QINGTUI_USER_LIST_MAX_PAGES [optional] Maximum pages to fetch when listing users; defaults to 5.
  • ELITEFORGE_SKILL_QINGTUI_USER_LIST_PAGE_SIZE [optional] Page size when listing users; defaults to 1000.
  • ELITEFORGE_SKILL_QINGTUI_MESSAGE_MAX_LENGTH [optional] Maximum text message length; defaults to 500.

Output Rules

  • 输出保持简洁，必要时可配合 jq 等Linux管道工具，处理接口JSON响应。
  • 失败时返回实际执行的命令和关键报错。
  • 需要更多命令说明时，继续引导查看对应 -h。

评论

支持 Markdown