Skip to content

docs+ci: 收尾记录(下一步接续点 + shell 坑)+ 修掉 CI 的管道吞错 - #12

Merged
heweidong-ecco merged 2 commits into
mainfrom
docs/handoff-20260921
Sep 21, 2026
Merged

heweidong-ecco merged 2 commits into
mainfrom
docs/handoff-20260921

Conversation

@heweidong-ecco

Copy link
Copy Markdown
Owner

收尾核查(全部通过)

项 结果
未提交 0
stash 0
未推送 0
落后远端 0
本地 / 远端 main 都是 8064c42 ✅
分支 本地与远端都只有 main(顺手 prune 掉 4 个过期的远端跟踪引用)

记录了什么

CLAUDE.md §6 加「⏭️ 下一步(2026-09-22 从这里开始)」

  • audit 清单已全部清零、无半成品;下一步头号事项:升级 3 个 action 主版本(消除 Node 20 告警)
  • 依据已核实(实测三个 action 的 action.yml):我们用的主版本声明 node20,最新主版本声明 node24
    ⇒ 下次别再重查;跨多个主版本 ⇒ 按纪律先落 DEC,验收判据=CI 绿 且 告警消失

CLAUDE.md §8 加「本机 shell 的两个坑」(本次各踩一次,且都不报错、只安静给错结果):

  • zsh 不对未加引号的变量分词 —— set -- $x 后 $1 拿到整串、$2 为空 ⇒ 命令静默查错东西
  • macOS 的 base64 解码是 -D 不是 -d —— 用 -d 会解码失败但不报错,得到空串

与「别信 Already up to date」「别让管道替你判成败」同族:它们都不报错。

提交前两问

① 无新增决策事项(只有接续记录 + shell 提示;头号事项已标明"需先落 DEC")
② CHANGELOG 已写(第 3 轮补「收尾状态」并指向接续点)

收尾核查(全部通过):
  未提交 0 · stash 0 · 未推送 0 · 落后 0 · 本地=远端=8064c42
  本地/远端分支都只有 main(顺手 prune 掉 4 个过期的远端跟踪引用)

CLAUDE.md:
  · §6 加「⏭️ 下一步(2026-09-22 从这里开始)」——
    头号事项:升级 checkout@v4→v7 / setup-python@v5→v7 / cache@v4→v6 消除 Node 20 告警。
    依据已核实(实测三个 action 的 action.yml:我们用的主版本声明 node20,最新主版本声明 node24),
    下次别再重查;跨多个主版本 ⇒ 按纪律先落 DEC。
  · §8 加「本机 shell 的两个坑」(本次各踩一次,且都不报错、只安静给错结果):
    zsh 不对未加引号的变量分词(set -- $x 后 $1 拿到整串)·
    macOS 的 base64 解码是 -D 不是 -d

CHANGELOG:第 3 轮补「收尾状态」,并指向接续点

提交前两问
① 本次无新增决策事项(只有接续记录与 shell 提示;头号事项已标明"需先落 DEC")
② CHANGELOG 已写

测试:61 passed
一个**只改文档**的 PR 让 test-embedding 红了,失败在「装并启动 Ollama」:
  curl: (22) The requested URL returned error: 504     ← ollama.com 瞬时 504
  … line 26: ollama: command not found                  ← 60 秒后才报错,看不出真因

两层原因:
1) 外部抖动:ollama.com 瞬时 504(同一次 test job 是绿的 ⇒ 不是逻辑错)
2) **自身缺陷(更值得记)**:`curl … | sh` 的**管道把 curl 的失败吞了** ——
   curl 失败时 sh 读到空内容、**退出码仍为 0**,脚本继续跑,直到 60 秒后报
   `command not found`。**报出来的错与真实原因毫无关系。**

⛔ 这违反了同一天刚写进 CLAUDE.md §8 的判据("判断命令成败,别经过管道")——
   判据写对了,然后在自己的 workflow 里违反了它。

处置:
  · 改成「先下载到文件 → 再执行」:下载失败**当场**报错,不伪装成别的步骤的怪错误
  · 下载加 --retry 3 --retry-delay 5(吃掉瞬时 504)
  · ollama pull 加 3 次重试;**三次都失败则 exit 1**
    —— 不许让"模型没拉到"退化成后面某个看不懂的测试失败

核实:YAML 可解析 · 8 项关键点逐条检查 · **把 run 块拉出来过 `bash -n`** ✅

提交前两问
① 本次无新增决策事项 ⇒ 沿用 DEC-002,并在其 §九 记录"第一次真实 flaky 与处置"
   (§七 当初就写了"若真的 flaky 先分辨环境抖动还是真 flaky",本次照此办理)
② CHANGELOG 已写
@heweidong-ecco heweidong-ecco changed the title docs: 收尾记录 —— 下一步接续点 + 本机 shell 两个坑(含 Node 20 告警的实测依据) docs+ci: 收尾记录(下一步接续点 + shell 坑)+ 修掉 CI 的管道吞错 Sep 21, 2026
@heweidong-ecco
heweidong-ecco merged commit 46b96f7 into main Sep 21, 2026
2 checks passed
@heweidong-ecco
heweidong-ecco deleted the docs/handoff-20260921 branch September 21, 2026 15:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant