patent-xml-generator 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CNIPA.AI
+
+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

@@ -0,0 +1,167 @@
+# Patent XML Generator
+
+将专利申请内容一键转为符合 CNIPA（国家知识产权局）DTD 标准的 XML 文件，可直接用于专利电子申请提交。
+
+## 功能
+
+- 支持发明专利五书（权利要求书、说明书、说明书附图、说明书摘要、摘要附图）转换
+- 自动段落编号（`[0001]`、`[0002]`...）
+- 自动权利要求编号，识别独立权利要求与从属权利要求
+- 输出符合 `cn-application-body` DTD 标准的 XML
+- 支持上标 `<sup>`、下标 `<sub>`、加粗 `<b>`、斜体 `<i>` 等行内格式
+- 支持 MathML 数学公式嵌入
+- 提供 XML 校验功能
+- TypeScript 编写，类型安全
+
+## 安装
+
+```bash
+npm install patent-xml-generator
+```
+
+## 快速开始
+
+```typescript
+import { PatentXMLGenerator } from 'patent-xml-generator';
+
+const generator = new PatentXMLGenerator();
+
+const xml = generator.generate({
+  title: '一种制冷压缩机排气过热度控制方法和系统',
+  claims: [
+    {
+      text: '一种制冷压缩机排气过热度控制方法，其特征在于，包括以下步骤：步骤S1：实时采集制冷系统运行参数；步骤S2：计算当前排气过热度；步骤S3：采用模糊自适应PID控制算法计算频率修正量。',
+      type: 'independent'
+    },
+    {
+      text: '根据权利要求1所述的方法，其特征在于，所述步骤S1中的运行参数包括压缩机排气温度、排气压力、吸气温度、吸气压力和环境温度。',
+      type: 'dependent',
+      dependsOn: 1
+    }
+  ],
+  description: {
+    technicalField: [
+      '本发明涉及制冷空调技术领域，具体涉及一种制冷压缩机排气过热度控制方法和系统。'
+    ],
+    backgroundArt: [
+      '在制冷空调系统中，压缩机排气温度是衡量系统运行状态的关键参数。',
+      '现有的排气过热度控制方法主要包括基于电子膨胀阀的开度调节、简单的频率限制法等方案。'
+    ],
+    disclosure: [
+      '为解决上述技术问题，本发明提供一种制冷压缩机排气过热度控制方法。'
+    ],
+    drawingsDescription: [
+      '图1为本发明控制方法的流程示意图；',
+      '图2为模糊自适应PID控制器的结构框图。'
+    ],
+    embodiments: [
+      '下面结合附图和具体实施例对本发明作进一步详细描述。'
+    ]
+  },
+  abstract: '本发明公开了一种制冷压缩机排气过热度控制方法和系统，通过模糊自适应PID控制算法动态调整压缩机运行频率，实现排气过热度的精确控制。'
+});
+
+console.log(xml);
+```
+
+## 输出示例
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE cn-application-body SYSTEM "cn-application-body.dtd">
+<cn-application-body lang="zh" country="CN" dtd-version="1.0">
+  <cn-claims>
+    <claim num="1" claim-type="independent">
+      <claim-text>一种制冷压缩机排气过热度控制方法，其特征在于...</claim-text>
+    </claim>
+    <claim num="2" claim-type="dependent">
+      <claim-text>根据权利要求1所述的方法，其特征在于...</claim-text>
+    </claim>
+  </cn-claims>
+  <description>
+    <invention-title lang="zh">一种制冷压缩机排气过热度控制方法和系统</invention-title>
+    <technical-field>
+      <heading level="1">技术领域</heading>
+      <p num="0001" Italic="0">本发明涉及制冷空调技术领域...</p>
+    </technical-field>
+    <background-art>
+      <heading level="1">背景技术</heading>
+      <p num="0002" Italic="0">在制冷空调系统中...</p>
+    </background-art>
+    ...
+  </description>
+  <cn-abstract>
+    <p num="0001" Italic="0">本发明公开了一种...</p>
+  </cn-abstract>
+</cn-application-body>
+```
+
+## API
+
+### `PatentXMLGenerator`
+
+#### `constructor(options?)`
+
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `lang` | `string` | `'zh'` | 语言代码 |
+| `country` | `string` | `'CN'` | 国家代码 |
+| `dtdVersion` | `string` | `'1.0'` | DTD 版本 |
+| `indent` | `boolean` | `true` | 是否格式化输出 |
+
+#### `generate(patent: PatentInput): string`
+
+生成完整的专利申请 XML 字符串。
+
+#### `generateClaims(claims: ClaimInput[]): string`
+
+仅生成权利要求书 XML 片段。
+
+#### `generateDescription(title: string, desc: DescriptionInput): string`
+
+仅生成说明书 XML 片段。
+
+#### `generateAbstract(text: string): string`
+
+仅生成摘要 XML 片段。
+
+#### `validate(xml: string): ValidationResult`
+
+校验 XML 是否符合 DTD 规范。
+
+### 类型定义
+
+```typescript
+interface PatentInput {
+  title: string;
+  claims: ClaimInput[];
+  description: DescriptionInput;
+  abstract: string;
+  drawings?: DrawingInput[];
+}
+
+interface ClaimInput {
+  text: string;
+  type: 'independent' | 'dependent';
+  dependsOn?: number;
+}
+
+interface DescriptionInput {
+  technicalField: string[];
+  backgroundArt: string[];
+  disclosure: string[];
+  drawingsDescription?: string[];
+  embodiments: string[];
+  sequenceList?: string[];
+}
+```
+
+## 关于
+
+本工具是 [CNIPA.AI](https://cnipa.ai) 专利智能服务平台的开源组件。
+
+CNIPA.AI 是一个 AI 原生的知识产权智能服务平台，基于全球公开专利数据，提供专利导航、企业画像、侵权检测、价值评估、趋势预测、AI 辅助撰写六大服务。
+
+## License
+
+MIT

package/dist/generator.d.ts

@@ -0,0 +1,46 @@
+import { PatentInput, ClaimInput, DescriptionInput, DrawingInput, GeneratorOptions, ValidationResult } from './types';
+/**
+ * 专利申请 XML 生成器
+ *
+ * 生成符合 CNIPA cn-application-body DTD 标准的 XML 文件
+ */
+export declare class PatentXMLGenerator {
+    private lang;
+    private country;
+    private dtdVersion;
+    private useIndent;
+    private dtdPath;
+    constructor(options?: GeneratorOptions);
+    /**
+     * 生成完整的专利申请 XML
+     */
+    generate(patent: PatentInput): string;
+    /**
+     * 生成权利要求书 XML 片段
+     */
+    generateClaims(claims: ClaimInput[]): string;
+    /**
+     * 生成说明书 XML 片段
+     */
+    generateDescription(title: string, desc: DescriptionInput): string;
+    /**
+     * 生成附图 XML 片段
+     */
+    generateDrawings(drawings: DrawingInput[]): string;
+    /**
+     * 生成摘要 XML 片段
+     */
+    generateAbstract(text: string): string;
+    /**
+     * 校验 XML 是否符合 DTD 基本规范
+     */
+    validate(xml: string): ValidationResult;
+    /**
+     * 处理权利要求文本，为从属引用添加 claim-ref 标记
+     */
+    private processClaimText;
+    /**
+     * 添加说明书的一个章节
+     */
+    private addDescriptionSection;
+}

package/dist/generator.js

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PatentXMLGenerator = void 0;
+const xml_utils_1 = require("./xml-utils");
+/**
+ * 专利申请 XML 生成器
+ *
+ * 生成符合 CNIPA cn-application-body DTD 标准的 XML 文件
+ */
+class PatentXMLGenerator {
+    constructor(options) {
+        this.lang = options?.lang ?? 'zh';
+        this.country = options?.country ?? 'CN';
+        this.dtdVersion = options?.dtdVersion ?? '1.0';
+        this.useIndent = options?.indent ?? true;
+        this.dtdPath = options?.dtdPath ?? 'cn-application-body.dtd';
+    }
+    /**
+     * 生成完整的专利申请 XML
+     */
+    generate(patent) {
+        const n = (0, xml_utils_1.newline)(this.useIndent);
+        const parts = [];
+        // XML 声明
+        parts.push(`<?xml version="1.0" encoding="UTF-8"?>`);
+        parts.push(`<!DOCTYPE cn-application-body SYSTEM "${this.dtdPath}">`);
+        // 根元素
+        parts.push(`<cn-application-body lang="${this.lang}" country="${this.country}" dtd-version="${this.dtdVersion}">`);
+        // 权利要求书
+        parts.push(this.generateClaims(patent.claims));
+        // 说明书
+        parts.push(this.generateDescription(patent.title, patent.description));
+        // 附图（如果有）
+        if (patent.drawings && patent.drawings.length > 0) {
+            parts.push(this.generateDrawings(patent.drawings));
+        }
+        // 摘要
+        parts.push(this.generateAbstract(patent.abstract));
+        // 关闭根元素
+        parts.push(`</cn-application-body>`);
+        return parts.join(n);
+    }
+    /**
+     * 生成权利要求书 XML 片段
+     */
+    generateClaims(claims) {
+        const n = (0, xml_utils_1.newline)(this.useIndent);
+        const i1 = (0, xml_utils_1.indent)(1, this.useIndent);
+        const i2 = (0, xml_utils_1.indent)(2, this.useIndent);
+        const i3 = (0, xml_utils_1.indent)(3, this.useIndent);
+        const lines = [];
+        lines.push(`${i1}<cn-claims>`);
+        claims.forEach((claim, index) => {
+            const num = index + 1;
+            const claimType = claim.type === 'independent' ? 'independent' : 'dependent';
+            lines.push(`${i2}<claim num="${num}" claim-type="${claimType}">`);
+            lines.push(`${i3}<claim-text>${this.processClaimText(claim.text, claim.dependsOn)}</claim-text>`);
+            lines.push(`${i2}</claim>`);
+        });
+        lines.push(`${i1}</cn-claims>`);
+        return lines.join(n);
+    }
+    /**
+     * 生成说明书 XML 片段
+     */
+    generateDescription(title, desc) {
+        const n = (0, xml_utils_1.newline)(this.useIndent);
+        const i1 = (0, xml_utils_1.indent)(1, this.useIndent);
+        const i2 = (0, xml_utils_1.indent)(2, this.useIndent);
+        const lines = [];
+        let paragraphCounter = 1;
+        lines.push(`${i1}<description>`);
+        // 发明名称
+        lines.push(`${i2}<invention-title lang="${this.lang}">${(0, xml_utils_1.escapeXml)(title)}</invention-title>`);
+        // 技术领域
+        paragraphCounter = this.addDescriptionSection(lines, 'technical-field', '技术领域', desc.technicalField, paragraphCounter);
+        // 背景技术
+        paragraphCounter = this.addDescriptionSection(lines, 'background-art', '背景技术', desc.backgroundArt, paragraphCounter);
+        // 发明内容
+        paragraphCounter = this.addDescriptionSection(lines, 'disclosure', '发明内容', desc.disclosure, paragraphCounter);
+        // 附图说明
+        if (desc.drawingsDescription && desc.drawingsDescription.length > 0) {
+            paragraphCounter = this.addDescriptionSection(lines, 'description-of-drawings', '附图说明', desc.drawingsDescription, paragraphCounter);
+        }
+        // 具体实施方式
+        paragraphCounter = this.addDescriptionSection(lines, 'mode-for-invention', '具体实施方式', desc.embodiments, paragraphCounter);
+        // 序列表（可选）
+        if (desc.sequenceList && desc.sequenceList.length > 0) {
+            paragraphCounter = this.addDescriptionSection(lines, 'sequence-list-text', '序列表', desc.sequenceList, paragraphCounter);
+        }
+        lines.push(`${i1}</description>`);
+        return lines.join(n);
+    }
+    /**
+     * 生成附图 XML 片段
+     */
+    generateDrawings(drawings) {
+        const n = (0, xml_utils_1.newline)(this.useIndent);
+        const i1 = (0, xml_utils_1.indent)(1, this.useIndent);
+        const i2 = (0, xml_utils_1.indent)(2, this.useIndent);
+        const i3 = (0, xml_utils_1.indent)(3, this.useIndent);
+        const lines = [];
+        lines.push(`${i1}<cn-drawings>`);
+        drawings.forEach((drawing) => {
+            const widthAttr = drawing.width ? ` wi="${drawing.width}"` : '';
+            const heightAttr = drawing.height ? ` he="${drawing.height}"` : '';
+            lines.push(`${i2}<figure num="${(0, xml_utils_1.escapeXml)(drawing.figureNumber)}">`);
+            lines.push(`${i3}<img file="${(0, xml_utils_1.escapeXml)(drawing.filePath)}" img-format="${drawing.format}" img-content="drawing"${widthAttr}${heightAttr}/>`);
+            lines.push(`${i2}</figure>`);
+        });
+        lines.push(`${i1}</cn-drawings>`);
+        return lines.join(n);
+    }
+    /**
+     * 生成摘要 XML 片段
+     */
+    generateAbstract(text) {
+        const n = (0, xml_utils_1.newline)(this.useIndent);
+        const i1 = (0, xml_utils_1.indent)(1, this.useIndent);
+        const i2 = (0, xml_utils_1.indent)(2, this.useIndent);
+        const lines = [];
+        lines.push(`${i1}<cn-abstract>`);
+        lines.push(`${i2}<p num="0001" Italic="0">${(0, xml_utils_1.escapeXmlPreservingInlineTags)(text)}</p>`);
+        lines.push(`${i1}</cn-abstract>`);
+        return lines.join(n);
+    }
+    /**
+     * 校验 XML 是否符合 DTD 基本规范
+     */
+    validate(xml) {
+        const errors = [];
+        const warnings = [];
+        // 检查 XML 声明
+        if (!xml.startsWith('<?xml')) {
+            errors.push({
+                type: 'invalid_structure',
+                message: '缺少 XML 声明（<?xml version="1.0" encoding="UTF-8"?>）'
+            });
+        }
+        // 检查根元素必需属性
+        if (!/<cn-application-body[^>]*lang="/.test(xml)) {
+            errors.push({
+                type: 'missing_required',
+                message: 'cn-application-body 缺少必需属性 lang'
+            });
+        }
+        if (!/<cn-application-body[^>]*country="/.test(xml)) {
+            errors.push({
+                type: 'missing_required',
+                message: 'cn-application-body 缺少必需属性 country'
+            });
+        }
+        // 检查 claim 的 num 属性
+        const claimMatches = xml.matchAll(/<claim(\s[^>]*)?>/g);
+        for (const match of claimMatches) {
+            if (!match[1] || !/num="/.test(match[1])) {
+                errors.push({
+                    type: 'missing_required',
+                    message: `claim 元素缺少必需属性 num`
+                });
+            }
+        }
+        // 检查 p 的 num 和 Italic 属性
+        const pMatches = xml.matchAll(/<p(\s[^>]*)?>/g);
+        for (const match of pMatches) {
+            const attrs = match[1] || '';
+            if (!/num="/.test(attrs)) {
+                errors.push({
+                    type: 'missing_required',
+                    message: `p 元素缺少必需属性 num`
+                });
+            }
+            if (!/Italic="/.test(attrs)) {
+                errors.push({
+                    type: 'missing_required',
+                    message: `p 元素缺少必需属性 Italic`
+                });
+            }
+        }
+        // 检查权利要求编号连续性
+        const claimNums = [...xml.matchAll(/<claim[^>]*num="(\d+)"/g)].map(m => parseInt(m[1]));
+        for (let i = 0; i < claimNums.length; i++) {
+            if (claimNums[i] !== i + 1) {
+                errors.push({
+                    type: 'invalid_attribute',
+                    message: `权利要求编号不连续：期望 ${i + 1}，实际 ${claimNums[i]}`
+                });
+                break;
+            }
+        }
+        // 检查段落编号连续性（说明书内）
+        const descMatch = xml.match(/<description>([\s\S]*?)<\/description>/);
+        if (descMatch) {
+            const pNums = [...descMatch[1].matchAll(/<p[^>]*num="(\d+)"/g)].map(m => parseInt(m[1]));
+            for (let i = 0; i < pNums.length; i++) {
+                if (pNums[i] !== i + 1) {
+                    warnings.push(`说明书段落编号不连续：第${i + 1}个段落编号为 ${pNums[i]}`);
+                    break;
+                }
+            }
+        }
+        // 检查 GB18030 字符集
+        const textContent = xml.replace(/<[^>]*>/g, '');
+        const gb18030Check = (0, xml_utils_1.checkGB18030)(textContent);
+        if (!gb18030Check.valid) {
+            warnings.push(`发现 ${gb18030Check.invalidChars.length} 个超出 GB18030 字符集的字符：${gb18030Check.invalidChars.join(', ')}，提交时可能需要转为图片`);
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings
+        };
+    }
+    // ===== 私有方法 =====
+    /**
+     * 处理权利要求文本，为从属引用添加 claim-ref 标记
+     */
+    processClaimText(text, dependsOn) {
+        let processed = (0, xml_utils_1.escapeXmlPreservingInlineTags)(text);
+        // 自动识别 "根据权利要求X" 并添加 claim-ref
+        if (dependsOn) {
+            const refPattern = new RegExp(`(根据权利要求)(${dependsOn})(所述)`, 'g');
+            processed = processed.replace(refPattern, `$1<claim-ref idref="CLM-${String(dependsOn).padStart(4, '0')}">$2</claim-ref>$3`);
+        }
+        return processed;
+    }
+    /**
+     * 添加说明书的一个章节
+     */
+    addDescriptionSection(lines, tagName, headingText, paragraphs, startNum) {
+        const n = (0, xml_utils_1.newline)(this.useIndent);
+        const i2 = (0, xml_utils_1.indent)(2, this.useIndent);
+        const i3 = (0, xml_utils_1.indent)(3, this.useIndent);
+        let num = startNum;
+        lines.push(`${i2}<${tagName}>`);
+        lines.push(`${i3}<heading level="1">${headingText}</heading>`);
+        for (const para of paragraphs) {
+            const formattedNum = (0, xml_utils_1.formatParagraphNum)(num);
+            lines.push(`${i3}<p num="${formattedNum}" Italic="0">${(0, xml_utils_1.escapeXmlPreservingInlineTags)(para)}</p>`);
+            num++;
+        }
+        lines.push(`${i2}</${tagName}>`);
+        return num;
+    }
+}
+exports.PatentXMLGenerator = PatentXMLGenerator;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { PatentXMLGenerator } from './generator';
+export type { PatentInput, ClaimInput, DescriptionInput, DrawingInput, GeneratorOptions, ValidationResult, ValidationError, } from './types';

package/dist/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PatentXMLGenerator = void 0;
+var generator_1 = require("./generator");
+Object.defineProperty(exports, "PatentXMLGenerator", { enumerable: true, get: function () { return generator_1.PatentXMLGenerator; } });

package/dist/types.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 专利申请输入数据结构
+ */
+export interface PatentInput {
+    /** 发明名称 */
+    title: string;
+    /** 权利要求列表 */
+    claims: ClaimInput[];
+    /** 说明书各部分 */
+    description: DescriptionInput;
+    /** 摘要文本 */
+    abstract: string;
+    /** 附图信息（可选） */
+    drawings?: DrawingInput[];
+}
+/**
+ * 权利要求
+ */
+export interface ClaimInput {
+    /** 权利要求正文 */
+    text: string;
+    /** 权利要求类型 */
+    type: 'independent' | 'dependent';
+    /** 从属权利要求引用的权项号 */
+    dependsOn?: number;
+}
+/**
+ * 说明书各部分
+ */
+export interface DescriptionInput {
+    /** 技术领域（每个元素为一个段落） */
+    technicalField: string[];
+    /** 背景技术 */
+    backgroundArt: string[];
+    /** 发明内容 */
+    disclosure: string[];
+    /** 附图说明 */
+    drawingsDescription?: string[];
+    /** 具体实施方式 */
+    embodiments: string[];
+    /** 序列表（可选，生物领域专利） */
+    sequenceList?: string[];
+}
+/**
+ * 附图
+ */
+export interface DrawingInput {
+    /** 图号，如 "1"、"2a" */
+    figureNumber: string;
+    /** 图片文件路径 */
+    filePath: string;
+    /** 图片格式 */
+    format: 'tif' | 'jpg' | 'png';
+    /** 图片宽度(像素) */
+    width?: number;
+    /** 图片高度(像素) */
+    height?: number;
+}
+/**
+ * XML生成器选项
+ */
+export interface GeneratorOptions {
+    /** 语言代码，默认 'zh' */
+    lang?: string;
+    /** 国家代码，默认 'CN' */
+    country?: string;
+    /** DTD 版本，默认 '1.0' */
+    dtdVersion?: string;
+    /** 是否格式化输出（缩进），默认 true */
+    indent?: boolean;
+    /** DTD 文件路径，默认 'cn-application-body.dtd' */
+    dtdPath?: string;
+}
+/**
+ * XML校验结果
+ */
+export interface ValidationResult {
+    /** 是否通过校验 */
+    valid: boolean;
+    /** 错误列表 */
+    errors: ValidationError[];
+    /** 警告列表 */
+    warnings: string[];
+}
+/**
+ * 校验错误
+ */
+export interface ValidationError {
+    /** 错误类型 */
+    type: 'missing_required' | 'invalid_attribute' | 'invalid_structure' | 'encoding';
+    /** 错误描述 */
+    message: string;
+    /** 出错位置（行号） */
+    line?: number;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/xml-utils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * XML 工具函数
+ */
+/** XML 特殊字符转义 */
+export declare function escapeXml(text: string): string;
+/**
+ * 智能转义：保留合法的行内XML标记，转义其余内容
+ * 支持 <sup>、<sub>、<b>、<i>、<u>、<br/> 等 DTD 允许的行内标记
+ */
+export declare function escapeXmlPreservingInlineTags(text: string): string;
+/**
+ * 生成缩进字符串
+ */
+export declare function indent(level: number, useIndent: boolean): string;
+/**
+ * 生成换行符
+ */
+export declare function newline(useIndent: boolean): string;
+/**
+ * 段落编号格式化：将数字转为4位补零字符串
+ * 1 -> "0001", 12 -> "0012"
+ */
+export declare function formatParagraphNum(num: number): string;
+/**
+ * 检测文本是否为GB18030字符集范围内
+ * 超出范围的字符需要转为图片
+ */
+export declare function checkGB18030(text: string): {
+    valid: boolean;
+    invalidChars: string[];
+};