Skip to content
qybaihePublic

About

中山大学广州到珠海校区岐关车预定Skill,部署之后可以让AI agent帮你预定车票

Resources

Stars

5 stars

Watchers

0 watching

Forks

Repository files navigation

岐关车.skill

把「查岐关车班次、选车、复制微信下单链接」这件事,交给 CLI 和 AI Skill。

珠海校区出发,少点开几层页面。

npm version License: MIT Node.js 18+ Codex Skill OpenClaw ClawHub

 

qg-skill 同时提供两件东西:

  • 一个全局命令行工具:qg / qg-list
  • 一个 Codex / OpenClaw Skill:qgcar-skill

它可以查询岐关车班次,列出 Code,再用 qg link CODE 生成微信可打开的 BusOrderWrite 下单入口链接。

⚠️ 本项目只生成微信订单填写入口链接,不会自动提交乘客信息、不会保存身份证信息、不会代替你支付。

安装 · 小龙虾一键安装 · 使用 · ai--openclaw-用法 · 支持路线 · 开发与发布


安装

一键部署

安装 CLI,并把 Skill 同时安装到 ~/.codex/skills/qgcar-skill 和 ~/.openclaw/skills/qgcar-skill:

curl -fsSL https://raw.githubusercontent.com/qybaihe/qg-skill/26ed8e31342968836b672d0ea7ab2a275361779c/install.sh | bash

脚本会优先从 npm 安装 qg-skill;如果 npm 包还没发布,会自动 fallback 到 GitHub 源码构建安装。

小龙虾一键安装

已发布到 ClawHub:

https://clawhub.ai/skills/qgcar-skill

如果你在用小龙虾 / OpenClaw,可以直接让它安装这个技能:

帮我从 ClawHub 安装 qgcar-skill,然后用它帮我查询岐关车并生成微信下单链接

或者手动执行:

clawhub install qgcar-skill

如果还没有安装 qg CLI,继续执行一键部署脚本:

curl -fsSL https://raw.githubusercontent.com/qybaihe/qg-skill/26ed8e31342968836b672d0ea7ab2a275361779c/install.sh | bash

只安装 CLI

npm install -g qg-skill

安装后检查:

qg --help
qg routes

只安装 Skill

从 ClawHub 安装到当前工作区:

clawhub install qgcar-skill

或者手动安装到 Codex:

mkdir -p ~/.codex/skills
git clone https://github.com/qybaihe/qg-skill ~/.codex/skills/qgcar-skill

OpenClaw 用户也可以装到:

mkdir -p ~/.openclaw/skills
git clone https://github.com/qybaihe/qg-skill ~/.openclaw/skills/qgcar-skill

如果你只安装 Skill,也需要确保机器上能运行 qg 命令:

npm install -g qg-skill

使用

1. 查今天可订班次

qg list --today --available

输出会包含 Code:

Date: 2026-04-07

珠海中大岐关服务点 -> South Campus
Code  Line   Board  Arrive  From                To                       Price   Seats  Type    Status
----  -----  -----  ------  ------------------  -----------------------  ------  -----  ------  ---------
1     16:00  16:20  18:00   珠海中大岐关服务点  广中大南校区 岐关服务部  ¥40.00  34     direct  available

2. 用 Code 生成微信下单入口

qg link 1

复制到剪贴板:

qg link 1 --copy

3. 指定路线、日期、站点

qg list --start zhuhai --to south --station zhuhai --today --available
qg list --start zhuhai --to east --station boya --tomorrow --available
qg list --start south --to zhuhai --date 2026-04-10 --available

4. 不经过列表,直接按时间生成链接

qg link --start zhuhai --to south --station zhuhai --time 16:00

--time 支持匹配线路时间或实际上车时间,最终链接会使用对应站点的实际上车时间。


AI / OpenClaw 用法

安装后一轮新对话里可以直接让 Codex 或 OpenClaw 帮你订票:

Use $qgcar-skill to find a Qiguan bus from Zhuhai to South Campus today and generate a WeChat order link.

也可以自然语言说:

帮我查今天珠海中大去南校区的可订班次,然后给我 16:00 那班的微信下单链接

OpenClaw 里可以这样说:

让 OpenClaw 用 qgcar-skill 帮我查今天珠海中大去南校区的可订班次,并生成微信下单链接

Skill 会指导 AI 走安全流程:

qg list ... --available
qg link CODE

不会自动提交订单或支付。

OpenClaw 可用性检查:

openclaw skills list
openclaw skills info qgcar-skill

ClawHub 发布页:

https://clawhub.ai/skills/qgcar-skill

支持路线

Campus Key

key 含义
zhuhai 珠海校区侧
south 南校区
east 东校区

珠海站点

key 站点
zhuhai 珠海中大岐关服务点
boya 博雅苑
fifth 中大五院正门

默认规则:

命令 默认含义
qg list 今天,珠海中大 -> 南校区
qg --start zhuhai 今天,珠海中大 -> 南校区
qg list --start south 今天,南校区 -> 珠海中大
qg list --start east 今天,东校区 -> 珠海中大
qg list --start zhuhai --all 今天,珠海中大 -> 南校区和东校区

路线必须有一侧是 zhuhai,不支持 south -> east。


日期

不输入日期默认今天。

qg list --today
qg list --tomorrow
qg list --date 2026-04-10
qg list --date fri

日期限制为一周内。


项目结构

qg-skill/
├── SKILL.md              # Codex Skill 入口
├── agents/openai.yaml    # Skill UI 元数据
├── references/qg-cli.md  # AI 使用 CLI 的详细参考
├── src/                  # TypeScript CLI 源码
├── dist/                 # 编译后的 CLI
├── install.sh            # 一键安装脚本
├── package.json          # npm 包配置
└── README.md

开发与发布

本地开发:

npm install
npm run build
npm link
qg list --today --available
qg link 1

发布到 npm:

npm login
npm publish --access public

也可以在 GitHub 仓库设置 NPM_TOKEN secret,然后手动触发 Publish workflow。

推送到 GitHub:

git remote add origin https://github.com/qybaihe/qg-skill.git
git push -u origin main

注意事项

  • 这是非官方工具,接口和站点信息可能会变化。
  • priceMark 会随查询刷新,所以建议先 qg list,再立刻 qg link CODE。
  • 微信链接打开后仍需要你自己确认乘客、订单和支付。
  • 不建议在 CLI 或 Skill 里保存身份证、手机号等乘客隐私信息。

MIT License © qybaihe

About

中山大学广州到珠海校区岐关车预定Skill,部署之后可以让AI agent帮你预定车票

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages