npm - @liuhange/dsh-data-asset-shared - Versions diffs - 2.0.2 → 3.0.0 - Mend

@liuhange/dsh-data-asset-shared 2.0.2 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/lib/auditLogger.js +26 -0
package/lib/businessRulesLoader.js +86 -0
package/lib/defaultBusinessRules.js +324 -0
package/lib/fileFormatAdapter.js +98 -0
package/lib/index.js +3 -0
package/lib/pathValidator.js +18 -0
package/lib/policyReferenceResolver.js +64 -0
package/lib/registrationNavigationEnhancer.js +107 -0
package/lib/reportGenerator.js +84 -0
package/lib/types/defaultBusinessRules.d.ts +3 -1
package/lib/types/index.d.ts +3 -0
package/lib/types/policyReferenceResolver.d.ts +13 -0
package/lib/types/registrationNavigationEnhancer.d.ts +12 -0
package/lib/types/types.d.ts +88 -0
package/lib/types.js +2 -0
package/package.json +4 -5

package/lib/auditLogger.js ADDED Viewed

@@ -0,0 +1,26 @@
+import * as fs from 'fs';
+import * as path from 'path';
+export class AuditLogger {
+    logDir;
+    constructor(logDir) {
+        this.logDir = logDir ?? path.resolve(process.cwd(), 'logs');
+    }
+    log(params) {
+        const timestamp = new Date().toISOString();
+        const operator = params.operator ?? 'system';
+        const logLine = `[${params.pluginName}] ${timestamp} | 操作: ${params.operation} | 操作人: ${operator} | 输入: ${params.inputPath} | 输出: ${params.outputPath} | 结果: ${params.result}`;
+        console.log(logLine);
+        if (params.writeToFile) {
+            this.writeToFile(logLine);
+        }
+    }
+    writeToFile(logLine) {
+        if (!fs.existsSync(this.logDir)) {
+            fs.mkdirSync(this.logDir, { recursive: true });
+        }
+        const date = new Date().toISOString().split('T')[0];
+        const logFile = path.join(this.logDir, `audit-${date}.log`);
+        fs.appendFileSync(logFile, logLine + '\n', 'utf-8');
+    }
+}
+//# sourceMappingURL=auditLogger.js.map

package/lib/businessRulesLoader.js ADDED Viewed

@@ -0,0 +1,86 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { defaultBusinessRules } from './defaultBusinessRules.js';
+export class BusinessRulesLoader {
+    cachedResult = null;
+    configPath;
+    constructor(configPath) {
+        this.configPath = configPath
+            ? path.resolve(configPath)
+            : path.resolve(process.cwd(), 'config', 'business-rules.json');
+    }
+    load() {
+        if (this.cachedResult) {
+            return this.cachedResult;
+        }
+        const result = this.loadInternal();
+        this.cachedResult = result;
+        return result;
+    }
+    loadInternal() {
+        if (!fs.existsSync(this.configPath)) {
+            return this.createDefaultResult('DEFAULT_MISSING');
+        }
+        let raw;
+        try {
+            raw = fs.readFileSync(this.configPath, 'utf-8');
+        }
+        catch {
+            return this.createDefaultResult('DEFAULT_PARSE');
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            return this.createDefaultResult('DEFAULT_PARSE');
+        }
+        if (!this.isBusinessRulesConfig(parsed)) {
+            return this.createDefaultResult('DEFAULT_PARSE');
+        }
+        if (!this.isVersionCompatible(parsed.version)) {
+            return this.createDefaultResult('DEFAULT_VERSION');
+        }
+        if (!this.hasRequiredNodes(parsed)) {
+            return this.createDefaultResult('DEFAULT_PARTIAL');
+        }
+        return {
+            config: parsed,
+            status: 'CONFIG_LOADED',
+        };
+    }
+    createDefaultResult(status) {
+        return {
+            config: defaultBusinessRules,
+            status,
+        };
+    }
+    isBusinessRulesConfig(value) {
+        return (typeof value === 'object' &&
+            value !== null &&
+            'version' in value &&
+            'valueAssessment' in value &&
+            'sensitivePatterns' in value &&
+            'cleaningRules' in value &&
+            'compliance' in value &&
+            'packaging' in value);
+    }
+    isVersionCompatible(version) {
+        if (typeof version !== 'string') {
+            return false;
+        }
+        return version.startsWith('1.') || version.startsWith('3.');
+    }
+    hasRequiredNodes(config) {
+        return (config.valueAssessment !== undefined &&
+            config.sensitivePatterns !== undefined &&
+            config.maskingLevels !== undefined &&
+            config.cleaningRules !== undefined &&
+            config.compliance !== undefined &&
+            config.packaging !== undefined);
+    }
+    clearCache() {
+        this.cachedResult = null;
+    }
+}
+//# sourceMappingURL=businessRulesLoader.js.map

