Merge pull request #12 from nightt5879/codex/1.1.0-seo-i18n

feat: implement 1.1.0 SEO and locale hardening

Author: nightt5879

.agent/PLAN.md

@@ -15,4 +15,7 @@
 - [x] T-0010：最小内容运营流程（0代码可执行）
 - [x] T-0011：基础收官验收包（交付与交接）
 
+## M4 线上可索引与双语体验
+- [ ] T-0012：SEO 与 i18n 基础加固
+
 参考：`docs/roadmap.md`

.agent/RUNS/2026-03-26_t0012-seo-i18n/00-intent.md

@@ -0,0 +1,12 @@
+# Intent
+
+- Task: `T-0012`
+- Branch: `codex/1.1.0-seo-i18n`
+- Goal: 完成 1.1.0 的 SEO / i18n 基础加固，并保留可审计的自验证证据。
+
+## Planned Scope
+- 生产站点 URL 配置
+- canonical / Open Graph / hreflang / robots
+- 当前页语言切换
+- 构建后 SEO / i18n 校验
+- 文档与变更记录同步

.agent/RUNS/2026-03-26_t0012-seo-i18n/01-actions.md

@@ -0,0 +1,9 @@
+# Actions
+
+- 2026-03-26: 创建 `T-0012` 任务与本次 RUN 骨架。
+- 2026-03-26: 读取现有路由、布局、CI 与 agent workflow 配置，确认 1.1.0 的实现边界。
+- 2026-03-26: 新增 `src/utils/seo.ts`，统一站点 URL、canonical、hreflang 与摘要逻辑。
+- 2026-03-26: 更新 `astro.config.mjs`、`BaseLayout.astro` 与页面描述，补齐 canonical / OG / robots / 当前页语言互跳。
+- 2026-03-26: 新增 `scripts/verify-seo-i18n.mjs`，并串到 `package.json`、CI 与 `verify.bat`。
+- 2026-03-26: 更新 README、release checklist、roadmap、changelog 与 `.env.example`。
+- 2026-03-26: 完成本地自验证：`verify.bat --no-pause` 通过。

.agent/RUNS/2026-03-26_t0012-seo-i18n/02-evidence/self-check.md

@@ -0,0 +1,20 @@
+# Self Check
+
+## Commands
+
+```bash
+npm run validate:content
+cmd /c verify.bat --no-pause
+```
+
+## Result
+
+- `validate:content`：通过
+- `build`：通过
+- `test:smoke`：通过
+- `test:seo`：通过
+
+## Notes
+
+- `verify.bat` 会自动设置 `ASTRO_TELEMETRY_DISABLED=1`
+- 本次 SEO / i18n 校验覆盖 canonical、Open Graph、hreflang、404 noindex 与当前页语言互跳

.agent/RUNS/2026-03-26_t0012-seo-i18n/04-summary.md

@@ -0,0 +1,30 @@
+# Summary
+
+## Done
+
+- 为站点增加环境变量优先的生产 URL 配置
+- 在共享布局层补齐 canonical、Open Graph、Twitter card、hreflang 与 robots
+- 把页脚语言切换改成当前页面中英互跳
+- 增加构建后的 SEO / i18n 校验，并串入 `verify.bat` 与 CI
+- 更新 1.1.0 文档与版本记录
+
+## Evidence
+
+- `.agent/RUNS/2026-03-26_t0012-seo-i18n/02-evidence/self-check.md`
+- `verify.bat --no-pause`
+
+## Diff
+
+- 新增：`src/utils/seo.ts`、`scripts/verify-seo-i18n.mjs`、`.env.example`
+- 更新：`astro.config.mjs`、`src/layouts/BaseLayout.astro`、各中英文页面、`verify.bat`、CI、README、roadmap、changelog
+
+## Next
+
+- 提交分支 commit
+- 准备 PR 描述与自验证结果
+- 交由云端 Codex 做第二层 review
+
+## Risk
+
+- 若生产域名后续变更但未同步 `PUBLIC_SITE_URL`，canonical / hreflang 会指向旧域名
+- 当前页语言互跳基于中英文路径镜像关系；若未来新增非对称路由，需要补专用映射

.agent/STATUS.json

