openydt-list — 车牌名单管理域 (blacklist / redlist / visitor)

CRITICAL：开始前 MUST 先用 Read 工具读取 [../openydt-shared/SKILL.md](../openydt-shared/SKILL.md)（认证 / profile / 签名 / 状态码 / 限速 / 安全规则）。未读共享基座不要执行任何命令。

何时用本技能

当用户要在停车场维护车牌名单时使用本技能，包括三类业务：

• 黑名单（blacklist）：禁止某车辆进场 / 收高额费用。说法如「拉黑这台车」「加黑名单」「查黑名单列表」「解除黑名单」。
• 白名单（redlist）：放行规则，免费 / 特权通行。说法如「加白名单」「警车放行」「白名单规则」「删除放行规则」。
• 访客（visitor）：临时来访登记，限时通行。说法如「登记访客车」「访客放行」「取消访客预约」。

意图路由：

• 「加黑 / 拉黑 / 查黑名单 / 解除黑名单」→ openydt blacklist ...
• 「加白 / 白名单规则 / 删除白名单」→ openydt redlist ...
• 「访客登记 / 取消访客」→ openydt visitor ...
• 「创建特殊车辆类型 / VIP 分组」→ openydt ticket add-special-car-type（前置步骤，见业务流程；详见 [[openydt-monthticket]]）

注意：本技能命令分布在 blacklist / redlist / visitor 三个子命令域，调用前缀各不相同。

可用命令

所有写操作（add/remove/del/cancel）均需追加 --yes 确认。读操作（get-*）无需 --yes。

业务流程

黑名单 / 访客登记必须先有「特殊车辆类型」，其 specialCarTypeId 是后续命令的必填入参。完整闭环如下，务必用前序命令响应里的字段作为后续命令入参：

1. 创建特殊车辆类型（前置，属 ticket 域）

openydt ticket add-special-car-type --yes - 黑名单用 vipGroupType=2，访客用 vipGroupType=1。 - 从响应中取回的 specialCarTypeId 是步骤 2 的必填入参（黑名单 --special-car-type-id / 访客 --special-car-type-id）。

1. 登记车辆（用步骤 1 的 specialCarTypeId + 车牌 + parkCode）

- 黑名单：openydt blacklist add-black-list-car --yes - 访客：openydt visitor add-visitor-car-new --yes

1. 查询确认

- 黑名单：openydt blacklist get-park-black-list，从返回列表中取回 blacklistId，供步骤 4 精确取消使用。 - 白名单：openydt redlist get-red-list，从返回中取回 ruleId，供 del-red-list 使用。

1. 清理 / 取消

- 黑名单：openydt blacklist remove-black-list-car --yes（用步骤 3 的 --blacklist-id，或仅传 --car-no 取消该车牌全部黑名单） - 访客：openydt visitor cancel-visitor-car-new --yes（用 --visitor-id，或仅传 --car-no 取消最新一次访客） - 白名单规则：openydt redlist del-red-list --yes --rule-id <步骤3的ruleId>

白名单规则相对独立，无需特殊车辆类型，直接用 openydt redlist red-list-add 新增（支持单车牌或 *警 这类通配规则）。

写入幂等与确认

• add-black-list-car/add-visitor-car-new 重复回传同车牌：平台按车牌去重（同车牌重复加黑不新建条目）；不确定首次是否生效先 get-park-black-list 查。
• ⚠️ remove-black-list-car/cancel-visitor-car-new 仅传 --car-no（不带 id）会取消该车牌全部条目——批量影响，执行前先 get-park-black-list 确认范围，优先用查询拿到的 blacklistId/visitorId 精确取消。

PII：--phone/--car-no 是 PII，prod 不记真实值（见 [[openydt-shared]]）；特殊车辆类型创建见 [[openydt-monthticket]]。

错误自愈速查（黑白名单/访客）

通用状态码与重试规则见 [[openydt-shared]]；结果三层判读见其 ../openydt-shared/references/result-reading-sop.md。

示例

下列 parkCode/时间为文档化测试值（仅 test；1ZS7H5PQH9/PTD2YBBZ 为测试车场，生产环境替换为授权车场）。写操作建议先 --dry-run 预览、确认后再 --yes。

1. 添加一条黑名单车辆（写，需 --yes；special-car-type-id 来自 add-special-car-type 的响应）：

openydt blacklist add-black-list-car --yes \
  --park-code 1ZS7H5PQH9 \
  --car-code 粤EJW962 \
  --car-owner 车主 \
  --reason 原因 \
  --special-car-type-id 253

1. 查询某停车场黑名单列表（读，免 --yes，用 --body 传 parkCodeList 数组）：

openydt blacklist get-park-black-list \
  --body '{"parkCodeList":["1ZS7H5PQH9"],"carCode":"粤EJW962","pageNum":1,"pageSize":10}'

1. 新增白名单放行规则（写，需 --yes，park-code-list 为数组用 --body）：

openydt redlist red-list-add --yes \
  --body '{"parkCodeList":["1ZS7H5PQH9","PTD2YBBZ"],"redlistParam":"粤EJW962"}'

1. 登记访客车辆（写，需 --yes；special-car-type-id 来自访客类型的 add-special-car-type 响应）：

openydt visitor add-visitor-car-new --yes \
  --park-code PTD2YBBZ \
  --car-no 粤EJW962 \
  --owner 李四 \
  --phone 13800000000 \
  --reason 访友 \
  --visit-from 20260601000000 \
  --visit-to 20260602000000 \
  --special-car-type-id 154