Agent Skills
返回列表
特殊字符探查器

特殊字符探查器

数据分析 更新于 2026.08.29

将以下提示词粘贴到你的 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 找出用户输入里混入的特殊控制字符。