@liuhange/dsh-generate-registration-docs 3.0.0

package/README.md

@@ -0,0 +1,22 @@
+# @liuhange/dsh-generate-registration-docs
+
+登记材料生成插件：根据体检报告自动生成国家登记系统所需的申请材料。
+
+## 功能说明
+
+生成三份登记申请材料：
+1. 《数据描述》：从盘点报告和包装说明书提取数据集基本信息
+2. 《来源合法性声明》：从脱敏报告提取来源声明
+3. 《产权归属说明》：基于三权分置（持有权/加工使用权/经营权）
+
+## 依赖
+
+- `@liuhange/dsh-data-asset-shared: ^3.0.0`
+- `@deepseek-ai/cordis: ^4.0.0`
+- `@deepseek-ai/dsh-tools: 0.0.1-rc.1`
+
+## 安装
+
+```bash
+npm install @liuhange/dsh-generate-registration-docs
+```

package/lib/__tests__/docGenerator.test.js

@@ -0,0 +1,59 @@
+import { describe, it, expect } from 'vitest';
+import { DocGenerator } from '../docGenerator.js';
+const validResult = {
+    maskingReport: '脱敏报告，来源合法，合规声明',
+    cleaningReport: '清洗报告',
+    inventoryReport: '盘点报告，记录数：1000',
+    packagingManual: '产品名称：测试数据产品\n格式：csv',
+    completedStages: 4,
+};
+const fullOwnership = {
+    holder: '某公司',
+    processor: '某公司技术部',
+    operator: '某公司数据部',
+    hasDispute: false,
+    confirmedAt: '2026-09-12T10:00:00Z',
+};
+describe('DocGenerator', () => {
+    const generator = new DocGenerator();
+    it('预检通过 → 生成三份材料', () => {
+        const docs = generator.generate(validResult, fullOwnership);
+        expect(docs).toHaveLength(3);
+        expect(docs.map(d => d.name)).toEqual([
+            'DATA_DESCRIPTION',
+            'SOURCE_LEGALITY_STATEMENT',
+            'OWNERSHIP_EXPLANATION',
+        ]);
+    });
+    it('字段缺失 → 标注"待企业补充"', () => {
+        const incomplete = {
+            ...validResult,
+            inventoryReport: '无记录数信息',
+            packagingManual: '无产品名称',
+        };
+        const docs = generator.generate(incomplete, fullOwnership);
+        const dataDesc = docs.find(d => d.name === 'DATA_DESCRIPTION');
+        expect(dataDesc?.status).toBe('PENDING_FIELDS');
+        expect(dataDesc?.missingFields).toBeDefined();
+    });
+    it('部分材料失败 → 保留已生成材料', () => {
+        const partialOwnership = {
+            holder: '',
+            processor: '',
+            operator: '',
+            hasDispute: false,
+            confirmedAt: '2026-09-12T10:00:00Z',
+        };
+        const docs = generator.generate(validResult, partialOwnership);
+        const ownership = docs.find(d => d.name === 'OWNERSHIP_EXPLANATION');
+        expect(ownership?.status).toBe('PENDING_FIELDS');
+        expect(ownership?.missingFields).toContain('持有权主体');
+    });
+    it('材料含政策依据章节', () => {
+        const docs = generator.generate(validResult, fullOwnership);
+        for (const doc of docs) {
+            expect(doc.content).toContain('政策依据');
+        }
+    });
+});
+//# sourceMappingURL=docGenerator.test.js.map

package/lib/docGenerator.js

