carlxu·wiki
输入关键词搜索全部已展示内容
本页目录

wiki-build-workflow-todo

创建于 2026-05-18  ·  wikibuildworkflowtodo

Wiki 构建部署工作流 TODO

核心规则

更新 OS 概念/流程/文章后，push 之前必须先本地运行构建。

原因：Vercel 构建时无 DeepLX 翻译服务，英文内容完全依赖本地构建产生的 wiki-content-en.json + wiki-routes.json（均已 commit 至 git）。不先构建→缓存不更新→Vercel 用 fallback→英文版出现中文或通用占位文字。

标准操作流程

每次修改 wiki: true 的概念/流程/文章后：

``bash

1. 本地构建（需要 DEEPLX_URL 生效，见 .env.local）

npm run build

2. 检查缓存文件有无更新

git diff --stat 99_SYSTEM/scripts/wiki-content-en.json 99_SYSTEM/scripts/wiki-routes.json

3. 连同 vault 变更一起提交

git add 99_SYSTEM/scripts/wiki-content-en.json 99_SYSTEM/scripts/wiki-routes.json git commit -m "build: refresh EN translation cache"

4. push 触发 Vercel 部署

git push `

不需要跑 build 的操作

以下修改不影响英文版缓存，可以不跑 build 直接 push：

  • 修改 wiki: false 或无 wiki 字段的笔记
  • 修改 journals、项目日记、阅读笔记
  • 修改 99_SYSTEM/ 非 scripts 部分

Pending Items

  • [ ] 确认 .env.local 里 DEEPLX_URL 正确配置，保证本地 build 可调用翻译
  • [ ] 为阅读量最高的 20 篇文章添加 title_en frontmatter（临时缓解文章标题翻译依赖）
  • [ ] 考虑 git pre-push hook 调用 wiki-routes-check.js 检测缓存是否过期

已完成

  • [x] 2026-05-18：修复 fallback 文字硬编码问题，中文 basename 文章改用 Article · YYYY-MM-DD 格式（见 wiki-build-fixes-2026-05-18）
  • [x] 2026-05-18：OS 概念/流程 enMeta 中文标签改为静态英文映射
  • [x] 2026-05-18：localize.js 修复重复标题（EN 页 article 首个 h1 与 title 匹配时自动剥离）
  • [x] 2026-05-18：localize.js OS 摘要 fallback 改为优先使用 getPageManifest() 已缓存摘要
  • [x] 2026-05-18：manual-en.js 新增投资判断流程图英文页（含英文 mermaid flowchart）
  • [x] 2026-05-18：双 DeepLX backend failover（BACKENDS 数组 + backendIndex 429 切换）
  • [x] 2026-06-06：llms.txt 构建自动生成（main.js 末尾追加，每次重建自动更新；对应方案 D1）
  • [x] 2026-06-06：loader.js 新增 rmSafe() 跳过无权限文件，本地构建不再因 root-owned 残留文件崩溃
  • [x] 2026-06-06：首页两条破损链接修复：/llms.txt 真实存在；"想抄这套系统" → /about.html`（B3 专页待写后再指回）
  • [x] 2026-06-06：Dashboard Phase 1–2：gen-dashboard.js 扩展（tasks/journal/accent）+ dashboard-page.js 全量重写 + middleware.js 鉴权 + 输出到 public/dashboard/index.html