Skip to content

自用版 v0.4.0 结项 + 仓库文档面按标准补齐 - #84

Merged
heweidong-ecco merged 1 commit into
mainfrom
docs/closeout-v0.4.0
Oct 18, 2026
Merged

heweidong-ecco merged 1 commit into
mainfrom
docs/closeout-v0.4.0

Conversation

@heweidong-ecco

Copy link
Copy Markdown
Owner

这是什么

自用版 v0.4.0 结项 + 仓库文档面按标准补齐。一个完整任务,一个 PR。

包含什么

1. DEC-019 完整 live 回归

  • run 20261018-182724-e6212c1d:47/48 · 0.9792 · exit 0 · judge 39,697 token
  • rule_hit_judge_fail = 0、soft_miss_judge_pass = 0 ⇒ 未观测到判分器误伤
  • 唯一失败 id=20 是真实被测失败(召回 [55,64,8],未召回含「两者结果互补」的 doc 60),已回灌
  • 报告 / DEC-019 §7 / 失败用例 / 复盘 / 3 份 spans.jsonl 证据归档

2. tools/sut-harness/run_sut.sh 修复

  • 适配被测新结构 app/ + 官方镜像 fastapi-rag-agent:latest
  • 源码只读挂 /src → 容器内复制到可写 /app(直接只读挂 /app 会被 .mem0/qdrant/.lock 挡住)
  • 新增 EVAL_SUT_DB / EVAL_SUT_SESSION_TOKEN_LIMIT
  • 能力探针失败退出码 1 → 2(与 README / 故障手册契约一致),已补红绿

3. 评测语料可复现

  • 仓内只放 eval/corpus/manifest.json(sha256 / 125 行 / 来源计数)
  • 正文放仓外 Product-external/eval-corpus/(不在任何 git 仓)
  • tools/export_eval_corpus.py + tools/seed_eval_corpus.py,seed 前强制校验 sha256

4. 结项记录

  • docs/结项报告-自用版-2026-10-18.md
  • DEC-024(结项范围 / 语料存放 / v0.4.0)· DEC-025(许可证 / 安全渠道 / CoC 暂缓)
  • 版本 0.3.0 → 0.4.0(pyproject.toml + __version__ 两处同步)

5. 文档面(标准驱动)

对照 GitHub 社区健康文件 + Standard Readme + promptfoo / openai/evals / deepeval / inspect_ai:

  • 仓库健康文件:LICENSE(MIT)· CONTRIBUTING.md · SECURITY.md · SUPPORT.md · CHANGELOG.md
  • GitHub 模板:.github/ISSUE_TEMPLATE/*.yml · .github/PULL_REQUEST_TEMPLATE.md
  • 使用者文档:docs/FAQ.md · docs/CLI.md · docs/README.md(总索引) · examples/
  • 架构图:docs/arch/README.md(C4 上下文 / 组件 / 时序);总纲.md 升到 0.4 并加「当前形态」
  • README:目录、4 个子命令、FAQ/贡献/安全/许可证段
  • 索引同步:CLAUDE.md 目录段 + 当前指针、ROADMAP.md 交接表与指针

验证

  • pytest:597 passed / 2 skipped
  • examples/offline-demo.sh:good → exit 0,bad → exit 1(脚本 exit 0)
  • 相对链接自检:0 broken
  • tools/check_evidence_coverage.py:✅ 通过

有意不放进 PR 的内容

  • 语料正文(Public 仓不放正文;仓外文件已生成)
  • eval/runs/*.local.json / *.trace.jsonl / .sut-harness.env(gitignore;3 份证据 span 已提交)
  • CODE_OF_CONDUCT / CITATION / GOVERNANCE / CODEOWNERS(DEC-025 明确暂缓)

没有动其他仓

fastapi-rag-agent 与 Product-external/external-fastapi-rag-agent 的 git status 都是干净的。

- 仓库健康文件:LICENSE(MIT)/CONTRIBUTING/SECURITY/SUPPORT/CHANGELOG
- GitHub 模板:.github/ISSUE_TEMPLATE/*.yml + PULL_REQUEST_TEMPLATE.md
- 使用者文档:docs/FAQ.md · docs/CLI.md · docs/README.md(索引) · examples/
- README:目录 + 完整 CLI 入口 + FAQ/贡献/安全/许可证段
- 架构图:docs/arch/README.md(C4/组件/时序);总纲 0.4 + 当前形态
- 结项:结项报告 + DEC-024 + DEC-025;版本 0.3.0 → 0.4.0
- 语料复现:eval/corpus 清单 + export/seed 工具(哈希校验)
- harness:适配 app/ 与官方镜像;探针失败 exit 2(已补红绿)
- 验证:597 passed / 2 skipped · 相对链接自检 0 broken · 证据覆盖守卫通过

[no-skill: 本轮工具改动含 corpus 导出/导入(先写测试:6 failed → 实现 → 6 passed)与探针退出码(测试先写,但脚本与测试同批改;已补红绿:退回旧行为→测试红→恢复→绿);TDD skill 在编辑后才调用,按 D-29 显式豁免并留痕]
@heweidong-ecco
heweidong-ecco merged commit 921e30d into main Oct 18, 2026
2 checks passed
@heweidong-ecco
heweidong-ecco deleted the docs/closeout-v0.4.0 branch October 18, 2026 11:11
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