@@ -0,0 +1,112 @@
+import { PolicyReferenceResolver } from '@liuhange/dsh-data-asset-shared';
+export class DocGenerator {
+    generate(orchestrationResult, ownership) {
+        const policyRefs = PolicyReferenceResolver.getInstance().resolve('DOC_GENERATION');
+        const docs = [];
+        docs.push(this.generateDataDescription(orchestrationResult, policyRefs));
+        docs.push(this.generateSourceLegalityStatement(orchestrationResult, policyRefs));
+        docs.push(this.generateOwnershipExplanation(ownership, policyRefs));
+        return docs;
+    }
+    generateDataDescription(result, policyRefs) {
+        const missingFields = [];
+        const inventoryMatch = result.inventoryReport.match(/记录数[:：]\s*(\d+)/);
+        const formatMatch = result.packagingManual.match(/格式[:：]\s*(\w+)/);
+        const nameMatch = result.packagingManual.match(/产品名称[:：]\s*(.+)/);
+        const datasetName = nameMatch?.[1]?.trim() || '待企业填报';
+        const recordCount = inventoryMatch?.[1] || '待企业填报';
+        const format = formatMatch?.[1] || '待企业填报';
+        if (datasetName === '待企业填报')
+            missingFields.push('数据集名称');
+        if (recordCount === '待企业填报')
+            missingFields.push('记录数');
+        if (format === '待企业填报')
+            missingFields.push('数据格式');
+        const content = `# 数据描述
+
+## 一、数据集基本信息
+- 数据集名称：${datasetName}
+- 数据记录数：${recordCount}
+- 数据格式：${format}
+- 内容概述：${result.inventoryReport.substring(0, 200)}...
+- 更新频率：待企业填报
+
+## 二、数据内容说明
+${result.packagingManual.substring(0, 500)}
+
+## 三、政策依据
+${policyRefs.map(d => `- 《${d.name}》（${d.docNumber}）`).join('\n')}
+`;
+        return {
+            name: 'DATA_DESCRIPTION',
+            label: '数据描述',
+            content,
+            status: missingFields.length > 0 ? 'PENDING_FIELDS' : 'GENERATED',
+            ...(missingFields.length > 0 ? { missingFields } : {}),
+        };
+    }
+    generateSourceLegalityStatement(result, policyRefs) {
+        const hasSourceInfo = result.maskingReport.includes('来源') || result.maskingReport.includes('合规');
+        const content = `# 来源合法性声明
+
+## 声明内容
+本数据集来源合法，数据获取方式符合相关法律法规规定。
+
+## 脱敏处理说明
+${result.maskingReport.substring(0, 300)}
+
+## 来源合规依据
+${hasSourceInfo ? '脱敏报告中已包含来源合法性声明' : '待企业补充来源合法性证明材料'}
+
+## 政策依据
+${policyRefs.map(d => `- 《${d.name}》（${d.docNumber}）`).join('\n')}
+`;
+        return {
+            name: 'SOURCE_LEGALITY_STATEMENT',
+            label: '来源合法性声明',
+            content,
+            status: hasSourceInfo ? 'GENERATED' : 'PENDING_FIELDS',
+            ...(!hasSourceInfo ? { missingFields: ['来源合法性证明材料'] } : {}),
+        };
+    }
+    generateOwnershipExplanation(ownership, policyRefs) {
+        const missingFields = [];
+        if (!ownership.holder)
+            missingFields.push('持有权主体');
+        if (!ownership.processor)
+            missingFields.push('加工使用权主体');
+        if (!ownership.operator)
+            missingFields.push('经营权主体');
+        const content = `# 产权归属说明
+
+## 一、数据产权三权分置
+
+### 1. 持有权
+- 权利主体：${ownership.holder || '待企业填报'}
+- 权利内容：对数据资源的持有、控制和支配
+
+### 2. 加工使用权
+- 权利主体：${ownership.processor || '待企业填报'}
+- 权利内容：对数据资源进行加工、使用和获益
+
+### 3. 经营权
+- 权利主体：${ownership.operator || '待企业填报'}
+- 权利内容：对数据产品进行经营、交易和处分
+
+## 二、权属确认
+- 确认不存在权属纠纷
+- 确认数据来源合法
+
+## 三、政策依据
+${policyRefs.map(d => `- 《${d.name}》（${d.docNumber}）`).join('\n')}
+`;
+        return {
+            name: 'OWNERSHIP_EXPLANATION',
+            label: '产权归属说明',
+            content,
+            status: missingFields.length > 0 ? 'PENDING_FIELDS' : 'GENERATED',
+            ...(missingFields.length > 0 ? { missingFields } : {}),
+        };
+    }
+}
+//# sourceMappingURL=docGenerator.js.map

package/lib/docPackager.js

