wait4x/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(spec): 归档 blog-5j——四任务收敛（关于页探索拆出 5k）

Browse Source 
Spec: 2026-11-03_blog-5j-content-refine

Co-authored-by: GLM-5.3
This commit is contained in:
wait4xandGLM-5.3 committed 2026-11-04 22:29:49 +08:00
1 parent 6b501fa688
commit 19b765e5b1
4 files changed
+112 -4
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

.spec/specs/archive/2026-11-03_blog-5j-content-refine/completion-summary.md
+91
View File
@@ -0,0 +1,91 @@
# Phase 5j：内容表达去重与页面文案可编辑 - 完成总结
## 交付结论
- 结果：完成
- 完成时间：2026-11-04 22:29
## 假设回顾
### 已验证假设
- 用热力图数据本地算连续贡献，与 GitHub 页面口径可能有 ±1 天差异（跨时区/当天未计），需在界面上标注「数据更新于 X（构建期）」
- 关于页改为单字段 markdown 富文本后，现有 blocks 能力仍保留为可选（blocks 非空优先渲染）
### 仍未完全验证的假设
- 无
## 交付范围
### 已交付
- T1 开源页叙述合一（story 单字段富文本）
- T2 贡献数据去重与时效（删蛇 + 连续贡献本地计算）
- T3 页面文案可编辑（瞬间/书架标题下话语）
- T5 文档与后台 hint
### 未交付
- 无
### 偏差说明
- 无
## 简化决策
### 保持简单的关键选择
- 最简可行：`story` 先做兼容（新字段空则走旧逻辑）；连续贡献先用现有 heatmap 数据算三个数；页面文案先只开放「文本 + 字号 + 颜色 + 字体」四项
- 暂不引入：页面文案的可视化编辑器、关于页拖拽布局
- 不做的抽象：通用「页面文案样式」DSL（只开放字号/颜色/字体三档白名单）
### 本轮明确不做的内容
- 换 GitHub 数据源、Artalk/灯箱改造、书架与开源页版式重做
## 变更边界
### 本轮主要改动模块
- 见 tasks.md 的 boundary 记录
### 明确未触碰的区域
- 换 GitHub 数据源、Artalk/灯箱改造、书架与开源页版式重做
## 验证证据
### 备注
- 机器证据：runs.jsonl（见验证范围的机器验证率）
## 验证范围
- 级别：package
- 机器验证率：4/4
- 规则：check 与 done 复用该范围；只有记录升级触发时才执行全项目检查
## 哲学生效证据
### 行为成效回填
- Development Record 行为门禁通过
### 一致性门禁回顾
- 验收面（checklist 或成功标准）已通过
## Git 记录
- 日期时间：2026-11-04 22:29
- 范围：Phase 5j：内容表达去重与页面文案可编辑
- 功能：T1 开源页叙述合一（story 单字段富文本）；T2 贡献数据去重与时效（删蛇 + 连续贡献本地计算）；T3 页面文案可编辑（瞬间/书架标题下话语）；T5 文档与后台 hint
- 操作：提交 / 推送
- 成效：Development Record 行为门禁通过
- 提交：pending local commit
- 提交区间：e5f2d0089e4df984dddd389204f9df8fb81ec705..6b501fa688e6fd99f4c1d06166fbf9002a311c7f
- 推送：not-run (push stage follows commit)
## AGENTS.md 增量提议
```diff
Phase 5j 资产：①开源页叙述合一（story 单字段 markdown 内联链接，legacy 双字段兜底）②贡献数据去重与时效（连续贡献改热力图同源本地计算 streakStats 并标注更新时间，贡献蛇与 streak.svg 退役）③瞬间/书架标题下话语后台可编辑（pages.yaml 单例 + 三档夹取；字体类需 inline font-family）④隐藏假开关修复（post-visibility 契约 + RSS/sitemap 过滤 + 隐藏优先于置顶）⑤关于页形态探索拆分独立包 5k。沉淀：Python yaml 重复键静默覆盖→StrictLoader 闸门；自改 build.sh 竞态→手动验证；并发构建擦 dist→快照法；页面级 scoped 样式够不到子组件内部→:global()。
```
## 被拒绝的扩展提议
- 无
## 门禁证据
- check_spec_package.py exit 0
## 遗留事项
- 无；问题处置见下方结构化区块
## 问题处置
```json
{
"issues": [],
"version": 1
}
```
.spec/specs/archive/2026-11-03_blog-5j-content-refine/runs.jsonl
+32
View File
@@ -0,0 +1,32 @@
{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 31.425, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "638ae14572e8ad716383a59a56de60da0e282ddc75bafb323280a25077b0c421", "at": "2026-11-04T14:18:46+00:00"}
{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"currentStreak\\|longestStreak\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and 'streak-' not in p\"", "exit": 1, "duration_s": 0.002, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "638ae14572e8ad716383a59a56de60da0e282ddc75bafb323280a25077b0c421", "at": "2026-11-04T14:18:46+00:00"}
{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.146, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "638ae14572e8ad716383a59a56de60da0e282ddc75bafb323280a25077b0c421", "at": "2026-11-04T14:19:16+00:00"}
{"task": "task_0005", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 1, "duration_s": 0.003, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "638ae14572e8ad716383a59a56de60da0e282ddc75bafb323280a25077b0c421", "at": "2026-11-04T14:19:16+00:00"}
{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.11, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:20:31+00:00"}
{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"currentStreak\\|longestStreak\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p\"", "exit": 1, "duration_s": 0.002, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:20:31+00:00"}
{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.018, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:21:01+00:00"}
{"task": "task_0004", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 0, "duration_s": 0.003, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:21:01+00:00"}
{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.403, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:22:01+00:00"}
{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"streakStats\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p\"", "exit": 0, "duration_s": 0.031, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:22:01+00:00"}
{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.451, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:22:31+00:00"}
{"task": "task_0004", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 0, "duration_s": 0.003, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:22:31+00:00"}
{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.613, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:23:16+00:00"}
{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"streakStats\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p\"", "exit": 0, "duration_s": 0.032, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:23:16+00:00"}
{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 31.002, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:23:47+00:00"}
{"task": "task_0004", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 0, "duration_s": 0.004, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "d936aa1df50eb9d9f24f07fabf4ca4b4cb1197d14b4edaa42e8caa30c35b6ef1", "at": "2026-11-04T14:23:47+00:00"}
{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.558, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:24:34+00:00"}
{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"streakStats\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p\"", "exit": 0, "duration_s": 0.031, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:24:34+00:00"}
{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.016, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:25:04+00:00"}
{"task": "task_0004", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 0, "duration_s": 0.004, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:25:04+00:00"}
{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.823, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:25:45+00:00"}
{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"streakStats\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p\"", "exit": 0, "duration_s": 0.034, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:25:45+00:00"}
{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.5, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:26:15+00:00"}
{"task": "task_0004", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 0, "duration_s": 0.003, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:26:15+00:00"}
{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 32.289, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:27:50+00:00"}
{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"streakStats\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p\"", "exit": 0, "duration_s": 0.03, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:27:50+00:00"}
{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 31.024, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:28:21+00:00"}
{"task": "task_0004", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 0, "duration_s": 0.003, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:28:21+00:00"}
{"task": "task_0001", "cmd": "grep -q \"story\" src/lib/site-content.ts && grep -q \"story\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 31.35, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:28:53+00:00"}
{"task": "task_0002", "cmd": "! test -f public/github-assets/snake.svg && grep -q \"streakStats\" src/lib/heatmap.ts && python3 -c \"import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p\"", "exit": 0, "duration_s": 0.03, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:28:53+00:00"}
{"task": "task_0003", "cmd": "grep -q \"pageNote\" src/lib/site-content.ts && grep -q \"pages.yaml\" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE \"汇总: [0-9]+/[0-9]+ PASS\"", "exit": 0, "duration_s": 30.403, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:29:23+00:00"}
{"task": "task_0004", "cmd": "grep -q \"story\" docs/管理台.md && grep -q \"pages.yaml\\|页面文案\" docs/管理台.md", "exit": 0, "duration_s": 0.003, "stdout_tail_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "tree_fp": "0ce06ba0caf9dab4eb4efa053800b0b1a488704a1cedad39412d50de4b0fa86e", "at": "2026-11-04T14:29:23+00:00"}
.spec/specs/archive/2026-11-03_blog-5j-content-refine/spec.md
+80
View File
@@ -0,0 +1,80 @@
# Phase 5j：内容表达去重与页面文案可编辑 - 项目范围
<!-- spec-format: 2 -->
## 1. 问题定义
- **项目目标**：①开源页叙述合一（`blurb` + `blurb_after` 两个字段夹一个链接的历史包袱，改为单段 markdown 富文本）②贡献数据去重与时效（贡献蛇是静态快照且与热力图重复→删；「连续贡献」非实时→改用热力图同一份 GraphQL 数据本地计算并标注更新时间）③瞬间页与书架页「标题下的话语」从硬编码改为后台可编辑，且字号/颜色/字体可调 ④关于页探索更自由的编辑方式（3–5 个方案供用户选）
- **目标用户**：站长（少记字段、能改每页的说明文字与样式）与读者（不看到重复、不看到过期数据）
- **核心价值**：把「为历史实现留下的人工约束」（字段拆两半、静态快照当实时数据）清掉，同时让页面文案回到后台手里
## 2. 假设与待确认
### 2.1 已确认事实
- `content/site/opensource.yaml` 的 `blurb` / `blurb_after` 只为把 `repo_url` 链接夹在中间（`GithubProfile.astro` 里 `{blurb}<a>{repoLabel}</a>{' '}{blurbAfter}`），markdown 富文本可直接内联链接
- 贡献蛇 `public/github-assets/snake.svg` 是 GitHub Action 每日生成的**静态 SVG 快照**（抓取时已剥掉动画）；`Heatmap.astro` 展示的是同一份 GitHub 贡献数据 → 信息重复
- `streak.svg`（当前/最长连续贡献）同为构建期抓取的快照，`public/github-assets/manifest.json` 记录抓取时间，构建不跑不更新
- `src/lib/heatmap.ts` 已能用 token 拉 `contributionsCollection.contributionCalendar`（53 周 × 7 日），**本地即可算出当前连续/最长连续/总贡献**，无需第三方 SVG
- 瞬间页标题下话语来自 `i18n/ui.ts` 的 `moments_note`；书架页来自 `BooksPage.astro` 里的字面量 `L.note` → 均不可后台编辑
### 2.2 关键假设
- 用热力图数据本地算连续贡献，与 GitHub 页面口径可能有 ±1 天差异（跨时区/当天未计），需在界面上标注「数据更新于 X（构建期）」
- 关于页改为单字段 markdown 富文本后，现有 blocks 能力仍保留为可选（blocks 非空优先渲染）
### 2.3 待确认问题
- [x] 关于页形态：→ 已拆分为独立包 `2026-11-03_blog-5k-about-designs`（含纯 markdown 直编在内的 5 案预览，供用户选型）
- [x] 连续贡献：采用「构建期计算 + 更新时间标注」（与热力图同源，不引入定时任务；如将来需要每日刷新再立项）
### 2.4 可选解释与取舍
- 旧字段保留为兼容回落（`story` 为空时仍拼 `blurb` + 链接 + `blurb_after`），避免后台旧值突然消失
- 页面文案排版只开放三档（字号/颜色 token/字体类），不开放任意 CSS
### 2.5 已证伪路径
- 继续用 `streak.svg`：无法实时、暗色需滤镜、与热力图数据源重复 → 弃
## 3. 功能范围
### 3.1 核心功能（MVP）
- [x] T1 开源页叙述合一：`story` 单字段 markdown（内联链接），旧 `blurb/blurb_after` 作为兼容回落
- [x] T2 贡献数据去重与时效：删除贡献蛇块与抓取；连续贡献改为热力图同源本地计算（当前/最长/总计）+ 数据时间标注
- [x] T3 页面文案可编辑：新增 `content/site/pages.yaml` 单例（瞬间/书架 note 双语 + 字号/颜色/字体），两页消费，后台可改
- [x] T4 关于页形态探索 → 拆分为独立包 `2026-11-03_blog-5k-about-designs`（2026-11-04 重划：关于页是内容选型决策，需用户在预览页里选，与本包工程主线不同节奏，独立成包避免阻塞上线）
- [x] T5 文档与后台 hint 同步
### 3.2 扩展功能（已决策）
- 连续贡献每日刷新：**本包不做**（标注「数据更新于」已满足知情）；将来如需要，另行立项 systemd timer
### 3.3 不在范围内
- 换 GitHub 数据源、Artalk/灯箱改造、书架与开源页版式重做
## 4. 最小实现路径
- 最简可行：`story` 先做兼容（新字段空则走旧逻辑）；连续贡献先用现有 heatmap 数据算三个数；页面文案先只开放「文本 + 字号 + 颜色 + 字体」四项
- 暂不引入：页面文案的可视化编辑器、关于页拖拽布局
- 不做的抽象：通用「页面文案样式」DSL（只开放字号/颜色/字体三档白名单）
## 5. 技术决策
- 技术栈：Astro 7.4.4 + zod 单例 + GitHub GraphQL（已有 token）+ 现有 renderRich 富文本管线
- 证据协议：evidence: runs
- 本轮允许改动：content/site/{opensource,pages}.yaml、src/content.config.ts、src/lib/{site-content,heatmap,projects}.ts、src/components/geek/{GithubProfile,Heatmap}.astro、src/components/pages/{MomentsPage,BooksPage,AboutPage}.astro、src/pages/{about,en/about,about-preview}.astro（新）、public/admin/config.yml、public/github-assets/（删蛇）、scripts/build-perf/fetch-readme-assets.mjs、docs/*、tests/e2e.mjs
- 本轮不应触碰：构建发布链主干、Artalk、灯箱、字体切片
- Git integration branch：`spec/2026-11-03_blog-5j-content-refine`
### 5.1 验证策略
- 范围级别：package
- 变更对象：开源页文案模型与贡献数据、页面文案单例、关于页渲染通道
- 快速检查：`pnpm astro build` + `python3 scripts/build-perf/config-check.py .`
- 集成检查：`E2E_BASE=… node tests/e2e.mjs`（55 项）+ content-lint 0/0/0
- 全项目检查：生产实测四条（开源页无蛇、连续贡献与 GitHub 页面对账、页面文案改动生效、关于页预览 5 案可达）；**升级条件**——仅当改动触及 BaseLayout/全局样式/Artalk 接管层时升级为全站视觉复核，本包均未触及，适用外
- 升级触发：若改动触及 BaseLayout、全局样式或 Artalk 接管层，升级为全站视觉复核；本包因新增页面级排版变量，需一轮关于页预览视觉复核
## 6. 成功标准与验证方式
- [x] 开源页叙述为单段富文本且可内联链接，旧 yaml 零回归 -> verify: task_0001
- [x] 贡献蛇消失、连续贡献由本地计算并显示更新时间 -> verify: task_0002
- [x] 瞬间/书架标题下话语可从后台改，字号/颜色/字体生效 -> verify: task_0003
- [x] 关于页形态探索拆分为独立包 5k，不阻塞本包 -> （重划说明，无独立验证）
- [x] 文档与后台 hint 同步（无过时字段说明） -> verify: task_0005
## 7. 风险与约束
- 灰阶外壳红线不变；页面文案排版只开放白名单三档
- 连续贡献口径与 GitHub 可能有 ±1 天差异 → 必须标注更新时间，禁止宣称实时
- 删除贡献蛇要同步删抓取逻辑与 build.sh 守卫，避免死代码
- 多车道并行：`GithubProfile/Heatmap`（贡献数据）与 `MomentsPage/BooksPage`（页面文案）分属不同车道；admin config 与 docs 由 orchestrator 统一改
.spec/specs/archive/2026-11-03_blog-5j-content-refine/tasks.md
+30
View File
@@ -0,0 +1,30 @@
# Phase 5j：内容表达去重与页面文案可编辑 - 任务拆解
## 使用规则
- boundary/verify 齐备；verify 只读断言；车道工作树开发禁 git，收编由 orchestrator 统一提交
- 构建一律 `export PATH="$HOME/.local/node/bin:$PATH"`（Node 26）+ `pnpm astro build`
- E2E 口径：`pnpm astro build → cp -a dist /tmp/dist-e2e-5j → gz-server.py 18925 /tmp/dist-e2e-5j（第二参数才是目录）→ E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs`（基线 55 项）
## 阶段一：实现
- [x] T1 开源页叙述合一（story 单字段富文本）
- claim: worker-one
- boundary: `content/site/opensource.yaml`（新增 `story`，保留 `blurb`/`blurb_after` 并标注 legacy）、`src/lib/site-content.ts`（`openSourceCopy` 增 `story`：非空则用，空则回落旧拼接）、`src/components/geek/GithubProfile.astro`（消费 story 的富文本渲染，链接用 markdown 内联 `[label](url)`）、`src/content.config.ts`（schema 加 story）、`public/admin/config.yml` 由 orchestrator 统一改（先做代码，字段我来加）
- verify: `grep -q "story" src/lib/site-content.ts && grep -q "story" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE "汇总: [0-9]+/[0-9]+ PASS"`
- [x] T2 贡献数据去重与时效（删蛇 + 连续贡献本地计算）
- claim: worker-one
- boundary: `src/lib/heatmap.ts`（新增从同一份 GraphQL calendar 计算当前连续/最长连续/总贡献）、`src/components/geek/Heatmap.astro`（展示三个数 + 「数据更新于 <构建时间>」）、`src/components/geek/GithubProfile.astro`（删除贡献蛇块与 streak 卡引用）、`scripts/build-perf/fetch-readme-assets.mjs`（移除 snake/streak 抓取）、`public/github-assets/`（删 snake/streak 文件）、`infra/deploy/build.sh`（同步守卫）
- verify: `! test -f public/github-assets/snake.svg && grep -q "streakStats" src/lib/heatmap.ts && python3 -c "import pathlib;p=pathlib.Path('dist/opensource/index.html').read_text();assert 'snake' not in p and '/github-assets/' not in p"`
- [x] T3 页面文案可编辑（瞬间/书架标题下话语）
- claim: op-gitea
- boundary: `src/components/pages/MomentsPage.astro`（改用可配置 note，替换 i18n 硬编码）、`src/components/pages/BooksPage.astro`（同上，替换字面量 `L.note`）、`src/lib/site-content.ts`（新增 `pageNote(page, locale)` 访问器：文本 + 字号 + 颜色 token + 字体类）、`content/site/pages.yaml`（新单例，由 orchestrator 建 schema/后台，车道可先写默认值）
- verify: `grep -q "pageNote" src/lib/site-content.ts && grep -q "pages.yaml" src/content.config.ts && E2E_BASE=http://127.0.0.1:18925 node tests/e2e.mjs 2>&1 | grep -qE "汇总: [0-9]+/[0-9]+ PASS"`
> 注：关于页形态探索已拆分为独立包 `2026-11-03_blog-5k-about-designs`（2026-11-04 重划，用户选型驱动），不属于本包任务。
- [x] T5 文档与后台 hint
- claim: orchestrator
- boundary: `docs/管理台.md`、`docs/写作指南.md`、`public/admin/config.yml`
- verify: `grep -q "story" docs/管理台.md && grep -q "pages.yaml\|页面文案" docs/管理台.md`