7090aafefc
ci-gate.py:Python 的依赖/格式/静态/构建/测试改成真的执行(uv sync --frozen / uv run ruff / compileall / uv run pytest),工具缺失即失败,不再空跑成功;前端测试把子进程退出码当判据(报告写 pass 但退出 1 也判红),框架按 test-scope.json 声明而不是写死 vitest;清单新增 security(密钥扫描 + 依赖漏洞)。预览逻辑进 ci_preview.py:先调 ci_report.verify(),核对不过一个 publish 请求都不发。检出进 ci_checkout.sh:协议原样保留并断言不降级、URL 不放凭据、顺带取事件 before。workflow 收成单作业,不再用 /tmp 跨作业传文件。
templates/ —— 可直接落仓的骨架
每个文件都替换掉附件原稿的 GitLab 口径;改法见
../04-模板评估与修正.md。 ⚠️ 复制到仓库后不要就地重写:ci_gate.py/ci_report.py请从已验证的仓库逐字节复制 (Weknora/knowledge-governance/.gitea/scripts/或/srv/aiball/ci/attach/)。
| 文件 | 落仓位置 | 说明 |
|---|---|---|
gitea-build.yml |
.gitea/workflows/build.yml |
提交触发的校验+编译+预览+上报。只做 CI:里面没有任何部署作业(CD 由项目另写独立 workflow,见正本 §8) |
gitea-prod-deploy.yml |
.gitea/workflows/deploy-production.yml |
生产发布唯一入口,只 workflow_dispatch,不构建。⚠️ 未实现的步骤故意 exit 1:占位不许返回成功 |
gitignore |
.gitignore |
去掉原稿自相矛盾的 !src/secrets/ 例外 |
commit-msg |
~/.githooks/commit-msg |
本机提交闸门;规则必须与 ci_gate.py 一致 |
AGENTS.md 骨架 |
AGENTS.md |
见下(agent 指令文件有写入保护,故内联在此) |
| —— 随仓携带 | .gitea/scripts/ci_gate.py.gitea/scripts/ci_report.py |
逐字节复制已验证版本,不要重写 |
落仓后的自检(反向自检,规范 §3.2-3)
# 1) 故意违规的提交必须被闸门拦住,且 build 不跑
git commit -F - <<'EOF'
update stuff
EOF
# 判据:本地 hook 报 ❌;push 后 CI 的 gate 红、build 未执行
# ⚠️ 口径别说过头:CI 的 gate 是**推完再跑**的,它拦不住那次推送本身。
# 要拦推送只有两条路:本机 hook,或开分支保护(禁直推)。gate 的价值是
# "把违规提交标红、挡住编译与预览",不是"没进 main"。
# 2) 合规提交必须过(正例对照:证明不是"永远红")
git commit -F - <<'EOF'
ci(deploy): 接入 Gitea Actions 生产发布 workflow
生产发布改成独立 workflow(只 workflow_dispatch),避免塞进 push 流水线;
concurrency 明确 cancel-in-progress: false —— 取消不是回滚。
验证:手动发起一次,confirm 不匹配时 guard 作业必须红。
EOF
# 3) 产物地址每个都要 200
curl -m 5 -o /dev/null -w '%{http_code}\n' http://192.168.50.134:8899/healthz
curl -m 5 -o /dev/null -w '%{http_code}\n' http://100.92.49.78:8899/healthz
AGENTS.md 骨架(复制到仓库根,按本工程改写 TODO)
# AGENTS.md — 给在 <PROJECT> 里干活的 AI 代理
> 这是**操作手册**,不是给用户看的介绍。改代码前先读「硬约束」与「已知陷阱」。
>
> **系统级规范(本机所有 Gitea 仓库都适用)**:仓库 `zheromiku/eng-standards-main`(本机工作副本 `~/eng-standards/`)
> —— `01-规范-Git与CI-CD(Gitea版).md`(正本)+ `02-流程说明与Runbook.md`。
> 做 git / 提交 / CI / 发布 / 回滚 / 密钥 这些事之前先读它;本文件只写**本工程特有**的东西。
## 0. 这个工程是什么
<PROJECT>(一句话说清做什么、给谁用、部署在哪)。
## 1. 硬约束(违反其中任何一条,这次改动就不合格)
1. TODO:不许改变对外可观测行为(接口、报文、退出码、配置语义)
2. TODO:本工程最硬的那条证据是什么(对拍 / 契约 / 字节一致 / 快照)
3. **同一含义的代码只准有一份**(禁止同义复制)
4. **注释写"为什么"**,不写"是什么"
5. 提交按"一件事一个提交",conventional commits,正文用中文,标题 ≤72 字符
6. **生产使用测试验收过的同一份构建产物**(同 sha / 同镜像 ID)—— 不许在生产机上另行 build
## 2. 本地验证闭环(提交前的最低要求)
```bash
make verify # 本仓唯一门禁入口(本地与 CI 同一条命令);跳过项会显式警告「不算全绿」
```
- 门禁**串行**、失败即停;**汇总按必需清单逐项核对**:失败即停后剩下的记 `not_run`,
而 `not_run` / `skipped` 都不算通过(别把「没跑到」当成「没问题」)。
- 只有「跑产物」的套件(端到端 / 契约 / 产物自检)才必须排在构建之后;
单测(`go test` / `pytest` / `vitest`)各自跑源码,不需要先构建。
- 改到部署脚本或产物形状时,必须另外跑一次真实的装配/启动自检。
## 3. CI 闭环
```bash
giteactl runs <ns>/<repo> # 最近运行
giteactl logs <ns>/<repo> <runId> # 作业日志
python3 ~/.hermes/scripts/gitea_api.py GET "/api/v1/repos/<ns>/<repo>/actions/tasks?limit=5"
```
- 失败时**先读日志再改代码**;追到第一处 `❌`。
- `status=pending` 且 `status_count=0` **不是**失败(那是"没有配置任何状态检查")。
- run 一直 `queued` ⇒ 先查**本仓库有没有自己的 Runner**,别怀疑工作流。
- 合并读回:`GET /pulls/{n}` → `state=closed` + `merged=true` + `merge_commit_sha` 非空。
⚠️ 合并接口成功时可能返回**空 body** → **永不重试**,改读回。
## 4. 已知陷阱(索引)
全文在 `docs/agents/traps.md`。**只追加、不重排、不复用旧号**;编号会被代码注释与测试引用。
⚠️ 新增陷阱要改两处(traps.md 加全文 + 这张表加一行)。
| # | 一句话 | 全文 |
| --- | ------ | ---- |
| 1 | TODO | [读](docs/agents/traps.md#trap-1) |
## 5. 提交与推送
- **默认直推 `main`**(原稿口径,正本 §1.1);**需要评审时**才开短命分支 + PR(正本 §1.2,那是**建议**、不是门禁)。
- conventional commits,正文中文,**说清"为什么"**;一件事一个提交。
- 提交信息不要用反引号 / `$()`(会触发命令替换):用 `git commit -F -` + heredoc。
- 推之前跑完第 2 节;推送后用第 3 节确认流水线,失败就**先读 trace 再改代码**。
- 生产发布**不走 push**:它是独立的 `deploy-production` workflow,只由人手动发起(见规范 §5.2)。