浅念
586d715455
- registerSource(db, input)：wxr/sitemap/媒体目录三类输入登记为 content-addressed 快照——流式 copy+sha256 单遍双算（64KB 块），副本落 storage/snapshots/<kind>/<sha256前2>/<sha256>（文件）或 <sha256>/（媒体整树）， 后续任务只读副本；UNIQUE(site,kind,sha256) 幂等（重复登记复用既有行） - media_bundle 哈希钉死：排序相对路径（'/' 归一）+ 每文件 sha256 → canonical JSON（键排序无空白）→ 再 sha256；不含 mtime、不依赖遍历顺序；完整清单 （path/bytes/sha256）入 metadata jsonb；符号链接（含 junction）跳过并记录 - site 按 key select-then-insert upsert（23505 竞态重查）；connection 判重键 (site_id,name) 为应用层 select-then-insert（表无库级唯一，注释注明） - 路径安全：输入 realpath 后须在 allowedRoots 白名单内（缺省 storage/incoming）， ENOENT/越界/类型不符抛带 code 的 SourceRegisterError；全部输入先校验后摄取， 任何失败零落库零复制 - 报告落 artifacts/register/<runId>/reports/register.json（runId=时间戳+随机； 输入清单/哈希/大小/耗时） - scripts/sf.ts（commander）：wxr:probe 只读诊断（任意可读路径，IO/损坏文件出 报告不崩——Task 6 fatalError 契约）出 JSON/HTML 报告；source:register 调服务 出摘要。CLI 机制钉死：根 devDep tsx + 根 script sf + commander 根依赖，TS 源码 直连（@sf/* 经 tsconfig paths，不经 dist） - source.module.ts：Nest 注册 SourceRegisterService（standalone context 用）； register.service.ts 刻意零装饰器（CLI/测试直 import 不拉 reflect-metadata） - launder 类型垫片改经 triple-slash 引用随 html.ts 进任意编译程序（apps/api 与 根程序直连适配器源码的新场景）；apps/api 增 @sf/adapter-wp workspace 依赖与 paths 映射（register.service 消费 ADAPTER_VERSION 单源） - 测试 +7（tests/integration/source-register.test.ts，临时库 + tmpdir storage/ 报告根 finally 清理）：三输入登记/清单哈希定义对拍/重复登记幂等/mtime 排除/ 副本布局与内容一致/路径安全六分支/junction 跳过/报告契约；全套 260 绿 Co-Authored-By: Claude Code <noreply@anthropic.com>
SiteForge
WordPress 站点到静态站点迁移引擎：读取 WXR/Sitemap/媒体归档 → 清洗入不可变内容库 → 主题化构建为自包含静态站点（Astro），全程可审计、可复现、契约冻结。
快速开始
前置：Node.js >= 22、Docker、corepack。
corepack enable # 激活 pnpm（或自行安装 pnpm@10）
pnpm install # 安装依赖
pnpm db:up # 启动 PostgreSQL 16（宿主端口 5434，等 healthcheck 就绪）
pnpm db:migrate # 开发库全量迁移（apps/api/drizzle）
pnpm db:test # 一键验收：起库 + 跑全部测试（测试用临时库，开发库零写入）
日常质量门（等价于 CI）：
pnpm lint && pnpm typecheck && pnpm test
说明：集成测试由 vitest globalSetup 自动创建临时库 sf_test_<ts> 并注入 DATABASE_URL_TEST，结束即 DROP——勿在 .env 手动设置该变量。
目录结构
apps/api/ NestJS standalone 骨架 + Drizzle schema/迁移（21 表，数据库约束即规格）
packages/contracts/ UniversalRow / Route / Render / Theme 跨源契约（冻结，变更须升版）
tests/ 单元 + 集成测试（fixtures：WXR/Sitemap/媒体样例）
infra/ docker-compose：PostgreSQL 16（端口 5434，避开 cms 项目 5433）
scripts/ migrate-test.sh 等运维脚本
docs/ adr/ 决策记录 · evidence/ 基线证据 · superpowers/ 规格与计划
文档导航
- 设计基线（表结构/技术决策/阶段划分）：
docs/superpowers/specs/2026-10-20-siteforge-vertical-slice-design-v2.md - 阶段 0+1 实施计划：
docs/superpowers/plans/2026-10-20-slice-foundation-phase0-1.md - 架构决策记录（ADR-001~015）：
docs/adr/ - 基线证据（环境/真实 WXR）：
docs/evidence/
当前状态
- 阶段 1 已完成：契约冻结、21 表数据模型全量落地（不可变触发器/唯一约束/CHECK 均落数据库并被 75 项测试锁定）、空环境一键启动+迁移验收通过。
- 下一步：阶段 2——WXR 适配器（流式 SAX 解析 → UniversalRow），计划基于阶段 1 经验另立。