package/lib/defaultBusinessRules.js ADDED Viewed

@@ -0,0 +1,324 @@
+export const defaultQualityScoringConfig = {
+    weights: {
+        completeness: 0.25,
+        accuracy: 0.25,
+        consistency: 0.25,
+        timeliness: 0.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: 0.5 },
+            { fieldName: 'email', pattern: '[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}', weight: 0.5 },
+        ],
+        domainRules: [
+            { fieldName: 'age', min: 0, max: 150, weight: 0.5 },
+            { fieldName: 'score', min: 0, max: 100, weight: 0.5 },
+        ],
+    },
+    consistency: {
+        crossFieldRules: [
+            { name: 'endDateAfterStartDate', fields: ['startDate', 'endDate'], constraint: 'after' },
+        ],
+    },
+    timeliness: {
+        timestampField: 'updatedAt',
+        freshnessThresholdHours: 720,
+    },
+};
+export const defaultLineageConfig = {
+    enabled: false,
+    storagePath: 'lineage',
+    hashAlgorithm: 'SHA-256',
+};
+export const defaultAdvancedMaskingConfig = {
+    defaultAlgorithm: 'hash',
+    fieldAlgorithms: {},
+    fpe: {
+        key: '',
+        radix: 10,
+    },
+    kAnonymity: {
+        kValue: 2,
+        quasiIdentifiers: ['zipCode', 'age', 'gender'],
+    },
+    differentialPrivacy: {
+        epsilon: 1.0,
+        totalBudget: 5.0,
+        sensitivity: 1.0,
+    },
+    hash: {
+        algorithm: 'SHA-256',
+        salt: '',
+    },
+};
+export const defaultVisualizationConfig = {
+    charts: {
+        bar: { enabled: true, title: '脱敏统计' },
+        comparison: { enabled: true, title: '清洗前后对比' },
+        pie: { enabled: true, title: '数据资产分布' },
+        radar: { enabled: true, title: '质量评分' },
+        flowchart: { enabled: true, title: '血缘追踪' },
+    },
+    layout: {
+        columns: 2,
+        responsive: true,
+    },
+    colorScheme: {
+        primary: '#4A90D9',
+        secondary: '#F5A623',
+        success: '#7ED321',
+        warning: '#F8E71C',
+        danger: '#D0021B',
+        background: '#F5F5F5',
+        text: '#333333',
+    },
+    interactions: {
+        expandCollapse: true,
+        chartSwitch: true,
+        tooltip: true,
+    },
+    templateVersion: '1.0',
+};
+export const defaultSensitivityClassificationConfig = {
+    fieldNameRules: [
+        { name: 'idCard', pattern: 'id_?card|身份证|identity', level: 'Secret' },
+        { name: 'phone', pattern: 'phone|手机|mobile|tel', level: 'Confidential' },
+        { name: 'email', pattern: 'email|邮箱|mail', level: 'Confidential' },
+        { name: 'bankCard', pattern: 'bank_?card|银行卡|account', level: 'Secret' },
+        { name: 'address', pattern: 'address|地址|addr', level: 'Internal' },
+        { name: 'name', pattern: '^name$|姓名|username', level: 'Internal' },
+        { name: 'public', pattern: 'status|type|category|label|tag|level', level: 'Public' },
+    ],
+    fieldValueRules: [
+        { name: 'idCardValue', pattern: '[1-9]\\d{5}(18|19|20)?\\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\\d|3[01])\\d{3}[\\dXx]', level: 'Secret' },
+        { name: 'phoneValue', pattern: '1[3-9]\\d{9}', level: 'Confidential' },
+        { name: 'emailValue', pattern: '[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}', level: 'Confidential' },
+        { name: 'bankCardValue', pattern: '[1-9]\\d{15,18}', level: 'Secret' },
+    ],
+    levelMapping: {
+        Public: 'none',
+        Internal: 'partial',
+        Confidential: 'full',
+        Secret: 'encrypt',
+    },
+    defaultLevel: 'Internal',
+};
+export const defaultIncrementalSchedulingConfig = {
+    incrementalMode: false,
+    cronExpression: '0 2 * * *',
+    hashAlgorithm: 'SHA-256',
+    watchDirectory: 'input',
+    stateFilePath: 'state/incremental-state.json',
+    lockTimeout: 3600,
+};
+export const defaultRegistrationConfig = {
+    ruleVersion: '1.0',
+    agencies: [
+        {
+            id: 'beijing',
+            name: '北京国际大数据交易所',
+            location: '北京',
+            specialties: ['医疗', '健康', '生物'],
+            contact: '北京国际大数据交易所官网',
+            basis: '医疗数据登记案例集中',
+        },
+        {
+            id: 'shanghai',
+            name: '上海数据交易所',
+            location: '上海',
+            specialties: ['金融', '征信', '支付'],
+            contact: '上海数据交易所官网',
+            basis: '金融数据交易活跃度最高',
+        },
+        {
+            id: 'shenzhen',
+            name: '深圳数据交易所',
+            location: '深圳',
+            specialties: ['交通', '物流', '地理'],
+            contact: '深圳数据交易所官网',
+            basis: '交通数据登记案例较多',
+        },
+    ],
+    dataTypeMapping: {
+        '金融': 'shanghai',
+        '征信': 'shanghai',
+        '支付': 'shanghai',
+        '医疗': 'beijing',
+        '健康': 'beijing',
+        '生物': 'beijing',
+        '交通': 'shenzhen',
+        '物流': 'shenzhen',
+        '地理': 'shenzhen',
+    },
+    defaultRecommendation: {
+        agency: null,
+        basis: '根据数据属性匹配',
+        message: '建议咨询专业机构',
+    },
+    registrationFee: 5000,
+    registrationSteps: ['申请', '受理', '审查', '公示', '异议', '存证', '凭证'],
+};
+export const defaultPolicyReferences = [
+    {
+        stage: 'INVENTORY',
+        stageLabel: '盘点',
+        documents: [
+            { name: '中华人民共和国数据安全法', docNumber: '主席令第八十四号', coreRequirement: '数据分类分级保护' },
+            { name: '数据产权登记工作指引（试行）', docNumber: '国数综政策〔2026〕35号', coreRequirement: '数据产权三权分置' },
+        ],
+    },
+    {
+        stage: 'CLEANING',
+        stageLabel: '清洗',
+        documents: [
+            { name: '企业数据资源相关会计处理暂行规定', docNumber: '财会〔2023〕11号', coreRequirement: '数据资源入表条件' },
+            { name: '数据资产评估指导意见', docNumber: '中评协〔2023〕17号', coreRequirement: '六维质量评价标准' },
+        ],
+    },
+    {
+        stage: 'MASKING',
+        stageLabel: '脱敏',
+        documents: [
+            { name: '中华人民共和国个人信息保护法', docNumber: '主席令第九十一号', coreRequirement: '匿名化后不再属于个人信息' },
+            { name: '关于完善数据流通安全治理的实施方案', docNumber: '发改数据〔2025〕18号', coreRequirement: '脱敏后可按一般数据流通' },
+        ],
+    },
+    {
+        stage: 'PACKAGING',
+        stageLabel: '包装',
+        documents: [
+            { name: '数据产权登记工作指引（试行）', docNumber: '国数综政策〔2026〕35号', coreRequirement: '登记凭证可用于入表、融资、入股' },
+        ],
+    },
+    {
+        stage: 'PRECHECK',
+        stageLabel: '登记预检',
+        documents: [
+            { name: '数据产权登记工作指引（试行）', docNumber: '国数综政策〔2026〕35号', coreRequirement: '不予登记情形' },
+        ],
+    },
+    {
+        stage: 'DOC_GENERATION',
+        stageLabel: '材料生成',
+        documents: [
+            { name: '数据产权登记工作指引（试行）', docNumber: '国数综政策〔2026〕35号', coreRequirement: '7步登记流程审查重点' },
+        ],
+    },
+    {
+        stage: 'AGENCY_MATCHING',
+        stageLabel: '机构匹配',
+        documents: [
+            { name: '数据产权登记工作指引（试行）', docNumber: '国数综政策〔2026〕35号', coreRequirement: '登记机构名录' },
+        ],
+    },
+];
+export const defaultBusinessRules = {
+    version: '1.0',
+    lastUpdated: '2026-08-17',
+    valueAssessment: {
+        highValue: {
+            keywords: ['供应链', '销售明细', '设备工况', '交易流水'],
+            score: 5,
+            label: '★★★★★',
+            recommendation: '优先交易，建议入表',
+        },
+        mediumValue: {
+            keywords: ['用户行为', '产品数据', '行业报告'],
+            score: 3,
+            label: '★★★',
+            recommendation: '脱敏后交易',
+        },
+        lowValue: {
+            keywords: ['日志', '备份', '临时'],
+            score: 1,
+            label: '★',
+            recommendation: '评估处理成本',
+        },
+        defaultValue: {
+            score: 3,
+            label: '★★★',
+            recommendation: '需进一步评估',
+        },
+    },
+    sensitivePatterns: {
+        idCard: {
+            pattern: '[1-9]\\d{5}(18|19|20)?\\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\\d|3[01])\\d{3}[\\dXx]',
+            level: 'FULL',
+        },
+        phone: {
+            pattern: '1[3-9]\\d{9}',
+            level: 'PARTIAL',
+        },
+        bankCard: {
+            pattern: '[1-9]\\d{15,18}',
+            level: 'PARTIAL',
+        },
+        email: {
+            pattern: '[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}',
+            level: 'PARTIAL',
+        },
+    },
+    maskingLevels: {
+        FULL: {
+            description: '完全匿名化',
+            applyTo: ['idCard'],
+        },
+        PARTIAL: {
+            description: '假名化，保留前3后4',
+            applyTo: ['phone', 'bankCard'],
+        },
+        GENERALIZE: {
+            description: '泛化处理',
+            applyTo: ['email'],
+        },
+    },
+    cleaningRules: {
+        missingValueStrategy: {
+            government: 'interpolation',
+            financial: 'manual_review',
+            behavior: 'mode_fill',
+        },
+        qualityThreshold: {
+            A: { missingRate: 0.05, errorRate: 0.01, label: '优秀' },
+            B: { missingRate: 0.10, errorRate: 0.03, label: '良好' },
+            C: { missingRate: 0.20, errorRate: 0.05, label: '合格' },
+            D: { missingRate: 0.20, errorRate: 0.05, label: '不合格', action: '不建议交易' },
+        },
+    },
+    compliance: {
+        policies: [
+            { name: '数据产权登记工作指引', doc: '国数综政策〔2026〕35号', check: '数据来源可登记' },
+            { name: '数据流通安全治理', doc: '发改数据〔2025〕18号', check: '来源合法性' },
+            { name: '数据脱敏工具标准', doc: 'YD/T 6225-2024', check: '脱敏效果达标' },
+        ],
+    },
+    packaging: {
+        complianceStatements: [
+            '本数据产品已完成脱敏处理',
+            '不包含个人身份信息',
+            '数据来源合法',
+            '建议交易前完成数据产权登记',
+        ],
+        pricingRules: [
+            { valueLevel: '★★★★★', suggestion: '根据数据质量、稀缺性和应用场景综合定价，建议高价交易' },
+            { valueLevel: '★★★★', suggestion: '根据数据质量和应用场景定价，建议中高价交易' },
+            { valueLevel: '★★★', suggestion: '根据数据质量和应用场景综合定价' },
+            { valueLevel: '★★', suggestion: '建议低价交易或内部使用' },
+            { valueLevel: '★', suggestion: '建议评估处理成本后决定是否交易' },
+        ],
+        defaultDescription: '适用于数据分析、模型训练、行业研究等场景',
+        version: 'V1.0',
+    },
+    registration: defaultRegistrationConfig,
+    policyReferences: defaultPolicyReferences,
+};
+//# sourceMappingURL=defaultBusinessRules.js.map

