From 1a6ea45b9ede45e8faf415e043a46b28f8622d1e Mon Sep 17 00:00:00 2001 From: Aska Date: Mon, 7 Sep 2026 05:15:54 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BC=BA=E5=8C=96=E6=94=B9=E5=8A=A8?= =?UTF-8?q?=E5=89=8D=E5=90=8E=E6=8E=A8=E4=BB=93=E5=BA=93=E7=BA=AA=E5=BE=8B?= =?UTF-8?q?=EF=BC=88=E7=94=A8=E6=88=B7=E7=BA=A2=E7=BA=BF=EF=BC=8C=E7=95=99?= =?UTF-8?q?=E6=81=A2=E5=A4=8D=E8=AF=AF=E6=93=8D=E4=BD=9C=E4=BD=99=E5=9C=B0?= =?UTF-8?q?=EF=BC=89=E2=80=94=E2=80=94=E6=AF=8F=E4=B8=AA=E6=A8=A1=E5=9D=97?= =?UTF-8?q?/=E5=8A=9F=E8=83=BD=E6=94=B9=E5=8A=A8=E5=89=8D=E5=90=8E?= =?UTF-8?q?=E9=83=BD=20push=EF=BC=8C=E7=BB=9D=E4=B8=8D=E6=94=92=E5=88=B0?= =?UTF-8?q?=E9=98=B6=E6=AE=B5=E6=9C=AB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 58d3233..566240a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -66,6 +66,6 @@ - 🔴 **日志必须标来源**：模块/子功能用 `internal/logger.WithSource`/`Scoped`（`source=module/subfeature`）标注，跨模块可追溯定位；**禁止无来源裸日志**。 - 🔴 **客户端 API 契约先行**：REST `/api/v1` + WS `/ws` + admin `/api/v1/admin/*` 统一**版本化契约**，供跨平台客户端（Web/移动/IM bridge）接入与治理；JSON 响应 `{data}` / `{error:{code,message}}`。 - 🔴 **用户侧 API 文档随实现更新**：每实现/变更一个 REST 端点、WS 事件、admin API，**立即同步更新 `Docs/api-client.md`**（用户侧跨平台客户端 API 文档），供后期原生客户端开发；契约变更版本化。 -- 🔴 每阶段完成（或里程碑归档）后：**`git push origin dev`** 同步远端。 +- 🔴 **每次模块/功能改动「前」与「后」都推仓库**（用户红线，留恢复误操作余地）：改动前若工作树有未推改动，先 `git push origin dev` 存一个干净基线；改动完成验收通过后，立即 `git commit` + `git push origin dev` 存档。**绝不攒一堆改动到阶段末一次性推**——坏操作可随时 `git reset`/`rebase` 到任一推过的 commit 回滚。每个模块/功能提交（或里程碑归档）后均 `git push origin dev` 同步远端。 - 🔴 **遇到开发文档冲突 / 意义不明 / 规格矛盾时**：**阻塞会话**，用 `AskUserQuestion` 询问主人，**不得自行猜测**；文档清、不冲突则自主推进。 - 🔴 阶段验证：后端 `go build ./...` + `go vet ./...` + `go test ./...` 全绿 + windows/darwin 交叉编译；前端（M9+）`tsc --noEmit` + `vite build` 通过。