cross-bj

进京证 CLI 工具 — 让人类和 AI Agent 都能在终端中办理进京证。

安装 · AI Agent Skills · 命令参考 · 通知渠道

为什么选 cross-bj？

• 为 Agent 原生设计 — Skills 开箱即用，Agent 无需额外适配
• 零 Python 依赖 — npm install -g 即装即用
• 智能续签 — 自动判断是否需要续签，剩余1天时提前申请
• 多渠道通知 — Bark、Telegram、钉钉、企业微信、飞书、Slack
• 一键定时 — cross-bj cron setup 写入 crontab

功能

| 类别 | 能力 | |------|------| | 进京证 | 智能续签、状态查询、到期提醒、多类型支持（六环内/六环外） | | 车辆管理 | 添加/删除车辆、首选车辆设置、换牌（保留信息） | | 通知 | Bark、Telegram、钉钉、企业微信、飞书、Slack、Webhook | | 定时任务 | 一键写入 crontab，自定义执行时间 |

安装

npm install -g cross-bj

要求 Node.js >= 18。

快速开始（人类用户）

Note for AI assistants: 如果你是 AI Agent，请跳转到快速开始（AI Agent）。

# 1. 初始化（交互式引导完成登录、配置）
cross-bj init

# 2. 查看状态
cross-bj status

# 3. 一键续签
cross-bj run

# 4. 设置自动续签（每天 9:00）
cross-bj cron setup

快速开始（AI Agent）

以下步骤面向 AI Agent，部分步骤需要用户配合提供信息。

第 1 步 — 安装

npm install -g cross-bj
npx skills add fichas/cross_beijing_cli -y -g

第 2 步 — 初始化（非交互式，需要用户提供手机号和密码）

cross-bj init --phone <phone> --password <password>

第 3 步 — 验证

cross-bj status

命令参考

初始化

cross-bj init                                    # 交互式（已有配置会询问是否覆盖）
cross-bj init --phone <phone> --password <pwd>   # 非交互式（已有配置会拦截）
  [--entry-type <六环内|六环外>]
  [--notify <url>...]
  [-f, --force]                                  #   强制覆盖已有配置

续签

cross-bj run                        # 智能续签 + 状态查询 + 通知
  [--plate <plate>]                 #   指定车牌（默认首选车辆）
  [--entry-type <六环内|六环外>]      #   指定进京证类型（默认使用配置值）
  [--no-notify]                     #   不发送通知

无参数执行 cross-bj 等同于 cross-bj run。

状态

cross-bj status                     # 查看进京证状态
  [-v]                              #   含配置信息
  [-n]                              #   将状态通过通知渠道发送
  [--plate <plate>]                 #   指定车牌（默认首选车辆）

车辆管理

cross-bj vehicle list               # 查看绑定车辆（标注首选）
cross-bj vehicle add                # 添加车辆
  --plate <plate>                   #   号牌号码（必填）
  --engine <engine>                 #   发动机号后6位（必填）
  --brand <brand>                   #   品牌型号（必填）
  --reg-date <YYYY-MM-DD>           #   注册日期（必填）
  [--plate-type <type>]             #   号牌种类（默认按车牌长度推断）
  [--vehicle-type <type>]           #   车辆类型（默认01=客车）
cross-bj vehicle remove <plate>     # 删除车辆
cross-bj vehicle set <plate>        # 设置首选车辆
cross-bj vehicle swap <newPlate>    # 换牌（保留其他信息）
  [--from <oldPlate>]               #   指定替换哪辆（默认首选）

通知

cross-bj notify add <url>           # 添加通知渠道
cross-bj notify remove <url>        # 删除通知渠道
cross-bj notify test                # 发送测试通知

配置

cross-bj set entry-type <六环内|六环外>   # 修改进京证类型

定时任务

cross-bj cron setup                 # 写入 crontab（默认每天 9:00）
  [--schedule '<cron>']             #   自定义 cron 表达式
cross-bj cron remove                # 移除定时任务
cross-bj cron status                # 查看定时状态

智能续签逻辑

cross-bj run 自动判断是否需要续签：

| 当前状态 | 行为 | |----------|------| | 无记录（新车） | 申请今天的进京证 | | 审核通过（生效中），剩余 ≤ 1 天 | 提前申请明天的进京证 | | 审核通过（生效中），剩余 > 1 天 | 无需续签 | | 审核中 / 待生效 | 无需续签 | | 已失效 / 审核失败 | 申请今天的进京证 | | 剩余次数和天数均为 0 | 无法续签（配额用完） |

首选车辆逻辑

申请进京证时的车辆选择优先级：

1. --plate 参数指定 → 用它
2. 有正在申请/生效中的车辆 → 用它
3. 有手动设置的首选车辆（cross-bj vehicle set）→ 用它
4. 都没有 → 用第一辆

只有一辆车时自动视为首选。换牌（vehicle swap）后自动更新首选。

通知渠道

通过 cross-bj notify add <url> 添加。URL 格式兼容 Apprise，支持以下渠道：

| 渠道 | URL 格式 | |------|----------| | Bark | bark://<server>/<key> 或 bark://<key> | | Telegram | tgram://<bot_token>/<chat_id> | | 钉钉机器人 | dingtalk://<access_token>[/<secret>] | | 企业微信机器人 | wecom://<key> | | 飞书机器人 | feishu://<hook_id>[/<secret>] | | Slack | slack://<T>/<B>/<token> | | 通用 Webhook | json://<host>/<path> |

详细的 URL 格式说明参见 Apprise Wiki。

配置文件

配置存储在 ~/.cross-bj/config.json，由 cross-bj init 自动创建，无需手动编辑。

Agent Skills

| Skill | 说明 | |-------|------| | cross-bj | 进京证办理、状态查询、车辆管理、通知配置 |

License

MIT