Skip to content

fix: C1 删除 TTL_SKILLS(假承诺)+ CLAUDE.md 补两条操作教训 - #7

Merged
heweidong-ecco merged 1 commit into
mainfrom
fix/c1-ttl-skills-and-ops-lessons
Sep 21, 2026
Merged

heweidong-ecco merged 1 commit into
mainfrom
fix/c1-ttl-skills-and-ops-lessons

Conversation

@heweidong-ecco

Copy link
Copy Markdown
Owner

落地 audit 的 C1(audit 清单的最后一条)。

C1 · TTL_SKILLS 从未被任何代码使用 → 删除,而不是接上去

事实 内容
引用 全仓零引用;技能摘要实际走 event_bus 里的 TTL_SUMMARY = 3600
文档 ARCHITECTURE.md §5 曾把它当生效项写进「分层 TTL:KV 60s / Summary 3600s / Skills 1 年」—— 那句话是假的
为什么不接上 1 年缓存 ⇒ 技能更新后脏一年;且技能匹配读的是磁盘 skills/ 目录,根本不吃这条 Redis 缓存 ⇒ 收益为零、代价确定

与 DEC-004(重排序不接)同一条纪律:别留旋钮没人转。裁决与反悔成本见 DEC-007。

顺带记了一个判据:TTL_RAG 同样未被使用,但一处删、一处留 ——
判据是「接上之后是否成立」:TTL_RAG(5 分钟缓存 RAG 结果)时长合理、是真实可行的待落地项,故保留登记。

CLAUDE.md §8 · 两条本次真实踩到的操作教训

  1. gh 通、git 不通 —— 本次诊断到根:DNS 正常、TCP 能连(nc 通),但 github.com 的 HTTPS 层被掐(curl 12s 超时、git 报 Failure when receiving data from the peer / expected flush after ref listing),而 api.github.com 一直 HTTP 200。
    ⇒ 判断真实远端状态要用 gh API / git ls-remote,⛔ 别拿本地 origin/* ref 当"已同步"。
    本次真实踩到:合并 PR fix: D4 合并 RAG 检索查询 + 拆掉 testpaths 陷阱;口令轮换完成 #6 后网络断,本地跑出的是旧主干的用例数(58 而非 61)—— 差点把过期签出当成"主干已验证"。
  2. 合并后别手动推进本地 main —— squash 产生新 SHA,手动推到本地那个未 squash 的提交会与远端分叉,下次 pull 变成合并而非快进。

⚠️ 本 PR 的状态说明

  • 远端当前那支是 rebase 前的版本(基于 2811d57);本地已 rebase 到 b1f6356(61 passed)。
  • 因 github.com 传输当前不稳,--force-with-lease 尚未成功 ⇒ PR 建成后我会把 rebase 版推上来(届时本 PR 会自动更新,CHANGELOG/CLAUDE 的重叠区已提前解掉,不再冲突)。

提交前两问

① 有决策事项 ⇒ DEC-007-TTL-SKILLS删除还是接上-20260921.md(二选一 + 与 TTL_RAG 为何一处删一处留)
② CHANGELOG 已写(C1 小节)

至此 audit 清单全部处置完毕

A1–A3 · B1–B3 · C1–C2 · D1–D4 · E

C1 · TTL_SKILLS 从未被任何代码使用 → **删除,而不是接上去**
  · 全仓零引用;技能摘要实际走 event_bus 里的 TTL_SUMMARY=3600
  · 而 ARCHITECTURE.md §5 把它当生效项写进「分层 TTL:…Skills 1 年」——**那句话是假的**
  · 为什么不接上:1 年缓存 ⇒ 技能更新后脏一年;且技能匹配读的是磁盘 skills/
    目录,**根本不吃这条 Redis 缓存** ⇒ 收益为零、代价确定
  · 与 DEC-004(重排序不接)同一条纪律:别留旋钮没人转
  留了「为什么删、别再加回来」的说明;§5/§11 同步更正
  与 TTL_RAG 的区别(同是未使用,一个删一个留)见 DEC-007

CLAUDE.md §8 补两条本次真实踩到的操作教训
  · **gh 通、git 不通**:git 传输连续 6 次 16s 超时,而同一时刻 gh pr view /
    gh run list 正常 ⇒ 判断真实远端状态要用 gh API / git ls-remote,
    ⛔ 别拿本地 origin/* ref 当"已同步"(它只在成功的 fetch 后才更新)
    —— 本次真实踩到:合并 PR #6 后网络断,本地跑出的是旧主干的用例数(58 而非 61),
       差点把过期签出当成"主干已验证"
  · **合并后别手动推进本地 main**:squash 产生新 SHA,手动推到本地那个未 squash 的
    提交会与远端分叉,下次 pull 变成合并而非快进 ⇒ 等 fetch 成功再 merge --ff-only;
    拿不到就如实说"本地落后",别用本地状态冒充远端状态

提交前两问
① 本次有决策事项 ⇒ 新建 DEC-007-TTL-SKILLS删除还是接上-20260921.md
   (二选一 + 与 TTL_RAG 为何一处删一处留的判据)
② CHANGELOG 已写(C1 小节)

⚠️ 本地落后于远端:本提交基于 2811d57,而远端 main 已是 b1f6356(PR #6 已合并)。
   本机到 GitHub 的 git 传输当前持续失败,故**尚未推送**。
   网络恢复后需:git fetch → 本地 main 快进 → 本分支 rebase 到新 main → 推 + PR。

测试:58 passed(这是本地过期主干的基线;C1 只删常量,不涉测试)
@heweidong-ecco
heweidong-ecco force-pushed the fix/c1-ttl-skills-and-ops-lessons branch from 0525221 to d926bf9 Compare September 21, 2026 13:37
@heweidong-ecco
heweidong-ecco merged commit 4161ecb into main Sep 21, 2026
2 checks passed
@heweidong-ecco
heweidong-ecco deleted the fix/c1-ttl-skills-and-ops-lessons branch September 21, 2026 13:42
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