@liuhange/dsh-gov-data-inspector
🔥 DSH 数据资产治理矩阵王牌插件 — 本包是 32 个独立发版插件中的核心引擎，历经番禺/开封/苏州三城真实政务网站验收，逻辑/语义/格式检出率 100%，误报率 0%。
👉 查看全部 32 个插件导航矩阵
⚠️ 版本状态说明
当前稳定版为 v3.6.5，生产环境请使用 @latest 安装：npm install @liuhange/dsh-gov-data-inspector
下一版本正在深度测试中，尝鲜测试请使用 @beta 安装：npm install @liuhange/dsh-gov-data-inspector@beta
基本信息
| 项目 | 值 |
|---|
| 插件名 | dsh-gov-data-inspector |
| 包名 | @liuhange/dsh-gov-data-inspector |
| 版本 | 3.6.5 |
| 工具 | inspect_gov_data |
功能说明
政务数据专项巡检，含办事指南质量检查（必填要素完整性、语义错误检测、服务便利度评估）和公共数据资产分类（基于GB/T 47949-2026结构化/半结构化/非结构化分类）。
安装
dsh plugin --profile web add @liuhange/dsh-gov-data-inspector
用法
import { apply } from '@liuhange/dsh-gov-data-inspector';
apply(ctx); // 注册工具: inspect_gov_data
政策依据
| 文件名称 | 文号 | 核心条款摘要 |
|---|
| 资产管理 数据资产分类与代码 | GB/T 47949-2026 | 数据资产分为结构化、半结构化、非结构化三小类，16项具体细类 |
| 资产管理 数据资产登记指南 | GB/T 47950-2026 | 明确初始、变更和注销登记流程 |
License
MIT
无凭据降级模式
当官方数据源（国家/省级）凭据未配置或不可达时，插件自动进入降级模式而非中止运行。
降级触发条件
- 国家和省级数据源均未配置 API Key / Endpoint
- 国家和省级数据源均不可达（网络超时、HTTP 错误等）
降级表现
| 检测模式 | 完整模式表现 | 降级模式表现 |
|---|
| classification | 正常分类 | 正常分类（不依赖知识库） |
| guide | 语义检测基于官方知识库 | 语义检测降级为本地规则检测 |
| full | 全量检测 | 分类正常 + 语义/逻辑降级 |
降级标记
降级模式下，巡检报告包含以下额外字段：
{
"degradedMode": true,
"degradedReason": "官方数据源全部不可用，已降级为本地规则检测模式"
}
端点协议宽松化
数据源端点支持以下三种协议：
https:// — HTTPS 远程端点http:// — HTTP 远程端点（不再强制 HTTPS）- 本地文件路径 — 直接读取本地 JSON 文件
异常输入处理
插件对以下异常输入场景提供明确的友好错误提示，不会崩溃或产生未捕获异常：
| 异常场景 | 错误码 | 错误提示 |
|---|
| 格式错误的 JSON | GOV_DATA_INPUT_INVALID | JSON 格式错误，请检查文件内容 |
| 空数据（空文件/空数组） | GOV_DATA_INPUT_INVALID | 无数据，请确认输入文件内容 |
| 超长数据（超 100 万字段） | GOV_DATA_SCALE_EXCEEDED | 数据量超出处理上限 |
| 无效 URL / 不可达路径 | GOV_DATA_URL_UNREACHABLE | 数据源不可达，请检查路径或 URL |
| 非 UTF-8 编码文件 | GOV_DATA_ENCODING_ERROR | 文件编码非 UTF-8 |
| 部分字段缺失 | 正常处理 | 报告中列出缺失字段清单 |
itemTypeOverride 参数
当自动匹配无法识别事项类型时，用户可通过 itemTypeOverride 参数手动指定：
execute({
dataSource: './data.json',
inspectionMode: 'guide',
itemTypeOverride: '现场勘查类'
})
未匹配事项类型警告
当事项无法匹配到任何检测规则时，报告中会包含 UNMATCHED_ITEM_TYPE 警告：
{
"warnings": [
{
"type": "UNMATCHED_ITEM_TYPE",
"guideId": "建设工程规划核实",
"message": "该事项未匹配到检测规则，语义检测被跳过"
}
]
}
匹配逻辑支持四通道：手动指定 → 名称关键词 → 编码前缀 → 流程字段关键词。
配置包机制
本插件采用通用检测引擎 + 可替换配置包架构。插件本体不含任何地区特定的政策标准，所有地区差异通过配置包注入。新增地区配置包无需修改插件代码。
架构原理
┌─────────────────────────┐ ┌──────────────────────────┐
│ 通用检测引擎（插件） │◄────│ 地区配置包（可替换） │
│ - 格式校验 │ │ - 政策依据 │
│ - 语义检测 │ │ - 必填字段 │
│ - 逻辑检测 │ │ - 格式规则 │
│ - 评分计算 │ │ - 标准词表 │
│ - 分类判定 │ │ - 数据源凭证 │
└─────────────────────────┘ └──────────────────────────┘
配置包加载优先级
插件按以下三级优先级加载配置包：
- 文件路径（
GOV_CONFIG_PACK_PATH 环境变量）— 加载指定 JSON 文件
- npm 包（
GOV_CONFIG_PACK_PACKAGE 环境变量）— 加载已安装的 npm 配置包
- 缺省配置包 — 插件内置的通用配置包，作为兜底
每级加载成功后执行 Schema 校验，校验失败则记录告警并尝试下一级。三级全部失败时抛出 GOV_CONFIG_PACK_UNAVAILABLE 错误。
环境变量
| 环境变量 | 说明 | 示例 |
|---|
GOV_CONFIG_PACK_PATH | 配置包 JSON 文件的绝对或相对路径 | /path/to/config-pack.json |
GOV_CONFIG_PACK_PACKAGE | 已安装的 npm 配置包包名 | @liuhange/gov-config-gd |
两个环境变量均为可选。同时设置时，GOV_CONFIG_PACK_PATH 优先于 GOV_CONFIG_PACK_PACKAGE。均未设置时使用缺省配置包。
巡检报告来源标注
加载配置包后，巡检报告包含以下来源标注字段：
{
"configPackId": "gd-gov-2026",
"region": "广东省",
"configPackVersion": "2026.1.0"
}
使用缺省配置包时，configPackId 为 default，region 为 通用。
如何新增地区配置包
配置包字段清单
配置包 JSON 文件包含以下 14 个必填字段与 5 个可选字段：
| 字段 | 类型 | 必填 | 说明 |
|---|
configPackId | string | 是 | 配置包标识，格式 ^[a-z]{2}-[a-z]+-\d{4}$ |
region | string | 是 | 地区名称 |
configPackVersion | string | 是 | 语义化版本号 |
policyBasis | array | 是 | 政策依据文档列表 |
requiredFields | string[] | 是 | 办事指南必填字段列表 |
formatRules | array | 是 | 格式校验规则（含正则） |
localStandardTerms | object | 是 | 本地标准词表（materials + conditions） |
logicErrorRules | array | 是 | 逻辑错误检测规则 |
scoringWeights | object | 是 | 评分权重（completeness + accuracy + traceability，和为 1） |
itemTypeMatching | object | 是 | 事项类型匹配规则 |
severityMapping | object | 是 | 严重等级映射 |
gbtMapping | object | 是 | GB/T 47949 分类映射 |
dataSourceCredentials | object | 是 | 数据源凭证配置 |
dataSourcePriority | string[] | 是 | 数据源优先级 |
convenienceWeights | object | 否 | 便利度权重 |
materialConciseThreshold | number | 否 | 材料精简阈值 |
missingFieldStandardClause | string | 否 | 缺失字段标准条款引用 |
degradedSimilarityThreshold | number | 否 | 降级相似度阈值 |
inputLengthThreshold | number | 否 | 输入长度阈值 |
字段名兼容映射
配置包支持新旧字段名兼容。当旧名字段存在而新名字段缺失时，自动映射：
| 新字段名 | 旧字段名（兼容） |
|---|
requiredFields | guideRequiredElements |
scoringWeights | scoreWeights |
gbtMapping | gbt47949Mapping |
新名与旧名同时存在时，新名优先。
创建步骤
-
创建配置包 JSON 文件：按上述字段清单编写 config-pack.json，填入目标地区的政策依据、标准词表等
-
Schema 校验：使用 @liuhange/gov-config-schema 包离线校验配置包内容
-
创建 npm 包：package.json 中 name 使用 scoped 命名 @liuhange/gov-config-{地区缩写}，exports 指向 config-pack.json
-
发布：npm publish --access public
-
使用：安装配置包后设置环境变量 GOV_CONFIG_PACK_PACKAGE=@liuhange/gov-config-{地区缩写}
已有地区配置包
| 包名 | 地区 | 版本 |
|---|
@liuhange/gov-config-gd | 广东省 | 2026.1.0 |
@liuhange/gov-config-zj | 浙江省 | 2026.1.0 |
@liuhange/gov-config-schema | Schema 校验工具 | 2026.1.0 |
配置包交付周期
配置包独立于插件发布，遵循语义化版本管理：
- 政策更新时：配置包 minor 或 patch 版本升级（如
2026.1.0 → 2026.1.1），插件版本不变
- 新增地区配置包：新建 npm 包，初始版本
2026.1.0
- 配置包 Schema 变更：
@liuhange/gov-config-schema 版本升级，插件内嵌 Schema 同步更新
配置包维护者可通过 @liuhange/gov-config-schema 包离线校验配置包内容，无需安装完整插件。
