cms-website

xinyouhe/cms-website

Fork 0

Commit Graph

Author	SHA1	Message	Date
浅念	0e8b2b5356	feat(import): job 骨架与生命周期 Plan 3 Task 1：sf import 命令骨架 + import_jobs 生命周期（空管道，Task 6 接真实管道）。 - import.service.ts（零装饰器）：createImportJob——站点/快照解析（缺省按 (connection, kind='wxr') 选最新；三快照绑定按前置事实 13 记入报告，job 行不扩列）、幂等建行（默认 key=site+wxr快照+三语义版本；重复提交复用既有 job 不重跑，并发撞唯一约束重查收敛）、状态推进 queued→running→succeeded/failed（attempt/started_at/finished_at/ error_code/error_summary）、报告落 artifacts/import/<jobId>/reports/import.json （全四版本块：adapter/mapping/sanitizer/parser；job 行落 mapping_version） - 可预期错误带 code：SITE_NOT_FOUND / SNAPSHOT_NOT_FOUND / NO_WXR_SNAPSHOT / PIPELINE_FAILED——解析期失败零 job 行 - adapter 事件加法式补 postId（前置事实 12）：unsupported/error 事件可选携带 String(postId)，缺失时键缺席不硬造 source_id；row 事件与报告聚合零影响、不触发版本 bump - canonicalJson 提取至 apps/api/src/common/canonical.ts 共享导出（前置事实 6）， register 侧改 import 零行为变更（既有清单哈希测试守护） - sf CLI + import 命令（--site/--snapshot/--key/--connection），输出 job 摘要与版本块 - 测试：tests/integration/import-job.test.ts（5 例：生命周期观察/最新快照解析/幂等复用与并发收敛/可预期失败零落行/failed 路径）+ adapter postId 3 例 + canonical 单测 6 例（265→279 全绿）；typecheck 四段链/lint 绿；临时库 CLI 冒烟（register→import→复用）通过 Co-Authored-By: Claude Code <noreply@anthropic.com>	2026-10-21 15:30:42 +08:00
浅念	073b9ca39c	fix(adapter-wp): IO 错误归入 fatalError；rowErrors 封顶；timings 契约与纯 term 流测试；PARSER 版本漂移保险审查修复（Task 6 质量审查 5 项）： - Fix 1：Node 系统错误（Error 且 code 字符串——ENOENT/EACCES 等 IO 形态）与 WxrError 同路记入 fatalError（message 含 code 与 path），报告不上抛保留已聚合部分；无 code 的程序 bug 仍原样上抛；模块头契约注释同步修正 - Fix 2：rowErrors 固化封顶 10_000 条 + rowErrorsTruncated 计数（超出只计数不固化，防对抗性输入使报告体积失去上界；counts/byDiffType 统计维度不受截断影响）；HTML 渲染追加截断说明行 - Fix 3：timings 注入契约测试（多 chunk 流消费完成后外部对象 parseMs>0/sanitizeMs>=0） - Fix 4：纯 wp:term 流测试（counts 空对象/rows=0/terms 计数） - Fix 5：PARSER_VERSION 漂移保险（createRequire 读 saxes/package.json，主版本不一致即爆红，fail loud） 247 → 253 测试全绿；tsc/lint/build 绿。 Co-Authored-By: Claude Code <noreply@anthropic.com>	2026-10-21 12:04:15 +08:00
浅念	6573b8b326	feat(adapter-wp): 全链组装与导入前报告 - src/versions.ts：ADAPTER/MAPPING/SANITIZER_VERSION 三常量（bump 语义 JSDoc 冻结：映射表/清洗白名单实质变更才 bump 对应项，三者独立演进）+ PARSER_VERSION（saxes 硬编码） - src/adapter.ts：runWxrAdapter 串联 parseWxrStream→mapItem→sanitizeBodyHtml 为 AsyncGenerator<AdapterEvent>；term 旁路直通；bodyHtml 为空跳过清洗零 diff； changed 用 html!==input（Task 5 移交：diffs.length===0 ≠ 未变更）；validateUniversalRow 加法式契约复检（不动 contracts）；解析/清洗分段计时（parser.next() await 窗口归属解析） - src/report.ts：runWxrAdapterReport 聚合（首条版本块/按 sourceType Created-Skipped(无变化)-Failed-Unsupported/清洗统计按 diff.type+changedRows/行级错误 rawLocation+message +excerpt/致命 WxrError 记 fatalError 不上抛——wxr:probe 消费通道）；renderReportHtml 所有动态文本经 escapeHtml（<>&"'，Task 5 移交的标记注入面防线） - test/adapter.test.ts：19 用例（mini 全链/changed 语义/报告结构/恶意样本转义/ unsupported-error 汇聚/wppop 失败贯通/JSON 可序列化/致命解析错误交付确定性） Co-Authored-By: Claude Code <noreply@anthropic.com>	2026-10-21 11:44:55 +08:00

