省市区级联
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/iwj20262006。
技能介绍
它要解决的问题
客户线索表里经常出现这样的字段:address 一坨字符串,前端筛不出“北京市的所有记录”,运营想按城市做统计只能全文匹配。更麻烦的是历史数据里存了 北京市朝阳区 这种展示文案,行政区划调整后无人维护,code 缺失导致无法和统计局口径对接。另一个常见坑是手写一份省市区 JSON——数据早就过时,来源也没标注。
技能如何工作
这个技能封装了 element-china-area-data 的级联逻辑,核心是“存 code,顺带存中文”:
- 用包导出的
regionData直接喂给 Element Plus 的el-cascader,不用自己拼树 - 提交时同时写出 区划 code、拼接中文和
detail详细地址 - 回显时用已存的 codes 赋给
v-model,避免反向查中文
Agent 的执行路径很明确:
- 安装包,把
regionData接到el-cascader - 提交:
codes + text + detail三个字段一起入库 - 回显:把数据库里的 codes 塞回
v-model - 自测:选到区级、清空、回显一致
关键约束是不要只存展示文案。code 是筛选、排序、对接外部区划数据的锚点,中文只是给人看的冗余。
适用边界
- 数据以 npm 包版本区划为准,库更新后区划会有变化,别假设是固定快照
- 港澳台与海外地址不要塞进同一个强制三级结构,应可跳过或另设字段
- 级联值变更时不要清空用户已填的门牌号,除非产品明确要求
- 手写 JSON 属于“不要做”:过时且不注明来源的区划数据比没有数据更危险
使用场景
- CRM 线索表的地址字段还是一整串文本,需要拆成省市区 code + 中文名 + 详细地址,支持按城市筛选
- 用 Element Plus 的 el-cascader 做省市区选择器,提交时同时落 code、拼接中文和详细地址三个字段
- 列表页要按城市维度筛记录,历史数据只存了地址字符串,需要补齐区划 code 回填能力
- 做统计局口径对齐前的准备工作,用带版本的 npm 区划数据替换过时的手写 JSON
适合人员
- 后端工程师:提交表单时要同时落省市区 code、中文名和详细地址,之后能按城市筛选排序
- 前端工程师:想直接用包里的 regionData 接 el-cascader,不愿手写和维护区划 JSON
- CRM 线索运营:需要按城市维度筛选客户地址,而不是在整串地址里全文搜索
- 数据对接人员:后续要和统计局口径对齐,需要区划 code 来源明确且随包版本更新