@liuhange/dsh-data-quality-scoring 2.0.1 → 2.0.2

package/package.json

@@ -1,39 +1,53 @@
-{
-    "name":  "@liuhange/dsh-data-quality-scoring",
-    "description":  "Data quality scoring plugin: multi-dimensional scoring (completeness/accuracy/consistency/timeliness) with weighted total and improvement suggestions",
-    "version": "2.0.1",
-    "publishConfig":  {
-                          "access":  "public"
-                      },
-    "repository":  {
-                       "type":  "git",
-                       "url":  "git+https://github.com/liuhange789/data-asset-inspector.git",
-                       "directory":  "packages/data-asset/data-quality-scoring"
-                   },
-    "type":  "module",
-    "main":  "lib/index.js",
-    "types":  "lib/types/index.d.ts",
-    "exports":  {
-                    ".":  {
-                              "types":  "./lib/types/index.d.ts",
-                              "default":  "./lib/index.js"
-                          },
-                    "./invariant":  {
-                                        "types":  "./lib/types/invariant.d.ts",
-                                        "default":  "./lib/invariant.js"
-                                    },
-                    "./src/*":  "./src/*",
-                    "./package.json":  "./package.json"
-                },
-    "files":  [
-                  "lib/index.js",
-                  "lib/invariant.js",
-                  "lib/types/**/*.d.ts"
-              ],
-    "license":  "MIT",
-    "peerDependencies":  {
-                             "@deepseek-ai/cordis":  "^0.1.0",
-                             "@deepseek-ai/dsh-tools":  "^0.1.0",
-                             "@liuhange/dsh-data-asset-shared":  "^2.0.0"
-                         }
-}
+{
+  "name": "@liuhange/dsh-data-quality-scoring",
+  "description": "Data quality scoring plugin: multi-dimensional scoring (completeness/accuracy/consistency/timeliness) with weighted total and improvement suggestions Also known as @deepseek-ai/dsh-data-quality-scoring.",
+  "version": "2.0.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/liuhange789/data-asset-inspector.git",
+    "directory": "packages/data-asset/data-quality-scoring"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "build": "tsc"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.0",
+    "@deepseek-ai/dsh-tools": "0.0.1-rc.1",
+    "@liuhange/dsh-data-asset-shared": "^2.0.0"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh-plugin",
+    "data-asset",
+    "data-asset-inspector",
+    "shujintong",
+    "数据资产"
+  ],
+  "homepage": "https://github.com/liuhange789/data-asset-inspector#readme"
+}

package/lib/index.js

