Skip to content

docs: origin 改走 SSH-over-443 + 两条操作判据(CLAUDE.md §8) - #8

Merged
heweidong-ecco merged 1 commit into
mainfrom
docs/ops-ssh-and-pipe-lessons
Sep 21, 2026
Merged

heweidong-ecco merged 1 commit into
mainfrom
docs/ops-ssh-and-pipe-lessons

Conversation

@heweidong-ecco

Copy link
Copy Markdown
Owner

诊断到层:不是 GitHub 挂了,是 github.com 的 HTTPS 被掐

检查 结果
DNS dig github.com ✅ 20.205.243.166
TCP nc github.com 443 ✅ 通
HTTPS curl https://github.com ❌ 12s 超时(HTTP 000)
git 报错 ❌ Failure when receiving data from the peer / expected flush after ref listing
curl https://api.github.com ✅ HTTP 200 / 0.11s
ssh -T -p 443 git@ssh.github.com ✅ Hi heweidong-ecco!

⇒ TCP 通 + HTTPS 不通 = 应用层被干扰,不在网络可达性 ⇒ 换通道即可绕过。

决定(DEC-008):换通道,而不是降标准

方案 处置
继续重试 https 成功率低(实测要 1–8 次才中,每次失败等 15–75s)
改走 ssh://git@ssh.github.com:443/... ✅ 选定 —— 实测 git fetch / git push 各一次即通
用 gh API 造提交 会造出同内容不同 SHA的提交 ⇒ 本地与服务端分叉
关 TLS 校验 / 改 CA ⛔ 禁止 —— 拿安全换连通

⛔ git remote -v 看到这个 SSH URL 是正常的,别改回 https。

CLAUDE.md §8 补两节

  1. 本仓 origin 走 SSH-over-443 + 判据表(含「gh 通 ≠ git 通」:两者走不同主机)
  2. 判断命令成败别经过管道 —— git fetch … | tail -1 的退出码是 tail 的、恒为 0。
    本次真实踩到两次:打出假 ✅("fetch 成功"而 origin/main 根本没动),差点据此以为已同步。

与「别信 Already up to date」同族:别让工具的输出格式替你做判断。

顺带清掉两处遗留(你要的「核查」结果)

  • 6 个过期的本地远端分支引用 ⇒ git remote prune origin
  • 1 个远端孤儿分支 ci/blocking-embedding-job(PR ci: 两个 job 都改成阻断(推翻 DEC-002 原裁决) #4 已合并,但远端分支没被删)⇒ 已删
    • ⚠️ 删前核对方法:squash 会造新 SHA ⇒ merge-base --is-ancestor 必为假,
      判据要用 git diff --stat <旧分支> <squash 提交> 是否为空(本次为空 ⇒ 内容一致 ⇒ 删除无损)

核查结论:无未提交、无未推送;远端现只剩 main。

提交前两问

① 有决策事项 ⇒ DEC-008-推送走哪条通道-20260921.md(四选一 + 反悔成本)
② CHANGELOG 已写(第 3 轮 Ops 小节)

测试

61 passed

诊断到层:github.com:443 的 **HTTPS 被掐** —— DNS 正常、TCP 能连(nc 通),
但 curl 12s 超时、git 报 "Failure when receiving data from the peer" /
"expected flush after ref listing";同一时刻 api.github.com 是 HTTP 200(0.11s)。

- origin 改走 ssh://git@ssh.github.com:443/heweidong-ecco/memory-system.git
  (只改本地 remote,不动仓库设置;实测 git fetch 一次成功)
  ⛔ 不要改回 https。选"换通道"而不是"降标准"(关 TLS 校验明确禁止)
- CLAUDE.md §8 补两节:
  ① 本仓 origin 走 SSH-over-443 + 判据表(含"gh 通 ≠ git 通"、SSH 认证被拒怎么办)
  ② 判断命令成败别经过管道 —— `git fetch … | tail -1` 的退出码是 tail 的、恒为 0,
     本次真实踩到两次:打出假 ✅("fetch 成功"而 origin/main 根本没动),差点据此以为已同步
- 顺带清掉两处遗留:6 个过期本地远端引用(remote prune)·
  1 个远端孤儿分支 ci/blocking-embedding-job(PR #4 已合并但分支没删)
  ⚠️ 删前核对方法:squash 造新 SHA ⇒ merge-base --is-ancestor 必为假,
     要用 git diff --stat <旧分支> <squash 提交> 是否为空来判断(本次为空 ⇒ 删除无损)

提交前两问
① 本次有决策事项 ⇒ 新建 DEC-008-推送走哪条通道-20260921.md
   (四选一:继续重试 https / 改走 SSH-over-443 / 用 gh API 造提交 / 关 TLS 校验
     → 选定第二种,理由"换通道而不是降标准";含反悔成本)
② CHANGELOG 已写(第 3 轮 Ops 小节)

测试:61 passed
@heweidong-ecco
heweidong-ecco merged commit 784da4d into main Sep 21, 2026
2 checks passed
@heweidong-ecco
heweidong-ecco deleted the docs/ops-ssh-and-pipe-lessons branch September 21, 2026 13:58
heweidong-ecco added a commit that referenced this pull request Sep 21, 2026
加完缓存的第一次运行就暴露了问题:PR 那次存下了(998 MB),合并后主干那次
报 "Path Validation Error: Path(s) ... do(es) not exist, hence no cache is being saved"
—— $HOME/.ollama/models 不存在,而同一 job 的测试是过的(模型与服务器都在)。

根因(安装脚本输出里的硬证据):
  >>> Creating ollama systemd service...
  Created symlink /etc/systemd/system/default.target.wants/ollama.service → ...
安装脚本会创建并启用一个 systemd 服务(以 ollama 用户跑,模型在
/usr/share/ollama/.ollama/models),它与我们手起的 ollama serve 抢 11434;
而由**服务端**决定 ollama pull 把模型写到哪:
  · 我们的进程赢 → $HOME/.ollama/models        → 缓存能存能取
  · systemd 服务赢 → /usr/share/ollama/…        → 缓存 path 不存在,**静默不保存**
⇒ 缓存能不能生效靠抢(PR 与主干两次结果不同,即由此而来)。

处置(三条一起做才有意义):
1. 装完 systemctl stop + disable ollama —— 把 11434 唯一交给我们的进程
2. 显式钉死 OLLAMA_MODELS="$HOME/.ollama/models",与 cache 的 path 对齐
3. 加守卫步骤:test -d "$HOME/.ollama/models" 不成立就 exit 1
   —— 让"路径不对"表现为**红的 job**,而不是安静地白攒一次缓存

判据(本仓第 N 次同族):**会静默失效的东西,必须配一个能红的守卫。**
缓存存不下 ≠ job 失败 ⇒ 没守卫时只表现为"缓存永远不命中",查无可查。

核实:YAML 可解析;步骤顺序程序化校验(缓存#5 < 安装#6 < 守卫#7 < 跑测试#8);
四条关键行存在性检查通过;cache path == OLLAMA_MODELS 指向同一目录。

提交前两问
① 本次有决策事项 ⇒ 沿用 DEC-009(已在其「五之二」补记这个竞态与处置,含硬证据)
② CHANGELOG 已写

测试:61 passed(只改 CI 配置)
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