openydt-list 是 openydt-cli 工具集中的车牌名单管理域技能，围绕停车场车牌名单提供黑名单、白名单和访客三类业务的管理能力。
【用途】 当用户需要在停车场维护车牌名单时使用本技能，涵盖三类业务：黑名单（blacklist）用于禁止某车辆进场或收取高额费用；白名单（redlist）用于配置放行规则，实现免费或特权通行；访客（visitor）用于临时来访登记，实现限时通行。
【前置要求】 开始前必须先使用 Read 工具读取 ../openydt-shared/SKILL.md，其中包含认证、profile、签名、状态码、限速和安全规则。未读共享基座不要执行任何命令。
【意图路由】 「加黑 / 拉黑 / 查黑名单 / 解除黑名单」对应 openydt blacklist 子命令；「加白 / 白名单规则 / 删除白名单」对应 openydt redlist 子命令；「访客登记 / 取消访客」对应 openydt visitor 子命令；「创建特殊车辆类型 / VIP 分组」对应 openydt ticket add-special-car-type，属于前置步骤。
【主要能力与命令】 黑名单：添加黑名单车辆（openydt blacklist add-black-list-car，写操作，参数 --park-code、--special-car-type-id、--car-code、--car-owner、--reason 均必填）；查询黑名单车辆列表（openydt blacklist get-park-black-list，读操作，--body 中 parkCodeList 必填，可选 --car-code、--owner、--page-size、--page-num）；取消黑名单车辆（openydt blacklist remove-black-list-car，写操作，--park-code 必填，--blacklist-id 或 --car-no 二选一）。 白名单：新增白名单规则（openydt redlist red-list-add，写操作，--redlist-param、--park-code-list 必填，可选 --plate-color、--operator、--remark）；查询白名单规则（openydt redlist get-red-list，读操作，--park-code-list 必填）；删除白名单规则（openydt redlist del-red-list，写操作，--rule-id 必填，来自查询结果）。 访客：添加访客车辆（openydt visitor add-visitor-car-new，写操作，--park-code、--car-no、--owner、--special-car-type-id、--visit-from、--visit-to 均必填）；取消访客车辆（openydt visitor cancel-visitor-car-new，写操作，--park-code 必填，--visitor-id 或 --car-no 二选一）。 所有写操作（add/remove/del/cancel）均需追加 --yes 确认，读操作（get-*）无需 --yes。
【业务流程】 黑名单和访客登记必须先有特殊车辆类型，其 specialCarTypeId 是后续命令的必填入参。完整闭环为：先创建特殊车辆类型（openydt ticket add-special-car-type --yes，黑名单用 vipGroupType=2，访客用 vipGroupType=1），从响应中取回 specialCarTypeId；再用该 ID 加车牌和 parkCode 登记车辆；然后查询确认，黑名单查询取回 blacklistId，白名单查询取回 ruleId；最后清理或取消。白名单规则相对独立，无需特殊车辆类型，可直接新增，支持单车牌或 *警 这类通配规则。
【写入幂等与确认】 add-black-list-car 和 add-visitor-car-new 重复回传同车牌时，平台按车牌去重。remove-black-list-car 和 cancel-visitor-car-new 仅传 --car-no 不带 id 会取消该车牌全部条目，属批量影响，执行前应先查询确认范围，优先用查询拿到的 blacklistId 或 visitorId 精确取消。--phone 和 --car-no 属于 PII，生产环境不记真实值。
【错误自愈】 加黑名单失败 status=7 或 resultCode=909 表示 specialCarTypeId 未传、不属本车场或类型不匹配，需先查询本车场类型 ID 并确认 vipGroupType=2；访客登记失败 status=2 表示 specialCarTypeId 属黑名单类型或未授权，需确认使用访客类型（vipGroupType=1）；取消后疑似未生效可能是平台查询延迟，可等待 1-2 秒后复核，若存在多条同车牌条目应改用 id 精确取消；查询返回 0 条需确认 parkCodeList 是否传全。
【适用场景】 适用于停车场管理场景中的车牌名单维护，包括拉黑违规车辆、配置警车等特权放行规则、登记临时访客车辆等。
【限制】 使用前必须完成共享基座配置；黑名单和访客登记依赖特殊车辆类型；写操作需 --yes 确认；仅传车牌取消会影响该车牌全部条目；示例中的 parkCode 和时间为文档化测试值，生产环境需替换为授权车场。