@@ -1,662 +0,0 @@
-import { defineTool } from "@deepseek-ai/dsh-tools";
-import * as fs from "fs";
-import * as path from "path";
-import { AuditLogger, BusinessRulesLoader, FileFormatAdapter, PathValidator } from "@liuhange/dsh-data-asset-shared";
-//#region lib/types/defaultScoringRules.js
-const defaultScoringRules = {
-	weights: {
-		completeness: .25,
-		accuracy: .25,
-		consistency: .25,
-		timeliness: .25
-	},
-	thresholds: {
-		completeness: 60,
-		accuracy: 60,
-		consistency: 60,
-		timeliness: 60
-	},
-	completeness: { missingMarkers: [
-		"null",
-		"undefined",
-		"N/A",
-		"",
-		"NULL",
-		"NaN"
-	] },
-	accuracy: {
-		formatRules: [{
-			fieldName: "phone",
-			pattern: "1[3-9]\\d{9}",
-			weight: .5
-		}, {
-			fieldName: "email",
-			pattern: "[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}",
-			weight: .5
-		}],
-		domainRules: [{
-			fieldName: "age",
-			min: 0,
-			max: 150,
-			weight: .5
-		}, {
-			fieldName: "score",
-			min: 0,
-			max: 100,
-			weight: .5
-		}]
-	},
-	consistency: { crossFieldRules: [{
-		name: "endDateAfterStartDate",
-		fields: ["startDate", "endDate"],
-		constraint: "after"
-	}] },
-	timeliness: {
-		timestampField: "updatedAt",
-		freshnessThresholdHours: 720
-	}
-};
-//#endregion
-//#region lib/types/completenessScorer.js
-var CompletenessScorer = class {
-	score(context) {
-		const missingMarkers = context.config.completeness.missingMarkers;
-		const issues = [];
-		if (context.records.length === 0 || context.fieldNames.length === 0) return {
-			score: 0,
-			issues
-		};
-		let totalValues = 0;
-		let missingValues = 0;
-		for (let i = 0; i < context.records.length; i++) {
-			const record = context.records[i];
-			for (const fieldName of context.fieldNames) {
-				totalValues++;
-				const value = record[fieldName];
-				if (this.isMissing(value, missingMarkers)) {
-					missingValues++;
-					issues.push({
-						dimension: "completeness",
-						description: `字段 ${fieldName} 缺失`,
-						location: `行 ${i + 1}, 列 ${fieldName}`,
-						severity: "medium"
-					});
-				}
-			}
-		}
-		if (totalValues === 0) return {
-			score: 0,
-			issues
-		};
-		return {
-			score: Math.floor((totalValues - missingValues) / totalValues * 100),
-			issues
-		};
-	}
-	isMissing(value, markers) {
-		if (value === null || value === void 0) return true;
-		const strValue = String(value).trim();
-		return markers.includes(strValue);
-	}
-};
-//#endregion
-//#region lib/types/accuracyScorer.js
-var AccuracyScorer = class {
-	score(context) {
-		const config = context.config;
-		const issues = [];
-		if (context.records.length === 0) return {
-			score: 0,
-			issues
-		};
-		const formatRules = config.accuracy.formatRules;
-		const domainRules = config.accuracy.domainRules;
-		let formatCompliance = 1;
-		let formatWeightSum = 0;
-		let formatWeightedCompliance = 0;
-		for (const rule of formatRules) {
-			if (!context.fieldNames.includes(rule.fieldName)) {
-				issues.push({
-					dimension: "accuracy",
-					description: `格式规则引用字段 ${rule.fieldName} 不存在，已跳过`,
-					location: `格式规则 ${rule.fieldName}`,
-					severity: "low"
-				});
-				continue;
-			}
-			let compliant = 0;
-			let total = 0;
-			for (let i = 0; i < context.records.length; i++) {
-				const value = context.records[i][rule.fieldName];
-				if (value === null || value === void 0 || String(value).trim() === "") continue;
-				total++;
-				try {
-					if (new RegExp(rule.pattern).test(String(value))) compliant++;
-					else issues.push({
-						dimension: "accuracy",
-						description: `字段 ${rule.fieldName} 值 "${value}" 不符合格式规则`,
-						location: `行 ${i + 1}, 列 ${rule.fieldName}`,
-						severity: "medium"
-					});
-				} catch {
-					issues.push({
-						dimension: "accuracy",
-						description: `格式规则 ${rule.fieldName} 正则编译失败`,
-						location: `格式规则 ${rule.fieldName}`,
-						severity: "high"
-					});
-				}
-			}
-			if (total > 0) {
-				formatWeightedCompliance += compliant / total * rule.weight;
-				formatWeightSum += rule.weight;
-			}
-		}
-		if (formatWeightSum > 0) formatCompliance = formatWeightedCompliance / formatWeightSum;
-		let domainCompliance = 1;
-		let domainWeightSum = 0;
-		let domainWeightedCompliance = 0;
-		for (const rule of domainRules) {
-			if (!context.fieldNames.includes(rule.fieldName)) {
-				issues.push({
-					dimension: "accuracy",
-					description: `值域规则引用字段 ${rule.fieldName} 不存在，已跳过`,
-					location: `值域规则 ${rule.fieldName}`,
-					severity: "low"
-				});
-				continue;
-			}
-			let compliant = 0;
-			let total = 0;
-			for (let i = 0; i < context.records.length; i++) {
-				const value = context.records[i][rule.fieldName];
-				if (value === null || value === void 0 || String(value).trim() === "") continue;
-				total++;
-				const numValue = Number(value);
-				if (isNaN(numValue)) {
-					issues.push({
-						dimension: "accuracy",
-						description: `字段 ${rule.fieldName} 值 "${value}" 不是数字，无法校验值域`,
-						location: `行 ${i + 1}, 列 ${rule.fieldName}`,
-						severity: "medium"
-					});
-					continue;
-				}
-				if (rule.min !== void 0 && rule.max !== void 0) if (numValue >= rule.min && numValue <= rule.max) compliant++;
-				else issues.push({
-					dimension: "accuracy",
-					description: `字段 ${rule.fieldName} 值 ${numValue} 超出值域 [${rule.min}, ${rule.max}]`,
-					location: `行 ${i + 1}, 列 ${rule.fieldName}`,
-					severity: "medium"
-				});
-				else if (rule.allowedValues !== void 0) if (rule.allowedValues.includes(value)) compliant++;
-				else issues.push({
-					dimension: "accuracy",
-					description: `字段 ${rule.fieldName} 值 "${value}" 不在允许值列表中`,
-					location: `行 ${i + 1}, 列 ${rule.fieldName}`,
-					severity: "medium"
-				});
-			}
-			if (total > 0) {
-				domainWeightedCompliance += compliant / total * rule.weight;
-				domainWeightSum += rule.weight;
-			}
-		}
-		if (domainWeightSum > 0) domainCompliance = domainWeightedCompliance / domainWeightSum;
-		return {
-			score: Math.floor((formatCompliance * .5 + domainCompliance * .5) * 100),
-			issues
-		};
-	}
-};
-//#endregion
-//#region lib/types/consistencyScorer.js
-var ConsistencyScorer = class {
-	score(context) {
-		const config = context.config;
-		const issues = [];
-		if (context.records.length === 0) return {
-			score: 0,
-			issues
-		};
-		const rules = config.consistency.crossFieldRules;
-		let totalChecks = 0;
-		let satisfiedChecks = 0;
-		for (const rule of rules) {
-			const missingFields = rule.fields.filter((f) => !context.fieldNames.includes(f));
-			if (missingFields.length > 0) {
-				issues.push({
-					dimension: "consistency",
-					description: `约束规则引用字段 ${missingFields.join(", ")} 不存在，已跳过`,
-					location: `约束规则 ${rule.name}`,
-					severity: "low"
-				});
-				continue;
-			}
-			for (let i = 0; i < context.records.length; i++) {
-				const record = context.records[i];
-				const result = this.checkConstraint(record, rule);
-				totalChecks++;
-				if (result.satisfied) satisfiedChecks++;
-				else issues.push({
-					dimension: "consistency",
-					description: `约束规则 ${rule.name} 不满足: ${result.reason}`,
-					location: `行 ${i + 1}`,
-					severity: "medium"
-				});
-			}
-		}
-		if (totalChecks === 0) return {
-			score: 100,
-			issues
-		};
-		return {
-			score: Math.floor(satisfiedChecks / totalChecks * 100),
-			issues
-		};
-	}
-	checkConstraint(record, rule) {
-		const fields = rule.fields;
-		const constraint = rule.constraint;
-		if (constraint === "after" && fields.length >= 2) {
-			const before = record[fields[0]];
-			const after = record[fields[1]];
-			if (before === null || before === void 0 || after === null || after === void 0) return {
-				satisfied: true,
-				reason: "字段为空，跳过约束"
-			};
-			const beforeDate = new Date(String(before));
-			if (new Date(String(after)) >= beforeDate) return {
-				satisfied: true,
-				reason: ""
-			};
-			return {
-				satisfied: false,
-				reason: `${fields[1]}(${after}) 早于 ${fields[0]}(${before})`
-			};
-		}
-		if (constraint === "before" && fields.length >= 2) {
-			const before = record[fields[0]];
-			const after = record[fields[1]];
-			if (before === null || before === void 0 || after === null || after === void 0) return {
-				satisfied: true,
-				reason: "字段为空，跳过约束"
-			};
-			if (new Date(String(before)) < new Date(String(after))) return {
-				satisfied: true,
-				reason: ""
-			};
-			return {
-				satisfied: false,
-				reason: `${fields[0]}(${before}) 不早于 ${fields[1]}(${after})`
-			};
-		}
-		if (constraint === "equal" && fields.length >= 2) {
-			const v1 = record[fields[0]];
-			const v2 = record[fields[1]];
-			if (v1 === v2) return {
-				satisfied: true,
-				reason: ""
-			};
-			return {
-				satisfied: false,
-				reason: `${fields[0]}(${v1}) 不等于 ${fields[1]}(${v2})`
-			};
-		}
-		if (constraint === "notEqual" && fields.length >= 2) {
-			const v1 = record[fields[0]];
-			const v2 = record[fields[1]];
-			if (v1 !== v2) return {
-				satisfied: true,
-				reason: ""
-			};
-			return {
-				satisfied: false,
-				reason: `${fields[0]}(${v1}) 等于 ${fields[1]}(${v2})`
-			};
-		}
-		if (constraint === "greaterThan" && fields.length >= 1) {
-			const v = record[fields[0]];
-			const threshold = rule.value;
-			if (v === null || v === void 0 || threshold === void 0) return {
-				satisfied: true,
-				reason: "字段为空，跳过约束"
-			};
-			if (Number(v) > Number(threshold)) return {
-				satisfied: true,
-				reason: ""
-			};
-			return {
-				satisfied: false,
-				reason: `${fields[0]}(${v}) 不大于 ${threshold}`
-			};
-		}
-		if (constraint === "lessThan" && fields.length >= 1) {
-			const v = record[fields[0]];
-			const threshold = rule.value;
-			if (v === null || v === void 0 || threshold === void 0) return {
-				satisfied: true,
-				reason: "字段为空，跳过约束"
-			};
-			if (Number(v) < Number(threshold)) return {
-				satisfied: true,
-				reason: ""
-			};
-			return {
-				satisfied: false,
-				reason: `${fields[0]}(${v}) 不小于 ${threshold}`
-			};
-		}
-		return {
-			satisfied: true,
-			reason: `未知约束类型: ${constraint}`
-		};
-	}
-};
-//#endregion
-//#region lib/types/timelinessScorer.js
-var TimelinessScorer = class {
-	score(context) {
-		const config = context.config;
-		const issues = [];
-		if (context.records.length === 0) return {
-			score: 0,
-			issues
-		};
-		const timestampField = config.timeliness.timestampField;
-		const thresholdHours = config.timeliness.freshnessThresholdHours;
-		if (!context.fieldNames.includes(timestampField)) {
-			issues.push({
-				dimension: "timeliness",
-				description: `时间戳字段 ${timestampField} 不存在`,
-				location: `时间戳字段 ${timestampField}`,
-				severity: "high"
-			});
-			return {
-				score: 0,
-				issues
-			};
-		}
-		const now = Date.now();
-		const thresholdMs = thresholdHours * 60 * 60 * 1e3;
-		let staleCount = 0;
-		let validCount = 0;
-		for (let i = 0; i < context.records.length; i++) {
-			const timestampValue = context.records[i][timestampField];
-			if (timestampValue === null || timestampValue === void 0 || String(timestampValue).trim() === "") continue;
-			const recordTime = new Date(String(timestampValue)).getTime();
-			if (isNaN(recordTime)) {
-				issues.push({
-					dimension: "timeliness",
-					description: `时间戳值 "${timestampValue}" 无法解析为日期`,
-					location: `行 ${i + 1}, 列 ${timestampField}`,
-					severity: "medium"
-				});
-				continue;
-			}
-			validCount++;
-			const age = now - recordTime;
-			if (age > thresholdMs) {
-				staleCount++;
-				issues.push({
-					dimension: "timeliness",
-					description: `数据已过期，距今 ${Math.floor(age / (3600 * 1e3))} 小时`,
-					location: `行 ${i + 1}, 列 ${timestampField}`,
-					severity: "medium"
-				});
-			}
-		}
-		if (validCount === 0) return {
-			score: 0,
-			issues
-		};
-		const staleRatio = staleCount / validCount;
-		return {
-			score: Math.floor((1 - staleRatio) * 100),
-			issues
-		};
-	}
-};
-//#endregion
-//#region lib/types/weightedScoreCalculator.js
-var WeightedScoreCalculator = class {
-	calculate(dimensions, weights) {
-		const weightSum = weights.completeness + weights.accuracy + weights.consistency + weights.timeliness;
-		let normalizedWeights = { ...weights };
-		let weightsNormalized = false;
-		if (weightSum !== 1) {
-			normalizedWeights = {
-				completeness: weights.completeness / weightSum,
-				accuracy: weights.accuracy / weightSum,
-				consistency: weights.consistency / weightSum,
-				timeliness: weights.timeliness / weightSum
-			};
-			weightsNormalized = true;
-		}
-		return {
-			totalScore: Math.floor(dimensions.completeness.score * normalizedWeights.completeness + dimensions.accuracy.score * normalizedWeights.accuracy + dimensions.consistency.score * normalizedWeights.consistency + dimensions.timeliness.score * normalizedWeights.timeliness),
-			weightsNormalized,
-			normalizedWeights
-		};
-	}
-};
-//#endregion
-//#region lib/types/issueCollector.js
-var IssueCollector = class {
-	collect(dimensionResults) {
-		const issues = [];
-		for (const result of dimensionResults) issues.push(...result.issues);
-		return issues;
-	}
-};
-//#endregion
-//#region lib/types/suggestionGenerator.js
-var SuggestionGenerator = class {
-	generate(dimensions, thresholds) {
-		const suggestions = [];
-		if (dimensions.completeness.score < thresholds.completeness) suggestions.push(`完整性得分 ${dimensions.completeness.score} 低于阈值 ${thresholds.completeness}，建议补充缺失字段数据或使用插值/众数填充`);
-		if (dimensions.accuracy.score < thresholds.accuracy) suggestions.push(`准确性得分 ${dimensions.accuracy.score} 低于阈值 ${thresholds.accuracy}，建议校验数据格式和值域，修正不合规记录`);
-		if (dimensions.consistency.score < thresholds.consistency) suggestions.push(`一致性得分 ${dimensions.consistency.score} 低于阈值 ${thresholds.consistency}，建议检查跨字段约束规则，修正逻辑冲突记录`);
-		if (dimensions.timeliness.score < thresholds.timeliness) suggestions.push(`时效性得分 ${dimensions.timeliness.score} 低于阈值 ${thresholds.timeliness}，建议更新过期数据或调整时效阈值`);
-		return suggestions;
-	}
-};
-//#endregion
-//#region lib/types/qualityReportGenerator.js
-var QualityReportGenerator = class {
-	async writeJson(filePath, result) {
-		const dir = path.dirname(filePath);
-		if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-		const jsonContent = {
-			dimensions: result.dimensions,
-			totalScore: result.totalScore,
-			issues: result.issues,
-			suggestions: result.suggestions,
-			weightsNormalized: result.weightsNormalized,
-			scoredAt: result.scoredAt
-		};
-		fs.writeFileSync(filePath, JSON.stringify(jsonContent, null, 2), "utf-8");
-	}
-	async writeMarkdown(filePath, result) {
-		const dir = path.dirname(filePath);
-		if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-		const lines = [];
-		lines.push("【数据质量评分报告】");
-		lines.push("");
-		lines.push(`> 评分时间: ${result.scoredAt}`);
-		lines.push(`> 总分: ${result.totalScore} 分`);
-		lines.push("");
-		lines.push("## 维度得分");
-		lines.push("");
-		lines.push("| 维度 | 得分 | 权重 | 是否归一化 |");
-		lines.push("|------|------|------|-----------|");
-		lines.push(`| 完整性 | ${result.dimensions.completeness.score} | ${result.dimensions.completeness.weight} | ${result.weightsNormalized ? "是" : "否"} |`);
-		lines.push(`| 准确性 | ${result.dimensions.accuracy.score} | ${result.dimensions.accuracy.weight} | ${result.weightsNormalized ? "是" : "否"} |`);
-		lines.push(`| 一致性 | ${result.dimensions.consistency.score} | ${result.dimensions.consistency.weight} | ${result.weightsNormalized ? "是" : "否"} |`);
-		lines.push(`| 时效性 | ${result.dimensions.timeliness.score} | ${result.dimensions.timeliness.weight} | ${result.weightsNormalized ? "是" : "否"} |`);
-		lines.push("");
-		lines.push("## 问题明细");
-		lines.push("");
-		if (result.issues.length === 0) lines.push("无问题");
-		else {
-			lines.push("| 维度 | 描述 | 位置 | 严重程度 |");
-			lines.push("|------|------|------|---------|");
-			for (const issue of result.issues) lines.push(`| ${issue.dimension} | ${issue.description} | ${issue.location} | ${issue.severity} |`);
-		}
-		lines.push("");
-		lines.push("## 改进建议");
-		lines.push("");
-		if (result.suggestions.length === 0) lines.push("各维度得分均高于阈值，无需改进");
-		else for (const suggestion of result.suggestions) lines.push(`- ${suggestion}`);
-		lines.push("");
-		lines.push("## 配置状态");
-		lines.push("");
-		lines.push(`- 权重是否归一化: ${result.weightsNormalized ? "是" : "否"}`);
-		lines.push(`- 问题总数: ${result.issues.length}`);
-		lines.push(`- 建议总数: ${result.suggestions.length}`);
-		fs.writeFileSync(filePath, lines.join("\n"), "utf-8");
-	}
-};
-//#endregion
-//#region lib/types/index.js
-const name = "data-quality-scoring";
-const inject = ["tools"];
-function parseRecords(lines, format) {
-	if (format === "csv" && lines.length > 0) {
-		const header = lines[0].split(",");
-		const records = [];
-		for (let i = 1; i < lines.length; i++) {
-			const values = lines[i].split(",");
-			const record = {};
-			for (let j = 0; j < header.length; j++) record[header[j]] = values[j] ?? "";
-			records.push(record);
-		}
-		return records;
-	}
-	if (format === "json") {
-		const records = [];
-		for (const line of lines) try {
-			const parsed = JSON.parse(line);
-			if (typeof parsed === "object" && parsed !== null) records.push(parsed);
-		} catch {}
-		return records;
-	}
-	return [];
-}
-function buildDimensionScore(result, weight, normalizedWeight) {
-	return {
-		score: result.score,
-		weight,
-		weightNormalized: normalizedWeight,
-		issues: result.issues
-	};
-}
-function buildDimensions(completeness, accuracy, consistency, timeliness, weights, normalizedWeights) {
-	return {
-		completeness: buildDimensionScore(completeness, weights.completeness, normalizedWeights.completeness),
-		accuracy: buildDimensionScore(accuracy, weights.accuracy, normalizedWeights.accuracy),
-		consistency: buildDimensionScore(consistency, weights.consistency, normalizedWeights.consistency),
-		timeliness: buildDimensionScore(timeliness, weights.timeliness, normalizedWeights.timeliness)
-	};
-}
-function apply(ctx) {
-	const loader = new BusinessRulesLoader();
-	const formatAdapter = new FileFormatAdapter();
-	const pathValidator = new PathValidator();
-	const auditLogger = new AuditLogger();
-	const completenessScorer = new CompletenessScorer();
-	const accuracyScorer = new AccuracyScorer();
-	const consistencyScorer = new ConsistencyScorer();
-	const timelinessScorer = new TimelinessScorer();
-	const weightedCalculator = new WeightedScoreCalculator();
-	const issueCollector = new IssueCollector();
-	const suggestionGenerator = new SuggestionGenerator();
-	const reportGenerator = new QualityReportGenerator();
-	ctx.tools.register(defineTool({
-		name: "score_data_quality",
-		description: "对数据文件进行多维度质量评分（完整性/准确性/一致性/时效性），生成质量评分报告",
-		parameters: {
-			filePath: {
-				type: "string",
-				required: true,
-				description: "待评分数据文件的路径"
-			},
-			outputPathDir: {
-				type: "string",
-				description: "报告输出目录（默认数据文件所在目录）"
-			}
-		},
-		output: {
-			schema: { type: "string" },
-			render: (_args, value) => [{
-				type: "text",
-				text: value
-			}]
-		},
-		async execute(args) {
-			const { config, status: configStatus } = loader.load();
-			const workingDir = process.cwd();
-			const filePath = args.filePath;
-			const outputPathDir = args.outputPathDir ?? path.dirname(path.resolve(filePath));
-			try {
-				pathValidator.validate(filePath, workingDir);
-			} catch {
-				return `错误：路径不合法 - ${filePath}`;
-			}
-			const fullPath = path.resolve(filePath);
-			if (!fs.existsSync(fullPath)) return `错误：文件不存在 - ${fullPath}`;
-			const scoringConfig = config.qualityScoring ?? defaultScoringRules;
-			const readResult = await formatAdapter.read(fullPath);
-			const records = parseRecords(readResult.lines, readResult.format);
-			const context = {
-				records,
-				fieldNames: records.length > 0 ? Object.keys(records[0]) : [],
-				config: scoringConfig
-			};
-			const completenessResult = completenessScorer.score(context);
-			const accuracyResult = accuracyScorer.score(context);
-			const consistencyResult = consistencyScorer.score(context);
-			const timelinessResult = timelinessScorer.score(context);
-			const weights = scoringConfig.weights;
-			const tempDimensions = buildDimensions(completenessResult, accuracyResult, consistencyResult, timelinessResult, weights, weights);
-			const { totalScore, weightsNormalized, normalizedWeights } = weightedCalculator.calculate(tempDimensions, weights);
-			const dimensions = buildDimensions(completenessResult, accuracyResult, consistencyResult, timelinessResult, weights, normalizedWeights);
-			const scoringResult = {
-				totalScore,
-				dimensions,
-				issues: issueCollector.collect([
-					completenessResult,
-					accuracyResult,
-					consistencyResult,
-					timelinessResult
-				]),
-				suggestions: suggestionGenerator.generate(dimensions, scoringConfig.thresholds),
-				weightsNormalized,
-				scoredAt: (/* @__PURE__ */ new Date()).toISOString()
-			};
-			const jsonReportPath = path.join(outputPathDir, "quality_report.json");
-			const markdownReportPath = path.join(outputPathDir, "quality_report.md");
-			await reportGenerator.writeJson(jsonReportPath, scoringResult);
-			await reportGenerator.writeMarkdown(markdownReportPath, scoringResult);
-			auditLogger.log({
-				pluginName: "data-quality-scoring",
-				operation: "score_data_quality",
-				inputPath: fullPath,
-				outputPath: jsonReportPath,
-				result: "SUCCESS"
-			});
-			return JSON.stringify({
-				jsonReportPath,
-				markdownReportPath,
-				report: scoringResult,
-				totalScore,
-				dimensions,
-				status: "SUCCESS",
-				configStatus
-			}, null, 2);
-		}
-	}));
-	console.log("[data-quality-scoring] 数据质量评分插件已加载");
-}
-//#endregion
-export { apply, inject, name };