package/lib/fileFormatAdapter.js ADDED Viewed

@@ -0,0 +1,98 @@
+import * as fs from 'fs';
+import * as path from 'path';
+export class FileFormatAdapter {
+    detectFormat(filePath) {
+        const ext = path.extname(filePath).toLowerCase().slice(1);
+        if (ext === 'csv' || ext === 'json' || ext === 'txt' || ext === 'xlsx') {
+            return ext;
+        }
+        return 'unknown';
+    }
+    async read(filePath) {
+        const format = this.detectFormat(filePath);
+        const fullPath = path.resolve(filePath);
+        if (!fs.existsSync(fullPath)) {
+            throw new Error(`错误：文件不存在 - ${fullPath}`);
+        }
+        const stats = fs.statSync(fullPath);
+        const isLargeFile = stats.size >= 10 * 1024 * 1024;
+        switch (format) {
+            case 'csv':
+                return this.readCsv(fullPath);
+            case 'json':
+                return this.readJson(fullPath);
+            case 'xlsx':
+                return this.readXlsx(fullPath);
+            case 'txt':
+            case 'unknown':
+            default:
+                return this.readTxt(fullPath, format, isLargeFile);
+        }
+    }
+    async write(filePath, lines, format) {
+        const fullPath = path.resolve(filePath);
+        const dir = path.dirname(fullPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        switch (format) {
+            case 'csv':
+                this.writeCsv(fullPath, lines);
+                break;
+            case 'json':
+                this.writeJson(fullPath, lines);
+                break;
+            case 'xlsx':
+                this.writeXlsx(fullPath, lines);
+                break;
+            case 'txt':
+            case 'unknown':
+            default:
+                fs.writeFileSync(fullPath, lines.join('\n'), 'utf-8');
+                break;
+        }
+    }
+    readTxt(filePath, format, _isLargeFile) {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n').filter(line => line.trim());
+        return { lines, format, raw: content };
+    }
+    readCsv(filePath) {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n').filter(line => line.trim());
+        return { lines, format: 'csv', raw: content };
+    }
+    readJson(filePath) {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (Array.isArray(parsed)) {
+            const lines = parsed.map(item => JSON.stringify(item));
+            return { lines, format: 'json', raw: parsed };
+        }
+        const lines = [JSON.stringify(parsed)];
+        return { lines, format: 'json', raw: parsed };
+    }
+    readXlsx(filePath) {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n').filter(line => line.trim());
+        return { lines, format: 'xlsx', raw: content };
+    }
+    writeCsv(filePath, lines) {
+        fs.writeFileSync(filePath, lines.join('\n'), 'utf-8');
+    }
+    writeJson(filePath, lines) {
+        const objects = lines.map((line) => {
+            try {
+                return JSON.parse(line);
+            }
+            catch {
+                return line;
+            }
+        });
+        fs.writeFileSync(filePath, JSON.stringify(objects, null, 2), 'utf-8');
+    }
+    writeXlsx(filePath, lines) {
+        fs.writeFileSync(filePath, lines.join('\n'), 'utf-8');
+    }
+}
+//# sourceMappingURL=fileFormatAdapter.js.map

package/lib/index.js CHANGED Viewed

@@ -6,4 +6,7 @@ export { FileFormatAdapter } from './fileFormatAdapter.js';
 export { ReportGenerator } from './reportGenerator.js';
 export { PathValidator } from './pathValidator.js';
 export { AuditLogger } from './auditLogger.js';
+export { PolicyReferenceResolver } from './policyReferenceResolver.js';
+export { RegistrationNavigationEnhancer } from './registrationNavigationEnhancer.js';
+export { defaultRegistrationConfig, defaultPolicyReferences, } from './defaultBusinessRules.js';
 //# sourceMappingURL=index.js.map

package/lib/pathValidator.js ADDED Viewed

@@ -0,0 +1,18 @@
+import * as path from 'path';
+export class PathValidator {
+    validate(filePath, workingDir) {
+        const resolved = path.resolve(filePath);
+        if (filePath.includes('..')) {
+            throw new Error(`错误：路径不合法 - ${filePath}`);
+        }
+        const relative = path.relative(workingDir, resolved);
+        if (relative.startsWith('..') || path.isAbsolute(relative)) {
+            throw new Error(`错误：路径不合法 - ${filePath}`);
+        }
+        return resolved;
+    }
+    validateDirectory(dirPath, workingDir) {
+        return this.validate(dirPath, workingDir);
+    }
+}
+//# sourceMappingURL=pathValidator.js.map

package/lib/policyReferenceResolver.js ADDED Viewed

@@ -0,0 +1,64 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { defaultPolicyReferences } from './defaultBusinessRules.js';
+export class PolicyReferenceResolver {
+    static instance = null;
+    cache = new Map();
+    references = [];
+    configPath;
+    constructor(configPath) {
+        this.configPath = configPath
+            ? path.resolve(configPath)
+            : path.resolve(process.cwd(), 'config', 'policy-references.json');
+        this.load();
+    }
+    static getInstance(configPath) {
+        if (!PolicyReferenceResolver.instance) {
+            PolicyReferenceResolver.instance = new PolicyReferenceResolver(configPath);
+        }
+        return PolicyReferenceResolver.instance;
+    }
+    load() {
+        try {
+            if (fs.existsSync(this.configPath)) {
+                const raw = fs.readFileSync(this.configPath, 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (parsed.policyReferences && Array.isArray(parsed.policyReferences)) {
+                    this.references = parsed.policyReferences;
+                    return;
+                }
+            }
+        }
+        catch {
+            console.warn('[PolicyReferenceResolver] 配置加载失败，使用默认值');
+        }
+        this.references = defaultPolicyReferences;
+    }
+    resolve(stage) {
+        if (this.cache.has(stage)) {
+            return this.cache.get(stage);
+        }
+        const ref = this.references.find(r => r.stage === stage);
+        let documents;
+        if (ref && ref.documents && ref.documents.length > 0) {
+            documents = ref.documents;
+        }
+        else {
+            console.warn(`[PolicyReferenceResolver] 环节 ${stage} 未配置政策依据，使用占位项`);
+            documents = [
+                {
+                    name: '依据文件待补充',
+                    docNumber: '待配置',
+                    coreRequirement: '请补充对应政策依据',
+                },
+            ];
+        }
+        this.cache.set(stage, documents);
+        return documents;
+    }
+    clearCache() {
+        this.cache.clear();
+        PolicyReferenceResolver.instance = null;
+    }
+}
+//# sourceMappingURL=policyReferenceResolver.js.map

package/lib/registrationNavigationEnhancer.js ADDED Viewed

@@ -0,0 +1,107 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { PolicyReferenceResolver } from './policyReferenceResolver.js';
+import { defaultRegistrationConfig } from './defaultBusinessRules.js';
+const PLUGIN_STAGE_MAP = {
+    'data-inventory': 'INVENTORY',
+    'data-cleaning': 'CLEANING',
+    'data-masking': 'MASKING',
+    'data-packaging': 'PACKAGING',
+};
+const NAVIGATION_TEXTS = {
+    'data-inventory': '本数据集已完成盘点，建议下一步申请数据产权登记。登记机构推荐：{agency}',
+    'data-cleaning': '数据质量已达到登记要求（依据《数据资产评估指导意见》六维质量评价标准）。',
+    'data-masking': "脱敏后数据已符合登记审查中的'来源合规性'要求（依据《数据产权登记工作指引》第三章）。",
+    'data-packaging': "本产品说明书可直接用于登记申请材料中的'数据描述'部分。",
+};
+export class RegistrationNavigationEnhancer {
+    config;
+    configPath;
+    constructor(configPath) {
+        this.configPath = configPath
+            ? path.resolve(configPath)
+            : path.resolve(process.cwd(), 'config', 'registration-agencies.json');
+        this.config = this.loadConfig();
+    }
+    loadConfig() {
+        try {
+            if (fs.existsSync(this.configPath)) {
+                const raw = fs.readFileSync(this.configPath, 'utf-8');
+                return JSON.parse(raw);
+            }
+        }
+        catch {
+            console.warn('[RegistrationNavigationEnhancer] 配置加载失败，使用默认值');
+        }
+        return defaultRegistrationConfig;
+    }
+    matchAgency(dataType) {
+        const agencyId = this.config.dataTypeMapping[dataType];
+        if (agencyId) {
+            const agency = this.config.agencies.find(a => a.id === agencyId);
+            if (agency)
+                return agency.name;
+        }
+        return this.config.defaultRecommendation.message;
+    }
+    enhance(report, pluginName, dataType) {
+        const stage = PLUGIN_STAGE_MAP[pluginName];
+        if (!stage)
+            return report;
+        const resolver = PolicyReferenceResolver.getInstance();
+        const policyDocs = resolver.resolve(stage);
+        let navText = NAVIGATION_TEXTS[pluginName] || '';
+        if (pluginName === 'data-inventory') {
+            const agencyName = this.matchAgency(dataType);
+            navText = navText.replace('{agency}', agencyName);
+        }
+        const policyText = policyDocs
+            .map(d => `- 《${d.name}》（${d.docNumber}）：${d.coreRequirement}`)
+            .join('\n');
+        const enhancedReport = `${report}
+---
+## 登记导航
+${navText}
+## 政策依据
+${policyText}
+`;
+        return enhancedReport;
+    }
+    enhanceAll(orchestrationResult, dataType) {
+        return {
+            ...orchestrationResult,
+            maskingReport: this.enhance(orchestrationResult.maskingReport, 'data-masking', dataType),
+            cleaningReport: this.enhance(orchestrationResult.cleaningReport, 'data-cleaning', dataType),
+            inventoryReport: this.enhance(orchestrationResult.inventoryReport, 'data-inventory', dataType),
+            packagingManual: this.enhance(orchestrationResult.packagingManual, 'data-packaging', dataType),
+        };
+    }
+    matchAgencyResult(dataType) {
+        const agencyId = this.config.dataTypeMapping[dataType];
+        if (agencyId) {
+            const agency = this.config.agencies.find(a => a.id === agencyId);
+            if (agency) {
+                return {
+                    agency: agency.id,
+                    agencyName: agency.name,
+                    basis: agency.basis,
+                    dataType,
+                    ruleVersion: this.config.ruleVersion,
+                };
+            }
+        }
+        return {
+            agency: null,
+            agencyName: this.config.defaultRecommendation.message,
+            basis: this.config.defaultRecommendation.basis,
+            dataType,
+            ruleVersion: this.config.ruleVersion,
+        };
+    }
+}
+//# sourceMappingURL=registrationNavigationEnhancer.js.map

package/lib/reportGenerator.js ADDED Viewed

@@ -0,0 +1,84 @@
+export class ReportGenerator {
+    generateMaskingReport(params) {
+        const findingsText = Object.keys(params.fieldTypeCounts).length > 0
+            ? Object.entries(params.fieldTypeCounts)
+                .map(([type, count]) => `发现 ${count} 个${type}类型的敏感数据`)
+                .join('；')
+            : '无';
+        return `【脱敏报告】
+- 处理文件：${params.inputPath}
+- 发现敏感字段：${findingsText}
+- 脱敏策略：${params.strategy}
+- 输出文件：${params.outputPath}
+- 状态：✅ 完成`;
+    }
+    generateCleaningReport(params) {
+        let report = `【数据清洗报告】
+- 文件：${params.inputPath}
+- 原始行数：${params.originalLineCount}
+- 去重后行数：${params.originalLineCount - params.duplicateRemoved}（删除 ${params.duplicateRemoved} 行重复）
+`;
+        if (params.standardizeApplied) {
+            report += '- 格式标准化：✅ 完成\n';
+        }
+        report += `- 异常值检测：发现 ${params.anomalyTotalCount} 个异常\n`;
+        if (params.anomalies.length > 0) {
+            const displayAnomalies = params.anomalies.slice(0, 5);
+            const anomalyText = displayAnomalies.map(a => `行${a.line}: ${a.reason}`).join('；');
+            report += `  异常详情：${anomalyText}`;
+            if (params.anomalyTotalCount > 5) {
+                report += `...等${params.anomalyTotalCount}项`;
+            }
+            report += '\n';
+        }
+        report += `- 输出文件：${params.outputPath}\n- 状态：✅ 完成`;
+        return report;
+    }
+    generateInventoryReport(params) {
+        let report = `【数据资产盘点报告】\n- 目录：${params.directory}\n- 发现数据文件：${params.fileCount} 个\n\n`;
+        report += '| 文件名 | 大小 | 类型 | 价值评估 | 说明 |\n';
+        report += '|--------|------|------|----------|------|\n';
+        for (const item of params.assetItems) {
+            report += `| ${item.fileName} | ${item.size} | ${item.type} | ${item.valueAssessment} | ${item.description} |\n`;
+        }
+        report += '\n---\n【建议】\n';
+        report += '1. 高价值数据（★★★★★）建议优先进行清洗和脱敏后交易\n';
+        report += '2. 低价值数据建议评估是否值得投入处理成本\n';
+        report += '3. 所有数据交易前必须完成合规审查\n';
+        return report;
+    }
+    generatePackagingManual(params) {
+        const manual = params.productManual;
+        const complianceText = manual.complianceStatements
+            .map(stmt => `✅ ${stmt}`)
+            .join('\n');
+        return `========================================
+        数据产品说明书
+========================================
+【产品名称】${manual.productName}
+【版本】${manual.version}
+【生成日期】${manual.generatedDate}
+【数据概览】
+- 源文件：${manual.dataOverview.sourceFile}
+- 数据量：${manual.dataOverview.recordCount} 条记录
+- 文件大小：${manual.dataOverview.fileSizeKb.toFixed(1)} KB
+- 格式：${manual.dataOverview.format}
+【数据样例】（前5行）
+${manual.sampleLines.join('\n')}
+【使用场景】
+${manual.usageScenario}
+【合规声明】
+${complianceText}
+【定价建议】
+${manual.pricingSuggestion}
+--- 本产品由数据资产化工具包自动生成 ---`;
+    }
+}
+//# sourceMappingURL=reportGenerator.js.map

package/lib/types/defaultBusinessRules.d.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-import type { BusinessRulesConfig } from './types.js';
+import type { BusinessRulesConfig, RegistrationConfig, PolicyReference } from './types.js';
 export declare const defaultQualityScoringConfig: {
     weights: {
         completeness: number;
@@ -136,5 +136,7 @@ export declare const defaultIncrementalSchedulingConfig: {
     stateFilePath: string;
     lockTimeout: number;
 };
+export declare const defaultRegistrationConfig: RegistrationConfig;
+export declare const defaultPolicyReferences: PolicyReference[];
 export declare const defaultBusinessRules: BusinessRulesConfig;
 //# sourceMappingURL=defaultBusinessRules.d.ts.map

package/lib/types/index.d.ts CHANGED Viewed

@@ -9,4 +9,7 @@ export type { MaskingReportParams, CleaningReportParams, InventoryReportParams,
 export { PathValidator } from './pathValidator.js';
 export { AuditLogger } from './auditLogger.js';
 export type { AuditLogParams } from './auditLogger.js';
+export { PolicyReferenceResolver } from './policyReferenceResolver.js';
+export { RegistrationNavigationEnhancer } from './registrationNavigationEnhancer.js';
+export { defaultRegistrationConfig, defaultPolicyReferences, } from './defaultBusinessRules.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/policyReferenceResolver.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import type { PolicyStage, PolicyDocument } from './types.js';
+export declare class PolicyReferenceResolver {
+    private static instance;
+    private cache;
+    private references;
+    private configPath;
+    private constructor();
+    static getInstance(configPath?: string): PolicyReferenceResolver;
+    private load;
+    resolve(stage: PolicyStage): PolicyDocument[];
+    clearCache(): void;
+}
+//# sourceMappingURL=policyReferenceResolver.d.ts.map

package/lib/types/registrationNavigationEnhancer.d.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import type { OrchestrationResult, AgencyMatchResult } from './types.js';
+export declare class RegistrationNavigationEnhancer {
+    private config;
+    private configPath;
+    constructor(configPath?: string);
+    private loadConfig;
+    private matchAgency;
+    enhance(report: string, pluginName: string, dataType: string): string;
+    enhanceAll(orchestrationResult: OrchestrationResult, dataType: string): OrchestrationResult;
+    matchAgencyResult(dataType: string): AgencyMatchResult;
+}
+//# sourceMappingURL=registrationNavigationEnhancer.d.ts.map

package/lib/types/types.d.ts CHANGED Viewed

@@ -82,6 +82,8 @@ export interface BusinessRulesConfig {
     visualization?: VisualizationConfig;
     sensitivityClassification?: SensitivityClassificationConfig;
     incrementalScheduling?: IncrementalSchedulingConfig;
+    registration?: RegistrationConfig;
+    policyReferences?: PolicyReference[];
 }
 export interface SensitiveField {
     type: SensitiveFieldType;
@@ -275,4 +277,90 @@ export interface IncrementalSchedulingConfig {
     stateFilePath: string;
     lockTimeout: number;
 }
+export type PolicyStage = 'INVENTORY' | 'CLEANING' | 'MASKING' | 'PACKAGING' | 'PRECHECK' | 'DOC_GENERATION' | 'AGENCY_MATCHING';
+export interface PolicyDocument {
+    name: string;
+    docNumber: string;
+    coreRequirement: string;
+}
+export interface PolicyReference {
+    stage: PolicyStage;
+    stageLabel: string;
+    documents: PolicyDocument[];
+}
+export interface AgencyConfig {
+    id: string;
+    name: string;
+    location: string;
+    specialties: string[];
+    contact: string;
+    basis: string;
+}
+export interface RegistrationConfig {
+    ruleVersion: string;
+    agencies: AgencyConfig[];
+    dataTypeMapping: Record<string, string>;
+    defaultRecommendation: {
+        agency: string | null;
+        basis: string;
+        message: string;
+    };
+    registrationFee: number;
+    registrationSteps: string[];
+}
+export interface NavigationField {
+    registrationNavigation: string;
+    policyReferences: PolicyDocument[];
+}
+export type CheckName = 'NATIONAL_SECURITY' | 'SOURCE_COMPLIANCE' | 'OWNERSHIP_DISPUTE' | 'MATERIAL_AUTHENTICITY';
+export type CheckResult = 'PASS' | 'FAIL' | 'PENDING' | 'UNDETERMINED';
+export type PrecheckConclusion = 'CAN_REGISTER' | 'CANNOT_REGISTER' | 'PENDING_CONFIRMATION';
+export interface PrecheckCheckItem {
+    name: CheckName;
+    label: string;
+    result: CheckResult;
+    detail: string;
+}
+export interface PrecheckReport {
+    conclusion: PrecheckConclusion;
+    checks: PrecheckCheckItem[];
+    failedItems: string[];
+    policyReferences: PolicyDocument[];
+    timestamp: string;
+}
+export type RegistrationDocName = 'DATA_DESCRIPTION' | 'SOURCE_LEGALITY_STATEMENT' | 'OWNERSHIP_EXPLANATION';
+export type DocStatus = 'GENERATED' | 'FAILED' | 'PENDING_FIELDS';
+export interface RegistrationDoc {
+    name: RegistrationDocName;
+    label: string;
+    content: string;
+    status: DocStatus;
+    missingFields?: string[];
+}
+export interface RegistrationDocPackage {
+    docs: RegistrationDoc[];
+    packagePath: string;
+    policyReferences: PolicyDocument[];
+    timestamp: string;
+}
+export interface AgencyMatchResult {
+    agency: string | null;
+    agencyName: string;
+    basis: string;
+    dataType: string;
+    ruleVersion: string;
+}
+export type StepStatus = 'COMPLETED' | 'CURRENT' | 'PENDING';
+export interface RegistrationStep {
+    name: string;
+    status: StepStatus;
+    description: string;
+}
+export interface RegistrationProgress {
+    steps: RegistrationStep[];
+    currentStep: number;
+    registrationId: string;
+    agency: string;
+    timestamp: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/lib/types.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=types.js.map

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
     "name":  "@liuhange/dsh-data-asset-shared",
     "description":  "Shared infrastructure for data assetization plugins: business rules loader, file format adapter, report generator, path validator, audit logger",
-    "version": "2.0.2",
+    "version": "3.0.0",
     "publishConfig":  {
                           "access":  "public"
                       },
@@ -26,9 +26,7 @@
                     "./package.json":  "./package.json"
                 },
     "files":  [
-                  "lib/index.js",
-                  "lib/invariant.js",
-                  "lib/types/**/*.d.ts"
+                  "lib/**/*.js", "lib/types/**/*.d.ts"
               ],
     "license":  "MIT",
     "scripts": {
@@ -43,5 +41,6 @@
                              "@deepseek-ai/cordis": "^4.0.0",
                              "@deepseek-ai/dsh-tools": "0.0.1-rc.1",
                              "@deepseek-ai/schemastery": "^3.18.0"
-                         }
+                         },
+    "dsh":  { "bundle":  { "patch": true } }
 }