技术文章发布系统 - 术语库字段命名规范

1. 统一术语库字段命名标准1.1 核心字段定义字段名类型必填描述示例`term`string是标准术语名称"CUDA核心"`en`string否英文对应词"CUDA cores"`standard`string是标准规范来源"NVIDIA CUDA 架构术语"`category`string是所属分类"显卡/GPU架构"`synonyms_allowed`string[]否允许的同义词列表["流处理器"]`synonyms_forbidden`string[]否禁止的同义词列表["cuda核"]`definition`string是术语定义"NVIDIA GPU中的并行计算核心单元"`usage_notes`string否使用注意事项"仅用于NVIDIA架构描述"`validation_rule`string否验证规则"必须伴随数值单位"`source_url`string否权威来源链接"https://www.nvidia.com/cuda"`created_at`string是创建时间"2025-12-01"`updated_at`string是更新时间"2025-12-01"`status`string是状态"active/draft/deprecated"1.2 术语分类体系术语分类结构: 计算机硬件: 处理器: - CPU架构 - 制程工艺 - 性能指标 显卡: - GPU架构 - 显存技术 - 显示接口 存储: - 内存技术 - 存储接口 - 性能指标 计算机软件: 操作系统: - 内核技术 - 系统架构 数据库: - 存储引擎 - 查询优化 1.3 命名规范1.3.1 术语命名规则中文术语: 使用标准技术词汇，避免口语化表达英文术语: 保持原始技术文档的大小写格式缩写词: 全部大写，如 "PCIe", "TDP", "GDDR6X"品牌名称: 保持官方大小写，如 "NVIDIA", "Intel", "AMD"1.3.2 字段命名约定// 术语库条目结构示例 { "term": "CUDA核心", // 标准中文术语 "en": "CUDA cores", // 英文对应 "standard": "NVIDIA CUDA", // 标准来源 "category": "显卡/GPU架构", // 三级分类 "definition": "NVIDIA GPU中的并行计算核心单元", "synonyms_allowed": ["流处理器"], // 允许同义词 "synonyms_forbidden": [], // 禁止用词 "validation_rule": "数值+单位", "usage_notes": "仅用于NVIDIA架构", "source_url": "https://...", "status": "active", "created_at": "2025-12-01", "updated_at": "2025-12-01" } 2. 关键词规范与示例模板2.1 关键词选择标准2.1.1 数量要求最少：5个关键词最多：8个关键词推荐：6-7个关键词2.1.2 质量要求专业性: 必须是标准技术术语相关性: 在正文中出现不少于3次准确性: 与文章内容高度相关规范性: 符合术语库标准2.2 关键词分类模板2.2.1 硬件评测类文章必需关键词: - 产品型号 (如: RTX-4090, Ryzen-9-7950X) - 核心技术 (如: CUDA核心, 制程工艺) - 性能指标 (如: 基准测试, 能效比) - 技术标准 (如: PCIe-4.0, GDDR6X) - 应用场景 (如: 游戏性能, 创作性能) 可选关键词: - 对比产品 (如: RTX-4080, RX-7900XTX) - 技术特性 (如: 光线追踪, DLSS) - 物理参数 (如: TDP, 显存带宽) 2.2.2 技术分析类文章必需关键词: - 技术领域 (如: 架构分析, 调度机制) - 核心技术 (如: 并行计算, 内存管理) - 性能指标 (如: 延迟, 吞吐量) - 技术标准 (如: IEEE-754, ISO标准) - 应用场景 (如: 服务器, 桌面应用) 可选关键词: - 技术版本 (如: Kernel-6.12, DirectX-12) - 算法概念 (如: 调度算法, 缓存策略) - 系统组件 (如: IO调度器, 内存分配器) 2.3 关键词验证规则// 关键词验证逻辑 const KEYWORD_VALIDATION_RULES = { // 数量验证 count: { min: 5, max: 8, message: "关键词数量必须在5-8个之间" }, // 长度验证 length: { min: 2, max: 20, message: "关键词长度应在2-20字符之间" }, // 内容验证 content: { minOccurrences: 3, // 正文中至少出现3次 contextRelevance: 0.6, // 上下文相关性阈值 message: "关键词必须在正文中有足够的相关性和出现频次" }, // 技术术语验证 technical: { mustBeInGlossary: true, // 必须在术语库中 allowAbbreviations: true, // 允许标准缩写 message: "关键词必须是标准技术术语" } }; 3. 批量修复与校验指南3.1 自动化修复流程3.1.1 修复脚本配置// repair.config.js module.exports = { // 修复模式 mode: 'auto', // auto | manual | dry-run // 备份设置 backup: { enabled: true, path: './backups', keepDays: 7 }, // 修复规则 rules: { // 元数据修复 metadata: { autoFillMissing: true, validateRequiredFields: true, normalizeDates: true }, // 内容修复 content: { ensureRequiredSections: true, fixKeywordOccurrences: true, normalizeTerminology: true }, // 文件结构修复 structure: { renameFilesToMatchTitle: true, ensurePathConsistency: true, validateCategoryPaths: true } }, // 验证设置 validation: { checkTerminologyConsistency: true, validateKeywordRelevance: true, verifyExternalLinks: true } }; 3.1.2 批量修复命令# 修复指定目录 npm run repair -- --dir ./计算机硬件/处理器 # 干运行模式（仅检查不修复） npm run repair -- --dry-run # 指定修复规则 npm run repair -- --rules=metadata,content # 生成修复报告 npm run repair -- --report=./reports/repair-log.json 3.2 校验检查清单3.2.1 术语一致性检查检查项目: - 术语拼写一致性: - 检查大小写规范 (CUDA vs cuda) - 验证缩写格式 (PCIe vs PCI-E) - 确认品牌写法 (NVIDIA vs nvidia) - 术语使用规范性: - 验证术语在术语库中存在 - 检查禁用同义词使用 - 确认上下文使用正确 - 术语更新同步: - 检查术语库最新版本 - 同步新增术语到文章 - 标记过时术语替换 3.2.2 关键词质量检查质量指标: - 覆盖率: 关键词是否覆盖文章核心内容 - 专业性: 是否使用标准技术术语 - 一致性: 关键词间是否存在语义重复 - 相关性: 与正文内容关联度 - 规范性: 符合命名和格式要求 检查流程: 1. 提取文章所有技术术语 2. 对比术语库验证专业性 3. 统计关键词在正文出现频次 4. 分析关键词语义相关性 5. 生成优化建议报告 3.3 可执行更新脚本3.3.1 术语库同步脚本// sync-terminology.js const fs = require('fs'); const path = require('path'); const glob = require('glob'); class TerminologySync { constructor(config) { this.config = config; this.glossary = this.loadGlossary(); this.stats = { updated: 0, errors: 0, warnings: 0 }; } async sync() { const files = await this.getMarkdownFiles(); for (const file of files) { try { await this.syncFile(file); } catch (error) { console.error(`同步失败: ${file}`, error.message); this.stats.errors++; } } this.generateReport(); } async syncFile(filePath) { const content = fs.readFileSync(filePath, 'utf8'); const { data, content: body } = matter(content); // 同步关键词到标准术语 if (data.keywords) { data.keywords = data.keywords.map(keyword => this.standardizeTerm(keyword) ); } // 替换正文中的非标准术语 let updatedBody = body; for (const [nonStandard, standard] of Object.entries(this.config.termMappings)) { const regex = new RegExp(`\\b${nonStandard}\\b`, 'gi'); updatedBody = updatedBody.replace(regex, standard); } // 写回文件 const updated = matter.stringify(updatedBody, data); fs.writeFileSync(filePath, updated); this.stats.updated++; } standardizeTerm(term) { // 在术语库中查找标准形式 const glossaryEntry = this.glossary.find(item => item.term === term || item.synonyms_allowed?.includes(term) ); return glossaryEntry ? glossaryEntry.term : term; } generateReport() { const report = { timestamp: new Date().toISOString(), stats: this.stats, summary: `术语同步完成: ${this.stats.updated}个文件更新, ${this.stats.errors}个错误` }; fs.writeFileSync( this.config.reportPath, JSON.stringify(report, null, 2) ); console.log(report.summary); } } // 使用示例 const sync = new TerminologySync({ glossaryPath: './config/glossary.json', reportPath: './reports/terminology-sync.json', termMappings: { 'cuda核': 'CUDA核心', '流处理器': 'CUDA核心', '功耗设计': 'TDP', '每瓦性能': '能效比' } }); sync.sync(); 3.3.2 关键词优化脚本// optimize-keywords.js class KeywordOptimizer { constructor(glossary, contentAnalyzer) { this.glossary = glossary; this.analyzer = contentAnalyzer; } optimizeKeywords(article) { const { content, keywords: currentKeywords } = article; // 分析内容提取候选关键词 const candidates = this.extractCandidateKeywords(content); // 评估现有关键词质量 const currentScore = this.evaluateKeywords(currentKeywords, content); // 生成优化建议 const suggestions = this.generateSuggestions(candidates, currentKeywords); return { current: { keywords: currentKeywords, score: currentScore, issues: this.identifyIssues(currentKeywords, content) }, optimized: suggestions.bestCombination, improvements: suggestions.improvements }; } extractCandidateKeywords(content) { // 提取技术术语 const techTerms = this.extractTechnicalTerms(content); // 统计词频和重要性 const termScores = techTerms.map(term => ({ term, frequency: this.analyzer.getFrequency(term, content), relevance: this.analyzer.getRelevance(term, content), technicalScore: this.getTechnicalScore(term) })); // 按综合得分排序 return termScores .sort((a, b) => b.relevance - a.relevance) .slice(0, 15); // 取前15个候选词 } generateSuggestions(candidates, currentKeywords) { // 确保覆盖核心概念 const coreConcepts = this.identifyCoreConcepts(candidates); // 平衡专业性和可读性 const balancedSet = this.balanceKeywordSet([ ...coreConcepts, ...this.selectHighScoringCandidates(candidates, 6) ]); return { bestCombination: balancedSet.slice(0, 8), improvements: this.compareKeywordSets(currentKeywords, balancedSet) }; } } // 命令行接口 if (require.main === module) { const optimizer = new KeywordOptimizer(glossary, analyzer); // 处理单个文件 if (process.argv.includes('--file')) { const filePath = process.argv[process.argv.indexOf('--file') + 1]; const article = loadArticle(filePath); const result = optimizer.optimizeKeywords(article); console.log(JSON.stringify(result, null, 2)); } // 批量处理 if (process.argv.includes('--batch')) { const dir = process.argv[process.argv.indexOf('--batch') + 1]; batchOptimize(dir, optimizer); } } 4. 执行指南4.1 术语库标准化流程# 1. 备份现有术语库 cp config/glossary.json config/glossary.json.backup # 2. 运行术语标准化 node scripts/standardize-terminology.js # 3. 验证术语一致性 npm run validate -- --check=terminology # 4. 同步更新所有文章 node scripts/sync-terminology.js --all # 5. 生成更新报告 node scripts/generate-report.js --type=terminology 4.2 关键词优化流程# 1. 分析现有关键词质量 node scripts/analyze-keywords.js --all # 2. 生成优化建议 node scripts/suggest-keywords.js --quality-threshold=0.8 # 3. 应用优化建议 node scripts/apply-keyword-suggestions.js --confirm # 4. 验证优化结果 npm run validate -- --check=keywords 4.3 质量监控设置# .github/workflows/quality-check.yml name: 术语与关键词质量检查 on: pull_request: paths: - '**.md' - 'config/glossary.json' - 'config/terms.yaml' jobs: quality-check: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: 安装依赖 run: npm install - name: 术语一致性检查 run: npm run validate -- --check=terminology - name: 关键词质量检查 run: npm run validate -- --check=keywords - name: 生成质量报告 run: node scripts/generate-quality-report.js - name: 上传报告 uses: actions/upload-artifact@v3 with: name: quality-report path: reports/quality-check.json 通过以上规范和工具，确保技术文章的术语使用一致性和关键词质量，提升整体内容的专业性和标准化程度。