 浅念
|
e6c8cb9ce6
|
chore(theme): astro 锁定 ~5.18.0（终审 Minor）+ docs: Plan 4 收官
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-22 16:16:03 +08:00 |
|
|
浅念
|
1ed3ac062a
|
feat(build): astro 构建管线与媒体落盘
Plan 4 Task 5：build.service snapshotting 后接真实构建——building 态进
pipeline.ts（spawn `pnpm --filter @sf/theme-pilot-minimal exec astro build`
（SF_BUILD_INPUT env；非零退出+stderr 标记判据）→ dist 定位与 target_file
完整性 → 媒体 copyPath→dist/public_path（sha256 全量校验）→ sitemap.xml/
robots.txt（编码 URL 原样）→ route-manifest.json（§12.1 字段面、哈希链复用）
→ build_artifacts dist/manifest 登记）→ validating(空,Task 6) → 报告+report
行 → succeeded；失败任何一步 failed+error_code/error_summary（stderr 摘要）
+input/dist 清残。
dist 双位置纪律：主题包 dist 是暂存，产物汇齐后拷出 <artifactsRoot>/jobs/
<jobId>/dist（job 级权威），暂存随即清空。无网证明：ASTRO_TELEMETRY_DISABLED=1
（实测 @astrojs/telemetry 构建期真调 fetch）+ NODE_OPTIONS 透传（测试注入
fetch/net stub 构建仍成功）。主题集成补面：ProductList 模板 + /products/
主列表分派特判（DB 物化形状 targetContentId=null，Task 4 夹具曾被占位绕过）。
测试：tests/integration/build-pipeline.test.ts 五用例（全链/夹具直跑/五禁
断言/失败路径）；build-snapshot 状态机补 building + 清场补 build_artifacts。
root 359 + theme 26 全绿。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-22 10:52:13 +08:00 |
|
|
浅念
|
0a7578b5eb
|
chore(theme): dist 根 stub 清理归属钩子；build.format 显式契约
sf-literal-html-paths 钩子收尾清理 astro 5.18.2 内容层无条件发射的
content-assets.mjs/content-modules.mjs（content/consts.js
ASSET_IMPORTS_FILE——本主题零内容集合，dist 树=target_file 面）；
build.format:'directory' 由缺省依赖升为显式契约，*.html.html 残留
自检守护折平前提（偏离即构建明错）。render-cases 钉死 dist 根无 stub。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-22 10:05:57 +08:00 |
|
|
浅念
|
f916f723ab
|
feat(theme): 六类页面渲染与路由分派
单一动态路由 [...slug].astro 读 routes.json html 纯路径行分派六模板
（home/typeKey 详情/分类前缀列表/news 主列表），无法分派即构建明错；
404 独立静态页。夹具扩展为六页集（真实 hesupipe 抽样形状脱敏化：
knownFields.postDate/title、media 块 attachmentRefs.* fieldPath、
/products/ 内容页占据、编码路径 + .html 字面路径防御）。
字面 .html 路径对齐钩子（astro.config 内联 integration）：Astro 页面
产物在 directory/file/preserve 三态均产不出 dist/news/x.html 字面文件，
构建收尾把包装目录折平为字面文件——target_file 契约对齐。
构建级测试 8 例（render-cases）：全量映射/编码字节原样/首页截断/
产品参数相册/新闻字面 .html/列表两类/SEO 基线。372 → 380。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-22 09:34:58 +08:00 |
|
|
浅念
|
eb81a57ebc
|
fix(theme): payload 契约上提 contracts；空路由明错；ui.routeHrefFor；eslint astro ignore
审查修复（Plan 4 Task 3 review）：
- 载荷类型单一事实来源：ContentEntry/TaxonomyEntry/TaxonomyTerm/RouteEntry/
AssetEntry/RenderManifestMeta/SiteConfigPayload/BrandConfigPayload 上提
@sf/contracts/render-snapshot（纯新增、不动既有导出——冻结面加法无需升版）；
物化端（apps/api build/render-snapshot.ts）与主题 load-render-data 同源引用，
双份手写镜像漂移即编译期破裂；主题侧 re-export 保持既有 import 面
- loader 空路由表前置明错（正常发布站点至少含首页路由——静默渲染会产零页站点）
- ui.routeHrefFor：targetContentId → 纯路径 html 落点（redirect/查询行不参与，
无落点 undefined 不虚构——Task 4 分派器入口）+ 测试
- 具夹 assets.json copyPath 去机器相关绝对路径（改仓库相对）
- eslint ignores 增 **/.astro/**（astro build 再生目录）
354 根测试 + 18 主题测试全绿；五段 typecheck；lint（.astro 存在态验证后清理）。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-22 08:58:33 +08:00 |
|
|
浅念
|
1cd309d56d
|
feat(theme): pilot-minimal 骨架与布局组件
Plan 4 Task 3：
- themes/pilot-minimal 入 workspace（astro ^5.18 纯静态；依赖仅 astro）
- theme.manifest：contracts isThemeManifest 守卫通过——key=pilot-minimal/
七模板条目（home/page/product-list/product-detail/news-list/news-detail/
not-found）；brand 刻意不入 requiredSiteConfig（恒可能 {}，Task 1 移交契约）
- load-render-data：全主题唯一取数入口（五禁纪律结构保证，JSDoc 钉死）——
SF_BUILD_INPUT 六文件、缺文件/形状破裂明确错误不静默空、同目录缓存单例、
name 空→'Untitled Site'/brand 缺席→{}、编码 slug 原样贯穿（源码令牌扫描
禁 percent-decode）
- 布局/组件：BaseLayout/SeoHead（title/desc/canonical/og）/SiteHeader（导航
路由缺席容忍隐藏）/SiteFooter/RichText（信任链：清洗+重写后直出）/
ResponsiveMedia/Breadcrumbs/ProductCard/NewsCard/Pagination（V1 禁用态）/
NotFound + tokens.css（75rem/系统字体/4-8-16-24-48/中性色+单 accent）
- 根 test 链并入主题（vitest 3 + astro getViteConfig，Container API 组件
渲染测试）；typecheck 四段变五段；.astro/ 入 gitignore
354 根测试 + 16 主题测试全绿。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-22 08:38:00 +08:00 |
|