package/lib/invariant.js

@@ -1,5 +0,0 @@
-//#region lib/types/invariant.js
-const invariant = "data-quality-scoring";
-function install() {}
-//#endregion
-export { install, invariant };

package/lib/types/accuracyScorer.d.ts

@@ -1,5 +0,0 @@
-import type { ScoringContext, DimensionScoringResult } from './types.js';
-export declare class AccuracyScorer {
-    score(context: ScoringContext): DimensionScoringResult;
-}
-//# sourceMappingURL=accuracyScorer.d.ts.map

package/lib/types/completenessScorer.d.ts

@@ -1,6 +0,0 @@
-import type { ScoringContext, DimensionScoringResult } from './types.js';
-export declare class CompletenessScorer {
-    score(context: ScoringContext): DimensionScoringResult;
-    private isMissing;
-}
-//# sourceMappingURL=completenessScorer.d.ts.map

package/lib/types/consistencyScorer.d.ts

@@ -1,6 +0,0 @@
-import type { ScoringContext, DimensionScoringResult } from './types.js';
-export declare class ConsistencyScorer {
-    score(context: ScoringContext): DimensionScoringResult;
-    private checkConstraint;
-}
-//# sourceMappingURL=consistencyScorer.d.ts.map

package/lib/types/defaultScoringRules.d.ts

