施工材料CSV导入工作台已经有了完整业务闭环：第一篇处理引号、BOM与记录边界，第二篇确认六列映射并隔离无效数量，第三篇按逻辑记录切片并把提交游标与数据库事务绑定。到了准备发布的阶段，新风险往往不在按钮或列表，而在依赖版本发生变化以后，过去合法的文件被解析成了不同数量的记录。只要记录边界发生变化，第三篇保存的nextRecord就可能指向错误的数据；只要数量转换规则变化，第二篇的隔离结果就可能与旧版本不一致。

因此这一篇不把回归复核理解成“打开几张页面看一遍”，而把它当成一组必须同时满足的发布条件：锁定依赖树、固定解析参数、重放代表性输入、核对映射与校验契约、执行中断续接检查、确认导入历史兼容性。HarmonyOS工程中的第三方包采用ohpm管理，Node预处理逻辑里的csv-parse则使用对应的Node依赖锁，两条依赖路径分别复核，不把Node包的成功安装直接等同于可以在ArkTS应用中使用。

让版本锁定有证据可追踪

oh-package.json5描述HarmonyOS工程和模块的依赖关系，oh-package-lock.json5记录解析后的依赖版本与依赖树。发布阶段应把锁文件提交到版本控制，并让CI和本地一致地安装；不要在构建期间删除锁文件后根据宽泛范围重新解析版本，也不要人工编辑锁文件内部的依赖元数据。工程级的依赖覆盖策略和模块级依赖配置需要一并检查，因为覆盖规则也会改变实际安装结果。

Node预处理侧采用package.json与相应锁文件管理解析库版本，记录csv-parse版本以及解析配置，包括BOM识别、最大记录长度、空行策略、列数不齐处理和引号行为。相同依赖版本配不同参数，也可能输出不同的二维记录。因此发布身份还应包括解析配置摘要、列映射规则修订、数量范围版本和导入断点结构版本，不能单凭一个包版本号判定兼容。

要解决的问题：发布记录与仓库依赖文件无法对应

const fs = require('node:fs');
const os = require('node:os');
const path = require('node:path');
const { createHash } = require('node:crypto');
const assert = require('node:assert/strict');
function sha256(bytes) {
  return createHash('sha256').update(bytes).digest('hex');
}
function manifestFingerprint(root, files) {
  const result = {};
  for (const filename of files) {
    const filepath = path.join(root, filename);
    if (!fs.existsSync(filepath)) throw new Error(`缺少文件：${filename}`);
    result[filename] = sha256(fs.readFileSync(filepath));
  }
  return result;
}
const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'package-check-'));
try {
  fs.writeFileSync(path.join(tmp, 'oh-package.json5'), '{"dependencies":{}}');
  fs.writeFileSync(path.join(tmp, 'oh-package-lock.json5'), '{}');
  const report = manifestFingerprint(tmp, ['oh-package.json5', 'oh-package-lock.json5']);
  assert.equal(report['oh-package.json5'].length, 64);
  assert.notEqual(report['oh-package.json5'], report['oh-package-lock.json5']);
  console.log('dependency file digests recorded:', Object.keys(report).length);
} finally {
  fs.rmSync(tmp, { recursive: true, force: true });
}

这里的哈希是对依赖文件整体的固定指纹，供发布记录、构建产物来源和代码提交核对。它不通过自行解析锁文件结构来推断安装结果，更不把两份文件恰好存在当成依赖已正确安装。实际发布需要配合ohpm安装结果、包来源与校验值复核；以上函数只负责确保两份关键文件存在并可形成稳定摘要。如果构建机器上的文件摘要与批准版本不符，立即停止制作发布包并排查原因。

回归样本应覆盖导致数据错位的细节

回归集要围绕真实契约构建，而不是只用没有逗号的三条样本。最少包括UTF-8带BOM、双引号内的逗号、连续双引号、字段内部换行、末尾空字段、重复表头、列数不足、负数与中文数量、超过业务精度的小数、单条过长，以及未闭合引号。对于语法正常但业务不合格的材料，应保留错误记录并继续核查其他材料；对于引号破损，必须阻断当前文件，不能把错误文本拼接成看似合法的记录。

若升级第三方解析器，先用固定输入分别跑旧解析器与新解析器，比较每条逻辑记录的原始字符串序列和错误类别。不要以“解析没有抛错”作为唯一通过条件。带有合法跨行字段的清单，在按物理行切分的错误实现中甚至可能输出更多记录，而这些多出来的记录后续完全可能被误写入材料表。测试结果必须同时覆盖接受数、隔离数、文件身份和断点后的下一条逻辑记录号。

要解决的问题：回归测试未覆盖引号与跨行数据

