@liuhange/dsh-gov-data-inspector 3.1.2 → 3.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 liuhange789
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -36,3 +36,80 @@ apply(ctx); // 注册工具: inspect_gov_data
 ## License
 
 MIT
+## 无凭据降级模式
+
+当官方数据源（国家/省级）凭据未配置或不可达时，插件自动进入**降级模式**而非中止运行。
+
+### 降级触发条件
+
+- 国家和省级数据源均未配置 API Key / Endpoint
+- 国家和省级数据源均不可达（网络超时、HTTP 错误等）
+
+### 降级表现
+
+| 检测模式 | 完整模式表现 | 降级模式表现 |
+|---------|------------|------------|
+| classification | 正常分类 | **正常分类**（不依赖知识库） |
+| guide | 语义检测基于官方知识库 | 语义检测降级为本地规则检测 |
+| full | 全量检测 | 分类正常 + 语义/逻辑降级 |
+
+### 降级标记
+
+降级模式下，巡检报告包含以下额外字段：
+
+```json
+{
+  "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` 参数手动指定：
+
+```javascript
+execute({
+  dataSource: './data.json',
+  inspectionMode: 'guide',
+  itemTypeOverride: '现场勘查类'
+})
+```
+
+### 未匹配事项类型警告
+
+当事项无法匹配到任何检测规则时，报告中会包含 `UNMATCHED_ITEM_TYPE` 警告：
+
+```json
+{
+  "warnings": [
+    {
+      "type": "UNMATCHED_ITEM_TYPE",
+      "guideId": "建设工程规划核实",
+      "message": "该事项未匹配到检测规则，语义检测被跳过"
+    }
+  ]
+}
+```
+
+匹配逻辑支持四通道：手动指定 → 名称关键词 → 编码前缀 → 流程字段关键词。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@liuhange/dsh-gov-data-inspector",
   "description": "Government data inspection plugin: service guide quality check and public data asset classification",
-  "version": "3.1.2",
+  "version": "3.1.3",
   "publishConfig": {
     "access": "public"
   },
@@ -26,11 +26,6 @@
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
-  "scripts": {
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "build": "tsc"
-  },
   "dependencies": {
     "@liuhange/dsh-data-asset-shared": "^3.1.0"
   },
@@ -40,7 +35,7 @@
   },
   "dsh": {
     "bundle": {
-      "patch": true
+      "patch": "./cordis.patch.yml"
     }
   },
   "keywords": [
@@ -56,7 +51,22 @@
     "gbt-47949",
     "政务数据",
     "公共数据",
-    "办事指南"
+    "办事指南",
+    "dsh",
+    "typescript",
+    "nodejs",
+    "automation",
+    "audit",
+    "compliance",
+    "data-governance",
+    "data-quality",
+    "plugin",
+    "open-source"
   ],
-  "homepage": "https://github.com/liuhange789/data-asset-inspector#readme"
-}
+  "homepage": "https://github.com/liuhange789/data-asset-inspector#readme",
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "build": "tsc"
+  }
+}