@@ -1,3 +0,0 @@
-import type { QualityScoringConfig } from '@liuhange/dsh-data-asset-shared';
-export declare const defaultScoringRules: QualityScoringConfig;
-//# sourceMappingURL=defaultScoringRules.d.ts.map

package/lib/types/index.d.ts

@@ -1,5 +0,0 @@
-import type { Context } from '@deepseek-ai/cordis';
-export declare const name = "data-quality-scoring";
-export declare const inject: string[];
-export declare function apply(ctx: Context): void;
-//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -1,3 +0,0 @@
-export declare const invariant = "data-quality-scoring";
-export declare function install(): void;
-//# sourceMappingURL=invariant.d.ts.map

package/lib/types/issueCollector.d.ts

@@ -1,5 +0,0 @@
-import type { DimensionScoringResult, QualityIssue } from './types.js';
-export declare class IssueCollector {
-    collect(dimensionResults: DimensionScoringResult[]): QualityIssue[];
-}
-//# sourceMappingURL=issueCollector.d.ts.map

package/lib/types/qualityReportGenerator.d.ts

@@ -1,6 +0,0 @@
-import type { QualityScoringResult } from './types.js';
-export declare class QualityReportGenerator {
-    writeJson(filePath: string, result: QualityScoringResult): Promise<void>;
-    writeMarkdown(filePath: string, result: QualityScoringResult): Promise<void>;
-}
-//# sourceMappingURL=qualityReportGenerator.d.ts.map