const assert = require('node:assert/strict');
function readCsv(input) {
  const text = input.replace(/^/, '');
  const rows = []; let row = [], field = '', state = 'plain';
  function endField() { row.push(field); field = ''; state = 'plain'; }
  function endRow() { rows.push(row); row = []; }
  for (let i = 0; i < text.length; i++) {
    const ch = text[i];
    if (state === 'quoted') {
      if (ch === '"' && text[i + 1] === '"') { field += '"'; i++; }
      else if (ch === '"') state = 'afterQuote';
      else field += ch;
    } else if (ch === '"') {
      if (state !== 'plain' || field !== '') throw new Error('引号位置错误');
      state = 'quoted';
    } else if (ch === ',' || ch === '\n' || ch === '\r') {
      endField();
      if (ch !== ',') {
        if (ch === '\r' && text[i + 1] === '\n') i++;
        endRow();
      }
    } else {
      if (state === 'afterQuote') throw new Error('引号后内容无效');
      field += ch;
    }
  }
  if (state === 'quoted') throw new Error('引号未闭合');
  if (state !== 'plain' || field || row.length) { endField(); endRow(); }
  return rows;
}
const input = '\uFEFF编码,名称\nMAT-001,"弯头,不锈钢"\nMAT-002,"检修\n说明"';
const rows = readCsv(input);
assert.equal(rows.length, 3);
assert.equal(rows[1][1], '弯头,不锈钢');
assert.equal(rows[2][1], '检修\n说明');
assert.deepEqual(readCsv('名称\n"双""引号"')[1], ['双"引号']);
assert.throws(() => readCsv('名称\n"未闭合'));
console.log('CSV boundary cases checked:', 4);

这里的独立解析函数是回归样本的校验工具，用于明确预期语义，并非代替上一章选择的三方解析库。实际集成回归必须再把同一份输入交给csv-parse或目标ArkTS适配器，逐格比对结果。正因为解析器可能升级，期望值应保存在固定用例中，而不是由升级后的同一个解析器自行生成。错误行隔离和断点逻辑也需要使用已确认的材料业务规则，不应把解析阶段的正常输出等同于整条导入链路通过。

让续接结构成为版本兼容的一部分

第三篇保存的导入身份由原始文件摘要、映射与校验版本组成，断点包含nextRecord并与已入库的逻辑记录对应。升级后必须能准确读出这些值，确认旧版记录序号与新版解析器对同一文件的序号一致。若断点表结构升级，需要提供确定的数据迁移步骤和可回滚方案；如果映射规则升级产生不同导入身份，就应清晰提示重新确认，而不是修改旧身份的含义。

回归时至少安排三种状态：文件完全未提交、在两个完整事务之后中断、刚写完最后一个批次后重新打开。重复调用同一批次，主键约束应使材料行数不增加；中途把源文件替换成同名不同内容，摘要校验应拒绝按旧游标继续；先提交成功记录和隔离记录再推进游标，异常回滚后仍可以从正确边界继续。对于Node数据库与HarmonyOS ArkData两种实现，应分别检查业务唯一键与提交顺序，不能只拿Node的事务行为推断设备侧实现也必然一致。

发布前把所有条件变成确定的门禁

发布复核清单可分成依赖文件、解析器集成、字段映射、错误隔离、事务续接、资源释放和隐私处理七部分。锁文件存在只是必要条件之一，三方包实际安装版本与锁文件一致、关键回归用例全部执行、出现的失败有明确处理结论，才适合打开发布门禁。那些未运行的用例不能自动记成通过；缺少平台构建结果时保持门禁关闭，同时可以独立复核JavaScript业务代码。

要解决的问题：人工勾选遗漏未检查的关键项目

const assert = require('node:assert/strict');
const required = ['lock', 'parser', 'mapping', 'quarantine', 'resume', 'cleanup'];
function releaseDecision(evidence) {
  const pending = required.filter(key => evidence[key] !== 'passed');
  const inconsistent = evidence.schemaVersion !== evidence.expectedSchemaVersion;
  return {
    approved: pending.length === 0 && !inconsistent,
    pending: [...pending, ...(inconsistent ? ['schema-version'] : [])]
  };
}
const checked = { lock: 'passed', parser: 'passed', mapping: 'passed',
  quarantine: 'passed', resume: 'passed', cleanup: 'pending',
  schemaVersion: 2, expectedSchemaVersion: 2 };
const first = releaseDecision(checked);
assert.equal(first.approved, false);
assert.deepEqual(first.pending, ['cleanup']);
const completed = releaseDecision({ ...checked, cleanup: 'passed' });
assert.equal(completed.approved, true);
console.log('release gate:', first.approved ? 'ready' : first.pending.join(','));

这段门禁函数本身很简单，关键是如何形成evidence：每个值应来自真实的CI用例、依赖解析结果或明确的人工复核结论，而不是按钮默认选中。发布页面只负责展示证据状态、版本摘要与未解决项目；一旦修改解析参数、校验规则或三方版本，相关门禁应重新变成待核查。保留上一版本的发布清单和测试输入摘要，便于出现兼容问题时准确比较变化范围。

与HarmonyOS页面和工程维护形成闭环

页面呈现尽量克制：先显示当前导入契约版本和依赖摘要，再给出编码、解析、映射、隔离与续接的结论，重要问题提供可定位的材料记录号或配置项。用户选择新文件时清理旧预览、取消页面订阅；已提交的隔离记录、导入历史和版本审计继续保留。三方库升级最好作为独立改动进入代码评审，避免与字段业务规则一起变更而难以确定回归差异来自哪里。

这套导入工作台真正值得维护的是稳定的数据契约，而不是某个解析函数调用得有多短。把依赖树固定下来，把CSV边界样本留下来，把续接行为纳入发布门禁，才能在未来增加供应商、扩展字段或调整页面时仍然明确每一条材料记录从哪里来、为什么进入材料表、又为何被隔离。

相关官方开发资料：HarmonyOS工程oh-package.json5配置及锁文件、ohpm clean与锁文件保留选项、ArkTS运行时概述；CSV解析器流式行为参阅CSV Parse Stream API。