Author

SHA1

Message

Date

浅念

0e8b2b5356

feat(import): job 骨架与生命周期

Plan 3 Task 1：sf import 命令骨架 + import_jobs 生命周期（空管道，Task 6 接真实管道）。

- import.service.ts（零装饰器）：createImportJob——站点/快照解析（缺省按 (connection,
  kind='wxr') 选最新；三快照绑定按前置事实 13 记入报告，job 行不扩列）、幂等建行
  （默认 key=site+wxr快照+三语义版本；重复提交复用既有 job 不重跑，并发撞唯一约束
  重查收敛）、状态推进 queued→running→succeeded/failed（attempt/started_at/finished_at/
  error_code/error_summary）、报告落 artifacts/import/<jobId>/reports/import.json
  （全四版本块：adapter/mapping/sanitizer/parser；job 行落 mapping_version）
- 可预期错误带 code：SITE_NOT_FOUND / SNAPSHOT_NOT_FOUND / NO_WXR_SNAPSHOT /
  PIPELINE_FAILED——解析期失败零 job 行
- adapter 事件加法式补 postId（前置事实 12）：unsupported/error 事件可选携带
  String(postId)，缺失时键缺席不硬造 source_id；row 事件与报告聚合零影响、不触发版本 bump
- canonicalJson 提取至 apps/api/src/common/canonical.ts 共享导出（前置事实 6），
  register 侧改 import 零行为变更（既有清单哈希测试守护）
- sf CLI + import 命令（--site/--snapshot/--key/--connection），输出 job 摘要与版本块
- 测试：tests/integration/import-job.test.ts（5 例：生命周期观察/最新快照解析/幂等复用
  与并发收敛/可预期失败零落行/failed 路径）+ adapter postId 3 例 + canonical 单测 6 例
  （265→279 全绿）；typecheck 四段链/lint 绿；临时库 CLI 冒烟（register→import→复用）通过

Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-10-21 15:30:42 +08:00

浅念

073b9ca39c

fix(adapter-wp): IO 错误归入 fatalError；rowErrors 封顶；timings 契约与纯 term 流测试；PARSER 版本漂移保险

审查修复（Task 6 质量审查 5 项）：
- Fix 1：Node 系统错误（Error 且 code 字符串——ENOENT/EACCES 等 IO 形态）与 WxrError
  同路记入 fatalError（message 含 code 与 path），报告不上抛保留已聚合部分；无 code 的
  程序 bug 仍原样上抛；模块头契约注释同步修正
- Fix 2：rowErrors 固化封顶 10_000 条 + rowErrorsTruncated 计数（超出只计数不固化，
  防对抗性输入使报告体积失去上界；counts/byDiffType 统计维度不受截断影响）；HTML
  渲染追加截断说明行
- Fix 3：timings 注入契约测试（多 chunk 流消费完成后外部对象 parseMs>0/sanitizeMs>=0）
- Fix 4：纯 wp:term 流测试（counts 空对象/rows=0/terms 计数）
- Fix 5：PARSER_VERSION 漂移保险（createRequire 读 saxes/package.json，主版本不一致
  即爆红，fail loud）

247 → 253 测试全绿；tsc/lint/build 绿。

Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-10-21 12:04:15 +08:00

浅念

6573b8b326

feat(adapter-wp): 全链组装与导入前报告

- src/versions.ts：ADAPTER/MAPPING/SANITIZER_VERSION 三常量（bump 语义 JSDoc 冻结：
  映射表/清洗白名单实质变更才 bump 对应项，三者独立演进）+ PARSER_VERSION（saxes 硬编码）
- src/adapter.ts：runWxrAdapter 串联 parseWxrStream→mapItem→sanitizeBodyHtml 为
  AsyncGenerator<AdapterEvent>；term 旁路直通；bodyHtml 为空跳过清洗零 diff；
  changed 用 html!==input（Task 5 移交：diffs.length===0 ≠ 未变更）；validateUniversalRow
  加法式契约复检（不动 contracts）；解析/清洗分段计时（parser.next() await 窗口归属解析）
- src/report.ts：runWxrAdapterReport 聚合（首条版本块/按 sourceType Created-Skipped(无
  变化)-Failed-Unsupported/清洗统计按 diff.type+changedRows/行级错误 rawLocation+message
  +excerpt/致命 WxrError 记 fatalError 不上抛——wxr:probe 消费通道）；renderReportHtml
  所有动态文本经 escapeHtml（<>&"'，Task 5 移交的标记注入面防线）
- test/adapter.test.ts：19 用例（mini 全链/changed 语义/报告结构/恶意样本转义/
  unsupported-error 汇聚/wppop 失败贯通/JSON 可序列化/致命解析错误交付确定性）

Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-10-21 11:44:55 +08:00

3 Commits