package/lib/types/suggestionGenerator.d.ts

@@ -1,6 +0,0 @@
-import type { QualityDimensions } from './types.js';
-import type { QualityScoringConfig } from '@liuhange/dsh-data-asset-shared';
-export declare class SuggestionGenerator {
-    generate(dimensions: QualityDimensions, thresholds: QualityScoringConfig['thresholds']): string[];
-}
-//# sourceMappingURL=suggestionGenerator.d.ts.map

package/lib/types/timelinessScorer.d.ts

@@ -1,5 +0,0 @@
-import type { ScoringContext, DimensionScoringResult } from './types.js';
-export declare class TimelinessScorer {
-    score(context: ScoringContext): DimensionScoringResult;
-}
-//# sourceMappingURL=timelinessScorer.d.ts.map

package/lib/types/types.d.ts

@@ -1,54 +0,0 @@
-export type QualityDimension = 'completeness' | 'accuracy' | 'consistency' | 'timeliness';
-export type IssueSeverity = 'low' | 'medium' | 'high';
-export interface ScoreDataQualityParams {
-    filePath: string;
-    outputPathDir?: string;
-}
-export interface QualityIssue {
-    dimension: QualityDimension;
-    description: string;
-    location: string;
-    severity: IssueSeverity;
-}
-export interface DimensionScore {
-    score: number;
-    weight: number;
-    weightNormalized: number;
-    subScores?: Record<string, number>;
-    issues: QualityIssue[];
-    suggestion?: string;
-}
-export interface QualityDimensions {
-    completeness: DimensionScore;
-    accuracy: DimensionScore;
-    consistency: DimensionScore;
-    timeliness: DimensionScore;
-}
-export interface QualityScoringResult {
-    totalScore: number;
-    dimensions: QualityDimensions;
-    issues: QualityIssue[];
-    suggestions: string[];
-    weightsNormalized: boolean;
-    scoredAt: string;
-}
-export interface ScoreDataQualityResult {
-    jsonReportPath: string;
-    markdownReportPath: string;
-    report: QualityScoringResult;
-    totalScore: number;
-    dimensions: QualityDimensions;
-    status: 'SUCCESS' | 'FAILED';
-    configStatus: string;
-}
-export interface ScoringContext {
-    records: Record<string, unknown>[];
-    fieldNames: string[];
-    config: unknown;
-}
-export interface DimensionScoringResult {
-    score: number;
-    issues: QualityIssue[];
-    subScores?: Record<string, number>;
-}
-//# sourceMappingURL=types.d.ts.map

package/lib/types/weightedScoreCalculator.d.ts

@@ -1,10 +0,0 @@
-import type { QualityDimensions } from './types.js';
-import type { QualityScoringConfig } from '@liuhange/dsh-data-asset-shared';
-export declare class WeightedScoreCalculator {
-    calculate(dimensions: QualityDimensions, weights: QualityScoringConfig['weights']): {
-        totalScore: number;
-        weightsNormalized: boolean;
-        normalizedWeights: QualityScoringConfig['weights'];
-    };
-}
-//# sourceMappingURL=weightedScoreCalculator.d.ts.map