Repository navigation
fix: C1 删除 TTL_SKILLS(假承诺)+ CLAUDE.md 补两条操作教训 - #7
Merged
Merged
Conversation
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
force-pushed
the
fix/c1-ttl-skills-and-ops-lessons
branch
from
September 21, 2026 13:37
0525221 to
d926bf9
Compare
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 配置)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
落地 audit 的 C1(audit 清单的最后一条)。
C1 ·
TTL_SKILLS从未被任何代码使用 → 删除,而不是接上去event_bus里的TTL_SUMMARY = 3600ARCHITECTURE.md §5曾把它当生效项写进「分层 TTL:KV 60s / Summary 3600s / Skills 1 年」—— 那句话是假的skills/目录,根本不吃这条 Redis 缓存 ⇒ 收益为零、代价确定与
DEC-004(重排序不接)同一条纪律:别留旋钮没人转。裁决与反悔成本见DEC-007。顺带记了一个判据:
TTL_RAG同样未被使用,但一处删、一处留 ——判据是「接上之后是否成立」:
TTL_RAG(5 分钟缓存 RAG 结果)时长合理、是真实可行的待落地项,故保留登记。CLAUDE.md §8 · 两条本次真实踩到的操作教训
gh通、git不通 —— 本次诊断到根:DNS 正常、TCP 能连(nc通),但github.com的 HTTPS 层被掐(curl12s 超时、git 报Failure when receiving data from the peer/expected flush after ref listing),而api.github.com一直 HTTP 200。⇒ 判断真实远端状态要用
ghAPI /git ls-remote,⛔ 别拿本地origin/*ref 当"已同步"。本次真实踩到:合并 PR fix: D4 合并 RAG 检索查询 + 拆掉 testpaths 陷阱;口令轮换完成 #6 后网络断,本地跑出的是旧主干的用例数(58 而非 61)—— 差点把过期签出当成"主干已验证"。
pull变成合并而非快进。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