特殊字符探查器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_d80cdbd5/kashen-check-special-letter。
技能介绍
问题:导出和 API 传参总出怪事
明明在数据库界面里看,字段值都是干净的,一到导出 Excel、丢给上游 API,就报 JSON parse error 或串行。排查半天才发现某个字段里混进了肉眼看不见的换行符、制表符或反斜杠——它们只是长得像空格或正常字符,实际编码完全不同。
特殊字符探查器(kashen-check-special-letter) 就是来快速定位这些隐形脏字符的。
它能做什么
给技能一份数据来源,它会自动生成一段只读探查 SQL,逐字段扫描并报告:
- 覆盖的脏字符:
BACKSLASH(反斜杠)、QUOTE(双引号)、CR(回车)、LF(换行)、TAB(制表符) - 输入方式很自由:直接发
SELECT语句、CREATE TABLE的 DDL,或者多条语句(分号分隔),脚本会逐表生成探查逻辑 - 输出三列:
col(字段名)、hit(命中的字符类型)、sample(命中行的原始值),方便直接拿原始数据核对
默认跳过数值、日期、布尔、枚举等非文本字段,只对 varchar/char/text 等字符串列做扫描。
怎么用:三步定位
1. 投放脚本
把 SELECT 或 DDL 直接给技能。如果是多表混合语句,用分号分隔即可,技能会自动拆解并分别生成探查 SQL。
2. 运行并看命中报告
每张表输出一段 UNION ALL 拼接的字段级探查查询。跑完只返回有命中的字段行——干净字段不会出现,一眼就知道哪些列需要做转义或清洗。返回的 sample 列完整保留原始值,可以直接在日志里对比排查。
3. 基于命中结果写转义逻辑
拿到探查结果后,按团队已有的转义规范处理。探查脚本本身不写数据——如果要清理数据,请再自行执行真实的清理语句。
适用边界与注意
- 探查脚本只读不写,不会改动你的原始
SELECT/DDL语义,也不会修改任何表数据 - 技能不生成转义脚本,仅提供命中定位;你需要单独编写对应的
REPLACE清洗逻辑 - 多表场景下建议分表逐步处理,一次性传递超大脚本可能会导致反馈超时
当你想搞清楚“到底哪个字段里藏了特殊字符导致下游解析报错”时,这技能会节省大量逐列排查的时间。
使用场景
- 系统导出或 API 上传报错提示 JSON 解析异常时,需要快速排查表中哪些字段含隐藏的换行、制表符或斜杠等不可见字符。
- 多表关联的复杂 SQL 运行数据串行时,需要通过大段 SELECT 语句逐表扫描,定位具体包含特殊字符的字段。
- 接手遗留数据库表结构开发时,只有空的 CREATE TABLE 脚本,需自动生成一批探查 SQL 来摸清现有文本列的脏数据情况。
适合人员
- 后端开发工程师:系统对接第三方 API 频繁出现 JSON 解析异常,急需定位接口数据中包含转义符的脏字段。
- 数据分析师:数据导入报表平台后出现串行,需要排查多个 SELECT 查询结果里不可见的制表符和回车符。
- 前端创作者:表单提交写入数据库的数据展示错位,需要利用探查 SQL 找出用户输入里混入的特殊控制字符。