交通违章处理助手（traffic-violation-helper）
这个 skill 解决什么痛点
有车一族几乎都遇到过这几个瞬间，而且每次都慌：
- 收到 12123 短信"您有 1 条违法记录"，点进去只看到代码
1302，根本不知道扣几分、罚多少钱、是不是自己犯的。 - 不知道怎么处理最快：线上能办还是必须跑窗口？异地违章能不能在本地处理？现场罚单和电子抓拍是不是两套流程？来回跑两趟才办成。
- 被误拍 / 被套牌：明明车停着却被拍违停，或收到从没去过的城市的违章——想复议但不知道向谁提、写什么、有没有用。
- 搞不清记分周期：这个周期已经扣了几分？还剩几分安全？什么时候清零？A/B 证和 C 证规则不一样，实习期更严，一不小心满 12 分就要重考科目一。
- 同一类违章反复吃：年年违停、月月压线，从没总结过自己的高频违章类型。
这个 skill 把"收到违章之后的 30 分钟"变成一条确定性流水线：识别违章代码 → 查处罚（扣分/罚款）→ 选处理通道 → 该复议复议 → 算清自己的安全分 → 总结避坑。数据全部存在本地，不联网、不上传。
目标用户
- 所有车主、驾驶人——尤其是城市通勤族（违停、压线、闯红灯、限速抓拍最高发）。
- 新手司机和实习期驾驶员（对记分更敏感，满 12 分后果严重）。
- 营运 / 货运司机（A/B 证只要有记分就要审验，规则更复杂）。
- 帮父母处理违章的子女（长辈不懂 12123 操作，容易超期）。
核心能力
- 违章代码速查：输入违章代码（如
1302）或口语关键词（如闯红灯违停压线打电话），秒返回行为描述、记分数、罚款区间、法律依据与避坑说明。 - 处理流程决策：根据"现场单 / 电子抓拍 / 本地 / 异地"四种组合，给出最快、最省事的处理路径（12123 线上 vs 窗口 vs 自助机）。
- 复议申请模板：被套牌、误拍、标线不清、避让特种车辆等可复议情形，提供结构化的复议申请书要点与话术。
- 记分周期测算：输入初领证日期、已处理分、待处理分、车型，算出当前周期剩余安全分、清零日期、满分学习与降级风险。
- 高频违章避坑清单：按类型给出可执行的具体改进行动。
使用方式（工作流）
步骤 1：识别并查处罚
用户发来违章代码或描述，先查处罚。脚本在 scripts/：
# 按代码查（用户短信/12123 里最常见的就是代码）
python3 ~/.workbuddy/skills/traffic-violation-helper/scripts/lookup.py 1302
# 按口语关键词查（无需记代码）
python3 ~/.workbuddy/skills/traffic-violation-helper/scripts/lookup.py 闯红灯
python3 ~/.workbuddy/skills/traffic-violation-helper/scripts/lookup.py 违停
python3 ~/.workbuddy/skills/traffic-violation-helper/scripts/lookup.py 压线
python3 ~/.workbuddy/skills/traffic-violation-helper/scripts/lookup.py 打电话
# 浏览全部 20+ 条常见违章
python3 ~/.workbuddy/skills/traffic-violation-helper/scripts/lookup.py --list
输出示例（闯红灯）：
[1302] 机动车不按交通信号灯规定通行（闯红灯）
记分：6 分 罚款：¥200
类别：信号灯 依据：163号令记6分
说明：越线停车（前轮过线即停）一般记1分或不记，视抓拍位置。
> 如果用户的代码不在内置表里，告诉用户：这是正常情况（库里只收了最高发的 20+ 条），请直接按 12123 显示的金额和分数处理，并把代码发给我，我帮你判断要不要复议。
步骤 2：选处理通道
按下面决策快速给结论：
| 情形 | 最快处理方式 | 注意事项 |
|---|---|---|
| 本地电子抓拍（非现场） | 交管 12123 App → 违法处理 → 在线缴费，支持绑定多车、可代缴 | 需先备案非本人机动车（备案后才能在 12123 处理）；处理即记分 |
| 现场罚单（交警手写/打印单） | 15 日内到指定银行或 12123 缴罚款；逾期每日加处 3% 滞纳金（不超本金） | 现场单超期影响年检、可能产生滞纳金 |
| 异地非现场违章 | 多数可在 12123 线上处理；部分省份老系统需回违法地或车籍地窗口 | 先试线上，提示用户"如线上无记录再跑窗口" |
| 记分已满/快满 12 分 | 不要一次性处理所有违章！分周期或找有分的家人代扣（注意买分卖分违法） | 满 12 分扣证、重考科目一；见步骤 4 |
关键提醒：
- 处理违章＝确认记分。在 12123 点"处理并缴款"之前，分数还没记到本周期；没把握前先别急着点。
- 一个记分周期最多 12 分，清零日是你初领证日期的"对月对日"前一日（见步骤 4）。
- 年检前必须清零所有违章，否则过不了线。
步骤 3：判断要不要复议（被误罚时）
以下情形建议复议，成功率较高，且复议期间不扣分不缴款：
- 被套牌：车辆从没去过违章地，或违章照片里车型/颜色/车架号不符。准备：行车记录仪、停车场票据、高速通行记录等不在场证明。
- 被误拍：同一地点短时间连拍、标线磨损看不清、信号灯故障、号牌被遮挡误导。
- 避让特种车辆：为给救护车/消防车让行而压实线、闯红灯（保留行车记录仪视频）。
- 信号灯 / 标线矛盾：路口标线指向与信号灯冲突，或施工改道未设标志。
复议申请要点模板（向违法地交警支队法制部门提交）：
复议申请人：___ 联系电话：___ 车牌号：___
复议请求：撤销编号 ____ 的行政处罚决定（违法代码 ____，时间 ____，地点 ____）。
事实与理由：
1. 本人车辆于上述时间并未实施该违法行为（/ 系避让特种车辆 / 系被套牌）；
2. 关键证据：行车记录仪视频（附光盘）、____（票据/照片）；
3. 原处罚认定事实不清 / 证据不足，恳请复核。
附件：身份证复印件、行驶证复印件、证据清单。
话术提示：先线上（12123"申诉"入口或违法地交警公众号）提交，多数城市支持；被驳回再线下到法制科。复议不收费、不记分、不缴款，赢了即撤销。
步骤 4：算清自己的安全分
# 基础：C 证，已处理3分，待处理6分
python3 ~/.workbuddy/skills/traffic-violation-helper/scripts/score_cycle.py \
--issue 2020-05-10 --processed 3 --pending 6 --type C
# A/B 证（只要有记分就要审验）、实习期
python3 ~/.workbuddy/skills/traffic-violation-helper/scripts/score_cycle.py \
--issue 2019-08-01 --processed 0 --pending 12 --type B --probation
脚本会输出：当前记分周期起止、距清零天数、剩余安全分、满分学习 / 降级 / 实习期风险。
步骤 5：给高频违章避坑清单
根据查到的违章类型，给 1–3 条最具体可行的改进行动，例如：
- 违停高发 → 用地图 App 提前看"禁止停车"黄实线路段，商圈用停车场而非路边。
- 压线 / 不按导向 → 进路口前 50 米就并好道，别到停止线才变道。
- 限速抓拍 → 陌生道路跟住前车速度、留意测速提示牌，导航开"电子眼提醒"。
- 开车打电话 → 上车连蓝牙，或将手机放手套箱，治本。
内置常见违章速查（节选）
| 代码 | 行为 | 记分 | 罚款 |
|---|---|---|---|
| 1039 | 普通道路违法停车 | 0 | ¥200 |
| 4701 | 高速/城市快速路违法停车 | 9 | ¥200 |
| 1301 | 逆向行驶 | 3 | ¥200 |
| 1302 | 闯红灯 | 6 | ¥200 |
| 1303 | 普通道路超速20%–50% | 3 | ¥200 |
| 1725 | 超速50%以上 | 12 | ¥200–2000 |
| 1362 | 开车拨打/接听手持电话 | 3 | ¥200 |
| 1116 | 违反禁止标线（压线） | 1 | ¥100–200 |
| 1117 | 违反禁令标志（禁行/限号） | 1 | ¥100–200 |
| 1357 | 不礼让斑马线 | 3 | ¥200 |
| 4608 | 占用应急车道 | 6 | ¥200 |
| 1712 | 饮酒后驾驶 | 12 | ¥1000–2000 |
| 1625 | 驾驶与准驾车型不符 | 9 | ¥200–2000 |
完整 20+ 条与说明见 scripts/violation_db.json，或运行 lookup.py --list。
边界声明 / 免责
- 本 skill 的处罚数据依据《道路交通安全违法行为记分管理办法》（公安部令第163号，2022-04-01实施）及《道路交通安全法》常见条款整理，为速查参考。
- 实际记分 / 罚款会因省份、道路类型（高速/城市快速路/普通道路）、车型、是否发生事故而变化；部分城市对违停、限行另有细则。
- 一切以交管 12123 App 显示和当地交警出具的处罚决定书为准。 涉及扣分、滞纳金、吊销、刑事（醉驾）等重大事项，请直接咨询属地交警或专业法律人士。
- 本工具不联网、不收集任何个人信息，全部数据仅在本机运行。
> ⚠️ 严禁"买分卖分"：代替实际驾驶人接受处罚记分并牟取经济利益属违法行为，记12分，请勿尝试。