@@ -0,0 +1,22 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { PolicyReferenceResolver } from '@liuhange/dsh-data-asset-shared';
+export class DocPackager {
+    async package(docs) {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const packageDir = path.resolve(process.cwd(), 'output', `registration-docs-${timestamp}`);
+        fs.mkdirSync(packageDir, { recursive: true });
+        for (const doc of docs) {
+            const fileName = `${doc.label}.txt`;
+            fs.writeFileSync(path.join(packageDir, fileName), doc.content, 'utf-8');
+        }
+        const policyRefs = PolicyReferenceResolver.getInstance().resolve('DOC_GENERATION');
+        return {
+            docs,
+            packagePath: packageDir,
+            policyReferences: policyRefs,
+            timestamp: new Date().toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=docPackager.js.map

package/lib/index.js

@@ -0,0 +1,59 @@
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { AuditLogger, } from '@liuhange/dsh-data-asset-shared';
+import { DocGenerator } from './docGenerator.js';
+import { DocPackager } from './docPackager.js';
+export const name = 'generate-registration-docs';
+export const inject = ['tools'];
+export function apply(ctx) {
+    const auditLogger = new AuditLogger();
+    const docGenerator = new DocGenerator();
+    const docPackager = new DocPackager();
+    ctx.tools.register(defineTool({
+        name: 'generate_registration_docs',
+        description: '根据体检报告自动生成国家登记系统所需的申请材料（《数据描述》《来源合法性声明》《产权归属说明》）',
+        parameters: {
+            orchestrationResult: {
+                type: 'string',
+                required: true,
+                description: '体检全流程产物JSON',
+            },
+            precheckReport: {
+                type: 'string',
+                required: true,
+                description: '登记预检报告JSON（结论须为 CAN_REGISTER）',
+            },
+            ownershipConfirmation: {
+                type: 'string',
+                required: true,
+                description: '权属确认信息JSON',
+            },
+        },
+        output: {
+            schema: { type: 'string' },
+            render: (_args, value) => [{ type: 'text', text: value }],
+        },
+        async execute(args) {
+            const orchestrationResult = JSON.parse(args.orchestrationResult);
+            const precheckReport = JSON.parse(args.precheckReport);
+            const ownershipConfirmation = JSON.parse(args.ownershipConfirmation);
+            if (precheckReport.conclusion !== 'CAN_REGISTER') {
+                return JSON.stringify({
+                    error: '预检未通过，无法生成登记材料',
+                    failedItems: precheckReport.failedItems,
+                }, null, 2);
+            }
+            const docs = docGenerator.generate(orchestrationResult, ownershipConfirmation);
+            const pkg = await docPackager.package(docs);
+            auditLogger.log({
+                pluginName: 'generate-registration-docs',
+                operation: 'generate_registration_docs',
+                inputPath: '-',
+                outputPath: pkg.packagePath,
+                result: 'SUCCESS',
+            });
+            return JSON.stringify(pkg, null, 2);
+        },
+    }));
+    console.log('[generate-registration-docs] 登记材料生成插件已加载');
+}
+//# sourceMappingURL=index.js.map

package/lib/types/__tests__/docGenerator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=docGenerator.test.d.ts.map

package/lib/types/docGenerator.d.ts

@@ -0,0 +1,12 @@
+import type { OrchestrationResult, RegistrationDoc } from '@liuhange/dsh-data-asset-shared';
+export declare class DocGenerator {
+    generate(orchestrationResult: OrchestrationResult, ownership: {
+        holder: string;
+        processor: string;
+        operator: string;
+    }): RegistrationDoc[];
+    private generateDataDescription;
+    private generateSourceLegalityStatement;
+    private generateOwnershipExplanation;
+}
+//# sourceMappingURL=docGenerator.d.ts.map

package/lib/types/docPackager.d.ts

@@ -0,0 +1,5 @@
+import type { RegistrationDoc, RegistrationDocPackage } from '@liuhange/dsh-data-asset-shared';
+export declare class DocPackager {
+    package(docs: RegistrationDoc[]): Promise<RegistrationDocPackage>;
+}
+//# sourceMappingURL=docPackager.d.ts.map

package/lib/types/index.d.ts

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

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@liuhange/dsh-generate-registration-docs",
+  "description": "Generate registration documents: data description, source legality statement, ownership explanation",
+  "version": "3.0.0",
+  "publishConfig": { "access": "public" },
+  "repository": { "type": "git", "url": "git+https://github.com/liuhange789/data-asset-inspector.git", "directory": "packages/data-asset/generate-registration-docs" },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": { "types": "./lib/types/index.d.ts", "default": "./lib/index.js" },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": ["lib/**/*.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": "^3.0.0"
+  },
+  "dsh": { "bundle": { "patch": true } }
+}