@@ -1,14 +1,14 @@
 {
-  "current_task": "process-audit",
-  "phase": "closure",
-  "progress": 1.0,
-  "last_update": "2026-03-04T14:58:00+08:00",
+  "current_task": "T-0012-seo-i18n-hardening",
+  "phase": "review",
+  "progress": 0.95,
+  "last_update": "2026-03-26T15:58:00+08:00",
   "next_steps": [
-    "Create a new task ID for the next UI iteration before coding",
-    "Keep RUN evidence updated for each future request"
+    "Review staged diff and create a clear commit for the 1.1.0 branch",
+    "Open a PR and hand the branch to cloud Codex for a second review pass"
   ],
   "blockers": [],
   "evidence": [
-    ".agent/RUNS/2026-03-04_process-audit/02-evidence/terminal.log"
+    ".agent/RUNS/2026-03-26_t0012-seo-i18n/02-evidence/self-check.md"
   ]
 }

.agent/TASKS/T-0012-seo-i18n-hardening.md

@@ -0,0 +1,35 @@
+# T-0012: SEO 与 i18n 基础加固
+
+## Goal
+让站点具备稳定的生产 SEO 基础能力，并让中英文页面支持“当前页互跳”。
+
+## Scope
+- In-scope:
+  - 生产域名改为环境变量优先、正式域名兜底
+  - 在布局层补 canonical、Open Graph、hreflang、robots 基础 meta
+  - 实现当前页面的中英互跳
+  - 增加 SEO / i18n 的构建后校验脚本
+  - 更新 README、roadmap、changelog 与 agent 留痕
+- Out-of-scope:
+  - CMS 接入
+  - 结构化数据、自动 OG 图片生成
+  - 新内容类型或新页面功能
+
+## Acceptance Criteria
+- [x] `astro.config.mjs` 支持环境变量站点地址，并且构建结果不再写死 localhost
+- [x] 首页、列表页、详情页产出 canonical / OG / hreflang
+- [x] 语言切换可在当前页面对应的中英文地址之间跳转
+- [x] 验证通过：`verify.bat --no-pause`
+- [x] 文档已更新：`README.md`、`README_EN.md`、`docs/roadmap.md`、`CHANGELOG.md`
+
+## Constraints
+- 不允许破坏性改动（除非批准）
+- 依赖策略：默认不新增依赖
+
+## Risks
+- SEO 标签集中到布局层后，若路径归一化有误，可能导致 canonical / hreflang 指向错误页面
+- 通过构建后脚本检查首页、列表页、详情页来降低回归风险
+
+## Progress Log
+- 2026-03-26: 创建任务，准备对齐站点地址、布局 SEO 标签与双语当前页互跳。
+- 2026-03-26: 完成环境变量站点地址、布局 SEO 标签、当前页语言互跳与构建后 SEO / i18n 校验。

.agent/WORKLOG.md

@@ -17,3 +17,10 @@
 - 按要求执行流程限制学习：已阅读 `.agent/CONTRACT.md`、`STATUS.json`、`WORKLOG.md`、`PLAN.md`、`TASKS/*` 与最新 `RUNS` 样例。
 - 新增开发留痕：`.agent/RUNS/2026-03-04_process-audit/`（intent/actions/evidence/summary）。
 - 明确后续执行规范：每次开发继续维护 `STATUS.json`、`WORKLOG.md` 与 `RUNS/*`。
+
+## 2026-03-26
+- 新增 T-0012：1.1.0 的 SEO / i18n 基础加固。
+- 创建 RUN 留痕：`.agent/RUNS/2026-03-26_t0012-seo-i18n/`。
+- 开始梳理站点 URL、布局 SEO 标签、当前页语言互跳与自验证链路。
+- 完成环境变量站点地址、canonical / OG / hreflang / robots、当前页语言互跳与构建后 `test:seo`。
+- 本地自验证通过：`verify.bat --no-pause`。

.env.example

@@ -0,0 +1 @@
+PUBLIC_SITE_URL=https://doubleducklab.com

.github/workflows/ci.yml

@@ -32,3 +32,6 @@ jobs:
 
       - name: Smoke test built routes
         run: npm run test:smoke
+
+      - name: Verify SEO and locale alternates
+        run: npm run test:seo